Home›Java›Mods›RelayLine
RelayLine
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

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.

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.

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

  5. Make sure your server aliases match the server names in your velocity.toml.

  6. 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.


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


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.
Quick facts

Install steps are the general flow for this file type — How to install Minecraft Java mods & modpacks walks through it step by step.

RelayLine is a free Minecraft Java mod. Compatible with Minecraft 1.20, 1.20.6, 1.21, 26.1 and newer. Downloaded 7 times (via Spigot). Download it and open it directly in the game.

Explore more