Mebahel’s RPG – Villager Quests and Companions

主要配置默认值

任何人都可以通过数据包或模组中的 JSON 文件为该模组创建新任务。你可以添加对话、目标、传闻、具名敌人、奖励、选择、伏击、袭击、运送、护送以及完整的分支任务线。

文件位置

将任务和传闻文件放入你自己的命名空间：

data/<namespace>/quests/<quest_file>.json
data/<namespace>/rumors/<rumor_file>.json

例如：

data/my_quests/quests/old_well.json

这会创建任务 ID：

my_quests:old_well

可以使用任务子文件夹，但它们不会成为任务 ID 的一部分。请确保命名空间内的每个任务文件名都唯一。

快速开始

1. 选择下面最接近你想制作的任务的示例。
2. 将其中的 JSON 复制到 data/<namespace>/quests/ 或 data/<namespace>/rumors/ 下的新文件中。
3. 将 example 或 modid 中的命名空间替换为你自己的命名空间。
4. 修改对话、实体、结构、目标、奖励和关联任务 ID。
5. 重新加载数据包，并在开发世界或备份世界中测试任务。

JSON 不允许注释或尾随逗号。请始终使用完整标识符，例如 minecraft:zombie；一个文件引用另一个文件时，请使用完整任务 ID，例如 my_quests:old_well。

面向玩家显示的文本可以使用翻译对象：

{

"translate": "quest.my_quests.old_well.title",

"fallback": "The Old Well"

}

如果没有可用的匹配翻译，系统会显示 fallback 值，因此语言文件不是必需的。

生成一名有名字的敌人，让玩家与其对话，然后根据目标是被攻击还是被放过，进入不同的后续任务。

首个任务

{
"title": "QUEST TITLE",


"summary": "Villager-facing summary shown before acceptance.",


"flow": {


"on_kill": "modid:kill_branch_2",


"on_spare": "modid:spare_branch_2"


},


"goals": [


{


"id": "talk_to_threat",


"talk": "minecraft:zombie",


"amount": 1,


"name": "NAMED THREAT"


},


{


"id": "kill_threat",


"kill": "minecraft:zombie",


"amount": 1,


"attack_only": true,


"from_threats": true


}


],


"threat": {


"entity": "minecraft:zombie",


"name": "NAMED THREAT",


"structure": "minecraft:ruined_portal",


"search_radius": 4000,


"spawn_on_accept": true,


"spawn_min_radius": 3,


"spawn_max_radius": 6,


"spare": true,


"glow": false,


"max_health": 150,


"equipment": {


"mainhand": "minecraft:diamond_sword",


"helmet": {


"item": "minecraft:iron_helmet",


"enchants": {


"minecraft:unbreaking": 3


}


}


},


"line": "Quest giver line that describes the threat.",


"target": "Initial line spoken by the threat.",


"talk": [


[


"Player question one?",


"Threat answer one."


],


[


"Player question two?",


"Threat answer two."


]


]


},


"choice": {


"attack": {


"label": "Attack choice label.",


"traits": [


"trait_from_attack"


],


"return": "Quest giver line after the target is killed."


},


"spare": {


"label": "Spare choice label.",


"line": "Immediate line after sparing the target.",


"post": "Follow-up line shown after the spare.",


"villager": "Quest giver line after spare.",


"traits": [


"trait_from_spare"


],


"rewards_from_giver": true,


"rewards": {


"xp": 160,


"items": {


"minecraft:iron_ingot": 4


}


},


"after": {


"offer_chance": 70,


"ambush_chance": 30,


"nothing_chance": 0,


"ambush": "minecraft:zombie",


"ambush_name": "Fallback Ambush Name",


"count": 5,


"ambush_max_health": 50,


"ambush_equipment": {


"helmet": "minecraft:leather_helmet"


},


"line": "Line used when the spared target offers the next quest.",


"ambush_line": "Line used if mercy triggers an ambush.",


"nothing": "Line used if no follow-up happens."


}


}


},


"dialogue": {


"return": "Quest giver line after kill.",

"reward": "任务发布者奖励行。",


"done": "任务发布者已完成行。"


},


"rewards": {


"xp": 260,


"items": {


"minecraft:emerald": 10


}


}


}

对于启用了宽恕的威胁对峙，优先使用上文展示的 talk 加 attack_only 击杀模式。第一次交互会打开对话，但不会完成阶段；只有玩家明确选择攻击或宽恕后，该阶段才会完成。

击杀分支

{


"title": "KILL BRANCH TITLE",


"summary": "Follow-up summary after the player chose attack.",


"dialogue": {


"intro": "Intro line.",


"offer": [


[


"Player question?",


"Quest giver answer."


]


],


"return": "Return line.",


"reward": "Reward line.",


"done": "Already completed line."


},


"goals": [


"kill 3 minecraft:zombified_piglin"


],


"threats": [


{


"entity": "minecraft:zombified_piglin",


"name": "Branch Threat",


"structure": "minecraft:ruined_portal",


"search_radius": 4000,


"spawn_on_accept": true,


"spare": false,


"max_health": 70,


"equipment": {


"mainhand": "minecraft:golden_sword"


}


}


],


"rewards": {


"xp": 360,


"items": {


"minecraft:emerald": 14


}


}


}

宽恕分支

{


"title": "SPARE BRANCH TITLE",


"summary": "Follow-up summary after the player chose spare.",


"flow": {


"next": "modid:spare_branch_3"


},


"dialogue": {


"intro": "Intro line from the spared target or quest giver.",


"offer": [


[


"Player question?",


"Answer."


]


],


"return": "Return line.",


"reward": "Reward line.",


"done": "Already completed line."


},


"goals": [


{


"collect": "minecraft:iron_ingot",


"amount": 4


}


],


"rewards": {


"xp": 240,


"items": {


"minecraft:emerald": 6


}


}


}

要求玩家先建造或收集物资，然后开始第二阶段，在任务发布者周围生成攻击者。

基于 questlines/village_build/village_pig_enclosure.json。

要点：

• sequential_objectives: true 使阶段 0 在阶段 1 开始前完成。
• 建造目标使用 place、bring、collect 或其他普通目标快捷方式。
• 威胁可以分配给 stage: 1，并通过 spawn_origin: "quest_giver" 在任务发布者周围生成。
• 当生成的具名/自定义威胁应被计入时，在击杀目标上使用 from_threats: true。
• 为每个要生成的生物添加一个 threats 条目。威胁条目上不会读取 amount。

{
"title": {

"translate": "quest.example.first_pen_defense.title",

"fallback": "值得守护的畜栏"

},

"summary": {

"translate": "quest.example.first_pen_defense.summary",

"fallback": "建造一个小型畜栏，把牲畜带进去，然后抵御袭来的掠夺者。"

},

"sequential_objectives": true,

"dialogue": {

"intro": {

"translate": "quest.example.first_pen_defense.dialogue.intro",

"fallback": "村民指向农场附近一片光秃秃的草地。"

},

"offer": [

[

{

"translate": "quest.example.first_pen_defense.dialogue.offer.0.0",

"fallback": "你需要我建些什么？"

},

{

"translate": "quest.example.first_pen_defense.dialogue.offer.0.1",

"fallback": "一圈栅栏、一扇栅栏门、两支火把，还要留出足够的空间安置第一批牲畜。"

}

]

],

"return": {

"translate": "quest.example.first_pen_defense.dialogue.return",

"fallback": "畜栏守住了，你也撑住了。"

},

"reward": {

"translate": "quest.example.first_pen_defense.dialogue.reward",

"fallback": "拿着这个。守得住的农场，养活的不止一户人家。"

},

"done": {

"translate": "quest.example.first_pen_defense.dialogue.done",

"fallback": "动物还在畜栏里，掠夺者已经不见了。"

}

},

"goals": [

{

"id": "place_fences",

"place": "minecraft:oak_fence",

"amount": 12,

"stage": 0,

"range": 60

},

{

"id": "place_gate",

"place": "minecraft:oak_fence_gate",

"amount": 1,

"stage": 0,

"range": 60

},

{

"id": "place_torches",

"place": "minecraft:torch",

"amount": 2,

"stage": 0,

"range": 60,

"say": {

"translate": "quest.example.first_pen_defense.goals.place_torches.say",

"fallback": "畜栏亮起来了。待在附近。"

}

},

{

"id": "bring_animals",

"bring": "minecraft:pig",

"amount": 2,

"stage": 0,

"range": 60

},

{

"id": "kill_raiders",

"kill": "minecraft:pillager",

"amount": 3,

"stage": 1,

"from_threats": true

},

{

"id": "kill_raider_captain",

"kill": "minecraft:vindicator",

"amount": 1,

"stage": 1,

"from_threats": true

}

],

"threats": [

{

"entity": "minecraft:pillager",

"name": {

"translate": "quest.example.first_pen_defense.threats.0.name",

"fallback": "饿肚子的掠夺者"

},

"stage": 1,

"spawn_origin": "quest_giver",

"spawn_min_radius": 18,

"spawn_max_radius": 30,

"spawn_on_accept": true,

"spare_enabled": false,

"glow": true

},

{

"entity": "minecraft:pillager",

"name": {

"translate": "quest.example.first_pen_defense.threats.1.name",

"fallback": "拆栅栏的掠夺者"

},

"stage": 1,

"spawn_origin": "quest_giver",

"spawn_min_radius": 18,

"spawn_max_radius": 30,

"spawn_on_accept": true,

"spare_enabled": false,

"glow": true

},

{

"entity": "minecraft:pillager",

"name": {

"translate": "quest.example.first_pen_defense.threats.2.name",

"fallback": "踢火把的掠夺者"

},

"stage": 1,

"spawn_origin": "quest_giver",

"spawn_min_radius": 18,

"spawn_max_radius": 30,

"spawn_on_accept": true,

"spare_enabled": false,

"glow": true

},

{

"entity": "minecraft:vindicator",

"name": {

"translate": "quest.example.first_pen_defense.threats.3.name",

"fallback": "破栅者"

},

"stage": 1,

"spawn_origin": "quest_giver",

"spawn_min_radius": 22,

"spawn_max_radius": 34,

"spawn_on_accept": true,

"spare_enabled": false,

"glow": true,

"max_health": 40.0

}

],

"rewards": {

"xp": 180,

"items": {

"minecraft:emerald": 6,

"minecraft:wheat": 12

}

},

"traits": {

"complete": [

"farm_defender"

]

}

}

将任务物品放入结构中的容器，让玩家阅读书面线索，然后完成爆破目标并生成敌人。

基于 questlines/sculk/sculk_mineshaft_investigation.json。

要点：

• read_book目标必须包含 item: "minecraft:written_book"。
• quest_book.title、quest_book.author 和 quest_book.pages 可以使用翻译对象。
• 使用 in_chest: true 搭配 container，在生成的容器中生成目标物品。
• 任务物品生成器会将生成的箱子/容器物品放入随机的空槽位。
• detonate_tnt应使用 block指定爆炸附近的目标方块，而不是 TNT 方块本身。
• force_place_block: true可在结构无法稳定生成目标方块时预先放置该方块。

{
"title": {


"translate": "quest.example.mine_demolition.title",


"fallback": "Notes Under the Mine"


},


"summary": {


"translate": "quest.example.mine_demolition.summary",


"fallback": "Find a sealed mineshaft, recover the foreman's notes, and destroy the marked spawner."


},


"sequential_objectives": true,


"goals": [


{


"id": "reach_old_mine",


"reach": "minecraft:mineshaft",


"structure": "minecraft:mineshaft",


"radius": 3200,


"range": 80,


"stage": 0,


"auto_advance": true


},


{


"id": "read_foreman_notes",


"type": "read_book",


"item": "minecraft:written_book",


"amount": 1,


"structure": "minecraft:mineshaft",


"container": "minecraft:barrel",


"stage": 1,


"radius": 3200,


"in_chest": true,


"auto_advance": true,


"tag": "example_foreman_notes",


"quest_book": {


"title": {


"translate": "quest.example.mine_demolition.book.title",


"fallback": "Foreman's Notes"


},


"author": {


"translate": "quest.example.mine_demolition.book.author",


"fallback": "Mine Foreman"


},


"pages": [


{


"translate": "quest.example.mine_demolition.book.page.0",


"fallback": "We sealed the lower drift after the spawner woke again. If anyone returns, place charges near the cage, not in the tunnel mouth."


}


]


},


"block_patch": {


"radius": 4,


"palette": [


"minecraft:sculk",


"minecraft:deepslate"


]


}


},


{


"id": "take_tnt_from_barrel",


"collect": "minecraft:tnt",


"amount": 3,


"mandatory": false,


"sequential": true,


"stage": 1,


"in_chest": true,


"structure": "minecraft:mineshaft",


"container": "minecraft:barrel"


},


{


"id": "place_demolition_charges",


"place": "minecraft:tnt",


"amount": 3,


"structure": "minecraft:mineshaft",


"stage": 2,


"range": 12


},


{


"id": "detonate_spawner",


"type": "detonate_tnt",


"block": "minecraft:spawner",


"required_mob": "minecraft:skeleton",


"structure": "minecraft:mineshaft",


"force_place_block": true,


"amount": 3,


"stage": 2,


"radius": 3200,


"range": 14,


"auto_advance": true,


"block_patch": {


"radius": 3,


"palette": [


"minecraft:sculk",


"minecraft:deepslate"


]


}


},


{


"id": "kill_what_crawls_out",


"kill": "minecraft:zombie",


"amount": 4,


"stage": 3,


"from_threats": true


}


],


"threats": [


{


"entity": "minecraft:zombie",


"name": {


"translate": "quest.example.mine_demolition.threats.0.name",


"fallback": "Sculk-Crowned Dead"


},


"stage": 3,


"spawn_origin": "player",


"spawn_min_radius": 8,


"spawn_max_radius": 16,


"spawn_on_accept": true,


"spare_enabled": false,


"glow": true,


"equipment": {


"head": "minecraft:sculk"


}


},


{


"entity": "minecraft:zombie",

"name": {


"translate": "quest.example.mine_demolition.threats.1.name",


"fallback": "被幽匿标记的亡者"


},


"stage": 3,


"spawn_origin": "player",


"spawn_min_radius": 8,


"spawn_max_radius": 16,


"spawn_on_accept": true,


"spare_enabled": false,


"glow": true,


"equipment": {


"head": "minecraft:sculk"


}


},


{


"entity": "minecraft:zombie",


"name": {


"translate": "quest.example.mine_demolition.threats.2.name",


"fallback": "被幽匿标记的亡者"


},


"stage": 3,


"spawn_origin": "player",


"spawn_min_radius": 8,


"spawn_max_radius": 16,


"spawn_on_accept": true,


"spare_enabled": false,


"glow": true,


"equipment": {


"head": "minecraft:sculk"


}


},


{


"entity": "minecraft:zombie",


"name": {


"translate": "quest.example.mine_demolition.threats.3.name",


"fallback": "被幽匿标记的亡者"


},


"stage": 3,


"spawn_origin": "player",


"spawn_min_radius": 8,


"spawn_max_radius": 16,


"spawn_on_accept": true,


"spare_enabled": false,


"glow": true,


"equipment": {


"head": "minecraft:sculk"


}


}


],


"rewards": {


"xp": 320,


"items": {


"minecraft:emerald": 10,


"minecraft:echo_shard": 1


}


}


}

收集物资，前往另一处建筑或村庄，将物品交给生成的目标，然后返回最初的任务发布者。

基于delivery_cobblestone_oak_log_other_village.json。

要点：

• 交付目标在threat中配置。
• delivery_objectives必须列出需要交付的目标 ID。
• 目标对话任务通常应使用auto_advance: true。
• 如果玩家必须回来报告，请在下一阶段添加一个最终的return: true任务。
• min_structure_distance当目标不应生成在同一村庄时，

很有用。
"title": {

"translate": "quest.example.remote_delivery.title",

"fallback": "送往下一个村庄的石料"

},

"summary": {

"translate": "quest.example.remote_delivery.summary",

"fallback": "把物资送给正在另一个村庄等候的信使。"

},

"sequential_objectives": true,

"goals": [

{

"id": "delivery_cobblestone",

"collect": "minecraft:cobblestone",

"amount": 32,

"mandatory": true,

"stage": 0

},

{

"id": "delivery_oak_logs",

"collect": "minecraft:oak_log",

"amount": 16,

"mandatory": true,

"stage": 0

},

{

"id": "deliver_to_messenger",

"talk": "minecraft:villager",

"amount": 1,

"mandatory": true,

"stage": 0,

"auto_advance": true,

"name": {

"translate": "quest.example.remote_delivery.goals.deliver_to_messenger.name",

"fallback": "村庄信使"

},

"say": {

"translate": "quest.example.remote_delivery.goals.deliver_to_messenger.say",

"fallback": "信使收下了物资。回去找派你来的村民。"

}

},

{

"id": "return_to_sender",

"return": true,

"amount": 1,

"mandatory": true,

"stage": 1

}

],

"threat": {

"entity": "minecraft:villager",

"name": {

"translate": "quest.example.remote_delivery.threat.name",

"fallback": "村庄信使"

},

"structure": "minecraft:villages",

"search_radius": 4200,

"spawn_radius": 10,

"spawn_on_accept": true,

"spare_enabled": false,

"glow": false,

"target_line": {

"translate": "quest.example.remote_delivery.threat.target_line",

"fallback": "如果你带来了石料和橡木，就在墙塌之前把它们交给我。"

},

"delivery_objectives": [

"delivery_cobblestone",

"delivery_oak_logs"

],

"delivery_choice_label": {

"translate": "quest.example.remote_delivery.threat.delivery_choice_label",

"fallback": "交出物资"

},

"delivered_line": {

"translate": "quest.example.remote_delivery.threat.delivered_line",

"fallback": "这些足够撑住了。告诉他们，我们两座村庄之间的道路仍值得保持畅通。"

},

"depart_after_delivery": false,

"min_structure_distance": 700

},

"rewards": {

"xp": 180,

"items": {

"minecraft:emerald": 7,

"minecraft:bread": 6

}

}

}

接受任务时开始一场普通的 Minecraft 袭击，并在村庄幸存后完成目标。

基于 questlines/village_defense/village_defense_chain_3_the_bell_and_the_raid.json。

要点：

• 使用 type: "defend_raid"。
• amount: 1 是单个袭击防御目标的常用值。
• 此目标依赖 Minecraft 的常规袭击流程，因此应由正在防守的村庄内或附近的村民发布。
• 如果希望袭击奖励别具特色，可以使用带有附魔物品的奖励。

{
"title": {

"translate": "quest.example.bell_raid.title",

"fallback": "钟声与袭击"

},

"summary": {

"translate": "quest.example.bell_raid.summary",

"fallback": "与村庄并肩作战，抵御袭击。"

},

"dialogue": {

"intro": {

"translate": "quest.example.bell_raid.dialogue.intro",

"fallback": "村民站在钟旁，一只手握着钟绳。"

},

"offer": [

[

{

"translate": "quest.example.bell_raid.dialogue.offer.0.0",

"fallback": "你觉得他们现在就要来了吗？"

},

{

"translate": "quest.example.bell_raid.dialogue.offer.0.1",

"fallback": "如果我们敲响钟声，他们就会知道我们已经做好战斗准备。"

}

]

],

"return": {

"translate": "quest.example.bell_raid.dialogue.return",

"fallback": "号角声已停，村庄依然屹立。"

},

"reward": {

"translate": "quest.example.bell_raid.dialogue.reward",

"fallback": "这是从袭击首领那里缴获的战利品。按战斗中的规矩，它归你了。"

},

"done": {

"translate": "quest.example.bell_raid.dialogue.done",

"fallback": "钟声再次响起，是为了警示，而非恐惧。"

}

},

"goals": [

{

"id": "defend_the_village",

"type": "defend_raid",

"amount": 1

}

],

"rewards": {

"xp": 650,

"items": {

"minecraft:emerald": 20,

"minecraft:crossbow": {

"count": 1,

"enchantments": [

{

"id": "minecraft:power",

"level": 3

},

{

"id": "minecraft:unbreaking",

"level": 2

},

{

"id": "minecraft:piercing",

"level": 1

}

]

}

}

},

"traits": {

"complete": [

"village_defender"

]

}

}

让任务保持不可用，直到玩家从村民那里听到正确的传闻。

基于 rumors/mine_smoke_below.json 和 blaze_mineshaft_threat.json。

要点：

• 传闻文件位于 data/<namespace>/rumors/<rumor_id>.json。
• unlock_quest 应该是完整的任务 ID。
• 发现传闻后，玩家会获得特质 quest_discovered:<full quest id>。
• 隐藏任务应要求拥有该特质。
• 使用 conditions.not_completed_quests，这样任务完成后，这条传闻就不再有用了。
• 传闻 line 和 discovered_line 目前都是普通字符串。

传闻文件

{
"id": "example_smoke_below",

"weight": 15,

"line": "矿工们发誓，封闭多年的矿井竖井里正冒出烟雾。",

"unlock_quest": "example:hidden_mineshaft_fire",

"conditions": {

"not_completed_quests": [

"example:hidden_mineshaft_fire"

]

},

"discovered_line": "发现传闻：有危险的灼热之物正在一条古老矿井中移动。"

}

隐藏任务文件

{

"title": {

"translate": "quest.example.hidden_mineshaft_fire.title",

"fallback": "Flame in the Mineshaft"

},

"summary": {

"translate": "quest.example.hidden_mineshaft_fire.summary",

"fallback": "A villager reports a blaze burning through an abandoned mineshaft."

},

"requires": {

"traits": [

"quest_discovered:example:hidden_mineshaft_fire"

]

},

"goals": [

{

"id": "kill_mine_blaze",

"kill": "minecraft:blaze",

"amount": 1

}

],

"threat": {

"entity": "minecraft:blaze",

"name": {

"translate": "quest.example.hidden_mineshaft_fire.threat.name",

"fallback": "Ignivar the Mineflame"

},

"structure": "minecraft:mineshaft",

"search_radius": 4000,

"spawn_on_accept": true,

"spare_enabled": false,

"max_health": 150.0,

"offer_line": {

"translate": "quest.example.hidden_mineshaft_fire.threat.offer_line",

"fallback": "Something from the Nether is burning through an old mineshaft."

},

"target_line": {

"translate": "quest.example.hidden_mineshaft_fire.threat.target_line",

"fallback": "The blaze crackles with hostile heat. There is no sign it understands mercy."

}

},

"rewards": {

"xp": 260,

"items": {

"minecraft:emerald": 12,

"minecraft:blaze_rod": 2

}

}

}

护送任务实体前往已搜索到的建筑，并可配置搜索距离和完成范围。

基于 questlines/armed_zombie/armed_zombie_chain_spare_2_forgotten_road.json。

要点：

• 使用 escort 快捷写法并指定建筑 ID。解析器会将其转换为 escort_entity。
• radius 控制建筑搜索的最远距离。
• range 控制被护送实体必须靠近目标建筑到什么程度。
• 这很适合作为备用人员/招募分支后的后续任务。

{
"title": {

"translate": "quest.example.forgotten_road.title",

"fallback": "被遗忘的道路"

},

"summary": {

"translate": "quest.example.forgotten_road.summary",

"fallback": "护送一名被饶过的敌人，前往它记得的村庄道路。"

},

"flow": {

"next": "example:remembered_name"

},

"dialogue": {

"intro": {

"translate": "quest.example.forgotten_road.dialogue.intro",

"fallback": "被饶过的生物放低武器，望向道路。"

},

"offer": [

[

{

"translate": "quest.example.forgotten_road.dialogue.offer.0.0",

"fallback": "你还记得一个村庄？"

},

{

"translate": "quest.example.forgotten_road.dialogue.offer.0.1",

"fallback": "钟声。炊烟。一口石头开裂的井。带我去那里。"

}

]

],

"return": {

"translate": "quest.example.forgotten_road.dialogue.return",

"fallback": "钟声。我认得这个声音。"

},

"reward": {

"translate": "quest.example.forgotten_road.dialogue.reward",

"fallback": "我在井边的石头下面找到了这个。它曾经属于我。"

},

"done": {

"translate": "quest.example.forgotten_road.dialogue.done",

"fallback": "村庄的道路还记得我。"

}

},

"goals": [

{

"id": "escort_to_village",

"escort": "minecraft:village_plains",

"radius": 3500,

"range": 40

}

],

"rewards": {

"xp": 220,

"items": {

"minecraft:iron_ingot": 6,

"minecraft:emerald": 4

}

},

"traits": {

"complete": [

"escort_memory"

]

}

}

任务公告板可以出现在已配置的村庄结构中，并独立于内置剧情任务生成可重复接取的合约。公告板会随时间刷新任务，可提供狩猎、递送、保护村庄和讨伐精英目标等任务。

打开公告板即可浏览当前合约、查看各项目标与奖励，并接取想做的任务。已接取的合约会直接加入常规任务日志和HUD：无需在物品栏中保留任何合约物品。每块公告板都有独立的共享声望和等级。完成该公告板的合约，会提高出现更高难度任务的几率，并缩短刷新时间。多人游戏中，可以将任务设为每位玩家单独领取，或由所有玩家共享领取。

合约分为五个难度等级：

应用倍率后，精英数量向上取整。特定精英可以选择不按倍率调整数量，方法是添加 "scale_count_with_difficulty": false；如果配置了 max_health，生命值加成仍会生效。

难度还会影响装备、状态效果、奖励以及获得的公告板声望。

数据包配置

任务公告板合约完全由数据驱动。数据包或模组可以添加原版或模组实体、物品、结构、装备和奖励，而无需替换内置文件。

请使用常规的数据包目录结构：

<datapack>/
pack.mcmeta

data/

<your_namespace>/

quest_board_contracts/

除非你有意覆盖相同资源路径的数据，否则不要将自定义文件放入 mebahelrpgrquest 命名空间。系统会发现并合并来自不同命名空间的契约定义。例如 example:raider_rewards 这样的引用会在被引用的命名空间内解析。

每种契约类型都有自己的定义文件和可选表格：

quest_board_contracts/kill/mobs.json

quest_board_contracts/kill/reward_tables/

quest_board_contracts/spawn_groups/groups.json

quest_board_contracts/spawn_groups/equipment_tables/

quest_board_contracts/spawn_groups/reward_tables/

quest_board_contracts/deliveries/deliveries.json

quest_board_contracts/deliveries/reward_tables/

quest_board_contracts/protection/protection.json

quest_board_contracts/protection/reward_tables/

quest_board_contracts/elites/elites.json

quest_board_contracts/elites/equipment_tables/

quest_board_contracts/elites/reward_tables/

如果定义所需的模组实体、物品或结构不可用，该定义会被安全忽略。无效条目会在日志中产生警告，但不会阻止其他有效契约加载。缺少自定义奖励表时，该契约类型会回退到内置的全局表；缺少装备表时，生物会保留其原有装备。

kill/mobs.json包含一个 mobs 数组。这类契约会统计对所选实体的普通击杀次数：

{
"mobs": [

{

"id": "examplemod:mutant_zombie",

"min": 2,

"max": 5,

"reward_table": "example:mutant_hunt"

}

]

}

上方的可选奖励表应放在此处：

data/example/quest_board_contracts/kill/reward_tables/mutant_hunt.json

spawn_groups/groups.json包含一个 groups 数组。每个被接受的群体契约都会定位一个已配置的结构，在那里生成一群目标，并且只追踪这些生成的目标。

最简群体条目格式如下：

{
"groups": [

{

"entities": [

{

"id": "minecraft:zombie",

"weight": 10

}

],

"min": 1,

"max": 2,

"structures": [

"minecraft:villages"

],

"equipment_table": "example:group_enemies",

"reward_table": "example:group_rewards",

"search_radius": 3000,

"ignore_current_structure": true,

"min_structure_distance": 128,

"spawn_min_radius": 8,

"spawn_max_radius": 32

}

]

}

entities 是一个加权池，会为群体中的每个成员分别抽取。structures 也是一个池：契约生成时会从中选出一个目的地。ignore_current_structure 会在告示板所在村庄以外搜索，而 min_structure_distance 用于设置排除距离。

deliveries/deliveries.json包含一个 deliveries 数组。接受契约后，系统会定位目的地并生成一名有名字的收件人。玩家必须将物品带给该收件人；与其互动会消耗所需物品并完成契约。

{
"deliveries": [

{

"item": "examplemod:medical_supplies",

"min": 8,

"max": 20,

"structures": [

"minecraft:villages"

],

"reward_table": "example:medical_delivery",

"search_radius": 3000,

"ignore_current_structure": true,

"min_structure_distance": 128,

"spawn_min_radius": 0,

"spawn_max_radius": 24,

"recipient_name": "Village Quartermaster"

}

]

}

protection/protection.json包含一个 contracts 数组。内置支持的防护类型为 iron_golem 和 lighting。

{
"contracts": [

{

"type": "lighting",

"target": "minecraft:torch",

"min": 6,

"max": 12,

"structures": [

"minecraft:villages"

],

"search_radius": 5000,

"ignore_current_structure": false,

"completion_range": 96

}

]

}

将 ignore_current_structure 设为 false，即可保护告示板所在的村庄；也可以将其设为 true 并配合 min_structure_distance，将玩家送往另一个村庄。

elites/elites.json包含一个 contracts 数组。每份悬赏可以包含多个精英条目，每个条目都可以单独设置数量、名称、生命值、效果和装备表。

{
"contracts": [

{

"structures": [

"minecraft:pillager_outpost"

],

"reward_table": "example:elite_rewards",

"search_radius": 3000,

"spawn_min_radius": 0,

"spawn_max_radius": 24,

"elites": [

{

"entity": "minecraft:vindicator",

"min": 1,

"max": 1,

"name": "The Iron Captain",

"max_health": 80,

"equipment_table": "example:elite_raiders",

"effects": [

{

"id": "minecraft:strength",

"duration_seconds": 3600,

"amplifier": 1

}

]

}

]

}

]

}

奖励表存放在对应悬赏类别的 reward_tables 文件夹中：

{
"rolls": {

"min": 1,

"max": 2

},

"rewards": [

{

"type": "item",

"id": "minecraft:emerald",

"weight": 4,

"base_min": 1,

"base_max": 3,

"per_kill_min": 0.2,

"per_kill_max": 0.5

},

{

"type": "xp",

"weight": 2,

"base_min": 20,

"base_max": 40,

"per_kill_min": 8,

"per_kill_max": 12

}

]

}

rolls用于控制按权重抽取的条目数量。交付类奖励表可以使用 per_item_min 和 per_item_max 作为 per_kill_min 和 per_kill_max 的别名。

装备表采用与团队狩猎相同的加权槽位格式。例如：

{
"slots": {

"right_hand": [

{

"id": "minecraft:iron_hoe",

"weight": 1,

"enchantments": [

{

"id": "minecraft:knockback",

"min_level": 3,

"max_level": 3

}

]

}

],

"helmet": [

{

"id": "minecraft:sculk",

"weight": 1

}

]

}

}

支持的槽位名称包括 right_hand、left_hand、mainhand、offhand、helmet、chestplate、leggings 和 boots。每个已配置的槽位都会独立进行抽取。如果某个槽位有时应明确留空，请将 minecraft:air 用作加权条目。