

Modrinth · Fabric, Forge, NeoForge, Quilt
Adaptive Performance Tweaks on your Minecraft server
Adaptive Performance Tweaks runs on Minecraft servers with Fabric or Forge or NeoForge or Quilt. Order your server, set the loader in the panel and install the mod with one click in the mod browser.
The Adaptive Performance Tweaks mod automatically adjust specific settings on the server to allow a better TPS/FPS.
- Downloads
- 107.8K
- Author
- Kaworru
- Loader
- Fabric, Forge, NeoForge, Quilt
- Minecraft
- 1.18.2 – 26.3
- Updated
- –
Screenshots
What Adaptive Performance Tweaks looks like
Images: Adaptive Performance Tweaks on Modrinth, published by the project team.
Setup
Install Adaptive Performance Tweaks on your server
The server and players need the same loader and Minecraft version. Back up the world before adding or updating mods.
- 01
Configure
4 GB of RAM is preselected. You choose the term and add-ons and pay by credit card or PayPal.
- 02
Set the loader
In the panel, set the server software to Fabric or Forge or NeoForge or Quilt and choose the matching Minecraft version, for example 26.3.
- 03
Install the mod
Search the mod browser for “Adaptive Performance Tweaks” and install the release for your loader. Alternatively, upload the .jar to the mods folder via SFTP. Required dependencies are listed on the project page.
- 04
Connect
Adaptive Performance Tweaks is not needed on the client. Players connect using the server address from the panel.
- On the server
- Required
- On the client
- Not needed
- Loader
- Fabric, Forge, NeoForge, Quilt
- Minecraft
- 26.3, 26.2, 26.1.2 +15 more
- License
- MIT License
The panel
Install mods, find errors.
Real screenshots from the Mado panel. Both come with every Minecraft server.
Mod browser
Modrinth and CurseForge, right in the panel.
The browser filters by your Minecraft version. Install mods with one click, without uploading .jar files.

AI crash analysis
When a mod crashes, the analyzer reads the log.
Mods often fail on a wrong loader version, Java version or missing dependency. The analyzer names a likely cause and suggests a fix.

Releases
Published releases
Pick the file that matches your server’s loader and Minecraft version. The server and players need the same release.
Adaptive Performance Tweaks · Modrinth- Adaptive Performance Tweaks 12.10.0October 9, 2026Minecraft 26.3 · Forge
- Adaptive Performance Tweaks 12.10.0October 9, 2026Minecraft 26.3 · NeoForge
- Adaptive Performance Tweaks 12.10.0October 9, 2026Minecraft 26.3 · Fabric, Quilt
- Adaptive Performance Tweaks 12.10.0October 9, 2026Minecraft 26.2 · NeoForge
- Adaptive Performance Tweaks 12.10.0October 9, 2026Minecraft 26.2 · Fabric, Quilt
Original description by the project author
Adaptive Performance Tweaks (APTweaks)

⚠️ 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 samemods/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
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 🚀
- Remove any old 11.x APTweaks jars from
mods/. - 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 inmods/. - Start the game, world, or server once.
- Review the generated files in
config/adaptive_performance_tweaks/. - Leave defaults on for a first test run before tuning anything.
- 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 🧩
| Feature | What it does |
|---|---|
| Spawn | Limits mob pressure with load-aware checks, view-area logic, and configurable presets |
| Game Rules | Adjusts selected gamerules when the server gets stressed |
| Items | Merges or removes excess dropped items |
| Experience Orbs | Clusters XP orbs to lower entity counts |
| Arrows | Cleans up stuck arrows without touching active projectiles |
| Player Protection | Protects players during login and helps newer or listed players |
| Simulation Distance | Lowers simulation cost automatically under load and can temporarily throttle harder during heavy exploration |
| View Distance | Optional advanced safety valve for heavy servers |
| AI Throttling | Optional advanced slowdown for far-away mob AI |
| Chunk Gen Throttle | Optional advanced slowdown for chunk generation work |
| Monitoring | Optional log-based visibility into load and entity pressure |
| Benchmark | Built-in scenario-based baseline/active measurement suite for real worlds, servers, and modpacks |
Simulation Distance stays load-aware as before, but can now also clamp down harder during
heavy exploration at MEDIUM+ load and then recover gradually after players stop moving or finish
logging in.
Commands 🔧
The main command root is /aptweaks.
Useful commands include:
/aptweaks status/aptweaks load/aptweaks stats/aptweaks stats items/aptweaks stats xp_orbs/aptweaks stats arrows/aptweaks stats reset/aptweaks entities overview/aptweaks feature <id> <true|false>/aptweaks playerPositions/aptweaks kill all_dropped_items/aptweaks reload/aptweaks debug/aptweaks benchmark/aptweaks benchmark start/aptweaks benchmark start scenario <general|items|xp|entities|recovery>
If something feels wrong, run these four commands first:
/aptweaks status/aptweaks load/aptweaks stats/aptweaks debug <module> true
Reload note:
/aptweaks reloadreloads the.cfgfiles- spawn preset JSON changes are safer with vanilla
/reloador a restart - feature on/off changes may still require a restart to take full effect
Learn more 📚
The wiki is the main 12.x documentation:
Adaptive Performance Tweaks server crashes on startup – what to do?
Common causes: the loader or Minecraft version does not match the mod file, a dependency is missing, or RAM is too low. Check the log (latest.log) for “OutOfMemoryError”, “Mixin” or missing mods. At Mado, the AI crash analysis reads the log and suggests a cause. You can change the loader and version in the panel.
Which loader does Adaptive Performance Tweaks run on?
According to Modrinth, Adaptive Performance Tweaks supports Fabric, Forge, NeoForge, Quilt for Minecraft 26.3, 26.2, 26.1.2. Forge and Fabric files are not interchangeable: pick one loader for the server and clients.
How much RAM does a server with Adaptive Performance Tweaks need?
As guidance, 3–4 GB for a server with this mod. This is an estimate, not a measured minimum. More mods, many players and long view distances need more. The spark profiler shows whether a mod is costing tick time.
Similar mods
Popular mods in the same category
Client only
Sodium
by jellysquid3
A high-performance rendering engine replacement for Minecraft, which greatly improves frame rates and reduces micro-stutter.
Client only
Iris Shaders
by coderbot
A modern shader pack loader for Minecraft intended to be compatible with existing OptiFine shader packs
Client only
Entity Culling
by tr7zw
Using async path-tracing to hide Block-/Entities that are not visible
Server-ready
FerriteCore
by malte0811
Memory usage optimizations
Ready for your server with Adaptive Performance Tweaks?
4 GB of RAM from €8.00 per month. 35% off your first month with MADO35.