Make Console Make Sense

# Make Console Make Sense (MCMS) **Your server console is a dumpster fire of Java exceptions and cryptic warnings. MCMS fixes that.** Every error message gets translated into plain English (with a bit of sarcasm). No more googling `java.net.SocketException: Connection reset` at 2am. No more staring at a 40-line stack trace trying to find what actually went wrong. --- ## Before vs After **Before:** ``` : java.net.SocketException: Connection reset : java.lang.NullPointerException : Can't keep up! Is the server overloaded? Running 2034ms or 40 ticks behind : Skipping BlockEntity with id mysticmod:magic_chest ``` **After:** ``` : A player ragequit so hard they broke TCP. Respect. RIP connection. : WHAT: Something was null that really shouldn't have been. Classic developer blunder. : WHERE: MyPlugin.java:42 in com.example.MyPlugin.doThing() : ALERT: Server is gasping for air! Running 2034ms (40 ticks) behind. Turn off the 500-hopper contraptions, please. : Found a mysterious block entity 'mysticmod:magic_chest'. Probably from a mod someone installed, loved for a week, and uninstalled. ``` Same information. Actually readable. Slightly sarcastic. --- ## What gets transformed? - **Network errors** — SocketException, timeout, broken pipe → plain disconnect messages - **Server lag** — "Can't keep up!" with exact ms and tick count - **Plugin errors** — enable/disable failures, deprecated API, wrong-thread calls - **Java exceptions** — NullPointerException, StackOverflow, ClassCast, OutOfMemory, and 20+ more - **World/Chunks** — unknown block entities, duplicate UUIDs, chunk failures - **Player events** — joins, disconnects, illegal movement, unknown commands - **Mojang auth** — authentication failures, session servers down - **YAML/config errors** — parse errors with line numbers - **Startup/shutdown** — version info, world loading, save messages 70+ patterns total. And for exceptions, instead of the full stack trace flooding your console, you get: ``` : ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ : WHAT: Something was null that really shouldn't have been. : TYPE: java.lang.NullPointerException : WHERE: MyPlugin.java:42 in com.example.MyPlugin.doThing() : Full stack trace follows: : ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ ``` The full trace still follows — nothing is hidden. You just get the important part first. --- ## Features - Drop-in install — zero configuration required - Colored startup banner (on supported terminals) - Update checker — notifies you in the console when a new version is out, with a link - `/mcms stats` — see how many messages have been transformed this session - Works on Paper, Purpur, Spigot, Bukkit, Folia, and all Paper forks --- ## Installation 1. Download `MCMS.jar` 2. Drop it in your `plugins/` folder 3. Restart 4. That's it --- ## Commands | Command | Permission | Description | |---------|-----------|-------------| | `/mcms stats` | `mcms.use` | Show transformation stats | | `/mcms update` | `mcms.admin` | Manually check for updates | | `/mcms reload` | `mcms.admin` | Reload config | | `/mcms help` | `mcms.use` | Show help | All permissions default to OP only. --- ## Requirements - **Minecraft**: 1.18 or newer - **Java**: **25 or newer** - **Server**: Bukkit / Spigot / Paper / Purpur / Folia (any Bukkit-based server)