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