Aerial Dash

Add responsive air movement without another key binding.

Aerial Dash adds a configurable mid-air dash to Minecraft. Press the existing Jump key again 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.

Features

• Uses Minecraft's existing Jump binding - no additional key is required.
• One air dash by default, restored on the ground, in water, or on climbable blocks.
• Horizontal dash distance scales with final Movement Speed by default.
• Independent horizontal and vertical scaling options.
• Configurable food, exhaustion, recharge, sound, particle, and fall-protection settings.
• Server-controlled gameplay settings synchronized with connected clients.
• Support for Forge, NeoForge, and Fabric.

Controls

Aerial Dash uses Minecraft's normal Jump binding - Space by default - including keyboard and mouse rebinding.

• Press Jump while airborne to dash.
• After a normal jump, release and press Jump again to dash.
• Press Jump twice quickly to dash directly from water or a climbable block.
• Holding Jump does not repeatedly activate the dash.
• Normal jumps from the ground remain unchanged.

The water and climbable double-press window can be adjusted in the client configuration.

Dash charges and recovery

By default, each 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 surface contact uses a configurable recharge delay to prevent dash spam. Surface-based recovery can also be disabled in favor of a timer-based cooldown.

Dash activation can additionally require a minimum food level and apply a configurable exhaustion cost.

Speed-aware dash distance

Horizontal dash strength scales with the player's final MOVEMENT_SPEED attribute by default.

This means:

• Speed effects increase horizontal dash distance.
• Slowness effects reduce it.
• Attribute-based movement bonuses and penalties from other mods compose naturally with the dash.

Vertical scaling is configured separately and is disabled by default, keeping vertical movement predictable. Horizontal and vertical scaling can be enabled, disabled, and limited independently.

Timing-based fall protection

Aerial Dash can make ordinary exploration more forgiving without making every large fall harmless.

Three settings control fall protection independently:

• 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 dash 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
• Local dash sound toggle
• Local dash particle toggle
• Option to suppress the protected-landing sound

Configuration files are generated automatically after the first launch. Restarting the relevant client or server after manually editing a configuration file is recommended.

Installation and requirements

Supported platforms:

• Minecraft 1.20.1 - Forge
• Minecraft 1.21.1 - NeoForge
• Minecraft 26.1.2 - NeoForge
• Minecraft 26.1.2 - Fabric

Install the file matching both your exact Minecraft version and mod loader.

The mod must be installed on both the client and server. In singleplayer, installing it in the normal client mod folder covers both sides.

Fabric installations also require Fabric API.

Compatibility

Aerial Dash uses standard movement attributes and platform APIs.

It is designed to work naturally with:

• Speed and Slowness
• Attribute-based movement modifiers
• Modded climbable blocks
• Supported swimmable fluids

Mods that replace the same movement or input behavior may require compatibility testing.

Modpacks

You may include the unmodified mod in public or private modpacks without asking for permission.

Aerial Dash is distributed under the Apache License 2.0.