Proxy and network

Bridge's proxy login checks, maintenance mode, MOTDs, staff notices, network settings, server travel commands and the audit log.

Joining the network

When a player connects to the proxy, Bridge checks in this order:

Client version. If BRIDGE_ALLOWED_PROTOCOLS is set, other versions are turned away. The screen names the versions in BRIDGE_VERSION_LABEL and your domain.
Maintenance. While it is on, only whitelisted players get in.
The player's record. Catalyst turns away a player with an active ban or blacklist. Ban evasion is checked once they're in. See Punishments.

If Catalyst can't be reached, players are turned away unless BRIDGE_FAIL_OPEN is true. Each Paper server checks maintenance and the player's record again when they join it.

Permission checks on the proxy use the player's Bridge permissions, so you can grant proxy command nodes through ranks. Nodes scoped to a server apply when the scope is the proxy's BRIDGE_PROXY id.

Maintenance

Command	What it does
`/maintenance`	Shows whether maintenance is on, the reason and how many players are whitelisted.
`/maintenance on`	Turns maintenance on. Also `/maintenance enable`.
`/maintenance off`	Turns maintenance off. Also `/maintenance disable`.
`/maintenance toggle`	Switches it.
`/maintenance reason <reason>`	Sets the reason shown on the maintenance screen.
`/maintenance whitelist add <player>`	Lets a player in during maintenance.
`/maintenance whitelist remove <player>`	Removes them.
`/maintenance whitelist list`	Lists the whitelist.

These need bridge.command.maintenance. /manageproxy has the same switch and whitelist as buttons. Only the whitelist lets players through; rank and permission don't.

MOTD and server list

Set the MOTD in /networkmetadata or /manageproxy. It is two lines of MiniMessage.

Start a line with <center> to centre it, or set BRIDGE_MOTD_CENTERED=true to centre every line.
<primary> and <secondary> use the network colours.
The legacy MOTD is shown to clients older than 1.16. Empty uses the normal MOTD with simpler colours.
The maintenance MOTD replaces both while maintenance is on, and the version text in the server list changes to the server list label, Maintenance by default.
With no MOTD set, the proxy shows the network name and domain. That fallback is presence.fallbackMotd in the proxy's plugins/Bridge/messages.yml.

BRIDGE_PLAYER_CAP sets the maximum player count shown.

Staff notices

Players with bridge.staff see a line when another staff member joins the network, leaves it or switches server. Only staff on the same proxy see it. The lines are under staff in the proxy's messages.yml.

Network settings

/networkmetadata (also /netmeta) opens the network-wide settings. It needs bridge.command.networkmetadata.

Setting	What it is used for
Server name	The tab list header and the fallback MOTD.
Primary and secondary colour	`<primary>` and `<secondary>` in messages, menus and MOTDs.
Domain	The appeal link on the ban screen, the fallback MOTD and the blocked-version screen.
Store, Discord, Twitter	Links saved for the network. Sentry's freeze message uses the Discord link.
Rank prefixes	Shows or hides rank prefixes in the tab list and on nametags.
Forbidden commands	Commands nobody can run on your Paper servers, except players with `bridge.command.bypass`.
MOTD	The server list MOTD.

The menu also has an Allowed When Banned list. This version of Bridge doesn't use it.

/manageproxy (also /proxy) opens maintenance, the whitelist, the ban, blacklist, ban evasion and maintenance screens, the MOTDs and the network settings. It needs bridge.command.manageproxy.

Moving between servers

Command	Permission	What it does
`/servers`	`bridge.command.servers`	Opens every server with its status, group, player count and client versions. Click an online server to join it. Also `/serverlist`, `/sl`.
`/server <id>`	`bridge.command.server`	Sends you to a server. Also `/connect`.
`/hub`	none	Sends you to the online server with the fewest players in the `hubServer` group from `bridge.yml`. Also `/lobby`, `/leave`.
`/sendplayer <player> <server>`	`bridge.command.sendplayer`	Sends an online player to a server. Also `/send`.
`/jump <player>`	`bridge.command.jump`	Takes you to a player's server and teleports you to them. Also `/goto`.
`/list`	none	Lists players on this server and on servers in its group, sorted by rank. Also `/who`, `/players`.

On a server that is already in the hub group, /hub tells you you're in a hub already. In /list, players with bridge.hiddenranks also see hidden ranks in the header, and players with bridge.staff also see players hidden from them.

Regions

/region opens a menu of the regions in bridge.yml, and /region <id> moves you to one. Each region has:

Key	What it does
`id`	Matches `region` in a server's `kernel.yml`. The region you're on is marked as current.
`name`	Shown in the menu and messages.
`description`	Shown in the menu.
`host`, `port`	The address players are transferred to. Leave `host` empty to block moving there.
`icon`	A Minecraft item name for the menu icon. `compass` by default.
`texture`	A head texture used instead of the icon.
`permission`	Needed to see and use the region. Empty means everyone.

plugins/Bridge/bridge.yml

regions:
  - id: na
    name: North America
    description: Servers in New York
    host: na.example.net
    port: 25565
    icon: compass
    texture: ""
    permission: ""

Staff lookups

Command	Permission	What it does
`/user info <player>`	`bridge.command.user`	Shows a player's rank, online status, first and last seen, logins and permission count. `/whois` works in place of `/user`.
`/seen <player>`	`bridge.command.seen`	Shows when a player was last online. Also `/lastseen`.
`/alts <player>`	`bridge.command.alts`	Lists accounts sharing an IP address with a player. Also `/accounts`.
`/removealts <player>`	`bridge.command.removealts`	Clears the addresses linking a player to their alts. Also `/clearalts`.
`/versions`	`bridge.command.versions`	Shows how players split across client versions. Also `/clientversions`.
`/auditlog`	`bridge.command.auditlog`	Browses the audit log of grants, punishments, rank edits and other staff actions by category. Also `/audit`.

Operators

/oplist (also /operators) opens the network operator list. Add players with the button and click an entry to remove them. It needs bridge.command.oplist.