一个简洁的 Velocity 代理插件,要求玩家在加入网络之前链接 Discord 账号。
VelocityDiscord 会在允许玩家进入你的 Minecraft 网络之前验证其 Discord 成员资格以及可选的 Discord 角色。
功能
- Velocity 的 Discord 账号链接
- 在后端连接前阻止未链接的玩家
- 使用 MiniMessage 格式的消息
- 持久的账号链接
配置
bot.token=YOUR_DISCORD_BOT_TOKEN
discord.guild.id=YOUR_DISCORD_GUILD_ID
allowed.discord.role.ids=[123456789012345678,234567890123456789]
special.discord.role.id=345678901234567890
special.enabled=false
debug=false
enforce.linking=true
code.length=6
code.expiry.minutes=10
允许的角色
allowed.discord.role.ids 支持多个 Discord 角色 ID。
示例:
allowed.discord.role.ids=[123456789012345678,234567890123456789]
行为:
- 如果列表为空(
[]),任何 Discord 成员都可以链接。
- 如果配置了角色,用户必须至少拥有一个被允许的角色。
- 推荐使用 Discord 角色 ID 而不是角色名称。
特殊角色模式
VelocityDiscord 支持可选的“特殊角色”系统。
启用后,插件会在成功链接账号后自动授予一个配置的 Discord 角色(无论他们是否拥有上面定义的必需角色)。
配置:
special.discord.role.id=345678901234567890
special.enabled=false
控制台命令:
/vdspecial status
/vdspecial enable
/vdspecial disable
别名:
velocitydiscordspecial
消息
生成的配置文件包含可自定义的消息设置,例如:
messages.kick
messages.success
messages.invalid-code
messages.no-required-role
messages.discord-server-only
messages.wrong-discord-server
messages.bot-offline
messages.usage
消息使用 MiniMessage 格式,支持颜色和排版。
踢出消息支持:
注意事项
- 如果
allowed.discord.role.ids 为空,则跳过角色检查。
- 在配置真实的 Discord 机器人令牌之前,链接强制保持禁用状态,以防止因使用占位符令牌而导致意外锁定。
A simple Velocity proxy plugin that requires players to link a Discord account before they can join the rest of the network.
VelocityDiscord verifies Discord membership and optional Discord roles before allowing players onto your Minecraft network.
Features
- Discord account linking for Velocity
- Blocks unlinked players before backend connection
- MiniMessage formatted messages
- Persistent account linking
Configuration
bot.token=YOUR_DISCORD_BOT_TOKEN
discord.guild.id=YOUR_DISCORD_GUILD_ID
allowed.discord.role.ids=[123456789012345678,234567890123456789]
special.discord.role.id=345678901234567890
special.enabled=false
debug=false
enforce.linking=true
code.length=6
code.expiry.minutes=10
Allowed roles
allowed.discord.role.ids supports multiple Discord role IDs.
Example:
allowed.discord.role.ids=[123456789012345678,234567890123456789]
Behavior:
- If the list is empty (
[]), any Discord member may link.
- If roles are configured, the user must have at least one allowed role.
- Using Discord role IDs is recommended over role names.
Special role mode
VelocityDiscord supports an optional "special role" system.
When enabled, the plugin automatically grants a configured Discord role after successful account linking (regardless if they do not have a required role defined above).
Configuration:
special.discord.role.id=345678901234567890
special.enabled=false
Console commands:
/vdspecial status
/vdspecial enable
/vdspecial disable
Alias:
velocitydiscordspecial
Messages
The generated config includes customizable message settings such as:
messages.kick
messages.success
messages.invalid-code
messages.no-required-role
messages.discord-server-only
messages.wrong-discord-server
messages.bot-offline
messages.usage
Messages use MiniMessage formatting, allowing colors and, formatting.
The kick message supports:
Notes
- If
allowed.discord.role.ids is empty, role checks are skipped.
- Link enforcement stays disabled until a real Discord bot token is configured, preventing accidental lockouts with placeholder tokens.
评论 0
登录后参与评分
还没有评论,来抢沙发吧