# VelocityWebPanel<\/p>\n
Requires LuckPerms<\/p>\n
A distributed Minecraft network web panel for **Velocity + Paper** environments.
\n`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.<\/p>\n
<\/p>\n
## What It Does<\/p>\n
– Hosts a browser-based admin panel from the Velocity side
\n– Connects multiple Paper servers through a backend WebSocket channel
\n– Streams server stats, players, plugins, and console output in near real time
\n– Lets authorized users run commands on individual backend servers
\n– Includes account-based login with BCrypt-hashed passwords<\/p>\n
<\/p>\n
## Architecture<\/p>\n
### 1) Velocity Side (Central Hub)
\n– Serves the web UI over HTTP (`web-port`, default `8080`)
\n– Exposes API endpoints for auth, polling, and actions
\n– Runs internal backend WebSocket server (`ws-port`, default `8100`)
\n– Maintains connected server sessions and broadcasts updates to browsers
\n– Includes a built-in `Velocity` node in the dashboard via `VelocityProxyBridge`<\/p>\n
### 2) Paper Side (Agent on Each Server)
\n– Connects to Velocity using shared secret handshake
\n– Sends periodic stats (TPS, memory, CPU, uptime, players)
\n– Streams console lines and command outputs
\n– Sends plugin list and player list updates<\/p>\n
## Web Panel Features<\/p>\n
– **Dashboard**: all connected servers with online status and quick metrics
\n– **Console**: live output + remote command execution
\n– **Players**: per-server player list view
\n– **Stats**: server performance cards + historical player samples
\n– **Plugins**: installed plugin list per backend
\n– **Network Info**: aggregated table across all servers
\n– **Users**: list\/remove panel users from the UI<\/p>\n
\n
\n<\/p>\n
## Authentication & Access<\/p>\n
– Players register or update panel password using: <\/p>\n ## Configuration (from `config.yml`)<\/p>\n – `panel-name`: panel branding\/title ## Typical Use Case<\/p>\n Ideal for network operators who want lightweight centralized visibility and control across multiple Paper servers behind Velocity, without requiring a heavy external dashboard stack.<\/p>\n","protected":false},"excerpt":{"rendered":" See and manage your whole network without any complicated setup! No third party websites or configurations, just a plugin!<\/p>\n","protected":false},"featured_media":165643,"template":"","meta":{"_minecraft_slug":"velocitywebpanel","_minecraft_project_id":"v9VgVrPA","_minecraft_author":"ItsVaidas","_minecraft_license":"MIT","_minecraft_downloads":47,"_minecraft_follows":5,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"velocitywebpanel.zip","_minecraft_size_bytes":298234,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-15T21:16:32.121066Z","_minecraft_date_created":"2026-03-21T23:20:00.827882Z","_minecraft_date_modified":"2026-03-21T17:56:06.653063Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/velocitywebpanel","_minecraft_icon_attachment_id":165643,"_minecraft_imported_at":"2026-06-09T17:55:56+00:00","_minecraft_import_hash":"5a5080411151c7a28c70aa129d9a0568","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[126,127,128,92,985],"mod_loader":[132,133,986],"minecraft_version":[49,50,51,52,53,54,55,56,57,58,59,36,60,93,94,101,102,62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-165642","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-management","mod_category-paper","mod_category-purpur","mod_category-utility","mod_category-velocity","mod_loader-paper","mod_loader-purpur","mod_loader-velocity","minecraft_version-1-17","minecraft_version-1-17-1","minecraft_version-1-18","minecraft_version-1-18-1","minecraft_version-1-18-2","minecraft_version-1-19","minecraft_version-1-19-1","minecraft_version-1-19-2","minecraft_version-1-19-3","minecraft_version-1-19-4","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n
\n – `\/vwpanel
\n– Passwords are stored as BCrypt hashes in `users.dat`
\n– Required LuckPerms integration validates `velocitywebpanel.use` permission
\n– Backend agent connections are protected by a shared `secret` value<\/p>\n
\n– `web-port`: panel HTTP port
\n– `ws-port`: backend agent WebSocket port
\n– `secret`: shared backend handshake secret
\n– `velocity-host`: proxy host used by Paper agents
\n– `server-name`: backend display name
\n– `server-type`: backend type label
\n– `update-interval`: stats push interval (seconds)
\n– `console-buffer-size`: retained console lines on agent side<\/p>\n