TACZ工坊

TACZ Workshop 提供游戏内工具，用于调整已安装的 TACZ 内容并管理枪械工坊配方。整合包作者可以调节武器数据、控制可用条目、构建带有 NBT 结果的配方，并选择由哪些工坊提供这些配方。

安装与访问

组件	要求
Minecraft	本模组面向 1.20.1
Forge	47.4.2 或更高版本
KineticCore	26.9.20 或更高版本；必需
Timeless and Classics Zero (TACZ)	必需
Sophisticated Backpacks / Sophisticated Core	可选的背包兼容性
LR Tactical 内容	对应近战、投掷物和消耗品数据类别所需

在客户端和服务器上均安装本模组及所需依赖，以用于多人游戏。按 F6 打开 KineticCore 的配置中心，然后打开 TACZ Workshop 的数据管理器或配方管理器。F6 是默认的共享配置按键。

编辑器会读取并修改服务器数据。打开服务器快照和提交修改需要权限等级 2。本地预览并不能证明服务器更改已被接受。

浏览与调整内容数据

数据管理器可按显示名称、物品 ID 或数据 ID 进行搜索，并将条目分为已启用、已修改和已禁用。已修改的条目会被标记，以便在原始枪械包内容中再次找到它们。

类别	存在时可编辑的数据示例
枪械	伤害、射速、弹匣容量、弹丸速度/重力、爆头倍率、散布、装填与操作时间
配件	其现有的数值、文本和布尔数据字段
弹药	现有弹药数据，如堆叠数量及相关属性
LR Tactical 近战	攻击伤害/倍率、冷却时间、耐久消耗、移动和碰撞箱属性
LR Tactical 投掷物	投掷速度、引信/存活时间、弹跳、爆炸、眩晕和云属性
LR Tactical 消耗品	使用时间、食物/治疗数值、效果、冷却时间和耐久消耗

字段源自所选条目的数据。详情界面支持属性搜索并显示数据路径，有助于区分名称相似的字段。可用属性取决于已安装的内容；此工具编辑现有定义，而不提供新的模型、纹理或动画。

对于枪械，配件类型控制可以允许或阻止受支持的配件类别，例如瞄准镜、枪口、枪托、握把、激光和扩展弹匣。

“禁用”会在更改应用后从相应内容索引中隐藏该条目。“恢复”会撤销禁用状态。“重置”会清除 Workshop 覆盖并还原原始整合包数据；它与简单地重新启用已编辑条目不同。

以批处理方式保存数据

1. 打开一个条目并更改所需字段。
2. 返回列表并根据需要编辑其他条目。详情编辑会暂存在客户端编辑会话中。
3. 使用数据管理器中的“全部保存”将暂存的更改一起提交。
4. 等待服务器验证、文件写入和重载结果，然后再测试内容。

批处理流程会将待处理编辑与已保存的服务器数据区分开。它还会检查是否已有另一次重载处于待处理状态。重置和禁用状态更改也参与同一暂存工作流。

创建枪械工坊配方

配方编辑器支持枪械、配件、弹药、普通物品以及可用的 LR Tactical 近战/投掷物/消耗品作为输出。选择一个实际输出物品、其数量、配方 ID，以及可选的分组和备注。

• 添加物品或物品标签输入，并分别设置所需数量。
• 为具体物品输入设置部分 NBT 条件；标签输入不直接携带 NBT 条件。
• 为自定义结果设置额外输出 NBT。
• 对于枪械输出，配置已装填弹药和预装配件。
• 根据所选内容验证配件类型和结果类型。
• 复制一个配方以创建新的配方 ID，编辑现有记录，或将其移除。
• 禁用一个自定义配方，同时保留其已保存定义以便日后重用。

配方搜索包括配方 ID、结果 ID、类型和备注。管理器会区分原始配方、Workshop 创建的配方和已移除的配方。

工坊路由与原始配方

工坊选择器按名称和 ID 列出可用的枪械工坊。切换配方可以出现并进行制作的工坊。使用原生路由的配方遵循其原始工坊规则。

编辑原始配方会保存一个 Workshop 替代配方，并将原始配方放入已移除集合。这保留了一种恢复原始配方的方式，而无需修改原始枪械包归档。当你想要恢复原始配方时，请使用配方管理器的恢复操作。

配方保存会立即生效：在服务器验证后，配方存储会更新，运行时配方/路由状态会同步。这与数据管理器的暂存式“全部保存”工作流不同。

验证与兼容性

配方验证会检查 ID、材料/结果结构、数量、结果类型和 NBT。预检流程还会在配方反序列化之前隔离格式错误的 TACZ 配方候选，并记录受影响的配方 ID 和原因以供诊断。这并不保证每个第三方枪械包都兼容。

安装 Sophisticated Backpacks 后，兼容层会在 TACZ 装填检查、消耗和弹药显示中纳入受支持物品栏背包中持有的弹药。该可选集成不仅仅是编辑器物品选择器；它会影响游戏过程中的弹药可用性。

存储与整合包分发

文件	用途
config/kineticcore/taczdata.json	内容数据覆盖和禁用状态
config/kineticcore/taczrecipes.json	Workshop 配方和原始配方移除状态
对应的 .json.bak 文件	适用时由存储维护的备份副本

这些是实例级配置文件。请保留原始 TACZ/LR Tactical 整合包安装：覆盖会引用其内容 ID。在复现配置时，请一并分发匹配的内容包和 Workshop 配置。

如果保存失败，请检查服务器消息/日志，并检查 ID、材料数量、NBT 以及所引用内容是否已加载。如果某个工坊缺少某个配方，还请检查其启用状态、原始/替代状态以及工坊选择。

实现参考：数据种类、暂存编辑、配方存储以及服务器验证与保存。

许可证：LGPLv3。依赖项：mods.toml。