Documentation
Protection and staffFree

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 -s to 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 keep inglis.sanctions.permanent for 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.