Phat's Progression Framework

Phat's Progression Framework is a config-driven mining tier system for Minecraft. Reassign vanilla tools to new tiers, gate iron ore behind copper, extend progression past netherite — entirely through JSON. No item registration, no worldgen, no content. Just a flexible foundation for modpack progression.

Most Minecraft progression mods either add their own tiers (forcing you to use their tools) or bolt new metals onto the vanilla system (capping at netherite). This mod takes a different approach: it lets modpack developers choose how the existing tools, blocks, and modded materials fit together. Want copper to gate iron ore? One config line. Want runite tools above netherite? Two config lines. Want adamantine ore to require Mythic Metals' end-game tools? You get the idea.

Available on Fabric

Available on NeoForge

Why install this

- Players: turn flat progression into something with real depth. Spread Mythic Metals' 20+ ores across distinct tiers. Insert mod metals between vanilla ones. Make every metal meaningful. - Players: ship your tier opinions via datapack so users get sensible defaults out of the box. - Players: install a modpack that uses this and finally have a reason to upgrade past netherite.

What it does

- Debug command: integers, easy to reason about. 0-5 match vanilla (hand through netherite), 6-10 are modpack-extensible. - Debug command: tools too weak for a block don't drop items and mine at bare-hands speed. Tool TYPE still matters (axe still won't mine iron ore — only pickaxes do). - Debug command: configure tiers by exact item ID, glob pattern (`*:copper_pickaxe`), tag (`#c:tools/pickaxes`), or substring keyword. Combine these for precision (`{"keyword": "bronze", "tag": "c:tools/pickaxes"}`). - Debug command: mods ship tier definitions, modpack devs override them via config. - Debug command: edit configs and `/reload` in-game. No restart needed. - Debug command: `/progression info` and `/progression block` show what tier any item or block is currently assigned to.

Default behavior

Out of the box, this mod ships with sensible defaults that mostly mirror vanilla. The 1.21.11 build adds copper-gates-iron progression by default — copper tools (added in vanilla 1.21.9) are now actually required to mine iron ore. The 1.21.1 build keeps vanilla progression intact.

Quick start

1. Install Architectury API. 2. Drop this jar into your mods folder. 3. Launch the game once. Default config files generate at `config/phats_progression/`. 4. Edit them or leave them alone — the defaults work.

Compatibility

- Java 21: works without integration code — the block-look tooltip shows the right mining requirements. - Java 21: requires the mod on both client and server. Vanilla clients cannot connect. - Java 21 required (Minecraft 1.21.x standard).

Configuration

Two config files at `config/phats_progression/`: - `block_tiers.json` — assign blocks to tiers - `tool_tiers.json` — assign tools to tiers

Schema accepts hybrid string-or-object entries:

```json { "ignore_datapacks": false, "tiers": { "6": [ "mythicmetals:runite_ore", "*:adamantite_pickaxe", "#c:tools/pickaxes", {"keyword": "mithril", "tag": "c:tools/pickaxes"} ] } } ```

See the GitHub README for full documentation.

Reporting issues

GitHub Issues

License

MIT — modify and ship at will.