预设

高级预设

旧版 Java 命令预设迁移

旧版 Java 命令预设迁移如今已是完整的高级工作流程，不再只是套模板的命令说明。当旧的 Command Pack 必须从过时的 Java 范例迁移到当前的 NBTForge 输出时，就使用这个预设。迁移要从物品或实体的意图出发，而不是盲目地做字符串替换，这样最终完成的命令更容易复核。本文把设置字段、输出审阅、Project 归位和结果截图整合到一起，让命令在成为地图设置、事件触发器或可复用 Command Pack 的一部分之前就能被检视清楚。审阅界面应同时呈现导入的旧命令、重建后的现代输出，以及二者之间的差异。这正是把语法迁移变成可控工作流程、而不是高风险单行编辑的关键所在。

阅读语言ENRUDEESPT中文日本語VIFR한국어IDPLTR

预设结果

一套把旧的 Java 物品意图转换为带审阅注释的当前组件输出的迁移工作流程。

输出

从旧版到当前版本的迁移说明

Legacy command intent: named sword with lore, sharpness, unbreakable, and custom marker.
Modern rebuild: /give @p minecraft:diamond_sword[custom_name={text:"Legacy Blade",color:"gold",italic:false},lore=[{text:"Migrated component item",color:"gray",italic:false}],enchantments={"minecraft:sharpness":5},unbreakable={},custom_data={legacy_item:1}] 1
Review: compare old NBT fields to current components before replacing the saved Project entry.
Too long for Minecraft chat

The longest command line is 259 characters, 3 over the 256-character chat input limit. Pasting it into chat can truncate the line and make Minecraft report a syntax error even when the generated command is valid.

  • Use a Command Block: run /give @s command_block, place it, then paste this command into the block command field.
  • Use a .mcfunction for a reusable datapack: save the line without the leading slash at saves/<world>/datapacks/<pack>/data/<ns>/function/<name>.mcfunction with a minimal pack.mcmeta, run /reload, then run /function <ns>:<name>. Do not paste .mcfunction content into chat.

预设截图

从用于定义预设状态的高级控件开始。
第二张截图突出展示了那些会改变面向玩家行为的设置或配套命令。
输出截图在最终命令或命令组进入 Project 之前让它们保持可见。

构建预设

  1. 粘贴或记录下旧命令的意图。
  2. 选择与该命令家族对应的当前 NBTForge 模块。
  3. 依据字段重建物品、实体或数据包资源。
  4. 在差异面板中比较旧的 NBT 与现代的输出。
  5. 把迁移后的命令保存为独立的 Project 条目。
  6. 只有在新输出经过测试之后，才用它替换旧命令。

为什么这个高级预设属于 Project

当旧的 Command Pack 必须从过时的 Java 范例迁移到当前的 NBTForge 输出时，就使用这个预设。迁移要从物品或实体的意图出发，而不是盲目地做字符串替换，这样最终完成的命令更容易复核。

审阅界面应同时呈现导入的旧命令、重建后的现代输出，以及二者之间的差异。这正是把语法迁移变成可控工作流程、而不是高风险单行编辑的关键所在。复制出去的命令只有在周围的假设都可见时才有用：选择器范围、世界状态、命令包内部的执行顺序，以及将要粘贴进 Minecraft 的精确输出。把这个预设视作一个检查点，让这些细节在命令离开 NBTForge 之前都能被审阅。

图集就是围绕这种复核思路构建的。第一张截图展示 Workbench 状态，第二张截图点出改变面向玩家行为的字段或配套模块，输出截图则让命令或命令组保持可见。当预设有可见的实际效果时，游戏内的截图会在还原好的测试世界里再次确认同一思路，而不是依赖通用的占位画面。

测试与范围把控

有些旧版 NBT 概念可以直接映射到现代组件，有些要迁移到 `custom_data` 中，还有一些则需要彻底重新设计。请逐个命令家族分别重建并测试，不要做全局文本替换。

用收窄的选择器和干净的世界状态跑第一轮冒烟测试。环境、工具、路由和反馈类命令看起来无害，但它们往往会影响每一名玩家或整个世界。先确认命令只会改变预期中的那部分状态，然后再把准确的输出连同设置行或解释其存在原因的说明行一起保存。

如果命令将成为函数文件或命令方块链条的一部分，请测试复制出来的成品，而不仅是 Workbench 的实时状态。这样才能发现陈旧的选择器、错误的命令顺序、缺失的设置行，以及那些只是因为前一次测试残留状态才显得有效的效果。

  • 在整包审阅完成之前，始终把选择器范围保持得很窄。
  • 把世界设置类命令放在战斗或事件专用的覆盖命令之前。
  • 把反馈命令保存在触发它们的状态变更旁边。

下一步去哪里

一次迁移一条已保存的 Project 条目，并保留旧的输出，直到新命令在干净的测试世界里通过验证。

针对具体物品类的迁移，请对照 Java 1.20.4 物品 NBT 预设指南 和 Java 1.21 物品组件预设指南。

FAQ

可以直接把这条高级命令粘贴到聊天里吗？

如果选择器足够安全、命令也不长，做单条命令的冒烟测试通常没问题。若是要可重复使用的成熟行为，请把它存进 Project 并复制有序的命令包或函数风格的输出。

为什么这个图集里只有界面截图？

这个预设产出的是 JSON、Project 组织方式或审阅工作流程，而不是世界里可见的实际物体。有用的证据是 Workbench 状态、输出和它在 Project 中的位置。

分享这个预设之前应该检查些什么？

检查选择器范围、命令顺序、目标版本，以及该命令到底属于设置、遭遇逻辑、反馈还是清理阶段。这些分类决定了它在 Project 命令包中的位置。

打开这个工作流

从相关 Advanced 工作台开始，然后按你的世界调整预设字段。