VelocityVault

VelocityVault - Fix Laggy Player Movement on Fabric Servers

Ever noticed how other players look like they're teleporting around when they have high ping? VelocityVault fixes that. It's a server-side mod that makes everyone's movement look smooth, even when someone's connection is acting up. Plus, it gives developers precise velocity data for building anti-cheat plugins or movement-based mechanics.

What It Does

Smooths Out Movement - The mod watches player positions and fills in the gaps between network updates, so laggy players don't look like they're stuttering across your screen. No more watching someone rubber-band through your base.


Tracks Player Velocity - Keeps a history of where players have been so it can figure out exactly how fast they're moving and in what direction. Super useful if you're building anti-cheat tools or just want accurate movement data.


Adapts to Each Player's Ping - The smoothing automatically adjusts based on someone's latency. High ping players get more correction, low ping players barely get touched. Everything feels natural.


Tweak Everything - Don't like the defaults? Change the smoothing strength, how much history it keeps, when corrections kick in, or turn on debug mode to see what's happening under the hood.


API for Modders - If you're making your own mods, you can tap into VelocityVault's movement tracking. Great for anti-cheat systems, player analytics, or custom gameplay features that need precise velocity info.

Getting Started

Grab the latest JAR from the downloads, drop it in your mods folder, restart your server. Done.


You'll need: Minecraft 1.21.4, Fabric Loader 0.16.10+, and Fabric API

Configuration

After your first launch, check config/velocityvault.json to customize things. You can reload settings without restarting the server.

• • enabled (true/false) - Turn the whole mod on or off

• • bufferSize (default: 15) - How many position snapshots to remember

• • smoothingTicks (default: 3) - How gradually to apply corrections

• • maxSmoothingDistance (default: 2.0) - Max distance to smooth in blocks - anything bigger just snaps instantly

• • minPingForSmoothingMs (default: 50) - Only smooth players above this ping threshold

• • smoothSelf (default: false) - Smooth your own position (usually leave this off)

• • debugLogging (default: false) - Spam the console with details if you're troubleshooting

Commands

• • /velocityvault stats - See if it's running and how many players are being tracked

• • /velocityvault player <username> - Get detailed movement stats for someone (needs OP level 2)

For Developers

Want to use VelocityVault's data in your own mod? The API is pretty straightforward. Just add the JAR to your dev environment and import com.pepe.velocityvault.api.VelocityVaultAPI.


Main stuff you can do:

• • getInstance() - Get the API (returns null if the mod's disabled)

• • getVelocityEstimate(UUID, long windowMillis) - Get average velocity over a time window as [​vx, vy, vz] in blocks/second

• • getMovementHistory(UUID) - Raw position history for a player

• • getAveragePing(UUID) - Their smoothed ping in milliseconds

• • getLastCorrectionDelta(UUID) - How far the last position correction moved them

Everything's thread-safe so you can call it as often as you need. Check the source for more details and examples.

Compatibility

It's server-only and doesn't need anything on the client, so it should play nice with most other mods. Lightweight and shouldn't cause any drama with your existing setup.

Issues & Source

Run into problems or want to contribute? Hit up the GitHub repository to report bugs or submit improvements.