VelocityWebPanel

# VelocityWebPanel Requires LuckPerms A distributed Minecraft network web panel for **Velocity + Paper** environments. `VelocityWebPanel` runs a central panel on your Velocity proxy and connects Paper servers as backend agents, giving you one place to monitor and manage your network. !(https://cdn.modrinth.com/data/cached_images/14d2ac1ad4a5ec3b649e68269edf06545e48bf18.png) ## What It Does - Hosts a browser-based admin panel from the Velocity side - Connects multiple Paper servers through a backend WebSocket channel - Streams server stats, players, plugins, and console output in near real time - Lets authorized users run commands on individual backend servers - Includes account-based login with BCrypt-hashed passwords !(https://cdn.modrinth.com/data/cached_images/7974e9d5687c163a575ab5af0278edd01d530c9d.png) ## Architecture ### 1) Velocity Side (Central Hub) - Serves the web UI over HTTP (`web-port`, default `8080`) - Exposes API endpoints for auth, polling, and actions - Runs internal backend WebSocket server (`ws-port`, default `8100`) - Maintains connected server sessions and broadcasts updates to browsers - Includes a built-in `Velocity` node in the dashboard via `VelocityProxyBridge` ### 2) Paper Side (Agent on Each Server) - Connects to Velocity using shared secret handshake - Sends periodic stats (TPS, memory, CPU, uptime, players) - Streams console lines and command outputs - Sends plugin list and player list updates ## Web Panel Features - **Dashboard**: all connected servers with online status and quick metrics - **Console**: live output + remote command execution - **Players**: per-server player list view - **Stats**: server performance cards + historical player samples - **Plugins**: installed plugin list per backend - **Network Info**: aggregated table across all servers - **Users**: list/remove panel users from the UI !(https://cdn.modrinth.com/data/cached_images/a871193da15d75aef6f5a9450a19a6e424252be7.png) !(https://cdn.modrinth.com/data/cached_images/1e02f92aa01e1a11e5b2ec81505fc1ee2caee394.png) !(https://cdn.modrinth.com/data/cached_images/72c2ebe25017f54c8e50f5af66ee1b6f2cc0c277.png) ## Authentication & Access - Players register or update panel password using: - `/vwpanel <password>` - Passwords are stored as BCrypt hashes in `users.dat` - Required LuckPerms integration validates `velocitywebpanel.use` permission - Backend agent connections are protected by a shared `secret` value !(https://cdn.modrinth.com/data/cached_images/4276603815c09bc47d0dedd038310adeea6970d0.png) ## Configuration (from `config.yml`) - `panel-name`: panel branding/title - `web-port`: panel HTTP port - `ws-port`: backend agent WebSocket port - `secret`: shared backend handshake secret - `velocity-host`: proxy host used by Paper agents - `server-name`: backend display name - `server-type`: backend type label - `update-interval`: stats push interval (seconds) - `console-buffer-size`: retained console lines on agent side ## Typical Use Case Ideal for network operators who want lightweight centralized visibility and control across multiple Paper servers behind Velocity, without requiring a heavy external dashboard stack.