MCA装备兼容

MCA装备兼容

为MCA Reborn村民添加高级装备、饰品和模组兼容性。

MCA Equipment Compat

MCA Equipment Compat 是 MCA Reborn — CurseForge / MCA Reborn — Modrinth 的轻量级非官方附属模组，通过手动装备槽位、Trinkets 支持、可选的 Accessories 兼容、类似玩家的装备耐久机制、经验修补支持以及与其他模组的兼容性，扩展了村民的装备管理功能。

该附属模组的设计目的是与 MCA Reborn 自身的装备系统协同工作，而不是取代它。由 MCA 控制的装备仍由 MCA 管理，而由玩家提供的装备则作为手动装备单独处理。

✨ 特性

🧑 仅限成年村民： MCA Equipment Compat 的装备与饰品系统仅对成年的 MCA 村民可用。婴儿、幼儿、儿童和青少年继续使用 MCA Reborn 的默认行为，不启用本附属模组的自定义装备界面。

🛡️ 手动装备槽位： 为成年 MCA 村民添加专用的头盔、胸甲、护腿、靴子、主手和副手槽位。

⚔️ 模组装备支持： 使用 Minecraft 标准装备系统的兼容盔甲、武器、盾牌及其他物品可以装备在 MCA 村民身上。

🔄 手动 / 自动装备系统： 玩家装备的物品被视为 MANUAL（手动）装备，受到保护，不受 MCA 自动装备逻辑的影响。由 MCA 选择或生成的装备被视为 AUTO（自动），仍由 MCA 控制。当手动物品被移除或损坏时，MCA 可以恢复对该槽位的控制。

🔒 自动装备保护： 由 MCA 管理的 AUTO 装备以锁定预览的形式显示，无法通过附属模组界面移除或复制。用有效的手动装备替换 AUTO 物品时，不会将 MCA 控制的物品交给玩家。

🏹 职业装备保护： MCA 自动生成的职业装备，例如守卫的盔甲、盾牌和弓箭手的弓，仍由 MCA 控制，同时在支持的装备界面中正确显示。

🔁 原生 MCA 装备逻辑： MCA Equipment Compat 不会取代 MCA Reborn 自身的装备选择系统。物品栏变化允许 MCA 的原生装备逻辑刷新，同时手动装备仍受到保护，不会被自动替换。

🎒 Trinkets 支持： Trinkets — CurseForge 是 MCA Equipment Compat 使用的主要饰品系统。支持的 Trinkets 槽位和兼容的饰品可供成年 MCA 村民使用。

⚠️ Trinkets 槽位兼容性： 标准支持的 Trinkets 槽位可正常用于 MCA 村民，但对 Trinkets 的支持并不自动保证与所有添加自定义槽位的模组兼容。模组可能仅为玩家注册新槽位，或使用自定义渲染、特殊能力或仅限玩家的行为。在这些情况下，MCA Equipment Compat 可能需要针对该模组进行专门的兼容性更新。

💍 Accessories 兼容： 添加对 Accessories — CurseForge 的可选兼容，同时 Trinkets 仍是本附属模组的主要饰品系统。Accessories 自身支持的槽位可供成年 MCA 村民使用，并同步盔甲和副手装备槽位、支持手动装备交互、受保护的 AUTO 装备预览，以及对兼容的 Accessories 物品的支持。

⚠️ Accessories 槽位兼容性： 标准支持的 Accessories 槽位可正常用于 MCA 村民，但添加自定义 Accessories 槽位的模组不自动保证可用。自定义槽位可能仅为玩家注册，或依赖特殊渲染、能力或其他仅限玩家的行为。在这些情况下，MCA Equipment Compat 可能需要针对该模组进行专门的兼容性更新。

⚒️ 装备耐久： 手动装备的武器和盔甲采用类似玩家的耐久行为，而 MCA 通常不消耗耐久。

✨ 附魔： 物品附魔和 NBT 会被保留。原版附魔如 耐久（Unbreaking） 通过 Minecraft 标准耐久系统继续生效。

🟢 经验修补支持： MCA 村民可以使用经验修复带有 经验修补（Mending） 的受损手动装备，包括吸引和收集附近的经验球。

🍞 恢复食物安全： 当 MCA 临时用手动手持装备替换为食物时，手动手持装备会被安全保留。进食后、世界/服务器重载后以及死亡处理后，之前的装备会被恢复，不会丢失玩家提供的物品。

🎒 Traveler's Backpack 兼容： 当安装了 Traveler's Backpack [Fabric] — CurseForge 时，背包可以装备在兼容的成年 MCA 村民身上，同时保留其原生存储、升级、储罐和支持的功能。

🧩 Traveler's Backpack 升级安全： 在必要时阻止 MCA 村民使用不支持或仅限玩家的背包能力，帮助避免异常行为，同时保留支持的背包功能。

🛏️ 睡袋兼容： Traveler's Backpack 的睡袋可供 MCA 村民使用，且不会替换其正常的 MCA 住所或居所。

🎨 装饰与饰品兼容： 包含对 Cosmetic Armor [Fabric] — CurseForge、Not Enough Trinket Slots (NETS) — CurseForge 以及支持的 Trinkets 和 Accessories 饰品的支持。

🖼️ 模组装饰渲染： 包含对支持的第三方装饰盔甲渲染器的兼容，否则这些渲染器会在 MCA 村民身上显示缺失/紫色的模型或纹理。

🔥 Torches 'n' Trinkets 兼容： 为 MCA 村民添加 legs/torchslot 槽位，并支持 Torches 'n' Trinkets — CurseForge，包括火炬腰带、灯笼腰带和灵魂灯笼腰带的渲染及动态照明。

🪽 Icarus 兼容： 装备在支持披风槽位中的来自 Icarus — CurseForge 的翅膀会使用 Icarus 自身的翅膀渲染器在 MCA 村民身上渲染。飞行和其他玩家控制的翅膀机制仍仅限玩家。

🌌 The Aether 兼容： 添加对来自 The Aether — CurseForge 的饰品槽位和支持物品的支持，包括为 MCA 村民提供的饰品槽位、支持的披风渲染及兼容的 Accessories 集成。

⚔️ Better Combat 兼容： 添加对 Better Combat — CurseForge 的兼容，包括在 MCA 村民身上正确渲染支持的双手持武器。

🧲 Artifacts 兼容： 包含对来自 Artifacts — CurseForge 的支持饰品效果（包括万能吸引器）的兼容处理。

🪂 仅限玩家滑翔装备保护： 依赖仅限玩家机制的滑翔物品会被阻止装备在 MCA 村民身上。在必要时，通过 Trinkets 或 Accessories 槽位、实际装备槽位或 Shift+点击进行的尝试会被阻止，之前已装备的不兼容滑翔物品会被安全返还至村民物品栏。

🛡️ 不支持的装备保护： 依赖不支持的仅限玩家机制的物品和饰品可以被阻止用于 MCA 村民，以防止崩溃、异常行为或无效的装备状态。

💡 可选动态照明： 支持 LambDynamicLights — CurseForge 以实现兼容的 Traveler's Backpack 灯笼功能和支持的 Torches 'n' Trinkets 装备。

📖 EMI 兼容： 当安装了 EMI — CurseForge 时，村民背包界面包含对 EMI 物品列表和 GUI 排除区域的兼容。

💾 数据保留： 装备、Trinkets、Accessories、装饰品、背包、手动装备状态以及临时恢复食物装备状态在存档、重启和支持的 MCA 恢复流程中均会被保留。

🔄 安全的年龄迁移： 之前将附属模组管理的装备存储在非成年 MCA 村民身上的现有世界会被安全处理。不支持的装备会被找回，而不是被静默丢失，并在村民物品栏满时提供备用处理。

🌙 MCA Bewitchment Compat 兼容： 与 MCA Bewitchment Compat — CurseForge 兼容，在吸血鬼和狼人转化/恢复流程中保留支持的装备和附属模组数据。

📦 前置要求

可选集成

添加新 Trinkets 或 Accessories 槽位的模组不自动保证可与 MCA 村民一起使用。其自身的自定义槽位可能仅为玩家注册，或可能依赖自定义渲染、特殊能力或仅限玩家的机制。这些模组可能需要 MCA Equipment Compat 的专门支持。

⚠️ MCA Reborn 版本兼容性

MCA Equipment Compat 1.0.5 是为 Minecraft 1.20.1 上的 MCA Reborn 7.7.1-beta.1 设计和测试的。

由于 MCA Equipment Compat 直接与 MCA Reborn 的装备、物品栏、村民和渲染系统交互，其他 MCA 版本可能需要更新附属模组。

在更新之前，请务必检查每个 MCA Equipment Compat 版本所需的 MCA Reborn 版本。

🔗 原项目

本附属模组扩展了对以下项目的兼容性：

具有仅限玩家机制的滑翔物品会被有意阻止用于 MCA 村民，且不被视为功能性可选集成。

可选集成仅在安装了其各自模组时才会使用。

对 Trinkets 或 Accessories 的支持并不自动意味着使用这些 API 的每个模组都完全兼容。其标准支持的槽位可以用于 MCA 村民，但引入自身槽位、自定义渲染、特殊能力或仅限玩家机制的模组可能需要专门的支持。

👤 鸣谢

MCA Equipment Compat 由 zClashTM 制作。

MCA Equipment Compat 是一个非官方附属模组，与 MCA Reborn 或其他受支持模组的开发者无关联，也未获得其认可。

所有引用的模组及其资源仍归其各自作者所有。