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 页面。