SentinelBan v1.1

SentinelBan​

A modern, lightweight and highly customizable punishment plugin for Paper servers.

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.

Examples:

/ban Steve other 30d Griefing

/ban Steve other 7d Inappropriate Language

Supported durations:

• 1h
• 12h
• 1d
• 7d
• 30d
• 90d
• 180d
• 365d
• perm

/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.

Example:

/sentinelban reload

Permissions​

sentinel.ban

Allows use of /ban

sentinel.unban

Allows use of /unban

sentinel.baninfo

Allows use of /baninfo

sentinel.banhistory

Allows use of /banhistory

sentinel.banlist

Allows use of /banlist

sentinel.admin

Allows use of /sentinelban reload

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.

​