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

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.