RelayLine
RelayLine 是一款轻量级的 Velocity 插件,专为 Minecraft 网络设计,旨在实现干净的跨服务器聊天,而无需替换、扁平化或干扰各个后端服务器本地的聊天格式。
它专为每个服务器拥有独立身份、权限组(ranks)、前缀、颜色和聊天风格的网络打造。你的生存服务器可以保留其生存模式的格式,你的监狱服务器可以保留监狱权限组和声望格式,大厅也可以保留其独特的聊天风格。RelayLine 仅将干净的全球聊天消息副本中继给其他后端服务器上的玩家。
玩家当前所在的服务器仍会显示来自该服务器自身聊天插件的正常本地聊天消息。
远程消息示例
[Survival] Zenova > hello
[Prison] BobJunior > Oh hey!
[Lobby] Noob123 > how do I join a server
其他后端服务器上的玩家将看到中继的消息,而发送者所在的后端服务器上的玩家将继续看到该服务器输出的正常本地聊天内容。
功能
- 仅限 Velocity 代理插件
- 保持后端服务器聊天格式不变
- 仅向其他后端服务器中继聊天
/global 和 /local 玩家聊天模式
- 支持 MiniMessage 用于中继消息、服务器别名和通知
- 服务器切换通知
- 仅限大厅的加入通知
- 来自任何后端服务器的离开通知
- 玩家可通过
/servernotices 切换开关、加入和离开通知
- 中继聊天和通知的控制台日志记录
- 通过
/relayline reload 重载命令
- 简单的权限支持,用于切换和重载命令
- 无必需依赖项
为什么使用 RelayLine?
许多跨服务器聊天插件试图完全控制整个网络的聊天。这虽然有用,但如果你的后端服务器已经拥有自己的聊天插件、权限组前缀/后缀、声望标签或自定义格式,可能会导致问题。
RelayLine 采取了一种更轻量的方法。
它允许每个后端服务器保持其本地聊天原封不动,同时当玩家选择使用全局模式时,仍允许他们在整个网络中跨服务器发言。
这使得它非常适合具有不同游戏模式的 Minecraft 网络。
格式示例
RelayLine 使用 MiniMessage 进行中继格式化。
format=<gray>[</gray>%server_name%<gray>]</gray> <aqua>%player%</aqua> <gray>></gray> <white>%message%</white>
server-alias.lobby=<aqua>Lobby</aqua>
server-alias.survival=<green>Survival</green>
server-alias.prison=<red>Prison</red>
可用的中继占位符:
%server_name%
%server%
%player%
%message%
玩家名称和消息将作为纯文本插入,因此玩家无法在中继聊天中注入 MiniMessage 标签。
服务器通知
RelayLine 可以在玩家在后端服务器之间移动、通过大厅加入或从任何服务器离开时显示小型网络通知。
server-switch-notices-enabled=true
default-see-server-switch-notices=true
server-switch-format=<dark_gray>(<gold>*</gold><dark_gray>) <gray>%player% <dark_gray>(<gold>%old_server%->%new_server%<dark_gray>)
join-leave-notices-enabled=true
join-notice-server=lobby
leave-notice-server=*
join-notice-format=<dark_gray>(<green>+</green><dark_gray>) <gray>%player%</gray>
leave-notice-format=<dark_gray>(<red>-</red><dark_gray>) <gray>%player%</gray>
玩家可以使用 /servernotices 来切换是否查看服务器切换、加入和离开通知。
安装
- 下载 RelayLine jar 文件。
- 将 jar 文件放入 Velocity 代理的
plugins 文件夹中。
- 重启 Velocity。
- 编辑生成的配置文件:
plugins/relayline/config.properties
- 确保你的服务器别名与
velocity.toml 中的服务器名称匹配。
- 修改配置后运行
/relayline reload,或者重启 Velocity。
RelayLine 应仅安装在你的 Velocity 代理上。
请勿将其安装到后端 Paper、Spigot、Purpur 或 Folia 服务器上。
从 LocalGlobalChat 升级
如果你是从预发布版本 LocalGlobalChat 升级,请先删除旧的 LocalGlobalChat-*.jar 文件。
RelayLine 将在首次启动时从以下位置复制缺失的数据文件:
plugins/localglobalchat
到:
plugins/relayline
命令
| 命令 |
描述 |
/global |
启用你消息的跨服务器中继 |
/local |
仅将你的消息限制在当前服务器 |
/servernotices |
切换开关、加入和离开通知 |
/switchalerts |
/servernotices 的别名 |
/serveralerts |
/servernotices 的别名 |
/relayline reload |
重载配置 |
/rl reload |
/relayline reload 的别名 |
/localglobalchat reload |
/relayline reload 的传统别名 |
/lgc reload |
/relayline reload 的传统别名 |
权限
| 权限 |
描述 |
relayline.toggle |
当启用权限检查时,允许玩家使用 RelayLine 切换命令 |
relayline.reload |
允许访问重载命令 |
仅在配置中启用了以下内容时,才需要 relayline.toggle:
require-permission=true
如果你使用 LuckPerms,请在你的 Velocity 或代理 LuckPerms 实例上设置这些权限:
/lp group default permission set relayline.toggle true
/lp group admin permission set relayline.reload true
重要提示
RelayLine 会尊重 Velocity 已标记为取消或拒绝的聊天消息。
如果你的静音系统仅在后端服务器上运行,并且未取消 Velocity 的聊天事件,则应使用代理端的静音设置,或在依赖全局中继之前仔细测试你的静音插件。
RelayLine 并非 Discord 桥接工具。它可以与 DiscordSRV 或类似插件很好地配合使用,但 Discord 链接功能应单独处理。
RelayLine
RelayLine is a lightweight Velocity plugin for Minecraft networks that want clean cross-server chat without replacing, flattening, or interfering with each backend server's local chat formatting.
It is designed for networks where each server has its own identity, ranks, prefixes, colours, and chat style. Your Survival server can keep its Survival formatting, your Prison server can keep prison ranks and prestige formatting, and your Lobby can keep its own chat style. RelayLine simply relays a clean copy of global chat messages to players on other backend servers.
The player’s current server still sees the normal local chat message from that server’s own chat plugin.
Example Remote Message
[Survival] Zenova > hello
[Prison] BobJunior > Oh hey!
[Lobby] Noob123 > how do I join a server
A player on another backend server would see the relayed message, while players on the sender’s current backend server continue to see the normal local chat output from that server.
Features
- Velocity-only proxy plugin
- Keeps backend server chat formatting untouched
- Relays chat to other backend servers only
/global and /local player chat modes
- MiniMessage support for relay messages, server aliases, and notices
- Server switch notices
- Lobby-only join notices
- Leave notices from any backend server
- Player toggle for switch, join, and leave notices with
/servernotices
- Console logging for relayed chat and notices
- Reload command with
/relayline reload
- Simple permission support for toggle and reload commands
- No required dependencies
Why Use RelayLine?
Many cross-server chat plugins try to fully control chat across the entire network. That can be useful, but it can also cause problems if your backend servers already have their own chat plugins, rank prefixes, suffixes, prestige tags, or custom formatting.
RelayLine takes a lighter approach.
It lets each backend server keep its own local chat exactly as it is, while still allowing players to speak globally across the network when they choose to use global mode.
This makes it ideal for Minecraft networks with different game modes.
Example Format
RelayLine uses MiniMessage for relay formatting.
format=<gray>[</gray>%server_name%<gray>]</gray> <aqua>%player%</aqua> <gray>></gray> <white>%message%</white>
server-alias.lobby=<aqua>Lobby</aqua>
server-alias.survival=<green>Survival</green>
server-alias.prison=<red>Prison</red>
Available relay placeholders:
%server_name%
%server%
%player%
%message%
Player names and messages are inserted as plain text, so players cannot inject MiniMessage tags into relayed chat.
Server Notices
RelayLine can show small network notices when players move between backend servers, join through the lobby, or leave from any server.
server-switch-notices-enabled=true
default-see-server-switch-notices=true
server-switch-format=<dark_gray>(<gold>*</gold><dark_gray>) <gray>%player% <dark_gray>(<gold>%old_server%->%new_server%<dark_gray>)
join-leave-notices-enabled=true
join-notice-server=lobby
leave-notice-server=*
join-notice-format=<dark_gray>(<green>+</green><dark_gray>) <gray>%player%</gray>
leave-notice-format=<dark_gray>(<red>-</red><dark_gray>) <gray>%player%</gray>
Players can use /servernotices to toggle whether they see server switch, join, and leave notices.
Installation
- Download the RelayLine jar.
- Put the jar in your Velocity proxy’s
plugins folder.
- Restart Velocity.
- Edit the generated config file:
plugins/relayline/config.properties
- Make sure your server aliases match the server names in your
velocity.toml.
- Run
/relayline reload after making config changes, or restart Velocity.
RelayLine should only be installed on your Velocity proxy.
Do not install it on backend Paper, Spigot, Purpur, or Folia servers.
Upgrading From LocalGlobalChat
If you are upgrading from the pre-release LocalGlobalChat build, remove the old LocalGlobalChat-*.jar file first.
RelayLine will copy missing data files from:
plugins/localglobalchat
into:
plugins/relayline
on first startup.
Commands
| Command |
Description |
/global |
Enables cross-server relay for your messages |
/local |
Keeps your messages on the current server only |
/servernotices |
Toggles switch, join, and leave notices |
/switchalerts |
Alias for /servernotices |
/serveralerts |
Alias for /servernotices |
/relayline reload |
Reloads the config |
/rl reload |
Alias for /relayline reload |
/localglobalchat reload |
Legacy alias for /relayline reload |
/lgc reload |
Legacy alias for /relayline reload |
Permissions
| Permission |
Description |
relayline.toggle |
Allows players to use RelayLine toggle commands when permission checking is enabled |
relayline.reload |
Allows access to the reload command |
relayline.toggle is only required if this is enabled in the config:
require-permission=true
If you use LuckPerms, set these permissions on your Velocity or proxy LuckPerms instance:
/lp group default permission set relayline.toggle true
/lp group admin permission set relayline.reload true
Important Notes
RelayLine respects chat messages that Velocity has already marked as cancelled or denied.
If your mute system only runs on a backend server and does not cancel the Velocity chat event, you should use a proxy-side mute setup or carefully test your mute plugin before relying on global relay.
RelayLine is not a Discord bridge. It works nicely alongside DiscordSRV or similar plugins, but Discord linking should be handled separately.
评论 0
登录后参与评分
还没有评论,来抢沙发吧