[ASW] 自适应皮肤风化

🍂 自适应皮肤风化

自适应皮肤风化是一款专为角色扮演服务器、硬核生存和原版增强整合包设计的客户端-服务器模组。它能将你的角色皮肤变成一本动态的冒险日志，根据你的行动、受到的伤害以及周围环境，在皮肤上叠加道路尘土、沙子、石粉、雪和血迹。

---

✨ 主要特性

我已将我的模组转变为一个功能完备的库。现在任何开发者都可以使用开放 API 来创建自己的附加组件。 你可以在玩家皮肤上叠加任意动态图层——从简单的毒液血管和污垢，到完整流畅的怪物变身。

为快速上手，我在 GitHub 上上传了随时可用的项目模板和不同难度的代码示例——https://github.com/zhiroslavPrime/ASWexample

🏃‍♂️ 动态皮肤风化

角色在移动时会逐渐累积环境痕迹。累积速度经过专门平衡，以提供沉浸式游戏体验和角色扮演服务器（默认情况下，连续行走约 15 分钟或冲刺 10 分钟后达到 100% 脏污度）。

🦿 智能地形识别器

累积的污垢颜色会根据你踩到的方块动态且平滑地适配：

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

🩸 战斗伤痕

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

🎨 肤色自适应

效果看起来不是扁平贴图。叠加层会分析玩家的皮肤，并将颜色适配到其个体肤色：

• 在亮色皮肤上： 血液呈现鲜红色，污垢呈现经典的深棕色。
• 在暗色/幻想类皮肤（兽人、恶魔）上： 污垢会自动变为浅色黏土，血液则呈现逼真的深栗色、近乎黑色，这样就不会在皮肤纹理上显得突兀。
• 自定义颜色： 如果在设置中禁用自适应性，游戏将使用你选择的自定义颜色，并动态调整其明度（亮色皮肤上更亮，暗色皮肤上更浓郁深沉）。

🧼 自然清洁

效果并非静态。进入水体（河流、湖泊）或站在没有方块遮挡的雨中，会逐渐洗去污垢和血迹，让皮肤恢复原有的洁净外观。血迹在雨中会洗得更慢，因为它有时间干涸。

---

⚙️ 配置与本地化（ModMenu 和 Cloth Config）

该模组完全集成了 ModMenu 和 Cloth Config，让你可以直接从游戏中自定义视觉效果：

• 独立启用/禁用污垢和血迹。
• 调整污垢累积速率（倍率）。
• 分别开关污垢和血迹颜色对肤色的自适应。
• 内置血迹颜色选择器。
• 完全本地化： 配置菜单会根据你的 Minecraft 客户端语言自动切换到英文或俄文。

---

⚡ 优化与安全

开发时特别注重重型整合包的高性能表现：

• 惰性计算（CPU 友好）： 对肤色进行复杂的像素分析仅在玩家皮肤加载时执行一次并缓存。游戏不会每帧浪费 CPU 周期进行计算。
• 内存泄漏保护： 皮肤缓存在长时间会话中会自动清理，已断开连接的玩家数据会从服务器内存中完全卸载。
• 数据包安全性（漏洞防护）： 客户端的接收器具有严格的范围检查和针对无效数据（NaN/无限值）的保护，防止客户端崩溃。
• 3D 皮肤层兼容性： 叠加层直接通过游戏渲染器投影，因此效果可以完美地铺设在平面的基础皮肤和 3D 外层（夹克、袖子、裤腿）上。

---

📦 安装与依赖

需要：

1. Fabric 加载器（Minecraft 1.20.1）
2. Fabric API
3. Cloth Config API（用于配置界面）（可选）
4. ModMenu（用于在游戏中访问配置界面）（可选）

这是一个客户端-服务器模组。为了效果正确显示和同步，它必须同时安装在服务器和每个连接的客户端上。

---

📞 联系方式与支持

如果你有任何问题、建议，或想报告漏洞，欢迎联系我：

• Discord： zhiroslavprime
• Twitter： x.com/OknoWindews 资源即将推出，我累了。