🍂 Adaptive Skin Weathering

Adaptive Skin Weathering is a visual client-server mod designed specifically for RP servers, hardcore survival, and Vanilla+ modpacks. It turns your character's skin into a dynamic log of their recent adventures, overlaying road dirt, sand, stone dust, snow, and blood based on your actions, taken damage, and the surrounding world.

✨ Key Features

i turned my mod into a full-fledged library. now any developer can use the open API to create their own addons you can overlay absolutely any dynamic layers onto the player's skin — from simple poison veins and dirt to a full, smooth transformation into mobs

for a quick start, i've uploaded ready-to-use project templates and code examples of varying difficulty to GitHub - https://github.com/zhiroslavPrime/ASWexample

🏃‍♂️ Dynamic Skin Weathering

Characters gradually accumulate traces of the environment while moving. The accumulation rate is balanced specifically for immersive gameplay and RP servers (by default, 100% dirtiness is reached after about 15 minutes of continuous walking or 10 minutes of sprinting).

🦿 Smart Terrain Resolver

The color of the accumulating dirt dynamically and smoothly adapts to the blocks you are stepping on:

Dirt and Grass: Classic dark soil.
Mud and Clay: Wet mud (accumulates twice as fast).
Sand: Light-yellow coat of sandy dust.
Stone and Ores: Dark-grey stone dust (automatically accumulates in caves below Y=50).
Snow and Ice: Frosty white coat with a light ice-blue tint (works perfectly even on thin layers of snow cover).
Jumps and Falls: When in mid-air, the dirt type is "sticky" and remembered. It doesn't reset to the default mud color mid-jump.
Custom Blocks (Mod Compatibility): If you step on a block from another mod, the system scans the tags, translation keys, or current biome to find the best match.

🩸 Battle Scars

When taking physical damage (from mobs, falls, arrows, or other players), the character begins to bleed. Each wound leaves unique splashes and bloodstains on random body parts.

🎨 Skin-Tone Adaptation

Effects do not look like flat decals. The overlays analyze the player's skin and adapt the colors to their individual skin tone:

On light skins: Blood appears bright scarlet, and dirt appears classic dark brown.
On dark/fantasy skins (orc, demon): Dirt automatically turns into light clay, and blood takes on a realistic dark-maroon, near-black shade so it doesn't get lost on the skin texture.
Custom Colors: If you disable adaptivity in the settings, the game will use your chosen custom color, dynamically adjusting its brightness (brighter for light skins, thicker and darker for dark skins).

🧼 Natural Cleansing

The effects are not static. Entering water (rivers, lakes) or standing under rain without blocks above your head will gradually wash away dirt and blood, returning the skin to its original clean look. Blood washes off more slowly under the rain, as it has time to dry.

⚙️ Configuration & Localization (ModMenu & Cloth Config)

The mod is fully integrated with ModMenu and Cloth Config, allowing you to customize the visual experience right from the game:

Enable/disable dirt and blood independently.
Adjust the dirt accumulation rate (multiplier).
Separate toggles for adapting dirt and blood color to the skin tone.
Built-in color picker for custom blood color.
Full Localization: The configuration menu automatically switches to English or Russian based on your Minecraft client language.

⚡ Optimization & Security

Developed with a focus on high performance for heavy modpacks:

Lazy Calculations (CPU-friendly): Complex pixel analysis of the skin tone runs exactly once when the player's skin loads and is cached. The game does not waste CPU cycles on calculations every frame.
Memory Leak Protection: The skin cache is automatically cleared during long sessions, and disconnected players' data is fully unloaded from the server memory.
Packet Security (Exploit Protection): The client-side packet receiver has strict range checks and protection against invalid data (NaN/Infinite), preventing client crashes.
3D Skin Layers Compatibility: Overlays are projected directly through the game renderer, so effects lay perfectly on both flat base skins and 3D outer layers (jackets, sleeves, pant legs).