CustomCrafting v5 Alpha 4

v5 是对整个插件及配方结构的全面重写与重新设计。
它新增了诸多在 v4 中无法实现的功能与改进。

近年来，《我的世界》发生了巨大变化，新的模组/插件平台不断涌现，或从原有项目中独立出来。
如今，让插件/模组跨平台兼容已成为一项重大挑战——各平台均拥有各自不同的 API。

随着混淆机制的移除，直接使用并基于《我的世界》内部代码进行开发已变得轻松许多。
正因如此，v5 版本的 CustomCrafting 将重心转向直接构建于《我的世界》内部机制之上，而非依赖特定平台的 API。
为确保兼容性，v5 的目标是在尽可能贴近各平台原生机制的前提下完成集成（例如事件系统、监听器、第三方插件/模组），同时保持绝大部分代码库与平台无关。

这正是 scafall 的用武之地。Scafall 支持构建跨平台 API，供其他模组与插件调用，并简化平台特有实现之间的关联整合。

然而，这一切也带来了诸多全新挑战。因此，CustomCrafting 后续版本将仅支持最新版《我的世界》！

简明摘要

• CustomCrafting v5 直接构建于《我的世界》内部机制之上
• 仅支持最新版《我的世界》
• 需依赖 scafall 库/模组 详见发布页面
• 提供跨平台 API

全新文档 Wiki

随 v5 在 社区 上线，我们同步推出全新文档 Wiki，地址如下：
https://wolfyscript.github.io/CustomCrafting/

新版 Wiki 拥有大量视觉优化，并采用 Git 进行管理，相较旧版 GitHub Wiki 更易于维护。

Fabric 服务器支持

v5 新增 Fabric 服务器支持。仅服务端模组允许原版客户端连接至 Fabric 服务器，其体验与 Spigot 类似——玩家无需安装任何客户端模组。

Fabric 实现相较 Spigot/Paper 实现具备诸多优势：
它将具备原版对应物的自定义配方直接整合进原版配方机制，从而实现与现有模组更佳的兼容性，并显著提升配方手册支持效果。

独立的 Paper 版本

本次更新起，我们将为 Paper 单独提供 CustomCrafting 与 scafall 的专用 JAR 文件。
若您使用 Paper，请务必选用该版本，以获得全部改进与额外功能。

当前，该版本独有的功能仅包括切石机配方支持——而 Spigot 版本尚不支持此功能。

新增功能

v5 对资源加载机制与配方结构进行了重大重构。

配置资源来源与加载顺序

资源来源定义了资源的加载位置（本地目录、H2、SQLite、MySQL 等）。
备份目标则定义了创建备份时的保存位置（本地目录或 ZIP 文件）。

全新且增强的配方类型

v5 扩展了所有配方类型的可用功能，尤其针对 v4 中功能较为薄弱的类型进行了重点强化。

提示
本版本内置若干默认配方，用于直观展示部分新特性。
它们将在启动时自动加载，您可在v5 分支中查阅。

增强型铁砧配方

• 重命名选项（格式化名称、前缀与后缀、消耗、修复代价）
• 耐久度组合选项（加成、比例组合）
• 物品修复选项（每物品消耗、附魔保留）
• 附魔选项（附魔保留、升级代价、冲突代价等……）

增强型砂轮配方

• 附魔移除选项
• 附魔合并选项
• 耐久度组合选项
• 修复代价选项

增强型配方物品

• 完整支持原版物品堆栈的 SNBT
• 通过 version 属性支持 DataFixerUpper

增强型命令结果动作

• 完整支持命令上下文
  • 目标选择器：@p、@n、@r、@a、@e、@s
  • 目标选择器参数
• 以及原版命令支持的几乎所有其他功能

高级原料系统

本次更新引入了全新的原料配置选项，可精细控制原料的匹配方式与消耗方式。
这些选项均为可选，若未指定，则默认行为与原版保持一致。
所有选项均拥有独立注册表，第三方插件/模组可为每类选项注册自定义行为。

匹配选项

该类选项用于定义原料候选项如何与物品栏中的源物品堆栈进行匹配。

消耗选项

该类选项用于定义当产出结果被领取或生成时，原料将如何消耗源物品堆栈。

错误追踪

CustomCrafting 内置错误追踪机制，以协助插件/模组的日常维护。
错误追踪集成使问题与异常更加直观可见，并提供插件/模组在实际运行环境中的表现洞察，从而大幅加快缺陷修复与功能优化速度。
更多详情请参阅Wiki 文档。

CustomCrafting v5 Alpha 4

v5 版本对整个插件及配方结构进行了彻底重写与重新设计。
它新增了许多 v4 版本中无法实现的功能与改进。

近年来，《我的世界》发生了诸多变化，新的模组/插件平台不断涌现，或从原有项目中独立出来。
如今，让插件/模组在各类平台上保持兼容已成为一项重大挑战——各平台均拥有彼此不同的 API。

随着混淆层的移除，直接使用并基于《我的世界》内部代码进行开发已变得轻松许多。
正因如此，v5 版本的 CustomCrafting 将重心转向直接构建于《我的世界》内部机制之上，而非依赖特定平台的 API。
为保障兼容性，v5 的目标是在尽可能贴合各平台（如事件系统、监听器、第三方插件/模组）的同时，使其绝大多数代码库保持跨平台通用性。

此时，Scafall 应运而生。Scafall 提供了一套跨平台 API 构建方案，其他模组与插件可直接调用，并更便捷地整合各平台专属实现。

然而，这一切也带来了诸多全新挑战，因此自即日起，CustomCrafting 将仅支持最新版《我的世界》！

简明摘要

• CustomCrafting v5 直接基于《我的世界》内部机制构建功能
• 仅支持最新版《我的世界》
• 需安装 Scafall 库/模组 详见发布页
• 提供跨平台 API

全新文档 Wiki

随 v5 版本在 社区 上线，我们同步推出了焕然一新的官方文档 Wiki：
https://wolfyscript.github.io/CustomCrafting/

新版 Wiki 在视觉呈现上全面升级，并采用 Git 进行管理，相较旧版 GitHub Wiki 更易于维护。

Fabric 服务器支持

v5 正式引入 Fabric 服务器支持。仅服务端模组允许原版客户端直连 Fabric 服务器，其体验与 Spigot 类似——玩家无需安装任何客户端模组。

Fabric 实现相较 Spigot/Paper 实现具备多项优势：
它将具备原版对应物的自定义配方直接集成至原版配方机制中，从而实现与现有模组更深度的兼容，以及更完善的配方手册支持。

Paper 专用独立版本

自本次更新起，我们将为 Paper 专门提供独立的 customcrafting 与 scafall JAR 文件。
若您使用 Paper，请务必选用该版本，以充分获得全部优化与新增功能。

目前，该专用版本额外支持的功能仅包括切石机配方，而此功能在 Spigot 版本中尚未实现。

新增功能

v5 对资源加载机制与配方结构进行了大规模重构。

配置资源来源与加载顺序

资源来源定义了资源的读取位置（本地目录、H2、SQLite、MySQL 等）。
备份目标则定义了备份文件的保存位置（本地目录或 ZIP 文件）。

全新且增强的配方类型

v5 大幅拓展了所有配方类型的可用功能，尤其针对 v4 中功能相对薄弱的配方类型进行了重点强化。

提示
本版本内置若干默认配方，用于直观展示部分新特性。
它们将在启动时自动加载，您可在 v5 分支 中查阅。

增强型铁砧配方

• 重命名选项（格式化名称、前缀/后缀、消耗、修理成本）
• 耐久度组合选项（加成、比例组合）
• 物品修复选项（每件物品的修复成本、附魔保留）
• 附魔选项（附魔保留、升级成本、冲突成本等……）

增强型砂轮配方

• 附魔移除选项
• 附魔合并选项
• 耐久度组合选项
• 修理成本选项

增强型配方物品

• 完整支持原版物品堆栈的 SNBT
• 通过 version 属性支持 DataFixerUpper

增强型命令执行结果动作

• 完整支持命令上下文
  • 目标选择器 @p、@n、@r、@a、@e、@s
  • 目标选择器参数
• 以及原版命令支持的几乎所有其他功能

高级原料配置

本次更新引入了全新的原料选项，允许精细设定其匹配逻辑与消耗方式。
这些选项均为可选，默认值将使其行为与原版保持一致。
所有选项均拥有独立注册表，第三方插件/模组可为每类选项注册自定义行为。

匹配选项

此类选项用于指定原料候选列表如何与物品栏中的源物品堆栈进行匹配。

消耗选项

此类选项用于指定当结果被领取或产出时，原料将如何消耗源物品堆栈。

错误追踪

CustomCrafting 内置错误追踪机制，以辅助插件/模组的日常维护。
错误追踪集成使问题与异常更加清晰可见，并提供插件/模组在实际运行环境中的表现洞察，从而显著加快缺陷修复与功能优化速度。
更多详情请参阅 Wiki 文档。

CustomCrafting v5 Alpha 4

v5 是对整个插件及配方结构的全面重写与重新设计。
它新增了许多 v4 中无法实现的功能与改进。

近年来，《我的世界》发生了诸多变化，新的模组/插件平台不断涌现，或从原有项目中独立出来。
如今，让插件/模组兼容各类平台已成为一项重大挑战——每个平台都拥有各自不同的 API。

随着混淆层的移除，直接使用并基于《我的世界》内部代码进行开发已变得轻松许多。
正因如此，v5 版本的 CustomCrafting 将重心转向直接构建于《我的世界》内部机制之上，而非依赖特定平台的 API。
为保障兼容性，v5 的目标是在各平台上实现尽可能完善的集成（例如事件系统、监听器、第三方插件/模组），同时保持其核心代码库与平台无关。

此时，Scafall 应运而生。Scafall 支持跨平台 API 的创建，其他模组与插件亦可调用，并能更便捷地将各平台专属实现相互关联。

然而，这一切也带来了诸多全新挑战。因此，CustomCrafting 后续版本将仅支持最新版《我的世界》！

简明摘要

• CustomCrafting v5 直接基于《我的世界》内部机制构建功能
• 仅支持最新版《我的世界》
• 需安装 Scafall 库/模组 详见发布页面
• 提供跨平台 API

全新 Wiki

随 v5 在 社区 上线，我们同步推出全新 Wiki，地址如下：
https://wolfyscript.github.io/CustomCrafting/

新版 Wiki 拥有大量视觉优化，并采用 Git 进行管理，相较旧版 GitHub Wiki 更易于维护。

Fabric 服务器支持

v5 新增对 Fabric 服务器的支持。仅服务端模组允许原版客户端连接 Fabric 服务器，其体验与 Spigot 类似——玩家无需安装任何客户端模组。

Fabric 实现相较 Spigot/Paper 实现有诸多优势：
它将具备原版对应物的自定义配方直接整合进原版配方机制，从而实现与现有模组更好的兼容性，并提升配方手册支持效果。

独立的 Paper 版本

自本次更新起，CustomCrafting 与 Scafall 将为 Paper 单独提供专用 JAR 文件。
若您使用 Paper，请务必选用该版本以获得全部改进与额外功能。

目前，此项增强仅包含切石机配方支持——Spigot 版本中尚不支持此功能。

新增功能

v5 对资源加载与配方结构进行了多项重大重构。

配置资源及加载顺序

资源来源定义了资源的加载位置（本地目录、H2、SQLite、MySQL 等）。
备份目标则定义了备份文件的保存位置（本地目录或 ZIP 文件）。

全新且改进的配方

v5 扩展了所有配方类型的可用功能，尤其强化了 v4 中功能相对薄弱的几类配方。

提示
本版本新增若干默认配方，用于演示部分新特性。
它们将在启动时自动加载，您可在v5 分支中查看

改进的铁砧配方

• 重命名选项（格式化名称、前缀与后缀、费用、修理成本）
• 耐久度组合选项（加成、比例组合）
• 物品修理选项（每件物品费用、附魔效果）
• 附魔选项（保留附魔、升级费用、冲突费用等……）

改进的砂轮配方

• 附魔移除选项
• 附魔合并选项
• 耐久度组合选项
• 修理成本选项

改进的配方物品

• 全面支持原版物品堆叠的 SNBT
• 通过版本属性支持 DataFixerUpper

改进的命令结果动作

• 完整支持命令上下文
  • 目标选择器：@p、@n、@r、@a、@e、@s
  • 目标选择器参数
• 以及原版命令支持的几乎所有其他功能

高级配料

本次更新引入了全新的配料选项，允许配置其匹配方式与/或消耗方式。
这些选项均为可选，若未指定则采用默认值，使其行为与原版保持一致。
所有选项均拥有独立注册表，第三方插件/模组可为每种选项类型注册自定义行为。

匹配选项

此类选项指定配料选项如何与物品栏中的源物品堆叠进行匹配。

消耗选项

此类选项指定当结果被领取或生成时，配料将如何消耗源物品堆叠。

错误追踪

CustomCrafting 内置错误追踪功能，以辅助插件/模组的日常维护。
错误追踪集成使问题与错误更加直观可见，并提供插件/模组在实际运行环境中的表现洞察，从而显著加快缺陷修复与功能优化的速度。
更多详情请参阅Wiki 页面。

🐛 修复

• 修复：纸张方法调用导致 Spigot 兼容性中断（详情）
• 修复：GUI 中玩家数据为空（详情）
• 修复：仅需检查一次锁定状态（详情）
• 修复：CraftListener 中 ItemsAdder 修复可能导致的空指针异常（详情）
• 修复：确保配方注册表返回的列表为不可变列表（详情）

⚙️ 构建与 CI/CD

• 构建：将 1.21.4 添加至 社区 支持版本列表（详情）

🐛 修复

• 修复：移除过时的协议配方数据包过滤器（详情）

⚙️ 构建与 CI/CD

• 构建：移除 ProtocolLib 依赖项（详情）
• 构建：再次尝试使 GitHub Actions 正常运行……（详情）
• 构建：强制使用 Gradle v8.13；再次、再次尝试使 GitHub Actions 正常运行……（详情）

🐛 修复

• 修复：在玩家数据（CCPlayerData）尚未可用时设置默认值（详情）
• 修复：当因错误而禁用 ProtocolLib 功能时，跳过相关功能（详情）

⚙️ 持续集成/持续部署（CI/CD）

• CI：修复提交详情链接指向错误仓库的问题（详情）

🚧 重大变更

• 重构！：升级至 WU 4.19 并移除已弃用的代码（详情）

🧪 测试

• 测试：将测试服务器更新至 1.21.5（详情）

⚙️ CI/CD

• CI：添加更新日志生成功能（详情）
• CI：从更新日志中移除杂项条目（详情）
• CI：以草稿形式创建发布版本（详情）

更新内容

• 合并了 @petulikan1 提交的 PR（#407），包含错误修复、对 Minecraft 1.21.4 的支持及其他改进
• 首次添加 GitHub 工作流，以自动发布 社区 版本

警告！1.21.4 之前版本已停止支持！

自本次更新起，WolfyUtils 与 CustomCrafting 将仅支持最新版 Minecraft（含小版本更新）！
此举可让我紧跟 Minecraft 新版本更新节奏，并将精力集中于新功能开发与错误修复，而非兼容性维护。
上一版 Minecraft 的长期支持（LTS）版本（含向后移植的错误修复）将面向高级用户开放，更多信息即将公布。

新贡献者

• @petulikan1 在 https://github.com/WolfyScript/CustomCrafting/pull/407 中首次作出贡献

完整更新日志：https://github.com/WolfyScript/CustomCrafting/compare/v4.17-beta.5...v4.18.5

此更新回溯了近期测试版中的一项修复，用于解决一个无效的文件复制操作，该操作会导致部分系统崩溃。

完整更新日志：v4.16.10...v4.16.11

警告

此次更新需要安装最新版 WolfyUtils 测试版！

你可从 社区 下载：https://社区.com/plugin/wolfyutils/version/4.17-beta.4

配方 / 自定义物品加载

本次更新对自定义物品与配方的整体加载流程进行了若干调整。

若某配方或自定义物品依赖于其他插件，而该插件未安装，则系统将立即报错并终止加载（不再像此前那样反复尝试加载）。此过程不执行任何校验操作。

若某配方或自定义物品所依赖的插件均已可用，则系统将确保该配方或自定义物品仅在其全部依赖项就绪后才开始加载；
此后，系统才会校验该配方，并确认其是否成功加载。

此外，有关待处理、失败或无效配方的信息，现可通过新增命令 /recipes info 在游戏中查看：

• 不带任何参数时，该命令将打开一个聊天交互菜单，列出全部配方；
• 使用 /recipes info <配方> 命令可查询指定配方的详细信息。

注意：
当前聊天菜单仍处于早期开发阶段，尚无法提供全部信息（例如配方加载失败的具体原因）。
此类信息及其他详情目前仅可在日志中查阅。

更新日志

• #363 - 允许为融锻配方添加权限条件
• #361 - 由 @Pavel-Gornov 更新 ru_RU.json
• #364 - 移除关于酿造台配方的提示说明
• #373 - 修复融锻配方：重复加载及空原料问题
• #372 - 实现 WolfyUtils 依赖系统
• #369 - 由 @SnowCutieOwO 更新 zh_CN.json
• bca3359e - 新增 data.sync 选项，支持在主线程中加载数据
  • 适用于依赖同步事件创建物品的插件（例如 MMOItems）

新贡献者

• @Pavel-Gornov 在 #361 中首次提交贡献
• @SnowCutieOwO 在 #369 中首次提交贡献

完整更新日志：v4.16.9.1...v4.16.10

• #357 — 修复物品创建器未能正确将更改应用至自定义物品的问题
• #358 — 修复物品创建器中的自定义耐久度功能
  • 已知问题： 自定义耐久度目前无法正常运作，使用时不会对物品造成损耗。该问题将在后续 WolfyUtils 更新中修复。
• 9c372b10 — 更新 Oraxen 并修复耐久度应用逻辑
• 7251fda9 — 取消操作时，直接从物品创建器跳转至配方物品编辑器
• 1ec37ad8 — 编辑或选择物品时，实时更新配方物品编辑器的 GUI
• 790dd645 — 从主菜单打开物品创建器时，自动清空此前的物品内容
• 9fbf37ea — 打开物品创建器编辑新物品时，重置此前的所有设置
• 5c73046a — 禁止在锻造配方的空原料槽中放置物品
• 6eb03614 — 修复锻造配方的“保留原有属性”与“仅更改材质”选项
• d5ed0bc8 — 修复物品编辑器中“编辑物品”交互提示显示异常的问题
• a2a46712 — 修复通过原料菜单编辑后，原料选项未同步应用至配方创建器的问题

完整更新日志：v4.16.9...v4.16.9.1

此次更新需要安装最新版 WolfyUtils 4.16.15 或更高版本！

---

改进物品编辑器

默认情况下，CustomCrafting（CC）会自动识别物品来源（例如 Oraxen 或 MMOItem 等插件），但若物品被手动修改过，或同时包含多个第三方插件的配置项，则该识别机制将失效。
本次更新为物品编辑器新增了标识符解析器选择功能，允许您更改已识别物品堆叠所关联的来源。

本示例中，Oraxen 的紫水晶被在 Oraxen 外部重命名，CC 仍能检测出该物品堆叠源自 Oraxen 并与其关联。
但如果我们希望保留这些手动修改，可对结果 按住 Shift 键并右键单击，再 按住 Shift 键并再次右键单击 以打开物品编辑器。
在此界面中，我们选择 Bukkit 解析器，它将保持物品堆叠现状不变，从而解除其与 Oraxen 的关联，并保留所有手动修改内容。

数据目录备份功能

当使用本地存储加载器（默认设置）时，在将配方与物品配置升级至新格式前，系统会自动创建一份备份。
该功能同时适用于自动升级和通过 /recipes save 命令执行的手动升级。

备份文件将以 ZIP 格式存放在 CustomCrafting/data_backups 目录内。
默认情况下，每份备份保留 60 天；旧备份仅在超过指定保留期限后、且有新备份生成时才会被删除。

您可在 config.yml 文件的 local_storage.backup 节点下启用或配置该备份功能。
keep_for 参数用于设定备份保留时长，单位支持 MINUTES（分钟）、HOURS（小时）、DAYS（天），甚至 SECONDS（秒）等。

更清晰的锁定模式提示

启用锁定模式命令前，系统将要求您进行确认操作。

当锁定模式启用后，玩家首次尝试合成时，控制台将输出一条日志提示；此后每满一小时，首次合成时亦会再次输出提示。

更新日志

• 改进堆叠编辑器，新增标识符解析器选择功能
• #328 — 修复锻造配方数据中无效的基础槽位
• #334 — 实现堆叠引用（StackReferences），并将自定义物品（CustomItems）与外部 ItemStack 引用分离
• #342 — 修复锻造配方的合成与创建逻辑
• #336 — 修复原版烹饪配方占位符错误地将结果物品作为来源的问题
• #353 — 为本地存储添加数据目录备份功能
• 54d5ad48 — 在验证配方及其依赖项后重新索引配方书
• 5abf142b — 新增锁定模式警告提示
  锁定模式启用后，玩家首次尝试合成时将输出日志提示；此后每满一小时，首次合成时亦会再次输出提示。
• 602e8dc2 — 锁定模式命令现需确认后方可执行
• f3e01ebc — 修复无序配方（ShapelessRecipe）原料在验证前即报错的问题
• 6f07c40d、5d99bba3 — 使用新的 Result#item 方法，并移除 CustomItem 的调用
• e43a7bf7 — 修复 NBT 合并适配器（NBTMergeAdapter）在所选原料为空时发生的错误
• 9056989f — 修复铁砧配方验证器未考虑 repairTask 设置的问题
• 22f66be6 — 修复德语（de_DE）语言文件中配方书标题显示异常的问题
• 21ac468a — 修复因缺少原始堆叠（original stack）而导致旧配置文件无法通过验证的问题
• cfdf5a21 — 在收集结果时同步更新炼药锅菜单标题
• 483e27cb — 注册配方时若 Bukkit 配方已存在，则直接替换之

完整更新日志：v4.16.8.5...v4.16.9

• #328 - 修复无效的锻造配方数据基础槽位
• #321 - 修复锻造配方跨版本（1.19 与 1.20）兼容性问题
• #322 - 仅允许空手交互时打开熔炉GUI
• 323 - 修复熔炼配方缓存未考虑Z-轴向的问题

完整更新日志: v4.16.8.3...v4.16.8.5

更新日志

• #315 - 修复加载旧配方时缺少可注入值的问题
• #316 - 修复重复的Bukkit配方
• #318 - 修复熔炉产物显示错误的问题
• #319 - 修复配方列表中禁用按钮重复显示的问题

完整更新日志: v4.16.8.2...v4.16.8.3

自 4.16.8.0 版以来的更新内容

护甲夹板合并适配器

新增的护甲夹板合并适配器支持将原料中的护甲夹板图案与材质复制到合成结果物品堆叠中。 它还提供若干额外选项，用于自定义其行为。

示例

复制图案，并将材质更改为紫水晶。

{
    key = "customcrafting:armor_trim"
    copyPattern = true
    copyMaterial = false
    defaultMaterial = "minecraft:amethyst"
}

从第 1 格原料中复制图案，从第 2 格原料中复制材质。

{
    key = "customcrafting:armor_trim"
    copyPattern = [ 1 ]
    copyMaterial = [ 2 ]
}

同时复制图案与材质。

{
    key = "customcrafting:armor_trim"
    copyPattern = true
    copyMaterial = true
}

更新日志

• #300 - 为附魔文本、书本与旗帜合并适配器添加排除选项
• #303 - 添加护甲夹板合并适配器
• #306 - 为锻造配方添加保留夹板选项
• #309 - 添加配置选项以启用或禁用原版烹饪配方回退检查
• #295 - 修复配方查找菜单中交互操作引发的错误
• #297 - 修复配方手册编辑器中“添加分类/筛选”菜单内的错误
• #299 - 修复无效的烹饪配方结果
• #301 - 修复在 1.19.4 之前版本服务器上无法保存锻造配方的问题
• #302 - 修复精英工作台条件中匹配结果无效的问题
• #304 - 修复因基础原料或附加原料为空导致砧板配方无法加载的问题
• #298 - 修复篝火与水桶、打火石等物品交互时的问题
• #305 - 修复已禁用配方在配方列表中重复显示的问题
• #307 - 修复配方条件中出现的空指针异常
• #308 - 更新并修复精英工作台条件设置
• #310 - 修复砧板配方忽略隐藏配方且未检查条件的问题
• #311 - 修复多种配方类型的优先级问题

这是在 社区 上的首个发布版本。
下方为您列出最近一次更新的变更日志。如需查阅此前的变更日志，请访问 GitHub

1.20 版本变更与 NMS 移除

锻造配方变更

此前版本中创建的锻造配方将被加载并自动转换。
默认情况下，这些配方需使用下界合金升级模板才能生效，其行为与原版下界合金升级配方一致。
您可通过游戏内编辑器修改配方，并移除该模板，使配方无需任何模板即可生效。

• 锻造配方现在支持空原料槽。在编辑器中留空对应槽位即可。

合成配方变更

合成系统再次进行了全面重构。
合成配方现会注册两条 Bukkit 配方：

• 显示配方：包含带 NBT 数据的原料，可发送至客户端的配方手册；
• 占位符配方：不含 NBT 数据的原料，永不发送至客户端。

由于占位符配方的存在，它可能覆盖原版配方，导致原版配方失效！
此时，您需另行创建一条与原版配方完全相同、但优先级更低的自定义配方。

营火烹饪配方变更

营火烹饪配方现已完全基于 Spigot API 实现，不再使用任何 NMS 代码（此前 CC 版本中曾使用）。
本次变更无破坏性改动，且实际运行效果可能比以往更加稳定可靠。

物品类型合并适配器

物品类型合并适配器允许配方根据某一原料的类型动态改变结果物品的类型。

该功能适用于修复/转化类配方及其他类似场景，即结果物品的类型由所用原料的类型决定。

该合并适配器的 ID 为 customcrafting:item，其行为与其他合并适配器类似，区别在于它仅始终作用于首个目标原料槽。

例如，您可以创建一个将剑转化为斧的配方：

target {
  mergeOptions : [ {
    slots : [ 4 ]
    adapters : [ {
      key : "customcrafting:item"
      typeMappings { // 将原料中剑的类型映射为结果物品的类型
        wooden_sword = wooden_axe
        stone_sword = stone_axe
        iron_sword  = iron_axe
        golden_sword = golden_axe
        diamond_sword = diamond_axe
      }
    } ]
  } ]
}

为使该配方正常工作，当然需允许所有变体物品作为原料。
您可通过 Shift + 右键 点击原料槽来实现此操作！

此功能并非用于替代船只、门等类型专属配方。
对于此类配方，仍需单独创建各自对应的配方，因为该适配器仅能作用于单个原料槽！

配方手册编辑器重构

更可靠的编辑与保存机制

打开编辑器时，系统将复制当前配方手册的全部状态，后续所有编辑均在此副本上进行。
（相较此前版本——当时是直接编辑原始配置文件）

保存时，系统会先将当前配置备份为 recipe_book_backup.conf，
再将编辑后的副本保存至 recipe_book.conf，从而覆盖原有配置。

分类与筛选器概览优化

每个已列出的分类/筛选器下方均新增了一个配置按钮，可用于编辑该分类/筛选器，或将其向左/右移动以调整其显示顺序。

后续改进计划

本次更新仅为编辑器的界面重设计与缺陷修复。
当前仍未涵盖 recipe_book.conf 中全部可用设置，因此直接编辑配置文件仍是推荐方式。

变更日志

• 新增 锻造配方对空原料的支持
• 新增 合成与烹饪类占位符配方，用于表示不含 NBT 原料的配方
• 新增 烹饪监听器与管理器适配器的文档说明
• 新增 ICustomVanillaRecipe#toPlaceholder 方法，用于生成占位符键名
• 新增 营火监听器，以替代原有的 NMS 系统
• 更新 配方手册中的锻造配方菜单至 1.20 版本
• 更新 锻造配方以适配 1.20 版本中的模板机制
• 更新 锻造配方创建器，以支持 1.20 版本的模板
• 更新 paper-api 至 1.20 版本
• 更新 WolfyUtils 至 4.16.12 版本
• 修复 合成台中闪烁与物品重复等异常行为
• 移除 全部基于 NMS 的合成系统
• #286 – 修复 GUI 中物品输入按钮在特定交互下误删物品堆叠的问题
• #292 – 新增物品类型合并适配器
• #290 – 修复使用配方手册完成配方时原料消失的问题
• #294 – 配方手册编辑器全面重构

完整变更日志：https://github.com/WolfyScript/CustomCrafting/compare/v4.16.7.2...v4.16.8.0

CustomCrafting v5 Alpha 4

v5 是对整个插件及配方结构的一次彻底重写与重新设计。
它新增了诸多在 v4 中无法实现的功能与改进。

近年来，《我的世界》发生了巨大变化，许多新的模组/插件平台相继涌现，或从其原始项目中独立出来。
如今，让插件/模组兼容各类平台已成为一项重大挑战——每个平台都拥有各自不同的 API。

随着混淆机制的移除，直接使用和基于《我的世界》内部代码进行开发已变得轻松得多。
正因如此，v5 版本的 CustomCrafting 将重心转向直接构建于《我的世界》内部机制之上，而非依赖特定平台的 API。
为确保兼容性，v5 的目标是在尽可能深入地集成各平台（例如事件系统、监听器、第三方插件/模组）的同时，保持其主体代码库与平台无关。

这正是 scafall 所发挥作用之处。Scafall 支持创建跨平台 API，供其他模组与插件调用，并更便捷地将各平台专属实现相互关联。

然而，所有这些革新也带来了大量全新挑战。因此，CustomCrafting 后续版本将仅支持最新版《我的世界》！

简明摘要

• CustomCrafting v5 直接构建于《我的世界》内部机制之上
• 仅支持最新版《我的世界》
• 需依赖 scafall 库/模组 详见发布页
• 提供跨平台 API

全新 Wiki 文档

随 v5 在 社区 上线，我们同步推出全新 Wiki 文档，地址如下：
https://wolfyscript.github.io/CustomCrafting/

新版 Wiki 拥有众多视觉优化，并采用 Git 进行管理，相较旧版 GitHub Wiki 更易于维护。

Fabric 服务端支持

v5 新增 Fabric 服务端支持。此类纯服务端模组允许原版客户端直接连接 Fabric 服务端，与 Spigot 类似，玩家无需安装任何客户端模组。

Fabric 实现相较 Spigot/Paper 实现有诸多优势：
它将具备原版对应物的自定义配方直接整合进原版配方机制，从而实现与现有模组更佳的兼容性，并提升配方书支持效果。

独立的 Paper 版本

自本次更新起，CustomCrafting 与 scafall 将分别为 Paper 平台提供专属 JAR 文件。
若您使用 Paper，请务必选用该版本以获得全部改进与额外功能。

目前，该专属版本所增加的功能仅包含切石机配方支持——此功能在 Spigot 版本中尚不可用。

新增功能

v5 对资源加载与配方结构进行了多项重大重构。

配置资源与加载顺序

资源源（Sources）定义资源加载位置（本地目录、H2、SQLite、MySQL 等）。
备份目标（Backup destinations）定义备份生成时的保存位置（本地目录或 ZIP 文件）。

全新并增强的配方类型

v5 大幅拓展了所有配方类型的可用功能，尤其针对 v4 中功能相对薄弱的配方类型。

提示
本版本内置若干默认配方，用于演示部分新特性。
它们将在启动时自动加载，您可在v5 分支中查阅。

增强的铁砧配方

• 重命名选项（格式化名称、前缀/后缀、消耗、修复成本）
• 耐久度组合选项（加成、比例组合）
• 物品修复选项（每件物品修复成本、附魔保留）
• 附魔选项（附魔保留、升级成本、冲突成本等……）

增强的砂轮配方

• 附魔移除选项
• 附魔合并选项
• 耐久度组合选项
• 修复成本选项

增强的配方物品

• 完整支持原版物品堆栈的 SNBT
• 通过 version 属性支持 DataFixerUpper

增强的指令结果动作

• 完整支持指令上下文
  • 目标选择器 @p、@n、@r、@a、@e、@s
  • 目标选择器参数
• 以及原版指令所支持的几乎所有其他功能

高级原料（Ingredients）

本次更新引入全新的原料配置选项，允许精细设定其匹配方式与/或消耗方式。
这些选项均为可选，且默认值使其行为与原版保持一致。
每类选项均拥有独立注册表，第三方插件/模组可为其注册自定义行为。

匹配选项

指定原料选项如何与物品栏中的源物品堆栈进行匹配。

消耗选项

指定当结果被领取或产出时，原料如何消耗源物品堆栈。

错误追踪

CustomCrafting 内置错误追踪功能，以辅助插件/模组的日常维护。
错误追踪集成使问题与错误更加直观可见，并提供插件/模组在实际运行环境中的表现洞察。
由此得以比以往更快地定位并修复缺陷、推进功能优化。
更多详情请参阅Wiki 文档。

CustomCrafting v5 Alpha 4

v5 是对整个插件及配方结构的全面重写与重新设计。
它新增了诸多在 v4 中无法实现的功能与改进。

近年来，《我的世界》发生了巨大变化，许多新的模组/插件平台相继出现，或从其原始项目中独立出来。
如今，让插件/模组兼容各类平台已成一项重大挑战——每个平台均拥有各自不同的 API。

随着混淆机制的移除，直接使用和基于《我的世界》内部代码进行开发已变得轻松得多。
正因如此，v5 版本的 CustomCrafting 将重心转向直接构建于《我的世界》内部机制之上，而非依赖特定平台的 API。
为确保兼容性，v5 的目标是在尽可能深度集成各平台（如事件系统、监听器、第三方插件/模组）的同时，保持其主体代码库与平台无关。

这正是 Scafall 所发挥的作用。Scafall 提供了一套跨平台 API 的构建能力，其他模组与插件亦可复用该 API，并更便捷地将各平台专属实现相互关联。

然而，上述所有改进也带来了一系列全新挑战。因此，CustomCrafting 后续版本将仅支持最新版《我的世界》！

简明摘要

• CustomCrafting v5 直接基于《我的世界》内部机制构建功能
• 仅支持最新版《我的世界》
• 需安装 scafall 库/模组 详见发布页面
• 提供跨平台 API

全新 Wiki 文档

随 v5 在 社区 平台发布，我们同步上线了焕然一新的 Wiki 文档，地址如下：
https://wolfyscript.github.io/CustomCrafting/

新版 Wiki 在视觉呈现上大幅优化，并采用 Git 进行管理，相较旧版 GitHub Wiki 更易于维护。

Fabric 服务器支持

v5 正式引入 Fabric 服务器支持。仅服务端运行的模组允许原版客户端直接连接 Fabric 服务器，因此与 Spigot 类似，玩家无需安装任何客户端模组。

Fabric 实现相较 Spigot/Paper 实现具备多项优势：
它将具有原版对应物的自定义配方直接整合进原版配方机制，从而实现与现有模组更佳的兼容性，并显著提升配方书支持效果。

独立的 Paper 版本

自本次更新起，我们将为 Paper 平台单独提供 CustomCrafting 与 Scafall 的 JAR 文件。
若您使用 Paper，请务必选用该版本以获得全部改进与额外功能。

目前，该版本独有功能仅包含切石机配方支持，而此功能在 Spigot 版本中尚不可用。

新增功能

v5 对资源加载机制与配方结构进行了重大重构。

配置资源与加载顺序

数据源定义资源的加载位置（本地目录、H2、SQLite、MySQL 等）。
备份目标则定义备份文件的保存位置（本地目录或 ZIP 文件）。

全新且增强的配方类型

v5 大幅拓展了所有配方类型的可用功能，尤其针对 v4 中功能相对薄弱的配方类型进行了重点强化。

提示
本版本内置若干默认配方，用于直观展示部分新特性。
它们将在启动时自动加载，您可在 v5 分支 中查阅。

增强型铁砧配方

• 重命名选项（格式化名称、前缀、后缀、消耗、修复成本）
• 耐久度组合选项（加成、比例组合）
• 物品修复选项（单件修复成本、附魔保留）
• 附魔选项（附魔保留、升级成本、冲突成本等……）

增强型磨石配方

• 附魔移除选项
• 附魔合并选项
• 耐久度组合选项
• 修复成本选项

增强型配方物品

• 完整支持原版物品堆栈的 SNBT
• 通过 version 属性支持 DataFixerUpper

增强型指令执行结果动作

• 完整支持指令上下文
  • 目标选择器：@p、@n、@r、@a、@e、@s
  • 目标选择器参数
• 以及原版指令所支持的几乎所有其他功能

高级原料系统

本次更新引入了全新的原料配置选项，允许精细设定原料的匹配逻辑与消耗方式。
这些选项均为可选，若未显式配置，则默认行为与原版保持一致。
每类选项均拥有独立注册表，第三方插件/模组可为各选项类型注册自定义行为。

匹配选项

此类选项用于指定原料候选集如何与物品栏中的源物品堆栈进行匹配。

消耗选项

此类选项用于指定当结果产出或被领取时，原料将如何消耗源物品堆栈。

错误追踪

CustomCrafting 内置错误追踪机制，以辅助插件/模组的日常维护工作。
该机制使问题与错误更加直观可见，并提供插件/模组在实际生产环境中运行状况的深入洞察，从而显著加快缺陷修复与功能优化的速度。
更多详情请参阅 Wiki 文档。

CustomCrafting v5 Alpha 4

v5 是对整个插件及配方结构的全面重写与重新设计。
它新增了诸多在 v4 中无法实现的功能与改进。

近年来，《我的世界》发生了巨大变化，许多新的模组/插件平台相继出现，或从其原始项目中独立出来。
如今，让插件/模组兼容各类平台已成一项重大挑战——每个平台都拥有各自截然不同的 API。

随着混淆机制的移除，直接使用和基于《我的世界》内部代码进行开发已变得轻松得多。
正因如此，v5 版本的 CustomCrafting 将重心转向直接构建于《我的世界》内部机制之上，而非依赖特定平台的 API。
为确保兼容性，v5 的目标是在尽可能深度集成各平台（如事件系统、监听器、第三方插件/模组）的同时，保持其主体代码库与平台无关。

这正是 Scafall 所发挥的作用。Scafall 提供了一套跨平台 API 的构建能力，其他模组与插件亦可复用该 API，并更便捷地桥接各平台专属的实现逻辑。

然而，上述所有改进也带来了大量全新挑战。因此，CustomCrafting 后续版本将仅支持最新版《我的世界》！

简明摘要

• CustomCrafting v5 直接构建于《我的世界》内部机制之上
• 仅支持最新版《我的世界》
• 需依赖 Scafall 库/模组 详见发布页面
• 提供跨平台 API

全新 Wiki 文档

随 v5 版本登陆 社区，我们同步上线了焕然一新的 Wiki 文档，地址如下：
https://wolfyscript.github.io/CustomCrafting/

新版 Wiki 拥有大量视觉优化，并采用 Git 进行管理，相较旧版 GitHub Wiki 更易于维护。

Fabric 服务器支持

v5 正式引入对 Fabric 服务器的支持。仅服务端模组允许原版客户端直连 Fabric 服务器，因此与 Spigot 类似，玩家无需安装任何客户端模组。

Fabric 实现相较 Spigot/Paper 实现有诸多优势：
它将具备原版对应物的自定义配方，直接整合进原版配方机制，从而实现与现有模组更优的兼容性，并显著增强配方手册支持。

独立的 Paper 版本

自本次更新起，CustomCrafting 与 Scafall 将为 Paper 平台单独提供专用 JAR 文件。
若您使用 Paper，请务必选用该版本以享受全部改进与额外功能。

目前，该版本独有功能仅包含对切石机配方的支持——而此功能在 Spigot 版本中尚属缺失。

新增功能

v5 对资源加载机制与配方结构进行了重大重构。

配置资源来源与加载顺序

资源来源定义资源加载位置（本地目录、H2、SQLite、MySQL 等）。
备份目标则定义备份文件的保存位置（本地目录或 ZIP 文件）。

全新且增强的配方类型

v5 大幅拓展了所有配方类型的可用功能，尤其针对 v4 中功能相对薄弱的配方类型。

提示
本版本内置若干默认配方，用于直观展示部分新特性。
它们将在启动时自动加载，您可在 v5 分支的此处 查看完整列表。

增强的铁砧配方

• 重命名选项（格式化、前缀/后缀、消耗、修理成本）
• 耐久度组合选项（加成、比例组合）
• 物品修理选项（每件物品消耗、附魔保留）
• 附魔选项（保留、升级成本、冲突成本等……）

增强的磨石配方

• 附魔移除选项
• 附魔合并选项
• 耐久度组合选项
• 修理成本选项

增强的配方物品

• 完整支持原版物品堆叠的 SNBT
• 通过 version 属性支持 DataFixerUpper

增强的指令执行结果动作

• 完整支持指令上下文
  • 目标选择器 @p、@n、@r、@a、@e、@s
  • 目标选择器参数
• 以及原版指令所支持的几乎所有其他功能

高级原料选项

本次更新引入了全新的原料配置项，允许精细设定原料的匹配方式与消耗行为。
这些选项均为可选，若未指定则采用默认值，使其行为与原版保持一致。
所有选项均拥有独立注册表，第三方插件/模组可为每类选项注册自定义行为。

匹配选项

此类选项定义原料选项如何与物品栏中的源物品堆叠进行匹配。

消耗选项

此类选项定义当配方结果被领取或产出时，原料将如何消耗源物品堆叠。

错误追踪

CustomCrafting 内置错误追踪功能，以辅助插件/模组的日常维护。
错误追踪集成机制使问题与异常更加显见，并提供插件/模组在实际运行环境中的表现洞察，
从而大幅加速缺陷修复与功能优化进程。
更多详情请参阅 Wiki 文档。

🐛 修复

• 修复：Paper 方法调用导致 Spigot 兼容性问题 (详情)
• 修复：GUI 中玩家数据为空的问题 (详情)
• 修复：仅需检查一次锁定状态 (详情)
• 修复：CraftListener 中 ItemsAdder 修复可能发生的空指针异常 (详情)
• 修复：确保配方注册表返回的列表为不可变列表 (详情)

⚙️ 构建与 CI/CD

• 构建：向 社区 支持版本中添加 1.21.4 (详情)