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

1. Download the RelayLine jar.
2. Put the jar in your Velocity proxy’s plugins folder.
3. Restart Velocity.
4. Edit the generated config file:

plugins/relayline/config.properties

1. Make sure your server aliases match the server names in your velocity.toml.
2. 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.

---