AdvancedBan - Punishment Management, GUI & More | 1.8-1.21.x+

AdvancedBan is a complete punishment management plugin built for servers that need a clean and reliable way to handle player punishments.

Manage bans, mutes, warnings, kicks, IP restrictions, punishment history, and more from one system.

FEATURES

Complete Punishment System

Handle different types of player punishments with permanent and temporary options.

Ban & Mute Management

Manage player bans and mutes with custom reasons and durations.

IP Punishments

Apply and manage IP-based restrictions alongside normal player punishments.

Warning System

Warn players, remove active warnings, and check their current warnings.

Punishment History

Keep track of previous punishments and review a player's moderation history.

GUI

Use the built-in GUI for supported punishment management and player information.

Discord Webhook

Send punishment-related notifications to Discord through webhook integration.

PlaceholderAPI

Use AdvancedBan placeholders with compatible scoreboards, chat systems, tablists, menus, and other PlaceholderAPI-supported plugins.

Configurable

Customize messages, GUI settings, broadcasts, animations, language, Discord integration, and other available options.

Multi-Language

Includes language files for English, Spanish, Indonesian, Vietnamese, and Chinese.



Punishment Commands

/ban <player> [reason]
Permanently ban a player.

/tempban <player> <duration> [reason]
Temporarily ban a player for a specific duration.

/unban <player>
Remove an active player ban.

/banip <player|ip> [reason]
Permanently ban a player's IP address or a specified IP.

/tempbanip <player|ip> <duration> [reason]
Temporarily ban an IP address.

/unbanip <player|ip>
Remove an active IP restriction.

/mute <player> [reason]
Permanently mute a player.

/tempmute <player> <duration> [reason]
Temporarily mute a player.

/unmute <player>
Remove an active mute.

/kick <player> [reason]
Kick a player from the server.

/warn <player> [reason]
Give a player a warning.

/unwarn <player>
Remove the latest active warning from a player.

/warnings <player>
View a player's active warnings.

History & Status Commands

/history <player>
View a player's punishment history.

/punishments <player>
View a player's active punishments.

/checkban <player>
Check whether a player is currently banned.

/checkmute <player>
Check whether a player is currently muted.

/checkip <ip|player>
Check the IP restriction status of an IP address or player.

Administration

/advancedban <reload|help|info|lookup|staff|debug>
Access AdvancedBan administration tools.

Aliases: /aban, /ab



Punishment Permissions

advancedban.ban — Allows permanent bans.

advancedban.tempban — Allows temporary bans.

advancedban.unban — Allows removing player bans.

advancedban.ipban — Allows IP bans.

advancedban.tempipban — Allows temporary IP bans.

advancedban.unbanip — Allows removing IP bans.

advancedban.mute — Allows permanently muting players.

advancedban.tempmute — Allows temporary mutes.

advancedban.unmute — Allows removing mutes.

advancedban.kick — Allows kicking players.

advancedban.warn — Allows warning players.

advancedban.unwarn — Allows removing active warnings.

advancedban.warnings — Allows viewing active warnings.

advancedban.history — Allows viewing punishment history.

advancedban.check — Allows checking ban, mute, and IP status.

Administration & Staff Permissions

advancedban.admin — Full AdvancedBan access.

advancedban.reload — Allows reloading AdvancedBan configuration.

advancedban.staff — Access to staff tools.

advancedban.notify — Receive staff punishment notifications.

Bypass Permissions

advancedban.bypass — Bypass all punishments.

advancedban.bypass.ban — Bypass bans.

advancedban.bypass.mute — Bypass mutes.

advancedban.bypass.kick — Bypass kicks.

advancedban.bypass.warn — Bypass warnings.

advancedban.bypass.ip — Bypass IP restrictions.

advancedban.ip.view — View sensitive network information.



PlaceholderAPI Placeholders

All AdvancedBan placeholders use the "advancedban" identifier.

%advancedban_player%
Returns the player's name.

%advancedban_uuid%
Returns the player's UUID.

%advancedban_is_banned%
Returns whether the player currently has an active ban.

%advancedban_is_muted%
Returns whether the player currently has an active mute.

%advancedban_status%
Returns the player's current punishment status.

%advancedban_ban_reason%
Returns the current ban reason.

%advancedban_ban_duration%
Returns the current ban duration.

%advancedban_ban_expiration%
Returns the current ban expiration.

%advancedban_ban_staff%
Returns the staff member responsible for the current ban.

%advancedban_mute_reason%
Returns the current mute reason.

%advancedban_mute_duration%
Returns the current mute duration.

%advancedban_last_punishment%
Returns the player's latest punishment.

%advancedban_last_punishment_reason%
Returns the reason for the player's latest punishment.

%advancedban_punishment_count%
Returns the player's punishment count.

%advancedban_warning_count%
Returns the player's warning count.



Plugin Information

Plugin: AdvancedBan

Version: 1.0.0

Platform: Paper

Minecraft API: 1.21

Java: 25

PlaceholderAPI: Optional

Vault: Optional

Languages: English, Spanish, Indonesian, Vietnamese & Chinese

Storage: YAML

Configuration: YAML

Integrations: PlaceholderAPI, Vault & Discord Webhook

Built for everyday server moderation.

AdvancedBan keeps your moderation tools together in one place without making everyday punishment management unnecessarily complicated.