MySimpleDiscordWhitelist
MySimpleDiscardWhitelist 允许你直接从 Discord 管理 Minecraft 服务器的白名单。管理员可以使用单个斜杠命令将玩家加入白名单,并同时关联其 Discord 账号——关联的成员会自动获得一个可配置的 Discord 角色,一旦他们被移出白名单(如果仍在线则会被立即踢出),该角色也会被移除。
仅通过 Minecraft 名称加入白名单的玩家,之后可以自行关联账号:在 Discord 中使用 /link 请求一次性验证码,然后在游戏内使用 /linkcode <code> 兑换。
除了白名单管理外,该插件还会在你指定的频道中保持一个自动更新的服务器状态嵌入卡片(显示在线/离线状态、玩家数量、玩家列表、MOTD),发布加入/离开通知,并在机器人的 Discord 状态中显示实时玩家数量。
功能特性
/whitelist add <minecraft-name> [discord-user] — 将玩家加入白名单,可选地在一步操作中完成 Discord 账号的关联和角色授予
/whitelist remove <player> — 通过 Minecraft 名称或 Discord ID 移除玩家;系统会自动清理相关的角色、链接信息,并断开(如果在线)玩家会话
/whitelist list — 查看包含已关联 Discord 用户的白名单列表
/link + 游戏内 /linkcode <code> — 自助式账号关联
/unlink <player> — 管理员强制解除账号关联
/status — 按需获取服务器状态
- 自动更新的状态嵌入卡片、加入/离开通知、显示玩家数量的机器人状态
- 内置 11 种语言支持(
de, en, es, es_MX, fr, ru, pt_BR, it, nl, pl, tr),每种语言均可针对服务器单独配置
要求
- Purpur 或 Paper 1.21.x,Java 21
- 一个 Discord 机器人应用(免费,通过 Discord Developer Portal 创建),需在服务器中启用 Server Members Intent(服务器成员意图)并拥有
Manage Roles(管理角色)权限
此插件管理服务器的原版标准白名单(whitelist.json)——因此 server.properties 中的 white-list=true 必须保持开启。
设置步骤
- 创建 Discord 机器人并将其邀请到你的服务器(作用域需包含
bot + applications.commands)。
- 将插件 jar 文件放入你的
plugins 文件夹,然后启动一次服务器以生成 config.yml 配置文件。
- 填写你的机器人令牌、服务器 ID(Guild ID)、白名单角色 ID 以及你想要使用的频道 ID。
- 重启服务器——机器人将自动连接并注册其斜杠命令。
完整的设置说明,包括所有配置选项,请参阅项目的 README 文档。
MySimpleDiscordWhitelist
MySimpleDiscordWhitelist lets you manage your Minecraft server's whitelist directly from Discord. Admins whitelist players with a single slash command and can link a Discord account at the same time — linked members automatically receive a configurable Discord role, which is removed again the moment they're taken off the whitelist (and they're kicked immediately if still online).
Players who were whitelisted by Minecraft name only can self-link their account afterwards: requesting a one-time code with /link in Discord and redeeming it in-game with /linkcode <code>.
On top of whitelist management, the plugin keeps an auto-updating server status embed in a channel of your choice (online/offline, player count, player list, MOTD), posts join/leave notifications, and shows the live player count in the bot's Discord presence.
Features
/whitelist add <minecraft-name> [discord-user] — whitelist a player, optionally linking + role-granting a Discord account in one step
/whitelist remove <player> — remove by Minecraft name or Discord ID; role, link, and (if online) the player session are cleaned up automatically
/whitelist list — view the whitelist with linked Discord users
/link + in-game /linkcode <code> — self-service account linking
/unlink <player> — admin override to remove a link
/status — on-demand server status
- Auto-updating status embed, join/leave notifications, player-count bot presence
- 11 bundled languages (
de, en, es, es_MX, fr, ru, pt_BR, it, nl, pl, tr), fully configurable per server
Requirements
- Purpur or Paper 1.21.x, Java 21
- A Discord bot application (free, created via the Discord Developer Portal) with the Server Members Intent enabled and
Manage Roles permission in your server
This plugin manages the server's regular vanilla whitelist (whitelist.json) — white-list=true must stay enabled in server.properties.
Setup
- Create a Discord bot and invite it to your server (scopes
bot + applications.commands).
- Drop the plugin jar into your
plugins folder and start the server once to generate config.yml.
- Fill in your bot token, guild ID, whitelist role ID, and the channels you want to use.
- Restart the server — the bot connects automatically and registers its slash commands.
Full setup instructions, including all configuration options, are in the project's README.
评论 0
登录后参与评分
还没有评论,来抢沙发吧