VelocityGuard

VelocityGuard Plugin

VelocityGuard is a lightweight Minecraft Paper 1.21.4 plugin designed to prevent extreme movement-based cheats like speed and flight. It uses direct packet interception for immediate detection and prevention of illegal movement. While it does not outright prevent all speed and flight cheats, it effectively stops the most extreme cases.

Features

• Direct Detection: Detects cheating in real-time at the packet level.
• Movement Blocking: Temporarily blocks movement when violations are detected.
• Pattern Detection: Identifies suspicious movement patterns.
• Adaptive System: Handles knockback, boats, horses, potions, and special movement states (swimming, flying, elytra gliding).

Installation

1. Download the latest jar file.
2. Place the .jar file in your Minecraft server's plugins folder.
3. Restart your server.

Configuration

In config.yml, you can configure:

# Configuration for detecting violations.
checks:
  speed:
    # Maximum horizontal speed in blocks per SECOND
    # Default vanilla walking speed: ~4.3 blocks/s
    # Default vanilla sprinting speed: ~5.6 blocks/s
    # Sprint-jumping can reach speeds of ~9-10 blocks/s temporarily
    # Recommended setting: 10.0 to allow for normal sprint-jumping with a buffer
    max-horizontal-speed: 10.0

    # How many seconds to cancel movement when a violation is detected.
    # This will just refuse all movement packets for this duration.
    # Has to be an integer.
    cancel-duration: 3

    # Latency compensation settings
    latency-compensation:
      # Whether to enable latency compensation
      enabled: true
      # Compensation factors for different ping ranges
      # 1.0 means no compensation. Higher values allow more speed
      very-low-ping: 1.1    # 21-50ms ping
      low-ping: 1.2         # 51-100ms ping
      medium-ping: 1.4      # 101-200ms ping
      high-ping: 1.45       # 201-300ms ping
      very-high-ping: 1.5   # 301-500ms ping
      extreme-ping: 1.6     # 500+ms ping

    # Knockback adjustment settings
    knockback:
      # Multiplier for speed threshold after taking damage.
      multiplier: 6.0
      # Duration in milliseconds that knockback effect lasts.
      duration: 1000

    # Trident riptide handling.
    riptide:
      # Multiplier for speed threshold after using a trident with riptide enchantment.
      multiplier: 8.0
      # Duration in milliseconds that the riptide effect lasts.
      duration: 3000

    # Elytra movement handling
    elytra:
      # Multiplier for speed threshold while gliding with elytra
      gliding-multiplier: 3.0
      # Duration in milliseconds that landing adjustment lasts after stopping gliding
      landing-duration: 1500

    # Vehicle speed multipliers.
    # Regular vehicle speed multiplier.
    vehicle-speed-multiplier: 1.1

    # Ice vehicle speed multiplier - only applies when vehicles are on ice.
    # Boats on ice can move especially fast.
    vehicle-ice-speed-multiplier: 3.6

    # Extra buffer multiplier applied to all speed checks.
    # This provides some leeway to prevent false positives.
    # Lower values = stricter checks, higher values = more lenient.
    buffer-multiplier: 1.1

    # Speed burst threshold - allows momentary speed spikes
    # Maximum number of consecutive measurements that can exceed the speed limit
    # before triggering a violation
    burst-tolerance: 15

# General settings.
settings:
  # Only enable if you are developing or testing the plugin
  # as this results in verbose logging.
  debug-mode: false

How It Works

1. The plugin intercepts player movement packets before they're processed.
2. Each movement is checked against configured speed limits and flight rules.
3. The plugin considers various factors like knockback, potion effects, and special movement states.
4. Sophisticated pattern detection identifies potential speed cheats that stay just under the defined thresholds.
5. Invalid movements are rejected, and player movement is temporarily blocked.
6. Players receive notification when cheating is detected.
7. After the block duration ends, players can immediately move normally again.

Commands

• /velocityguard reload: Reloads the plugin configuration (requires the velocityguard.admin permission).

Permissions

velocityguard.admin: Allows reloading the plugin configuration (default: op).

Support Me

Donations will help me with the development of this project.

One-off donation: https://ko-fi.com/lolwhatyesme

Patreon: https://www.patreon.com/lolwhatyesme