Aerial Dash
Aerial Dash adds a responsive and configurable mid-air dash to Minecraft.
Press the existing Jump key while airborne to launch yourself in the direction you are looking. The mechanic uses immediate client prediction for responsive controls, while the server independently validates and applies every dash.
Controls
Aerial Dash uses Minecraft's normal Jump binding — Space by default — including keyboard and mouse rebinding.
- Press Jump once while airborne to dash.
- Press Jump twice quickly while swimming or climbing.
- Normal jumps from the ground remain unchanged.
- Holding Jump does not repeatedly activate the dash.
- After jumping normally, release and press Jump again to dash.
No additional key binding is required.
Movement-aware dashing
Horizontal dash strength scales with the player's final MOVEMENT_SPEED attribute by default.
This means:
- Speed effects increase dash distance.
- Slowness effects reduce it.
- Other attribute-based movement bonuses compose naturally with the dash.
Vertical scaling is separate and disabled by default, keeping vertical movement predictable. Both horizontal and vertical scaling can be configured independently.
Dash charges and recovery
By default, the player has one air dash.
Dash charges are restored by touching:
- The ground
- Water or another supported swimmable fluid
- Ladders, vines, and other climbable blocks
Dashing directly from water or a climbable block is supported. These states use a quick double press so the mechanic does not interfere with ordinary swimming and climbing.
Continuous contact has a configurable recharge delay to prevent dash spam. Alternatively, surface-based charges can be disabled in favor of a configurable timer cooldown.
Dashing also has configurable food and exhaustion requirements.
Skill-based fall protection
The default fall-damage system is designed to help normal exploration without making large falls completely harmless.
Aerial Dash provides three independent settings:
- Safe fall distance: increased from the vanilla 3 blocks to 6 blocks by default.
- Reset fall distance on dash: clears accumulated fall distance when the server approves a dash.
- Full landing protection: optionally cancels all fall damage from the first landing after a dash.
Full landing protection is disabled by default. With the default settings, avoiding damage from a long fall requires saving the dash until close to the ground.
Sounds and particles
The server can configure:
- Dash sound and volume
- Minimum and maximum sound pitch
- Particle type and count
- Particle spread and speed
- Whether sounds or particles are produced at all
Each client can independently hide Aerial Dash sounds or particles without affecting effects created by Minecraft or other mods.
Invalid or unsupported effect IDs safely fall back to the default phantom-flap sound and cloud particles.
Configuration
Gameplay settings are controlled by the server and synchronized to clients for correct movement prediction.
Server configuration includes:
- Global enable switch
- Dash power and vertical boost
- Horizontal and vertical movement-speed scaling
- Reference speed and scaling limits
- Number of dash charges
- Ground, water, and climbable recharge rules
- Surface recharge delay or timer cooldown
- Food requirement and exhaustion cost
- Safe fall distance
- Fall-distance reset
- Optional full landing protection
- Sound and particle settings
Client configuration includes:
- Water/climbable double-press window
- Dash sound visibility
- Dash particle visibility
- Protected-landing sound suppression
Configuration files are generated automatically after the first launch. Restarting the relevant client or server after manually editing a configuration file is recommended.
Supported platforms
| Minecraft | Mod loader | Java | Additional dependency |
|---|---|---|---|
| 1.20.1 | Forge | Java 17 | None |
| 1.21.1 | NeoForge | Java 21 | None |
| 26.1.2 | NeoForge | Java 25 | None |
| 26.1.2 | Fabric | Java 25 | Fabric API |
Always download the file matching both your Minecraft version and mod loader.
Aerial Dash must be installed on both the client and server. For singleplayer, installing it in the client instance is sufficient because Minecraft starts an integrated server automatically.
Compatibility
Aerial Dash uses standard movement attributes and platform APIs instead of depending on specific movement mods.
It is designed to work naturally with:
- Speed and Slowness
- Attribute-based movement modifiers
- Modded climbable blocks
- Supported swimmable fluids
Modpacks
You may include Aerial Dash in any public or private modpack, including monetized modpacks where permitted by the relevant platform rules. No separate permission is required.
When you use the original, unmodified JAR, no additional attribution steps are needed. The license and copyright notice are already bundled inside the JAR, so you do not need to copy them to your modpack page or include separate files.

