[ASW] Adaptive Skin Weathering

🍂 Adaptive Skin Weathering

Adaptive Skin Weathering 是一款专为 RP 服务器、硬核生存和 Vanilla+ 整合包打造的视觉效果客户端-服务器模组。它会根据你的行动、受到的伤害以及周围环境，在角色皮肤上叠加道路尘土、沙尘、石粉、积雪和血迹，让皮肤动态记录角色最近的冒险经历。

✨ 主要特性

我把这个模组改造成了功能完备的前置库。现在，任何开发者都可以使用开放 API 创建自己的附属模组
你可以在玩家皮肤上叠加任意动态效果层——从简单的中毒血管和尘土，到平滑地完全变身为生物

为了方便快速上手，我已在 GitHub 上传可直接使用的项目模板和不同难度的代码示例 – https://github.com/zhiroslavPrime/ASWexample

🏃‍♂️ 动态皮肤风化

角色移动时会逐渐沾上环境留下的痕迹。痕迹累积速度经过专门平衡，适合沉浸式游戏体验和 RP 服务器（默认情况下，连续行走约15 分钟或疾跑10 分钟后，污渍会达到 100%）。

🦿 智能地形识别

累积污渍的颜色会根据你踩过的方块动态、平滑地变化：

• 泥土和草方块：经典的深色土壤。
• 泥泞和黏土：湿泥（累积速度翻倍）。
• 沙子：浅黄色沙尘覆盖层。
• 石头和矿石：深灰色石粉（在 Y=50 以下的洞穴中会自动累积）。
• 雪和冰：带有淡淡冰蓝色调的霜白覆盖层（即使是薄薄的积雪也能完美生效）。
• 跳跃和坠落：身处空中时，污渍类型会保持不变并被记住，不会在跳跃途中重置为默认的泥土颜色。
• 自定义方块（模组兼容性）：如果你踩到其他模组添加的方块，系统会扫描其标签、翻译键或当前生物群系，以找到最合适的匹配项。

🩸 战斗伤痕

受到物理伤害（来自生物、坠落、箭矢或其他玩家）时，角色便会开始流血。每处伤口都会在随机身体部位留下独特的血液飞溅和血迹。

🎨 肤色适配

这些效果并非生硬的贴花。叠加层会分析玩家的皮肤，并根据其肤色调整颜色：

• 浅色皮肤：血迹呈鲜亮的猩红色，污渍则呈经典的深棕色。
• 深色/奇幻风格皮肤（兽人、恶魔）：污渍会自动变为浅色黏土，血迹则呈现逼真的深栗色，接近黑色，避免与皮肤纹理融为一体。
• 自定义颜色：如果在设置中关闭适配，游戏将使用你选择的自定义颜色，并动态调整其亮度（浅色皮肤上的颜色更亮，深色皮肤上的颜色则更浓、更暗）。

🧼 自然清洁

这些效果不是静态的。进入水中（河流、湖泊），或在头顶没有方块遮挡的地方淋雨，都会逐渐洗去污渍和血迹，让皮肤恢复原本的洁净状态。血迹在雨中会洗得更慢，因为它有时间变干。

⚙️ 配置与本地化（模组菜单和 Cloth Config）

本模组与ModMenu和Cloth Config全面集成，你可以直接在游戏内自定义视觉效果：

• 分别启用/禁用污渍和血迹。
• 调整污渍累积速度（倍率）。
• 分别设置污渍和血迹颜色是否适配肤色。
• 内置自定义血迹颜色选择器。
• 完整本地化：配置菜单会根据 Minecraft 客户端语言，自动切换为英语或俄语。

⚡ 优化与安全

专为在大型整合包中实现高性能而开发：

• 惰性计算（对 CPU 更友好）：肤色的复杂像素分析会在玩家皮肤加载时仅运行一次，并将结果缓存起来。游戏不会每帧都浪费 CPU 周期进行计算。
• 防止内存泄漏：长时间游玩时会自动清理皮肤缓存，玩家断开连接后，其数据也会从服务器内存中彻底卸载。
• 数据包安全（防止漏洞利用）：客户端数据包接收器设有严格的范围检查，并能防护无效数据（NaN/Infinite），避免客户端崩溃。
• 兼容 3D 皮肤层：覆盖层会直接通过游戏渲染器投射，因此无论是平面基础皮肤，还是 3D 外层（夹克、袖子、裤腿），效果都能完美贴合。

📦 安装与依赖

需要：

1. Fabric Loader（Minecraft 1.20.1）
2. Fabric API
3. Cloth Config API（用于配置界面）（可选）
4. ModMenu（用于在游戏内打开配置界面）（可选）

这是一个客户端-服务器模组。要正确显示和同步效果，服务器和每位加入的客户端都必须安装此模组。

📞 联系方式与支持

如有疑问、建议或想要报告漏洞，欢迎联系我：

• Discord： zhiroslavprime
• Twitter： x.com/OknoWindews

资源稍后上传，我累了