VelocityWebPanel

Minecraft 版本： 1.17 1.17.1 1.18 1.18.1 1.18.2 1.19 1.19.1 1.19.2 1.19.3 1.19.4 1.20 1.20.1 1.20.2 1.20.3 1.20.4 1.20.5 1.20.6 1.21 1.21.1 1.21.2 1.21.3 1.21.4 1.21.5 1.21.6 1.21.7 1.21.8 1.21.9 1.21.10 1.21.11

平台： paper purpur velocity

标签： management utility

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.

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

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

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

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.