Перейти к содержимому
Mineforgian

Tartarus Punishments - Simple Ban / Mute / Prison System

A simple ban manager with predefined reasons and timeframes

Загрузки
507
Подписчики
2
Обновлён
13 апреля 2026 г.
Лицензия
All-Rights-Reserved

Опубликован 20 ноября 2025 г.

TartarusPunishements

Ban with Simplicity.

Modrinth Tracking

Version Platform

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.

Ченджлог

0.2.7Релиз26.1, 26.1.1, 26.1.2 · 13 апреля 2026 г.
  • Shadow Punishment System:
    • Shadow Ban: Silent punishment simulating high lag (60% block failure), rubberbanding, and interaction issues.
    • Shadow Mute: Ghost chat system where players see their own messages, but no one else does.
  • Staff Accountability Tools:
    • Evidence System: New /evidence add <player> <url> command to attach proof to punishment records.
    • Staff Notes: New /note <add|list> <player> command for persistent internal staff communication.
  • Minecraft 26.1 & Java 25 Support:
    • Full compatibility with the new 2026.1 year-based versioning scheme.
    • Hybrid Build: Compiled with Java 21 bytecode for high compatibility while supporting Java 25 runtimes.
    • Updated to Adventure 4.26.1 to resolve API symbol conflicts.
    • Modernized attribute handling to Attribute.MAX_HEALTH for safe long-term support.
  • Performance & Architecture:
    • Event-Driven Prison System: Transitioned FreezeManager from polling to event-driven, reducing CPU overhead.
    • Punishment Caching: Added PunishmentCache to optimize high-frequency ban checks for JanusMCD.
    • JanusMCD Robustness: Automatic 5-second retry loop for service registration during boot.
    • TartarusAPI: Initial public release of the plugin API for cross-plugin integration.
  • Bug Fixes:
    • Resolved a race condition where the Blindness effect could "stick" to players after release.
0.2.6Релиз1.21.9, 1.21.10, 1.21.11 · 18 февраля 2026 г.

Tartarus Punishments v0.2.6 - The "Shadow" Update

The ban hammer just got a lot smarter (and sneakier). This update introduces psychological warfare against cheaters and better tools for staff.

New Feature: Shadow Punishments

Why ban them when you can drive them crazy?

  • Shadow Ban: The player can join, but...
    • Blocks reappear instantly (60% chance)
    • Items refuse to work (40% chance)
    • Random rubberbanding when moving (5% chance)
    • They think the server is lagging, but it's just them.
  • Shadow Mute: They can type in chat, and it looks normal to them, but nobody else sees it.

Staff Tools

  • Evidence System: /evidence add <player> <url> - Attach clips, screenshots, or logs directly to a player's latest punishment. Never lose proof again.
  • Staff Notes: /note add <player> <text> - Leave persistent notes for other staff members. Great for tracking suspicions or warnings.
  • Review: /checkpunishments <player> now shows attached evidence and staff notes!

Under the Hood

  • JanusMCD Integration: Now fully synced with the Janus Panopticon for web/Discord viewing.
0.2.5Релиз1.21.9, 1.21.10, 1.21.11 · 19 января 2026 г.

Bug Fix: Fixed permission issues for /checkpunishments. Permissions: Switched to JDA permissions for Discord commands.

0.2.4Релиз1.21.9, 1.21.10, 1.21.11 · 16 января 2026 г.

v0.2.4

  • Punishment Scaling System: Introduced 'Fractal' and 'Linear' scaling modes for dynamic punishment durations based on history. Linear is a simple count, if they get 3 (Configurable) of the same ban reason, its permenant. Fractal are steps, each one make the punishment more severe until all steps are exhausted.
  • New Command /checkpunishments: Allows staff to view a player's punishment history and scaling status (In-Game & Discord).
  • Discord Integration:
    • Implemented rich Discord Embeds for punishment checks (requires JanusMCD v0.2.0).
    • Enhanced autocomplete to search Online players, Active Bans, and Offline players.
  • Forgive Enhancement: Added /forgive <player> clearlast to forgive and remove the last punishment from history (undo strike).
  • System: Updated to JanusMCD v0.2.0 API.
0.2.3Релиз1.21.9, 1.21.10, 1.21.11 · 21 декабря 2025 г.
  • fixed missing permission node extension. Allows ban-reasons to be set to the 3 permissions Moderator/Admin/Helper
0.2.2Релиз1.21.9, 1.21.10, 1.21.11 · 15 декабря 2025 г.
  • Fixed malformed YML file causing issues with ban-layout.
  • IP Bans are automatically processed with any ban-reason (Cannot be removed)
  • Added screenshare workflow. The process is managed end to end, admin runs it and if the player leaves they are automatically placed on a ban with their inventory cleared.
0.2.1Релиз1.21.9, 1.21.10, 1.21.11 · 27 ноября 2025 г.

v0.2.1

  • Added configurable ban message layout with named colours or legacy codes, including placeholder docs.
  • Enabled custom ban message lines to default colours smartly (named, codes, or leading codes in text).
  • Auto-populate ban-message defaults into existing configs when missing.
  • Updated plugin metadata to version 0.2.1.
0.2.0Релиз1.21.8, 1.21.9, 1.21.10 · 22 ноября 2025 г.
  1. Commands updated from ban/unban to punish/forgive
  2. Added per ban-reason permissions (Configure with a permission manager)
  3. Added customReason so you can customise the message, configured on each ban-reason in config.yml
  4. Added Spigot/Bukkit support

Комментарии

Загружаем…