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）。
• 高度可定制：几乎所有功能均可通过配置文件进行调整。
• 插件兼容：支持与众多主流插件挂钩，实现更丰富的功能。

✨支持的插件

聊天插件

• Herochat
• LegendChat
• LunaChat
• TownyChat
• VentureChat

隐身插件

• Essentials
• PhantomAdmin
• SuperVanish
• VanishNoPacket

其他功能插件

• 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 命令重新加载插件以生效。

🎮安装与配置

• 安装指南：请访问 Wiki 上的 安装页面 查看清晰详细的安装与设置说明。
• 权限列表：完整的权限节点请参考 Wiki 上的 权限页面。
• 命令列表：所有可用命令请参考 Wiki 上的 命令页面。

⭐开发者信息

如果您希望自己的插件与 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 向作者发送私信以便手动核实。