AutoSwitch [Fabric] [1.21.8] [1.20.5] [1.19.4]

AutoSwitch

AutoSwitch — это модификация для Minecraft (для Fabric / NeoForge), которая автоматически меняет выбранный предмет в зависимости от того, что вы собираетесь сделать — добывать, атаковать, взаимодействовать или при изменении определенных характеристик и того, что доступно на вашей панели быстрого доступа (например, при ударе по каменному блоку рукой, она переключится на кирку).

Она управляется правилами и высоко настраивается через файл конфигурации HOCON autoswitch.conf, расположенный в папке config, которая находится рядом с папкой ресурспаков. Быстрый способ перейти туда — выбрать Настройки > Наборы ресурсов > перейти на одну папку вверх.

Модификацию можно динамически включать/выключать в игре, нажав клавишу R.

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

Данный раздел применим только к AutoSwitch 12+. Более ранние версии использовали другой формат конфигурации.

В файле конфигурации есть четыре раздела — три для определения селекторов и целей при различных действиях и один для общей конфигурации функций:

• attack-action — правила, используемые при атаке (сущностей или блоков).
• interact-action — правила, используемые при взаимодействии (действия, подобные правому клику).
• stat-change-action — правила, активируемые событиями изменения характеристик (например, использование тотема бессмертия).
• feature-config — Управляет общим поведением модификации.

Каждое правило содержит:

• priority — целое число; более высокие значения имеют приоритет, когда несколько целей совпадают.
• target — что соответствует этому правилу (типы: BLOCK, ENTITY, STAT или EXPRESSION, позволяющий комбинировать другие цели). Цели могут ссылаться на теги или конкретные явные идентификаторы (minecraft:ender_chest, sugar_cane).
• tools — упорядоченный массив кандидатов для переключения. Каждый должен быть ITEM или EXPRESSION из ITEM, либо быть пустым списком (чтобы отключить переключение для этой цели).

EXPRESSION могут иметь столько элементов или уровней вложенности, сколько пожелаете, что позволяет осуществлять детальный контроль. Конфигурация по умолчанию охватывает широкий спектр случаев и должна служить отличной основой для расширения.

Инструменты и цели могут иметь дополнительное поле data для управления такими аспектами, как зачарования или состояния блоков, которые должны совпадать.

Изменения в реальном времени

Просто пересохраните файл конфигурации, находясь в игре, чтобы он автоматически перезагрузился.

Подробности

Выражения (Expressions)

Выражения могут быть вложены на любую желаемую глубину.

Выражения поддерживают следующие операции:

• OR — Соответствует любому из своих дочерних элементов
• AND — Соответствует всем своим дочерним элементам
• NOT — Не соответствует ни одному из своих дочерних элементов
• XOR — Соответствует только одному из своих дочерних элементов

Данные (Data)

В настоящее время поддерживаются следующие типы данных:

• BlockState — Состояние блока для сопоставления
• Component — В настоящее время поддерживает только POTION_CONTENTS для предметов
• Enchantment — Зачарования, которые имеет предмет
• EntityEquipment — Экипировка, которую носит сущность, например, свинья с седлом

Приоритет выбора

Порядок принятия решения (первое различие решает):

1. Приоритет цели (Target Priority) — предпочтение отдается правилам с более высоким приоритетом.
2. Рейтинг цели (многоуровневый) (Target Rating) — сравнение уровней рейтинга 0 - n до настроенного максимума. На каждом уровне сравните, по порядку:
   • isGroup (предпочтение отдается не группам)
   • hasData (предпочтение отдается тем, у кого есть данные)
   • typeRating (предпочтительнее более высокий, например, DPS оружия или уровень добычи)
   • dataRating (предпочтительнее более высокий, например, нормализованный уровень зачарования)
3. Приоритет инструмента (Tool Priority) — предпочтение отдается инструментам с изначально более высоким приоритетом.
4. Рейтинг инструмента (многоуровневый) (Tool Rating) — та же логика многоуровневого сравнения, что и для рейтинга цели (isGroup → hasData → typeRating → dataRating).
5. Выбран ли слот в данный момент? — предпочтение отдается currently held slot при равенстве.
6. Наименьший индекс слота — окончательный тай-брейк: побеждает слот с наименьшим (самым левым) индексом в инвентаре.

Текстовая блок-схема

START: candidate inventory slots (all slots that matched a selector)
|
v
Сравнить Приоритет Цели (Target Priority)
|-- если различаются --> выбрать наивысший Приоритет Цели --> END
|
v (одинаковый)
Сравнить Рейтинг Цели (уровни 0..N) (Target Rating)
Для каждого уровня:
- сравнить: isGroup? (предпочтение не группам)
- сравнить: hasData? (предпочтение с данными)
- сравнить: typeRating (выигрывает более высокий)
- сравнить: dataRating (выигрывает более высокий)
|-- если найдено различие --> выбрать победителя --> END
|
v (нет различий)
Сравнить Приоритет Инструмента (Tool Priority)
|-- если различаются --> выбрать наивысший Приоритет Инструмента --> END
|
v (одинаковый)
Сравнить Рейтинг Инструмента (уровни 0..N) (Tool Rating)
(те же правила на уровне, что и для Рейтинга Цели)
|-- если найдено различие --> выбрать победителя --> END
|
v (всё еще равно)
Предпочитать текущий выбранный слот?
|-- Да --> выбрать текущий выбранный --> END
|-- Нет  --> выбрать наименьший (самый левый) слот --> END