Home›Java›Mods›Overclock
Overclock
⚡ 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.
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
✔ Farm Safeguard
Overclock is built to never break your players' builds. These always keep vanilla AI:
♻ Ground Item Manager
★ Built for Folia and big servers
Commands & Permissions
The alias /oc works too. overclock.* grants everything. All permissions except sweep alerts default to OP.
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
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:*"]
Installation
  1. Make sure your server runs Paper, Purpur or Folia 26.1 or newer on Java 25.
  2. Drop Overclock-1.1.0.jar into your plugins folder.
  3. Restart your server. That's it!
Still on Minecraft 1.21.x? Use Overclock 1.0.0.
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​

Commands

Plugin details

Read from the plugin's own plugin.yml.

Quick facts

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.

Explore more