task: #106 Minecraft Log Analyzer Bot
Two use cases: 1. Trust/Verification — Check for hacked clients during whitelist 2. Troubleshooting — Help subscribers diagnose crashes Uses mclo.gs for log hosting, bot analyzes and responds. Modpack-specific allowlists for expected mods. Chronicler #75
This commit is contained in:
103
docs/tasks-index/task-106-minecraft-log-analyzer.md
Normal file
103
docs/tasks-index/task-106-minecraft-log-analyzer.md
Normal file
@@ -0,0 +1,103 @@
|
||||
---
|
||||
task_number: 106
|
||||
title: Minecraft Log Analyzer Bot
|
||||
status: Planned
|
||||
priority: P3-Low
|
||||
is_blocker: false
|
||||
owner: Michael
|
||||
tags:
|
||||
- discord
|
||||
- support
|
||||
- automation
|
||||
estimated_hours: 6
|
||||
---
|
||||
|
||||
# Task #106: Minecraft Log Analyzer Bot
|
||||
|
||||
## Overview
|
||||
|
||||
Discord bot integration that analyzes Minecraft logs uploaded to mclo.gs for two purposes:
|
||||
1. **Trust/Verification** — Check for hacked clients, banned mods during whitelist application
|
||||
2. **Troubleshooting** — Help subscribers diagnose crashes, connection issues, mod conflicts
|
||||
|
||||
## Use Cases
|
||||
|
||||
### Verification Flow
|
||||
1. Player applies for whitelist
|
||||
2. Bot asks: "Please upload your logs to mclo.gs and paste the link"
|
||||
3. Player provides link
|
||||
4. Bot analyzes for:
|
||||
- Known cheat client signatures
|
||||
- Xray texture packs
|
||||
- Banned mod lists
|
||||
- Suspicious entries
|
||||
5. Bot returns: ✅ Clean or ⚠️ Flagged (with details for staff review)
|
||||
|
||||
### Troubleshooting Flow
|
||||
1. Subscriber posts in #support: "Game keeps crashing"
|
||||
2. Staff (or bot) asks for mclo.gs link
|
||||
3. Bot analyzes and responds:
|
||||
- Identified error type
|
||||
- Common cause
|
||||
- Suggested fix
|
||||
- Link to relevant FAQ/guide
|
||||
|
||||
## Technical Options
|
||||
|
||||
### Option A: Existing Bot
|
||||
- **LogBot** — Pre-built, may have limitations
|
||||
- **HeroBot** — More features, may be overkill
|
||||
|
||||
### Option B: Custom Integration
|
||||
- Use mclo.gs API to fetch log content
|
||||
- Build analysis logic into Arbiter or new bot
|
||||
- Custom rules for Firefrost-specific modpacks
|
||||
- Auto-respond with modpack-specific troubleshooting
|
||||
|
||||
### Option C: Hybrid
|
||||
- Use mclo.gs for hosting
|
||||
- Custom Arbiter module for analysis
|
||||
- Tailored responses per server/modpack
|
||||
|
||||
## Modpack-Specific Considerations
|
||||
|
||||
Each modpack has different expected mods. Bot should know:
|
||||
- ATM10 expected mod list
|
||||
- Vault Hunters expected mod list
|
||||
- etc.
|
||||
|
||||
Flag anything NOT on the expected list for that server.
|
||||
|
||||
## Implementation Phases
|
||||
|
||||
### Phase 1: Research
|
||||
- [ ] Test mclo.gs API
|
||||
- [ ] Evaluate existing bots (LogBot, HeroBot)
|
||||
- [ ] Document common crash patterns across our modpacks
|
||||
|
||||
### Phase 2: MVP
|
||||
- [ ] Basic log fetching from mclo.gs links
|
||||
- [ ] Simple pattern matching for obvious cheats
|
||||
- [ ] Manual trigger (!analyze <link>)
|
||||
|
||||
### Phase 3: Troubleshooting
|
||||
- [ ] Crash pattern database
|
||||
- [ ] Auto-suggest fixes
|
||||
- [ ] Link to FAQ articles
|
||||
|
||||
### Phase 4: Automation
|
||||
- [ ] Auto-detect mclo.gs links in #support
|
||||
- [ ] Integration with whitelist application flow
|
||||
- [ ] Per-modpack mod allowlists
|
||||
|
||||
## Success Criteria
|
||||
|
||||
- [ ] Bot can fetch and parse mclo.gs links
|
||||
- [ ] Detects common cheat clients (Wurst, Impact, etc.)
|
||||
- [ ] Identifies top 10 crash causes with suggested fixes
|
||||
- [ ] Staff can verify applicants without manual log reading
|
||||
- [ ] Subscribers get faster support responses
|
||||
|
||||
---
|
||||
|
||||
**Fire + Frost + Foundation = Where Love Builds Legacy** 💙🔥❄️
|
||||
Reference in New Issue
Block a user