FAQ

FAQ

Does this work on Paper / Purpur / other Spigot forks? Yes — anything built on the Spigot/Bukkit API works fine.

What Minecraft versions are supported? 1.13 through the current 1.21.x line. If you're on something notably newer and hit odd behavior (particularly around chat handling, since Minecraft's chat system has changed a few times over the years), that's worth reporting.

Do I need a database? No. The default JSON storage works out of the box. A real database is an option for larger networks, not a requirement.

Can I use this across multiple servers? Yes, via Redis — see Network Setup. It works with BungeeCord, Waterfall, and Velocity.

Does it work with Velocity specifically? Yes. The sync mechanism is Redis-based rather than tied to BungeeCord's plugin-messaging system, so it's proxy-agnostic. See Network Setup for details, including how to write your own thin Velocity-side plugin if you want punishments to also apply at the proxy layer.

Is the web panel required? No, you can disable it entirely with web.enabled: false if you only want to manage punishments in-game.

Can I run the web panel without exposing it to the internet? Yes — bind it to localhost-only access via your firewall, or put it behind a VPN, and only reach it that way. See Web Panel.

Can players appeal bans? There's an appeals framework in the codebase (sxbans.appeals.view permission, appeal-related messages in messages.yml), but it doesn't currently have a player-facing submission command or a staff review UI wired up — right now it's better thought of as a foundation for a future release than a ready-to-use feature. If you need appeals today, handling them through a Discord ticket system or a web form outside the plugin is the practical option.

Can I schedule a punishment to happen in the future? There's groundwork for this in the codebase, but no command currently exposes it. Not usable yet.

Does it support hex colors in messages? Yes, alongside the standard &-code colors.

What happens if I uninstall it — do bans stay in effect? Name-based bans and mutes are tracked entirely by SXBans, so removing the plugin removes the enforcement (the punishment record itself stays wherever your storage backend kept it, but nothing's checking it anymore). IP bans issued through SXBans are also added to the server's own built-in ban list, so those keep working even without the plugin installed, until manually removed.

Is there a Discord integration? Not built in currently. If you want punishment logs in Discord, a webhook plugin that watches your server log for SXBans' punishment log lines is the simplest bridge until native support exists.

Can I contribute / report bugs? Yes — see the Support/Issues section in the README.