DiscordSRV

DiscordSRV 服务器与 Discord 互通

> 把服务器和 Discord 打通：游戏内聊天与 Discord 频道双向同步、控制台转发到频道并可直接执行命令、账号绑定与身份组同步——让 Discord 从"公告板"变成真的运营工具。
基本信息

| 项目 | 信息 |
| --- | --- |
| 插件名称 | DiscordSRV |
| 开发者 | DiscordSRV 团队（开源维护）|
| 最新版本 | 1.30.5（2026-04-24）|
| 许可协议 | GPL-3.0-or-later |
| 兼容版本 | Minecraft Java 1.7.10 – 26.2 |
| 运行平台 | Bukkit、Spigot、Paper、Purpur、Folia |
| 前置依赖 | 无强制前置；需要一个 Discord 机器人令牌 |
| 项目地址 | https://modrinth.com/plugin/discordsrv |
| 官方文档 | https://docs.discordsrv.com |
简介

DiscordSRV 解决的是"玩家在 Discord、服主在游戏里"这种割裂感。配置好机器人后，游戏内的聊天会实时出现在指定 Discord 频道，Discord 里的发言也会以玩家身份出现在游戏内；玩家离线时刷 Discord，上线后仍能看到这段对话，社区不会因为不在线而断掉。

它更实用的部分是运营功能：可以指定一个频道接收服务器控制台输出，并在该频道里直接发消息当命令执行（记得把这个频道设为只有管理员可见）；可以把游戏内账号与 Discord 账号互相绑定，进而做身份组同步、封禁同步、昵称同步，甚至要求必须绑定才能进服。想给 Discord 里活跃的玩家发奖励、想一眼看出"这个 Discord 用户是游戏里的谁"，都可以由它完成。

插件支持中文在内的十几种语言，并与 LuckPerms、Vault、PlaceholderAPI、Multiverse、Essentials 隐身等常见插件做了对接，装好之后基本不需要额外开发。
核心特性
双向聊天同步：游戏内消息与 Discord 频道消息互相同步，可分别设置频道与格式
远程控制台：把控制台日志转发到指定频道，并允许在该频道直接发送命令执行
账号绑定：玩家用命令把游戏账号与 Discord 账号绑定，可用绑定状态做进服限制
身份组与昵称同步：Minecraft 权限组 ↔ Discord 角色、游戏 ID ↔ Discord 昵称互相同步
封禁同步：游戏内与 Discord 的封禁状态保持一致
事件提醒：玩家进出服、死亡、达成成就等事件可推送到 Discord
语音邻近聊天：配合 Discord 语音频道实现按距离衰减的语音交流
多语言：内置中文等十余种语言，消息可自行修改
广泛对接：支持 LuckPerms、Vault、PlaceholderAPI、Multiverse、各类隐身与聊天插件
环境要求

| 项目 | 要求 |
| --- | --- |
| 服务端 | Bukkit、Spigot、Paper、Purpur、Folia |
| Minecraft | Java 版 1.7.10 – 26.2（以所装版本标注为准）|
| 外部条件 | 一个 Discord 服务器与自建机器人（需要机器人令牌）|
| 可选对接 | LuckPerms、Vault、PlaceholderAPI、Multiverse 等 |
安装方法
在 Discord 开发者后台新建应用，创建机器人并复制令牌
用邀请链接把机器人拉进自己的 Discord 服务器，并给足频道权限
从 Modrinth 下载 DiscordSRV-Build-1.30.5.jar，放入 plugins/ 目录
启动服务器，插件会生成配置文件；在其中填入机器人令牌与各频道 ID
重载插件后用绑定命令测试：游戏内执行绑定命令，确认 Discord 侧能收到提示
使用提示
主命令是 /discord，先执行 /discord reload 让配置生效，再用 /discord linked 等子命令查看状态
拿到频道 ID 最方便的方式是开启 Discord 开发者模式后右键频道复制
控制台频道务必限制为管理员可见——该频道里的任何发言都会被当成命令执行
账号绑定需要机器人在服务器内有对应角色的管理权限，否则同步会失败
消息格式与各功能开关都在配置文件里，建议先只开聊天同步，跑通后再逐项加功能
官方只对最新版本提供支持，遇到问题先升级到最新构建再反馈
相关链接
Modrinth 项目页：https://modrinth.com/plugin/discordsrv
官方文档：https://docs.discordsrv.com
Discord 社区：https://discordsrv.com/discord
源码仓库：https://github.com/DiscordSRV/DiscordSRV