🐣 Advancement Cradle

The Ultra-Lightweight, Data-Driven Progression Engine for 1.21.1

Advancement Cradle is a robust, modular framework that transforms Minecraft's native advancement tracks into a powerful, data-driven RPG progression system. Built with performance and flexibility in mind, it allows modpack developers, server administrators, and content creators to map custom reward payloads directly to vanilla or modded advancements using simple data pack JSON files. Zero Java knowledge required.

Whether you want to build an MMORPG-style leveling system, reward players for conquering difficult milestones, or create highly specific harvest tables, Advancement Cradle provides the stable core infrastructure to make it happen.

🛠️ Core Capabilities

• ⚡ Dynamic Attribute Modifiers: Permanent injections into Minecraft's native Core Attribute registry (e.g., Movement Speed, Mining Efficiency, Max Health). Supports multiple mathematical operations (ADD_VALUE, ADD_MULTIPLIED_BASE, ADD_MULTIPLIED_TOTAL) with built-in duplicate prevention.

• 💎 Advanced Conditional Drop Tables: Trigger drop chances dynamically based on block mining or entity combat. Includes full tool/weapon validation matching against explicit item IDs or native registry tags (e.g., #minecraft:pickaxes).

• 🎒 Direct Item Grants: Instantly inject items into the player's hotbar or inventory upon achievement completion. Features an automated inventory fail-safe that safely drops the payload at the player's feet if their bags are full.

• 💾 Cross-Session Permanence: Light on memory and completely uncorruptible. The engine utilizes Minecraft's native advancement logs as its absolute source of truth, automatically reconstructing player attribute sheets and active drop rules during the login sequence.

• ⚙️ Native In-Game GUI Configuration: Includes local client preference synchronization. Players can customize their experience, like globally disabling reward audio feedback, directly through the native NeoForge "Mods" list configuration menu.

📝 Quick Start & Syntax Schema

Registering a progression profile is as simple as placing a lowercase JSON file inside your custom data pack namespace directory: data/[your_namespace]/cradle_rewards/any_filename.json

Multi-Reward Example Blueprint:

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"
        ]
      }
    ]
  }
]

🛑 Strict Developer Validation Logs

Say goodbye to hidden syntax issues. Advancement Cradle includes a strict, automated schema validator that protects server stability. If a creator introduces a typo, an out-of-bounds percentage, or a missing field, the engine discards the broken entry safely and prints a clean, line-by-line diagnostic warning directly to the server console stream to accelerate your development workflow.

🤝 Permissions & Modpacks

• Can I use this in my modpack?Absolutely! You have full permission to include Advancement Cradle in any free or commercial modpack distributed on CurseForge or elsewhere.

• Bug Reports & Feedback: Please utilize the official repository issue tracker to report bugs, registry conflicts, or feature requests.