EasyBans

A complete moderation suite for Velocity proxies — bans, mutes, warnings, kicks, escalating punishment templates, and full multi-language support, working out of the box.

No MySQL required to get started — runs on an embedded H2 database by default.

What is EasyBans?

EasyBans is a network-wide moderation plugin for Velocity proxies. It replaces every vanilla ban-related command (/ban, /ban-ip, /pardon, /pardon-ip, /banlist, /kick) at the proxy level, so your staff get one consistent moderation system across your entire network instead of each backend server enforcing its own vanilla bans. Bans, mutes, warnings, kicks and staff notes are all tracked centrally, by UUID, with full history and staff accountability.

Key Features

• Bans, IP bans, mutes, warnings, kicks & staff notes — all UUID-based, all with reasons, durations, and staff attribution
• Escalating punishment templates — configure a punishment ladder (e.g. 3d → 14d → permanent) that automatically applies the right stage based on a player's prior offenses
• Warning categories with auto-escalation — "3 spam warnings → auto-mute", "5 warnings → auto-ban", fully configurable
• Per-server scoping — ban a player from one backend server only, or network-wide, with a single flag
• Multi-instance sync — running more than one proxy against the same database? Punishments propagate automatically (database polling or Redis pub/sub)
• Full multi-language support — French, English, Spanish, Italian, Russian, Arabic and German out of the box, all in MiniMessage format (hex colors, gradients, hover text). Players can set their own language with /easybans language <code>
• Fully customizable, multi-line kick/ban screens — with gradients, hover text, and per-template-stage overrides
• Discord webhook integration — every ban/mute/warn/kick posted to your staff Discord as a rich embed
• Linked-account (alt) detection — notifies staff (or optionally auto-bans) when a new connection shares an IP with a banned account
• Import from other plugins — migrate straight from vanilla ban-lists, EssentialsX, MaxBans, BanManager, AdvancedBan, BungeeAdminTools, or LiteBans
• Tab-completion everywhere — online and offline player names, flags, durations, templates, categories, servers
• MySQL, MariaDB, PostgreSQL & H2 — pick your backend, or just use the zero-config embedded default

Commands

/ban <player> <duration|reason...> [-s] [-server:<name>] [-t:<template>]
/banip <player> <duration|reason...> [-s] [-server:<name>]
/unban <player> [reason...]
/pardon-ip <ip> [reason...]
/mute <player> <duration|reason...> [-s] [-server:<name>] [-t:<template>]
/unmute <player> [reason...]
/warn <player> <category> <reason...>
/kick <player> <reason...> [-server:<name>]
/note <player> <note...>
/history <player> [page]
/staffhistory <staff> [page]
/banlist [players|ips] [page]
/lookup <id>
/easybans allow <player> <ip>
/easybans rollback <staff|confirm>
/easybans import <source> <location>
/easybans language <code>
/easybans template
/easybans reload

Every vanilla ban command name (ban-ip, pardon, pardon-ip, banlist) is registered as an alias, so EasyBans transparently takes over for staff already used to vanilla syntax.

Requirements

• Java 25+
• Velocity proxy
• Nothing else for a single-proxy setup — H2 is embedded and zero-config
• For mutes on 1.19.1+ clients, install SignedVelocity on the proxy and every backend server (prevents chat-signature desync when a mute cancels a message)

Configuration

Everything is generated with sensible defaults on first run: config.yml (storage, sync, Discord, linked-account detection, locale), templates.yml (punishment templates and warning categories), and messages_<locale>.yml for each of the 7 bundled languages. Full reference: see CONFIG.md in the plugin's GitHub repository.

Permissions

Every permission is namespaced under easybans.* (e.g. easybans.ban, easybans.mute, easybans.warn, easybans.kick, easybans.history, easybans.rollback, easybans.import...) — nothing is granted by default beyond server operators. Full list in PERMISSIONS.md on GitHub.

Found a bug or have a feature request? Open an issue on GitHub or reach out on Discord.

Suggested Spigot resource metadata

• Category: Proxy Support (Velocity)
• Supported platforms/versions: Velocity, Minecraft 1.26.2 (Velocity API 4.0.0-SNAPSHOT)
• Tags/keywords: ban, moderation, mute, kick, warn, velocity, proxy, punishment, i18n, multi-language, discord webhook