进阶摇篮

进阶摇篮

一个数据驱动的 NeoForge 框架，让创作者能够通过简单的数据包 JSON 模式将成就映射到永久属性修饰符、自定义物品授予和条件掉落表。

🐣 进度摇篮

1.21.1 的超轻量、数据驱动进度引擎

进度摇篮 是一个强大且模块化的框架，能将 Minecraft 原生的进度系统转化为一个强大的、数据驱动的 RPG 进度系统。它注重性能和灵活性，允许整合包开发者、服务器管理员和内容创作者使用简单的数据包 JSON 文件，将自定义奖励负载直接映射到原版或模组进度上。无需任何 Java 知识。

无论你是想构建一个 MMORPG 风格的升级系统、在玩家完成困难里程碑时给予奖励，还是创建高度特定的收获表，进度摇篮都能提供稳定的核心基础设施来帮助你实现。

🛠️ 核心功能

  • ⚡ 动态属性修饰符： 永久注入到 Minecraft 原生核心属性注册表（例如：移动速度、挖掘效率、最大生命值）。支持多种数学运算（ADD_VALUE、ADD_MULTIPLIED_BASE、ADD_MULTIPLIED_TOTAL），并内置了重复防止机制。

  • 💎 高级条件掉落表： 根据方块挖掘或实体战斗动态触发掉落几率。包含完整的工具/武器验证，可匹配具体的物品 ID 或原版注册表标签（例如：#minecraft:pickaxes）。

  • 🎒 直接物品授予： 玩家完成成就后，立即将物品注入到其快捷栏或物品栏中。具有自动化的物品栏容错机制：如果背包已满，会安全地将负载掉落在玩家脚边。

  • 💾 跨会话持久性： 内存占用低且完全防损坏。引擎使用 Minecraft 原生的进度日志作为绝对真相来源，在登录序列期间自动重建玩家的属性表和活跃的掉落规则。

  • ⚙️ 原生游戏内 GUI 配置： 包含本地客户端偏好同步。玩家可以直接通过原生的 NeoForge "模组"列表配置菜单来自定义体验，例如全局禁用奖励音效反馈。

📝 快速入门与语法结构

注册一个进度配置文件的步骤很简单：只需将一个全部小写的 JSON 文件放入你的自定义数据包命名空间目录中：data/[你的命名空间]/cradle_rewards/任意文件名.json

多奖励示例蓝图：

JSON

{
[
  {
    "advancement_id": "minecraft:story/mine_stone",
    "enabled": true,
    "rewards": [
      {
        "type": "attribute_modifier",
        "attribute_id": "minecraft:generic.movement_speed",
        "modifier_id": "advancement_cradle:speed_boost",
        "value": 0.15,
        "operation": "ADD_MULTIPLIED_BASE"
      }
    ]
  },
  {
    "advancement_id": "minecraft:story/mine_diamond",
    "enabled": false,
    "rewards": [
      {
        "type": "item_grant",
        "grant_item": "minecraft:netherite_scrap",
        "grant_amount": 1
      }
    ]
  },
  {
    "advancement_id": "minecraft:story/enchant_item",
    "rewards": [
      {
        "type": "conditional_drop",
        "target_block": "minecraft:obsidian",
        "drop_item": "minecraft:lapis_lazuli",
        "drop_amount": 3,
        "chance": 0.40,
        "drop_sound": "minecraft:entity.experience_orb.pickup",
        "required_tools": [
          "minecraft:netherite_pickaxe",
          "#minecraft:cluster_max_harvestables"
        ]
      }
    ]
  }
]

🛑 严格的开发者验证日志

告别隐藏的语法问题。进度摇篮包含一个严格的自动模式验证器，可保护服务器稳定性。如果创建者引入了拼写错误、超出范围的百分比或缺失字段，引擎会安全地丢弃错误条目，并在服务器控制台流中直接打印清晰、逐行的诊断警告，以加速你的开发工作流程。

🤝 许可与整合包

  • 我可以在我的整合包中使用这个模组吗？ 当然可以！你有完全的许可，可以将进度摇篮包含在 CurseForge 或其他地方分发的任何免费或商业整合包中。

  • 错误报告与反馈： 请使用官方仓库的问题跟踪器来报告错误、注册表冲突或功能请求。