MurphyBan

MurphyBan

MurphyBan is a self-contained punishment system built to replace LiteBans and AdvancedBan with a single, clean solution. Every player-facing string is configurable via MiniMessage and every database operation runs fully async — the main thread is never blocked.

Punishments

• Permanent and temporary bans, IP bans, mutes, kicks, and warnings
• Full offline player support — punish players who aren't online
• IP bans accept a player name or a raw IP address
• Warn escalation — auto-punishes when a player hits the warning threshold
• Warns older than warns.expire-after (default 30 days) stop counting automatically

Staff Tools

• /check — compact summary of a player's active ban, mute, and warn count
• /history — paginated chest GUI, colour-coded by type, with Active / Revoked / Expired status
• /blame — last 5 punishments printed in chat
• /staffhistory — paginated GUI of all punishments issued by a staff member
• /alts — paginated GUI of all accounts sharing an IP, with ban status per player head
• Staff alert channel notified on every ban, mute, kick, warn, and alt join

Alt Detection

• Every IP a player connects from is recorded automatically
• On join, the incoming IP is checked against all banned accounts — staff alerted instantly
• Optional auto-ban for alts of banned players (disabled by default)

Database

• SQLite out of the box — zero configuration required
• MySQL support with HikariCP connection pooling
• All queries fully async via CompletableFuture
• Schema and migrations run automatically on startup

Other

• Full MiniMessage support for every player-facing message
• PlaceholderAPI expansion with 9 placeholders
• Background expiry sweeper runs every 5 minutes
• /murphyban reload hot-reloads config and messages without restart
• Debug mode toggled live via reload — no restart needed

Requirements

• Java 21+
• Spigot / Paper 1.21
• PlaceholderAPI (optional)

Source Code

Full source available on GitHub