Craftorithm - 自定义合成系统

GitHub | WIKI | Discord

Craftorithm 是一款功能强大的配方管理插件，支持添加自定义配方、移除/禁用配方、为配方添加使用限制等操作，并提供直观的图形界面。

💡核心功能

• 图形界面 (GUI)：所有操作均可通过游戏内图形界面完成，直观易用。
• 支持多种配方类型：
• 有序合成配方 (Shaped)
• 无序合成配方 (Shapeless)
• 烹饪配方 (熔炉、高炉、烟熏炉、营火)
• 锻造台配方 (Smithing)
• 切石机配方 (Stone Cutting)
• 酿造配方 (Brewing)
• 铁砧配方 (Anvil)
• 配方管理：
• 查看服务器所有配方列表
• 禁用特定配方
• 管理由本插件创建的配方组

🎮命令与权限

主命令：craftorithm 或 craft

所需权限：craftorithm.command

物品管理

• 命令：craft item save
• 将手中物品保存至文件。
• 权限：craftorithm.command.item.save
• 命令：craft item give
• 从文件中获取已保存的物品。
• 权限：craftorithm.command.item.give

自定义燃料

• 命令：craft item fuel add <tick>
• 将手中物品添加为自定义燃料，并设置燃烧时间（tick）。
• 权限：craftorithm.command.item.fuel.add
• 命令：craft item fuel remove <name>
• 移除一个已添加的自定义燃料。
• 权限：craftorithm.command.item.fuel.remove

插件操作

• 命令：craft reload
• 重载插件配置。
• 权限：craftorithm.command.reload
• 命令：craft disable
• 禁用服务器的原版配方。
• 权限：craftorithm.command.disable
• 命令：craft remove
• 删除由 Craftorithm 创建的配方组。
• 权限：craftorithm.command.remove
• 命令：craft list server/craftorithm
• 打开服务器配方列表或 Craftorithm 配方组列表的 GUI。
• 权限：craftorithm.command.list 以及 craftorithm.command.list.server 或 craftorithm.command.list.craftorithm
• 命令：craft create <type> [name]
• 打开指定类型的配方创建器 GUI。
• 权限：craftorithm.command.create
• 命令：craft run
• 执行动作（通常与配方联动）。
• 权限：craftorithm.command.run
• 命令：craft version
• 查看插件版本信息。
• 权限：craftorithm.command.version
• 命令：craft display
• 打开配方展示 GUI。
• 权限：craftorithm.command.display

🔧使用统计

本插件使用 bStats 收集匿名的使用数据，以帮助开发者了解插件使用情况并持续改进。

Craftorithm 是一个强大的自定义合成配方插件，允许服务器管理员为任何物品创建和配置独特的合成配方。它支持多种配方类型和高级功能，为服务器带来无限的自定义合成可能性。

💡核心功能

• 自定义配方：为任何物品创建全新的合成配方。
• 多种配方类型：支持有序合成、无序合成、熔炉烧炼、切石机切割等多种配方类型。
• 高级配方选项：可设置配方权限、经验消耗、合成冷却时间、合成失败提示等。
• 配方限制：可限制玩家每天或总共可合成某个配方的次数。
• 配方解锁：支持通过权限、指令、完成任务或消耗经验来解锁配方。
• 物品变量：在配方中使用具有特定名称、描述、附魔、属性等的物品作为材料。
• 配方书 GUI：提供一个图形界面（配方书），供玩家浏览和合成已解锁的配方。
• 多语言支持：插件内置多语言系统。

🎮指令与权限

主要指令

• /craftorithm 或 /cr：打开配方书 GUI（需要 craftorithm.command.craftorithm 权限）。
• /craftorithm admin 或 /cr admin：打开管理员 GUI（需要 craftorithm.command.admin 权限）。
• /craftorithm give <player> <item_id>：给予玩家一个自定义物品（需要 craftorithm.command.give 权限）。
• /craftorithm reload：重载插件配置（需要 craftorithm.command.reload 权限）。

主要权限节点

• craftorithm.command.craftorithm：允许使用 /craftorithm 打开配方书。
• craftorithm.command.admin：允许使用管理员指令和 GUI。
• craftorithm.command.give：允许使用给予物品指令。
• craftorithm.command.reload：允许重载插件配置。
• craftorithm.bypass.cooldown：绕过所有配方的合成冷却时间。
• craftorithm.bypass.limit：绕过所有配方的合成次数限制。
• craftorithm.unlock.<recipe_id>：解锁特定配方的权限节点。

🔧快速开始

安装插件

• 将 Craftorithm 的 jar 文件放入服务器的 plugins 文件夹。
• 重启服务器。
• 插件会自动生成配置文件夹和默认文件。

创建第一个配方

• 在 plugins/Craftorithm/recipes 文件夹内创建一个新的 YAML 文件（例如 my_recipe.yml）。
• 使用以下基础模板编写配方：

my_sword:
  type: shaped
  result: DIAMOND_SWORD
  shape:
    - " D "
    - " D "
    - " S "
  ingredients:
    D: DIAMOND
    S: STICK

• 在游戏内或控制台执行 /craftorithm reload 重载配方。
• 玩家现在可以使用两个钻石和一根木棍在工作台中按指定形状合成钻石剑。

✨配方配置详解

配方类型 (type)

• shaped：有序合成，需要指定 shape 和 ingredients。
• shapeless：无序合成，只需指定 ingredients。
• furnace：熔炉烧炼，需要指定 ingredient 和 cookingtime（可选）。
• blasting、smoking、campfire：对应的高炉、烟熏炉、营火烧炼。
• stonecutting：切石机切割，需要指定 ingredient。
• smithing：锻造台升级，需要指定 base、addition 和 result。

常用配方选项

• permission：设置合成此配方所需的权限节点。
• expCost：合成需要消耗的经验值。
• cooldown：合成冷却时间（秒）。
• limit：限制合成次数，可设置每日限制或总次数限制。
• unlock：设置配方的解锁方式（如指令、权限、经验消耗）。
• failMessage：当合成失败时发送给玩家的提示信息。
• successMessage：当合成成功时发送给玩家的提示信息。

物品变量

在 ingredients 中，可以使用物品变量来精确匹配材料。例如：

ingredients:
  S:
    ==: org.bukkit.inventory.ItemStack
    type: DIAMOND_SWORD
    meta:
      ==: ItemMeta
      meta-type: UNSPECIFIC
      display-name: "§c传奇之剑"
      lore:
        - "一把非常强大的剑。"

❓常见问题

• 如何让配方在配方书中显示？

在配方配置中设置 showInRecipeBook: true，并确保玩家有 craftorithm.unlock.<recipe_id> 权限或通过其他方式解锁了该配方。

• 支持哪些 Minecraft 版本？

Craftorithm 支持 Spigot/Paper 1.16.5 及以上版本。请查看官方页面获取具体的版本兼容信息。

• 如何迁移旧版配方？

插件通常提供向后兼容性，但建议在更新前备份您的配方文件。详细迁移指南请查阅官方 Wiki。

• 在哪里获取帮助？

您可以访问插件的官方 Wiki 页面（https://craftorithm.gitbook.io）或加入其 Discord 社区获取支持。