Advanced Whitelist
与普通的白名单类似,但拥有强大的额外功能,以提升你的 Minecraft 服务器体验。玩家在尝试连接时可以直接发送加入请求,使访问管理更加轻松和互动。
管理员可以即时审查并批准请求,在保持完全控制权的同时减少手动操作。该插件还包括 Discord 白名单管理、请求理由以及重要白名单操作的协议日志记录。
高级功能
请求系统
当玩家尝试加入服务器时,他们会向服务器上的管理员发送加入请求。
如果有管理员在线,请求会作为交互式消息直接发送到聊天中,管理员可以立即批准。
如果没有管理员在线,请求会被存储一段可配置的时间,之后可以通过 /whitelist requests 命令进行审查。
请求可以包含一个理由,该理由会在请求概览和交互式请求消息中显示。

Discord 集成
用户可以通过添加一个使用令牌的 Discord 机器人,直接从他们的 Discord 服务器管理白名单。
Discord 集成包括:
- 用于白名单管理的斜杠命令
/request 模态框,用户可以在其中提交带有理由的请求
- 可选的基于角色的 Discord 白名单命令访问权限
- 可选的使用请求模态框的角色要求
- 将协议日志记录到可配置的 Discord 频道,用于白名单更改

命令
| 命令 |
权限 |
描述 |
/whitelist <add/remove> <player> |
advancedwhitelist.player |
将玩家添加到或从白名单中移除 |
/whitelist list |
advancedwhitelist.list |
显示所有已列入白名单的玩家 |
/whitelist toggle/on/off |
advancedwhitelist.toggle |
启用或禁用白名单 |
/whitelist set |
advancedwhitelist.player |
清除当前列表并将所有在线玩家添加进去 |
/whitelist requests |
advancedwhitelist.requests |
显示所有待处理的加入请求,包括理由和过期时间 |
/whitelist reload |
advancedwhitelist.reload |
重新加载插件配置 |
Discord 斜杠命令
| 命令 |
描述 |
/whitelist toggle |
启用或禁用白名单 |
/whitelist add |
将玩家添加到白名单 |
/whitelist remove |
从白名单中移除玩家 |
/whitelist list |
显示所有已列入白名单的玩家 |
/whitelist requests |
显示待处理的白名单请求 |
/whitelist info |
显示特定请求的详细信息 |
/request |
打开请求模态框并提交理由 |
权限
advancedwhitelist.admin → 管理所有功能的权限
advancedwhitelist.request.notify → 在聊天中接收加入请求的权限
advancedwhitelist.toggle → 启用或禁用白名单的权限
advancedwhitelist.player → 添加或移除玩家的权限
advancedwhitelist.list → 列出白名单玩家的权限
advancedwhitelist.requests → 查看待处理请求的权限
advancedwhitelist.reload → 重新加载配置的权限
配置
| 值 |
描述 |
默认值 |
Language |
更改插件语言(支持:English, German) |
en |
RequestsExpiration |
加入请求过期的时间(分钟) |
10 |
Discord 机器人配置
| 值 |
描述 |
默认值 |
Discord-Bot.Enabled |
更改是否应使用 Discord 机器人 |
false |
Discord-Bot.Token |
Discord 机器人的令牌 (启用时必需) |
空 |
Discord-Bot.Permissions.UseAdmin |
对白名单命令要求 Discord 管理员权限 |
true |
Discord-Bot.Permissions.UseRoleId |
用作替代管理员权限的角色 ID |
0 |
Discord-Bot.Protocol.ChannelId |
用于协议和白名单日志消息的 Discord 频道 ID |
0 |
Discord-Bot.Model.Request.MinChars |
请求理由的最小长度 |
30 |
Discord-Bot.Model.Request.MaxChars |
请求理由的最大长度 |
200 |
Discord-Bot.Model.Request.RequiredRole |
要求特定角色才能使用 /request |
false |
Discord-Bot.Model.Request.RoleId |
使用 /request 所需的角色 ID |
0 |
如何创建和设置 Discord 机器人
创建 Discord 应用程序
- 前往 Discord Developer Portal
- 点击 New Application。
- 为你的机器人输入名称(例如
Advanced Whitelist)。
- 点击 Create。
创建机器人用户
- 在左侧菜单中打开 Bot。
- 点击 Add Bot 并确认。
- (可选)上传机器人图标并更改用户名。
- 启用以下 Privileged Gateway Intents(特权网关意图):
- Presence Intent
- Server Members Intent
- Message Content Intent
- 点击 Save Changes。
如果你的机器人读取消息或处理命令,则需要这些意图。
复制机器人令牌
- 在 Bot 部分,点击 Reset Token。
- 复制生成的令牌。
- 安全存储它,切勿公开分享。
令牌就是你的机器人的密码。
邀请机器人到 Discord 服务器
- 前往 OAuth2 → URL Generator。
- 选择范围
bot 和 applications.commands。
- 选择以下权限之一:
- Administrator(推荐)
- 或仅选择你的机器人所需的权限
- 复制生成的 URL。
- 在浏览器中打开它并授权机器人。
你需要拥有 Manage Server 权限。
将 Token 插入配置文件
示例:config.yml
Discord-Bot:
Enabled: true
Token: "YOUR_BOT_TOKEN_HERE"
Permissions:
UseAdmin: true
UseRoleId: 0
Protocol:
ChannelId: 0
Model:
Request:
MinChars: 30
MaxChars: 200
RequiredRole: false
RoleId: 0
保存文件并重启服务器。
启动机器人
当 Minecraft 服务器运行时,机器人将在你的 Discord 服务器上显示为在线状态。
如果你需要帮助或想建议新功能,欢迎加入我们的 Discord:
->
Advanced Whitelist
Like a normal whitelist, but with powerful extra features to improve your Minecraft server experience. Players can send join requests directly when trying to connect, making access management easier and more interactive.
Administrators can review and accept requests instantly, keeping full control while reducing manual effort. The plugin also includes Discord whitelist management, request reasons, and protocol logging for important whitelist actions.
Advanced Features
Request System
Players send a join request to an administrator on the server when they try to join.
If an administrator is online, the request is sent directly in chat as an interactive message, where it can be accepted immediately.
If no administrator is online, the request is stored for a configurable amount of time and can later be reviewed with /whitelist requests.
Requests can contain a reason, which is shown in the request overview and in the interactive request messages.

Discord Integration
Users can add a Discord bot using a token to manage the whitelist directly from their Discord server.
The Discord integration includes:
- Slash commands for whitelist management
- A
/request modal where users can submit a request with a reason
- Optional role-based access for Discord whitelist commands
- Optional role requirements for using the request modal
- Protocol logging to a configurable Discord channel for whitelist changes

Commands
| Command |
Permission |
Description |
/whitelist <add/remove> <player> |
advancedwhitelist.player |
Add or remove a player from the whitelist |
/whitelist list |
advancedwhitelist.list |
Show all whitelisted players |
/whitelist toggle/on/off |
advancedwhitelist.toggle |
Enable or disable the whitelist |
/whitelist set |
advancedwhitelist.player |
Clear the current list and add all online players |
/whitelist requests |
advancedwhitelist.requests |
Show all pending join requests including reason and expiration |
/whitelist reload |
advancedwhitelist.reload |
Reload the plugin configuration |
Discord Slash Commands
| Command |
Description |
/whitelist toggle |
Enable or disable the whitelist |
/whitelist add |
Add a player to the whitelist |
/whitelist remove |
Remove a player from the whitelist |
/whitelist list |
Show all whitelisted players |
/whitelist requests |
Show pending whitelist requests |
/whitelist info |
Show details for a specific request |
/request |
Open the request modal and submit a reason |
Permissions
advancedwhitelist.admin → Permission to manage all features
advancedwhitelist.request.notify → Permission to receive join requests in chat
advancedwhitelist.toggle → Permission to enable or disable the whitelist
advancedwhitelist.player → Permission to add or remove players
advancedwhitelist.list → Permission to list whitelisted players
advancedwhitelist.requests → Permission to view pending requests
advancedwhitelist.reload → Permission to reload the configuration
Configuration
| Value |
Description |
Default |
Language |
Change the plugin language (supported: English, German) |
en |
RequestsExpiration |
Time in minutes until a join request expires |
10 |
Discord Bot Configuration
| Value |
Description |
Default |
Discord-Bot.Enabled |
Change whether the Discord bot should be used |
false |
Discord-Bot.Token |
Token for the Discord bot (required if enabled) |
Empty |
Discord-Bot.Permissions.UseAdmin |
Require Discord administrator permission for whitelist commands |
true |
Discord-Bot.Permissions.UseRoleId |
Role ID used instead of administrator permission |
0 |
Discord-Bot.Protocol.ChannelId |
Discord channel ID for protocol and whitelist log messages |
0 |
Discord-Bot.Model.Request.MinChars |
Minimum length for a request reason |
30 |
Discord-Bot.Model.Request.MaxChars |
Maximum length for a request reason |
200 |
Discord-Bot.Model.Request.RequiredRole |
Require a specific role to use /request |
false |
Discord-Bot.Model.Request.RoleId |
Role ID required to use /request |
0 |
How to Create and Set Up a Discord Bot
Create a Discord Application
- Go to the Discord Developer Portal
- Click New Application.
- Enter a name for your bot (e.g.
Advanced Whitelist).
- Click Create.
Create the Bot User
- Open Bot in the left menu.
- Click Add Bot and confirm.
- (Optional) Upload a bot icon and change the username.
- Enable the following Privileged Gateway Intents:
- Presence Intent
- Server Members Intent
- Message Content Intent
- Click Save Changes.
These intents are required if your bot reads messages or processes commands.
Copy the Bot Token
- In the Bot section, click Reset Token.
- Copy the generated token.
- Store it securely and never share it publicly.
The token is the password for your bot.
Invite the Bot to a Discord Server
- Go to OAuth2 → URL Generator.
- Select the scopes
bot and applications.commands.
- Choose one of the following permissions:
- Administrator (recommended)
- or only the permissions your bot needs
- Copy the generated URL.
- Open it in your browser and authorize the bot.
You need the Manage Server permission.
Insert the Token into the Config File
Example: config.yml
Discord-Bot:
Enabled: true
Token: "YOUR_BOT_TOKEN_HERE"
Permissions:
UseAdmin: true
UseRoleId: 0
Protocol:
ChannelId: 0
Model:
Request:
MinChars: 30
MaxChars: 200
RequiredRole: false
RoleId: 0
Save the file and restart the server.
Start the Bot
Once the Minecraft server is running, the bot will appear online on your Discord server.
If you need help or want to suggest new features, feel free to join our Discord:
->
评论 0
登录后参与评分
还没有评论,来抢沙发吧