Punishments
Warn, kick, mute, ban and blacklist players with Bridge, silently or not, and manage history, revokes, ban screens and ban evasion.
Punishment types
| Type | What it does |
|---|---|
| Warn | Sends the player a warning and records it. |
| Kick | Kicks the player. They must be on the same server as you. |
| Mute | Stops the player using public chat. Temporary or permanent. |
| Ban | Stops the player joining. Temporary or permanent. |
| Blacklist | Stops the player joining, with its own screen. Permanent from the command, any length from the menu. |
Bans and blacklists are checked when a player joins the proxy and again on every Paper server. A new ban or blacklist kicks the player from the server they are on.
You can only punish players ranked below you. The console has no limit.
Commands
| Command | What it does |
|---|---|
/warn <player> <reason> | Warns a player. |
/kick <player> <reason> | Kicks a player on your server. |
/mute <player> <reason> | Mutes permanently. |
/tempmute <player> <duration> <reason> | Mutes for a time. |
/ban <player> <reason> | Bans permanently. |
/tempban <player> <duration> <reason> | Bans for a time. |
/blacklist <player> <reason> | Blacklists permanently. |
/unmute <player> <reason> | Lifts a mute. |
/unban <player> <reason> | Lifts a ban. |
/unblacklist <player> <reason> | Lifts a blacklist. |
/history <player> | Lists every punishment a player has had, in chat. |
/punishments <player> | Opens the player's history as a menu. |
/checkpunishment <id> | Prints one punishment by its id. |
A reason is always required. Durations combine w, d, h, m and s, like 7d or 1d12h. perm makes a temp command permanent, which needs the .permanent node.
Silent punishments
Add --silent anywhere in the reason:
/tempban Steve 7d Cheating --silentNormally, players on the server where you issue the punishment see an announcement, unless they turned off the Bans chat setting in Toolkit. A silent punishment is only announced to players with bridge..
The punishment menu
/punishments <player> lists every punishment, newest first:
- Red: active, with time left.
- Orange: expired.
- Grey: revoked, with who revoked it and why.
Click New punishment to issue one from menus: pick the type, then a duration for mutes, bans and blacklists (presets from 30 minutes to 90 days, a custom duration, or Permanent if you're allowed), then a reason (presets or typed), with a Silent toggle. A confirmation follows.
Click an active punishment to revoke it.
The duration and reason presets are set in plugins/Bridge/menus. under punishDuration. and punishReason..
Ban evasion
When a player joins, Catalyst checks whether another account that has used the same IP address has an active ban or blacklist. If so, the joining account gets the same punishment with the same end time and is removed with the ban evasion screen.
Give catalyst. to players who should never be caught by this, for example staff who share a connection.
To see and clear address links:
/alts <player>lists accounts that share an address with a player./removealts <player>clears the addresses linking a player to their alts.
Ban screens
/manageproxy edits the screens shown to players who can't join: the ban, blacklist, ban evasion and maintenance screens. They accept MiniMessage and these placeholders:
| Placeholder | Filled with |
|---|---|
{reason} | The punishment or maintenance reason. |
{expires} | Time left, or never. |
{appeal} | The network domain set in /networkmetadata. |
The default ban screen shows the reason, time left and "Appeal at" your domain. The default blacklist screen shows the reason only.
Permissions
| Node | Unlocks |
|---|---|
bridge. | /warn. |
bridge. | /kick. |
bridge. | /tempmute, and /mute together with .permanent. |
bridge. | /tempban, and /ban together with .permanent. |
bridge. | /blacklist together with .permanent. |
bridge. | Permanent mutes. |
bridge. | Permanent bans. |
bridge. | Permanent blacklists. |
bridge. | /unmute. |
bridge. | /unban. |
bridge. | /unblacklist. |
bridge. | /history. |
bridge. | /checkpunishment. |
bridge. | Seeing silent punishments. |
bridge. | /punishments. |
catalyst. | Never punished for ban evasion. |
The menu only offers the types you have the node for.