Custom Recipes and Crafting (CraftEnhance) - CraftEnhance

由于我更新插件的时间有限，我和 brokenarrow 决定由他来负责在他的账户上发布更新。这一变动将使他发布更新更加便捷。您可以在以下链接找到分支版本：Craftenhance fork。如需支持，请加入 Discord 服务器：https://discord.gg/8xYEbft。所有详细的更新信息也会首先在那里发布。关于本插件更及时、更详细的信息，请查阅 Wiki。任何捐赠都将提供巨大帮助。如果您喜欢这个插件，可以在此捐赠：给我买杯咖啡。

CraftEnhance 允许您通过图形界面在游戏中创建或禁用任何合成配方，操作简单直观。

💡核心功能

• 使用自定义物品合成

您可以添加包含附魔、自定义名称、耐久度、药水效果等任何游戏内已有属性的物品作为合成材料或产物。

• 完整的图形界面支持

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

• 中键点击编辑

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

• 为配方设置权限

为了给予服主完全的控制权，自定义配方可以设置权限。没有对应权限的玩家将无法合成或查看该配方（“查看”部分可以单独配置）。

• 隐藏配方但仍可合成

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

• 禁用原版配方

通过专用 GUI，您可以禁用任何不希望存在的原版配方。例如，不再允许制作过于廉价或强力的钻石/下界合金装备。

• 游戏内物品编辑器

为了创建有趣的配方，插件内置了物品编辑器。您可以使用它为物品设置彩色描述、彩色名称、耐久度、添加附魔、添加物品标签（ItemFlags），甚至设置本地化名称。注：物品标签可用于隐藏物品上的附魔或属性提示。

• Tab 键补全支持

自 Minecraft 1.13 更新后，我认为这是必备功能。无需记住所有命令，只需输入前几个字母即可获得提示。

🎮命令列表

配方创建与查看命令

• /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 [行号] [描述文本] - 将主手物品描述的指定行设置为给定的文本。如果留空文本部分，则会添加一个空行。

🔧默认权限

权限可在配置文件中修改，以下是默认设置

• 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 文件中定义的物品键。不过，由于所有配方都可通过 GUI 创建，此处不再深入说明。

`items.yml`

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

`config.yml`

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