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 文档。