VelocityWebConsole

VelocityWebConsole

Control your Velocity proxy from anywhere via a web browser. No SSH, no external web server — just drop the plugin and open a URL. Perfect for VPS setups where you don't have direct terminal access.

_NOTE THIS PLUGIN IS NEW AND UNDER ACTIVE DEVELOPMENT, EXPECT BUGS. PLEASE REPORT THEM TO THE PROVIDED DISCORD CHANNEL UNDER #plugin-help_

---

🟢 SUPER Easy setup & use

- Users — The plugin runs its own web server. No Apache, nginx, or database to install or configure. - Users — Drop the jar in `plugins/`, restart Velocity, then open `http://YOUR_SERVER_IP:25580/` in a browser. That’s it. - Users — Port Users, log file auto-detected. You only need to edit `config.properties` if you want a different port or to bind to localhost. - Users — Log in with Users / Users, set a new password when prompted, and you’re in. Add more users (admin/viewer) from the Users page if you like.

---

---

✨ Features

- HTTP redirect — See your proxy's console output in real time, streamed straight to the browser. - HTTP redirect — Execute any Velocity console command from the web UI. - HTTP redirect — Create multiple users with HTTP redirect (full control) or HTTP redirect (read-only console, no command execution) roles. - HTTP redirect — Passwords are stored hashed (PBKDF2) in `users.json`. - HTTP redirect — Serve the console over TLS. Set `use_https=true` in config and provide a keystore (PKCS12 or JKS). Use a certificate from HTTP redirect (or another CA) for your domain to avoid browser "Not secure" warnings; self-signed certs work but require clicking "Advanced → Proceed" once per browser. When using HTTPS, the session cookie is `Secure` and responses send HTTP redirect so browsers stick to HTTPS. Optional HTTP redirect: set `redirect_http_port` so users can type `http://yourserver:25580` and get redirected to `https://yourserver:25581` (see config comments).

---

⚙️ Configuration

Edit `plugins/velocitywebconsole/config.properties` and restart the proxy for changes to take effect.

| Option | Default | Description | |--------|---------|-------------| | `port` | `25580` | Port the web console listens on (HTTPS if `use_https=true`, else HTTP). | | `bind_address` | `0.0.0.0` | `0.0.0.0` = all interfaces, `127.0.0.1` = localhost only. | | `log_file` | *(auto)* | Path to Velocity's log file if auto-detect fails (e.g. `logs/latest.log`). | | `use_https` | `false` | Serve over HTTPS (requires `keystore_path` and `keystore_password`). | | `keystore_path` | *(empty)* | Path to keystore file (.p12/.pfx or .jks). Relative = under plugin data dir. | | `keystore_password` | *(empty)* | Keystore password. | | `keystore_type` | `PKCS12` | `PKCS12` or `JKS`. | | `redirect_http_port` | `0` | When using HTTPS: HTTP port that redirects to HTTPS so users can type the URL without `https://`. Set `port` to the HTTPS port (e.g. 25581) and `redirect_http_port` to the port users type (e.g. 25580). `0` = disabled. |

---

🔒 Security tips

- Change the default password on first use. - Prefer `bind_address=127.0.0.1` and use SSH port forwarding if you only need access from your own machine. - Don't expose the web console port to the internet without a firewall or strong passwords.

---

📋 Requirements

- Java 17+ 3.4.x - 3.5.x proxy, built on 3.4.x API (tested on 3.5.x) - Java 17+

---