BanCore

# 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

1. Put ZeryxBans.jar in the server plugins folder.
2. Start the server once to generate the files.
3. Edit plugins/ZeryxBans/config.yml, messages.yml, templates.yml, and webhooks.yml.
4. Use /zeryxbans reload after config edits.
5. 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.