AdvancedBanZ

***# Please note: This is a fork of the original AdvancedBan or AdvancedBanX plugin. Do not request support in the official AdvancedBan Discord; instead, seek help on the GitHub repository's issues page.*** ### Description AdvancedBanZ is a fork of AdvancedBanX, which itself is a modernized update of the original AdvancedBan plugin developed by Leoko. It is an all-in-one punishment system supporting warnings (warn), temporary warnings (tempwarn), mutes, temporary mutes (tempmute), bans, temporary bans (tempban), IP bans (ipban), and kicks. The plugin also provides a player history feature to view past punishment records. The plugin supports configurable time and message templates, automatically calculating and increasing punishment durations based on specific reasons. AdvancedBanZ provides complete message files, allowing you to freely modify and translate all prompts, and includes a detailed main configuration file with numerous practical options. Currently, AdvancedBanZ supports Bukkit (Spigot/Paper) and BungeeCord platforms, and supports both MySQL and local file storage for data persistence. ### Installation Steps 1. Download the plugin from *(https://modrinth.com/plugin/advancedbanz)*. 2. Place the plugin into your `plugins` folder (applicable for both Bukkit and BungeeCord). 3. Reload or restart your server. 4. Use `/advancedban` to check if the plugin loaded successfully. 5. Configure as needed and start using it. > **Optional Tip**: If you encounter issues connecting to the database, try adjusting the MySQL version to 5.X. ### Command Reference <details open> <summary>View All Commands</summary> Legend: - ` <Optional>`: `|` means "or", `-s` indicates a silent punishment (does not notify others) - `/kick<-s> <Reason | @LayoutName>` Kick a player - `/ban /mute /warn /note <-s> <Reason | @LayoutName>` Ban / Mute / Warn a player, or add a note to them - `/banip <-s> <Reason | @LayoutName>` Ban a player's IP (if a player name is entered, the cached IP is used) - `/tempban /tempmute /tempwarn <-s> <Reason | @LayoutName>` Issue a temporary punishment with a specified duration or auto-calculated duration based on a time layout - `/tempipban <-s> <Reason | @LayoutName>` Temporarily ban a player's IP (Alias: `/tipban`) - `/change-reason ` Modify the reason based on the punishment ID - `/change-reason ` Modify the reason for a player's current ban or mute - `/unban /unmute ` Unban or unmute a player - `/unwarn /unnote ` Remove a warning or note - `/unwarn /unnote clear ` Remove all warnings or notes for a player - `/unpunish ` Remove any type of punishment record - `/warns /notes <Player>` View your own or another player's list of warnings/notes - `/check ` Get player status: UUID / IP / Country / Ban Status / Mute Status / Warning Count / Note Count - `/banlist <Page>` View all currently active punishments - `/history <Page>` View a player's historical punishment records (requires permission `ab.history`) - `/advancedban reload` Reload message files and some settings - `/advancedban help` Display all commands and their brief descriptions - `/systemprefs` Display system information helpful for configuration </details> ### Permission Nodes <details open> <summary>All Permissions</summary> ```yaml ab.kick.use - /kick ab.kick.exempt - Exempt from being kicked ab.notify.kick - Receive kick notifications ab.ban.perma - /ban ab.ban.temp - /tempban ab.ban.undo - /unban ab.ban.exempt - Exempt from being banned ab.notify.ban - Receive ban notifications ab.undoNotify.ban - Receive unban notifications ab.notify.tempban - Receive temporary ban notifications ab.ipban.perma - /ipban ab.ipban.temp - /tempipban ab.notify.ipban - Receive IP ban notifications ab.tempipban.exempt - Exempt from temporary IP bans ab.notify.tempipban - Receive temporary IP ban notifications ab.mute.perma - /mute ab.mute.temp - /tempmute ab.mute.undo - /unmute ab.mute.exempt - Exempt from being muted ab.notify.mute - Receive mute notifications ab.undoNotify.mute - Receive unmute notifications ab.notify.tempmute - Receive temporary mute notifications ab.warn.perma - /warn ab.warn.temp - /tempwarn ab.warn.undo - /unwarn ab.warn.exempt - Exempt from being warned ab.notify.warn - Receive warning notifications ab.undoNotify.warn - Receive unwarn notifications ab.notify.tempwarn - Receive temporary warning notifications ab.note.use - /note ab.note.undo - /unnote ab.note.exempt - Exempt from having notes added ab.notify.note - Receive note notifications ab.undoNotify.note - Receive note removal notifications ab.all.undo - /unpunish ab.warns.own - /warns (view self) ab.warns.other - /warns PLAYER (view others) ab.notes.own - /n