Vyvern Bridge

Summary: Shared foundation for every Vyvern companion mod — WebSocket bus, permissions, config sync and the in-game hub GUI. Does nothing by itself.

Description

Vyvern Bridge is the shared library every other Vyvern mod builds on. It has no gameplay of its own — install it because another Vyvern mod (Stats, QOL, Teams, Mine, Autopilot, Voxy) needs it.

What it provides:

• An optional WebSocket bus to a Vyvern panel. Fully dormant if no panel is configured — nothing breaks, nothing phones home.
• A permission-node framework shared by every Vyvern mod, so server operators get one consistent permission model instead of one per mod.
• CompanionConfigStore: live in-game config changes (e.g. an operator raising a limit from an in-game panel) sync instantly to every connected client, persist atomically to config/vyvern-companion.json, and survive a restart — even without a panel connection.
• The shared in-game "Vyvern hub" GUI shell: a custom, translucent, Vyvern-styled tab rail that every feature mod's panels are built into.
• A shared Notices broadcast channel + on-screen banner overlay, with a chat fallback for vanilla clients.
• Bus command dispatch, used by other mods' commands.

Requires: NeoForge 1.21.1+, Minecraft 1.21.1. Works standalone; a Vyvern panel connection is optional and only unlocks remote management.