🍂 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, soot, frost, 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 & Balancing
Characters gradually accumulate traces of the environment while moving. The accumulation rates are calibrated for realistic and immersive gameplay:
- Soil/Grass: 100% dirtiness reached after about 10 minutes of walking.
- Sand: Sandy coat reached after about 7 minutes of walking.
- Stone/Gravel: Grey stone dust reached after about 13 minutes of walking.
- Sprinting: Speeds up the accumulation process by 1.5x.

🦿 Smart Terrain Resolver & Carpet Cleaning
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, around 5 minutes).
- 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.
- 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.
- Carpet Doormats: Walking on wool carpets will now quickly wipe the dirt off your feet (takes about 5 seconds of running). Other clean indoor floors (wood, stone, glass) act as neutral zones where dirt won't accumulate.
- 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 & Blood Dripping
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. If your blood level is high or your health drops below the bleeding threshold, realistic blood droplets will drip off your body.

🎨 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).

💧 Dynamic Wetness & Drip Particles
Your skin now reacts dynamically to swimming, rain, or water splashes, getting a beautiful, glossy wet look that dries off gradually (takes 30 seconds by default). When wet, water droplets will realistically drip off your body.
- First-Person Friendly: To prevent screen clutter, drips in first-person view are reduced by 75% and pushed to the edges of the screen, maintaining immersion without blocking your vision.

❄️ Frost & Freezing
Gradually freeze in cold biomes, snowstorms, or when taking freeze damage. Snowflakes will shake off your model as you move. Melting frost or ice temporarily increases your skin wetness.

🔥 Soot & Charcoal
Catching fire or standing near extreme heat leaves a dark charcoal layer on your skin. Wash it off in water, under the rain, or let it naturally disperse over time.

💨 Real-time Voxel Steam Breath
Your character will exhale visible steam breath in cold environments.
- World-Space Physics: The steam stays suspended in the air right where you exhaled, completely independent of your movement or head/body rotation.
- Dynamic Temperature: World temperature drops dynamically by 1/600 per block above sea level (Y > 64) and cools down at night, meaning your breath will steam up on high peaks or during chilly nights.

--- 🧼 MOD INTEGRATIONS ---

- Supplementaries Soap: Lathering up with soap triggers a 3-second gradual cleaning animation with soapy foam, dripping water, clean sparks, and scrubbing sounds, gradually clearing dirt, blood, frost, and soot.
- Create Mod Splashing Fans: Standing in front of an active splashing fan (water + wind) from the Create mod gives you a high-pressure wash, gradually sweeping off dirt, blood, and soot with custom wind and water mist effects.

--- ⚙️ CONFIGURATION & LOCALIZATION ---

The config menu has been completely rebuilt into 6 massive, categorized sections with dozens of precise sliders and toggles:
- General & Visuals: Basic toggles, adaptive colors, custom blood colors, and first-person particle limits.
- Dirt Settings: Set different accumulation speeds for specific blocks (sand, mud, stone, snow) and configure carpet cleaning rates.
- Blood & HP Settings: Adjust damage multipliers, bleeding thresholds, zombie blood factors, and drip chances.
- Wetness, Soot & Breath: Calibrate exactly how fast rain and water wash away different stains, set soot accumulation/drying speeds, and adjust your breath vapor duration and opacity.
- Frost Settings: Fine-tune snow freezing, warm melting, water melting, and snowflake drip rates.
- Mod Integrations: Adjust the washing power of Create fans and the soapy foam efficiency of Supplementaries soap.
- 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: Custom S2C Payload records prevent client crashes and exploit attempts (NaN/Infinite protection).
- 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).
- Admin Commands: I've restricted the /weathering commands to operators (OPs) and local world hosts (Permission Level 2). No more regular players abusing commands on servers.

--- 📦 INSTALLATION & DEPENDENCIES ---

Requires:
1. Fabric Loader (Minecraft 1.20.1 / 1.21.1)
2. Fabric API
3. Cloth Config API (for the config screen)
4. ModMenu (to access the config screen in-game)

This is a client-server mod. For effects to display and sync correctly, it must be installed on both the server and each connecting client.

--- 📞 CONTACTS & SUPPORT ---

If you have any questions, suggestions, or want to report a bug, feel free to contact me:
- Discord: zhiroslavprime

🍂 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).

📦 Installation & Dependencies

Requires:

1. Fabric Loader (Minecraft 1.20.1)
2. Fabric API
3. Cloth Config API (for the config screen) (optional)
4. ModMenu (to access the config screen in-game) (optional)

This is a client-server mod. For effects to display and sync correctly, it must be installed on both the server and each connecting client.

📞 Contacts & Support

If you have any questions, suggestions, or want to report a bug, feel free to contact me:

• Discord: zhiroslavprime
• Twitter: x.com/OknoWindews ASSETS COMING SOON IM TIRED