SlotBypass

Slotbypass lets your VIPs and staff join the server even when it's full powered by LuckPerms.

Overview

Slotbypass is a lightweight, server-side mod for Forge 1.20.1. When your server reaches its player cap, normal players get the usual "The server is full!" message but players in the LuckPerms groups (or with the permission) you choose can still get in, up to a configurable number of reserved overflow slots. It only acts when the server is actually full, so there's zero impact the rest of the time.

Example: max-players = 30, maxBypassSlots = 10 → once 30 players are online, regular players are refused but allowed players keep joining, up to a hard cap of 40.

Features

• 🎟️ Reserved slots for VIPs / staff via LuckPerms groups or a permission.
• 🔢 Configurable overflow limit.
• 🖥️ Server-side only vanilla/Forge clients without the mod connect normally.
• ⚙️ Configurable by file and in-game commands.
• ⌨️ Tab-completion of group names from LuckPerms.
• 🧪 Built-in solo test command.
• 🛡️ Safe only the "server full" check is touched; disables itself if LuckPerms is absent.

Requirements

Minecraft 1.20.1 · Forge 47.x · LuckPerms (Forge) · install in the server's mods/ folder.

Configuration slotbypass-server.toml

Option	Default	Description
enabled	true	Enable/disable the bypass.
maxBypassSlots	10	Max players above max-players.
bypassPermission	"slotbypass.join"	Permission that grants the bypass.
bypassGroups	"fondateur,administrateur,moderateur,vip,vip+"	Allowed groups (comma-separated, case-insensitive).

Commands /slotbypass (alias /sbypass)

status · group add/remove/list <name> · slots <n> · enable <true\|false> · permission <node> · simulate <n> (test). Saved instantly. Access: op 4 or LuckPerms slotbypass.admin.

Testing solo (simulate)

/slotbypass simulate 20 makes the server act full → reconnect without a bypass group (refused), with one (allowed). simulate 0 to stop.

---

🇫🇷 Français

Slotbypass permet à vos VIP et à votre staff de rejoindre le serveur même lorsqu'il est plein grâce à LuckPerms.

Présentation

Slotbypass est un mod léger et côté serveur pour Forge 1.20.1. Quand votre serveur atteint sa limite, les joueurs normaux reçoivent le message « Le serveur est plein ! » mais les joueurs des groupes LuckPerms (ou avec la permission) que vous choisissez peuvent quand même entrer, dans la limite d'un nombre configurable de slots de dépassement réservés. Le mod n'agit que serveur plein : aucun impact le reste du temps.

Exemple : max-players = 30, maxBypassSlots = 10 → une fois 30 joueurs en ligne, les joueurs normaux sont refusés mais les autorisés continuent d'entrer, jusqu'à 40 maximum.

Fonctionnalités

• 🎟️ Slots réservés pour les VIP / le staff via groupes LuckPerms ou une permission.
• 🔢 Limite de dépassement configurable.
• 🖥️ Uniquement côté serveur les clients sans le mod se connectent normalement.
• ⚙️ Configurable par fichier et par commandes.
• ⌨️ Auto-complétion des groupes depuis LuckPerms.
• 🧪 Commande de test solo intégrée.
• 🛡️ Sûr seule la vérification « serveur plein » est modifiée ; se désactive si LuckPerms est absent.

Prérequis

Minecraft 1.20.1 · Forge 47.x · LuckPerms (Forge) · à placer dans le mods/ du serveur.

Configuration slotbypass-server.toml

Option	Défaut	Description
enabled	true	Active/désactive le bypass.
maxBypassSlots	10	Nb max de joueurs au-dessus de max-players.
bypassPermission	"slotbypass.join"	Permission qui accorde le bypass.
bypassGroups	"fondateur,administrateur,moderateur,vip,vip+"	Groupes autorisés (virgules, casse ignorée).

Commandes /slotbypass (alias /sbypass)

status · group add/remove/list <nom> · slots <n> · enable <true\|false> · permission <node> · simulate <n> (test). Enregistré instantanément. Accès : op 4 ou LuckPerms slotbypass.admin.

Tester en solo (simulate)

/slotbypass simulate 20 rend le serveur « plein » → reconnecte sans groupe de bypass (refusé), avec un groupe (autorisé). simulate 0 pour arrêter.