
Modrinth · Minecraft mod
Scalable
Get the most out of your hardware. Scalable optimises and puts the most important things first
Quick answer
Which Scalable release matches 26.1?
Scalable 2.0.2 targets 26.1, 26.1.1, 26.1.2 with Fabric. Do not install it on the client. It must be installed on the dedicated server. All 1 required mods have matching files.
Where it goes
Is Scalable required on the client, server, or both?
Do not install it on the client. It must be installed on the dedicated server.
This file is marked server-only.
What else does Scalable 2.0.2 need?
2.0.2 on 26.1. Every mod below is checked against that same setup.
Install Fabric API first. We found matching files for this game-version and loader setup.
We only count dependency files that match this setup. A file for another loader does not fill the gap.
Before you install it
Add Scalable without breaking your instance.
Built for Scalable 2.0.2 on 26.1. Pick another file and the loader, install side or required mods may change.
- 01
Stick to this file
Use 2.0.2. It targets 26.1, 26.1.1, 26.1.2 with Fabric; another release may have different loader, side or dependency requirements.
- 02
Bring the mods it needs
Install Fabric API first. We found matching files for this game-version and loader setup.
- 03
Put it on the correct side
Do not install it on the client. It must be installed on the dedicated server.
- 04
Pick the file you checked
Use the “Get this file” button beside 2.0.2. It opens that exact file at the source.
About this project
What does Scalable add?

A lightweight server-side optimization mod for Fabric that keeps your server running smoothly under load by intelligently budgeting work.
Scalable naturally "scales" the server performance. It works great for large servers or a low budget.
The result is a server that stays responsive even when it's struggling.
Unlike similar mods, vanilla mechanics stay intact and the mod wont be noticed by even the most observant players under normal conditions.
Installation
Requires the latest version of Fabric Loader and Fabric API. Drop the .jar into your mods folder. No client installation required.
Please let me know if you have issues on github by making an issue: https://github.com/raderth/Scalable/issues
What does Scalable actually do?
At the start of every server tick, Scalable starts a timer. Chunk ticking and entity ticking proceed normally. But if the budget runs out mid tick, remaining work is deferred to the next tick rather than causing the entire tick to overrun.
Scalable sets a time limit and stops when it's hit. The unprocessed remainder is picked back up next tick. Under normal load, everything is ticked every tick as usual. Under heavy load, less important things (far away chunks, distant entities) are delayed, but the things closest to players stay responsive.
Chunk ticking
Chunks are sorted and processed in this order each tick:
- Deferred chunks from the previous tick (carried over work gets priority)
- Priority chunks those loaded by portals, ender pearls.
- Player-assigned chunks remaining chunks are distributed across players using a round-robin scheduler, with each player's queue sorted by proximity to their projected future position (based on their current velocity).
- Unclaimed chunks any ticking chunks not assigned to a specific player
If the budget runs out before all chunks are processed, the leftovers are deferred.
Entity ticking
Entities are also budget-aware and player-assigned:
- Players are always ticked first (priority queue)
- Other entities are assigned to their nearest player and ticked in round-robin order
- If the budget runs out, remaining entities are simply skipped for that tick
This means that even under heavy load, players and their immediate surroundings are always prioritized. You can still open inventories, interact with the world, and move around smoothly. Similar to how mods like TT20 keep the server interactive even when it's overloaded. The advantage here is that the game is actually still running in a broader sense.
Configuration
Config file is at config/scalable.json and is created automatically on first run.
{
"budget_ms": 40,
"max_deferred": 2048
}
| Field | Default | Description |
|---|---|---|
budget_ms |
40 |
Milliseconds per tick available for chunk and entity ticking. Set to -1 for automatic mode (also 40ms). |
max_deferred |
2048 |
Maximum number of chunks that can be held in the deferred queue at once. Excess entries are dropped (oldest first). |
passive_collision_interval |
5 |
Each mob still runs the pass once every 5 ticks |
In-game commands
All commands require operator.
| Command | Description |
|---|---|
/scalable budget auto |
Switch to automatic budget mode (40ms) |
/scalable budget <ms> |
Set a fixed budget in milliseconds (1–50) |
/scalable profile |
Show current budget mode, MSPT, and TPS |
/scalable deferred <max> |
Set the max deferred chunk queue size (0–65536) |
/scalable collisions off|always|adaptive |
Set how often entity collisions are handled |
Changes made via commands are saved to scalable.json immediately.
Limitations
Note: Scalable smooths out lag spikes and buys your server breathing room. It won't eliminate lag caused by something consistently eating your entire tick budget (e.g. extreme entity counts), but it will make things significantly more bearable while you address the root cause.
- Entities are not deferred between ticks if the budget runs out mid-entity-loop, those entities simply don't tick that frame. Deferred entity carry-over is not yet implemented.
- Consistent heavy lag from entities or other non-chunk sources may still cause TPS drops until those sources are addressed.
Project description from Modrinth.
Pick your setup
Scalable by Minecraft version and loader
Choose the version and loader you play, then open the matching release.
26.3
1 loader build26.1.2
1 loader build26.1.1
1 loader build26.1
1 loader build1.21.11
1 loader buildCheck the dependencies, then try the file in a copied instance before changing a world you care about.
Recent files
Scalable versions and loaders
2.0.2
Scalable-2.0.2.jar
28 May 2026
2.0.1
Scalable-2.0.1.jar
22 May 2026
2.0.0
Scalable-2.0.0.jar
15 May 2026
Looking for an older file? The official Modrinth project page is in Resources.