SlotBypass

Slotbypass 让您的 VIP 和工作人员即使在服务器满员时也能加入服务器，由 LuckPerms 提供支持。

概述

Slotbypass 是一个针对 Forge 1.20.1 的轻量级、服务器端模组。当您的服务器达到玩家上限时，普通玩家会收到常见的 “服务器已满！” 消息，但您指定的 LuckPerms 权限组（或拥有权限）中的玩家仍然可以进入，上限为一个可配置的预留溢出槽位数量。它仅在服务器实际满员时才会生效，因此其余时间零影响。

示例：max-players = 30，maxBypassSlots = 10 → 一旦有 30 名玩家在线，常规玩家将被拒绝，但允许的玩家可以继续加入，直至达到 40 人的硬上限。

功能

• 🎟️ 通过 LuckPerms 权限组或权限，为 VIP / 工作人员提供预留槽位。
• 🔢 可配置的溢出限制。
• 🖥️ 仅服务器端 - 没有安装该模组的普通/Forge 客户端可以正常连接。
• ⚙️ 可通过配置文件 和 游戏内命令进行配置。
• ⌨️ 从 LuckPerms 自动补全权限组名称。
• 🧪 内置单人测试命令。
• 🛡️ 安全 - 仅修改“服务器已满”检查；如果 LuckPerms 缺失，则自行禁用。

必要条件

Minecraft 1.20.1 · Forge 47.x · LuckPerms (Forge) · 安装到服务器的 mods/ 文件夹中。

配置文件 slotbypass-server.toml

选项	默认值	描述
enabled	true	启用/禁用绕过功能。
maxBypassSlots	10	超出 max-players 的最大玩家数量。
bypassPermission	"slotbypass.join"	授予绕过权限的权限节点。
bypassGroups	"fondateur,administrateur,moderateur,vip,vip+"	允许的权限组（逗号分隔，不区分大小写）。

命令 /slotbypass (别名 /sbypass)

status · group add/remove/list <名称> · slots <n> · enable <true|false> · permission <节点> · simulate <n> (测试)。更改会立即保存。权限：op 4 或 LuckPerms 的 slotbypass.admin。

单人测试 (simulate)

/slotbypass simulate 20 会让服务器模拟满员状态 → 重新连接时，若没有绕过权限组则会（被拒绝），若拥有则会（被允许）。使用 simulate 0 停止测试。

---

🇫🇷 法语

Slotbypass 允许您的 VIP 和工作人员即使在服务器满员时也能加入服务器，这得益于 LuckPerms。

介绍

Slotbypass 是一款针对 Forge 1.20.1 的轻量级、服务器端模组。当您的服务器达到上限时，常规玩家会收到 “服务器已满！” 的消息，但您选择的 LuckPerms 权限组（或拥有权限）中的玩家仍然可以进入，受限于一个可配置的预留溢出槽位数量。该模组仅在服务器满员时才起作用：其余时间毫无影响。

示例：max-players = 30，maxBypassSlots = 10 → 一旦 30 名玩家在线，常规玩家会被拒绝，但被授权的玩家可以继续进入，最多可达 40 人。

功能特性

• 🎟️ 通过 LuckPerms 权限组或权限，为 VIP / 工作人员提供预留槽位。
• 🔢 可配置的溢出限制。
• 🖥️ 仅限服务器端 - 未安装该模组的客户端可以正常连接。
• ⚙️ 可通过配置文件 和 游戏内命令进行配置。
• ⌨️ 从 LuckPerms 自动补全权限组名称。
• 🧪 内置单人测试命令。
• 🛡️ 安全 - 仅修改“服务器已满”检测；若 LuckPerms 缺失则自动禁用。

先决条件

Minecraft 1.20.1 · Forge 47.x · LuckPerms (Forge) · 放置在服务器的 mods/ 目录下。

配置文件 slotbypass-server.toml

选项	默认值	描述
enabled	true	启用/禁用绕过功能。
maxBypassSlots	10	超出 max-players 的最大玩家数。
bypassPermission	"slotbypass.join"	授予绕过权限的权限节点。
bypassGroups	"fondateur,administrateur,moderateur,vip,vip+"	允许的权限组（逗号分隔，忽略大小写）。

命令 /slotbypass (别名 /sbypass)

status · group add/remove/list <名称> · slots <n> · enable <true|false> · permission <节点> · simulate <n> (测试)。更改会立即保存。权限：op 4 或 LuckPerms 的 slotbypass.admin。

单人测试 (simulate)

/slotbypass simulate 20 会让服务器模拟“满员”状态 → 重新连接时，若没有绕过权限组（被拒绝），若有（被允许）。使用 simulate 0 停止。