Cape 3D Layers

3D 披风是一个轻量级客户端模组，可将你的 Minecraft 披风与鞘翅渲染为真正的 3D 几何体，而非平面纹理。披风设计会被挤压成体素，边缘正确包裹，鞘翅翼则获得一个沿着翅膀轮廓的实心 3D 外壳。

---

特性

• 🧊 真正 3D 的披风 — 披风会被重建为 16 个堆叠的体素条，其正面、背面和侧边均从实际的披风纹理中包裹而来。
• 🪽 3D 鞘翅 — 鞘翅翼设计被挤压成一个沿着翅膀轮廓的坚硬 3D 外壳，而非扁平的矩形。
• 🌊 WaveyCapes 物理效果（可选） — 安装 WaveyCapes 后，3D 披风将继承其完整的摆动模拟效果。
• 🎒 支持 elytraslot（可选） — 3D 鞘翅可在 elytraslot 的专用鞘翅栏中工作，让你能同时飞行并穿戴胸甲。
• 🛫 兼容 Elytra Physics — 3D 翅膀会自动遵循 Elytra Physics 的飞行姿态。
• ⚙️ 可配置 — 可调整披风厚度、体素大小、摆动样式及渲染距离 LOD。

工作原理

该模组读取原版披风/鞘翅纹理，并将其交给公共的 3D Skin Layers API（create3DMesh），该 API 会构建真实的体素网格。披风被分割成 16 个水平段，因此每一段都能（在 WaveyCapes 下）独立摆动。鞘翅翼则构建为一个刚性的整体外壳，并使用原版翅膀变换进行定位，使飞行/扑翼/滑翔姿态均与原版一致。

一切均在客户端运行。只有安装了此模组的玩家才能看到效果。

依赖项

必需

• 3D Skin Layers — 提供体素网格 API。

可选（安装以启用额外功能）

• WaveyCapes — 披风摆动物理效果。
• elytraslot — 支持专用鞘翅栏。
• Elytra Physics — 更真实的鞘翅飞行（自动兼容）。

安装方法

1. 为 Minecraft 1.21.1 安装 Fabric Loader。
2. 安装 3D Skin Layers（必需）。
3. 将 3D-Cape-*.jar 放入你的 mods 文件夹。
4. （可选）添加 WaveyCapes、elytraslot 和/或 Elytra Physics。

配置

编辑 config/cape3d.json：

键	默认值	描述
enabled	true	总开关。
thickness	1	披风/鞘翅厚度（以像素为单位）（1 = 原版，2+ = 更厚重）。
voxelSize	1.0	3D 网格的整体缩放比例。
chainWave	true	true = 连接链式摆动（无重叠）；false = 重叠段 + 水平偏移。
renderDistanceLOD	14	超过此距离（以方块为单位）后，披风将回退为平面渲染。

常见问题

这在服务器上有效吗？ 是的 — 它是客户端模组。在客户端安装即可；服务器不需要它（安装在服务器上也不会起作用）。

其他玩家能看到我的 3D 披风吗？ 只有安装了该模组的玩家才能看到它。

为什么我的披风看起来仍然很薄？ 删除或更新 config/cape3d.json — 已保存的配置文件不会被新默认值覆盖。