[fork] Custom Recipes and Crafting (CraftEnhance) - CraftEnhance - 自定义配方与合成增强

简介

CraftEnhance 是原版 Craftenhance 的分支版本，让你能够通过图形界面轻松创建或禁用任何合成配方。只需将 JAR 文件放入插件文件夹即可完成安装，无需其他操作。本插件支持使用带有附魔、自定义名称、耐久度、药水等任意游戏内属性的物品进行合成，并提供完整的 GUI 支持来编辑、创建、查看和管理配方。

💡支持与更新

• 加入 Discord 获取支持：https://discord.gg/8xYEbft
• 所有详细的更新信息会首先在 Discord 发布。
• 更全面和最新的插件信息请查阅 Wiki。
• 欢迎捐赠以支持开发：

- 如果喜欢本插件，可以给 DutchJelly 买杯咖啡。

- 也可以捐赠给 broken 以支持插件的持续更新。

- 捐赠并非强制，但我们将非常感激。

✨核心功能

• 使用自定义物品合成

- 你可以添加包含附魔、自定义名称、耐久度、药水效果等任意游戏内属性的合成配方。

• 完整的 GUI 支持

- 所有操作，包括编辑配方、创建配方、查看配方以及在查看器中排序配方，都可通过库存 GUI 完成。

• 中键点击编辑

- 在配方查看器中，只需对配方使用鼠标中键点击即可打开编辑器。此操作需要相应权限。

• 为配方设置权限

- 每个自定义配方都可以关联一个权限。没有该权限的玩家将无法合成或查看该配方（“查看”部分可配置）。

• 隐藏配方但仍可合成

- 你可以对没有“绕过”权限的玩家隐藏配方，但他们如果拥有配方的合成权限，则仍然可以合成。

• 禁用原版配方

- 通过专用 GUI，你可以禁用任何不希望玩家使用的原版配方（例如，防止制作过于廉价强力的钻石/下界合金装备）。

• 游戏内物品编辑器

- 内置物品编辑器，允许你设置彩色 lore、彩色名称、耐久度、添加附魔、添加物品标签（ItemFlags）甚至设置本地化名称。

- 注：物品标签可用于隐藏物品上的附魔或属性显示。

• Tab 键补全支持

- 所有相关命令均支持 Tab 键补全，无需记忆复杂指令。

🎮命令列表

配方创建与查看命令

• /ceh

- 主命令，请使用 Tab 键补全查看子命令。

• /ceh viewer [页码或分类] [编号或名称]

- 打开配方查看器 GUI。可以指定页码或配方分类直接打开。

• /recipes

- 打开配方查看器 GUI（快捷命令）。

• /ceh createrecipe [配方键] [权限]

- 使用指定的键和权限创建一个新配方。如果不提供参数，插件将自动生成一个键，且配方不要求权限。

• /ceh specs [配方键]

- 显示指定配方键的详细信息（目前仅包含权限）。

• /ceh setpermission [配方键] [新权限]

- 更改指定配方键的权限。

• /ceh changekey [旧配方键] [新配方键]

- 更改指定配方的键。

• /ceh cleanitemfile

- 清理 `items.yml` 文件中未被任何配方使用的自定义物品。

• /ceh reload

- 重载整个插件。

物品编辑命令

• /edititem

- 物品编辑主命令，请使用 Tab 键补全。

• /edititem name [名称]

- 编辑主手物品的名称。

• /edititem durability [1-100]

- 将主手物品的耐久度设置为其最大耐久的百分比（1-100%）。

• /edititem enchant [附魔名称,clear] [等级] [...]

- 为主手物品设置指定的附魔。此命令会先移除所有旧附魔（不会保留），然后添加指定的附魔。如需清除所有附魔，请使用 `clear` 代替附魔名称。

• /edititem itemflag [物品标签] [物品标签] [...]

- 切换主手物品上指定的物品标签（ItemFlag）。

• /edititem lore [行号] [文本]

- 将主手物品 Lore 的指定行设置为给定文本。如果文本部分留空，则会添加一个空行。

🔧默认权限

权限可在 config.yml 中配置，以下是默认设置：

• craftenhance.edit

- 权限命令：`/ceh createrecipe`, `/ceh cleanitemfile`, `/ceh reload`, `/ceh setpermission`, `/ceh specs`, `/ceh changekey`。

- 此权限也是使用中键点击配方打开编辑器所必需的。

• craftenhance.view

- 权限命令：`/ceh viewer`, `/recipes`。

• craftenhance.edititems

- 所有以 `/edititem` 开头的命令。

• craftenhance.edit_categorys

- 允许编辑配方分类，包括将配方移出分类、删除分类、更改分类名称以及更改分类显示物品。

❓配置文件

插件会生成以下配置文件

`guitemplates.yml`

• 用于完全自定义所有 GUI 界面。
• fill-space：指定一个物品槽位索引范围，用于填充动态内容（如查看器中的配方列表）。
• template：指定在库存中放置的静态物品。确保其不与 fill-space 的范围重叠。按钮也在此处定义。
• buttons：指定按钮的位置，其值代表按钮类型。请参考预设文件查看所有选项。

`recipes.yml`

• 所有配方的存储文件。配方使用 items.yml 中定义的物品键（Item Key）。由于所有配方都可通过 GUI 创建，通常无需手动编辑此文件。

`items.yml`

• 所有自定义物品的存储文件，每个物品都有一个唯一键。此文件由插件自动管理，通常无需手动修改。

`config.yml`

• 存储部分消息文本和权限设置。
• 重要设置：可以配置是否让玩家看到他们没有权限合成的配方。