Repository navigation
Getting Started
Applies to Tick Smoothing 1.0.0 for Minecraft 1.21.1 (NeoForge).
| Minecraft | 1.21.1 |
| NeoForge | 21.1.249 |
| Java | 21 |
| Required mods | none |
On the server and on clients. The mod is server-authoritative, but it syncs the compensation factor to connected clients so their animation and prediction stay in step. A client without it still plays correctly — it just will not be smoothing its own prediction.
This is the important step, and it is the one people skip.
Tick Smoothing does not make your server faster. It hides the symptoms of low TPS. If your server is struggling, this will make it feel fine while it gets steadily worse.
So profile first. If you have not already identified what is eating your tick budget, do that before installing this. Use it alongside real performance work, never instead of it.
/ticksmoothing status
Reports three things live:
| Live TPS | what your server is actually running at |
| Factor | the current compensation, tps / 20
|
| Active modules | which compensation modules are running |
If the factor sits at 1.0, the mod is doing nothing — which means your TPS is fine, or the window has not filled yet. See Configuration for the window size.
This command is the honest test: a healthy server shows 1.0, and any deviation from it is a real
measurement rather than a guess.
| Live TPS | Factor | What it means |
|---|---|---|
| 20 | 1.00 | Nothing to do. Untouched. |
| 15 | 0.75 | Noticeable, mild compensation. |
| 10 | 0.50 | Half-speed compensation. Your players will feel it. |
| 5 | 0.25 | Heavy. See Safety. |
The factor never exceeds 1, so a fast server is never sped up.
Two files:
-
config/tick_smoothing/config.toml— the server config, synced to clients. - a small client-only config for the debug overlay and chat warnings.
Nothing needs changing. See Configuration.
Remove the JAR. No blocks, items or world data are added, so nothing needs cleaning up and saves are untouched.
The compensation factor is computed on the server and sent to clients. Clients do not measure their own frame rate to decide how long an action should take — that would let a laggy client desync from the server's view of the world.
The practical effect: your client animation matches what the server is doing, so you do not see your own item use stutter or rubber-band back.
Tick Smoothing is by Stalking Dragons, released under the MIT License. It hides the symptoms of low TPS; it does not raise TPS. Pair it with real performance work.