❌Ban

The Ban system is the most severe form of punishment, preventing a player from connecting to the server entirely. Crown supports both temporary and permanent bans, as well as IP-based banning.

How it Works

When a player attempts to join, Crown checks the database for active ban entries matching their UUID or IP address. If found, the connection is refused with a customizable kick screen.

Usage

Command	Permission	Description
/ban <player> [-ip|-local] [time] [reason]	crown.punish.ban	Bans a player. Opens GUI if args are missing.
/unban <player|#ID>	crown.unpunish.ban	Unbans a player.

Configuration (ban.yml)

The ban system offers a highly configurable kick screen that supports placeholders.

# Use internal Crown handling or execute a vanilla/external command?
use-internal: true 

# Should the ban automatically apply to the player's IP address?
punish-by-ip: true 

# The screen shown to the player when they try to join
ban-screen:
  - '<gradient:#ff416c:#ff4b2b><bold>You have been banned.</bold></gradient>'
  - ''
  - '<color:#b0b0b0>Reason: <color:#ffffff>{reason}</color></color>'
  - '<color:#b0b0b0>Expires in: <color:#ffffff>{time_left}</color></color>'
  - '<color:#b0b0b0>Appeal at: <color:#00c6ff><u>{support_link}</u></color></color>'

Note: If punish-by-ip is enabled, any account joining from the banned IP will be rejected, even if that specific account name isn't banned.