Punishments
Bans, IP bans, mutes, kicks and warnings, with escalating templates and staff limits, synced across your network.
The Punishments module gives your staff everything they need to deal with rule breakers: bans, temporary bans, IP bans, mutes, kicks and warnings. Every punishment applies to your whole network at once and is kept in a full history you can browse and manage from the web editor.
Features
- All the classic punishments: permanent and temporary bans, IP bans, permanent and temporary mutes, kicks and warnings.
- Network wide. A ban or a mute given on one server applies on every server immediately.
- Players who never joined can already be banned or muted by name. The punishment attaches to their account when they first connect.
- Escalating templates.
/punish <player> <template>picks the right step automatically: a first offence gets the first duration, a repeat offence the next one. - Automatic actions on warnings. Run a command when a player reaches a number of active warnings, for example a mute at 3 and a ban at 5.
- Staff limits. Cap the longest punishment each staff group can give, and keep permanent punishments for trusted staff.
- Rank protection. With the Ranks module, staff cannot punish or lift the punishment of a player whose rank is equal or higher than theirs, even when that player is offline.
- Silent punishments. Add
-sto only tell the staff. - A real mute. A muted player cannot chat, use the commands you block, write on signs or in books, or rename items in an anvil.
- Linked accounts. See other accounts that used the same IP address.
- Web management. Search, filter, punish and lift punishments from the web editor.
Setting it up
Open the Punishments module in the web editor.
Punishments tab
The top of the page shows the punishments of the last 24 hours, active bans, active mutes and the total. Below, the full list:
- Search by player, staff or reason, filter by type, or show Active only.
- New punishment: enter the Player, the Type, a Duration (empty means permanent, for example
7d), a Reason, and tick Silent (staff only) if needed. The punishment applies on the whole network right away. - Lift ends an active punishment, with an optional reason.
A player's profile in the web editor also shows their active ban or mute, their warnings, their full history and their Linked accounts (same IP).
Settings tab
General
| Setting | What it does | Default |
|---|---|---|
| Public announcement | Announces punishments to every player. Otherwise only staff is told. | On |
| Default reason | Used when no reason is given. | Breaking the rules |
| Block on error | Refuses logins if the database does not answer. Safer, but less tolerant. | Off |
Mute
| Setting | What it does | Default |
|---|---|---|
| Commands blocked while muted | Commands a muted player cannot use, without the leading /. Aliases of these commands are blocked too. |
msg, tell, w, whisper, r, reply, me, say, mail, teammsg, tm |
Ladder templates (/punish)
Each template has an ID, a Type (Ban, IP ban, Mute, Kick, Warning or Jail), a Reason, its Steps and a Permission. Steps are durations separated by commas; perm means permanent. The first time a player gets a template, the first step is used; the second time, the second step; and so on. Once the last step is reached, it keeps being used. Punishments lifted by staff do not count toward the next step.
| ID | Type | Reason | Steps |
|---|---|---|---|
cheating |
Ban | Cheating (modified client) | 7d, 30d, perm |
spam |
Mute | Spam or flood | 10m, 1h, 1d, 7d |
insults |
Mute | Insults | 1h, 1d, 7d, 30d |
advertising |
Ban | Advertising another server | 1d, 7d, perm |
unsporting |
Warning | Unsportsmanlike behavior | 0 |
All default templates use the permission inglis.sanctions.punish. Jail templates need the moderation module.
Warnings
| Setting | What it does | Default |
|---|---|---|
| Automatic actions | Command run by the console when a player reaches this number of active warnings. {player} is replaced by the player name. |
3 warnings: mute {player} 1h Too many warnings; 5 warnings: ban {player} 1d Too many warnings |
| Warning lifetime | Older warnings no longer count. 0 means they never expire. | 30d |
Staff limits
| Setting | What it does | Default |
|---|---|---|
| Maximum durations | Staff with this permission cannot give a ban or mute longer than this duration. If a staff member has several, the longest one applies. | inglis.sanctions.limit.helper: 1d; inglis.sanctions.limit.mod: 30d |
The limit permissions you add here are granted to nobody by default: give them to your staff ranks in the Ranks module.
Durations
Durations combine a number and a unit: s (seconds), m (minutes), h (hours), d (days), w (weeks), mo (months), y (years). You can chain them, for example 1d12h. perm, permanent or 0 mean permanent.
Commands
The commands that give a punishment accept -s anywhere after the player to punish silently.
| Command | What it does | Permission |
|---|---|---|
/ban <player> [duration] [reason] |
Bans a player, permanently if no duration is given. | inglis.sanctions.ban |
/tempban <player> <duration> [reason] |
Bans a player for a set time. | inglis.sanctions.ban |
/ipban <player or IP> [duration] [reason] (also /banip) |
Bans an IP address, and so every account using it. | inglis.sanctions.ipban |
/mute <player> [duration] [reason] |
Mutes a player, permanently if no duration is given. | inglis.sanctions.mute |
/tempmute <player> <duration> [reason] |
Mutes a player for a set time. | inglis.sanctions.mute |
/kick <player> [reason] |
Kicks a player, on whichever server of the network they are. | inglis.sanctions.kick |
/warn <player> [reason] |
Gives a warning. | inglis.sanctions.warn |
/unban <player or IP> [reason] (also /pardon, /unbanip) |
Lifts a ban or an IP ban. | inglis.sanctions.unban |
/unmute <player> [reason] |
Lifts a mute. | inglis.sanctions.unmute |
/punish (also /sanction) |
Lists the templates. | inglis.sanctions.punish |
/punish <player> <template> |
Applies the next step of a template. Also needs the permission of the template and the permission of its type, for example inglis.sanctions.ban. |
inglis.sanctions.punish |
/history <player> (also /hist, /sanctions) |
Shows the last 15 punishments of a player. | inglis.sanctions.history |
/check <player> (also /baninfo) |
Shows if a player is online, banned, muted, their warnings and linked accounts. | inglis.sanctions.history |
/alts <player> (also /dupeip) |
Lists accounts that used the same IP, banned ones in red and online ones in green. | inglis.sanctions.alts |
All these commands are for operators by default.
Permissions
| Permission | Grants | Default |
|---|---|---|
inglis.sanctions.notify |
Sees every punishment and lift, even when public announcements are off or the punishment is silent. | Operators |
inglis.sanctions.silent |
Using -s. |
Operators |
inglis.sanctions.permanent |
Giving permanent bans and mutes. | Operators |
inglis.sanctions.seeip |
Seeing the IP address in /check. |
Operators |
inglis.sanctions.exempt |
Cannot be punished. | Nobody |
inglis.sanctions.jail |
Applying a Jail template with /punish. |
Operators |
inglis.sanctions.limit.helper, inglis.sanctions.limit.mod and any you add |
The maximum duration set in Staff limits. | Nobody |
Placeholders
| Placeholder | Shows |
|---|---|
%ingliscore_muted% |
true if the player is muted, otherwise false |
%ingliscore_mute_remaining% |
Time left on the mute, ∞ if permanent, empty if not muted |
See placeholders for how to use them.
Tips
- Give your helpers the template permission and a short limit such as
inglis.sanctions.limit.helper, and keepinglis.sanctions.permanentfor senior staff. - The reports module lets staff punish straight from a report, and the Discord module can post every punishment to a channel.
- The console has no duration limit and can always give permanent punishments.