1. 从“铁匠”到“创世神”:自定义进度系统的无限可能
在Minecraft的世界里,原版的进度系统就像一本官方指南,引导你一步步体验挖矿、下界探险、击败末影龙等经典旅程。但如果你是一位数据包开发者,或者是一个服务器的管理者,你肯定不满足于此。你想为你的玩家设计一套独一无二的冒险故事,你想让“成为顶级附魔师”或“建造一座宏伟城堡”成为可以追踪和庆祝的里程碑。这时,自定义进度系统就是你手中最强大的叙事和激励工具。
简单来说,数据包中的进度系统,允许你定义一套全新的“成就树”。你可以设定任何你想要的触发条件——不仅仅是合成物品,还可以是玩家到达某个坐标、击败某种自定义生物、甚至是在聊天框里输入了特定密语。当条件满足时,你可以给予玩家丰厚的奖励:大量的经验、解锁隐藏的合成配方,或者直接运行一个函数,给玩家发放一套神装、传送他去一个秘密基地,甚至改变游戏规则。这不再是简单的“成就解锁”,而是一个高度可编程的游戏内任务与奖励引擎。
我刚开始折腾数据包时,觉得进度JSON文件那一大堆嵌套结构看得人头大。但实际摸爬滚打几年下来,我发现它其实逻辑非常清晰,一旦掌握了核心的几块“积木”,你就能像搭乐高一样,构建出极其复杂的成就体系。这篇文章,我就把我这些年踩过的坑、总结的最佳实践,用最“小白”的方式分享给你,让你也能轻松成为自己世界的“规则制定者”。
2. 进度系统的基石:理解JSON文件的结构
在动手写代码之前,我们得先搞清楚进度文件到底长什么样,以及它放在哪里。这就像盖房子要先看图纸一样重要。
2.1 文件位置与命名空间
所有自定义进度文件都放在数据包的 data/<命名空间>/advancement/ 目录下。这个“命名空间”就是你数据包的身份证,用来区分不同作者或不同功能模块的内容。比如,我的数据包命名空间是 my_pack,那么我的第一个进度文件路径可能就是 data/my_pack/advancement/get_started.json。在游戏里,这个进度的完整ID就是 my_pack:get_started。
这里有个非常实用的技巧:你可以在 advancement 文件夹下创建子文件夹来分类管理你的进度。例如,你可以创建一个 data/my_pack/advancement/mining/ 文件夹,里面专门放所有与采矿相关的进度文件。这样,一个进度文件的实际路径可能是 data/my_pack/advancement/mining/deep_digger.json,其游戏内ID相应地就是 my_pack:mining/deep_digger。这种结构对于管理几十上百个进度时,能让你保持清醒的头脑。
2.2 进度JSON的核心骨架
一个进度JSON文件主要由四大块构成:display(显示信息)、criteria(达成准则)、requirements(需求列表)和 rewards(奖励)。我们拆开来看。
display 块: 这是进度的“脸面”,决定了它在游戏界面里看起来怎么样。里面包含了:
icon:进度图标,可以指定物品、数量,甚至是有附魔光效或自定义名称的物品。title和description:进度的标题和描述,支持JSON文本格式,可以变色、加粗。frame:图标边框样式,有task(任务,默认)、goal(目标)、challenge(挑战)三种。challenge完成时有特殊的音效,描述文字会变成紫色,非常适合用来标记终极成就。background:仅用于根进度,用来设置整个进度标签页的背景纹理图。show_toast和announce_to_chat:控制完成时是否在屏幕右上角弹出提示,以及在聊天栏广播。hidden:进度在完成前是否对玩家隐藏。用来制作“惊喜”成就或彩蛋非常合适。
criteria 块: 这是进度的“大脑”,定义了达成进度需要满足的条件。你可以把它理解为一组检测器。每个检测器都有一个自定义的名字(比如 get_diamond)和一个 trigger(触发器)。Minecraft提供了几十种内置触发器,如 minecraft:inventory_changed(背包变化)、minecraft:recipe_crafted(合成配方)、minecraft:player_killed_entity(击杀实体)等等。每个触发器还有自己的 conditions(条件),用来细化检测,比如“背包变化”这个触发器,可以限定变化的物品必须是“钻石”。
requirements 块: 这是进度的“逻辑电路”,它规定了 criteria 中列出的多个条件之间是“与”(AND)还是“或”(OR)的关系。它的结构是一个二维数组。[["条件A"], ["条件B"]] 表示条件A 或 条件B满足一个即可。而 [["条件A", "条件B"]] 则表示必须同时满足条件A 与 条件B。这个设计让你能实现非常灵活的逻辑组合。
rewards 块: 这是玩家完成进度后的“甜头”,也是驱动玩家去完成进度的核心动力。奖励可以包括:
experience:直接给予经验值。recipes:解锁原版或数据包自定义的合成配方。function:这是最强大的一点,可以运行一个数据包函数(function)。这意味着你可以通过命令做任何事情:给予自定义物品、传送玩家、播放音效、改变游戏模式……奖励的想象力由此被无限放大。
3. 动手实战:构建你的第一个进度树
理论讲得再多,不如亲手写一个。我们就以打造一个“铁匠大师”职业进度线为例,从头开始构建一个包含根进度和多个叶子进度的完整体系。
3.1 创建根进度:一切的起点
每个进度标签页都需要一个“根进度”(Root Advancement)。它就像是成就树的树干,所有其他进度都从它这里分支出去。根进度文件通常命名为 root.json。
假设我们的命名空间是 blacksmith,那么我们在 data/blacksmith/advancement/ 下创建 root.json 文件。
{
"display": {
"icon": {
"id": "minecraft:iron_ingot",
"count": 1
},
"title": "铁匠学徒",
"description": "获得你的第一块铁锭",
"background": "minecraft:textures/block/iron_block.png",
"frame": "task",
"show_toast": true,
"announce_to_chat": true,
"hidden": false
},
"criteria": {
"obtain_iron": {
"trigger": "minecraft:inventory_changed",
"conditions": {
"items": [
{
"items": "minecraft:iron_ingot"
}
]
}
}
},
"requirements": [
[
"obtain_iron"
]
],
"rewards": {
"recipes": [
"minecraft:iron_sword",
"minecraft:iron_pickaxe"
],
"experience": 50
}
}
我们来逐行解析这个文件:
- 显示部分:图标是铁锭,标题和描述一目了然。
background设置了铁块的纹理作为这个进度标签页的背景,让整个界面主题统一。 - 准则部分:我们定义了一个名为
obtain_iron的准则。它使用inventory_changed触发器,检测玩家物品栏的变化。条件 (conditions) 是:变化的物品中需要包含 (items) 铁锭 (minecraft:iron_ingot)。这意味着玩家无论是挖矿获得、还是从箱子裡找到、或是村民交易得到铁锭,都能触发。 - 需求部分:
[["obtain_iron"]]表示只需要满足这一个准则即可。 - 奖励部分:玩家完成此进度后,将自动解锁铁剑和铁镐的合成配方(如果还没解锁的话),并立即获得50点经验值。
把这个文件放进数据包,在游戏里输入 /reload 重载数据包,然后获取一个铁锭试试。你会看到成就弹出,配方书里铁剑和铁镐的配方也亮了起来。恭喜,你的第一个自定义进度生效了!
3.2 添加叶子进度:延伸你的故事线
有了根,我们就可以生长枝叶了。叶子进度必须通过 parent 字段指定它的父进度是谁。
我们在 advancement 文件夹下创建第二个文件 forge_iron_block.json,目标是让玩家合成一个铁块。
{
"display": {
"icon": {
"id": "minecraft:iron_block",
"count": 1
},
"title": "积铁成块",
"description": "合成一个铁块",
"frame": "task",
"show_toast": true,
"announce_to_chat": true,
"hidden": false
},
"parent": "blacksmith:root",
"criteria": {
"craft_iron_block": {
"trigger": "minecraft:recipe_crafted",
"conditions": {
"recipe_id": "minecraft:iron_block"
}
}
},
"requirements": [
[
"craft_iron_block"
]
],
"rewards": {
"experience": 100
}
}
注意看,这里多了一个 "parent": "blacksmith:root"。这行代码告诉游戏,这个进度是 blacksmith:root 进度的子节点。在游戏进度界面里,它会从“铁匠学徒”这个图标延伸出来。触发器换成了 recipe_crafted,并指定了配方ID,确保玩家必须是通过工作台合成的方式获得铁块才算数。
3.3 实现分支与复杂条件
现在,假设我们想让玩家在成为“铁匠”的道路上有两个分支选择:一个是成为武器大师(制作铁剑),另一个是成为防具大师(制作铁胸甲)。并且,我们希望“积铁成块”是这两个分支的共同前提。
我们需要创建两个新的进度文件,它们的 parent 都指向 blacksmith:forge_iron_block。
武器大师进度 (master_swordsmith.json):
{
"display": {
"icon": {
"id": "minecraft:iron_sword",
"count": 1
},
"title": "武器大师",
"description": "打造并附魔一把铁剑",
"frame": "goal",
"show_toast": true,
"announce_to_chat": true,
"hidden": false
},
"parent": "blacksmith:forge_iron_block",
"criteria": {
"craft_sword": {
"trigger": "minecraft:recipe_crafted",
"conditions": {
"recipe_id": "minecraft:iron_sword"
}
},
"enchant_sword": {
"trigger": "minecraft:enchanted_item",
"conditions": {
"item": {
"items": "minecraft:iron_sword"
}
}
}
},
"requirements": [
["craft_sword", "enchant_sword"]
],
"rewards": {
"function": "blacksmith:rewards/master_sword",
"experience": 200
}
}
这个进度文件有几个关键点:
- 多个准则:我们在
criteria里定义了两个准则:craft_sword(合成铁剑)和enchant_sword(附魔铁剑)。 - “与”逻辑需求:注意
requirements部分是[["craft_sword", "enchant_sword"]]。这个外层数组只有一个内层数组,内层数组里包含了两个条件。这表示玩家必须同时满足合成铁剑 与 附魔铁剑这两个条件,进度才能达成。这是一种“与”(AND)关系。 - 函数奖励:奖励部分没有给经验或配方,而是调用了一个函数
blacksmith:rewards/master_sword。这是我们实现复杂奖励的关键。
相应地,你可以创建 master_armorer.json,要求玩家合成并穿上一件铁胸甲,触发器可以使用 minecraft:recipe_crafted 和 minecraft:inventory_changed(条件为装备槽位是胸甲且物品是铁胸甲)。
4. 进阶技巧:让奖励系统“活”起来
仅仅给予经验和解锁配方,时间长了玩家可能会觉得乏味。而 function 奖励能将进度系统与数据包的其他部分(如命令、战利品表、谓词)深度结合,创造出动态、个性化且令人难忘的奖励体验。
4.1 编写函数奖励:发放自定义神器
上面我们提到了一个函数奖励 blacksmith:rewards/master_sword。现在我们来创建这个函数文件。
在数据包中创建 data/blacksmith/functions/rewards/master_sword.mcfunction。
# 给达成“武器大师”进度的玩家发放一把自定义铁剑
advancement revoke @s only blacksmith:master_swordsmith
give @s iron_sword{display:{Name:'[{"text":"大师之刃","italic":false,"color":"gold"}]', Lore:['[{"text":"由传奇铁匠亲手锻造","color":"gray"}]','[{"text":"锋利 V | 横扫之刃 III","color":"dark_purple"}]']}, Enchantments:[{id:sharpness, lvl:5}, {id:sweeping_edge, lvl:3}], CustomModelData:10001, Unbreakable:1b} 1
# 播放一个庆祝音效
playsound entity.player.levelup master @s ~ ~ ~ 1 1.5
# 在玩家头顶显示特效粒子
particle minecraft:totem_of_undying ~ ~2 ~ 0.5 1 0.5 0.1 50 force
# 发送一条私密的祝贺消息
tellraw @s {"text":"恭喜你晋升为武器大师!这是你的专属奖励。","color":"green"}
这个函数做了以下几件很酷的事情:
- 首先收回进度:
advancement revoke ...这一行是可选的,但它可以防止玩家通过某些手段重复触发奖励函数,确保奖励的唯一性。 - 给予一件高度自定义的物品:这把铁剑拥有金色的自定义名称、描述 lore、附魔(锋利V和横扫之刃III)、自定义模型数据(
CustomModelData)以及“无法破坏”的属性。这完全超越了原版游戏的奖励范畴。 - 营造氛围:通过
playsound播放升级音效,用particle命令在玩家周围生成不死图腾复活时的绿色粒子,从视觉和听觉上强化成就达成的喜悦感。 - 个性化反馈:使用
tellraw向玩家发送一条私聊的彩色祝贺信息。
通过函数,你的奖励可以是任何命令能实现的事情:传送玩家到一个隐藏房间,授予一个临时或永久的状态效果(如“英雄村庄”效果),甚至为玩家在某个计分板上增加“大师点数”。
4.2 利用谓词实现更复杂的触发条件
原版进度触发器虽然丰富,但有时仍有限制。比如,你想做一个“连续击杀10只苦力怕不死亡”的成就,原版触发器就难以直接实现。这时,就需要结合“谓词”(Predicate)。
谓词是数据包中用于复杂条件判断的JSON文件,它可以检测玩家分数、实体距离、时间、天气等几乎任何游戏状态。进度系统可以调用谓词作为条件的一部分。
例如,我们创建一个谓词 data/blacksmith/predicates/killed_10_creepers.json,它通过检查一个假名计分板 creeperKillStreak 的分数来判断。
{
"condition": "minecraft:entity_scores",
"entity": "this",
"scores": {
"creeperKillStreak": {
"min": 10
}
}
}
然后,在你的进度文件中,可以在 criteria 的 conditions 里引用这个谓词。不过,更常见的做法是配合 minecraft:tick 触发器。tick 触发器每游戏刻都会触发,我们可以用它来持续检测某个条件是否满足。
"criteria": {
"creeper_master": {
"trigger": "minecraft:tick",
"conditions": {
"player": [
{
"condition": "minecraft:entity_properties",
"entity": "this",
"predicate": {
"type_specific": {
"type": "player"
},
"location": {},
"stepping_on": {},
// 这里可以组合多个条件,例如玩家必须活着
"health": {
"min": 1
}
}
}
]
}
}
}
但是,tick 触发器本身不携带谓词条件。更强大的组合是使用函数来检测:创建一个每刻或每秒运行的循环函数,它检查玩家的 creeperKillStreak 分数,当分数达到10时,直接使用 advancement grant 命令授予玩家进度。这种方式将触发逻辑从静态的JSON文件转移到了动态的命令函数中,实现了几乎无限的可能性。
5. 避坑指南与最佳实践
在我多年的开发中,积累了一些容易出错的地方和效率技巧,分享给你能少走很多弯路。
路径与引用错误:这是新手最常见的问题。确保进度JSON文件放在正确的 advancement 文件夹下,并且 parent 字段的引用格式正确。格式是 <命名空间>:<路径>,路径相对于 advancement 文件夹,且不需要 .json 后缀。例如,data/mypack/advancement/combat/kill_dragon.json 的ID是 mypack:combat/kill_dragon。
触发器条件理解偏差:仔细阅读Wiki上每个触发器的具体条件。比如 player_hurt_entity(玩家伤害实体),判断武器类型的条件必须写在 damage 字段下的 source_entity 里,如果错误地写在顶层的 player 条件里,进度将永远无法触发。我早期就曾在这里卡了好几个小时。
合理使用生成器与手动编辑:像 Misode's Advancement Generator 这样的在线工具非常适合快速搭建进度框架和预览UI。但是,对于复杂的条件、尤其是涉及函数奖励和谓词引用的部分,手动编辑JSON往往更可靠。我的工作流通常是:用生成器做出UI和基础结构 -> 复制到代码编辑器 -> 手动添加复杂的 conditions 和 rewards 部分。
性能考量:避免滥用 minecraft:tick 作为进度触发器。如果确实需要持续检测,最好通过数据包中的计时器函数(schedule 命令)来低频次检测,并在条件满足时用命令授予进度,而不是让成千上万的 tick 触发器每刻都运行。
保持可读性与可维护性:为你的进度和准则起一个清晰、一致的名字。使用子文件夹分类管理进度文件。在复杂的函数奖励中多写注释。几个月后当你回头修改数据包时,你会感谢当初有条理的自己。
测试,测试,再测试:进度系统与游戏状态紧密相连,一个条件设置不当就可能让进度无法触发或错误触发。在创造模式中,多使用 /advancement grant 和 /advancement revoke 命令来测试进度的授予与回收。使用 /tellraw 或 /say 在函数奖励中输出调试信息,确保奖励逻辑按预期执行。
自定义进度与奖励系统是Minecraft数据包开发中最能体现创意和设计能力的部分之一。它不仅仅是给玩家几个成就图标,更是塑造游戏体验、讲述专属故事、设计经济与成长体系的核心工具。从简单的“获得第一个木头”到复杂的“在不使用工作台的情况下通关游戏”,只要你敢想,这套系统都能帮你实现。希望这篇指南能帮你打开这扇门,剩下的,就交给你的想象力去驰骋吧。
473



被折叠的 条评论
为什么被折叠?



