DiscordSRV

目前最强大、可配置性最高且开源的 Discord 桥接插件。

支持从 1.7.9 到 26.2 的所有 Minecraft 版本

我们仅对最新发布的版本/开发构建提供支持；在寻求帮助前请先更新

功能特性

在 Minecraft 和 Discord 聊天之间建立桥接
将您的 Minecraft 控制台转发至 Discord 文本频道，并从 Discord 执行命令
基于特定事件广播警报 (alerts.yml)
通过 Discord 语音聊天实现语音距离效果 (voice.yml)
要求绑定账户（或特定角色）方可进入游戏 (linking.yml)
将您的 Minecraft 账户与 Discord 账户绑定 (config.yml & synchronization.yml)
- Minecraft 群组 <-> Discord 角色同步
- Minecraft（显示）名称 -> Discord（昵称）名称同步
- Minecraft <-> Discord 封禁同步
- 奖励玩家（例如身在 Discord 服务器或进行助推等）
- 识别玩家身份（通过 /discord linked 命令及验证）
- 管理用途
支持多种语言
中文、丹麦语、荷兰语、英语、爱沙尼亚语、法语、德语、日语、韩语、波兰语、俄语、西班牙语和乌克兰语
支持流行的聊天插件（列表如下）
高度可定制

我们集成的插件：

聊天
- Herochat, LegendChat, LunaChat, TownyChat, VentureChat
隐身
- Essentials, PhantomAdmin, SuperVanish, VanishNoPacket
世界
- Multiverse
Vault
LuckPerms
PlaceholderAPI - DiscordSRV 扩展占位符

使用我们 API 的插件：

DiscordSRV StaffChat
ChatControlRed
CMI
Plan
EmojiChat
PurpleIRC
ChatReplay
AuctionHouse
Staff Facilities
Staff++
LiteBansBridge
MCSF (My Christian Swear Filter)
MZP-VoteParty
InteractiveChat DiscordSRV Addon (与 DiscordSRV 无关联)
DiscordSRVUtils (与 DiscordSRV 无关联)
ActivityRoles
EconomyShopGUI
DiscordSchematicUploader (与 DiscordSRV 无关联)
KiaiMC
SlashAdditions
Custom Bans Plus
DiscordSRVOAuth (与 DiscordSRV 无关联)
Villager Announcer
DiscordNickSync

预期用途

通过使用此插件，您可以让玩家在游戏内与您的 Discord 服务器上的玩家聊天，同时让 Discord 服务器上的人能够与 Minecraft 服务器中的人聊天——这对于仍想与游戏内玩家交流但因故无法访问 Minecraft 服务器的玩家非常有用。

该插件具备远程控制台功能。您可以指定一个文本频道，让插件将控制台消息转发至此频道，同时将该频道中发送的所有消息作为服务器控制台命令执行（您应限制仅开发者或高级别角色才能向此频道发送消息）。由于 Discord 权限的工作方式，您可以让某些服务器角色有权查看控制台，但不允许他们在此频道中发送消息，从而为受信任的管理员创建只读控制台。

聊天和控制台功能均可通过配置文件进行开关。部分选项可由拥有 OP 权限或具有 discordsrv.reload 权限的玩家通过 /discordsrv reload 命令刷新。

机器人权限

服务器权限

权限	功能
`Manage Roles`	角色同步以及为已绑定玩家添加角色
`Manage Channels`	频道主题更新器和语音模块
`Ban Members`	封禁同步
`Manage Nicknames`	昵称同步
`Manage Webhooks`	实验性 Webhook 用法
	（建议设置为全服务器权限，但也可按频道单独应用）

频道权限

权限	功能
`Read Text Channels & See Voice Channels`	DiscordSRV 的频道选项所必需（包括控制台和语音大厅），语音模块分类以及您希望用于预设回复的任何其他频道
以及 `Send Messages`
`Manage Messages`	当消息被玩家列表和聊天频道命令删除时
`Embed Links`	可选用于嵌入游戏内发布的链接，并在使用嵌入消息时为死亡、加入/离开所必需
`Mention @everyone, @here and All Roles`	用于提及 @everyone（如果已添加到 config.yml 中的允许提及项且提及功能已启用）
`Add Reactions` 和 `Read Message History`	当机器人用"💬"和"❗"反应以通知从 Discord 发送到 Minecraft 的截断消息时所需
`Move Members`, `Mute Members` 和 `Manage Permissions`	语音大厅和语音分类所必需

安装

请访问安装页面，获取关于安装和设置 DiscordSRV 的清晰且深入的说明。

捐赠

首先，衷心感谢您请我吃披萨。如果您愿意捐赠，请访问 https://scarsz.me/donate。建议捐赠金额为 10 美元，但您也可以捐赠任意金额——任何捐赠对我而言都是巨大的感谢。请在备注中填写您的 Discord 用户名，如果您加入了 DiscordSRV 的服务器，您将被标记为捐赠者，并在未来获得一些不错的特权。如果您捐赠时未添加备注，请在 Discord 上向我发送私信，我将手动核实。

开发者

如果您希望将 DiscordSRV 与您的插件对接，可以通过添加 Maven 依赖或将插件 jar 文件（DiscordSRV 版本 1.18.0+）添加到您的项目中来实现。您还需要添加 JDA 仓库。示例请参考 DiscordSRV-ApiTest。请务必将 "DiscordSRV" 添加到您插件的 plugin.yml 中的 depends/softdepends 列表。

Maven

<repository>
    <id>Scarsz-Nexus</id>
    <url>https://nexus.scarsz.me/content/groups/public/</url>
</repository>  
...  
<dependency>
    <groupId>com.discordsrv</groupId>
    <artifactId>discordsrv</artifactId>
    <version>1.29.0</version>
    <scope>provided</scope>
</dependency>

Gradle

repositories {
    maven { url 'https://nexus.scarsz.me/content/groups/public/' }
}  
dependencies {
    compileOnly 'com.discordsrv:discordsrv:1.29.0'
}

数据使用

数据收集

在 https://bstats.org/plugin/bukkit/DiscordSRV 上显示的所有内容都将公开可见，您的服务器也将包含在统计数据中。这仅用于统计目的；不会发送您服务器的任何私人信息。如果您不希望您的服务器被包含在内，请在 config.yml 文件中指定配置选项 MetricsDisabled 并将其设置为 true。

更新检查

DiscordSRV 使用 GitHub API 检查更新，并通过最低版本机制确保版本安全（安全功能）。您可以通过在 config.yml 文件中将 UpdateCheckDisabled 设置为 true 来禁用更新检查；但如果存在安全问题/漏洞且您正在运行易受攻击的版本，此举可能会使您的服务器面临风险。