DiscordSRV - 游戏与聊天互通插件
简介
DiscordSRV 是一款功能强大、高度可配置的开源 Discord 桥梁插件，支持从 1.7.9 到 1.21.x 的所有 Minecraft 版本。它能让您的 Minecraft 服务器与 Discord 社区无缝连接，实现双向沟通与管理。请注意，我们仅对最新的正式版或快照版提供支持，请在寻求帮助前确保插件已更新至最新版本。
核心功能
- 双向聊天桥接：在 Minecraft 游戏内聊天与 Discord 文本频道之间同步消息。
- 远程控制台：将 Minecraft 服务器控制台输出转发至指定的 Discord 频道，并可在该频道执行服务器命令（建议严格限制访问权限）。
- 事件广播：根据配置文件 (
alerts.yml) 中的设定，在特定事件发生时向 Discord 发送警报。 - 语音距离聊天：通过 Discord 语音聊天实现游戏内的近距离语音通信（需配置
voice.yml）。 - 账户链接：可要求玩家必须将其 Discord 账户与游戏账户链接（或拥有特定 Discord 身份组）才能进入服务器（配置见
linking.yml）。 - 高度可定制：几乎所有功能均可通过配置文件进行调整。
- 插件兼容：支持与众多主流插件挂钩，实现更丰富的功能。
支持的插件
聊天插件
隐身插件
其他功能插件
- Multiverse (多世界)
- Vault (经济权限)
- LuckPerms (权限管理)
- PlaceholderAPI (使用 DiscordSRV 扩展变量)
使用 DiscordSRV API 的插件
- DiscordSRV Staff Chat
- ChatControlPro
- CMI
- Plan
- EmojiChat
- PurpleIRC
- ChatReplay
- AuctionHouse
- Staff Facilities
- Staff++
- LiteBansBridge
- MCSF (My Christian Swear Filter)
- MZP-VoteParty
- InteractiveChat DiscordSRV Addon
使用说明
通过使用此插件，玩家可以在游戏内与您 Discord 服务器中的成员交流，反之亦然。这方便了玩家在离开 Minecraft 服务器后，仍能与游戏内的社区保持联系。
远程控制台功能允许您将控制台消息转发至 Discord 的指定频道，发送到该频道的消息将被服务器控制台视为命令执行。出于安全考虑，强烈建议您将此频道的访问权限限制给开发者或高级管理员。您也可以利用 Discord 的权限系统，为受信任的管理员成员创建一个只读的控制台视图。
所有聊天和控制台功能均可在配置文件中启用或关闭。配置更改后，可由 OP 或拥有 discordsrv.reload 权限的玩家使用 /discordsrv reload 命令重新加载插件以生效。
安装与配置
开发者信息
如果您希望自己的插件与 DiscordSRV 集成，可以通过添加 Maven 依赖或将 DiscordSRV 插件 Jar 文件（1.18.0 或更高版本）加入项目来实现。具体示例请参考 GitHub 上的 DiscordSRV-ApiTest。请确保在您插件的 plugin.yml 文件中，将 DiscordSRV 列入 depends 或 softdepends 列表。
Maven 依赖 (`pom.xml`)
<repository>
<id>scarsz</id>
<url>https://nexus.scarsz.me/content/groups/public/</url>
</repository>
<dependency>
<groupId>com.discordsrv</groupId>
<artifactId>discordsrv</artifactId>
<version>1.26.0</version>
<scope>provided</scope>
</dependency>Gradle 依赖 (`build.gradle`)
repositories {
maven { url 'https://nexus.scarsz.me/content/groups/public/' }
}
dependencies {
compileOnly 'com.discordsrv:discordsrv:1.26.0'
}常见事项
数据收集
插件使用 bStats 收集匿名统计信息。在 https://bstats.org/plugin/bukkit/DiscordSRV 上公开显示的数据中包含您服务器的统计贡献。此过程仅用于统计，不会发送任何服务器的私人信息。如果您不希望服务器被计入统计，请在 config.yml 文件中将配置项 MetricsDisabled 设置为 true。
更新检查
DiscordSRV 会通过 GitHub API 检查更新，并通过最低版本要求确保使用的版本是安全的（一项安全功能）。您可以在 config.yml 中将 UpdateCheckDisabled 设置为 true 来禁用更新检查。但请注意，如果存在安全漏洞/问题，而您正在运行易受攻击的版本，禁用更新检查可能会使您的服务器面临风险。
支持与捐赠
感谢所有支持！如果您喜欢这个插件并愿意请作者喝杯咖啡，可以通过 https://scarsz.me/donate 进行捐赠。建议金额为 10 美元，当然任何数额的支持都是莫大的鼓励。请在备注中留下您的 Discord 用户名，如果您在 DiscordSRV 的官方服务器中，您将被标记为捐赠者，并可能在未来获得一些专属福利。如果您捐赠时未备注，请通过 Discord 向作者发送私信以便手动核实。
