Skip to content

MinecraftPlayground/msmp-console-mod

Repository files navigation

MSMP Console

A server-side Fabric mod that extends the Minecraft Server Management Protocol (MSMP) by forwarding every server console log event to all connected clients as a JSON-RPC 2.0 notification.

Installation

  1. Download the mod .jar and place it in your server's mods/ folder.
  2. Enable the Management Server in server.properties:
    management-server-enabled=true
  3. Start the server. The Management Server will listen on localhost:25576 by default.

Notification

Once a client connects to the WebSocket endpoint, it will receive a notification for every log event produced by the server.

Method: console:notification/log_event

Payload

Field Type Description
timestamp string ISO-8601 timestamp of when the log event occurred
level string Log level: TRACE, DEBUG, INFO, WARN, ERROR or FATAL
thread string Name of the thread that produced the log event
logger string Fully qualified name of the originating logger (e.g. the class name)
message string The fully interpolated log message
throwable string Serialized stacktrace if an exception was attached, omitted otherwise

Example

{
  "jsonrpc": "2.0",
  "method": "console:notification/log_event",
  "params": [{
    "timestamp": "2026-03-21T15:06:06.146Z",
    "level": "INFO",
    "thread": "Server thread",
    "logger": "net.minecraft.server.MinecraftServer",
    "message": "Done (1.019s)! For help, type \"help\""
  }]
}
{
  "jsonrpc": "2.0",
  "method": "console:notification/log_event",
  "params": [{
    "timestamp": "2026-03-21T15:06:07.212Z",
    "level": "ERROR",
    "thread": "Server thread",
    "logger": "net.minecraft.server.MinecraftServer",
    "message": "Encountered an unexpected exception",
    "throwable": "java.lang.NullPointerException: Cannot invoke ...\n\tat net.minecraft.server.MinecraftServer..."
  }]
}

License

LGPL-3.0

About

A server-side Fabric mod that extends the Minecraft Server Management Protocol (MSMP) by forwarding every server console log event

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Contributors

Languages