Network appearance
MOTD, tab list, maintenance mode, chat format and every text players see, set once for the whole network.
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
[motd]
line1 = "§b§lMUTECLOUD §7| §fYour network"
line2 = "§7Version 1.8 to 26.3 §7| §f{online}§7 online"
max_players = 100Both 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
[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[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.
Maintenance for one group
maintenance BedWars on
maintenance BedWars add Tester
maintenance BedWars remove Tester
maintenance BedWars offThe network stays open, only the servers of that group are closed. Anyone who wants to go there
sees group_maintenance from the texts, unless they are on the whitelist, on the group's own
list or hold the right from bypass_permission. The group's list suits testers of a new game
mode who have no special rights anywhere else. Players already on the group stay there.
maintenance without arguments shows which groups are under maintenance, maintenance BedWars
shows the group's list, and in the dashboard every group has its own switch. It is stored in the
group file as maintenance = true and maintenance_players = ["Tester"].
Chat
[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 |
group_maintenance | a player wants to join a group under maintenance, {group} is its name |
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 mapWithout --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
[notify]
enabled = false
permission = "mutecloud.notify"
starting = "§7[§bCloud§7] §f{service} §7is starting"
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 starts, is ready or stops. An empty
text switches the respective message off. {service} and {group} are available.
Who may use /mutecloud in game
[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
[compat]
version_check = falseWhen 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.
Shield
The [shield] section controls the built-in shield in front of the
proxies. Its limits apply immediately, switching it on or off only takes effect when the
proxies restart.