Velocity-Chat 跨服聊天插件

Velocity-Chat
跨服聊天插件 — 仅需安装在 Velocity 代理端，子服务器无需任何插件或模组。
当前版本 v1.9.1 | 兼容 Velocity 1.8.x – 26.2（MC 1.7.x – 1.21.x+） | 许可证 MIT

概述

Velocity-Chat 是一款轻量级跨服聊天插件，专为 Velocity 代理端设计。安装后所有子服务器共享同一套聊天系统，玩家无需切换服务器即可与全服沟通。

核心优势：
仅代理端安装，子服零负担
支持跨服广播与 & 颜色代码
进服 / 切服 / 离服消息自动广播，支持服务器别名映射
跨服邀请 /yq，一键把好友拉进当前服务器
群组称号前缀系统
中英双语配置切换，热重载即生效
权限节点自动注册到 LuckPerms，开箱即用
国人开发 by LiquidTeam、YuHongChen

功能详解
跨服邀请（v1.9.0 新增）

玩家在任何子服使用 /yq，向全代理网络广播一条带可点击悬停提示的邀请消息，其他子服玩家点击"点击加入"即可直接传送到邀请者所在服务器。
悬停文本会正确显示目标服务器别名（如 点击进入 §a生存服），不会暴露占位符字面量
该修复在 v1.9.1 中完成；v1.9.0 的悬停文本曾错误显示为 {1}
跨服聊天

玩家使用 /br 在任何子服发送消息，全代理网络内均可看到。支持 & 颜色代码，让聊天内容更醒目。
v1.6.0 起优化 Tab 补全：玩家输入内容后不再弹出无关补全提示
进出服广播

自动广播以下事件，可分别配置开关与可见性：
玩家进服
玩家切换子服
玩家离服

支持服务器别名映射，显示名称可自定义。
稳定性说明：
v1.5.0 修复断线时偶尔显示 unknown 的问题（会缓存玩家最后所在服务器），并优化断线消息可靠性
v1.7.0 起，被封禁且在连接时被拒绝、从未进入后端服务器的玩家，不会再触发离开消息广播
v1.4.0 起控制台不再重复打印进出服消息
群组称号

通过权限为玩家设置称号前缀，聊天时自动显示在玩家名前。称号支持 & 颜色代码，便于区分 VIP、管理、普通玩家等身份组。
权限细分

提供 velocitychat.admin. 子权限节点，并与 LuckPerms 等权限插件无缝配合。
v1.4.0 起新增细分节点：velocitychat.admin.create / .group.join / .group.remove / .group.settitle / .group.delete / .group.list / .reload
玩家进服时权限节点会自动注册到 LuckPerms，无需手动添加
冷却控制

可配置 /br 聊天冷却时间，防止刷屏。管理员可绕过冷却限制。
消息可见性

进服广播支持三种模式：
ALL — 全体可见（默认）
ADMIN — 仅管理员可见
NONE — 关闭
中英双语

配置文件一行切换语言，无需重启服务器，仅需 /vchat reload 热重载即可生效。

命令列表
玩家命令

| 命令 | 说明 | 权限 |
| :--- | :--- | :--- |
| /br | 发送跨服聊天消息，支持 & 颜色代码 | 所有玩家 |
| /yq | 发送跨服邀请，全服玩家可点击加入你所在服务器 | 所有玩家 |
| /vchat local | 仅向本地服务器发送聊天消息 | 所有玩家 |
| /vchat broadcast | 发送全局广播消息（同 /br） | 所有玩家 |
| /glist | 查看全代理在线玩家列表 | 所有玩家 |
管理员命令

| 命令 | 说明 | 权限 |
| :--- | :--- | :--- |
| /vchat create group | 创建称号群组 | velocitychat.admin.create |
| /vchat group join | 将玩家加入称号群组 | velocitychat.admin.group.join |
| /vchat group remove | 将玩家移出称号群组 | velocitychat.admin.group.remove |
| /vchat group settitle | 设置群组称号前缀（支持 & 颜色） | velocitychat.admin.group.settitle |
| /vchat group delete | 删除称号群组 | velocitychat.admin.group.delete |
| /vchat group list | 列出所有称号群组 | velocitychat.admin.group.list |
| /vchat reload | 热重载配置文件 | velocitychat.admin.reload |

权限节点

| 权限 | 默认 | 说明 |
| :--- | :--- | :--- |
| velocitychat.use | 所有玩家 | 使用跨服聊天 |
| velocitychat.invite | 所有玩家 | 使用跨服邀请 /yq |
| velocitychat.admin. | OP | 管理员权限组（含全部子节点） |
| velocitychat.admin.create | OP | 创建称号群组 |
| velocitychat.admin.group.join | OP | 将玩家加入群组 |
| velocitychat.admin.group.remove | OP | 将玩家移出群组 |
| velocitychat.admin.group.settitle | OP | 设置群组称号前缀 |
| velocitychat.admin.group.delete | OP | 删除称号群组 |
| velocitychat.admin.group.list | OP | 列出称号群组 |
| velocitychat.admin.reload | OP | 热重载配置 |
| velocitychat.bypass.cooldown | OP | 绕过聊天冷却限制 |

配置文件

配置文件位于 plugins/velocity-chat/config.yml，主要选项如下：
语言设置: zh(中文) / en(英文)
language: zh
跨服聊天前缀
chat-prefix: "&b[全局]&r"
进服消息
join-message: "&a[+] %player% 加入了服务器"
join-visible: ALL # ALL / ADMIN / NONE
离服消息
leave-message: "&c[-] %player% 离开了服务器"
leave-visible: ALL
切服消息
switch-message: "&e[~] %player% 切换到了 %server%"
switch-visible: NONE
聊天冷却(秒)，0 为关闭
cooldown-seconds: 3
跨服邀请是否启用
invite-enabled: true
服务器别名映射
server-aliases:
lobby: "&e大厅"
survival: "&a生存服"
minigame: "&6小游戏"

安装步骤
从 Modrinth 下载 Velocity-Chat 最新版 JAR（v1.9.1）
将 JAR 放入 Velocity 的 plugins/ 目录
重启 Velocity 代理服务器
插件自动生成配置文件，按需修改后执行 /vchat reload 热重载

依赖要求

| 依赖 | 说明 |
| :--- | :--- |
| Velocity 3.3.0+（兼容 26.2） | 代理端核心 |
| LuckPerms（可选但推荐） | 权限管理；v1.4.0+ 权限节点会自动注册 |

更新记录
v1.9.1
修复 /yq 邀请悬停提示占位符未替换的问题：鼠标悬停"点击加入"不再显示字面量 {1}，正确显示目标服务器名称（如 点击进入 §a生存服）
v1.9.0
新增跨服邀请功能 /yq：玩家可在任意子服发送邀请，其他子服玩家点击即可加入

作者与许可
作者： YuHongChen (LiquidTeam)
源代码： 插件内置 GitHub 链接（v1.8.0+）
许可： MIT License
联系方式： QQ 1464670605

制作 LT-YHC