CrossChat

插件

· 作者 ethan08921

将 CrossChat 的所有消息链接为一条

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

最新 1.3.8 · 26.3 · Velocity

一键开服(送7天)

适用于 Velocity 的简单、轻量级跨服务器聊天插件。

CrossChat 是一款 Velocity 3.x 代理插件,可连接您网络中的聊天功能,使不同后端服务器的玩家能够通过单一的全局聊天频道实时通信。

无论您的网络包含大厅、生存、农场、小游戏还是多个游戏服务器,CrossChat 都能让所有人保持联系。


✨ 功能特性

  • ? 跨服务器聊天 — 来自任何参与后端服务器发送的消息都会实时广播到整个网络的玩家。
  • ? 完全自定义聊天格式 — 直接从 config.yml 配置全局聊天的外观。
  • ?️ 支持传统代码与 MiniMessage — 使用传统的 & 颜色代码或现代的 Adventure MiniMessage 格式。
  • ? LuckPerms 集成 — 当在代理上安装 LuckPerms 时,自动显示 LuckPerms 前缀。
  • ?️ 服务器过滤 — 精确选择哪些后端服务器参与全局聊天。
  • ⚡ 轻量级 — 在代理上以极小的开销运行,不包含不必要的功能。
  • ? 安全的消息处理 — 玩家消息作为纯文本插入,防止玩家注入格式化代码。
  • ? 后端占位符支持 — 通过 CrossChat Backend Placeholders 扩展包,使用后端插件提供的占位符值来扩展 CrossChat。

? 要求

要求 版本
Java 17 或更高
Velocity 3.x
LuckPerms (可选) 5.x
SignedVelocity 1.4.x

CrossChat 运行在 Velocity 代理 上。您无需在每个后端服务器上安装 CrossChat。


? 安装

  1. 下载最新的 crosschat-x.x.x.jar。
  2. 将其放入 Velocity 的 plugins/ 文件夹中。
  3. 重启 Velocity 代理。
  4. CrossChat 将自动创建其配置文件。
  5. 打开 plugins/velocityglobalchat/config.yml。
  6. 配置聊天格式和参与的服务器。
  7. 重启代理。

就是这样——CrossChat 已准备就绪。


⚙️ 配置

配置文件位于:

plugins/velocityglobalchat/config.yml

示例:

# 启用或禁用 CrossChat
enabled: true

# 全局聊天格式
#
# 占位符:
#   {server}  - 后端服务器名称
#   {player}  - 玩家的 Minecraft 用户名
#   {prefix}  - LuckPerms 前缀
#   {message} - 聊天消息
#
# 请使用 & 颜色代码 OR MiniMessage。
# 不要混合使用这两种样式。
format: "&8[&b{server}&8] &7{prefix}{player}&f: {message}"

# 参与全局聊天的后端服务器。
#
# 未在此列出的服务器上的玩家将不会
# 发送或接收全局聊天消息。
#
# 留空以包含所有服务器。
servers:
  - hub
  - survival
  - farming

? 聊天格式化

CrossChat 同时支持传统的 Minecraft 颜色代码和 Adventure MiniMessage。

传统 & 代码

&8[&b{server}&8] &7{prefix}{player}&f: {message}

示例:

[ SURVIVAL ] [Admin] Ethan: Hello everyone!

MiniMessage

<dark_gray>[<aqua>{server}</aqua>]</dark_gray> <gray>{prefix}{player}</gray><white>: {message}</white>

可用占位符

占位符 描述
{server} 玩家当前连接的后端服务器
{player} 玩家的 Minecraft 用户名
{prefix} 玩家的 LuckPerms 前缀
{message} 玩家的聊天消息

安全性: 玩家消息内容始终作为纯文本插入,无论选择何种格式化系统。玩家无法在全局聊天中注入额外的颜色代码或 MiniMessage 标签。


? 后端占位符

想要使用运行在后端服务器上的插件信息吗?

使用 CrossChat Backend Placeholders 扩展 CrossChat,添加由后端提供的占位符值。

这允许您显示诸如:

  • 玩家等级
  • 经济余额
  • 当前世界
  • 等级
  • 阵营
  • 统计数据
  • 服务器特定信息
  • 其他 PlaceholderAPI 值

该扩展包与 CrossChat 协同工作,而非替换它。


?️ 服务器过滤

您可以精确控制哪些服务器参与全局聊天。

例如:

servers:
  - hub
  - survival
  - farming

hub、survival 和 farming 上的玩家可以发送和接收全局消息。

未列出的服务器将被排除在全局聊天之外。

若要包含所有连接的服务器,请将列表留空:

servers: []

这对于某些服务器应保持隔离的网络非常有用,例如私有实例、管理服务器或独立小游戏。


? 工作原理

CrossChat 完全在 Velocity 代理上运行。

  1. 玩家发送聊天消息。
  2. CrossChat 在代理上接收 PlayerChatEvent。
  3. CrossChat 确定玩家当前的后端服务器。
  4. 配置的聊天格式使用 Adventure 进行渲染。
  5. 消息发送给参与服务器上的玩家。
  6. 原始聊天事件被拒绝,防止后端服务器接收并重复该消息。

这意味着 CrossChat 不需要将同一条消息转发到每个后端服务器。


? 专为 Velocity 设计

CrossChat 是专门为 Velocity 代理和 Adventure API 构建的。

您的后端服务器不需要单独安装 CrossChat —— 代理负责处理全局聊天系统。


?️ 故障排除

玩家看不到全局消息

请检查:

  • CrossChat 已安装在 Velocity 上。
  • 玩家的服务器已包含在 servers 列表中。
  • 插件已启用。
  • 没有冲突的聊天插件取消或修改聊天事件。

{prefix} 占位符为空

请确保 LuckPerms 已安装并在 Velocity 代理 上运行,并且玩家已被分配了前缀。

LuckPerms 是可选的,因此当 LuckPerms 不可用时,{prefix} 将为空。

我的格式不生效

请确保您每次只使用一种格式化系统。

使用以下任一方式:

&8[&b{server}&8] ...

或者:

<dark_gray>[<aqua>{server}</aqua>] ...

不要在同一种格式中混用传统颜色代码和 MiniMessage 标签。


? 许可证

CrossChat 根据 MIT 许可证 发布。

请参阅仓库中的 LICENSE 文件以获取完整的许可证文本。

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源