Attributification [Attribute Unification]

Ключевые особенности

• Внутриигровой GUI конфигурации – Редактируйте маппинги прямо в игре с автоматической генерацией GUI
• Статические и динамические маппинги – Статические маппинги используют псевдонимы реестра для простых преобразований 1:1 (требуется перезапуск), динамические маппинги используют конвертацию во время выполнения с полной поддержкой масштабирования (перезагружаемые)
• Конвертация атрибутов – Преобразует модификаторы исходных атрибутов в целевые атрибуты с использованием настраиваемых коэффициентов
• Однонаправленный режим – Управляйте тем, показывает ли источник виртуальные значения или перенаправляет напрямую к цели
• Конвертация операций – Преобразует модификаторы ADDITION в MULTIPLY_BASE/MULTIPLY_TOTAL для правильного масштабирования
• Поддержка резервных вариантов – Сопоставляет с вторичными атрибутами, если основной целевой мод отсутствует
• Режим полной замены – Полностью заменяет определённые атрибуты, чтобы предотвратить проблемы баланса из-за «двойного учёта»
• Перезагрузка в реальном времени – Изменения динамических маппингов применяются сразу после релога (полный перезапуск не нужен)
• Синхронизация клиент-сервер – Конфигурация сервера автоматически синхронизируется со всеми подключёнными клиентами

Как это работает

В отличие от эффектов, которые используют булевы проверки, атрибуты хранят числовые значения. Attributification решает это следующим образом:

1. Конвертация модификаторов: Модификаторы предметов преобразуются из источника в цель в момент применения
2. Виртуальное отображение: Команды /attribute get показывают виртуальные значения, рассчитанные из цели (когда unidirectional=false)
3. Перенаправление атрибутов: Запросы исходного атрибута перенаправляются к целевому атрибуту
4. Трансформация операций: Модификаторы ADDITION можно преобразовать в MULTIPLY_BASE для процентного масштабирования

Однонаправленный режим

Unidirectional = false (по умолчанию):

• Источник показывает виртуальное значение: source = target × equivalence
• /attribute get source возвращает рассчитанное значение из цели
• Используйте в большинстве случаев, когда нужна визуальная согласованность

Unidirectional = true:

• Источник НЕ показывает виртуальное значение
• Прямое перенаправление без умножения
• Используйте, когда хотите, чтобы источник показывал значение цели напрямую

Поддерживаемые моды (из коробки)

Примечание: Предварительно настроенные маппинги включены только в версию для Forge. Пользователи Fabric начинают с пустой конфигурацией, так как большинство целевых модов в стандартных маппингах недоступны на Fabric. Вы можете добавить свои собственные маппинги для Fabric-совместимых модов через внутриигровой GUI или файл конфигурации.

• Магия и заклинания: Iron's Spells 'n Spellbooks ↔ Spell Power Attributes, Ars Nouveau, Eidolon, Goety, Wizard's Reborn

• Основные библиотеки: Apothic Attributes ↔ Obscure API, Turtleboi's Core Library, GTBC's SpellLib/API, Lodestone

• Все задействованные modid: spell_power, irons_spellbooks, traveloptics, gtbcs_geomancy_plus, attributeslib, ranged_weapon, eidolon, more_rpg_classes, obscure_api, turtlecore, gtbcs_spell_lib, goety, ars_nouveau, lodestone, wizards_reborn, iter_rpg

Конфигурация

Внутриигровой GUI

Доступ к GUI конфигурации осуществляется через:

• Fabric: Mod Menu → Attributification → кнопка Config
• Forge: Список модов → Attributification → кнопка Config

GUI предоставляет:

• Визуальный редактор – Редактируйте все маппинги через удобный интерфейс
• Подсказки атрибутов – Выпадающие списки всех зарегистрированных атрибутов
• Предпросмотр в реальном времени – Смотрите изменения сразу, без перезапуска
• Подсказки к полям – Наведите курсор на поля для подробных объяснений
• Сводки списков – Быстрый обзор каждого маппинга в списке

Файл конфигурации

Расположение конфига: config/attributification/attributification.toml

Система конфигурации поддерживает:

• Статические маппинги – Алиасинг в реестре при запуске (требует перезапуска, только простое 1:1)
• Динамические маппинги – Конвертация атрибутов во время работы (перезагружается через релог, поддерживает масштабирование)
• Коэффициенты эквивалентности – Задают точное масштабирование между разными значениями атрибутов
• Конвертация операций – Переключение логики между ADDITION и MULTIPLY_BASE/MULTIPLY_TOTAL
• Однонаправленный режим – Управляет тем, показывает ли источник виртуальные значения или перенаправляет напрямую
• Полная замена – Замораживает исходный атрибут, чтобы предотвратить двойное начисление
• Цепочки запасных вариантов – Задают несколько целевых атрибутов: "primary, fallback1, fallback2"
• Пользовательские маппинги – Добавляют поддержку любого мода, использующего стандартную систему атрибутов Minecraft
• Автоматическая миграция – Старые конфиги автоматически конвертируются в последний формат

Миграция со старых версий

При обновлении:

1. Ваш старый конфиг автоматически конвертируется в последний формат
2. Все ваши пользовательские маппинги сохраняются
3. Старый конфиг сохраняется в резервную копию с расширением .old
4. Никаких ручных действий не требуется!

[[staticMappings]]
sourceAttribute = "spell_power:haste"
targetAttribute = "irons_spellbooks:cast_time_reduction"

[[dynamicMappings]]
sourceAttribute = "spell_power:earth"
targetAttribute = "gtbcs_geomancy_plus:geo_spell_power, irons_spellbooks:nature_spell_power"
equivalence = 3.0
conversionEquivalence = 20.0
unidirectional = false
onlyVisualChange = false
fullReplacement = false
subtractValue = 0.0
operationConversion = "ADDITION_TO_MULTIPLY_BASE"

[[dynamicMappings]]
sourceAttribute = "obscure_api:critical_hit"
targetAttribute = "attributeslib:crit_chance"
equivalence = 1.0
conversionEquivalence = 0.0
unidirectional = false
onlyVisualChange = false
fullReplacement = true
subtractValue = 0.0
operationConversion = "DEFAULT"

[[dynamicMappings]]
sourceAttribute = "some_mod:visual_attribute"
targetAttribute = "minecraft:generic.attack_damage"
equivalence = 1.0
conversionEquivalence = 0.0
unidirectional = false
onlyVisualChange = true
fullReplacement = false
subtractValue = 0.0
operationConversion = "DEFAULT"

**Что происходит:**
- Атрибут-источник переименовывается в целевой без преобразования значения
- Предмет с `+10 some_mod:visual_attribute` отображается как `+10 minecraft:generic.attack_damage`
- Модификатор не преобразуется, меняется только отображаемое имя
- Полезно для косметической унификации

</details>