Synccord

插件

· 作者 gamingkaetzchen

一个用于你 Minecraft 服务器的 Discord 机器人。

0 本站下载 0 关注 更新于 11 个月前

需要前置:LuckPerms

最新 0.4.0 · 1.21.10 · Bukkit / Paper

一键开服(送7天)

?? 英文

Synccord 是一款一站式集成插件,可将你的 Paper/Spigot 服务器与 Discord 公会连接:

✅ 通过代码进行账号绑定(MC ↔ Discord),使用 SQLite 存储

? Discord 角色与 LuckPerms 组之间的角色同步

? 完整聊天桥接(Minecraft ↔ Discord)+ 加入/离开/死亡嵌入消息

? 工单系统,支持按钮、模态框、LiteBans 钩子及转录记录

? 实时服务器状态嵌入消息(TPS、MSPT、玩家数量、IP),支持离线检测

? 在线玩家列表嵌入消息,自动更新

? 规则接受流程,包含密码词与自动分配角色

? PlaceholderAPI 扩展(synccord_…),用于统计、绑定状态和 Discord 信息

⚙️ 所有配置均可通过 config.yml、lang/de.yml、rules.yml 进行调整

? 调试模式,提供详细的日志消息

? 支持 bStats

功能详情 ? 账号绑定(MC ↔ Discord)

基于代码的绑定方式:

在 Minecraft 端生成一个代码。

在 Discord 端通过斜杠命令/按钮流确认该代码。

绑定关系存储在 SQLite 中(linked_users 表)——避免 YAML 文件杂乱无章。

命令:

/dcfind <player> – 显示 Minecraft 玩家的已绑定 Discord ID + 标签

/unlinkdiscord <player> – 移除现有的绑定关系(Minecraft 端,管理员权限)

/linkmc … & /unlinkmc … – Discord 斜杠命令,用于从 Discord 端绑定/解绑

占位符与语言键会显示绑定状态、上次绑定时间、代码剩余有效时间等。

? 角色同步(Discord ↔ LuckPerms)

Discord → Minecraft:

role-link:在 config.yml 中将 Discord 角色 ID 映射到 LuckPerms 组。

玩家加入时,Synccord 查找已绑定的 Discord 成员并同步组别。

添加或移除组别,确保 Discord 角色设置与游戏内组别始终一致。

详细的调试日志:检查哪些角色/组组合被添加、移除或保持不变。

错误信息(缺少公会 ID / 角色 / 成员)通过 lang/de.yml 进行本地化。

(LuckPerms 为硬性依赖项。)

? 聊天桥接与加入/离开/死亡嵌入消息

Minecraft → Discord:

所有聊天消息都会发送到配置的 discord.chat-channel-id。

使用 PlaceholderAPI 格式化玩家名称、前缀、状态等。

可在 config.yml 中配置格式(chat.format-to-discord)。

Discord → Minecraft:

来自指定频道的消息会被发送到 Minecraft 聊天频道。

支持占位符替换和颜色代码。

可以屏蔽提及消息并忽略机器人消息。

加入/离开/死亡转发:

加入/离开/死亡的随机消息(discord.join-messages, discord.leave-messages, discord.death-messages)。

带有颜色和玩家名称的嵌入消息。

可通过 features.send-join、features.send-leave、features.send-death 切换功能开关。

? 工单系统(仅 Discord,但感知 Minecraft 状态)

config.yml 下的 tickets 部分可配置多种工单类型: (例如 support, entbannung, bugreport, teamapply, vorschlag, kriegsanfrage …)

每种类型包含:

名称、描述、按钮标签

支持人员角色(supporter_roles)

工单分类(Discord 分类 ID)

可选的 LiteBans 钩子,用于在未解封工单中附加封禁信息

问题列表及最大输入长度(模态表单)

斜杠命令 /ticket setup …(Discord)以发布工单面板。

当创建工单时:

在配置的分类下创建一个私人工单频道。

支持人员获得权限,用户只能看到自己的工单。

转录记录:

关闭工单时,收集所有消息并上传为 log 频道中的 transcript.txt,附带 informative embed。

Minecraft 集成:

当工作人员加入服务器且存在未处理的工单时,他们会收到游戏内的提醒(可配置的语言键)。

? 实时服务器状态嵌入消息

斜杠命令 /setup info 会将服务器信息面板发送到 Discord 频道:

TPS、MSPT、运行时长

在线玩家数量

Java 版与 Bedrock 版 IP(来自配置)

tps-monitor 每隔 X 秒自动更新嵌入消息。

Synccord 会在一个小 YAML 文件中记住频道和消息 ID,并在重启后恢复它们。

如果服务器离线,InfoUpdaterOffline 会将面板替换为“离线”嵌入消息和一个按钮,确保用户始终看到有效的状态。

? 在线玩家列表嵌入消息

独立的玩家列表嵌入消息:

显示当前在线玩家及其排名和别名(playerlist.rank-aliases)。

配置选项:显示排名、别名、名称;每行格式自定义。

在玩家加入/退出时自动更新。

存储频道和消息 ID,并在重启后复用。

? 规则与密码词接受

文件 rules.yml 以多个章节保存你的服务器规则。

Discord 斜杠命令 /setup regel:

将规则发送到频道(如有需要则拆分为多个嵌入消息)。

添加一个“接受规则”按钮,打开带有密码词的模态框。

如果用户输入了 config.yml 中配置的正确答案(rules.keyword):

他们将获得配置好的接受角色(rules.accept-role-id)。

错误、成功和调试消息均通过语言文件完全本地化。

? PlaceholderAPI:%synccord_*%

Synccord 注册了一个名为 synccord 的 PlaceholderAPI 扩展,包含许多占位符,例如:

全局变量:

%synccord_tps%, %synccord_mspt%

%synccord_online_count%, %synccord_max_players%

%synccord_uptime%

%synccord_ip_java%, %synccord_ip_bedrock%

%synccord_synccord_version%

%synccord_status_embed_active%, %synccord_playerlist_embed_active%

%synccord_discord_online%, %synccord_linked_online%

%synccord_tickets_open%

按玩家变量(需要玩家上下文和绑定关系):

基本信息:%synccord_player%, %synccord_uuid%, %synccord_x%, %synccord_y%, %synccord_z%

绑定状态:%synccord_discord_id%, %synccord_discord_linked%, %synccord_discord_status%

Discord 信息:%synccord_discord_tag%, %synccord_discord_username%, %synccord_discord_avatar%

角色:%synccord_discord_roles%, %synccord_role_count%, %synccord_highest_role%

绑定信息:%synccord_last_linked%, %synccord_code_expire%, %synccord_sync_fail_reason%

工单:%synccord_tickets_user%, %synccord_ticket_support_role%, %synccord_last_ticket_time%

非常适合用于记分板、MOTD、TAB 或其他聊天插件。

? 语言、调试与指标

所有面向用户的文本均位于 lang/de.yml 中:

普通消息、错误消息、调试日志、工单文本、规则消息等。

缺失的密钥会显示清晰的“缺失密钥”提示,以便你进行修复。

在 config.yml 中设置 debug: true 可启用非常详细的调试日志记录:

链接、斜杠命令、角色同步、工单、嵌入组件、玩家列表、信息更新器等。

已集成 bStats(ID 在插件中配置),用于提供匿名统计数据。

? 要求

服务器:Paper / Purpur / Spigot(已在 1.21 版本测试)

Java:现代长期支持版(例如 Java 17+;插件基于 Java 21 构建)

依赖项:

必需:LuckPerms

可选但受支持:

LiteBans – 用于解封工单集成

PlaceholderAPI – 用于占位符和聊天格式化

?? 德语

Synccord 是一款功能全面的 Discord ↔ Minecraft 插件:

✅ 账户绑定(MC ↔ Discord),支持代码验证与 SQLite 存储

? 角色同步,实现 Discord 角色与 LuckPerms 组之间的联动

? 聊天桥接(Minecraft ↔ Discord),包含加入/离开/死亡嵌入消息

? 工单系统,支持按钮、模态框、LiteBans 集成及转录功能

? 服务器状态嵌入组件(TPS、MSPT、在线玩家数、IP 地址),具备离线检测功能

? 自动更新的玩家列表嵌入组件

? 规则系统,支持关键词查询与自动分配角色

? PlaceholderAPI 扩展(synccord_…),用于统计、链接状态及 Discord 信息展示

⚙️ 完全可通过 config.yml、lang/de.yml、rules.yml 进行配置

? 调试模式,提供详细日志记录

? 支持 bStats

功能概览 ? 账户绑定(Minecraft ↔ Discord)

玩家在 Minecraft 中获取一个代码,并在 Discord 端确认绑定。

链接信息会永久且规范地存储在 SQLite 数据库中。

命令:

/dcfind <玩家> – 显示玩家的关联 Discord ID 及标签

/unlinkdiscord <玩家> – 移除链接(支持 Minecraft 玩家或管理员)

/linkmc … /unlinkmc … – Discord 上的斜杠命令

占位符与多语言文本提供关于链接状态、上次链接时间、代码剩余有效期等信息。

? 角色同步

Discord → Minecraft (LuckPerms):

在 config.yml 的 role-link: 下,将 Discord 角色 ID 映射到 LuckPerms 组。

当已关联的玩家加入时,会调整其 LuckPerms 中的组。

添加或移除组,直至与现有的 Discord 角色匹配。

详细的调试输出:显示哪些角色/群组被检查、添加、移除或忽略。

错误情况(缺少公会 ID、角色、成员)完全通过语言文件处理。

? 聊天桥接与加入/离开/死亡通知

Minecraft → Discord:

来自 Minecraft 的聊天消息会发送到配置好的 Discord 频道(discord.chat-channel-id)。

可以使用 PlaceholderAPI 来插入名称、前缀、状态等信息。

格式可在 config.yml 中自定义(chat.format-to-discord)。

Discord → Minecraft:

来自聊天频道的消息会显示在 Minecraft 中。

可以屏蔽 @提及,并忽略机器人发送的消息。

加入/离开/死亡通知转发:

随机的加入/离开/死亡消息(discord.join-messages、discord.leave-messages、discord.death-messages)。

以嵌入形式展示,包含颜色与玩家名称。

可通过 features.send-join、features.send-leave、features.send-death 单独禁用。

? 工单系统

工单完全通过 Discord 创建,但具备 Minecraft 感知能力。

在 tickets 下支持多种工单类型(配置于 config.yml):

例如 support(支持)、entbannung(解封)、bugreport(错误报告)、teamapply(团队申请)、vorschlag(建议)、kriegsanfrage(战争请求)……

每种类型包含:

名称、描述、按钮文本

支持者角色(supporter_roles)

工单分类(频道类别)

可选的 LiteBans 钩子(例如用于解封工单)

带最大字符数限制的问题(Modal 表单)

使用 Slash 命令 /ticket setup … 发布工单嵌入消息。

创建时:

为当前用户和支持者分配相应权限的私密工单频道。

转录记录:

关闭时,所有消息将被收集并作为 transcript.txt 上传至日志频道,同时附带包含元数据的嵌入消息。

Minecraft 集成:

若存在未关闭的工单,游戏中会向有权限的玩家显示加入提示。

? 实时服务器状态

/setup info post 发布一个状态嵌入消息:

TPS、MSPT、运行时间

玩家数量

来自配置的 Java 与 Bedrock IP

tcs-monitor 会按设定间隔自动更新该嵌入消息。

Synccord 会保存频道 ID 和消息 ID,重启后恢复这些内容。

当服务器不可达时,将发送离线嵌入消息,确保状态显示永远不会“过时”。

? 玩家列表嵌入

独立的玩家列表面板:

显示所有在线玩家及其所属组和别名(playerlist.rank-aliases)。

每个玩家的显示格式可通过模板定义(如 {alias} {name} 等)。

在玩家加入或离开时自动更新。

频道和消息会被持久化保存,并在服务器重启后复用。

? 规则与暗号系统

rules.yml 包含按分类组织的服务器规则。

在 Discord 中使用 /setup regel:

将规则以多条嵌入消息的形式发布。

添加一个按钮,点击后打开带有暗号输入框的 Modal 表单。

输入正确的暗号(rules.keyword):

用户将获得指定的角色(rules.accept-role-id)。

所有文本(错误信息、成功提示、调试输出)均通过 lang/de.yml 管理。

? PlaceholderAPI 扩展 synccord

Synccord 提供大量占位符变量:

全局变量:

%synccord_tps%, %synccord_mspt%

%synccord_online_count%, %synccord_max_players%

%synccord_uptime%

%synccord_ip_java%, %synccord_ip_bedrock%

%synccord_synccord_version%

%synccord_status_embed_active%, %synccord_playerlist_embed_active%

%synccord_discord_online%, %synccord_linked_online%

%synccord_tickets_open%

玩家相关变量:

基础信息:%synccord_player%, %synccord_uuid%, %synccord_x%, %synccord_y%, %synccord_z%

链接信息:%synccord_discord_id%, %synccord_discord_linked%, %synccord_discord_status%

Discord 信息:%synccord_discord_tag%, %synccord_discord_username%, %synccord_discord_avatar%

角色信息:%synccord_discord_roles%, %synccord_role_count%, %synccord_highest_role%

链接状态:%synccord_last_linked%, %synccord_code_expire%, %synccord_sync_fail_reason%

工单信息:%synccord_tickets_user%, %synccord_ticket_support_role%, %synccord_last_ticket_time%

适用于记分板、TAB、聊天插件、MOTD 等。

? 语言、调试与统计

插件中的所有文本均可通过 lang/de.yml 进行自定义。

缺失的键会明确标注,以便你快速补充。

在配置文件中启用 debug: true 后,将输出详细的调试信息,涵盖:

链接系统、角色同步(RoleSync)、工单系统、状态面板、玩家列表、聊天桥接等。

已集成 bStats 统计服务。

? 前置要求

服务器端:Paper / Purpur / Spigot(已在 1.21 版本测试)

Java 版本:现代 Java 版本(推荐 Java 17+ / 21)

依赖项:

必需:LuckPerms

可选:LiteBans、PlaceholderAPI

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源