DiscordUtils - 服务器 Discord 机器人

💡DiscordUtils 插件介绍

DiscordUtils 允许你在 Minecraft 服务器上运行自己的 Discord 机器人，实现游戏与 Discord 社区的无缝连接。它提供了账户链接、安全验证、跨平台聊天、权限同步等丰富功能，是管理现代化社群的强大工具。

🎮核心功能

账户与安全

• 将 Discord 账户与游戏内账户进行链接。
• 启用基于 Discord 的二次验证（2FA），并可配置会话与强制特定群组使用。
• 支持游戏内与 Discord 昵称同步。

社区互动

• 创建游戏内玩家与 Discord 用户的实时聊天桥梁。
• 在游戏内生成语音频道邀请。
• 奖励身处 Discord 语音频道的玩家。
• 当玩家在 Discord 被提及时，在游戏内发送通知。

管理与监控

• 将服务器事件（加入、退出、死亡、聊天）实时记录到指定的 Discord 频道。
• 在 Discord 服务器上创建虚拟控制台，供管理员执行命令和查看完整日志。
• 同步封禁名单（Discord ↔ Minecraft）。
• 支持使用 PlaceholderAPI 自定义占位符来动态更新 Discord 频道名称。

集成与扩展

• 与权限插件（如 LuckPerms）集成，实现 Discord 身份组与游戏内权限组的自动关联。
• 提供完整的 DiscordUtils API，允许开发者创建自己的功能扩展。
• 支持 PlaceholderAPI，提供多个专用占位符。
• 支持使用十六进制颜色代码进行消息自定义。

自定义与控制

• 完全可定制的消息内容。
• 可启用或禁用的自动更新检查器。
• 可从机器人设置文件直接选择和下载官方翻译。
• 为游戏内事件创建自定义触发器。
• 机器人支持显示动态活动状态。
• 支持 Discord 斜杠命令。

🔧命令列表

Discord 机器人命令

• /help — 查看帮助信息。
• /link — 将你的 Discord 账户链接到游戏账户。
• /online — 查看服务器当前在线玩家数量。
• /stats [player] — 查看你或其他玩家的统计数据（基于 PAPI 占位符）。若不指定玩家，则显示你自己的数据。
• /unlink — 解除你的游戏账户与服务器账户的链接。
• /sudo — 以控制台发送者身份执行服务器命令（仅管理员）。
• /embed — 发送嵌入消息（仅管理员）。

游戏内命令

• /du help — 查看帮助信息。权限：discordutils.discordutils.help（别名：/du h）。
• /du link — 链接你的 Discord 账户。权限：discordutils.discordutils.link。
• /du unlink — 解除你的 Discord 账户链接。权限：discordutils.discordutils.unlink（别名：/du ulink）。
• /du secondfactor — 启用/禁用 2FA。权限：discordutils.discordutils.secondfactor（别名：/du 2fa）。
• /du sendtodiscord — 发送嵌入消息到 Discord 服务器。权限：discordutils.discordutils.sendtodiscord（别名：/du sendtodis, /du std, /du stodis, /du stdis）。
• /du voiceinvite [players] — 邀请所有在线玩家（或指定玩家）加入语音频道对话。权限：discordutils.discordutils.voiceinvite（别名：/du vinvite, /du vcinvite, /du vinv, /du vcinv）。
• /du getdiscord — 获取已验证玩家的 Discord 信息。权限：discordutils.discordutils.getdiscord（别名：/du gdis, /du gdiscord, /du gd）。
• /dua reload — 重载配置文件。权限：discordutils.discordutilsadmin.reload（别名：/dua rl, /dua rel）。
• /dua forceunlink — 强制解除某玩家的 Discord 账户链接。权限：discordutils.discordutilsadmin.forceunlink（别名：/dua funlink, /dua fulink, /dua forceulink）。
• /dua stats — 查看管理员统计数据。权限：discordutils.discordutilsadmin.stats（别名：/dua stat）。
• /dua migrate — 从旧版配置/数据库迁移到当前数据管理器（此操作将覆盖现有用户数据）。权限：discordutils.discordutilsadmin.migrate（别名：/dua mig, /dua migr）。

✨PlaceholderAPI 占位符

• %discordutils_islinked% — 检查玩家是否已链接。
• %discordutils_2fa% — 检查玩家是否启用了 2FA。
• %discordutils_discord% — 获取已链接玩家的 Discord 信息。
• %discordutils_isboosting<guild_id>% — 检查玩家是否正在助力指定的 Discord 服务器（请将 <guild_id> 替换为实际的服务器 ID）。

⭐支持的集成插件

• LuckPerms
• Vault（支持与多个插件集成）

❓Discord 机器人设置教程

有关如何设置 Discord 机器人的详细步骤，请参阅插件文档或官方页面。

🔧开发者 API

Maven 依赖

<dependency>
    <groupId>io.github.mirrerror</groupId>
    <artifactId>discordutils</artifactId>
    <version>5.0.1</version>
    <scope>provided</scope>
</dependency>

Gradle 依赖

implementation 'io.github.mirrerror:discordutils:5.0.1'

API 使用示例：https://github.com/mirrerror/DiscordUtilsAPIUsageExample/tree/main

💡支持与贡献

获取帮助

如果你在使用插件时遇到任何问题，可以加入官方 Discord 服务器并创建工单以获取免费技术支持。我们将尽快为你提供帮助。

• Discord 服务器：https://discord.gg/47txjnVtz7

支持开发者

你的支持将极大地激励我们持续更新和改进插件。

• 捐赠链接：paypal.me/mirrerror