WindTweaks

WindTweaks

WindTweaks changes wind charge behavior on Paper, Folia, and Fabric servers. It adds a configurable air-hit boost inspired by spear mace wind-charge mechanics on Minemen Club, plus settings for cooldowns and projectile despawning.

Features

• Configure the air-hit boost, including its radius, minimum fall distance, and vertical velocity.
• Optionally require the player to carry a spear.
• Choose whether to keep horizontal velocity, reset fall distance, or apply damage.
• Toggle the boost’s sound and particle effects.
• Disable the boost in selected worlds or dimensions.
• Set the wind-charge cooldown and projectile lifetime.
• Paper and Folia support.

Supported versions

• Paper and Folia: Minecraft 1.21.11–26.3
• Fabric: Minecraft 1.21.11, 26.1.x, 26.2.x, and 26.3.x

Fabric downloads are version-specific. Install the JAR for your Minecraft version. Fabric API is required.

Requirements

• Minecraft 1.21.11: Java 21 or newer
• Minecraft 26.x: Java 25 or newer
• Fabric builds: Fabric Loader and Fabric API

The Fabric mod is server-side. Players joining a dedicated server do not need it installed on their clients. Singleplayer is also supported.

Installation

Place the matching JAR in the server’s plugins folder for Paper or Folia, or in mods for Fabric. Start the server once to create its configuration file.

Commands

• /windtweaks reload — reloads the configuration.

On Paper and Folia, this command requires windtweaks.admin, which is granted to operators by default. On Fabric, it requires operator-level permissions.

Configuration

Edit the config and run /windtweaks reload to apply your changes.

Paper and Folia

File: plugins/WindTweaks/config.yml

wind-charges:
  air-hit:
    # Give the thrower a vertical boost when their own wind charge is close while they are falling.
    enabled: true
    # Require the thrower to carry at least one spear in any inventory slot.
    only-spear: false
    # Maximum distance from the charge to the thrower, in blocks.
    trigger-radius: 1.0
    # Minimum fall distance before the boost can trigger, in blocks.
    minimum-fall-distance: 1.0
    # Vertical velocity applied by the boost, clamped from -4.0 to 4.0 blocks per tick. 0.2 matches v1.
    vertical-velocity: 0.2
    # Keep current sideways motion when applying the boost.
    preserve-horizontal-velocity: true
    # Set to false to keep the player's current fall distance after the boost.
    reset-fall-distance: true
    # Apply generic damage when the air-hit boost triggers.
    damage-enabled: true
    # Damage amount in health points (2 points = 1 heart).
    damage-amount: 1.0
    # Spawn the small gust particle around the player when the boost triggers.
    particle-enabled: true
    # Play the wind-charge burst sound when the boost triggers.
    sound-enabled: true
    # Worlds where the air-hit boost is disabled. Use exact world folder names.
    excluded-worlds: []

  cooldown:
    # Override the vanilla wind-charge item cooldown. Set enabled to false to clear it.
    enabled: true
    # Cooldown duration in ticks. Use 0 for no cooldown.
    length: 10

  despawn:
    # Remove wind charges after the configured lifetime to reduce lingering entities.
    enabled: false
    # Lifetime in ticks (20 ticks = 1 second). Must be at least 1 when enabled.
    time: 200

Fabric

File: config/windtweaks.properties

# Change values, save this file, then run /windtweaks reload.
# Durations use game ticks (20 ticks = 1 second).
# Booleans accept true or false.
#
# Air-hit boost applies when a player's own wind charge is near while they are falling.
# trigger-radius is measured in blocks.
# vertical-velocity is the player's Y velocity, clamped from -4.0 to 4.0.
# only-spear requires any spear in the player's inventory.
# preserve-horizontal-velocity keeps X/Z motion.
# reset-fall-distance prevents accumulated fall damage.
# damage-amount is health points (2 points = 1 heart).
# excluded-worlds is a comma-separated list of dimension IDs, for example: minecraft:the_nether

wind-charges.air-hit.enabled=true
wind-charges.air-hit.only-spear=false
wind-charges.air-hit.trigger-radius=1.0
wind-charges.air-hit.minimum-fall-distance=1.0
wind-charges.air-hit.vertical-velocity=0.2
wind-charges.air-hit.preserve-horizontal-velocity=true
wind-charges.air-hit.reset-fall-distance=true
wind-charges.air-hit.damage-enabled=true
wind-charges.air-hit.damage-amount=1.0
wind-charges.air-hit.particle-enabled=true
wind-charges.air-hit.sound-enabled=true
wind-charges.air-hit.excluded-worlds=

# Cooldown overrides the vanilla wind-charge cooldown.
# Set length=0 for no cooldown.
wind-charges.cooldown.enabled=true
wind-charges.cooldown.length=10

# Remove wind-charge projectiles after this many ticks.
# A value of 200 is 10 seconds.
wind-charges.despawn.enabled=false
wind-charges.despawn.time=200

The optional fall-distance reset may help avoid anti-cheat false positives, but compatibility depends on the server and its anti-cheat configuration.