BanCore - CraftHub

Banner # ZeryxBans

ZeryxBans is a configurable punishment system for Paper servers, built for networks that want clean staff commands, separate per-server punishment storage, Discord webhook logging, and fully editable messages.

This build targets Paper 26.2 and Java 25.

Features

Bans, IP bans, mutes, IP mutes, warnings, kicks, history, staff history, rollback, ban lists, mute lists, warn lists, IP history, UUID lookup, IP reports, chat lockdown, mute chat, clear chat, and configurable templates.
Local server storage by default, so a punishment on one server does not automatically punish players on another server unless you configure global sync behavior.
Live remaining-time messages for bans and mutes. If a player reconnects after time passes, the remaining duration updates.
Fully configurable messages.yml with modern gradient-styled punishment screens and staff broadcasts.
Discord webhook logging with per-punishment routes and /zeryxbans webhooktest.
Screenshot-style alt/IP scanner with online, offline, banned, and IP-banned status labels.
Silent punishment support using -s.
Lite-style command aliases for familiar moderation workflows, without LiteBans branding.
H2 database included inside the jar.

Main Commands

/ban <player> [duration] <reason> - Ban a player permanently or temporarily.
/tempban <player> <duration> <reason> - Temporarily ban a player.
/ipban <player|ip> [duration] <reason> - IP-ban a player or IP.
/tempipban <player|ip> <duration> <reason> - Temporarily IP-ban.
/unban <player> - Remove an active ban.
/mute <player> [duration] <reason> - Mute a player permanently or temporarily.
/tempmute <player> <duration> <reason> - Temporarily mute a player.
/ipmute <player|ip> [duration] <reason> - IP-mute a player or IP.
/tempipmute <player|ip> <duration> <reason> - Temporarily IP-mute.
/unmute <player> - Remove an active mute.
/warn <player> <reason> - Warn a player.
/unwarn <player> - Remove the latest active warning.
/kick <player> <reason> - Kick a player.
/history <player> - View punishment history.
/warnings [player] - View active warnings.
/banlist [page] - View active bans.
/mutelist [page] - View active mutes.
/warnlist [page] - View active warnings.
/checkban <player> - Check active ban status.
/checkmute <player> - Check active mute status.
/checkwarn <player> - Check active warning status.
/staffhistory <staff> - View punishments issued by staff.
/staffrollback <staff> - Remove active punishments issued by staff.
/prunehistory <player> - Prune inactive history for a player.
/iphistory <player> - View known IP history.
/dupeip <player|ip> - Scan accounts linked to an IP.
/alts <player|ip> - Alias for /dupeip.
/checkalts <player|ip> - Alias for /dupeip.
/listalts <player|ip> - Alias for /dupeip.
/ipreport <player> - Show IP and alt report.
/lastuuid <player> - Show last known UUID.
/lockdown [on|off] - Toggle server lockdown.
/mutechat [on|off] - Toggle global chat mute.
/togglechat [on|off] - Alias for mute chat.
/clearchat - Clear public chat.
/zeryxbans reload - Reload config, messages, templates, and webhooks.
/zeryxbans info - Show plugin version and server info.
/zeryxbans servers - Show configured server scope information.
/zeryxbans broadcast <message> - Send a staff broadcast.
/zeryxbans webhooktest - Send a Discord webhook test.

Common Permissions

zeryxbans.ban
zeryxbans.tempban
zeryxbans.ipban
zeryxbans.tempipban
zeryxbans.unban
zeryxbans.mute
zeryxbans.tempmute
zeryxbans.ipmute
zeryxbans.tempipmute
zeryxbans.unmute
zeryxbans.warn
zeryxbans.unwarn
zeryxbans.kick
zeryxbans.history
zeryxbans.warnings
zeryxbans.warnings.self
zeryxbans.banlist
zeryxbans.mutelist
zeryxbans.warnlist
zeryxbans.checkban
zeryxbans.checkmute
zeryxbans.checkwarn
zeryxbans.staffhistory
zeryxbans.staffrollback
zeryxbans.prunehistory
zeryxbans.iphistory
zeryxbans.dupeip
zeryxbans.ipreport
zeryxbans.lastuuid
zeryxbans.lockdown
zeryxbans.mutechat
zeryxbans.clearchat
zeryxbans.admin
zeryxbans.notify
zeryxbans.notify.broadcast
zeryxbans.silent
zeryxbans.bypass

Setup

Put ZeryxBans.jar in the server plugins folder.
Start the server once to generate the files.
Edit plugins/ZeryxBans/config.yml, messages.yml, templates.yml, and webhooks.yml.
Use /zeryxbans reload after config edits.
Use /zeryxbans webhooktest to confirm Discord logging.

For networks, install the jar separately on each Paper server. Keep storage local if you want Hub and Practice punishments to stay separate.