Repository navigation
AstroVelocity build-1
First release of AstroVelocity — a rebranded, cleaned-up build of Velocity-CTD.
AstroVelocity is a proxy, not a server jar. It sits in front of your backend servers and moves players between them. You only need it if you run more than one server.
Requires Java 25
java -Xms512M -Xmx512M -XX:+UseG1GC -XX:G1HeapRegionSize=4M -XX:+UnlockExperimentalVMOptions -XX:+ParallelRefProcEnabled -XX:+AlwaysPreTouch -jar AstroVelocity-b1.jar
First run writes astrovelocity.toml. Migrating from Velocity or Velocity-CTD? Drop your existing velocity.toml in and it will be used as-is.
What's rebranded
- F3 debug screen shows
Paper (AstroVelocity) /astrovelocityis the primary command, with/velocityand/velocityctdkept as aliases- Config is
astrovelocity.toml, with a fallback to an existingvelocity.toml - Update checker points at this repository instead of upstream's
Java packages are not renamed, so every Velocity plugin keeps working. See NOTES.md.
No performance claims
No proxy benchmarks have been run, so none are published. This is Velocity-CTD's performance work, properly rebranded — it is not faster than upstream and isn't claimed to be.
On Linux or macOS, setting enable-reuse-port = true in [advanced] is worth doing. It stays off by default because the proxy binds once per worker thread and that fails to start on Windows.
Verified
Build and tests pass including checkstyle and spotless. Boots on Java 25 in ~1s with kqueue channels, libdeflate compression and native ciphers.
GPL-3.0, inherited from Velocity and Velocity-CTD. Full source is in this repository.