SparkAnalyzer
A Minecraft plugin that analyzes Spark profiler data using AI to provide actionable performance recommendations.
Features
AI-Powered Analysis
- Supports multiple AI providers: OpenAI, Anthropic (Claude), Google Gemini, and OpenRouter
- Evidence-based diagnostics with severity ratings (Critical, High, Medium, Low)
- Structured analysis reports with specific recommendations
Easy to Use
- Simply run
/sparkanalyze <spark-url> with any spark.lucko.me profile link
- Upload raw JSON data with
/sparkanalyze upload
- Re-analyze last profile with
/sparkanalyze last
Webhook Integration
- Send analysis reports to Discord, Slack, or custom webhooks
- Automatic retry with exponential backoff
- Auto-disable on repeated failures
Internationalization
- Full i18n support with customizable language files
- English (en-US) included by default
Security Hardened
- No backdoors, telemetry, or hidden network calls
- API keys are never logged
- All network activity is user-triggered only
Spoil config.yml
```
# SparkAnalyzer Configuration
# Security-hardened Minecraft Paper plugin for AI-powered Spark analysis
# Language setting - uses standard locale codes
# Available: en-US (default), vi-VN, ja-JP, etc.
# If an invalid code is provided, falls back to en-US
language: en-US
# AI Provider Configuration
ai:
# Supported providers: openai, anthropic, gemini,
provider: openrouter
# Your API key - NEVER share this publicly
# This value is loaded securely and never logged
api-key: your_api_key_here
# Model to use for analysis
# OpenAI: gpt-4.1-mini, gpt-4o, gpt-4-turbo
# Anthropic: claude-3-opus, claude-3-sonnet
# Gemini: gemini-pro
# OpenRouter: Any model from openrouter.ai (e.g., openai/gpt-4o, anthropic/claude-3.5-sonnet, meta-llama/llama-3.1-70b-instruct)
model: liquid/lfm-2.5-1.2b-thinking:free
# Temperature controls randomness (0.0 = deterministic, 2.0 = creative)
# For technical analysis, lower values (0.1-0.3) are recommended
# Valid range: 0.0 to 2.0
temperature: 0.2
# Maximum tokens in the AI response
# Higher values allow for more detailed analysis
# Must be greater than 0
max-tokens: 32000
# Webhook Configuration (Optional)
webhook:
# Set to true to enable webhook notifications
enabled: false
# Webhook URL - only this URL will receive notifications
# Example: https://discord.com/api/webhooks/...
url: ""
# Format: discord, slack, or generic
format: discord
# Include full analysis report in webhook (may be truncated)
include-full-report: false
# Maximum retry attempts for failed webhooks
max-retries: 3
# Auto-disable webhook after this many consecutive failures
failure-threshold: 5
# Report Settings
reports:
# Save detailed reports to plugins/SparkAnalyzer/reports/
save-to-file: true
# Include timestamps in report filenames
include-timestamp: true
# Debug Settings (for troubleshooting only)
debug:
# Enable verbose logging (does NOT log API keys)
enabled: false
```
Requirements
- Paper 1.16.5 - 1.21.11
- Java 17+
- Spark profiler installed
Permissions
| Permission |
Description |
sparkanalyzer.analyze |
Use analysis commands |
sparkanalyzer.reload |
Reload configuration |
暂无评论，抢个沙发吧~