Adaptive Performance Tweaks

# Adaptive Performance Tweaks (APTweaks) (http://cf.way2muchnoise.eu/versions/Minecraft_450269_all.svg)] (http://cf.way2muchnoise.eu/title/450269.svg)] (http://cf.way2muchnoise.eu/full_450269_downloads.svg)] (https://img.shields.io/badge/dynamic/json?labelColor=black&color=grey&label=&query=title&url=https://api.modrinth.com/v2/project/kLawTYXp&style=flat&logo=modrinth)] (https://img.shields.io/badge/dynamic/json?labelColor=black&color=grey&label=&suffix=%20downloads&query=downloads&url=https://api.modrinth.com/v2/project/kLawTYXp&style=flat&logo=modrinth)] (https://img.shields.io/badge/Report%20Issue%20%2F%20Bug%20%2F%20Crash-grey?style=flat&logo=github)] (https://img.shields.io/github/issues/MarkusBordihn/BOs-Adaptive-Performance-Tweaks?style=flat&logo=Github&color=red)] (https://img.shields.io/github/issues-closed/MarkusBordihn/BOs-Adaptive-Performance-Tweaks?style=flat&logo=Github)] ! > ⚠️ **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 <span><iframe width="788" height="443" src="https://www.youtube.com/embed/XqRv3liEfqs" frameborder="0" allowfullscreen="allowfullscreen"></iframe></span> ## 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 (https://www.curseforge.com/minecraft/mc-mods/adaptive-performance-tweaks) or (https://modrinth.com/mod/adaptive-performance-tweaks) 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 (https://github.com/MarkusBordihn/BOs-Adaptive-Performance-Tweaks/wiki/SpawnPresets). ## Feature overview 🧩 | Feature | What it does | |---------------------|--------------