BanModerationSecurityIP Ban2 min read

Ban and unban players

Use ban, ban-ip, and pardon commands to manage player access to your server.


Ban a player by name

From the console at panel.baires.host or in-game as OP:

terminal
ban PlayerName Reason for the ban

Example:

terminal
ban Griefer123 Destroying other players' builds

Ban by IP address

Prevents a player from reconnecting with a different account:

terminal
ban-ip PlayerName
ban-ip 192.168.1.100

Temporary ban (with EssentialsX)

terminal
/tempban PlayerName 7d Griefing - 7 day ban
/tempban PlayerName 24h Spamming in chat

Duration formats: 30m (minutes), 12h (hours), 7d (days)

Unban a player

terminal
pardon PlayerName

Unban an IP

terminal
pardon-ip 192.168.1.100

View ban list

terminal
banlist
banlist ips

Kick (without banning)

Remove a player from the server without banning them:

terminal
kick PlayerName Please read the rules

Managing bans via files

Bans are stored in two files:

  • banned-players.json — name bans
  • banned-ips.json — IP bans

You can edit these directly in the panel file manager for bulk operations.

Best practices

  • Always include a reason with bans for record-keeping
  • Use temp bans for first offenses, permanent bans for repeat offenders
  • IP bans can affect innocent players on shared networks — use carefully
  • Keep a moderation log (Discord channel or spreadsheet) for accountability
  • Consider using a plugin like LiteBans for advanced ban management with history and web interface

Tips

  • Banned players see the ban reason when they try to connect
  • Bans persist through server restarts
  • If using a proxy (Velocity/BungeeCord), ban at the proxy level for network-wide bans

Was this guide helpful?