Adaptive Performance Tweaks

Adaptive Performance Tweaks (APTweaks)

[][mod_page]

[][mod_page] [][mod_page]

[][modrinth_page] [][modrinth_page]

[][issues] [][issues_open] [][issues_closed]

![Adaptive Performance Tweaks][header]

> ⚠️ 12.x is the current unified release line. > Older docs or setup guides may still describe the legacy 11.x multi-module layout. > > 💾 Back up your world and config files before updating. > 12.x is still a early-release and some configuration details may change between releases. > > 📝 Known limitations before stable release > There is no in-game config GUI yet. 12.x currently uses a config-first workflow, and larger > servers will usually need some spawn tuning beyond the defaults. > > 🔄 Upgrading from 11.x? > Remove all old APTweaks module jars before installing 12.x. Do not mix 11.x and 12.x files in > the same mods/ folder.

Adaptive Performance Tweaks is a server-side optimization mod for Forge, Fabric, and NeoForge. It watches Minecraft's server-side load and adjusts selected systems automatically to reduce lag pressure on dedicated servers, single-player worlds, and LAN-open worlds.

That means APTweaks is not only for public or dedicated servers. It can also help in normal client worlds, because single-player and LAN sessions still run the same server-side systems for spawning, ticking, gamerules, items, XP orbs, and simulation distance.

Instead of asking you to assemble separate modules, 12.x bundles the major feature groups in one mod:

• Spawn control and spawn presets
• Game rule adaptation
• Item, XP orb, and arrow cleanup
• Player login and beginner protection
• Adaptive simulation distance with movement-aware throttling
• Optional advanced throttles for AI, chunk generation, and view distance
• Monitoring and benchmarking tools

🎥 Introduction and Overview Video

<iframe width="788" height="443" src="https://www.youtube.com/embed/XqRv3liEfqs" frameborder="0" allowfullscreen="allowfullscreen"></iframe>

What APTweaks is good at ✨

APTweaks helps most when performance problems are caused by:

• too many mobs or repeated spawn attempts
• large amounts of dropped items, XP orbs, or stuck arrows
• overloaded exploration and chunk generation
• worlds or servers that need softer automatic reactions instead of permanent hard limits

APTweaks is especially useful for:

• dedicated servers that need adaptive protection under changing player load
• modpacks with heavy entity pressure
• single-player worlds with farms, exploration, or too much dropped loot
• LAN worlds where the host machine struggles with the integrated server load

It is less helpful for issues that come mainly from:

• heavy redstone or machine logic
• one specific broken mod or entity
• world corruption or storage bottlenecks

Quick start 🚀

1. Remove any old 11.x APTweaks jars from mods/.
2. Install APTweaks 12.x via

the CurseForge or Modrinth launcher. Manual install: download the jar for your loader from one of those pages and place it in mods/.

1. Start the game, world, or server once.
2. Review the generated files in config/adaptive_performance_tweaks/.
3. Leave defaults on for a first test run before tuning anything.
4. If you run a larger server, review spawn limits early. The fallback spawn defaults are tuned for

about 4 players.

Spawn presets are loaded from:

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

If you want to customize presets, start with the templates and examples in wiki/SpawnPresets.

Feature overview 🧩