⚡ Overclock
Stop lag, not gameplay.
Smart mob AI throttling and safe ground item cleanup for Paper & Folia 26.1+
► Requires Paper or Folia 26.1+ and Java 25. Overclock does NOT run on Spigot or CraftBukkit. ◄
Paper is a free, drop-in replacement for Spigot, and your existing Spigot plugins keep working on it.
Mob farms, villager halls and item overflows are the biggest TPS killers on most servers. The usual fixes either delete everything on the ground or freeze mobs until your farms stop working.
Stop lag, not gameplay.
Smart mob AI throttling and safe ground item cleanup for Paper & Folia 26.1+
► Requires Paper or Folia 26.1+ and Java 25. Overclock does NOT run on Spigot or CraftBukkit. ◄
Paper is a free, drop-in replacement for Spigot, and your existing Spigot plugins keep working on it.
Overclock takes a smarter approach. It watches your tick time live and steps in only when your server actually struggles. It slows the brains of distant and crowded mobs, and it cleans up item pileups, while farms, named mobs and valuable items stay untouched.
⚡ Smart Mob AI
- Only acts when needed. Overclock reads your MSPT every tick and switches between Normal, Warning and Critical. While your server is healthy, it changes nothing.
- Distance and crowd aware. Mobs far from players, or packed into crowded chunks, think less often: every 2nd, 4th or 8th tick instead of every tick. Mobs near players keep full AI unless the server is critical.
- Only the brain slows down. Pathfinding and target selection are throttled. Gravity, water streams, damage, despawning, breeding and growth all run at full speed.
- No stuck mobs. Throttled mobs wake in short bursts that always include a full decision step, so they never freeze in place or forget what they were doing.
- Instant wake-up. Hit, feed, trade with, leash or get chased by a throttled mob, and it gets full AI immediately.
Overclock is built to never break your players' builds. These always keep vanilla AI:
- Name-tagged, tamed and leashed mobs
- Breeding animals and bartering piglins
- Villagers in a trade, and villagers in general until the server is critical
- Mobs that are fighting or chasing a player
- Mobs in minecarts and boats, and jockeys
- Mobs inside detected player farms. Hoppers, dispensers, beds and beehives are recognized automatically.
- Anything you tag with /tag <mob> add overclock.exempt
- Hotspot merging. Identical dropped items near each other are combined into full stacks, but only in busy spots like iron farm collectors and sorter overflows. Nothing is lost; there are just fewer entities.
- Trims the excess only. By default, a sweep only touches chunks piled with more than 64 items and removes the oldest first. A few items lying around a base are never touched. Prefer a classic full clear? That's one setting.
- Players always get warned. A chat countdown runs before every sweep (60s, 30s, 10s, 5s...), and a summary follows afterwards. Sweeps run on a timer, start early when items pile up, or can be started by staff.
- Valuables are never deleted: netherite, diamonds, shulker boxes, elytra, totems and more (fully configurable), all armor, renamed, enchanted and resource-pack items, custom items from other plugins (matched by their data keys, e.g. mmoitems:*), death drops (protected for 5 minutes) and fresh drops younger than 60 seconds.
- Other plugins are safe too. Shop displays and holograms are never merged or removed.
- Region-aware on Folia. Each region is judged by its own tick time, so a lagging farm on one side of the map gets throttled while everywhere else stays vanilla.
- Thread-safe by design. Every mob, item and chunk is handled on the thread that owns it.
- No lag from the cleaner itself. Overclock never scans your whole world. Work is split by area and spread across ticks in small batches.
- Crash-safe. If the server goes down mid-throttle, affected mobs are restored automatically when their chunks load.
- Tested on real servers. Every build is started on real Paper and Folia 26.1.2 and 26.2 servers before release.
- /overclock status ► live MSPT, TPS, memory, throttled mobs and AI ticks saved per second (overclock.status)
- /overclock inspect ► why the mob you're looking at is (or isn't) throttled (overclock.inspect)
- /overclock items ► ground items per world, the busiest hotspots and the next sweep (overclock.items)
- /overclock sweep ► start a sweep with a warning countdown (overclock.sweep)
- /overclock sweep now | cancel ► sweep immediately, or cancel a countdown (overclock.sweep)
- /overclock pause | resume ► give all mobs full AI while you test (overclock.toggle)
- /overclock reload ► reload the config without a restart (overclock.reload)
- Load alerts ► chat alerts when the load state changes (overclock.notify)
- Sweep alerts ► sweep warnings and results, for everyone by default (overclock.sweep.notify)
Configuration
Works great out of the box. Every option is explained in config.yml, and new options are added to your file automatically when you update.
Spoiler: Config preview
Installation
Code (Text):
load-monitor:
warning-mspt: 40.0
critical-mspt: 47.0
throttling:
near-distance: 24
far-distance: 48
profiles:
warning: { near: 1, medium: 2, far: 4 }
critical: { near: 2, medium: 4, far: 8 }
ground-items:
merging:
radius: 2.5
sweeping:
mode: EXCESS # or ALL
excess-per-chunk: 64
interval-minutes: 15
warn-at-seconds: [60, 30, 10, 5, 3, 2, 1]
protection:
materials: ["NETHERITE_*", "DIAMOND*", "*SHULKER_BOX", ELYTRA, TOTEM_OF_UNDYING]
armor: true
enchanted: true
data-keys: ["mmoitems:*"]
warning-mspt: 40.0
critical-mspt: 47.0
throttling:
near-distance: 24
far-distance: 48
profiles:
warning: { near: 1, medium: 2, far: 4 }
critical: { near: 2, medium: 4, far: 8 }
ground-items:
merging:
radius: 2.5
sweeping:
mode: EXCESS # or ALL
excess-per-chunk: 64
interval-minutes: 15
warn-at-seconds: [60, 30, 10, 5, 3, 2, 1]
protection:
materials: ["NETHERITE_*", "DIAMOND*", "*SHULKER_BOX", ELYTRA, TOTEM_OF_UNDYING]
armor: true
enchanted: true
data-keys: ["mmoitems:*"]
- Make sure your server runs Paper, Purpur or Folia 26.1 or newer on Java 25.
- Drop Overclock-1.1.0.jar into your plugins folder.
- Restart your server. That's it!
FAQ
Will it break my farms?
Overclock is designed not to. Physics-based parts (water, hoppers, redstone) are never throttled, important mobs are protected, and farm areas are detected automatically. You can also use /overclock pause to compare behaviour side by side.
Does it change anything when my server isn't lagging?
Mob AI stays fully vanilla until MSPT rises. Item merging and sweeps only act on real pileups.
Is it safe to remove?
Yes. Stop your server normally and delete the jar. Every mob gets its normal AI back on shutdown.
Does it work with Spigot?
No. Overclock needs Paper, Purpur or Folia.
Found a bug or have an idea?
Open an issue on GitHub
Quick facts
- Edition: Minecraft Java
- File type: .jar
- Minecraft versions listed: 1.21, 26.1, 26.2
- How to install: Install the matching mod loader (Forge, Fabric or NeoForge) for your Minecraft version. → Download the .jar. → Put it in the .minecraft/mods folder and launch that loader profile.
- Where to get it: Opens on Spigot — not every file is mirrored on our own servers.
Install steps are the general flow for this file type — How to install Minecraft Java mods & modpacks walks through it step by step.
Overclock is a free Minecraft Java mod. Compatible with Minecraft 1.21, 26.1, 26.2. Downloaded 3 times (via Spigot). Download it and open it directly in the game.