ModMedic
Real-time error diagnostics for Paper server plugins
Stop digging through server logs. See every plugin error with instant diagnosis.
Real-time error diagnostics for Paper server plugins
Stop digging through server logs. See every plugin error with instant diagnosis.
Spoiler: Quick Demo
What is ModMedic?
Install the plugin, start the desktop app, done. Errors appear in real time with the cause and a suggested fix.
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
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:
1. Built-in patterns (52 curated patterns)
2. Custom patterns (your own additions)
3. 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
- 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)
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.
Quick facts
- Edition: Minecraft Java
- File type: .jar
- Minecraft version listed: 1.21
- How to install: Install the matching mod loader (Forge, Fabric or NeoForge) for your Minecraft version. → Download the .jar. → Put it in the .minecraft/mods folder and launch that loader profile.
- Where to get it: Opens on Spigot — not every file is mirrored on our own servers.
Install steps are the general flow for this file type — How to install Minecraft Java mods & modpacks walks through it step by step.
ModMedic is a free Minecraft Java mod. Compatible with Minecraft 1.21. Downloaded 11 times (via Spigot). Download it and open it directly in the game.