TartarusPunishements

Ban with Simplicity.

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 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

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

Licensed ARR — see project page for details.

Tartarus Punishments - Simple Ban / Mute / Prison System

📖About Tartarus Punishments - Simple Ban / Mute / Prison System