CoreChatX

插件

· 作者 IceWolf23X

CoreChatX 是专为 Minecraft 服务器打造的全方位通信套件。它将多种聊天相关功能整合到一个精致的系统中。

0 本站下载 0 关注 更新于 2 周前

最新 2026.3.4 · 26.3 · Paper / Purpur

一键开服(送7天)

CoreChatX 功能列表

CoreChatX 是专为 Minecraft 服务器打造的完整通信套件。 它将聊天、私聊、持久化昵称、频道、提及(Mentions)、Ping 提示、聊天物品预览、气泡头像、管理工具、玩家设置、多语言支持以及外部桥接整合到一个精致的系统中。

其理念很简单:服务器的聊天体验应当像一个统一的产品,而不是一堆需要各自配置、命令和维护的独立插件堆砌。

本页面为商业风格的功能概览。 具体的配置键名、默认值、限制及操作细节请参阅文档:

当前版本:2026.3.4

在更新现有安装之前,请停止受影响的服务器,并备份其 CoreChatX 插件文件夹内的所有文件和子文件夹。 单独保留旧的 JAR 文件,如果已使用 MySQL,也请对其进行备份。同时更新 Velocity 代理和所有参与的 Paper 后端。


为什么选择 CoreChatX

许多服务器最终会安装一个插件用于聊天,另一个用于私聊,另一个用于昵称,另一个用于提及,另一个用于频道,另一个用于 Discord,另一个用于 Telegram,另一个用于气泡头像,另一个用于物品预览,最后再装一个来维持整个设置的统一性。

这在技术上可行。 但这也会让聊天维护变成一种“爱好”。

CoreChatX 专为希望获得一致通信体验的服务器所有者打造:

  • 统一的视觉语言
  • 统一的权限模型
  • 统一的玩家设置流程
  • 统一的网络感知聊天层
  • 统一管理公共聊天、私聊、昵称、频道、Ping 提示、桥接、管理工具和丰富交互的场所

它并非试图成为“又一个聊天插件”。 它旨在用一套干净、友好、面向服务器的系统,取代分散的聊天相关插件堆栈。


统计数据

CoreChatX Paper/Purpur Chart

CoreChatX Velocity Chart

CoreChatX 默认启用 bStats 以收集使用统计数据。报告内容包括插件/平台类型、Java 版本、操作系统详情、处理器数量、玩家数量、在线模式状态、生成的服务器标识符,以及在 Velocity 上配置的后端数量。这些指标不包含聊天消息或玩家名称。bStats 接收这些报告;聚合图表公开可见。

您可以通过在 Paper 的 plugins/bStats/config.yml 中设置 enabled: false,或在 Velocity 的 plugins/bStats/config.txt 中设置 enabled=false 来选择退出,然后重启受影响的服务器/代理。这些设置与其他 bStats 集成共享。请参阅 bStats 服务器所有者指南 和 隐私政策。

当前状态

CoreChatX 目前:

  • 支持 Paper 1.21.11 - 26.2
  • 目标 Java 版本为 21;Paper 1.21.11 请使用 Java 21,Paper 26.1/26.2 请使用 Java 25,而 Velocity 需满足其自身的运行时要求及 CoreChatX 的 Java 21 最低要求
  • 提供独立的 corechatx-paper 和 corechatx-velocity 运行时 JAR 包
  • 在 Paper 上的插件名为 CoreChatX
  • 在 Velocity 上的插件 ID 为 corechatx
  • 可在独立的 Paper 服务器上运行
  • 可在 Velocity 网络上运行,支持一个或多个隔离的 CoreChatX 代理组
  • 默认使用 YAML 存储,并为独立 Paper 服务器或 Velocity 拥有的网络组提供可选的 MySQL 存储
  • 包含经过验证的备份功能,支持通过 /ccxstorage 命令进行 YAML 到 MySQL 的迁移,以及当前数据从 MySQL 回滚到 YAML
  • 允许每位玩家选择持久化或非持久化的频道选择
  • 支持永久或定时的个人频道隐藏
  • 检查 Modrinth 以获取稳定版本和实验性的 alpha/beta 构建,并在控制台和 Paper OP 通知中显示
  • 支持群组本地网络聊天、私聊、玩家设置、昵称、运行时数据、Discord 链接和 ChatItem 快照
  • 支持 Discord 入站和出站消息
  • 支持 Telegram 入站和出站消息
  • 支持 Telegram 论坛主题路由
  • 支持针对每个频道的 Discord 和 Telegram 桥接格式覆盖
  • 支持基于来源的提及门控(Minecraft、Discord 和 Telegram 文本)
  • 支持可选的 Discord-Minecraft 账户关联
  • 支持 Discord 必需关联才能游玩和必需角色才能游玩的门控
  • 支持从 Minecraft 昵称同步 Discord 昵称,若失败则回退至真实的 Minecraft 玩家名称
  • 支持 Discord 连接、死亡、成就和服务器状态的嵌入消息
  • 支持 Discord 控制台频道、玩家列表输出和频道描述更新
  • 支持 Discord ChatItem PNG 预览和物品检视菜单
  • 支持从 Minecraft 消息扩展 Discord 自定义表情符号
  • 支持将 Discord 入站附件作为可点击的 Minecraft 文件链接
  • 在渲染前支持来自可信服务端值的旧版颜色和十六进制格式转换
  • 包含可选的玩家头顶气泡头像
  • 包含持久的 CoreChatX 昵称,支持细粒度的颜色、样式、十六进制和渐变权限
  • 支持本地 Paper 或代理路由的加入、离开和首次加入公告
  • 已在独立 Paper 和 Velocity 网络设置中经过测试
  • 通过 LICENSE 和 THIRD-PARTY-NOTICES.md 文档说明了专有 CoreChatX 代码和外部第三方库

一套套件,而非十个插件

CoreChatX 涵盖了核心通信堆栈:

  • 公共聊天
  • 私聊
  • 持久化昵称
  • 昵称的真实姓名查找
  • 回复
  • 频道
  • 频道快捷方式
  • 提及
  • 自定义 Ping 提示
  • 交互式关键词
  • 聊天物品预览
  • 气泡头像
  • 管理工具
  • 玩家设置
  • 多语言支持
  • Discord 桥接
  • Telegram 桥接
  • 独立服务器和 Velocity 网络设置

其价值不仅仅在于功能数量的堆砌。 真正的价值在于这些功能彼此知晓、相互协同。

频道可以影响格式设置、权限控制、@提及通知的投递、聊天组件(ChatItems)、气泡提示以及桥接导出。 @提及能够尊重玩家的个人设置与频道的阅读权限。 私聊可以与社交窥视(social spy)和屏蔽规则配合工作。 网络聊天可以承载丰富的 Adventure 组件,并支持聊天组件预览引用。 桥接模块可以遵循频道路由逻辑,而不是作为一个独立且割裂的副项目运行。

这就是一个统一的聊天系统与那些拥有重叠命令、配置彼此脱节的独立插件之间的区别。


精致的公共聊天

CoreChatX 为公共聊天提供了玩家真正能感知到的坚实基础:

  • 简洁的聊天格式
  • 基于排位的布局
  • 基于频道的布局
  • LuckPerms 前缀支持
  • 服务器控制模板中的 PlaceholderAPI 支持
  • 持久化昵称支持
  • 加入、退出及首次加入消息
  • 消息清理与净化
  • 在可信服务端文本中安全转换旧版颜色代码与旧版十六进制颜色值
  • 防重复检测
  • 防全大写检测
  • 词语过滤

玩家撰写的消息保持安全。 服务器拥有的模板可以使用动态占位符,而正常的玩家输入在转化为富文本聊天组件之前会受到严格控制。


Kyori Adventure 与 MiniMessage

CoreChatX 基于 Kyori Adventure 和 MiniMessage 格式构建。 这意味着服务器管理员无需被困在仅支持旧版颜色代码的格式限制中,即可创建现代的聊天组件。

MiniMessage 支持让使用变得轻松便捷:

  • 颜色
  • 渐变色
  • 悬停文本
  • 点击动作
  • 建议命令
  • 复制到剪贴板动作
  • 可复用的格式模式
  • 跨聊天、消息、预览、桥接输出、嵌入内容及命令反馈的整洁富文本

CoreChatX 还会在处理最终 Adventure 组件之前,先处理由 PlaceholderAPI、LuckPerms 和 Essentials 风格昵称提供者等插件返回的旧版格式。 这有助于服务器管理员保留现代的 MiniMessage 模板,同时避免当其他插件仍返回旧版颜色代码或十六进制颜色输出时出现崩溃或错误。

这使得 CoreChatX 具有现代 Paper 原生的质感,而非那种事后强行附加丰富格式的遗留聊天系统。


基于 PlaceholderAPI 的交互

CoreChatX 可以在服务器控制的模板中将 MiniMessage 与 PlaceholderAPI 结合使用。

这为基于以下内容的快速、灵活交互打开了大门:

  • 玩家数据
  • 段位与分组
  • 经济数值
  • 服务器统计信息
  • 世界数据
  • 进度系统
  • 已安装的 PlaceholderAPI 扩展
  • 通过占位符暴露的自定义服务器逻辑

CoreChatX 还向其他插件暴露了有用的 PlaceholderAPI 值,包括:

  • %corechatx_player_nickname%
  • %corechatx_first_join_date%
  • %corechatx_messages_count%

在实际应用中,这意味着服务器管理员可以构建动态的聊天交互,而无需额外编写胶水代码来实现悬停提示行、消息桥接、Discord 频道描述或点击动作等显示有用信息的功能。

如果 PlaceholderAPI 能够暴露这些占位符,CoreChatX 就能帮助将其转化为聊天体验的一部分。

在 Velocity 平台上,可选的 PAPIProxyBridge 支持可以为代理管理的界面解析 PlaceholderAPI 值,例如玩家列表行、Discord 频道描述、加入/离开消息以及备用 Discord 格式。如果代理占位符查找无法及时完成,CoreChatX 会回退处理,而不是让消息路径无限期等待。


持久化昵称

CoreChatX 包含完整的昵称层,而非将显示名称视为一种事后补充的格式化功能。

昵称功能包括:

  • /nick <昵称>

  • /nick off、/nick clear 和 /nick reset

  • 管理员可为其他在线玩家编辑昵称

  • /realname <昵称> 查询

  • {player_name} 用于获取真实的 Minecraft 用户名

  • {player_nickname} 用于获取可见的 CoreChatX 昵称,若未设置则回退至真实用户名

  • 可选的 nicknames.prefix 仅在使用自定义昵称时显示

  • 通过 nicknames.change-only-colors 实现可选的仅颜色模式

  • 支持命名颜色、安全的 MiniMessage 样式、十六进制颜色、渐变色以及传统颜色代码输入

  • 按颜色和样式的昵称权限控制

  • 重复昵称保护

  • 代理组昵称同步

昵称用于聊天、私信、社交间谍、广播、加入/离开/首次加入消息、提及、ChatItem 预览标题、PlaceholderAPI 输出以及启用的 Discord 账户关联身份中。

玩家的实际身份在内部保持稳定。 路由、忽略规则、回复、账户关联和运行时状态仍使用 UUID 和真实的 Minecraft 名称,而可见的展示则可使用配置的昵称。


交互式关键词

交互式关键词允许玩家输入简单的令牌,例如:

  • [discord]
  • [rules]
  • [store]
  • [vote]
  • [map]

CoreChatX 可以将这些令牌转换为精美的可点击聊天元素。

它们可以包含:

  • 悬停文本
  • 点击命令
  • 建议命令
  • URL
  • 复制的文本
  • 可选权限
  • 频道限制
  • 可选的 PlaceholderAPI 渲染

这类小功能通常会促使玩家“再装一个插件”。 而在这里,它只是聊天套件的一部分。


@提及与通知

@提及和通知直接内置于消息流中。

它们支持:

  • 玩家提及
  • @Player 和精确名称提及行为
  • 昵称感知的提及建议
  • 自定义 ping 触发器
  • 声音通知
  • 操作栏通知
  • 按玩家的 ping 开关
  • 对工作人员友好的 ping 规则
  • 跨服务器提及感知
  • 基于被提及玩家的提及格式
  • 在目标被 ping 之前检查频道的读取权限
  • 针对 Minecraft、Discord 和 Telegram 的特定来源提及门控
  • 来自 Discord 触发的自定义 ping 的 Discord 角色白名单

如果玩家无法阅读他们被提及的频道,CoreChatX 不会对他们进行 ping,也不会将其名称渲染为 @ 提及。

由于提及(mentions)是 CoreChatX 自身的一部分,它们可以与格式化、通知、隐私设置、自定义昵称、频道权限以及 Velocity 网络在线状态等功能协同工作,而不是假装每个服务器都是独立的。


频道

CoreChatX 支持多种频道样式:

  • 全局聊天
  • 本地聊天
  • 管理员聊天
  • 全网络聊天
  • 基于角色的聊天空间
  • 自定义服务器定义频道

频道的传递范围是明确的:NETWORK 会覆盖同一 Velocity 组中的参与后端服务器,SERVER 仅保留在单个后端服务器上,而 LOCAL_RADIUS 则覆盖同一世界中配置半径内的玩家。在独立的 Paper 服务器上,网络范围的聊天仅限于该服务器。

频道可以决定:

  • 谁可以发送消息
  • 谁可以接收消息
  • 启用了哪些功能
  • 消息的外观样式
  • 是否允许气泡聊天
  • 是否允许 ChatItem(物品预览)
  • 消息是否可以导出到 Discord 或 Telegram
  • 哪个 Discord 或 Telegram 目标应接收桥接输出
  • 使用哪种每频道桥接格式覆盖
  • 哪些来源可以创建提及
  • 哪个快捷命令用于控制该频道
  • 公共聊天忽略行为是仅影响通知,还是隐藏被忽略发送者的消息

可以为每个频道配置快捷命令。 例如,/ac 可以将玩家切换到 adminchat 频道,而 /ac <message> 可以向该频道发送一次性消息,而不改变玩家当前选定的活跃频道。

拥有相应权限的玩家可以使用 /hidechannel <channel> [minutes] 暂时隐藏某个频道,直到他们使用 /unhidechannel <channel> 恢复它。在隐藏期间,玩家无法向该频道发送消息或从该频道接收消息。此偏好设置会持久保存,并在代理模式下跟随玩家在 backend 之间切换。

这使得频道行为集中化,而不是分散在多个具有不同聊天行为理念的插件中。


私聊

私聊与公共聊天属于同一个通信系统。

包含的工具:

  • 直接消息
  • 回复命令
  • 社交间谍模式
  • 忽略控制
  • 私聊开关
  • 投递反馈
  • 跨服务器私聊
  • Velocity 网络上的群组本地私聊

公共聊天忽略行为可以设置为仅限私聊、抑制公共提及/ping 通知,或隐藏来自被忽略玩家的公共消息。频道可以继承或覆盖此行为,配置的管理人员绕过权限仍然适用。

结果是产生了一个理解插件其他部分的私聊系统:隐私、管理、网络路由、格式化、昵称和玩家设置都存在于同一个生态系统中。


管理工具

CoreChatX 包含了真实服务器所需的各种日常管理控制功能:

  • 玩家静音
  • 取消静音
  • 全局聊天静音
  • 清除聊天
  • 防重复检查
  • 防大写检查
  • 词汇过滤
  • 管理人员绕过权限
  • 静音感知的 Discord 账户链接行为
  • 已链接 Discord 用户的桥接来源权限检查

管理工作在聊天层内部处理。 这意味着它可以自然地与频道、私聊、网络行为、Discord 链接用户和玩家设置配合使用。

这避免了单独的管理工具和聊天工具相互重复或猜测彼此的状态。


物品预览

玩家可以分享以下内容的可点击预览:

  • 手持物品
  • 潜影盒内容
  • 盔甲
  • 快捷栏
  • 背包
  • 末影箱

支持的聊天令牌包括:

  • [item]
  • [i]
  • [armor]
  • [hotbar]
  • [inventory]
  • [inv]
  • [enderchest]
  • [ender]
  • [ec]

ChatItem 令牌格式可以使用:

  • {token}
  • {name}
  • {material}
  • {amount}

当存在自定义物品名称时,{name} 优先使用自定义物品名称,然后是物品名称,最后是材质回退。

同一条消息中的多个 ChatItem 令牌可以重用相同的捕获玩家状态,同时仍能打开正确的视图。

在 Velocity 网络上,位于另一个后端的玩家仍可以通过轻量级的快照引用和按需检索来点击并打开预览。 这使得网络聊天更加简洁,避免了将沉重的物品数据塞入主聊天数据包中。

当启用 Discord 图像渲染时,Minecraft 到 Discord 的 ChatItem 消息可以附加渲染后的 PNG 预览图。类似库存的渲染可以包含下拉菜单,Discord 用户可以通过临时的 Minecraft 风格提示面板检查各个物品,其中包含名称、描述、附魔、存储的附魔书附魔、药水效果、属性、盔甲纹饰和耐久度。

过期的 Discord 物品检查操作现在会返回清晰的过期或不可用消息,而不是无限加载。

管理员还可以使用以下命令预热物品渲染缓存:

  • /corechatx itemcache warmup
  • /corechatx itemcache status
  • /corechatx itemcache cancel

这有助于在缓存准备就绪后更快地显示 Discord 物品预览。

当启用原版资产下载时,渲染器可以将 Minecraft 客户端资产下载并提取到本地插件缓存中。配置的资源包也可以提供渲染资产;原版 Minecraft 资产不捆绑在插件 JAR 文件中。


气泡聊天

CoreChatX 可以在玩家头顶显示最近的聊天消息。

气泡功能包括:

  • 玩家开关
  • 频道规则
  • 世界规则
  • 潜行检查
  • 隐身检查
  • 可配置持续时间
  • 消息换行
  • 堆叠最近的消息
  • 基于距离的可见性
  • 退出、重载和关闭时的清理

气泡聊天使用已经处理过的消息,因此过滤、频道、提及、昵称和关键词都已经完成了它们的工作。

在网络环境中,气泡仅局限于发送者物理所在服务器的范围内。 这使得该功能保持实用,而不是假装头顶的气泡可以漂浮在服务器之间。


玩家控制

玩家可以直接控制重要的通信偏好设置:

  • 设置菜单
  • Ping 切换开关
  • PM(私聊)切换开关
  • 昵称管理
  • 频道切换
  • 频道快捷键
  • 永久或定时的个人频道隐藏
  • 持久化或非持久化的频道选择
  • 聊天气泡切换开关
  • 语言区域选择
  • 忽略列表控制
  • 启用时支持 Discord 账号绑定与解绑命令

/ccxsettings(同样适用于 /chatsettings)中的 Channel 罗盘允许每位玩家自行选择:

  • Persistent(持久化): 断开连接后保留最后活跃的频道,包括跨服务器重启。
  • Non persistent(非持久化): 下次连接时返回配置好的默认频道。

更改此偏好设置不会立即切换当前活跃频道。在同一代理连接期间在后端之间移动也会保留当前的频道选择。

这使得 CoreChatX 感觉像是一个面向玩家的功能,而不仅仅是一个附带聊天命令的管理员配置文件。


语言区域支持

CoreChatX 包含实用的语言区域基础功能:

  • 按玩家的语言区域选择
  • 语言区域覆盖文件
  • 回退至主消息文件
  • 更清晰地控制面向玩家的措辞

这对于多语言社区以及希望每条消息都符合其品牌风格的服务器非常有用。


Discord 和 Telegram 桥接

CoreChatX 内置了桥接支持。

重要披露:Discord 和 Telegram 桥接是可选的,仅在服务器所有者启用并配置它们时才运行。 启用后,CoreChatX 可以将选定的聊天内容、玩家显示名称、频道标签、富媒体消息数据及相关消息格式发送给您配置的 Discord 或 Telegram 服务。 入站桥接消息也可以将 Discord 或 Telegram 的消息传回已配置的 Minecraft 频道中。 账号绑定将 Minecraft 身份与 Discord 账号关联起来。启用后,事件镜像、ChatItem 导出和控制台镜像还可以向 Discord 发送事件数据、物品/库存预览或控制台输出。

桥接功能包括:

  • Discord 出站消息
  • Discord 入站消息
  • Telegram 出站消息
  • Telegram 入站消息
  • Telegram 论坛主题路由
  • 按频道的桥接目标
  • 按频道的 Discord 和 Telegram 桥接格式覆盖
  • 完全可配置的 Discord 入站格式
  • 作为可点击的 Minecraft 文件链接转发 Discord 入站附件
  • 针对 Minecraft 来源消息的 Discord ChatItem 图片附件和物品检查菜单
  • 使用内部占位符和可选 PlaceholderAPI 值更新 Discord 文本频道描述
  • Discord 玩家列表文本和斜杠命令
  • 用于独立 Paper、后端控制台机器人和 Velocity 代理命令的 Discord 控制台命令频道
  • Discord 出站格式模板中的 PlaceholderAPI 和等级前缀支持
  • Discord 角色名称和角色颜色可用于 Minecraft 聊天格式
  • Minecraft 到 Discord 消息的 Discord 自定义表情符号扩展
  • 可选的 Discord 账号绑定以支持基于 Minecraft 的入站身份
  • 可选的从 Minecraft 昵称或真实玩家名称同步 Discord 昵称
  • 可选的通过 Minecraft 拒绝或踢出原因中的 Discord 链接代码强制执行链接
  • 可选的 Discord 角色门槛用于加入服务器的玩家
  • Velocity 网络上的特定组所需角色门槛
  • 路由级别和频道级别的账号绑定覆盖
  • Discord 入站格式模板中的频道前缀支持
  • 针对 Minecraft、Discord 和 Telegram 入站文本的来源特定提及门槛
  • 桥接来源自定义提示音的 Discord 角色白名单
  • 连接、首次加入、退出、死亡和进度嵌入
  • 服务器在线和离线状态嵌入
  • Telegram 出站格式模板中的等级前缀支持
  • 频道级别的桥接导出控制
  • 桥接占位符无效或入站 MiniMessage 语法错误的配置加载警告
  • 全局桥接主开关
  • 更清晰的重新加载和关闭行为
  • 安全的消息长度处理

基于 Discord 角色的准入需要 Server Members Intent。启用后,角色和公会成员资格的变化可以撤销在线已绑定玩家的访问权限,并且准入门控会阻止重新连接,直到恢复所需的访问权限。Discord 昵称同步仍受 Discord 的角色层级和公会所有者限制的影响。控制台频道及其授权角色应仅限于受信任的管理员。

支持自定义 Discord 斜杠命令名称。链接消息可以使用 /{link_command},这样说明中会显示为独立或代理机器人实际配置的命令。

桥接格式化在关键之处进行了清理。 CoreChatX 可以在发送到外部服务之前从身份/模板片段中剥离 MiniMessage、旧版和十六进制格式,同时保留真实的玩家消息内容。

桥接层被视为聊天系统的一部分,而不是具有无关路由规则的单独外部管道。

这很重要,因为频道规则、格式、网络行为和桥接路由应该彼此一致。 如果它们不一致,玩家会注意到。 管理员会更快注意到。


Velocity 网络支持

CoreChatX 支持独立的 Paper 服务器和 Velocity 网络。

在网络模式下,它可以确保以下功能跨服务器正常运行:

  • 组内局域网聊天频道
  • 跨服务器私聊(组内)
  • 玩家通信设置
  • 持久化昵称
  • 代理模式下的 Velocity 运行时存储
  • 玩家真实姓名与昵称建议
  • TAB 列表条目(如可用)
  • @提及与通知
  • 组内 Discord 账号绑定同步
  • 交互式关键词行为
  • ChatItem 预览访问权限
  • 经代理路由的加入、离开及首次加入公告
  • 代理模式下用于加入、离开及首次加入消息的 Velocity 专属 velocity-messages.yml 格式
  • 经代理路由的组内广播
  • 匹配组的 Discord 玩家列表输出
  • Discord 桥接导出时不重复发送网络消息
  • Discord 后端死亡事件与进度达成事件的嵌入式嵌入(Embeds)
  • Discord 服务器状态嵌入式嵌入(Embeds),涵盖代理启动、代理关闭以及后端在线/离线状态变更

在多通道模式下,每个 Velocity network-channel 值都是一个独立的 CoreChatX 组。 聊天、私聊、玩家目录数据、状态同步、昵称、屏蔽、Discord 绑定、待处理绑定代码、Discord 图片传输以及 ChatItem 快照路由均保留在匹配的组内。

Velocity 还可以监控列在 backend-groups.* 中的后端服务器,并在启用 discord.server-status 时向 Discord 通报在线/离线状态变更。

当启用登录门禁时,backend-groups.<server> 允许 Velocity 在玩家完全进入后端之前解析目标 CoreChatX 组。 这使得必需的 Discord 绑定和角色检查可以在代理边界完成,而不必依赖拥有在线载体玩家的某个后端。

这正是“一套套件”方法发挥最大作用的地方。 网络架构不应要求在每个后端上都部署单独的插件堆栈,以便让消息、开关、@提及、昵称、加入/离开行为、桥接器和私聊能够感知玩家已切换服务器。


YAML 与 MySQL 存储

CoreChatX 默认使用 YAML 作为存储后端。您可以将 YAML 安装更新到 2026.3.0,而无需切换到 MySQL。

可选的 MySQL 存储持久化以下内容:

  • 玩家偏好设置与昵称
  • 统计信息及活跃/隐藏频道
  • 忽略列表与屏蔽记录
  • 全局运行时状态
  • Discord 绑定、解绑记录及待处理绑定代码

独立运行的 Paper 服务器直接管理其自身存储。在代理模式下,Velocity 管理共享运行时数据并保持每个 CoreChatX 网络组隔离;Paper 后端使用代理而非自行建立 MySQL 连接。

/ccxstorage 提供状态与健康检查、文件/数据库验证、已验证备份、迁移计划、进度跟踪、数据对比、历史记录以及中断恢复功能。迁移与回滚操作仅限控制台执行。配置的 MySQL 存储在不可用时不会静默回退到 YAML。

仅更改后端设置不会迁移现有的 YAML 数据。 在完成本页面顶部描述的完整备份后,请根据您的部署环境遵循相应指南:

每份指南均按顺序说明准备、导入、验证、激活与重新加载步骤。此外还涵盖恢复机制以及如何利用最新 MySQL 数据返回 YAML 环境。请在迁移生产服务器之前,使用您自己安装的隔离副本进行演练;如果在 MySQL 已接受新更改后恢复旧的 YAML 备份,将会丢失这些较新的更改。


命令

CoreChatX 包含以下命令:

  • 插件管理
  • /corechatx 根命令
  • /ccx 根命令别名
  • /corechatx itemcache
  • /ccxstorage
  • /ccxsettings 与 /chatsettings
  • /hidechannel 与 /unhidechannel
  • /nick
  • /realname
  • /discord link
  • /discord unlink
  • /discord linked
  • 私聊
  • 回复
  • 社交间谍
  • 广播
  • 昵称
  • 自定义昵称的真实姓名查询
  • Discord 账号绑定
  • 通知控制
  • 频道控制
  • 频道快捷方式
  • 忽略控制
  • 私聊开关
  • 设置菜单
  • 语言区域选择
  • 屏蔽与解除屏蔽
  • 全局聊天屏蔽
  • 清除聊天

这些命令基于相同的通信层设计,因此彼此关联紧密,而非杂乱无章。


管理员体验

CoreChatX 为服务器所有者提供了实用的功能:

  • 清除启动信息
  • 启动时显示版本与作者
  • 启动时显示 Paper 或 Velocity 架构
  • CORECHATX 启动横幅
  • corechatx.* 权限命名空间
  • corechatx:main 默认网络频道
  • 更安全的配置验证
  • 默认配置键同步
  • 更简洁的错误处理
  • 更安全的网络消息处理
  • 重载与关闭时的桥接生命周期处理
  • 支持配置重新生成
  • Discord ChatItem 渲染缓存预热
  • 记录了专有代码与第三方依赖项的通知
  • 紧凑打包的运行时 JAR 文件,包含通用模块、MySQL 存储模块、HikariCP 和 Connector/J;无需单独的存储或 JDBC 插件 JAR
  • 通过 plugin.yml 声明 Paper 外部运行时库
  • Velocity 外部库下载至 plugins/CoreChatX/libs,启动日志会显示库是已下载还是已存在
  • 自动修复缺失的默认项,适用于 Paper YAML 文件及 Velocity YAML/properties 文件
  • 独立 Paper 部署与 Velocity 代理部署的运行时数据所有权规则
  • 针对 Paper 与 Velocity JAR 对显式的混合版本警告
  • 启动后默认每 24 小时异步执行 Modrinth 更新检查
  • 稳定版推荐以及独立发布的实验性 Alpha/Beta 公告
  • 存储健康检查、已验证备份、迁移与回滚工具

更新检查器会在 Paper 上通知控制台和 OP(管理员)玩家,在 Velocity 上仅通知控制台。它从 Modrinth API 读取版本元数据,并通过 User-Agent 识别已安装的插件版本;它不会下载或安装插件更新。可以在 Paper 的 config.yml 或 Velocity 的 velocity-config.properties 中配置 update-check.interval-hours 或通过 update-check.enabled 禁用检查。

由 Paper 声明或由 Velocity 加载的运行库可能在初始启动期间需要访问互联网。

这些并非面向玩家的炫目功能,但它们让日常运营变得更容易信任和维护。


验证状态

当前项目状态已通过以下测试:

  • 构建与测试通过
  • 发布打包检查
  • 独立 Paper 启动
  • Velocity 启动
  • 网络模式下的 Paper 启动
  • 命令检查
  • 配置重新生成检查
  • Discord 桥接检查
  • ChatItem 渲染与缓存检查
  • 实时 Paper 测试环境检查
  • 实时 Velocity 网络测试环境检查

未来方向

CoreChatX 旨在成长为更广泛的通信中心,服务于常见的服务器社交系统,例如:

  • 氏族与公会
  • 城镇与定居点
  • 领地与领土
  • 队伍与轻量级小组

目标是让聊天感知玩家实际建立的社区,同时保持通信集中、一致且易于使用。 这些是未来发展方向,并非当前版本中包含的额外集成。


总结

CoreChatX 为服务器提供:

  • 精美的公共聊天
  • Kyori Adventure MiniMessage 格式化
  • 基于 PlaceholderAPI 的动态模板
  • 持久化昵称
  • 传统格式兼容性
  • 交互式关键词
  • @提及与提示音
  • 频道与频道快捷方式
  • 私聊消息
  • 管理工具
  • ChatItem 预览
  • 聊天气泡
  • 玩家设置
  • 多语言支持
  • Discord 与 Telegram 桥接
  • Discord 账号绑定及可选登录门控
  • Discord 连接、事件与服务器状态嵌入
  • Discord ChatItem 图片渲染、玩家列表命令、控制台频道、频道描述、自定义表情符号及附件转发
  • 独立 Paper 支持
  • Velocity 网络支持
  • 可选 MySQL 存储,附带备份、迁移与回滚工具
  • 个人频道的持久化与可见性控制
  • Modrinth 稳定版与实验版更新通知

简而言之,CoreChatX 适用于希望通信体验更具设计感的服务器。

如果你的聊天设置需要多个插件、多个桥接配置以及额外的占位符胶水代码才能生成一条一致的聊天消息,那么 CoreChatX 正是为此类场景打造,旨在简化这一体验。

也可尝试


CoreToolsX logo
      CoreToolsX      


CoreArmorX logo
      CoreArmorX      


CoreStructuresX logo
   CoreStructuresX   


CoreCaseX logo
      CoreCaseX      


CoreExtractionX logo
   CoreExtractionX   

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源