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

Install: Drop AutoPunish-V3.0Beta.jar into plugins/ folder
Start: Server generates configs and admin token (check console)
Access: Web panel at http://your-ip:8080
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

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

Need Help? Contact author for support | Version: V3.0Beta | Updated: January 2026

📚 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

AutoPunish