Punishments
Ban, mute, kick, and IP-ban management with timed and permanent punishments.
Overview
EssentialsC provides a full punishment system with bans (player and IP), mutes, and kicks. Punishments can be timed or permanent, are stored in bans.yml and mutes.yml, and support a network hook for cross-server sync via the MySQL expansion. Players with the exempt permission are immune to punishments.
Commands
| Command | Description |
|---|---|
/ban <player> [duration] [reason] |
Ban a player. Duration uses the format below; omit for permanent. |
/unban <player> |
Unban a player. |
/ban-ip <player|ip> [-t:duration] [reason] |
Ban an IP address or a player's IP. |
/unban-ip <ip> |
Unban an IP address. |
/banlist [players|ips|all|history] [page] |
List active bans. Use history to see expired/pardoned bans. |
/mute <player> [duration] [reason] |
Mute a player, preventing them from chatting. |
/unmute <player> |
Unmute a player. |
/kick <player> [reason] |
Kick a player from the server. |
/checkpunish <player> |
Check a player's current punishment status - bans, mutes, and history. |
Duration Format
Timed punishments use a simple duration string format combining numbers and time units.
| Unit | Suffix | Example |
|---|---|---|
| Minutes | m |
30m - 30 minutes |
| Hours | h |
2h - 2 hours |
| Days | d |
7d - 7 days |
| Weeks | w |
2w - 2 weeks |
| Combined | 7d12h30m - 7 days, 12 hours, 30 minutes |
If no duration is provided, the punishment is permanent. Players with the essentialsc.punishment.exempt permission cannot be banned, muted, or kicked.
Permissions
| Permission | Description | Default |
|---|---|---|
essentialsc.ban |
Ban players. | Operators |
essentialsc.unban |
Unban players. | Operators |
essentialsc.banip |
Ban IP addresses. | Operators |
essentialsc.unbanip |
Unban IP addresses. | Operators |
essentialsc.banlist |
View the ban list. | Operators |
essentialsc.mute |
Mute players. | Operators |
essentialsc.unmute |
Unmute players. | Operators |
essentialsc.kick |
Kick players. | Operators |
essentialsc.checkpunish |
Check player punishment status. | Operators |
essentialsc.punishment.exempt |
Immune to all punishments - cannot be banned, muted, or kicked. | Operators |
essentialsc.punishment.notify |
Receive notifications when punishments are issued or expire. | Operators |