AliienPunishmentGUI | LiteBans Addon v1.0.4

AliienPunishmentGUI | LiteBans Addon

If you want to help your staff team with avoiding formatting mistakes, forgetting proper punishment lengths, or misapplying rules, AliienPunishmentGUI is the best, highly optimized graphical user interface (GUI) addon designed exclusively for LiteBans.

What exactly does this plugin do?
Instead of forcing your staff to memorize complex commands and punishment durations or to look it up in documentation every time it is needed (e.g., typing out /ban 30d Hacking), AliienPunishmentGUI provides an intuitive, interactive menu accessible via a single simple command. When a staff member selects a rule category (like "Chat Spam" or "Cheating"), the plugin automatically reads the rule-breaker's LiteBans database history. It then instantly applies the correct, escalated punishment based on the ladder system you configure (For example: 1st Offense = Warning ➔ 2nd Offense = 1-Hour Mute ➔ 3rd Offense = Permanent Mute).

Why should you purchase and use AliienPunishmentGUI?
Running a big server requires consistent, unbiased moderation. When staff members have to manually type out commands, it is very common to commit errors, leading to inconsistent punishment, community backlash, and higher-ups fixing the punishments instead of handling other high-priority tasks. This plugin standardizes your entire punishment system, ensuring 100% accuracy and fairness across your network. By eliminating manual command typing, you encourage your staff team to moderate faster, easier, and more confidently. Combined with advanced safety nets like session-locking (preventing two staff members from punishing the same player simultaneously) and a strictly asynchronous, zero-lag system, this is the best moderation upgrade your staff team needs.

---

Core Features

• Smart Punishment Ladders: The GUI automatically hooks into the user’s database history. It reads previous offenses to ensure the correct escalated punishment is applied every single time.
• Folia & Paper Support: For the first time, other than paper, my plugin is fully supporting Folia from the start. A lot of the tests I made on this plugin were made on Folia so be 100% sure that everything would work fine from the start.
• Customization: Every single menu, item, and message is in your control.
  1. Full support for modern formatting (MiniMessage, Hex, and legacy codes).
  2. Swap out item icons using any Vanilla material or implement Custom Model Data for custom resource pack integration.
  3. Design your own in-menu rule explanations and layout structures.
• Session-Locking: Prevents duplicate punishments by completely blocking multiple staff members from editing or punishing the same player simultaneously.
• Confirmation GUIs: A toggleable safety menu to ensure staff double-check their actions before confirming a ban or mute.
• All-In-One Moderation: Handle bans, mutes, warnings, kicks, and even un-punish commands without ever leaving the interface.

---

Requirements

1. Java: Java 21 or higher.
2. Server Software: Paper, Folia, Spigot, or Purpur (1.21+).
3. Dependencies: LiteBans, as well as a permissions plugin (e.g. LuckPerms)

---

Commands & Permissions

AliienPunishmentGUI is designed to be plug-and-play without bloating your server with unnecessary commands.

Commands:

1. /punish — Opens the menu to punish your target. (Permission: aliien.punish.use)
2. /punish reload — Reloads the plugin configuration. (Permission: aliien.punish.reload)

Permissions (All Default to OP):

1. aliien.punish.use — Allows the user to open the punishment menu.
2. aliien.punish.reload — Allows the user to reload the plugin.
3. aliien.punish.version-notify — Receive in-game notifications for new plugin updates.

---

Configuration Example

Setting up custom rules and punishment ladders is incredibly straightforward. Here is an example of how you can configure a progressive "Spam" rule using standard LiteBans punishment types:

---

Disclaimer
AliienPunishmentGUI is an unofficial addon and is not officially affiliated with LiteBans. Likewise, LiteBans is not officially affiliated with this project. Please direct any issues or feature requests regarding this GUI addon to our Discord support tickets. Any issues regarding the core LiteBans plugin itself should be directed to the official LiteBans developer.

---

Need help, found a bug, or have a suggestion? Do not use the review section for bug reports! Head over to our Discord Server and open a ticket. Use our Documentation to learn how to use any of my plugins! If you enjoy the plugin and it helps your staff team, a 5-star review is greatly appreciated!