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