<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 - **Punish & Forgive** — Apply or remove punishment options (ban, mute, prison, screenshare) - **Temporary & Permanent Punishments** — Flexible duration support (permanent, timed) - **Prison System** — Freeze and teleport players to a designated prison location - **Screenshare Workflow** — Freeze players for screenshare checks with automatic unfreezing - **Predefined Reasons + Custom Reasons** — Use built-in reason templates or define your own - **Permission-based Controls** — Fine-grained permission nodes for each punishment type - **Customizable Messages & Layouts** — Color or legacy codes, configurable message templates per reason - **Automatic Default Messages** — Smart fallback messages if none provided (avoids server crashes or misconfig) - **IP Banning** — Automatic IP bans with UUID-based bans - **Inventory Clearing** — Optional inventory clearing on ban (configurable per reason) - **Async Database Operations** — Non-blocking punishment checks for optimal server performance - **Fully Configurable** — All settings exposed in config file; easy to tailor for your server style - **Easy Setup & Lightweight** — 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: - **Async Player Lookups**: Player searches run off the main thread - **Async Database Checks**: Punishment verification doesn't block the server - **Async Join Processing**: 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 - **Loaders:** 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 | |-----------|---------| | **Simple yet powerful** | Provides comprehensive moderation without bloat or complexity | | **Customizable & flexible** | Customize reasons, durations, messages — fits any server style | | **Permission-driven** | Control who can punish who, integrate with permission plugins | | **Performance optimized** | Async operations prevent server lag during punishment checks | | **Lightweight & easy** | 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) - **Performance Optimization**: Moved all database operations to async threads for zero main-thread blocking - **Code Refactoring**: Introduced `TartarusCommand` base class for better code reusability - **Player Lookup Optimization**: Created `PlayerFinder` utility for efficient async player searches - **Join Listener Optimization**: Async punishment data loading prevents login freezes - **Tab Completion Fix**: 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 col