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.

  1. 01

    Configure

    4 GB of RAM is preselected. You choose the term and add-ons and pay by credit card or PayPal.

  2. 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.

  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.

  4. 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.

Browser in the Mado panel with search, a CurseForge or Modrinth source switch and install buttons.

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.

Optimization page in the Mado panel with the AI Log Analyzer enabled and a “Server Crashed” notice with an “Analyze Now” button.

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
Original description by the project author

Adaptive Performance Tweaks (APTweaks)

APTweaks: Bundle Versions

Download on CurseForge
CurseForge Downloads

Download on Modrinth
Modrinth Downloads

Report an Issue
Open Issues
Closed Issues

Adaptive Performance Tweaks

⚠️ 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

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/.
  3. Start the game, world, or server once.
  4. Review the generated files in config/adaptive_performance_tweaks/.
  5. Leave defaults on for a first test run before tuning anything.
  6. 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 reload reloads the .cfg files
  • spawn preset JSON changes are safer with vanilla /reload or 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:

FAQ

Adaptive Performance Tweaks questions

Question not listed? Ask our team.

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.

Ready for your server with Adaptive Performance Tweaks?

4 GB of RAM from €8.00 per month. 35% off your first month with MADO35.

Order server