SentinelBan

SentinelBan was designed to provide a simple but powerful punishment system with support for temporary bans, permanent bans, ban history tracking, customizable messages, configurable templates and Discord appeal integration.

Everything can be customized through configuration files, allowing server owners to create punishment systems that perfectly match their server.

Features Temporary and permanent bans Custom punishment templates Unique Ban ID system Ban information lookup Ban history tracking Active ban list command Offline player support Automatic unban when punishments expire Fully customizable ban screen Fully customizable messages through lang.yml Discord appeal integration Reload command Tab completion support Ban by player name Ban lookup by Ban ID or player name Lightweight and easy to configure Paper 1.21+ support

Commands

/ban

Ban a player using a configured template.

Examples:

/ban Steve xray

/ban Steve autoclick

/ban other Create a custom punishment.(This will not be saved in the config.)

Examples:

/ban Steve other 30d Griefing

/ban Steve other 7d Inappropriate Language

Supported durations:

day=d

hour=h

minute=m

You can set these values freely.

Examples:

14d

5h

You can also use “perm” to ban someone permanently.

/unban

Remove a punishment.

Examples:

/unban Steve

/unban ABC12345

Supports player names and Ban IDs.

/baninfo

Display detailed information about a punishment.

Examples:

/baninfo Steve

/baninfo ABC12345

/baninfo #ABC12345

/banhistory

View previous punishments for a player.

Example:

/banhistory Steve

/banlist

Display all currently active punishments.

Example:

/banlist

/sentinelban reload

Reload config.yml and lang.yml without restarting the server.

Ban Templates

Templates are configured inside config.yml.

Example:

templates:
  xray:
    reason: "X-Ray"
    duration: "30d"

  autoclick:
    reason: "Auto Clicker"
    duration: "14d"

Unlimited templates can be created.

Language File

All visible messages can be customized through lang.yml.

This includes:

Ban screen Command responses Ban list messages Ban info messages Ban history messages Permanent ban text Discord appeal messages Discord Appeals Players can immediately appeal their punishment through your Discord server directly from the ban screen.

Lightweight Design SentinelBan stores punishment data in simple YAML files and does not require any external database, making installation quick and easy while remaining highly configurable.