
Maykesh的Fabric快速白名单
一个零停机白名单系统,支持即时更新、可配置的命令权限,并完整追踪每位玩家由谁添加,以实现清晰的工作人员问责。
📜 Rapid Whitelist
一个面向现代 Fabric 服务器的高性能、支持热重载的白名单系统。
Rapid Whitelist 完全取代了原版 Minecraft 白名单,提供异步 I/O、热重载和高级速率限制功能。它专为需要健壮访问控制系统、同时又不希望主线程性能受损的服务器而设计。
🚀 为什么使用这个模组?
- ⚡ 零卡顿:所有白名单操作(添加/移除/检查)均使用异步 I/O,让你的服务器 TPS 保持在较高水平。
- 🔥 支持热重载:可手动或通过命令编辑
whitelist.json,更改会立即生效,无需重启。 - 🛡️ 速率限制:内置针对添加/移除玩家和重载操作的命令刷屏防护。
- 🔌 开发者 API:包含
CustomWhitelistAPI,便于与其他模组或插件集成。 - 🚫 完全替代:完全绕过原版白名单逻辑,实现全面控制。
✨ 功能
🔒 核心白名单
- 异步存储:玩家数据存储在
config/customwhitelist/whitelist.json中,并以异步方式加载。 - 支持 UUID 与名称:基于 GameProfile(UUID + 名称)进行白名单管理,以保障安全。
- 即时更新:命令会立即更新缓存;手动文件编辑会通过文件监视器检测到。
⚙️ 管理与控制
- 完整命令套件:
/rapidwhitelist add、remove、list、enable、disable、reload。 - 可配置消息:在
config.json中自定义踢出消息和反馈文本。 - 权限等级:将命令限制到特定 OP 等级(默认:等级 3)。
🛡️ 保护
- 速率限制:可配置每分钟可添加/移除的玩家数量上限。
- 日志记录:记录被拒绝的连接和管理操作的详细日志。
📜 命令
管理员命令
(默认需要 OP 等级 3)
/rapidwhitelist add <player>- 将玩家添加到白名单。/rapidwhitelist remove <player>- 从白名单中移除玩家。/rapidwhitelist list- 列出所有白名单中的玩家。/rapidwhitelist reload- 从磁盘重新加载配置和白名单数据。/rapidwhitelist enable- 启用白名单强制检查。/rapidwhitelist disable- 禁用白名单(允许所有人)。
⚙️ 配置
主配置文件 config/customwhitelist/config.json 控制行为:
{
"enableWhitelist": true,
"commandPermissionLevel": 3,
"storageMode": "json",
"messages": {
"kickMessage": "You are not whitelisted on this server.",
"whitelistEnabled": "Whitelist has been enabled.",
"whitelistDisabled": "Whitelist has been disabled."
},
"rateLimits": {
"addPerMinute": 10.0,
"removePerMinute": 10.0,
"reloadCooldownMs": 5000
}
}
如需更多 Minecraft 版本支持,请在我的 Discord 服务器联系我(链接如下):
https://discord.gg/BmUZ6jHcJz -- 这是我们搭载了我所有模组的 SMP……来测试一下我们的服务器吧?谢谢!
[免责声明:本项目部分内容是在 PhaseZero Labs 工作流中借助 AI 辅助工具开发的。]
正在加载版本记录…
正在加载评论…
评论在新手盒子客户端中发表,这里同步展示。