CurseForge · Minecraft mod
Joinqueue
Async Join Queue for NeoForge 1.21.1/1.21.8. Prevents crashes and TPS drops during mass logins by holding players in a thread-safe queue. Admits players at a stable rate. Features a custom position screen. Required on both server and client.
Quick answer
Which Joinqueue release matches 1.21.8 Fabric?
joinqueue-1.3.0+1.21.8-fabric.jar targets 1.21.8 with Fabric. The project page does not say whether this file belongs on the client, dedicated server, or both. No extra mods listed for this file.
Where it goes
Is Joinqueue required on the client, server, or both?
The project page does not say whether this file belongs on the client, dedicated server, or both.
The source does not explicitly classify this release as client-only or server-only.
What else does joinqueue-1.3.0+1.21.8-fabric.jar need?
joinqueue-1.3.0+1.21.8-fabric.jar on 1.21.8 Fabric. Every mod below is checked against that same setup.
This file does not list any required mods. Do not add a library just because a different file uses it.
This file does not list any required or optional mods.
Before you install it
Add Joinqueue without breaking your instance.
Built for joinqueue-1.3.0+1.21.8-fabric.jar on 1.21.8 Fabric. Pick another file and the loader, install side or required mods may change.
- 01
Stick to this file
Use joinqueue-1.3.0+1.21.8-fabric.jar. It targets 1.21.8 with Fabric; another release may have different loader, side or dependency requirements.
- 02
Bring the mods it needs
This file does not list any required mods. Do not add a library just because a different file uses it.
- 03
Put it on the correct side
The project page does not say whether this file belongs on the client, dedicated server, or both.
- 04
Pick the file you checked
Use the “Get this file” button beside joinqueue-1.3.0+1.21.8-fabric.jar. It opens that exact file at the source.
About this project
What does Joinqueue add?
JoinQueue
Prevents server crashes and TPS drops caused by many players joining at the same time (e.g., after a restart or during events). The mod puts connecting players into a waiting line during the Configuration Phase, preventing the Main Thread from overloading.
Features
- Activation: With default settings the queue is always active (
queue_activation_threshold = 0). Set a threshold to only activate above a given online player count. It also force-activates during the grace period after a server restart (default 60s) or whenever TPS drops below 8.0. - TPS Check: Players are only released while the server is stable (TPS ≥ 8.0) and the queue is not paused. Releasing stops automatically during heavy lag.
- Release Rate: Players are let in on a timer — by default every 2s (normal) and every 1s (VIP), configurable via
ticks_between_joins/ticks_between_joins_vip. - Manual Control: Admins can use
/joinqueue pauseand/joinqueue resumeto stop or start the login process manually, or/joinqueue toggleto enable/disable the whole mod. - Priority & Bypass:
- Staff members bypass the queue entirely.
- VIP players are moved to the front of the queue and released on a faster timer.
- Server-Full Handling: When the server reaches its vanilla player cap, normal players are held in the queue (with a "Server is full" message) until a slot opens, instead of being rejected at the network layer. Staff bypass the limit and VIPs may join over it.
- Async Chunk Loading: Loads spawn chunks on background threads (radius configurable, default 3) before a player joins to prevent main-thread freezes. A
hold_back_mssafety ceiling (default 1500ms) guarantees release even if chunks are slow. - Queue Screen: Shows players their live position in line, the total queue size, and a custom (configurable) message, including a separate message when the queue is paused.
- Minimum Wait & Size Cap: Optional
min_queue_secondsforces every player to wait a minimum time, andmax_queue_sizecan cap how many players the queue holds.
Commands
All commands require permission level 2 (OP). Changes are saved automatically and take effect immediately.
| Command | Description |
|---|---|
/joinqueue status |
Shows master switch, release state, server-ready state, TPS, queue size, threshold and staff/VIP counts. |
/joinqueue toggle |
Enables or disables the entire mod (master switch). |
/joinqueue pause |
Pauses the queue (players accumulate but are not released). |
/joinqueue resume |
Resumes releasing players. |
/joinqueue reload |
Reloads the configuration from config/joinqueue.json. |
/joinqueue staff <add|remove> <player> |
Adds or removes a player from the Staff (bypass) list. |
/joinqueue vip <add|remove> <player> |
Adds or removes a player from the VIP (fast-queue) list. |
/joinqueue list <staff|vip> |
Lists all members of the Staff or VIP list. |
Technical Details
- Runs entirely in the Configuration Phase, before the player fully joins the world.
- Uses
ConcurrentLinkedDequeandAtomicIntegerfor thread-safe performance. - TPS is measured via a rolling 40-tick ring buffer using
nanoTime. - Extends the server keep-alive timeout (15s → 2min) via a Mixin so queued players are never kicked while waiting.
- Released players that never complete the join handshake are dropped after 15s so the line never stalls.
- Compatible with Arclight/hybrid servers (chunk preloading is safely skipped there).
- Required on both server and client.
Project description from CurseForge.
Pick your setup
Joinqueue by Minecraft version and loader
Choose the version and loader you play, then open the matching release.
1.21.8
2 loader builds1.21.1
2 loader builds1.20.1
2 loader buildsCheck the dependencies, then try the file in a copied instance before changing a world you care about.
Recent files
Joinqueue versions and loaders
joinqueue-1.3.0+1.21.8-fabric.jar
18 Oct 2026
joinqueue-1.2.0+1.21.8-fabric.jar
17 Sept 2026
Looking for an older file? The official CurseForge project page is in Resources.