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