AutoPunish

Minecraft 版本： 1.8 1.8.1 1.8.2 1.8.3 1.8.4 1.8.5 1.8.6 1.8.7 1.8.8 1.8.9 1.9 1.9.1 1.9.2 1.9.3 1.9.4 1.10 1.10.1 1.10.2 1.11 1.11.1 1.11.2 1.12 1.12.1 1.12.2 1.13 1.13.1 1.13.2 1.14 1.14.1 1.14.2 1.14.3 1.14.4 1.15 1.15.1 1.15.2 1.16 1.16.1 1.16.2 1.16.3 1.16.4 1.16.5 1.17 1.17.1 1.18 1.18.1 1.18.2 1.19 1.19.1 1.19.2 1.19.3 1.19.4 1.20 1.20.1 1.20.2 1.20.3 1.20.4 1.20.5 1.20.6 1.21 1.21.1 1.21.2 1.21.3 1.21.4 1.21.5 1.21.6 1.21.7 1.21.8 1.21.9 1.21.10 1.21.11

平台： bukkit folia paper purpur spigot

标签： game-mechanics management utility

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