Skip to content
SPECIFICTION
Get listed

BanManager

banmanagement.com

WebLinuxAPISelf-hosted

What it is

BanManager is a free, open-source suite of moderation plugins and apps for Minecraft servers. It supports bans, IP blocks, mutes, profane-name blocking, and chat moderation that can include shadow muting. Players can report behavior while staff are offline, then staff can track and resolve reports. Configurable warning thresholds can trigger commands with increasing severity. Staff can add notes and review player records, including unbans and who issued them. Downloads are listed for Bukkit variants, BungeeCord, Fabric, Sponge, and Velocity. Data can be stored locally in H2 or remotely with MySQL or MariaDB. The optional self-hosted WebUI adds appeals, reports, role-based permissions, and a dashboard for one or more servers. That interface requires BanManager-WebEnhancer and MySQL 5+ or MariaDB 10+; the default H2 database is unsupported. Its setup page is initially unauthenticated, so the documentation recommends setting a setup token before exposing it to the internet. A developer API lets other plugins read or modify punishment data and receive change events.

Spec sheet

Purpose
BanManager is a suite of moderation plugins and apps for Minecraft servers.Read 28 Sep 2026 · banmanagement.com
Product
BanManager is a suite of moderation plugins and apps for Minecraft servers.Read 29 Sep 2026 · banmanagement.com
Support
The maker directs users to its Discord, GitHub discussions, and FAQ for support and feature requests.Read 29 Sep 2026 · banmanagement.com
Maker
The site credits James Mortemore and displays a 2012–2026 copyright; it does not state a headquarters or founding year.Read 29 Sep 2026 · banmanagement.com
Chat moderation
It can mute players who spam chat, including through shadow muting.Read 29 Sep 2026 · banmanagement.com
Credential protection
The WebUI uses a 64-character hex ENCRYPTION_KEY to encrypt stored BanManager database passwords.Read 28 Sep 2026 · banmanagement.com
Cross-server sync
The FAQ says local punishments are checked every 30 seconds and global punishments every two minutes by default; more frequent checks increase database use.Read 28 Sep 2026 · banmanagement.com
Customization
Messages can be customized with color codes and JSON messages.Read 29 Sep 2026 · banmanagement.com
Data storage
BanManager supports local H2 storage and remote MySQL or MariaDB storage for sharing data or using the WebUI.Read 29 Sep 2026 · banmanagement.com
Database options
BanManager supports local H2 storage and remote MySQL or MariaDB storage.Read 28 Sep 2026 · banmanagement.com
Developer API
The developer API lets other plugins read and modify punishment data and provides events for punishment changes.Read 29 Sep 2026 · banmanagement.com
Open source
The maker describes BanManager as open source and welcomes contributions.Read 28 Sep 2026 · banmanagement.com
Price
The maker describes BanManager as open source and free.Read 29 Sep 2026 · banmanagement.com
Punishments
It supports player and IP bans and prevents profane names from joining servers.Read 29 Sep 2026 · banmanagement.com
Reports
Players can report behavior while staff are offline, and staff can track and resolve reports later.Read 28 Sep 2026 · banmanagement.com
Reports and warnings
Players can report behavior while staff are offline, and warnings can trigger increasingly severe commands after a configured threshold.Read 29 Sep 2026 · banmanagement.com
Security configuration
The WebUI documentation says the browser installer is unauthenticated by default and recommends setting SETUP_TOKEN on internet-reachable hosts.Read 28 Sep 2026 · banmanagement.com
Security setup
The WebUI Docker guide says its setup page is initially open and recommends setting a SETUP_TOKEN before exposing an install to the internet.Read 29 Sep 2026 · banmanagement.com
Server platforms
Downloads are listed for Bukkit (CraftBukkit, Spigot, Paper), BungeeCord, Fabric, Sponge, and Velocity.Read 29 Sep 2026 · banmanagement.com
Staff records
Staff can add notes and view a player's record, including unbans and who issued them.Read 29 Sep 2026 · banmanagement.com
Supported server platforms
Downloads are listed for Bukkit (CraftBukkit, Spigot, Paper), BungeeCord, Fabric, Sponge, and Velocity.Read 28 Sep 2026 · banmanagement.com
Warnings
The warning system can automatically issue commands after a configured number of warnings, with increasing severity.Read 28 Sep 2026 · banmanagement.com
Web dashboard
The self-hosted WebUI supports appeals, reports, role-based permissions, and a dashboard for one or more servers.Read 29 Sep 2026 · banmanagement.com
Web interface
The self-hosted WebUI adds appeals, reports, role-based permissions, and a dashboard for one or more servers.Read 28 Sep 2026 · banmanagement.com
WebUI requirement
The WebUI requires BanManager-WebEnhancer and a MySQL 5+ or MariaDB 10+ database; the default H2 database is unsupported.Read 29 Sep 2026 · banmanagement.com
WebUI requirements
The WebUI requires BanManager configured with MySQL 5+ or MariaDB 10+; the default H2 database is unsupported.Read 28 Sep 2026 · banmanagement.com

Strong points and limits

Strong points

  • Free and open source
  • Players can report behavior while staff are offline
  • Supports local H2 or remote MySQL and MariaDB
  • Developer API exposes punishment data and change events

Limits

  • WebUI does not support the default H2 database
  • WebUI requires BanManager-WebEnhancer and MySQL 5+ or MariaDB 10+
  • WebUI setup is unauthenticated by default

Who it suits

BanManager suits Minecraft server staff who need to manage punishments, reports, warnings, and staff records. The WebUI is for administrators able to provide the required database and configure its setup security.

BanManager in depth

Read the full write-up

BanManager is a free, open-source moderation suite for Minecraft server teams that need punishments, reporting, staff records, and cross-server data in one system. It suits administrators running more than one server or proxy, especially those willing to manage their own database. The main trade-off is that its optional WebUI adds useful workflows but also imposes database and security setup work.

Overview

BanManager brings bans, IP blocks, mutes, profane-name blocking, reports, warnings, and player histories into a common moderation layer. It can respond to chat spam with ordinary or shadow mutes, while configurable messages support color codes and JSON. As open-source software with no charge, it is a practical fit for communities that prefer self-hosting and control over recurring costs.

Storage can remain local with H2 or move to MySQL or MariaDB for shared data between servers. That flexibility is useful for a single server, but teams planning the WebUI must choose MySQL 5+ or MariaDB 10+ because the default H2 database is unsupported. For category comparisons, see the Minecraft Moderation Plugins list.

Key features

Punishments and chat control

Moderators can ban accounts, block IP addresses, mute players, and reject profane names. Chat-spam muting, including shadow muting, lets staff intervene without always revealing the action to the offender. This broadens BanManager beyond a simple ban list, although server teams still need to define their own policies and thresholds.

Reports and escalating warnings

Players can file behavior reports while staff are offline, then staff can review and resolve them later. Warnings can trigger configured commands after a chosen count, with increasingly severe responses as warnings accumulate. That gives communities a repeatable escalation path instead of relying on ad-hoc decisions.

Records, API, and customization

Staff notes and player histories include unbans and the identity of the staff member who issued them, supporting accountability during appeals or internal review. The developer API allows other plugins to read or change punishment data and receive punishment-change events, making BanManager a useful moderation backend in a larger plugin stack. Messages can be tailored with color codes and JSON.

WebUI

The self-hosted WebUI adds appeals, reports, role-based permissions, and a dashboard covering one or more servers. It is the strongest option for teams that want browser-based staff workflows, but it requires BanManager-WebEnhancer plus MySQL 5+ or MariaDB 10+. The installer is initially unauthenticated; internet-facing deployments should set a SETUP_TOKEN. Stored database passwords are encrypted with a 64-character hexadecimal ENCRYPTION_KEY.

Pricing

BanManager is free, with no paid tiers or trial period. That makes the complete plugin suite and WebUI attractive where hosting and administration are already budgeted. The real cost is operational: WebUI users must provide and maintain a compatible MySQL or MariaDB database, configure the enhancer, and secure the setup process. There are no published seat, quota, or renewal charges.

Platforms

Downloads cover Bukkit servers (CraftBukkit, Spigot, and Paper), BungeeCord, Fabric, Sponge, and Velocity. API, Linux, self-hosted, and web environments are supported. Cross-server synchronization checks local punishments every 30 seconds and global punishments every two minutes by default; shortening those intervals increases database use. Local H2 suits simpler installations, while remote MySQL or MariaDB is the route to shared data and the WebUI.

Who it's for

Choose BanManager if you run one or several Minecraft servers and want a free, extensible moderation system with reports, audit-friendly records, configurable warning escalation, and broad platform coverage. It is particularly well matched to proxy networks and teams comfortable operating databases and securing a self-hosted panel. A small server that only needs basic punishments may find the WebUI requirements and synchronization administration unnecessary.

Pros and cons

Pros: Free and open source, with no recurring license cost.

Pros: Covers punishments, chat moderation, reports, warnings, notes, and audit history in one suite.

Pros: Supports Bukkit, BungeeCord, Fabric, Sponge, and Velocity deployments.

Pros: API events and data access allow other plugins to integrate moderation changes.

Cons: The WebUI cannot use the default H2 database and needs MySQL 5+ or MariaDB 10+ plus BanManager-WebEnhancer.

Cons: The browser installer starts unauthenticated, so internet exposure requires deliberate SETUP_TOKEN configuration.

Cons: More frequent cross-server checks increase database usage.

Alternatives

ModGUI is a free, self-hosted MIT-licensed option for Paper 1.21.11 or newer. Pick it when that narrower platform target and a simpler plugin choice suit your server.

Staff+ is free and self-hosted under the MIT License, covering Paper, Purpur, Folia, and Velocity versions in its stated range. It fits teams targeting those platforms.

LibertyBans is free software for supported Minecraft platforms and requires Java 17. Choose it when a punishment-focused, API-capable deployment is the priority.

Nimbus AntiCheat is a free self-hosted anti-cheat with 43 checks, per-check punishments, reports, staff inspection tools, and Discord webhooks. Pick it when cheating detection is the central need.

ExtraBan is a free plugin for Paper or a fork on Java 25+. Player Report is a free self-hosted reporting plugin for Minecraft 1.21. PunishBAN and AdvancedSensitiveWords are free self-hosted alternatives.

Verdict

BanManager is a strong choice for Minecraft networks that want broad moderation coverage, extensibility, and a free self-hosted stack across multiple server platforms. Choose it for its unified records, reporting and warning workflows, and optional multi-server WebUI. Look elsewhere if you want a turnkey panel without database administration or an initially exposed installer that needs extra security configuration.

Verdict

BanManager covers moderation workflows across several Minecraft server platforms, with an optional self-hosted WebUI. The WebUI's database requirement and initial setup security need attention before deployment.

Where Specifiction places it

Alternatives to BanManagerAll alternatives →