适用于 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。
? 安装
- 下载最新的
crosschat-x.x.x.jar。 - 将其放入 Velocity 的
plugins/文件夹中。 - 重启 Velocity 代理。
- CrossChat 将自动创建其配置文件。
- 打开
plugins/velocityglobalchat/config.yml。 - 配置聊天格式和参与的服务器。
- 重启代理。
就是这样——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 代理上运行。
- 玩家发送聊天消息。
- CrossChat 在代理上接收
PlayerChatEvent。 - CrossChat 确定玩家当前的后端服务器。
- 配置的聊天格式使用 Adventure 进行渲染。
- 消息发送给参与服务器上的玩家。
- 原始聊天事件被拒绝,防止后端服务器接收并重复该消息。
这意味着 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 文件以获取完整的许可证文本。
Simple, lightweight cross-server chat for Velocity.
CrossChat is a Velocity 3.x proxy plugin that connects chat across your network, allowing players on different backend servers to communicate through a single global chat channel in real time.
Whether your network has a lobby, survival, farming, minigame, or multiple game servers, CrossChat keeps everyone connected.
✨ Features
- ? Cross-server chat — Messages sent from any participating backend server are broadcast to players across your network in real time.
- ? Fully customisable chat format — Configure your global chat appearance directly from
config.yml. - ?️ Legacy & MiniMessage support — Use traditional
&colour codes or modern Adventure MiniMessage formatting. - ? LuckPerms integration — Automatically display LuckPerms prefixes when LuckPerms is installed on your proxy.
- ?️ Server filtering — Choose exactly which backend servers participate in global chat.
- ⚡ Lightweight — Runs on the proxy with minimal overhead and no unnecessary features.
- ? Safe message handling — Player messages are inserted as plain text, preventing players from injecting formatting codes.
- ? Backend placeholder support — Extend CrossChat with the CrossChat Backend Placeholders addon to use placeholder values provided by backend plugins.
? Requirements
| Requirement | Version |
|---|---|
| Java | 17 or later |
| Velocity | 3.x |
| LuckPerms (optional) | 5.x |
| SignedVelocity | 1.4.x |
CrossChat runs on the Velocity proxy. You do not need to install CrossChat on every backend server.
? Installation
- Download the latest
crosschat-x.x.x.jar. - Place it into your Velocity
plugins/folder. - Restart your Velocity proxy.
- CrossChat will automatically create its configuration.
- Open
plugins/velocityglobalchat/config.yml. - Configure your chat format and participating servers.
- Restart the proxy.
That's it — CrossChat is ready to use.
⚙️ Configuration
The configuration file is located at:
plugins/velocityglobalchat/config.yml
Example:
# Enable or disable CrossChat
enabled: true
# Global chat format
#
# Placeholders:
# {server} - backend server name
# {player} - player's Minecraft username
# {prefix} - LuckPerms prefix
# {message} - chat message
#
# Use either & colour codes OR MiniMessage.
# Do not mix both styles.
format: "&8[&b{server}&8] &7{prefix}{player}&f: {message}"
# Backend servers participating in global chat.
#
# Players on servers not listed here will not
# send or receive global chat messages.
#
# Leave empty to include every server.
servers:
- hub
- survival
- farming
? Chat Formatting
CrossChat supports both traditional Minecraft colour codes and Adventure MiniMessage.
Legacy & Codes
&8[&b{server}&8] &7{prefix}{player}&f: {message}
Example:
[ SURVIVAL ] [Admin] Ethan: Hello everyone!
MiniMessage
<dark_gray>[<aqua>{server}</aqua>]</dark_gray> <gray>{prefix}{player}</gray><white>: {message}</white>
Available Placeholders
| Placeholder | Description |
|---|---|
{server} |
The backend server the player is currently connected to |
{player} |
The player's Minecraft username |
{prefix} |
The player's LuckPerms prefix |
{message} |
The player's chat message |
Security: Player message content is always inserted as plain text, regardless of the selected formatting system. Players cannot inject additional colour codes or MiniMessage tags into global chat.
? Backend Placeholders
Want to use information from plugins running on your backend servers?
Use CrossChat Backend Placeholders to extend CrossChat with backend-provided placeholder values.
This can allow you to display things such as:
- Player ranks
- Economy balances
- Current worlds
- Levels
- Factions
- Statistics
- Server-specific information
- Other PlaceholderAPI values
The addon works alongside CrossChat rather than replacing it.
?️ Server Filtering
You can control exactly which servers participate in global chat.
For example:
servers:
- hub
- survival
- farming
Players on hub, survival, and farming can send and receive global messages.
Servers that aren't listed are excluded from global chat.
To include all connected servers, leave the list empty:
servers: []
This is useful for networks where certain servers should remain isolated, such as private instances, admin servers, or standalone minigames.
? How It Works
CrossChat operates entirely on the Velocity proxy.
- A player sends a chat message.
- CrossChat receives the
PlayerChatEventon the proxy. - CrossChat determines the player's current backend server.
- The configured chat format is rendered using Adventure.
- The message is sent to players on participating servers.
- The original chat event is denied, preventing the backend server from receiving and duplicating the message.
This means CrossChat does not need to forward the same message through every backend server.
? Designed for Velocity
CrossChat is built specifically around the Velocity proxy and Adventure API.
Your backend servers don't need a separate CrossChat installation — the proxy handles the global chat system.
?️ Troubleshooting
Players can't see global messages
Check that:
- CrossChat is installed on Velocity.
- The player's server is included in the
serverslist. - The plugin is enabled.
- There are no conflicting chat plugins cancelling or modifying the chat event.
The {prefix} placeholder is empty
Make sure LuckPerms is installed and running on the Velocity proxy, and that the player has a prefix assigned.
LuckPerms is optional, so {prefix} will simply be empty when LuckPerms isn't available.
My formatting isn't working
Make sure you're using one formatting system at a time.
Use either:
&8[&b{server}&8] ...
or:
<dark_gray>[<aqua>{server}</aqua>] ...
Do not mix legacy colour codes and MiniMessage tags in the same format.
? Licence
CrossChat is released under the MIT License.
See the repository's LICENSE file for the full licence text.
下载 CrossChat
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 CrossChat
下载 CrossChat
下载 CrossChat
下载 CrossChat
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 CrossChat
下载 CrossChat
下载 CrossChat
下载 CrossChat
下载 CrossChat
[1.3.8] — 2026-11-03
修复
- 修复了聊天格式中未正确解析旧版十六进制颜色的问题,包括
&#RRGGBB和&x&R&R&G&G&B&B代码,并支持将它们与其他旧版颜色代码混合使用。
更改
- 将代理版本更新为
1.3.8。 - 记录了两种受支持的旧版十六进制颜色格式。
已修复
- 修复了因 Velocity 无法拒绝签名聊天消息而导致玩家断开连接的问题。CrossChat 现在以非签名形式转发消息。
- 恢复了 Paper/Purpur 配套插件的
crosschat:suppress信号。如果配套插件不可用,CrossChat 将保留源服务器本地聊天内容不变,仅向其他参与服务器广播,从而避免在源服务器上产生重复的代理广播。 - 发送者已被排除在代理广播之外,以避免与客户端乐观本地聊天渲染重复。
- CrossChat 的聊天处理不再需要 SignedVelocity。
已更改
- 将代理版本更新至
1.3.7。 - 文档中补充了关于源服务器格式设置和本地回显抑制的 Paper 非签名聊天设置及配套插件行为说明。
关于这个资源的讨论、问题反馈与使用心得
还没有讨论,来发第一帖吧
你是这个资源的作者?登录后可认领此资源。
相似资源
插件
PacketEvents 是一款专为 Minecraft Java 版打造的协议库,旨在简化数据包的处理与传输。
插件
ExyliaPlugins 的库。
插件
通过对话框或铁砧界面帮助你的 Anthme
插件
自定义你的Minecraft头像!
插件
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
插件
为基于 Spigot/Paper/Folia 的服务器添加对 Vivecraft 的支持
评论 0
登录后参与评分
还没有评论,来抢沙发吧