Even Better Whitelist

插件

· 作者 zeusdagoat

一套专业的白名单工作流程,包含 Discord 操作、双 VPN/代理检测、GeoIP、可选验证码、Discord 账号绑定以及统计功能。专为生产环境服务器设计。

0 本站下载 0 关注 更新于 8 个月前

最新 2.0.0 · 1.21.11 · Paper / Purpur

一键开服(送7天)

EvenBetterWhitelist - 插件

适用于 Minecraft Paper 1.21.x 的现代白名单系统,支持 Discord 集成。当玩家尝试加入服务器且未被列入白名单时,系统会将结构化的请求发布到您的 Discord 频道。管理员可以直接在 Discord 中使用按钮接受、拒绝或封禁请求。

安装步骤

  1. 将 WhitelistPluginButBetter-1.0.0.jar 放入服务器的 plugins/ 文件夹中
  2. 启动/重启您的服务器
  3. 编辑 plugins/WhitelistPluginButBetter/config.yml
  4. 下载 GeoLite2-City.mmdb 并将其放置在插件文件夹中
  5. 使用 /wlp reload 重新加载配置或重启服务器

? Discord Bot 设置

1. 创建 Discord 应用程序

  1. 前往 Discord Developer Portal
  2. 点击“New Application”并为其命名
  3. 进入“Bot”部分并点击“Add Bot”
  4. 复制 Bot Token(请保密!)
  5. 启用以下 Privileged Gateway Intents:
    • Message Content Intent

2. 邀请 Bot

  1. 进入“OAuth2” → “URL Generator”
  2. 选择作用域:bot, applications.commands
  3. 选择权限:Send Messages, Embed Links, Read Message History
  4. 复制生成的 URL 并打开它以邀请 bot

3. 获取您的 ID

在 Discord 中启用开发者模式(设置 → 高级 → 开发者模式)

  • Server ID:右键点击您的服务器 → 复制服务器 ID
  • Channel ID:右键点击该频道 → 复制频道 ID
  • Admin User ID:右键点击自己 → 复制用户 ID

4. (可选)创建 Webhook

  1. 右键点击您的频道 → 编辑频道
  2. 进入 Integrations → Webhooks
  3. 创建一个 webhook 并复制其 URL

⚙️ 配置

discord:
  bot-token: "YOUR_BOT_TOKEN_HERE"
  webhook-url: "YOUR_WEBHOOK_URL_HERE"
  server-id: "YOUR_SERVER_ID_HERE"
  channel-id: "YOUR_CHANNEL_ID_HERE"
  admin-user-ids: "USER_ID_1,USER_ID_2"
  ping-admins: true

cooldowns:
  deny-cooldown: 60        # 被拒绝的玩家再次尝试之前的分钟数
  pending-cooldown: 5      # 等待期间两次加入尝试之间的分钟数
  ip-cooldown: 10          # 同一 IP 发起新请求之前的分钟数

geoip:
  enabled: true
  database-path: "plugins/WhitelistPluginButBetter/GeoLite2-City.mmdb"

查看所有选项请参阅完整的 config.yml!

? 命令

命令 描述
/wlp accept <player> 接受待处理的白名单请求
/wlp deny <player> 拒绝待处理的白名单请求
/wlp pending 查看所有待处理请求
/wlp list [page] 查看已列入白名单的玩家
/wlp add <player> 手动将玩家添加到白名单
/wlp remove <player> 从白名单中移除玩家
/wlp info <player> 查看玩家详细信息
/wlp status 查看插件状态
/wlp reload 重新加载配置

? 权限

权限 描述 默认值
whitelistplugin.admin 访问所有命令 OP
whitelistplugin.bypass 绕过白名单检查 OP

Discord Embed 预览

当玩家尝试加入时,管理员会收到如下嵌入消息:

┌─────────────────────────────────────────┐
│ New Whitelist Request                   │
├─────────────────────────────────────────┤
│ Player: Steve                           │
│ UUID: 069a79f4-...                      │
│ IP: ||192.168.1.1||                     │
│ Location: New York, United States       │
│ Client: fabric                          │
│ Language: en_US                         │
│ Requested: 2024-01-15 14:30 UTC         │
│                                         │
│ Same IP as: Alex (1 other request)      │
│                                         │
│ [Accept]  [Deny]  [Ban]                 │
└─────────────────────────────────────────┘

?️ 文件结构

plugins/WhitelistPluginButBetter/
├── config.yml              # 主配置文件
├── whitelist.json          # 白名单玩家
├── pending-requests.json   # 待处理请求
├── denied-players.json     # 被拒绝的玩家(用于冷却时间)
├── requests.log            # 操作日志
└── GeoLite2-City.mmdb      # GeoIP 数据库(需自行提供)

故障排除

Bot 对按钮无响应?

  • 确保 Bot Token 正确
  • 确保 Bot 在该频道拥有权限
  • 检查控制台是否有连接错误

GeoIP 不工作?

  • 从 MaxMind 下载 GeoLite2-City.mmdb
  • 将其放置在插件文件夹中
  • 检查 config.yml 中的路径

玩家未被踢出?

  • 确保插件已加载(执行 /plugins)
  • 检查玩家是否拥有 whitelistplugin.bypass 权限
  • 查看控制台是否有错误

看到私有 IP(10.x.x.x, 192.168.x.x)?

当使用 反向代理(BungeeCord, Velocity, TCPShield 等)时会发生这种情况。

对于 BungeeCord:

  1. 在 spigot.yml 中设置 bungeecord: true
  2. 重启服务器

对于 Velocity:

  1. 编辑 config/paper-global.yml
  2. 设置 proxies.velocity.enabled: true
  3. 将 secret 设置为与 Velocity 的转发密钥匹配
  4. 重启服务器

对于 TCPShield/其他: 请遵循您所用代理的文档进行 IP 转发。

客户端/语言显示为“N/A(登录前)”?

这是预期行为!插件会在玩家完全连接之前进行拦截,因此此时客户端品牌和区域设置数据尚不可用。这是 Minecraft 的局限性,并非错误。

我们确实捕获的数据(IP、UUID、GeoIP 地理位置)对于识别玩家及其小号仍然非常有用!

? 许可证

保留所有权利。未经告知的任何修改均属非法。

专为 Minecraft 社区打造!

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源