Folks & Favors

Folks & Favors

动态实体任务,让你的世界充满生机!

冒险

Folks & Favors!

Folks & Favors 通过赋予特定生物独特的个性、请求和奖励,添加了一个温馨轻量的任务系统。不再是静态的 NPC,村民和其他友好生物现在可以向你寻求帮助——并用有用的物品作为回报来感谢你。此模组设计为原版友好、沉浸式且完全可配置,非常适合休闲世界和大型整合包。默认情况下,该模组增强了傻瓜村民,将他们变为拥有独特个性和物品请求的迷人任务发布者。其他生物可以通过简单的 JSON 配置启用!

配置

Folks & Favors 有 4 个不同的配置文件,下面说明每个文件的作用以及如何使用它们:

folksfavors_quest_givers.json

此文件定义了哪些生物可以成为任务发布者,以及它们生成时获得个性的概率。(如果生物没有个性,它将不会收到任务!!!)

示例代码:

{
  "quest_givers": {
    "minecraft:villager": {
      "chance": 1.0,
      "forced_personality": null
    }
  }
}

chance 表示生物生成时成为任务发布者的百分比概率。(值为 1.0 表示总是,而 0.25 表示 25%)

forced_personality 可以设置为任何已定义的个性名称。此实体现在将永远只拥有该个性。(如果不需要此参数,可以删除它或将其设置为 null)

folksfavors_personalities.json

每个个性定义:

  • 它们偏好哪种类型的任务(基于标签的系统)
  • 它们的任务有多稀有
  • 它们在提供新任务前等待多长时间

示例代码:

"farmer": {
  "preferred_tags": ["plants", "food", "animals"],
  "rarity_bias": {
    "common": 70,
    "uncommon": 20,
    "rare": 8,
    "mythic": 2,
    "legendary": 0
  },
  "reset_time": 18000
}

preferred_tags 决定此个性更可能选择哪些任务。

rarity_bias 控制此个性中每种任务稀有度出现的频率。

reset_time 是在上一个任务被满足后,它们可以再提供新任务之前的时间(以刻为单位)。

你可以添加任意数量的个性!

folksfavors_quests.json

每个任务条目定义了请求的物品、数量、稀有度以及它所属的个性标签。

示例代码:

{
  "id": "gather_wheat",
  "text": "Could you bring me some wheat?",
  "item": "minecraft:wheat",
  "amount": 16,
  "rarity": "common",
  "tags": ["plants", "food"]
}

id 是给予每个任务的唯一任务 ID,用于调用并应用到生物上。

text 是任务被授予后显示在生物头顶的任务标题。(某些符号会自动转义以符合 JSON 的格式)

item 是任务物品的物品注册名。(例如 minecraft:dirt、minecraft:sugar_cane 等。这与你安装的任何模组兼容)

amount 是完成任务所需的物品堆叠数量。任务只会检查该物品堆叠是否在玩家手中。(为防止“卡住的任务”,请只将堆叠数量设置为不超过 64,除非该物品支持更高的堆叠数量)

rarity 是任务在分配给有个性的生物时被选中的权重值。有 5 种硬编码的稀有度:"common"、"uncommon"、"rare"、"mythic" 和 "legendary"。每种稀有度的权重在个性中定义。(你可以添加更多个性,不过模组不会为你的任务文本字符串分配颜色代码)

tags 定义任务可以属于哪个个性。你可以在每个生物上使用任意数量的标签。(为减少庞大的标签列表,使用 "any" 来调用所有标签)

folksfavors_loot.json

完成任务后,玩家将从对应任务稀有度的战利品表中抽取奖励。

示例代码:

{
  "loot": [
    {
      "rarity": "common",
      "item": "minecraft:bread",
      "min": 1,
      "max": 3,
      "weight": 40
    },
    {
      "rarity": "uncommon",
      "item": "minecraft:emerald",
      "min": 1,
      "max": 2,
      "weight": 20
    },
    {
      "rarity": "rare",
      "item": "minecraft:golden_apple",
      "min": 1,
      "max": 1,
      "weight": 5
    }
  ]
}

rarity 定义了哪些任务稀有度可以抽取此表。

item 是奖励的物品堆叠 ID。

min 是奖励时可以获得的最小物品数量。

max 是奖励时可以获得的最大物品数量。

weight 是该奖励相对于表中其他奖励的概率。(这些数字是权重,不是百分比。它们不需要加起来等于 100,不需要归一化,它们是相对彼此使用的)

感谢游玩!欢迎评论任何你认为有益于添加到本项目中的建议。