
DiscordUtils 是一款轻量级的 Discord 实用 Minecraft 插件,旨在帮助每位服务器管理员连接玩家与其 Discord 服务器。您可以对玩家实施处罚、在特定频道使用日志进行追踪、让玩家申诉处罚等等!
?️ 观看展示视频
⚙️ 功能
- 完全可配置的 GUI,包含信息物品等更多内容!
- GUI 中 discord-item 的自定义方块
- 完全可配置的音效
- 多种向玩家显示 Discord 链接的方式
- 完全可配置且可切换的 Discord 机器人
- 简洁的处罚系统
- 简洁的申诉系统(通过您的 Discord 服务器)
- 简洁的日志系统(同样通过您的 Discord 服务器)
- 简单的配置
还有更多!请查看 config.yml 了解所有功能!
? DiscordUtils 在 PAPER 服务器上效果最佳,因为它使用了一些仅在该平台上有效的功能。
如需更多信息,请在此处查看展示视频。
? Discord 机器人
正如我之前所说,DiscordUtils 可以使用_Discord 机器人_来从您的 Discord 服务器追踪玩家及其处罚记录。尽管此功能是可切换的,但插件会因此失去一些主要功能(例如_处罚_相关功能)
配置机器人相当_简单易懂_。以下是主要步骤:
1️⃣ 前往 Discord 开发者门户并创建一个应用程序。
2️⃣ 进入机器人部分,填写_用户名、描述、图标、横幅_并复制BOT TOKEN。此外,启用以下 3 个意图(Presence、Server Members 和 Message Content)。
3️⃣ 在 botconfig.yml 文件中,用该机器人的 token 填写 bot-token 部分。
4️⃣ 之后,打开 Discord,右键点击您的服务器,复制_Guild ID_ 并将其粘贴到 guild-id 部分(在 botconfig.yml 文件中)。
‼️最后但同样重要的是,前往 config.yml 文件,您应该会看到 open-discord-bot 部分。如果您使用的是服务器网络,则需要在所有服务器上安装该插件以及一个 MySQL 数据库(通常主机商会提供 2 或 3 个)。为了避免覆盖机器人设置,请在仅一台服务器上将该值设置为 TRUE,并将其余服务器保持为 FALSE(默认值)。
现在我们来谈谈如何将机器人添加到您的 Discord 服务器:
1️⃣ 返回 Discord 开发者门户,点击您的应用并进入 OAuth2 部分。
2️⃣ 在URL 生成器中,选择 bot 和 application.commands。
3️⃣ 向下滚动,选择 Administrator(机器人需要访问玩家的角色/权限等*)。
4️⃣ 在底部,复制生成的链接,将其粘贴到浏览器中并按照说明邀请它加入您的服务器。
我还在两个 .yml 文件中提供了各种说明,请务必仔细阅读。
? 命令
| 命令 |
描述 |
权限 |
/dcutils mainconfig |
打开主配置文件。 |
discordutils.commands.mainconfig |
/dcutils punishments |
打开处罚菜单 |
discordutils.commands.punishments |
/dcutils reload |
重新加载配置文件。 |
discordutils.commands.reload |
/dcutils help |
打开帮助手册 |
discordutils.commands.help |
/discord |
打开 Discord GUI |
discordutils.discord |
/verify |
开始验证流程 |
discordutils.verify |
/unverify |
取消玩家验证 |
discordutils.unverify |
/history |
打开玩家的处罚历史记录 |
discordutils.viewhistory |
? 权限
| 权限 |
描述 |
discordutils.commands |
允许玩家使用配置命令 |
discordutils.commands.reload |
允许玩家重新加载配置文件 |
discordutils.commands.help |
允许玩家打开 帮助手册 |
discordutils.commands.mainconfig |
允许玩家打开主配置菜单 |
discordutils.commands.punishments |
允许玩家打开 处罚菜单 |
discordutils.punishments.add |
允许玩家添加处罚 |
discordutils.punishments.add.permban |
允许玩家添加永久封禁 |
discordutils.punishments.add.tempban |
允许玩家添加临时封禁 |
discordutils.punishments.add.kick |
允许玩家执行踢出操作 |
discordutils.punishments.add.permbanwarn |
允许玩家添加永久封禁警告 |
discordutils.punishments.add.tempbanwarn |
允许玩家添加临时封禁警告 |
discordutils.punishments.add.permmute |
允许玩家执行永久静音/超时 |
discordutils.punishments.add.tempmute |
允许玩家执行临时静音/超时 |
discordutils.punishments.add.permmutewarn |
允许玩家添加永久静音/超时警告 |
discordutils.punishments.add.tempmutewarn |
允许玩家添加临时静音/超时警告 |
discordutils.punishments.remove |
允许玩家移除处罚 |
discordutils.punishments.remove.permban |
允许玩家移除永久封禁 |
discordutils.punishments.remove.tempban |
允许玩家移除临时封禁 |
discordutils.punishments.remove.kick |
允许玩家移除踢出记录 |
discordutils.punishments.remove.permbanwarn |
允许玩家移除永久封禁警告 |
discordutils.punishments.remove.tempbanwarn |
允许玩家移除临时封禁警告 |
discordutils.punishments.remove.permmute |
允许玩家移除永久静音/超时 |
discordutils.punishments.remove.tempmute |
允许玩家移除临时静音/超时 |
discordutils.punishments.remove.permmutewarn |
允许玩家移除永久静音/超时警告 |
discordutils.punishments.remove.tempmutewarn |
允许玩家移除临时静音/超时警告 |
discordutils.punishments.playerhistory |
允许玩家查看其他玩家的处罚历史 |
? 配置文件
DiscordUtils 使用两个配置文件:
config.yml,你可以在其中 配置 整个插件的功能。包括音效、GUI、任务以及更多内容。
botconfig.yml,你可以在其中 配置 Discord 机器人。包括 Discord 角色、频道、消息以及更多内容。
❤️ 致谢与许可
许可:MIT 许可
DiscordUtils 由 _ItsAndrew_ 开发与测试
特别感谢所有提供帮助、进行测试并最重要的是提供反馈的人!
如果你遇到 Bug,请在此处提交 Issue 这里!这将对我有很大帮助。

DiscordUtils is a lightweight, discord utility minecraft plugin, designed to help every server owner connect the players with his discord server. Control the punishments of the players, track them using logs in specific channels, let players appeal their punishments and much more!
?️ Watch the Showcase Video
⚙️ Features
- Fully configurable GUI, with info items and more!
- Custom block for the discord-item in the GUI
- Fully configurable sounds
- Multiple ways of displaying the discord link to the player
- Fully configurable and toggleable discord bot
- Clean punishments system
- Clean appealing system (via your discord server)
- Clean logs system (also via your discord server)
- Simple configuration
And more! Check config.yml for every feature!
? DiscordUtils works best with a PAPER server, because it uses some stuff which work ONLY on it.
For more information, check the showcase video here.
? Discord Bot
As I said earlier, DiscordUtils can use a discord bot in order to track the players and their punishments from your Discord Server. Despite this, the feature is toggleable, although the plugin will lose some of the main functions (e.g. Punishments)
Configuring the bot is fairly easy and simple. Here are the main steps:
1️⃣ Go to the Discord Developer Portal and create an application.
2️⃣ Go to the bot section, fill in the username, description, icon, banner and copy the BOT TOKEN. Also, enable all those 3 intents (Presence, Server Members and Message Content).
3️⃣ In the botconfig.yml file, fill in the bot-token section with that bot token.
4️⃣ After this, open Discord, right click on your server, copy the Guild ID and paste it in the guild-id section (in botconfig.yml file).
‼️Last but not least, head over to the config.yml file and you should see the open-discord-bot section. If you have a Network of Server, you need the plugin on all of them + a MySQL Database (usually hosts give you like 2 or 3 of them). So, in order to not override the bot, set that value to TRUE on ONLY ONE server, and leave the rest to FALSE (by default).
Now let's talk about how you get the bot on your Discord Server:
1️⃣ Head back to the Discord Developer Portal, click on your app and head over to the OAuth2 section.
2️⃣ At the URL Generator, select bot and application.commands.
3️⃣ Further down, select Administrator (the bot needs to access the player's roles/permissions and more).
4️⃣ At the bottom, copy the generated link, paste it in your browser and follow the instructions to invite it to your server.
I also told various instructions in both .yml files, so make sure to read them thoroughly.
? Commands
| Command |
Description |
Permission |
/dcutils mainconfig |
Opens up the main configuration. |
discordutils.commands.mainconfig |
/dcutils punishments |
Opens up the Punishments Menu |
discordutils.commands.punishments |
/dcutils reload |
Reloads the configuration files. |
discordutils.commands.reload |
/dcutils help |
Opens the help manual |
discordutils.commands.help |
/discord |
Opens the discord GUI |
discordutils.discord |
/verify |
Starts the verification process |
discordutils.verify |
/unverify |
Unverifies the player |
discordutils.unverify |
/history |
Opens the player's punishment history |
discordutils.viewhistory |
? Permissions
| Permission |
Description |
discordutils.commands |
Allows the player to use the configuration commands |
discordutils.commands.reload |
Allows the player to reload the config. files |
discordutils.commands.help |
Allows the player to open the Help Manual |
discordutils.commands.mainconfig |
Allows the player to open the main config. menu |
discordutils.commands.punishments |
Allows the player to open the Punishments Menu |
discordutils.punishments.add |
Allows the player to add punishments |
discordutils.punishments.add.permban |
Allows the player to add a permanent ban |
discordutils.punishments.add.tempban |
Allows the player to add a temporary ban |
discordutils.punishments.add.kick |
Allows the player to apply a kick |
discordutils.punishments.add.permbanwarn |
Allows the player to apply a permanent ban warn |
discordutils.punishments.add.tempbanwarn |
Allows the player to apply a temporary ban warn |
discordutils.punishments.add.permmute |
Allows the player to apply a permanent mute/timeout |
discordutils.punishments.add.tempmute |
Allows the player to apply a temporary mute/timeout |
discordutils.punishments.add.permmutewarn |
Allows the player to apply a permanent mute/timeout warning |
discordutils.punishments.add.tempmutewarn |
Allows the player to apply a temporary mute/timeout warning |
discordutils.punishments.remove |
Allows the player to remove punishments |
discordutils.punishments.remove.permban |
Allows the player to remove a permanent ban |
discordutils.punishments.remove.tempban |
Allows the player to remove a temporary ban |
discordutils.punishments.remove.kick |
Allows the player to remove a kick |
discordutils.punishments.remove.permbanwarn |
Allows the player to remove a permanent ban warning |
discordutils.punishments.remove.tempbanwarn |
Allows the player to remove a temporary ban warning |
discordutils.punishments.remove.permmute |
Allows the player to remove a permanent mute/timeout |
discordutils.punishments.remove.tempmute |
Allows the player to remove a temporary mute/timeout |
discordutils.punishments.remove.permmutewarn |
Allows the player to remove a permanent mute/timeout warning |
discordutils.punishments.remove.tempmutewarn |
Allows the player to remove a temporary mute/timout warning |
discordutils.punishments.playerhistory |
Allows the player to view other players` punishment history |
? Configuration Files
DiscordUtils uses 2 configuration files:
config.yml, in which you can configure the whole plugin. Sounds, GUI, tasks and much more.
botconfig.yml, where you can configure the discord bot. Discord roles, channels, messages and much more.
❤️ Credits and License
License: MIT license
DiscordUtils was developed and tested by _ItsAndrew_
Special thanks to everyone who help, test and, most importantly, give feedback!
If you encounter bugs, please open an issue here! It would help me a lot.
评论 0
登录后参与评分
还没有评论,来抢沙发吧