Phat’s Progression Framework
A versatile mining tier progression mod for Minecraft, enhancing the vanilla tier system beyond netherite.
Phat’s Progression Framework offers a customizable mining tier system for Minecraft, allowing you to redefine vanilla tools into new tiers, restrict iron ore access with copper, and expand progression beyond netherite – all through a simple JSON configuration. There’s no need for item registration, world generation, or additional content; just a solid foundation for modpack progression.
Unlike most Minecraft progression mods that either introduce their own tiers (compelling users to adopt their tools) or simply add new metals to the vanilla structure (ceasing at netherite), this mod adopts a more flexible approach. It empowers modpack developers to decide how existing tools, blocks, and custom materials integrate. For instance, if you want to require copper to access iron ore, just adjust one line in the configuration. To place runite tools above the netherite tier, modify two lines. If adamantine ore should only be mineable with Mythic Metals’ end-game tools, it’s as simple as that.
Benefits of Installing Phat’s Progression Framework
- For Modpack Developers: Transform a simple progression model into one with greater complexity. Distribute Mythic Metals’ extensive collection of ores across varied tiers and incorporate modded metals between vanilla options, ensuring every metal serves a purpose.
- For Mod Developers: Deliver your tier preferences through datapacks so that users enjoy intelligent defaults right from the start.
- For Players: Join a modpack utilizing this framework and discover motivations to progress beyond netherite.
Features of the Framework
- Tier System Ranging from 0-10: A straightforward integer system where 0-5 corresponds to vanilla tiers (hand tools to netherite), and 6-10 are adaptable for modpacks.
- Mining Tier Restrictions: Tools that are too weak for specific blocks will fail to drop items and will mine at a basic speed. Tool type remains significant (for instance, an axe will still be unable to mine iron ore—only pickaxes can).
- Versatile Tier Matching: Configure tiers by specific item IDs, glob patterns (e.g., `*:copper_pickaxe`), tags (`#c:tools/pickaxes`), or substring keywords. Combine these specifications for greater accuracy (e.g., `{“keyword”: “bronze”, “tag”: “c:tools/pickaxes”}`).
- Datapack Compatibility: Mods can include tier definitions, while modpack developers can override them through configuration.
- Hot Reload Feature: Adjust configurations and simply use `/reload` in-game—no need to restart your game.
- Debugging Commands: Utilize commands like `/progression info` and `/progression block` to verify the tier assignments of any item or block.
Out-of-the-Box Functionality
When initially installed, this mod comes with intelligent default settings that closely resemble the vanilla experience. In the 1.21.11 version, copper-gated iron progression is implemented by default—copper tools (introduced in vanilla 1.21.9) are now a requisite for mining iron ore. The 1.21.1 version preserves the vanilla progression system.
Getting Started Quickly
- First, install the Architectury API.
- Then, place the jar file into your mods directory.
- Launch the game once. Default configuration files will appear at `config/phats_progression/`.
- Edit these files as needed, or simply use the default settings, which function effectively.
Compatibility Considerations
- With Jade: Operates smoothly without needing integration code, as the block tooltip displays the correct mining requirements.
- Server Requirement: This mod must be present on both the client and server; vanilla clients are unable to connect.
- Java 21 is essential (for Minecraft 1.21.x standard).
Configuration Options
Two configuration files can be found at `config/phats_progression/`:
- `block_tiers.json` — designates block assignments to respective tiers.
- `tool_tiers.json` — designates tool assignments to respective tiers.
The schema allows for hybrid string or object entries:
{ “ignore_datapacks”: false, “tiers”: { “6”: [ “mythicmetals:runite_ore”, “*:adamantite_pickaxe”, “#c:tools/pickaxes”, {“keyword”: “mithril”, “tag”: “c:tools/pickaxes”} ] } }
For comprehensive documentation, refer to the GitHub README.
Issue Reporting
Visit GitHub Issues to report any problems.
License Information
Licensed under MIT — feel free to modify and distribute as desired.