Skip to content

0bi0/VelocityProxy

Repository files navigation

VelocityProxy - Version 1.0.0


A Velocity proxy plugin for Minecraft that acts as a middleman between clients and backend servers. Hides backend server IPs, handles player forwarding, and dynamically registers servers at runtime without hardcoding them in velocity.toml. Built for Velocity 3.4.0-SNAPSHOT.

Features:

  • Dynamic server registration on proxy startup
  • Modern player info forwarding (hides backend IPs from clients)
  • Compatible with Paper backend servers

Setup

Backend (Paper) requirements

In server.properties:

online-mode=false

In config/paper-global.yml:

proxies:
  velocity:
    enabled: true
    online-mode: true
    secret: <your forwarding secret>

Proxy requirements

In velocity.toml, set:

player-info-forwarding-mode = "MODERN"
forwarding-secret-file = "forwarding.secret"

Make sure forwarding.secret matches the secret set in Paper's config.


Building Project

Make sure you have Java 21 installed, then run the following in your terminal:

git clone https://github.com/0bi0/VelocityProxy.git
cd VelocityProxy
./gradlew build

The output JAR will be in build/libs/. Drop it into your Velocity plugins/ folder and restart the proxy.


License

Unlicense

About

Simple Velocity proxy server

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages