{"id":152142,"date":"2026-06-09T07:36:43","date_gmt":"2026-06-09T04:36:43","guid":{"rendered":"https:\/\/vpesports.com\/minecraft\/mods\/tartarus-punishments\/"},"modified":"2026-06-09T07:36:43","modified_gmt":"2026-06-09T04:36:43","slug":"tartarus-punishments","status":"publish","type":"mod","link":"https:\/\/vpesports.com\/minecraft\/mods\/tartarus-punishments\/","title":{"rendered":"Tartarus Punishments – Simple Ban \/ Mute \/ Prison System"},"content":{"rendered":"
\n

TartarusPunishements<\/h1>\n

Ban with Simplicity.<\/i><\/p>\n

\"Modrinth<\/p>\n

\n \"Version\"
\n \"Platform\"\n <\/p>\n<\/div>\n

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

—<\/p>\n

## \u2705 Key Features<\/p>\n

– **Punish & Forgive** \u2014 Apply or remove punishment options (ban, mute, prison, screenshare)
\n– **Temporary & Permanent Punishments** \u2014 Flexible duration support (permanent, timed)
\n– **Prison System** \u2014 Freeze and teleport players to a designated prison location
\n– **Screenshare Workflow** \u2014 Freeze players for screenshare checks with automatic unfreezing
\n– **Predefined Reasons + Custom Reasons** \u2014 Use built-in reason templates or define your own
\n– **Permission-based Controls** \u2014 Fine-grained permission nodes for each punishment type
\n– **Customizable Messages & Layouts** \u2014 Color or legacy codes, configurable message templates per reason
\n– **Automatic Default Messages** \u2014 Smart fallback messages if none provided (avoids server crashes or misconfig)
\n– **IP Banning** \u2014 Automatic IP bans with UUID-based bans
\n– **Inventory Clearing** \u2014 Optional inventory clearing on ban (configurable per reason)
\n– **Async Database Operations** \u2014 Non-blocking punishment checks for optimal server performance
\n– **Fully Configurable** \u2014 All settings exposed in config file; easy to tailor for your server style
\n– **Easy Setup & Lightweight** \u2014 Drop JAR into plugins folder on Bukkit\/Spigot\/Paper\/Purpur; ready to go
\n– **Active Development & Changelog** \u2014 Frequent updates, bug-fixes, and improvements<\/p>\n

## \ud83c\udfaf Performance Features (v0.2.2+)<\/p>\n

Tartarus Punishments is designed for optimal server performance:
\n– **Async Player Lookups**: Player searches run off the main thread
\n– **Async Database Checks**: Punishment verification doesn’t block the server
\n– **Async Join Processing**: Player login data loads asynchronously
\n– **Optimized Tab Completion**: Only searches online players for instant results<\/p>\n

Your server will remain responsive even during heavy moderation activity!
\n—<\/p>\n

## \u2699\ufe0f Supported Platforms & Versions<\/p>\n

– **Loaders:** Bukkit, Spigot, Paper, Purpur
\n– **Minecraft Versions:** 1.21.x
\n– Java 21+<\/p>\n

Compatible on any Bukkit-based server \u2014 from small SMPs to mid-sized communities.<\/p>\n

—<\/p>\n

### Permissions
\n– `tartarus.punishments.punish` \u2013 Punish a player
\n– `tartarus.punishments.forgive` \u2013 Remove a punishment
\n– `tartarus.punishments.banlist` \u2013 View the ban list
\n– `tartarus.punishments.prison` \u2013 Imprison (freeze) players
\n– `tartarus.punishments.setprison` \u2013 Set the prison location
\n– `tartarus.punishments.screenshare` \u2013 Freeze players for screenshares
\n– `tartarus.punishments.*` \u2013 All punishment permissions<\/p>\n

### Commands
\n– `\/punish ` (aliases: `\/ban`, `\/banplayer`)
\n– `\/forgive ` (aliases: `\/unban`, `\/pardon`)
\n– `\/banlist` (aliases: `\/bans`)
\n– `\/prison `
\n– `\/setprison`
\n– `\/screenshare `<\/p>\n

—<\/p>\n

## \ud83d\udca1 Why Use Tartarus Punishments?<\/p>\n

| \u2714\ufe0f Benefit | Details |
\n|———–|———|
\n| **Simple yet powerful** | Provides comprehensive moderation without bloat or complexity |
\n| **Customizable & flexible** | Customize reasons, durations, messages \u2014 fits any server style |
\n| **Permission-driven** | Control who can punish who, integrate with permission plugins |
\n| **Performance optimized** | Async operations prevent server lag during punishment checks |
\n| **Lightweight & easy** | SQLite database, minimal dependencies, no complex setup |
\n| **Active & maintained** | Regular updates and bug fixes ensure reliability |<\/p>\n

For servers that don’t need heavy all-in-one moderation suites, but want a clean, dependable punishment system \u2014 Tartarus Punishments hits the sweet spot.<\/p>\n

—<\/p>\n

## \ud83d\udd04 Recent Changelog (since 0.2.0)<\/p>\n

### v0.2.2 (Latest)
\n– **Performance Optimization**: Moved all database operations to async threads for zero main-thread blocking
\n– **Code Refactoring**: Introduced `TartarusCommand` base class for better code reusability
\n– **Player Lookup Optimization**: Created `PlayerFinder` utility for efficient async player searches
\n– **Join Listener Optimization**: Async punishment data loading prevents login freezes
\n– **Tab Completion Fix**: Commands now properly support tab completion via `TabExecutor`
\n– **Code Cleanup**: Removed ~53 lines of unnecessary verbose comments for better maintainability<\/p>\n

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

Full changelog available in \u201cVersions\u201d tab.<\/p>\n

—<\/p>\n

## \ud83d\udd27 Installation<\/p>\n

1. Download the latest `TartarusPunishments-*.jar` from Releases on Modrinth
\n2. Place it in your server\u2019s `plugins` folder (Bukkit\/Paper\/Spigot\/Purpur)
\n3. (Re)start the server
\n4. Configure `config.yml` as needed \u2014 or use defaults
\n5. Use permissions and commands to manage punishments <\/p>\n

—<\/p>\n

*Licensed ARR \u2014 see project page for details.* <\/p>\n","protected":false},"excerpt":{"rendered":"

A simple ban manager with predefined reasons and timeframes<\/p>\n","protected":false},"featured_media":152143,"template":"","meta":{"_minecraft_slug":"tartarus-punishments","_minecraft_project_id":"DbYPs9vY","_minecraft_author":"cyb3rz3us","_minecraft_license":"LicenseRef-All-Rights-Reserved","_minecraft_downloads":348,"_minecraft_follows":2,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"tartarus-punishments.zip","_minecraft_size_bytes":127508576,"_minecraft_version_count":9,"_minecraft_updated_at":"2026-05-16T11:26:02.354467Z","_minecraft_date_created":"2025-11-22T10:25:08.827048Z","_minecraft_date_modified":"2026-04-13T20:23:23.230501Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/tartarus-punishments","_minecraft_icon_attachment_id":152143,"_minecraft_imported_at":"2026-06-09T04:36:44+00:00","_minecraft_import_hash":"b67622f0a5577690ad59b7da46a3a551","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,125,126,127,128,129,92],"mod_loader":[130,131,132,133,134],"minecraft_version":[62,37,40,41,73,74,38,78,79,80,81,82,83,167,163],"class_list":["post-152142","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-bukkit","mod_category-folia","mod_category-management","mod_category-paper","mod_category-purpur","mod_category-spigot","mod_category-utility","mod_loader-bukkit","mod_loader-folia","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9","minecraft_version-26-1","minecraft_version-26-1-1","minecraft_version-26-1-2"],"yoast_head":"\nTartarus Punishments - Simple Ban \/ Mute \/ Prison System - Minecraft<\/title>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/vpesports.com\/minecraft\/mods\/tartarus-punishments\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"Tartarus Punishments - Simple Ban \/ Mute \/ Prison System - Minecraft\" \/>\n<meta property=\"og:description\" content=\"A simple ban manager with predefined reasons and timeframes\" \/>\n<meta property=\"og:url\" content=\"https:\/\/vpesports.com\/minecraft\/mods\/tartarus-punishments\/\" \/>\n<meta property=\"og:site_name\" content=\"Minecraft\" \/>\n<meta property=\"og:image\" content=\"https:\/\/img.shields.io\/badge\/Modrinth-TartarusPunishments-4a6cf7?style=for-the-badge&logo=modrinth\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data1\" content=\"3 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\\\/\\\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/tartarus-punishments\\\/\",\"url\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/tartarus-punishments\\\/\",\"name\":\"Tartarus Punishments - Simple Ban \\\/ Mute \\\/ Prison System - Minecraft\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/#website\"},\"primaryImageOfPage\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/tartarus-punishments\\\/#primaryimage\"},\"image\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/tartarus-punishments\\\/#primaryimage\"},\"thumbnailUrl\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/wp-content\\\/uploads\\\/2026\\\/06\\\/tartarus-punishments-icon-227633f87d4c8213e49b5e33c9939feb9012424c_96.webp\",\"datePublished\":\"2026-06-09T04:36:43+00:00\",\"breadcrumb\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/tartarus-punishments\\\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/tartarus-punishments\\\/\"]}]},{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/tartarus-punishments\\\/#primaryimage\",\"url\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/wp-content\\\/uploads\\\/2026\\\/06\\\/tartarus-punishments-icon-227633f87d4c8213e49b5e33c9939feb9012424c_96.webp\",\"contentUrl\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/wp-content\\\/uploads\\\/2026\\\/06\\\/tartarus-punishments-icon-227633f87d4c8213e49b5e33c9939feb9012424c_96.webp\",\"width\":96,\"height\":96},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/tartarus-punishments\\\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Mods\",\"item\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Tartarus Punishments – Simple Ban \\\/ Mute \\\/ Prison System\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/#website\",\"url\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/\",\"name\":\"Minecraft\",\"description\":\"\",\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-US\"}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"Tartarus Punishments - Simple Ban \/ Mute \/ Prison System - Minecraft","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/vpesports.com\/minecraft\/mods\/tartarus-punishments\/","og_locale":"en_US","og_type":"article","og_title":"Tartarus Punishments - Simple Ban \/ Mute \/ Prison System - Minecraft","og_description":"A simple ban manager with predefined reasons and timeframes","og_url":"https:\/\/vpesports.com\/minecraft\/mods\/tartarus-punishments\/","og_site_name":"Minecraft","og_image":[{"url":"https:\/\/img.shields.io\/badge\/Modrinth-TartarusPunishments-4a6cf7?style=for-the-badge&logo=modrinth","type":"","width":"","height":""}],"twitter_card":"summary_large_image","twitter_misc":{"Est. reading time":"3 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/vpesports.com\/minecraft\/mods\/tartarus-punishments\/","url":"https:\/\/vpesports.com\/minecraft\/mods\/tartarus-punishments\/","name":"Tartarus Punishments - Simple Ban \/ Mute \/ Prison System - Minecraft","isPartOf":{"@id":"https:\/\/vpesports.com\/minecraft\/#website"},"primaryImageOfPage":{"@id":"https:\/\/vpesports.com\/minecraft\/mods\/tartarus-punishments\/#primaryimage"},"image":{"@id":"https:\/\/vpesports.com\/minecraft\/mods\/tartarus-punishments\/#primaryimage"},"thumbnailUrl":"https:\/\/vpesports.com\/minecraft\/wp-content\/uploads\/2026\/06\/tartarus-punishments-icon-227633f87d4c8213e49b5e33c9939feb9012424c_96.webp","datePublished":"2026-06-09T04:36:43+00:00","breadcrumb":{"@id":"https:\/\/vpesports.com\/minecraft\/mods\/tartarus-punishments\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/vpesports.com\/minecraft\/mods\/tartarus-punishments\/"]}]},{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/vpesports.com\/minecraft\/mods\/tartarus-punishments\/#primaryimage","url":"https:\/\/vpesports.com\/minecraft\/wp-content\/uploads\/2026\/06\/tartarus-punishments-icon-227633f87d4c8213e49b5e33c9939feb9012424c_96.webp","contentUrl":"https:\/\/vpesports.com\/minecraft\/wp-content\/uploads\/2026\/06\/tartarus-punishments-icon-227633f87d4c8213e49b5e33c9939feb9012424c_96.webp","width":96,"height":96},{"@type":"BreadcrumbList","@id":"https:\/\/vpesports.com\/minecraft\/mods\/tartarus-punishments\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/vpesports.com\/minecraft\/"},{"@type":"ListItem","position":2,"name":"Mods","item":"https:\/\/vpesports.com\/minecraft\/mods\/"},{"@type":"ListItem","position":3,"name":"Tartarus Punishments – Simple Ban \/ Mute \/ Prison System"}]},{"@type":"WebSite","@id":"https:\/\/vpesports.com\/minecraft\/#website","url":"https:\/\/vpesports.com\/minecraft\/","name":"Minecraft","description":"","potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/vpesports.com\/minecraft\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"}]}},"_links":{"self":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod\/152142","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod"}],"about":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/types\/mod"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/media\/152143"}],"wp:attachment":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/media?parent=152142"}],"wp:term":[{"taxonomy":"mod_category","embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod_category?post=152142"},{"taxonomy":"mod_loader","embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod_loader?post=152142"},{"taxonomy":"minecraft_version","embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/minecraft_version?post=152142"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}