EpicCraftings - 自定义合成

注意：本插件已停止更新！如需功能更强大的替代品，请使用我的新插件 EpicCraftingsPlus：https://www.spigotmc.org/resources/epiccraftingsplus-fully-configurable-crafts-1-8-1-15.39967/

EpicCraftings 允许你以一种独特的方式创建自定义合成配方。通过 /ecraft 命令（或一个可配置的合成点），你可以制作具有自定义名称、描述、附魔的史诗物品，前提是玩家拥有所需的材料（所有内容均可配置）。你可以创建任意数量的合成配方，每个配方最多支持 15 种需求物品。

例如，你可以合成一件名为“史诗之剑”的物品，但需要：15 个钻石、15 个金锭以及任何你想要的物品。

✨功能对比 (EpicCraftings vs EpicCraftingsPlus)

• ✓ 添加自定义合成配方
• ✓ 需求物品可设置自定义名称、描述与附魔
• ✓ 合成产物可设置自定义名称/颜色/描述/附魔
• ✓ 每个配方最多支持 15 种需求物品
• ✓ 可为合成配方设置独立权限
• ✓ 合成产物可设为不可破坏
• ✓ 可为合成产物隐藏物品标签（Hide-flags）
• ✓ 可为需求物品隐藏物品标签
• ✓ 支持设置合成点（Crafting Places）
• ✓ 支持 1.8+ 版本
• ✓ 提供 GUI 合成菜单
• ✓ 无需权限即可使用基础功能
• ✓ 合成点支持分类
• ✓ 合成冷却时间（等待时间）
• ✓ 合成时可执行命令
• ✓ 随机合成选项
• ✓ 右键点击物品可执行命令
• ✓ 支持 /ecraft create（通过 GUI 轻松创建配方，无需手动编辑配置）
• ✓ 额外需求：玩家等级、JobsReborn 等级、游戏币
• ✓ 配方分类
• ✓ 合成成功率系统
• ✓ 兼容药水
• ✓ 兼容染色皮革盔甲
• ✓ 兼容自定义材质头颅
• ✓ 兼容属性修饰符（Attribute Modifiers）
• ✓ 可通过权限隐藏特定合成
• ✓ 可将所有工作台转换为打开 EpicCraftings 菜单
• ✓ 可通过命令打开合成菜单
• ✓ 可禁止使用游戏币进行合成
• ✓ 合成产物可拥有随机附魔等级
• ✓ 合成产物可拥有随机描述属性
• ✓ 日志文件
• ✓ 可阻止与已合成物品的交互
• ✓ 可阻止已合成物品在工作台中使用
• ✓ 兼容 Boss 插件

你可以在此处找到此插件的 Premium 版本（EpicCraftingsPlus）。

🎮配置文件详解 (config.yml)

配置文件允许你深度自定义合成菜单与配方。

菜单与全局设置

decorative-menu-item: '160:3'
menu-page-item: '262'
click-to-craft-item: '58'
firework-on-craft: true
new-version-reminder: true
block-ecraft-command: false

• decorative-menu-item / menu-previous-page-item / click-to-craft-item：菜单装饰物品、翻页物品、点击合成物品的 ID 或名称。建议使用物品 ID。
• firework-on-craft：设置为 true 时，玩家在插件 GUI 中成功合成物品将触发烟花效果。
• block-ecraft-command：此选项在你使用 /ecraft setplace 命令设置了特定合成点后生效，用于阻止玩家直接使用 /ecraft 命令。

合成配方配置

配方在 Crafts: 节点下定义。每个配方拥有一个唯一 ID（如 super_sword），并包含以下子项：

• id：合成产物的物品 ID。
• name：合成产物的自定义名称（支持颜色代码）。
• lore：合成产物的自定义描述（支持颜色代码）。可使用变量 %player% 来引用合成者名称。可移除此部分。
• enchants：合成产物附带的附魔列表，格式为 '附魔名称;等级'。
• permission：合成此物品所需的权限（可选）。
• hide-flags：要隐藏的物品标签列表（如 HIDE_ATTRIBUTES）。
• requires：合成所需物品列表。每行定义一个需求物品。

需求物品格式

需求物品的格式为

'物品ID;数量;自定义名称;描述行1;描述行2;...;ENCHANTS:附魔名1,等级:附魔名2,等级'

• 每行代表一种不同的需求物品。
• 最多可设置 15 种需求物品。
• 自定义名称、描述和附魔部分为可选。

**示例**

requires:
- '264;15;&b独特钻石;&7传奇矿物;&7极难获取..;ENCHANTS:KNOCKBACK,1:FIRE_ASPECT,2'
- '266;10;ENCHANTS:KNOCKBACK,1'

这表示合成需要

• 15 个钻石，其名称为“独特钻石”，带有两行描述，并附有击退 I 和火焰附加 II。
• 10 个金锭，并附有击退 I。

🔧使用方法

创建合成配方

使用命令 /ecraft create <配方名称>，然后根据提示或参照上述配置说明编辑 config.yml 文件。

设置合成点

• 创建：看着一个方块，执行 /ecraft createplace。点击该方块将打开 EpicCraftings 菜单。
• 移除：看着已设置的方块，执行 /ecraft removeplace。

[/] 命令列表

• /ecraft - 打开插件合成菜单。
• /ecraft create <名称> - 在配置中创建一个新合成配方。
• /ecraft delete <名称> - 删除一个合成配方。
• /ecraft list <页码> - 显示所有已创建的合成配方。
• /ecraft setplace - 创建一个新的合成点。
• /ecraft removeplace - 移除一个现有的合成点。
• /ecraft give <配方名称> <玩家> - 直接将合成物品给予玩家。
• /ecraft reload - 重载配置文件。
• /ecraft info - 显示插件信息。

💡权限

仅有一个管理员权限

• ecraft.admin

⭐API 与开发

插件提供了一个简单的事件 API。

前提：需要将 EpicCraftings 添加为你插件的外部依赖，并在你的 plugin.yml 中设置 softdepends: [EpicCraftings]。

**事件示例**

// 当玩家成功合成物品且材料已从背包扣除时触发。
@EventHandler
public void testEvent(EpicCraftingsCraftEvent event) {
    Player player = event.getPlayer();
    String craftName = event.getCraft();
}

❓教程与翻译

• 西班牙语教程（作者提供）
• 俄语教程（由 Sumrak-TV 制作）

语言翻译文件（替换 message.yml 内容即可）：

• 西班牙语 (By Ajneb97): [点击下载]
• 葡萄牙语 (By Rhander): [点击下载]
• 中文 (By Process): [点击下载]
• 俄语 (By @DarkSumrak): [点击下载]