Apothic Category Compat

Apothic Category Compat

一个适用于 Forge 和 NeoForge 的小型服务端模组，用于补全武器和盔甲模组的 Apotheosis 战利品分类；这些模组可能没有设置分类，或设置了错误的分类。在 Forge 上，它通过 Apotheosis 的 IMC 覆盖 API 发送分类；在 NeoForge 1.21.1 上，则通过 Apotheosis 数据映射添加分类。

版本

1.20.1 和 1.19.2（Forge）：通用攻击速度和伤害规则，以及通过 IMC 发送的各模组模块。1.19.2 支持的模组列表较短。
1.21.1（NeoForge）：数据映射。Apotheosis 8.x 会自行分类大多数装备，并合并了分类（近战武器统一为一个分类，采矿工具归为破坏工具），因此此版本会补全 Apotheosis 遗漏的分类。

功能（Forge）

Apotheosis 使用战利品分类来决定物品可以获得哪些词缀和宝石插槽。许多模组武器没有分类或分类错误，因此无法获得词缀。本模组会在加载时发送正确的分类。

通用规则会根据攻击速度，将近战武器分为剑或重型武器（攻击速度为 1.0 或更低时归为重型武器；伤害达到 10.0 或更高时也会归为重型武器）。弓、弩、三叉戟、镐、铲、盾牌和盔甲则根据原版类层级进行分类。属性会实时读取，因此即使其他模组在运行时修改属性，本模组仍能正常工作。读取属性时也会回退到物品堆级别的属性，因此 Epic Fight 风格的武器（如 Weapons of Miracles 的巨斧）也能正确识别。

模组加载完成后还会进行第二轮检查，以识别那些属性在延迟初始化期间才确定的武器。

Apotheosis 硬编码了几个默认值，这些默认值的优先级高于此处设置的分类（minecraft:iron_sword 归为剑，minecraft:shulker_shell 归为无分类）。

各模组模块

将这些模组中的物品归入正确分类（剑、重型武器、弓、弩、三叉戟、盾牌、无分类；若存在 Fallen Gems & Affixes，则还可归为法杖或剑）：L’Ender’s Cataclysm、Twilight Forest、Epic Fight（本体、Nightfall、Resurrection）、Weapons of Miracles、Tetra、Marium’s Soulslike Weaponry、Meet Your Fight、Dungeons and Combat、Alex’s Caves、Alex’s Mobs、Aquamirae、Born in Chaos、Forbidden and Arcanus、Traveloptics、Celestisynth、The Undergarden。

1.19.2 支持的模组列表较短，并包含 Epic Samurai，以替代部分仅适用于 1.20.1 的模组。

由通用规则处理

这些模组会继承正确的原版类，或带有实际攻击属性：Simply Swords、Integrated Simply Swords、Spartan Weaponry、Spartan Shields、Epic Knights、Samurai Dynasty、Dread Steel、Iron’s Spellbooks、Mowzie’s Mobs、Bosses of Mass Destruction、Deeper and Darker、Knight Quest、Enigmatic Legacy、Malum、RPG Style More Weapons、Cataclysm 自带的近战武器和盾牌，以及其他所有使用原版类武器或带有攻击伤害属性的物品，此外还包括盔甲。

分类设置

apothic_category_compat-common.toml 中有两个开关。编辑后重启即可应用。

name_based_heavy_override（自 v2.1.0 起默认开启）：ID 中包含重型武器名称（greatsword、claymore、zweihander、warhammer、halberd、glaive、battleaxe、lance、scythe 等）的物品会归为 heavy_weapon，以 “sword” 结尾的 ID 则会归为 sword。现有配置会保留原来的值，因此请将其设为 true，或删除配置文件以采用新的默认值。
weapon_pickaxes_as_heavy（默认开启）：Cataclysm 的 Void Forge 和 Infernal Forge、Forbidden and Arcanus 各等级的铁匠木槌，以及 Twilight Forest 的 Cube of Annihilation 会归为 heavy_weapon。关闭此项则会将它们归为 pickaxe。

配置

配置文件位于 config/apothic_category_compat-common.toml。首次启动 v2.1.0 或更高版本时，旧配置文件 apothic_compat-common.toml 会迁移至此，因此原有设置会保留。单个物品和标签的覆盖设置：

[item_overrides]
“ruins:greatsword” = “heavy_weapon”

[tag_overrides]
“simplyswords:greathammers” = “heavy_weapon”

有效类别：sword、heavy_weapon、trident、bow、crossbow、shield、helmet、chestplate、leggings、boots、pickaxe、shovel、none。将物品设为 none 可使其不随机获得任何词缀。其他模组注册的类别（例如 Fallen Gems & Affixes 中的法杖）也同样受支持。

1.21.1 NeoForge（Apotheosis 8.x）

通过位于 data/apotheosis/data_maps/item/loot_category_overrides.json 的 NeoForge 数据映射进行覆盖。

将以下模组中的物品归入正确的类别（远程武器归入 bow，双叉戟归入 trident，法杖和镰刀归入 Apothic Compats 的 staff 和 scythe 类别，后两者仅在同时加载 Apothic Compats 和 Malum 时生效）：L’Ender’s Cataclysm、Alex’s Caves、Alex’s Mobs、Born in Chaos、The Undergarden、Twilight Forest、Lands of Icaria、Iron’s Spellbooks、Ice and Fire、Ice and Fire Spellbooks、Forbidden and Arcanus、Mahoutsukai、Deeper Darker、the Aether 以及 Traveloptics。

双用途镐（Cataclysm 的锻炉和 Forbidden Arcanus 的铁匠锤）通过 #apothic_category_compat:weapon_pickaxes 物品标签归入近战武器。weapon_pickaxes_as_melee 配置开关（默认开启）通过数据映射条件控制此行为；将其设为 false 可让它们保持为破坏工具。可从你自己的数据包扩展该标签以覆盖更多物品。

词缀黑名单

阻止特定词缀随机出现在新生成的装备上。在 affix_blacklist 数组中列出词缀 id：

affix_blacklist = [“apotheosis:sword/attribute/vampiric”, “apotheosis:heavy_weapon/attribute/berserking”]

词缀 id 与 JSON 文件路径对应，例如 data/apotheosis/affixes/sword/attribute/vampiric.json 对应 apotheosis:sword/attribute/vampiric。在 1.21.1 上路径顺序变为 attribute//，因此同一词缀在那里是 apotheosis:attribute/sword/vampiric。

仅阻止未来的随机结果；已带有黑名单词缀的物品会保留该词缀。在服务器启动、数据包重载和 /acc reload 时重新应用。

重载命令

/apothiccategorycompat reload 或 /acc reload（需要 OP 等级 2）会重新读取配置并在 Forge 上重新应用。在 1.21.1 上它会重新读取词缀黑名单；数据映射则遵循常规的数据包 /reload。

需求

1.20.1：Forge 47.x，Apotheosis 7.4.x。
1.19.2：Forge 43.x，Apotheosis 6.5.x。
1.21.1：NeoForge 21.1.x，Apotheosis 8.5 或更新版本。

在 Forge 上，请同时在客户端和服务端安装，以确保词缀属性显示和宝石镶嵌加成正确。在 1.21.1 上，数据映射和词缀黑名单在服务端运行，Apotheosis 会将类别同步到客户端。

许可证

MIT