AutoPunish

# AutoPunish V3.0Beta (https://img.shields.io/badge/Paper-1.16--1.21-blue.svg)](https://papermc.io) (https://img.shields.io/badge/Spigot-1.16--1.21-orange.svg)](https://www.spigotmc.org) (https://img.shields.io/badge/Purpur-1.16--1.21-purple.svg)](https://purpurmc.org) (https://img.shields.io/badge/Bukkit-1.16--1.21-red.svg)](https://bukkit.org) (https://img.shields.io/badge/Folia-1.21.x-green.svg)](https://papermc.io/downloads/folia) (https://img.shields.io/badge/License-All%20Rights%20Reserved-red.svg)](#license) (https://img.shields.io/badge/Java-21+-red.svg)](https://adoptium.net/) **All-in-one moderation system with web panel, rule-based punishment, word filtering, and approval workflows.** AutoPunish V3 eliminates the need for multiple moderation plugins while providing server admins with powerful automation, a real-time web dashboard, and comprehensive player history tracking. Built for performance and Folia-compatible from the ground up. --- ## Quick Start 1. **Install:** Drop `AutoPunish-V3.0Beta.jar` into `plugins/` folder 2. **Start:** Server generates configs and admin token (check console) 3. **Access:** Web panel at `http://your-ip:8080` 4. **Configure:** Edit files in `plugins/AutoPunish/` as needed **Requirements:** Java 21+, Minecraft 1.16-1.21 (Paper/Spigot/Purpur/Bukkit/Folia) --- ## Key Features - **Rule-Based Escalation** - Automatic tier progression for repeat offenders - **Web Dashboard** - Real-time stats, bans, mutes, approvals (single port: HTTP + WebSocket) - **Word Filtering** - Auto-detect spam, profanity, advertising with regex support - **Approval Workflow** - Review serious punishments before they're applied - **Folia Compatible** - Native multi-threaded server support - **Complete History** - Full audit trail of every moderation action --- ## Essential Commands ``` /ban <player> - Ban temporarily or permanently /mute <player> - Mute player's chat /warn <player> - Issue warning (auto-escalates) /case <player> <rule> - Apply rule-based punishment /history <player> - View complete punishment history /autopunish reload - Hot reload all configs /autopunish approve <id> - Approve pending punishment ``` **View all 16 commands:** (https://github.com/AlanTheDevv/) --- ## Usage Examples ### Temporary Ban ``` /ban Griefer123 7d Destroying player builds ``` ### Rule-Based Punishment (Auto-Escalates) ``` /case Spammer chat_violation ``` First offense: Warning → Second: 1h mute → Third: 1d mute → ... → Fifth: Permanent ban ### Approval Workflow ``` Staff: /ban Hacker permanent Flight hacks System: Queued for approval (ID: abc123) Admin: /autopunish approve abc123 System: Ban applied ``` --- ## Configuration **config.yml** - Main settings ```yaml webpanel: enabled: true port: 8080 # HTTP + WebSocket unified approval: enabled: true require-for-permanent: true ``` **rules.yml** - Define escalating punishment tiers ```yaml rules: chat_violation: tiers: 1: { action: warn } 2: { action: mute, duration: "1h" } 5: { action: ban, duration: "permanent" } ``` **filter.yml** - Auto-detect and punish filtered words **messages.yml** - Customize all player-facing messages --- ## Web Panel Access at `http://your-server-ip:8080` **Public Pages:** Dashboard stats, ban/mute lists, player lookup, server rules **Admin Panel:** Approve/deny punishments (token required - check console on first start) Real-time updates via WebSocket when punishments are issued. --- ## License **All Rights Reserved** © 2026 AlanTheDevv Unauthorized copying, distribution, or modification prohibited. Use on your own server permitted. (#) --- ## Author Created by **AlanTheDevv** | (https://github.com/AlanTheDevv/) **Acknowledgements:** NanoHTTPD, Paper Team, Folia Team, Minecraft Community --- <div align="center"> **Need Help?** Contact author for support | **Version:** V3.0Beta | **Updated:** January 2026 </div> <br> <br> <hr> # 📚 Legacy Documentation (V2.0 Core) *The documentation below applies to the legacy version 2.0 of AutoPunish. It is provided here for reference during the migration to V3.0Beta.* # AutoPunish - Advanced Minecraft Punishment System (V2.0) A production-grade Minecraft plugin featuring automated moderation, advanced escalation systems, real-time synchronization, and comprehensive health monitoring. ## 🌟 What's New in V2.0 ### Production Monitoring & Performance - **Health Monitoring System**: Real-time system health checks with database, cache, and resource monitoring - **Load Testing Suite**: Automated API performance benchmarking - **3-SQLite CQRS Architecture**: Advanced caching with real-time synchronization - **Performance Analytics**: Request monitori