Mericle's CustomRecipes

插件

· 作者 Mericle

CustomRecipes 是一款轻量级的 Minecraft Spigot 插件,允许服务器管理员通过简单的 JSON 文件添加自定义合成配方。该插件支持有形状和无形状的配方,并具备热重载功能。

0 本站下载 0 关注 更新于 1 年前

最新 1.2-ALPHA · 1.21.9 · Paper / Spigot

一键开服(送7天)

MERICLE 的自定义配方

项目描述

CustomRecipes 是一款轻量级、对开发者友好的 Minecraft Spigot 插件,使服务器管理员能够使用简单的 JSON 配置文件轻松地在 Minecraft 服务器中添加自定义合成配方。该插件在复杂的配方管理系统和用户友好的配置之间架起桥梁,提供了一种清晰直观的方式来扩展 Minecraft 的合成系统。

核心目的

本插件解决了 Minecraft 服务器管理员在不具备复杂编程知识的情况下添加自定义合成配方的常见需求。它提供了一种基于 JSON 的简单配方创建方法,既易于人类阅读又便于维护:

  • 基于文件的配置 - 在各个 JSON 文件中定义配方
  • 热重载功能 - 无需重启服务器即可添加配方
  • ZenScript 风格的语法 - 为经验丰富的用户提供熟悉的格式
  • 零依赖 - 独立插件,无外部要求

主要特性

基于 JSON 的配方系统

  • 配方存储在 recipes/ 文件夹中的各个 .json 文件里
  • 全面的错误处理与详细的日志记录,便于故障排除
  • 首次运行时自动生成示例配方

全面的配方支持

  • 有形状配方 (Shaped Recipes):位置相关的合成图案(类似原版工具)
  • 无形状配方 (Shapeless Recipes):顺序无关的材料组合(类似原版染料)
  • 物品标签支持:使用 Minecraft 的物品标签(例如 #minecraft:sand)以接受多种材料变体

高级物品自定义

  • 自定义显示名称:使用 & 格式化代码完全支持颜色
  • 丰富的背景文本 (Lore):支持颜色格式化的多行物品描述
  • 附魔应用:自动将附魔应用于合成出的物品
  • 灵活的输出数量:支持生成多个物品的配方

配方管理

  • 通过 /customrecipes reload 命令实现的热重载系统
  • 带有详细错误报告的配方验证
  • 自动注册到 Bukkit 的合成系统
  • 冲突检测与解决

对开发者友好的架构

  • 模块化设计,关注点清晰分离
  • 可扩展的结构,便于未来功能添加
  • 采用现代 Java 实践,利用 Java 21 特性

命令

  • /customrecipes - 显示插件信息
  • /customrecipes reload - 无需重启服务器重新加载所有配方

配方格式示例

有形状配方(位置重要)

{
  "type": "shaped",
  "name": "reinforced_sword",
  "result": {
    "item": "minecraft:diamond_sword",
    "count": 1,
    "display_name": "&bReinforced Sword",
    "lore": ["&7Enhanced with special materials"],
    "enchantments": {"sharpness": 2, "unbreaking": 1}
  },
  "pattern": [
    ["minecraft:diamond", "minecraft:diamond", "minecraft:diamond"],
    ["minecraft:air", "minecraft:stick", "minecraft:air"],
    ["minecraft:air", "minecraft:stick", "minecraft:air"]
  ]
}

无形状配方(顺序不重要)

{
  "type": "shapeless",
  "name": "dirt_diamonds",
  "result": {
    "item": "minecraft:diamond",
    "count": 4,
    "display_name": "&aDirt Diamond"
  },
  "ingredients": [
    "minecraft:dirt", "minecraft:dirt", 
    "minecraft:dirt", "minecraft:stick"
  ]
}

服务器影响

  • 性能:高效的配方注册,运行时开销极小
  • 兼容性:适用于 Spigot、Paper 和基于 Bukkit 的服务器
  • 可扩展性:可处理大量自定义配方而不会影响性能
  • 数据:基于文件的配置,存储占用极小

安装

  1. 下载插件 JAR 文件
  2. 放入服务器的 plugins/ 文件夹
  3. 重启服务器
  4. 将 JSON 配方文件添加到 plugins/CustomRecipes/recipes/
  5. 使用 /customrecipes reload 加载新配方

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源