ModMedic
Real-time error diagnostics for Paper server plugins
Stop digging through server logs. See every plugin error with instant diagnosis.
quick demo
Install the plugin, start the desktop app, done. Errors appear in real time with the cause and a suggested fix.
What is ModMedic?
ModMedic catches plugin errors on your Paper server as they happen and streams them to a desktop companion app. It analyzes the stack trace, identifies the root cause, and suggests fixes — no more scrolling through pages of console output.
Features
- Live Error Feed — Plugin crashes appear in the desktop UI the instant they happen via WebSocket
- Smart Diagnosis Engine — 52 built-in patterns covering NPEs, NoSuchMethodError, ClassNotFoundException, YAML/config issues, version mismatches, and more
- Causal Chain Parsing — Follows
Caused by:chains through the full stack trace to find the real source - Custom Patterns — Add your own diagnosis patterns through the desktop UI, saved across restarts
- LLM Fallback (Optional) — Connect to Ollama (local, free) or OpenAI for errors no pattern matches
- Console Log Viewer — All server output mirrored to the desktop app in real time
- Dashboard — Stats showing error counts by plugin, pattern, and time
- Zero Config — Drop the plugin in
plugins/, start the desktop app, that's it
How It Works
The Paper plugin hooks into ServerExceptionEvent and streams every error — plus all console output — to the desktop app over WebSocket. The diagnosis engine runs locally on your PC (no data leaves your machine unless you enable LLM mode).
Diagnosis pipeline:
- Built-in patterns (52 curated patterns)
- Custom patterns (your own additions)
- LLM fallback (optional — Ollama or OpenAI)
Installation
1. Download the latest release from GitHub
2. Copy ModMedic.jar to your server's plugins/ folder
3. Run ModMedicDesktop.bat on your PC
4. Start your server — the plugin connects automatically
Server commands:
/modmedic ping— Check WebSocket connection/modmedic test— Fire a test error to verify the pipeline
Requirements
- Server: Paper 1.21.1 (or compatible fork)
- Desktop: Windows 10+ (JavaFX bundled — no separate install)
- Java 21 for building from source (pre-built JAR included)
Open Source
ModMedic is fully open source under GPL-3.0. Source code, issue tracker, and documentation on GitHub. Contributions welcome — especially new diagnosis patterns!
Links
Support
Report bugs and request features on the GitHub issue tracker.
Pinned Versions
Pages
Members
