![Banner](https://cdn.modrinth.com/data/cached_images/0aca6868cff87cc61301291b91928a7494b93c81.png)# 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 [duration] ` - Ban a player permanently or temporarily. - `/tempban ` - Temporarily ban a player. - `/ipban [duration] ` - IP-ban a player or IP. - `/tempipban ` - Temporarily IP-ban. - `/unban ` - Remove an active ban. - `/mute [duration] ` - Mute a player permanently or temporarily. - `/tempmute ` - Temporarily mute a player. - `/ipmute [duration] ` - IP-mute a player or IP. - `/tempipmute ` - Temporarily IP-mute. - `/unmute ` - Remove an active mute. - `/warn ` - Warn a player. - `/unwarn ` - Remove the latest active warning. - `/kick ` - Kick a player. - `/history ` - View punishment history. - `/warnings [player]` - View active warnings. - `/banlist [page]` - View active bans. - `/mutelist [page]` - View active mutes. - `/warnlist [page]` - View active warnings. - `/checkban ` - Check active ban status. - `/checkmute ` - Check active mute status. - `/checkwarn ` - Check active warning status. - `/staffhistory ` - View punishments issued by staff. - `/staffrollback ` - Remove active punishments issued by staff. - `/prunehistory ` - Prune inactive history for a player. - `/iphistory ` - View known IP history. - `/dupeip ` - Scan accounts linked to an IP. - `/alts ` - Alias for `/dupeip`. - `/checkalts ` - Alias for `/dupeip`. - `/listalts ` - Alias for `/dupeip`. - `/ipreport ` - Show IP and alt report. - `/lastuuid ` - 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 ` - 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.

mrsuhrem