物品锻造

Itemsmith

一个面向 Minecraft 1.21.1 的 NeoForge 游戏内物品编辑器，专为一项任务而构建：制作独特的物品，在活动结束后发放给玩家。

打开手持物品上的编辑器，随心修改，赋予它光环、能力以及专属提示框，然后将其作为编号限量版保存到库中。日志会记录谁收到了哪个编号。

一切以服务端为准。客户端负责绘制界面并提交请求；服务端会针对每一次改动所触及的权限节点进行计费，并拒绝其余部分。

编辑器

七个标签页，通过 /itemsmith edit 打开。

• 外观 —— 名称、描述、稀有度、显示选项、3D 模型，以及名称或描述行上的颜色渐变。
• 属性 —— 耐久度、属性修饰符、附魔，每项均受配置上限约束。
• 组件 —— 食物、药水与物品规则：灵魂绑定、所有者锁定、过期。
• 能力 —— 由触发器、形态、动作及其调校组合而成，下方以通俗语言呈现结果，让你看清自己刚刚构建了什么。
• 光环 —— 17 种图案、14 种自定义粒子、7 层音效，以及手持、穿戴或掉落的可选方式，并带有实时预览，其绘制公式与世界中的完全一致。
• 提示框 —— 9 个现成面板，以及一个可重新排列其构建行的编辑器，下方实时渲染真实的提示框。
• 原始 NBT —— custom_data 标签，用于标签页未覆盖的内容。

内含十二个初始模板，让奖励只需一击即可完成。

独特物品

3D 模型。 十个原创武器模型和五个扁平奖杯。每把武器都是依照绘制轮廓堆叠的盒子，并带有承载光效与装饰的动画层。没有任何借用：所有随附资源均为原创。

光环。 完全在客户端绘制，因此不占用服务端任何开销。图案可以紧贴剑刃环绕、在穿戴者周围松散垂挂，或在地面上减半。

提示框。 面板由矩形和物品自身的强调色绘制而成，因此无需随附任何纹理，且任意颜色都能使用。行可以重新排序、对齐和关闭。

库、日志与撤销

将完成的物品保存为编号版本，通过命令或界面发放副本，并可回查谁获得了哪个编号。提示框可以显示编号，也可以将其保密，仅限工作人员查看。

如果某个奖励被证明是个错误，撤销它会在在线玩家身上移除该物品，其他玩家则在下次登录时移除，并会在某人下次打开箱子时销毁仍存放在其中的任何副本。账本会记录执行实际拦截到的内容，因此“是否已处理？”有据可答。

权限

八个节点，可通过 LuckPerms 或作为后备的操作等级授予：edit、appearance、stats、components、abilities、visuals、library、nbt。一次编辑会针对其触及的每个节点计费，因此仅有 itemsmith.appearance 的人只能重命名物品，别的什么也做不了。

命令

命令	作用
/itemsmith edit	打开手持物品的编辑器
/itemsmith journal	打开所有编辑与发放的日志
/itemsmith trace	在聊天中说明手持物品的来源
/itemsmith library	打开已保存物品的库
/itemsmith give <player> <id>	将库中的条目发放给玩家

性能

服务端代码遵循三条规则：不在 tick 上做任何工作、不做任何与世界大小成正比的事、对未配置任何内容的情况提前退出。检查容器中是否存在被撤销物品，对双箱而言耗时不到一微秒，而在从未撤销过任何内容的服务器上则完全无开销。

需求

Minecraft 1.21.1、NeoForge 21.1.0 或更高版本、Java 21。LuckPerms 可选。请在服务端以及所有需要看到模型、光环和提示框的客户端上安装。