Minecraft plugin AdvancedBan

🔌 About AdvancedBan

AdvancedBan is a Minecraft plugin for managing player punishments on single servers and across BungeeCord networks. It centralizes warns, mutes, bans, IP bans, temporary punishments and kicks, and stores player punishment history. The plugin offers configurable time/layout templates, message files for translation, and both local file storage and MySQL support.

🎯 Purpose

AdvancedBan aims to provide server administrators and moderation teams with a single, configurable punishment system that works on standalone Spigot/Bukkit servers and on proxy networks using BungeeCord. It is suitable for servers that need structured record-keeping of punishments and optional network-wide sync.

⚙️ Features

• Warns, temp-warns and permanent warns
• Mutes and temporary mutes
• Bans and temporary bans
• IP bans and temporary IP bans
• Kicks
• PlayerHistory to review past punishments
• Configurable time layouts and message files for translations
• Support for MySQL and local file storage
• Optional web/monitoring panel (requires MySQL reachable externally)
• API for other plugins to integrate with AdvancedBan
• bStats metrics integration

🧩 Who It Is For

• Small and large survival / SMP servers that need structured moderation
• Networks using BungeeCord that require synchronized punishments
• Server administrators who want configurable layouts and translation-ready message files

🏗️ Example Use Cases

• An admin issues a tempban for rule violations with an automated time layout.
• Moderators check a player's PlayerHistory to review past warnings before issuing further sanctions.
• A network uses MySQL storage to share punishments between proxy and backend servers.

⌨️ Commands

(Commands above are documented by official plugin sources; specific permission nodes for most commands are not listed on the primary pages.)

🔐 Permissions

⚙️ Installation

📥 Setup

• Download the official AdvancedBan jar and place it into your server plugins/ directory (either on the Spigot/Bukkit server or on the BungeeCord proxy for network setups).
• Restart the server or restart the BungeeCord proxy.
• Verify the plugin loaded by running the plugin check command (the plugin provides an admin check command).

📦 Dependencies

• Optional: Official GUI addon depends on AdvancedGUI (addon-specific).
• Storage: supports MySQL (networked) or local file storage (embedded).

🧾 Configuration

• The plugin provides a detailed config file and a full message file for translations and layout customization.
• A web/monitoring panel is available but requires AdvancedBan v2.0.0+ and an externally reachable MySQL server.

🧠 Technical Notes

• Supported server types: Bukkit/Spigot and BungeeCord (the project includes both Bukkit and Bungee modules).
• Storage backends: local file storage or MySQL (MySQL required for networked/web features).
• API: AdvancedBan exposes an API for other plugins (JavaDocs and API usage are provided by the project).
• Metrics: the plugin reports usage via bStats.
• License: GPL-3.0 (project repository).

🤝 When This Plugin Is Useful

If you need a single, configurable punishment system that can run on a standalone Spigot server or across a BungeeCord proxy with shared storage, AdvancedBan provides documented punish actions, player history, and integration points for addons and external tools.