Ambient Winds & Footsteps

Client-side high-immersion mod for Minecraft 1.21.11 "Mounts of Mayhem".Dynamic wind engine, foliage carried by gusts, and realistic footstep prints on the ground.

Author: LunoX

⚠️ Attribution & Derivative Work Notice

This mod is a derivative work that builds upon two existing open-source projects. Per their licenses, full attribution is provided here:

1. FootprintParticle — by Rivmun

• Original repository: https://github.com/Rivmun/FootprintParticle
• License: GPL-3.0-only
• What was used: Particle rotation pattern (quaternion-based yaw orientation), FootprintParticleType carrying entity data via setData(), footprint spawn logic from LivingEntityMixin (block detection, direction calculation, throttle pattern).
• What was changed: Removed configuration GUI, multi-loader support, water/snow-dust sub-particles. Adapted to Mojang mappings for 1.21.11 (SingleQuadParticle instead of TextureSheetParticle, extract() instead of render(), Layer instead of ParticleRenderType). Added 3 texture variations per block type (dirt/sand/snow) and double-footprint textures.

2. Windy (Configurable fork) — by BonfireMC / MacatMovie

• Original repository: https://github.com/MacatMovie/Windy-Configurable
• License: LGPL-3.0-only
• What was used: All 31 wind_*.png and 19 strong_wind_*.png particle textures (64x64 RGBA). ClientLevelMixin hook on doAnimateTick for probabilistic wind spawn. WindParticle physics pattern (scale(50.5), setAlpha(0.5), setSpriteFromAge, createShiftedParticle distance 40-70 blocks). Normal/Strong sub-class pattern with different lifetimes.
• What was changed: Removed Living Wind integration, configuration screen, biome-based density, height scaling. Added a WindManager state machine (CALM ↔ GUST) on top of the vanilla spawn, with stormy-weather coupling. Split textures into normal/strong variants. Added close-range spawn (2-8 blocks) during gusts. Adapted to 1.21.11 API (SingleQuadParticle, extract(), Layer).

3. Original work by LunoX

• Wind state machine (CALM ↔ GUST stochastic automaton)
• Storm weather coupling (rain/thunder → ×3 frequency, ×1.8 force)
• Leaf swirl engine with biome tint
• Footprint color/texture selection per block
• 4 leaf color variations (light green, dark green, autumn yellow, autumn red)
• 3 footprint texture variations (dirt brown, sand yellow, snow white)
• Configuration file (15 options)
• All footprint and leaf textures (32x32 and 16x16)

🌬️ Features

Dynamic Wind Engine

• Stochastic state machine ( CALM ↔ GUST ) with gusts every 30-60 seconds
• During a gust ( 5-10 seconds ) : emits visible wind streaks
• Weather coupling : rain / thunder → gust frequency ×3 and wind force ×1.8
• Wind particles at multiple depths ( close, mid, far )
• 23 wind texture variations ( 15 normal + 8 "strong" for powerful gusts )

Foliage Carried by Gusts

• Stochastic cubic scan around the player ( configurable radius )
• Detects blocks in the #minecraft:leaves tag
• Leaves fall with wind drift + sinusoidal oscillation + lateral sway
• Visual rotation of leaves during the fall
• 4 color variations ( light green, dark green, autumn yellow, autumn red )

Realistic Footstep Prints

• Appear when the player walks on sand, snow, dirt, mud, gravel
• Double texture ( left foot + right foot ) like a walking human
• 3 variations per block : brown ( dirt ), sand yellow, snow white
• Orientation based on entity yaw
• Progressive alpha fade-out over 4-5 seconds
• Accelerated erasure by rain
• Adaptive throttle ( more prints while walking, less while sneaking )

⚙️ Configuration

The mod creates config/ambient_winds_footsteps.properties with 15 adjustable options :

• Enable / disable each subsystem
• Gust interval and duration
• Storm multipliers
• Leaf scan radius
• Spawn rate
• Footprint lifetime
• Alpha fade
• Rain erasure

🚀 Performance

• Zero per-tick allocation on the WindManager side
• Bounded stochastic leaf sampling
• Per-entity throttle for footprints
• Wind spawn via vanilla doAnimateTick ( Windy pattern ) + close spawn during gusts
• All subsystems run only on the client thread

📦 Requirements

• Minecraft 1.21.11 "Mounts of Mayhem"
• Fabric Loader 0.18.1+
• Fabric API
• Java 21+

📜 License

GPL-3.0-only

This mod includes code adapted from FootprintParticle (GPL-3.0) and textures adapted from Windy (LGPL-3.0). Both require this derivative work to also be distributed under GPL-3.0.