AutoPunish V3.0Beta
集管理于一体的系统,包含 Web 面板、基于规则处罚、词过滤及审批工作流。
AutoPunish V3 消除了对多个管理插件的需求,同时为服务器管理员提供强大的自动化功能、实时 Web 仪表板以及全面的玩家历史记录追踪。专为高性能打造,并从底层兼容 Folia。
快速开始
- 安装: 将
AutoPunish-V3.0Beta.jar 放入 plugins/ 文件夹
- 启动: 服务器生成配置文件和管理员令牌(请查看控制台)
- 访问: Web 面板位于
http://your-ip:8080
- 配置: 根据需要编辑
plugins/AutoPunish/ 中的文件
要求: Java 21+,Minecraft 1.16-1.21 (Paper/Spigot/Purpur/Bukkit/Folia)
主要特性
- 基于规则的升级 - 针对重复违规者的自动等级提升
- Web 仪表板 - 实时统计信息、封禁、禁言、审批(单一端口:HTTP + WebSocket)
- 词过滤 - 使用正则表达式自动检测垃圾信息、不雅词汇和广告
- 审批工作流 - 在应用严重处罚前进行审查
- 兼容 Folia - 原生支持多线程服务器
- 完整的历史记录 - 每项管理操作的完整审计跟踪
基本命令
/ban <player> [duration] [reason] - 临时或永久封禁玩家
/mute <player> [duration] [reason] - 静音玩家的聊天
/warn <player> [reason] - 发出警告(会自动升级)
/case <player> <rule> - 应用基于规则的处罚
/history <player> - 查看完整的处罚历史
/autopunish reload - 热重载所有配置
/autopunish approve <id> - 批准待处理的处罚
查看所有 16 个命令: 完整命令列表
使用示例
临时封禁
/ban Griefer123 7d Destroying player builds
基于规则的处罚(自动升级)
/case Spammer chat_violation
首次违规:警告 → 第二次:1小时禁言 → 第三次:1天禁言 → ... → 第五次:永久封禁
审批工作流
Staff: /ban Hacker permanent Flight hacks
System: Queued for approval (ID: abc123)
Admin: /autopunish approve abc123
System: Ban applied
配置
config.yml - 主要设置
webpanel:
enabled: true
port: 8080 # HTTP + WebSocket 统一端口
approval:
enabled: true
require-for-permanent: true
rules.yml - 定义升级处罚层级
rules:
chat_violation:
tiers:
1: { action: warn }
2: { action: mute, duration: "1h" }
5: { action: ban, duration: "permanent" }
filter.yml - 自动检测并处罚被过滤的词语
messages.yml - 自定义所有面向玩家的提示信息
Web 面板
访问地址 http://your-server-ip:8080
公开页面: 仪表板统计、封禁/禁言列表、玩家查询、服务器规则
管理面板: 批准/拒绝处罚(需要令牌 - 首次启动时请检查控制台)
当发出处罚时,通过 WebSocket 实时更新。
许可协议
保留所有权利 © 2026 AlanTheDevv
禁止未经授权的复制、分发或修改。允许在您的个人服务器上自用。完整条款
作者
由 AlanTheDevv 创建 | GitHub
致谢: NanoHTTPD, Paper Team, Folia Team, Minecraft Community
需要帮助? 联系作者获取支持 | 版本: V3.0Beta | 更新日期: 2026年1月
? 旧版文档 (V2.0 Core)
以下文档适用于 AutoPunish 的旧版 2.0 版本。此处提供仅供参考,以便在向 V3.0Beta 迁移期间查阅。
AutoPunish - 高级 Minecraft 处罚系统 (V2.0)
一款生产级的 Minecraft 插件,具备自动化管理、高级升级系统、实时同步和全面的健康监控功能。
? V2.0 新增功能
生产监控与性能
- 健康监控系统:实时系统健康检查,包括数据库、缓存和资源监控
- 负载测试套件:自动化的 API 性能基准测试
- 3-SQLite CQRS 架构:带有实时同步的高级缓存
- 性能分析:请求监控和错误跟踪
模块化插件架构
- 可选 Web 面板:Web 界面作为独立插件提供(在 V3.0 中集成到核心)
- 插件 API 扩展:增强用于第三方集成的 API
高级安全性
- 速率限制:API 端点保护
- 输入验证:防止 SQL 注入
- 审计跟踪:增强的日志记录
? 旧版命令 (V2.0)
玩家命令
/punish <player> <rule> - 对玩家应用处罚规则
/punishments [player] - 查看处罚历史
/severity [player] - 检查当前严重程度评分
管理员命令
/punishadmin list/approve/deny <id> - 管理处罚审批
/punishadmin resetrequests - 查看待处理的歷史重置请求
/resethistory <player> <reason> - 请求重置玩家历史
/rulemanagement <create|edit|delete> [rule] - 管理处罚规则
/punishreload - 重新加载配置文件
?️ 安全功能 (V2.0)
- 基于权限的访问控制:所有敏感操作都需要特定的权限
- 审批工作流:关键操作需要管理员审批
- 审计日志:完整记录所有操作以实现责任追溯
- 数据完整性:软删除机制防止意外数据丢失
AutoPunish-WebPanel 插件(旧版 V1.0)
注意:在 AutoPunish V3.0 中,Web 面板已直接集成到核心插件中。以下信息适用于旧的独立插件版本。
? 旧版功能
Web 仪表板
- 实时统计:实时查看处罚统计数据
- 玩家管理:搜索和查看历史记录
- 规则管理:通过 Web 界面创建规则
- 审批系统:处理待处理的审批请求
安全性
- 多因素身份验证:安全登录
- 速率限制:保护 API 端点
- 输入验证:防止 SQL 注入攻击
? 旧版 API 文档
核心端点
GET /api/health
返回系统健康状态和性能指标。
GET /api/statistics
返回全面的处罚统计数据。
GET /api/punishments
返回分页的处罚列表。
GET /api/players//history
返回玩家的完整处罚历史。
旧版文档结束
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
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
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
评论 0
登录后参与评分
还没有评论,来抢沙发吧