AutoPunish V3.0Beta

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> [duration] [reason]     - Ban temporarily or permanently
/mute <player> [duration] [reason]    - Mute player's chat
/warn <player> [reason]               - 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: Full Command List

---

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

webpanel:
  enabled: true
  port: 8080  # HTTP + WebSocket unified

approval:
  enabled: true
  require-for-permanent: true

rules.yml - Define escalating punishment tiers

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. Full Terms

---

Author

Created by AlanTheDevv | GitHub

Acknowledgements: NanoHTTPD, Paper Team, Folia Team, Minecraft Community

---

---

📚 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 monitoring and error tracking

Modular Addon Architecture

• Optional Web Panel: Web interface available as separate addon (Integrated into Core in V3.0)
• Plugin API Extensions: Enhanced APIs for third-party integrations

Advanced Security

• Rate Limiting: API endpoint protection
• Input Validation: SQL injection protection
• Audit Trails: Enhanced logging

📋 Legacy Commands (V2.0)

Player Commands

• /punish <player> <rule> - Apply a punishment rule to a player
• /punishments [player] - View punishment history
• /severity [player] - Check current severity score

Administrative Commands

• /punishadmin list/approve/deny <id> - Manage punishment approvals
• /punishadmin resetrequests - View pending history reset requests
• /resethistory <player> <reason> - Request player history reset
• /rulemanagement <create|edit|delete> [rule] - Manage punishment rules
• /punishreload - Reload configuration files

🛡️ Security Features (V2.0)

• Permission-Based Access: All sensitive operations require specific permissions
• Approval Workflows: Critical actions need administrative approval
• Audit Logging: Complete action tracking for accountability
• Data Integrity: Soft deletes prevent accidental data loss

---

AutoPunish-WebPanel Addon (Legacy V1.0)

Note: In AutoPunish V3.0, the web panel is integrated directly into the core plugin. The information below applies to the legacy standalone addon.

🌟 Legacy Features

Web Dashboard

• Real-time Statistics: Live viewing of punishment statistics
• Player Management: Search and view history
• Rule Management: Web interface for creating rules
• Approval System: Process pending approvals

Security

• Multi-factor Authentication: Secure login
• Rate Limiting: API endpoint protection
• Input Validation: SQL injection protection

🔗 Legacy API Documentation

Core Endpoints

GET /api/health

Returns system health status and performance metrics.

GET /api/statistics

Returns comprehensive punishment statistics.

GET /api/punishments

Returns paginated list of punishments.

GET /api/players//history

Returns complete punishment history for a player.

---

End of Legacy Documentation