Details

ArkOps-Ai Console Monitoring Skill

Monitors Minecraft Purpur console warnings and errors, automatically analyzes issues and provides fix suggestions, with optional QQ notifications via NapCatQQSkill.

Features

Feature	Description
Real-time Monitoring	Intercepts console WARNING and SEVERE level logs
Smart Classification	Auto-detects 14 common error types (OOM, plugin errors, server lag, etc.)
Fix Suggestions	Each error type comes with troubleshooting and fix recommendations
Error Buffer	Caches the latest 200 error records for AI queries
QQ Notifications	Sends alerts to admin QQ groups via NapCatQQSkill on critical errors
Statistics Report	Generates distribution reports by error type and severity level

Quick Start

1. Build

cd console-monitoring
mvn clean package

2. Deploy

Copy target/ConsoleMonitoringSkill-1.0.0.jar to:

plugins/ArkOps-Ai/skills/

3. Configure (Optional)

Config file path: plugins/ArkOps-Ai/skills/console_monitoring.yml

To enable QQ notifications:

qq_notification:
  enabled: true
  admin_group_id: "your_admin_group_id"
  admin_qq_ids:
    - "admin_qq_1"
    - "admin_qq_2"
  notify_level: "ERROR"

4. Verify

After restarting the server, look for these log messages:

[ConsoleMonitoring] Console Monitoring Skill enabled
[ConsoleMonitoring] Buffer size: 200
[ConsoleMonitoring] QQ notification: enabled/disabled

Tools

get_recent_errors

Retrieve recent console error/warning records.

Parameter	Type	Required	Description
count	number	No	Number of errors to retrieve (default 20, max 100)
level	string	No	Filter by level: WARNING, ERROR, ALL (default ALL)

analyze_error

Analyze a specific error entry in detail and get fix suggestions.

Parameter	Type	Required	Description
error_index	number	Yes	Error index (0-based)

get_error_statistics

Get error statistics grouped by category and severity level.

clear_error_log

Clear all error records from the buffer. Requires SUPER_ADMIN permission.

check_qq_notification_status

Check the configuration and status of QQ notification feature.

send_test_alert

Send a test alert to the admin QQ group. Requires SUPER_ADMIN permission.

Error Categories

Category	Description
Out of Memory	OutOfMemoryError, heap space exhausted
Server Lag	Can't keep up, TPS below normal
Plugin Error	Plugin exceptions or event handler errors
Connection Error	Player disconnections, timeouts
World/Chunk Error	Chunk load/save failures
Entity Error	Duplicate entity UUIDs, etc.
Thread Deadlock	Server thread deadlock (critical)
Disk IO Error	Disk full or read/write failures
Config Error	Plugin configuration format errors
Permission Error	Permission system misconfiguration
Startup Error	Server startup failures
Command Error	Command execution exceptions
Network Error	Network protocol/packet issues
Unknown	Other uncategorized errors

Permissions

Tool	Required Permission
get_recent_errors	ADMIN
analyze_error	ADMIN
get_error_statistics	ADMIN
clear_error_log	SUPER_ADMIN
check_qq_notification_status	SUPER_ADMIN
send_test_alert	SUPER_ADMIN

Dependencies

ArkOps-Ai >= 2.0.0
Paper/Purpur >= 1.21
NapCatQQSkill (optional, for QQ notifications)

Usage Examples

In-game or via QQ:

@ops check recent errors
@ops analyze error 0
@ops are there any issues with the server
@ops check QQ notification status
@ops send a test alert

Console Monitoring Skill