MiniHUD Debug Bridge (Paper 1.21.11, v1.0)

Paper plugin that streams debug data (paths, goals, villager brains, neighbor updates) to MiniHUD on clients. It can be used as a replacement for the Servux mod on Paper servers or as a way to stream data to older clients if you're using ViaVersion.

Credits

• MiniHUD and malilib by maruohon
• Servux by maruohon (original server-side debug concept)

This project is not affiliated with or endorsed by the original authors.

What It Does

• Collects debug data server-side for nearby mobs.
• Sends it to the client over a custom plugin channel.
• The client addon feeds that data into Minecraft's debug renderers for MiniHUD overlays.

Requirements

• Paper 1.21.11
• Java 21
• Optional: ViaVersion (for older clients)
• Client: malilib + MiniHUD + MiniHUD Bridge Listener addon

Install (Server)

1. Drop the jar into the server plugins folder.
2. Restart the server.
3. Ensure the player is OP or has minihuddebugbridge.subscribe.

How It Works

• On join, the client addon sends a subscribe packet.
• The plugin scans nearby mobs and emits debug payloads over a custom channel.
• MiniHUD renders the overlays using vanilla debug renderers.

Adapting To Another Minecraft Version

1. Update the Paper dev bundle in build.gradle.kts to the target version.
2. Re-check NMS classes used in DebugBridgePlugin (debug subscriptions, Brain, gossip, memory, etc.).
3. Update any renamed classes or fields.
4. Rebuild with ./gradlew build.

Notes

• This plugin is a Paper alternative to Servux mod debug overlays.
• It does not provide every Servux feature; it focuses on MiniHUD debug overlays.

License

GNU LGPL v3.0 (see LICENSE).