数据包预设
自定义奖励 Item Modifier 预设
自定义奖励的 Item Modifier 预设如今是一整套完整的 Data Pack 工作流程，而不再是一段模板化的命令注释。当奖励物品应当在战利品生成之后再由数据包逻辑去塑形时，请使用这个预设。Item Modifier 让战利品表、`/item modify` 和奖励函数共享同一套物品造型，而不必在多条命令字符串里重复抄写自定义名称、描述文本 (lore)、稀有度和自定义数据。本文把设置字段、输出审查、Project 归位以及结果截图整合在一起，让命令在成为地图设置、事件触发器或可复用 Command Pack 的一部分之前，容易被审计。Data Pack 工作台把 modifier 函数、命名空间、路径和物品文本字段串联在一起。这一点至关重要，因为修改器通常会从另一个资源被引用，所以路径和 JSON 主体一样重要。
预设结果
一份物品修改器资源，把生成的奖励塑形为一枚命名好的任务勋章。
输出
奖励物品修改器 JSON
data/nbtforge/item_modifier/rewards/quest_medal.json
{
"function": "minecraft:set_components",
"components": {
"minecraft:custom_name": {
"text": "Crypt Medal",
"color": "gold",
"italic": false
},
"minecraft:lore": [
{
"text": "Awarded for clearing the crypt",
"color": "gray",
"italic": false
}
],
"minecraft:rarity": "rare",
"minecraft:custom_data": {
"quest_reward": "crypt_clear"
}
}
}预设截图
构建预设
- 打开 Data Pack 工作台，选择 Item Modifier。
- 把命名空间设为 `nbtforge`，资源路径设为 `rewards/quest_medal`。
- 当奖励需要名称、描述文本 (lore)、稀有度或自定义数据时，选择 `set_components`。
- 在物品组件编辑器里填入面向玩家的奖励文本。
- 审查生成的 JSON，并复制其路径。
- 在战利品、进度或 `/item modify` 流程里引用这个修改器。
- 把修改器路径和使用它的命令一起保存到 Project。
为什么这个 Data Pack 预设应进入 Project
当奖励物品应当在战利品生成之后再由数据包逻辑去塑形时，请使用这个预设。Item Modifier 让战利品表、`/item modify` 和奖励函数共享同一套物品造型，而不必在多条命令字符串里重复抄写自定义名称、描述文本 (lore)、稀有度和自定义数据。
Data Pack 工作台把 modifier 函数、命名空间、路径和物品文本字段串联在一起。这一点至关重要，因为修改器通常会从另一个资源被引用，所以路径和 JSON 主体一样重要。复制出来的命令只有在周围假设可见时才有用：选择器范围、世界状态、包内顺序，以及将要粘贴进 Minecraft 的确切输出。把这个预设当作检查点，让这些细节在命令离开 NBTForge 之前接受审查。
整组截图就是围绕这种审查思路而设计的。第一张展示工作台状态，第二张点出改变面向玩家行为的字段或配套模块，输出截图保留最终命令或命令对。当预设有可见结果时，游戏内截图会在恢复的测试世界中确认同一个结论，而不是靠通用素材敷衍了事。
测试与范围审查
请把展示文本和检测数据分开。出于平衡或本地化的需要，名称可以变化，但 `custom_data.quest_reward` 应当保持稳定，这样其他命令才能持续地把这件物品识别为奖励。
用窄选择器和干净的世界状态做第一次冒烟测试。环境、实用、路由和反馈类命令看起来无害，但它们往往会影响每一位玩家或整张世界。先确认命令只改变预期的状态，再把确切的输出和设置行或解释行一起保存。
如果命令将进入函数文件或命令方块链，请测试复制出来的成品，而不仅是当前工作台状态。这样才能抓出过期的选择器、错误的命令顺序、漏掉的设置行，以及那些只因前一次测试残留状态而显得有效的效果。
- 在完整审过整个包之前，始终把选择器范围收窄。
- 把世界级设置放在战斗专用覆盖之前。
- 把反馈命令紧挨着触发它们的状态变化保存。
接下来用在哪里
只有当独立的 JSON 能被正确读取之后，再把修改器挂到战利品表条目或物品命令上。
如需相关的奖励方案，可对比进度奖励预设指南与Boss 掉落战利品表预设。
FAQ
我可以直接把这条 Data Pack 命令粘进聊天框吗？
如果选择器安全、命令行不长，做一次性冒烟测试通常没问题。但若要复用为地图行为，请把它保存到 Project，并复制有序的包或函数式输出。
为什么这组截图只展示界面？
这个预设生成的是 JSON、项目结构或审查流程，而不是某个可见的现实物体。真正有用的证据是工作台状态、输出和 Project 归位。
在分享这个预设之前，我应该核对哪些内容？
核对选择器范围、命令顺序、目标版本，以及这条命令到底属于设置、战斗逻辑、反馈还是清理。这些分类决定了它在 Project 包中的位置。
打开这个工作流
从相关 Data Pack 工作台开始，然后按你的世界调整预设字段。