Tartarus Punishments - Simple Ban / Mute / Prison System

<div align="center"> <h1>TartarusPunishements</h1> <p><i>Ban with Simplicity.</i></p>

<p> <a href="https://modrinth.com/plugin/tartarus-punishments"> <img src="https://img.shields.io/badge/Modrinth-TartarusPunishments-4a6cf7?style=for-the-badge&logo=modrinth" alt="Modrinth Tracking"> </a> </p> <p> <img src="https://img.shields.io/badge/Version-0.2.5-darkred?style=for-the-badge" alt="Version"> <img src="https://img.shields.io/badge/Paper-%3E%3D1.21-green?style=for-the-badge" alt="Platform"> </p> </div>

Tartarus Punishments is a lightweight, permission-based moderation plugin for Minecraft servers (Bukkit/Paper/Purpur/Spigot). Easily manage bans & temporary punishments with predefined or custom reasons — perfect for small to medium-sized servers needing a clean, configurable punishment system.

---

✅ Key Features

- Active Development & Changelog — Apply or remove punishment options (ban, mute, prison, screenshare) - Active Development & Changelog — Flexible duration support (permanent, timed) - Active Development & Changelog — Freeze and teleport players to a designated prison location - Active Development & Changelog — Freeze players for screenshare checks with automatic unfreezing - Active Development & Changelog — Use built-in reason templates or define your own - Active Development & Changelog — Fine-grained permission nodes for each punishment type - Active Development & Changelog — Color or legacy codes, configurable message templates per reason - Active Development & Changelog — Smart fallback messages if none provided (avoids server crashes or misconfig) - Active Development & Changelog — Automatic IP bans with UUID-based bans - Active Development & Changelog — Optional inventory clearing on ban (configurable per reason) - Active Development & Changelog — Non-blocking punishment checks for optimal server performance - Active Development & Changelog — All settings exposed in config file; easy to tailor for your server style - Active Development & Changelog — Drop JAR into plugins folder on Bukkit/Spigot/Paper/Purpur; ready to go - Active Development & Changelog — Frequent updates, bug-fixes, and improvements

🎯 Performance Features (v0.2.2+)

Tartarus Punishments is designed for optimal server performance: - Optimized Tab Completion: Player searches run off the main thread - Optimized Tab Completion: Punishment verification doesn't block the server - Optimized Tab Completion: Player login data loads asynchronously - Optimized Tab Completion: Only searches online players for instant results

Your server will remain responsive even during heavy moderation activity! ---

⚙️ Supported Platforms & Versions

- Minecraft Versions: Bukkit, Spigot, Paper, Purpur - Minecraft Versions: 1.21.x - Java 21+

Compatible on any Bukkit-based server — from small SMPs to mid-sized communities.

---

Permissions

- `tartarus.punishments.punish` – Punish a player - `tartarus.punishments.forgive` – Remove a punishment - `tartarus.punishments.banlist` – View the ban list - `tartarus.punishments.prison` – Imprison (freeze) players - `tartarus.punishments.setprison` – Set the prison location - `tartarus.punishments.screenshare` – Freeze players for screenshares - `tartarus.punishments.*` – All punishment permissions

Commands

- `/punish <player> <reason>` (aliases: `/ban`, `/banplayer`) - `/forgive <player>` (aliases: `/unban`, `/pardon`) - `/banlist` (aliases: `/bans`) - `/prison <player> <duration>` - `/setprison` - `/screenshare <player>`

---

💡 Why Use Tartarus Punishments?

| ✔️ Benefit | Details | |-----------|---------| | Active & maintained | Provides comprehensive moderation without bloat or complexity | | Active & maintained | Customize reasons, durations, messages — fits any server style | | Active & maintained | Control who can punish who, integrate with permission plugins | | Active & maintained | Async operations prevent server lag during punishment checks | | Active & maintained | SQLite database, minimal dependencies, no complex setup | | Active & maintained | Regular updates and bug fixes ensure reliability |

For servers that don't need heavy all-in-one moderation suites, but want a clean, dependable punishment system — Tartarus Punishments hits the sweet spot.

---

🔄 Recent Changelog (since 0.2.0)

v0.2.2 (Latest)

- Code Cleanup: Moved all database operations to async threads for zero main-thread blocking - Code Cleanup: Introduced `TartarusCommand` base class for better code reusability - Code Cleanup: Created `PlayerFinder` utility for efficient async player searches - Code Cleanup: Async punishment data loading prevents login freezes - Code Cleanup: Commands now properly support tab completion via `TabExecutor` - Code Cleanup: Removed ~53 lines of unnecessary verbose comments for better maintainability

- Added configurable ban message layouts supporting named colours or legacy codes - Custom ban message lines now support smart defaulting if colours are omitted - Auto-populate missing `ban-message` config fields on update to avoid breaking configurations - Metadata and compatibility update for 1.21.x

Full changelog available in “Versions” tab.

---

🔧 Installation

1. Download the latest `TartarusPunishments-*.jar` from Releases on Modrinth 2. Place it in your server’s `plugins` folder (Bukkit/Paper/Spigot/Purpur) 3. (Re)start the server 4. Configure `config.yml` as needed — or use defaults 5. Use permissions and commands to manage punishments

---

*Licensed ARR — see project page for details.*