SparkAnalyzer
A plugin that can help you to checkout on Spark profiler and give back some advices
Автор: Simple-Dev6661обновлён 25 янв. 2026 г.
УправлениеОптимизацияТехнологии
Описание
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 |
Последние версии
Все версии →release
SparkAnalyzer 1.0.0
1.0.025 янв. 2026 г.665Minecraft: 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.11paper
Что нового
# 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
<details>
<summary>Spoil config.yml</summary>
```
# 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: enter_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
```
</details>
### 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 |