Maykesh的Fabric快速白名单

Maykesh的Fabric快速白名单

一个零停机白名单系统,支持即时更新、可配置的命令权限,并完整追踪每位玩家由谁添加,以实现清晰的工作人员问责。

游戏机制

📜 Rapid Whitelist

Fabric Java License

一个面向现代 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 辅助工具开发的。]