⚠️ Current documentation targets APTweaks 12.x. If you open a wiki revision, guide, or copied setup note from 2025 or earlier, there is a good chance it still describes the older multi-module architecture.

12.x is the big architecture reset.

Instead of separate downloads for core, spawn, gamerules, items, player, and bundle-style setups, 12.x brings everything together into one modern codebase.

That gives users:

• one main mod instead of a small stack of jars
• one shared config folder
• one command tree under /aptweaks
• easier testing and maintenance
• clearer compatibility handling

Treat the following as legacy guidance unless it is clearly marked otherwise:

• instructions that tell you to install multiple APTweaks modules
• references to the old bundle or mods optimization feature family
• old config locations such as config/adaptiveperformancetweaks/
• TOML-era assumptions copied from older Forge-only releases

1. Remove all old 11.x APTweaks jars from mods/.
2. Install 12.x via the CurseForge or Modrinth launcher. Manual install: download the 12.x jar for your loader and place it in mods/.
3. Start once so the new config files are generated.
4. Review the new config files manually instead of expecting a direct 1:1 migration.

New main location:

• config/adaptive_performance_tweaks/

Spawn preset locations:

• config/adaptive_performance_tweaks/spawn_presets/
• data/<namespace>/aptweaks/spawn_presets/

Because the structure users see in the code, config files, commands, and changelog is already a 12.x structure. Keeping old module-era wording in the current docs makes installation, support, and modpack setup more confusing than the alpha label itself.