ModsJava
XPathSpeed
Boosts player movement speed dynamically when walking on designated path blocks.
⬇ Download on Spigot⚡ XPathSpeed
High-Performance Path Boost for Modern Minecraft Servers
XPathSpeed is an ultra-lightweight, high-performance server plugin that automatically grants players a customizable Speed II boost when walking or running on Dirt Path (DIRT_PATH) and other configurable path blocks.
Engineered specifically for modern servers running Minecraft 1.21+ on Java 21-25, XPathSpeed is built to handle hundreds of concurrent players moving simultaneously with 0 TPS drop.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
✨ Features
- Speed Boost on Dirt Paths - Instantly grants and refreshes the Speed effect when stepping onto path blocks.
- Sub-Block Geometry Aware - Correctly detects the 15/16-height hitbox (0.9375 blocks) of dirt path blocks seamlessly.
- ️ Smooth & Jitter-Free - Includes a configurable time buffer (default: 2.0s) so player FOV / screen doesn't violently flicker when stepping on and off path borders.
- Extreme Zero-Lag Architecture - Zero object allocation on camera turns, native 64-bit Bitmask material checks, and packet deduplication.
- Modern Neon Blue Aesthetic - Clean in-game feedback and a futuristic console startup banner.
- ⚙️ Fully Customizable - Adjust speed amplifier, duration buffer, toggle potion swirl particles, ambient effects, HUD icons, world whitelists/blacklists, or add custom blocks (e.g. Gravel, Cobblestone).
- ️ Smart Admin & Player Views - Regular players see a clean single-line status, while admins/OPs receive a detailed diagnostic panel.
- Real-Time Hot Reloading - Reload all settings and messages in real-time without restarting the server (/xpathspeed reload).
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
⚡ Zero-Lag Architecture (Built for 500+ Players)
Most movement-based plugins cause TPS drops because PlayerMoveEvent fires constantly on every head rotation. XPathSpeed is engineered from the ground up to eliminate lag:
- Zero-Allocation Fast-Path: Discards >95% of move events (camera turns, pitch/yaw changes) in <1 nanosecond before allocating a single byte on the JVM heap.
- Primitive Math: Eliminates Location.clone().subtract() calls, creating zero GC (Garbage Collection) pressure.
- EnumSet Bitmask Lookups: Block material comparisons execute in a single CPU instruction ($O(1)$) rather than slower string or collection lookups.
- Packet Throttling: Checks if the player already has an active speed buffer to avoid spamming potion attribute packets across the network.
- Dual Engine Support: Choose between high-responsiveness EVENT mode or batch TICK_TASK mode in config.yml.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Commands & Permissions
| Command | Aliases | Permission | Description |
| /xpathspeed | /xspeedpath, /pathspeed, /speedpath | xpathspeed.use (Default: all) | Displays plugin status. |
| /xpathspeed info | /xspeedpath info, /pathspeed info, /speedpath info | xpathspeed.use (Default: all) | Displays plugin status. |
| /xpathspeed reload | /xspeedpath reload, /pathspeed reload, /speedpath reload | xpathspeed.admin (Default: OP) | Reloads config.yml from disk. |
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
⚙️ Configuration (config.yml)
Code (YAML):
# ============================================================================== #
# #
# XPathSpeed Configuration #
# High-Performance Speed on Dirt Paths #
# #
# ============================================================================== #
# Potion effect settings
effect :
# The effect amplifier.
# 0 = Speed I, 1 = Speed II (Default), 2 = Speed III
amplifier : 1
# Duration of the effect applied in ticks (20 ticks = 1 second).
# A short buffer (e.g. 40 ticks = 2.0s) ensures seamless walking without screen/FOV flickering.
duration-ticks : 40
# Display potion swirl particles around the player.
particles : true
# Makes potion effect particles translucent / subtle (like a beacon).
# Set to false for standard bright potion swirls.
ambient : true
# Show the potion effect icon on the player's HUD.
show-icon : false
# Blocks that trigger the speed effect when walked upon.
# Must be valid Bukkit Material enum names.
path-blocks :
- DIRT_PATH
# Detection & Performance settings
detection :
# Detection mode:
# - EVENT: Ultra-responsive event-based detection with zero-allocation fast filtering. (Recommended)
# - TICK_TASK: Periodic batch task scanning online players every N ticks (ideal for 1000+ bot simulations).
mode : "EVENT"
# Interval in ticks between player scans if detection.mode is set to TICK_TASK.
task-period-ticks : 5
# If true, players will not receive the speed boost while sneaking / crouching.
disable-when-sneaking : false
# If true, players will not receive the speed boost while flying (creative/spectator/fly).
disable-when-flying : true
# If true, players will not receive the speed boost while gliding with an Elytra.
disable-when-gliding : true
# If set to true, players must have the 'xpathspeed.use' permission to receive the speed boost.
# Set to false to bypass permission checking for maximum performance.
require-permission : false
# World filtering configuration
worlds :
# World filter mode:
# - ALL: Enabled in all worlds.
# - WHITELIST: Only enabled in the worlds listed below.
# - BLACKLIST: Enabled in all worlds EXCEPT the worlds listed below.
mode : "ALL"
# List of world names used with WHITELIST or BLACKLIST modes.
list :
- "example_world_disabled"
# Plugin messages and color formatting
# Supports Hex colors: <#00D2FF>, �D2FF, and Legacy color codes (&b, &f, &a, &c, etc.)
messages:
prefix : "<#00D2FF>&lXPathSpeed &8» &f"
no-permission : "<#00D2FF>&lXPathSpeed &8» &cYou do not have permission to execute this command."
reload-success : "<#00D2FF>&lXPathSpeed &8» <#00F5FF>Configuration reloaded successfully in <#00D2FF>%time%ms<#00F5FF>!"
reload-fail : "<#00D2FF>&lXPathSpeed &8» &cFailed to reload configuration. Check server console for errors."
unknown-command : "<#00D2FF>&lXPathSpeed &8» &7Unknown subcommand. Use <#00F5FF>/%label% info&7 or <#00F5FF>/%label% reload&7."
XPathSpeed is a free Minecraft Java mod. Compatible with Minecraft 1.21, 26.1, 26.2. Available via Spigot. Download it and open it directly in the game.