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 对资源加载与配方结构进行了多项重大重构。

配置资源与加载顺序

资源源（Sources）定义资源加载位置（本地目录、H2、SQLite、MySQL 等）。
备份目标（Backup destinations）定义备份生成时的保存位置（本地目录或 ZIP 文件）。

全新并增强的配方类型

v5 大幅拓展了所有配方类型的可用功能，尤其针对 v4 中功能相对薄弱的配方类型。

提示
本版本内置若干默认配方，用于演示部分新特性。
它们将在启动时自动加载，您可在v5 分支中查阅。

增强的铁砧配方

• 重命名选项（格式化名称、前缀/后缀、消耗、修复成本）
• 耐久度组合选项（加成、比例组合）
• 物品修复选项（每件物品修复成本、附魔保留）
• 附魔选项（附魔保留、升级成本、冲突成本等……）

增强的砂轮配方

• 附魔移除选项
• 附魔合并选项
• 耐久度组合选项
• 修复成本选项

增强的配方物品

• 完整支持原版物品堆栈的 SNBT
• 通过 version 属性支持 DataFixerUpper

增强的指令结果动作

• 完整支持指令上下文
  • 目标选择器 @p、@n、@r、@a、@e、@s
  • 目标选择器参数
• 以及原版指令所支持的几乎所有其他功能

高级原料（Ingredients）

本次更新引入全新的原料配置选项，允许精细设定其匹配方式与/或消耗方式。
这些选项均为可选，且默认值使其行为与原版保持一致。
每类选项均拥有独立注册表，第三方插件/模组可为其注册自定义行为。

匹配选项

指定原料选项如何与物品栏中的源物品堆栈进行匹配。

消耗选项

指定当结果被领取或产出时，原料如何消耗源物品堆栈。

错误追踪

CustomCrafting 内置错误追踪功能，以辅助插件/模组的日常维护。
错误追踪集成使问题与错误更加直观可见，并提供插件/模组在实际运行环境中的表现洞察。
由此得以比以往更快地定位并修复缺陷、推进功能优化。
更多详情请参阅Wiki 文档。