WhitelistGate
WhitelistGate 是一款轻量级服务端模组,它添加了一个基于昵称的独立白名单功能,且不会使用或修改 Minecraft 原版 whitelist.json。
它专为希望拥有独立、简单访问列表(在在线模式和离线模式下均可运行)的服务端所有者设计。玩家无需在客户端安装 WhitelistGate,该模组也不会添加自定义的网络握手协议。
特性
- 完全为服务端:原版客户端或未安装此模组的客户端均可连接。
- 兼容
online-mode=true 和 online-mode=false。
- 对玩家昵称进行不区分大小写的检查。
- 保留原版的封禁、IP 封禁、玩家数量限制及其他连接检查机制。
- 使用自身的配置文件,绝不触碰原版
whitelist.json。
- 命令更改立即保存。
- 无需账号、密码、注册、数据库、GUI 界面或客户端安装。
安装
- 在服务端安装 Forge。
- 将 WhitelistGate JAR 文件放入服务端的
mods 文件夹中。
- 启动服务器。
- 通过命令配置白名单,或编辑
config/whitelistgate/whitelist.json 并运行 /whitelistgate reload。
请勿在玩家客户端上安装 WhitelistGate。它仅设计用于在服务端运行。
命令
所有命令均需权限等级 3,可由服务端操作员(OP)或在专用服务器控制台中使用。
/whitelistgate enable
/whitelistgate disable
/whitelistgate add <nickname>
/whitelistgate remove <nickname>
/whitelistgate list
/whitelistgate reload
启用 WhitelistGate 不会踢出已连接的玩家。禁用它会立即停止 WhitelistGate 对新连接的限制。
离线模式安全警告
在离线模式服务器上,玩家可以选择任何昵称,包括属于他人的昵称。昵称白名单仅控制哪些名称可以连接,但无法对用户进行身份验证,也无法证明其对 Minecraft 账号的所有权。
WhitelistGate 根据 Apache License 2.0 许可授权。
WhitelistGate
WhitelistGate is a lightweight, server-side mod that adds an independent nickname-based whitelist without using or modifying Minecraft's vanilla whitelist.json.
It is designed for server owners who want a separate, simple access list that works in both online and offline mode. Players do not need to install WhitelistGate on their clients, and the mod does not add a custom network handshake.
Features
- Fully server-side: vanilla clients and clients without the mod can connect.
- Works with both
online-mode=true and online-mode=false.
- Checks player nicknames case-insensitively.
- Preserves vanilla bans, IP bans, player limits, and other connection checks.
- Uses its own configuration file and never touches vanilla
whitelist.json.
- Saves command changes immediately.
- No accounts, passwords, registration, database, GUI, or client-side installation.
Installation
- Install Forge on the server.
- Place the WhitelistGate JAR in the server's
mods folder.
- Start the server.
- Configure the whitelist with commands or edit
config/whitelistgate/whitelist.json and run /whitelistgate reload.
Do not install WhitelistGate on player clients. It is intended to run only on the server.
Commands
All commands require permission level 3 and can be used by server operators or from the dedicated server console.
/whitelistgate enable
/whitelistgate disable
/whitelistgate add <nickname>
/whitelistgate remove <nickname>
/whitelistgate list
/whitelistgate reload
Enabling WhitelistGate does not kick players who are already connected. Disabling it immediately stops WhitelistGate from restricting new connections.
Offline-mode security warning
On an offline-mode server, players can choose any nickname, including a nickname belonging to another person. A nickname whitelist controls which names may connect, but it does not authenticate users or prove ownership of a Minecraft account.
WhitelistGate is licensed under the Apache License 2.0.
评论 0
登录后参与评分
还没有评论,来抢沙发吧