冰与火史诗战斗兼容（兼容链接）

CompatLink：冰与火 CE

为冰与火的每一种武器提供史诗战斗动作集——以及一套在战斗模式下仍保留其角部的护甲。

此整合包为冰与火：社区版 2.0（NeoForge 1.21.1）提供两项功能。

1. 武器动作集

龙骨质/龙钢质/银质/铜质剑将作为剑挥动，它们的斧作为斧，龙骨质弓作为弓，钓鱼矛和潮汐三叉戟作为矛，斯廷法利斯鸟匕首作为匕首，以及巨型巨魔武器作为双手巨剑——共计26种武器，通过CompatLink映射实现。您无需自行编写史诗战斗数据包。

2. 保持真实形状的护甲

史诗战斗从不调用原版护甲层，因此在战斗模式下，用于替换冰与火真实护甲模型的钩子永远不会触发。通常您会得到一个普通的原版轮廓：没有龙钢角、没有面甲、没有海蛇鳍——并且纹理会被拉伸到错误的UV网格上。

此整合包通过其公开的模型转换器API将这些真实模型交给史诗战斗，因此所有30套冰与火护甲（120件物品）都能在战斗模式下以其实际几何形状渲染：

• 12种龙鳞颜色（红色、绿色、青铜色、灰色、蓝色、白色、蓝宝石色、银色、电光色、紫水晶色、铜色、黑色）
• 3套龙钢护甲（火焰、寒冰、闪电）——包括角和面甲
• 7套海蛇（潮汐）护甲
• 3套死亡蠕虫护甲，3套巨魔护甲，外加金属银和金属铜

此桥接程序读取护甲渲染器注册表而非硬编码物品列表，因此数据包添加的颜色和变体也由同一代码覆盖。它仅客户端运行，在专用服务器上不执行任何操作，如果史诗战斗、Uranus或冰与火缺失，则会静默退出。所有失败路径都会回退到史诗战斗的默认行为，而不是抛出异常。

---

⚠️ 不要将冰与火放入CompatLink的armors[]

如果您的config/compatlink/mappings/中有以下内容，请将其移除：

"armors": [ { "target": "iceandfire:*" } ]

史诗战斗在咨询任何模型转换器之前，会先寻找预先构建的assets/<命名空间>/animmodels/armor/<物品>.json。CompatLink的armors[]生成器恰好会创建这些文件——因此将冰与火留在armors[]中会使史诗战斗完全忽略此整合包，而您将回到普通的原版轮廓。

这两项功能通过不同途径解决同一问题，并且无法同时驱动同一件物品：

	CompatLink armors[]	此整合包的桥接程序
方式	重写史诗战斗的通用网格UV	使用模组自身的模型几何形状
轮廓	原版形状	真实形状（角、面甲、鳍）
范围	任何模组，数据驱动	通过Uranus渲染护甲的模组

为您的其他模组保留armors[]——只是不要将iceandfire包含在内。如果桥接程序发现冰与火的护甲部件是通过预构建网格而非自身渲染的，它会在日志中记录一条单行警告，指明该物品名称；如果护甲仍然显示异常，请在日志中搜索CompatLink/IceAndFire。

前置要求

• CompatLink 1.1.0+——必需
• 史诗战斗、冰与火：社区版、Uranus——可选；如果缺少任何一个，此整合包会无害地闲置

---