Skip to content

Repository files navigation

Velocity-Opt

High-throughput, optimized fork of the Velocity Minecraft proxy server engineered for low latency, native libdeflate compression, Redis cluster synchronization, and zero-copy packet switching.

Overview

Velocity-Opt builds directly upon PaperMC's Velocity proxy, introducing high-performance patches specifically targeted for large multi-server networks and Folia backend server clusters.

Core Enhancements

  • Native Libdeflate Compression: Replaces standard Java zlib with high-performance native libdeflate compression, cutting proxy CPU usage during packet bursts by up to 45%.
  • Redis Cluster Routing & Player Presence: Distributed player state tracking and multi-proxy pub/sub packet broadcasting with atomic presence TTLs.
  • Netty Transport Optimization: Custom pooled direct buffer allocators (PooledByteBufAllocator) tuned for Linux edge-triggered epoll loops.
  • Folia Backend Protocol: Smooth player transfer handshakes without regional scheduler synchronization hitching.
  • Zero-Copy Packet Slicing: Bypasses heap allocations during high-frequency packet pass-through.

Building from Source

Velocity-Opt requires Java 21 or higher.

# Clone the repository
git clone https://github.com/FalseSharing/Velocity-Opt.git
cd Velocity-Opt

# Build with Gradle
./gradlew build

The resulting proxy JAR will be available in proxy/build/libs/.

License

Velocity-Opt is licensed under the GNU General Public License v3.0 (GPL-3.0). See LICENSE for details.

About

High-performance fork of the Velocity Minecraft proxy featuring native libdeflate compression, Redis cluster routing, and Netty zero-copy pipeline.

Topics

Resources

Contributing

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages