Network appearance

What a player sees of the network before and while playing lives in network.toml: MOTD, tab list, maintenance, chat and the texts the proxy uses when it moves or rejects players. The cloud reads the file every two seconds and pushes every change to all proxies and servers immediately, no restart required. network shows the current state.

Colours are written with & or §, both work, including hex colours in the format §x§r§r§g§g§b§b. The one exception is the chat format on Paper, which only understands &.

If the file contains a typo or an unknown field, the cloud discards it entirely and falls back to the defaults. Among other things this switches off an active maintenance mode, so check with network after every change that it arrived. Commands such as maintenance or admin rewrite the file and drop comments in the process.

MOTD

network.toml

[motd]
line1 = "§b§lMUTECLOUD §7| §fYour network"
line2 = "§7Version 1.8 to 26.3 §7| §f{online}§7 online"
max_players = 100

Both lines support {online} and {max}. The player count in the server list is the real number in the network, max_players the displayed limit.

Tab list

network.toml

[tablist]
enabled = true
header = "\n §b§lMUTECLOUD \n §7{online} players in the network \n"
footer = "\n §7You are on §f{server} \n §7Latency §f{ping}ms \n"

Header and footer know {online}, {max}, {player}, {server}, {ping} and {proxy}. The proxy rewrites them every three seconds and shortly after every server switch. If you design the tab list with your own plugin, set enabled = false.

Maintenance

maintenance on
maintenance add MuteBefehl
maintenance remove MuteBefehl
maintenance off

network.toml

[maintenance]
enabled = false
line1 = "§c§lMaintenance"
line2 = "§7Back soon"
kick = "§cThe network is under maintenance."
whitelist = ["MuteBefehl"]
bypass_permission = "mutecloud.maintenance.bypass"

While maintenance is on, the server list shows line1 and line2 instead of the MOTD. Anyone on the whitelist or holding the right from bypass_permission gets in, everyone else receives kick. When it is switched on, players without an exception are disconnected immediately. Names on the list are case insensitive.

Chat

network.toml

[chat]
enabled = false
format = "{prefix}{player}{suffix}&f: {message}"

When enabled, the bridge sets the chat format on every server using prefix and suffix from the ranks. Available are {prefix}, {player}, {suffix}, {rank} and {message}, where {rank} stays empty on servers up to 1.20.4. If you use your own chat plugin, leave this off.

Texts

[messages] holds the texts the proxy sends itself.

Field	When
`shutdown`	the cloud shuts down and disconnects every player
`no_server`	`/hub` finds no free lobby
`hub_already`	`/hub` on a server of the fallback group
`fallback_down`	a player arrives, but no lobby is running
`restart_warning`	a server is drained and the player moved
`wrong_version`	only with `[compat] version_check`, see below
`announce_format`	frame around `announce`, `{message}` is the text
`prefix`	before every reply to `/mutecloud` in game

On joining, a player lands on the emptiest server of the first group with fallback = true. If a player is kicked from a server, the proxy sends them to another lobby instead of disconnecting them.

Announcements

announce Starting in a moment
announce --title &bNew map

Without --title the text appears in chat inside announce_format, with --title as a title in the middle of the screen. If a proxy is running, the announcement goes through it to everyone, otherwise to each server individually.

Notifications for the team

network.toml

[notify]
enabled = false
permission = "mutecloud.notify"
started = "§7[§bCloud§7] §f{service} §7is ready"
stopped = "§7[§bCloud§7] §f{service} §7has stopped"

Players with the right are told in chat when a server is ready or stops. {service} and {group} are available.

Who may use `/mutecloud` in game

network.toml

[admins]
names = ["MuteBefehl"]
permission = "mutecloud.admin"

/mutecloud, with the aliases /mcloud and /cloud, is open to everyone listed here or holding the right. admin add <name> and admin remove <name> maintain the list from the console. What someone may actually run after that is governed by access.toml, see Security.

Version check

network.toml

[compat]
version_check = false

When enabled, the proxy lets a player only onto servers whose version matches their client and shows wrong_version with {client} and {server} otherwise. Without Via plugins on the servers this is the cleaner approach; with them, leave it off.

Clients

The sections [labymod] and [badlion] belong to the addons and only take effect once the respective addon is installed.

Network appearance

On this page