Apothic Category Compat — правильные аффиксы для модового снаряжения
Если вы играли с модом Apotheosis, то наверняка замечали: меч из Twilight Forest или топор из Cataclysm часто не получают ни одного аффикса. Всё потому, что Apotheosis раздаёт бонусы и сокеты только предметам с корректно назначенной категорией лута. Мододелы не всегда прописывают эти категории, а иногда делают это неправильно. Решение — небольшой серверный мод Apothic Category Compat, который заполняет пробелы и заставляет аффиксы работать на почти любом снаряжении.
Что делает Apothic Category Compat
Apotheosis использует категории лута, чтобы решить, какие аффиксы и сокеты могут выпасть на предмете. Когда у модового меча нет категории или она указана неверно, аффиксы просто не генерируются. Apothic Category Compat исправляет это: на Forge он отправляет правильные категории через IMC-API Apotheosis, а на NeoForge для версии 1.21.1 использует data map. Мод работает на загрузчиках Forge и NeoForge, поддерживая Minecraft 1.19.2, 1.20.1 и 1.21.1.
Универсальное правило разделяет оружие ближнего боя на мечи и тяжёлое оружие по скорости атаки. Если скорость 1.0 или медленнее — предмет считается тяжёлым. Урон 10+ тоже переводит оружие в категорию heavy_weapon. Луки, арбалеты, трезубцы, кирки, лопаты, щиты и броня определяются через ванильную иерархию классов. Характеристики читаются в реальном времени, поэтому если другие моды меняют их на лету, всё продолжает работать корректно. Дополнительный проход после загрузки модов ловит предметы, чьи статы окончательно устанавливаются в отложенной инициализации.
Поддержка популярных модов
Для целого ряда модов Apothic Category Compat содержит отдельные модули, которые направляют предметы в правильные категории: меч, тяжёлое оружие, лук, арбалет, трезубец, щит, а также посохи через Fallen Gems & Affixes. В списке — L'Ender's Cataclysm, Twilight Forest, Epic Fight, Weapons of Miracles, Tetra, Marium's Soulslike Weaponry, Alex's Caves, Alex's Mobs, Forbidden and Arcanus, The Undergarden и многие другие. Для версии 1.19.2 список чуть короче, но включает Epic Samurai.
Некоторые моды вообще не требуют отдельных модулей. Simply Swords, Spartan Weaponry, Iron's Spellbooks, Mowzie's Mobs, Bosses of Mass Destruction, Malum и прочие расширяют правильные ванильные классы или имеют реальные атрибуты атаки. Их снаряжение обрабатывается универсальным правилом автоматически.
Настройка и конфигурация
Файл конфигурации находится по пути config/apothic_category_compat-common.toml. При первом запуске версии v2.1.0 или новее настройки переносятся из старого файла apothic_compat-common.toml, так что ваши изменения не потеряются. Есть два основных переключателя. name_based_heavy_override (включён по умолчанию) отправляет предметы с названиями вроде greatsword, claymore, zweihander, warhammer, halberd, glaive, battleaxe, lance, scythe в категорию тяжёлого оружия, а ID, заканчивающиеся на "sword", — в категорию меча. weapon_pickaxes_as_heavy переводит особые кирки из Cataclysm, Forbidden and Arcanus и Twilight Forest в тяжёлое оружие. Отключите его, чтобы они оставались кирками.
Поддерживаются переопределения для отдельных предметов и тегов. Например, можно задать [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, тоже принимаются.
Чёрный список аффиксов
В конфиге есть массив affix_blacklist, куда можно вписать ID аффиксов, которые не должны генерироваться на новых предметах. Например: ["apotheosis:sword/attribute/vampiric", "apotheosis:heavy_weapon/attribute/berserking"]. ID соответствуют пути JSON-файла аффикса. На 1.21.1 порядок пути другой: apotheosis:attribute/sword/vampiric. Чёрный список блокирует только новые выпадения — предметы, уже имеющие такой аффикс, сохранят его. Изменения применяются при запуске сервера, перезагрузке датапаков и через команду /acc reload (или /apothiccategorycompat reload, уровень оп 2).
Версия 1.21.1 на NeoForge
Для Minecraft 1.21.1 и Apotheosis 8.x Apothic Category Compat работает через data map в файле data/apotheosis/data_maps/item/loot_category_overrides.json. В этой версии Apotheosis 8.x сама сортирует большинство снаряжения и объединила категории в одну категорию melee weapon для оружия ближнего боя и breaker для инструментов. Мод заполняет оставшиеся пробелы. В списке поддержки — 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, Forbidden and Arcanus, Mahoutsukai, Deeper Darker, Aether и Traveloptics. Двухцелевые кирки (кузнечные молоты из Cataclysm и Forbidden Arcanus) направляются в melee weapon через тег #apothic_category_compat:weapon_pickaxes. Переключатель weapon_pickaxes_as_melee управляет этим через условие data map — установите false, чтобы оставить их как breaker. Свой датапак может расширить тег дополнительными предметами.
Установка и требования
Для версии 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 data map и чёрный список работают на серверной стороне, а Apotheosis синхронизирует категории клиентам. Скачать Apothic Category Compat можно на популярных площадках модов, файл просто кладётся в папку mods.
Если вы предпочитаете не возиться с ручной установкой, обратите внимание на лаунчер foxygame.net — в его каталоге дополнений Apothic Category Compat для Minecraft добавляется в сборку в один клик, а лаунчер сам следит за совместимостью версий и обновлениями. Это удобно, когда нужно быстро собрать клиент с Forge или NeoForge и сразу приступить к игре.
Итог
Apothic Category Compat — это тот случай, когда маленький мод решает большую проблему. Без него огромный пласт контента Apotheosis просто не работает с популярными модами на оружие и броню. С ним аффиксы, сокеты и гемы начинают выпадать там, где раньше был только пустой слот. Мод настраивается под себя, поддерживает переопределения, чёрный список аффиксов и актуальные версии Minecraft. Если вы играете с Apotheosis и модовым снаряжением — это обязательная часть сборки.