Effective Instruments

Effective Instruments

Играй музыку. Усиливай союзников. Или проклинай врагов. Effective Instruments добавляет систему магических аур к Genshin Instruments, позволяя музыкантам давать эффекты зелий nearby игрокам и приручённым питомцам во время игры — или, если выбрать вариант с отрицательной полярностью, накладывать дебаффы на nearby мобов. У каждого инструмента есть своя уникальная положительная и атакующая аура — возьми Windsong Lyre и почувствуй, как бриз ускоряет твой шаг (положительная), или вызови завывающий шквал, который замедляет и ослабляет каждого врага в радиусе (атакующая).

Новое в 1.4.x:

• Атакующие (отрицательные) ауры — у каждого инструмента есть зеркальный вариант с дебаффом (Wither, Poison, Slowness, Blindness и т. д.). Выбери иконку с красной рамкой, чтобы переключать полярности на лету.
• Прочность инструментов — инструменты теперь изнашиваются при использовании (прочность NBT для каждого инструмента) и могут быть починены на наковальне. Полоса прочности в ванильном стиле под каждым слотом инструмента. Атакующие ауры изнашивают инструменты быстрее.
• Уникальные ауры 1-к-1 для 42 инструментов. У каждого инструмента GI, EMI (включая все 16 вариантов нотного блока) и Immersive Melodies есть своя собственная пара положительной + атакующей ауры — всего 84 уникальные ауры.
• Широкое нацеливание атакующих аур по умолчанию — отрицательные ауры задевают каждого моба в радиусе, кроме музыканта, его собственных питомцев и питомцев других игроков. Админы могут переключиться на тонкую настройку по категориям, если предпочитают.
• Команда диагностики — /effectiveinstruments diagnose показывает каждый этап в цепочке аур, так что на вопрос «почему моя аура не срабатывает?» есть ответ одной командой.

Из 1.3.0: Опциональная поддержка Immersive Melodies! Ходи с инструментом IM и получай более лёгкие пассивные баффы — экран не нужен.

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

Стационарный уровень (Genshin Instruments / Even More Instruments)

1. Открой любой инструмент из Genshin Instruments (или Even More Instruments).
2. Положительная аура по умолчанию для твоего инструмента выбирается автоматически. У каждого инструмента есть привязанная аура по умолчанию — выбирать вручную не нужно.
3. Сыграй одну ноту, и аура применится сразу ко всем подходящим целям в радиусе. Эффекты обновляются, пока ты продолжаешь играть; цветные частицы музыкальных нот разлетаются наружу, показывая охват ауры.
4. Выбери иконку с красной рамкой в правом верхнем углу, чтобы переключиться на атакующий вариант инструмента. Неамбиентные частицы на задетых мобах показывают, что дебафф сработал.
5. Прекрати играть, и аура отключится после короткого окна задержки (настраивается, по умолчанию 5 секунд). Эффекты естественно истекают.
6. Закрой инструмент, и аура сбросится. Открой тот же инструмент снова — он запомнит твой последний выбор для этой сессии.

Мобильный уровень (Immersive Melodies — опционально)

Когда Immersive Melodies установлен вместе с Effective Instruments:

1. Держи инструмент IM и начни мелодию (автовоспроизведение) или используй режим свободной игры.
2. Свободно ходи вокруг — пассивный бафф ауры применяется к тебе и nearby союзникам с каждым импульсом (по умолчанию: раз в секунду). Цветные музыкальные ноты парят вокруг музыканта, пока аура активна.
3. Пауза или смена инструмента — эффекты ненадолго задерживаются, затем сбрасываются.
4. Выбери иконку с красной рамкой, чтобы переключиться на атакующую ауру мобильного уровня для удерживаемого инструмента.

Мобильные ауры намеренно легче стационарных (один эффект, меньше радиус и длительность) для баланса. Если оба уровня должны примениться к одному игроку, стационарный уровень имеет приоритет по умолчанию.

Поддержка свободной игры появилась в 1.4.3. Достаточно открыть экран IM, чтобы активировать ауру — автовоспроизведение не требуется. (Прочность расходуется только во время автовоспроизведения / фактического проигрывания нот, а не при просмотре списка мелодий.)

Ауры инструментов

У каждого инструмента есть своя уникальная тематическая аура:

Инструменты Genshin

Ещё больше инструментов

Варианты инструментов из нотных блоков (basedrum, bass, bell и т. д.) тоже привязаны к тематически подходящим аурам — полный список смотрите в _README_INSTRUMENTS.txt в папке конфига.

Immersive Melodies (мобильный пассивный уровень)

Все ауры можно свободно настраивать, отключать или удалять. Добавляйте свои, создавая новые JSON-файлы.

Полностью управляемая данными система аур

Каждая аура задаётся простым JSON-файлом в папке конфига:

config/effective_instruments/auras/

При первом запуске мод создаёт 84 стандартных JSON-файла аур (31 стационарная положительная + 31 стационарная атакующая + 11 мобильных положительных + 11 мобильных атакующих) и справочник _README.txt. Дальше всё в ваших руках:

• Редактируйте любую стандартную ауру — меняйте её эффекты, длительность, радиус, цвет, название или описание
• Отключайте ауру, установив "enabled": false — она останется на диске, но не будет появляться в игре
• Удаляйте стандартный файл ауры — он не будет создан заново
• Создавайте новые ауры, добавляя свои .json-файлы в папку

Формат JSON для аур

{
  "displayName": "Fire Ward",
  "description": "Fire Resistance to nearby allies",
  "color": "FF4400",
  "enabled": true,
  "durationTicks": 200,
  "radius": 12,
  "sortOrder": 10,
  "effects": [
    { "effect": "minecraft:fire_resistance", "amplifier": 0 }
  ]
}

Новое в 1.3.0: Два необязательных поля управляют поддержкой уровней:

• "tiers" — массив из "stationary", "mobile" или обоих. По умолчанию ["stationary"], если опущено, так что существующие файлы менять не нужно.
• "showInSelector" — true/false. По умолчанию true для стационарных пресетов, false для мобильных.

Поля:

Каждая запись в массиве effects принимает:

• "effect" — регистрируемое имя эффекта зелья (например, "minecraft:regeneration", "minecraft:speed")
• "amplifier" — уровень эффекта минус 1 (0 = Уровень I, 1 = Уровень II и т. д.)

Если icon/iconSelected опущены, кнопка отображает первую букву отображаемого имени как запасной вариант — так что кастомные ауры не требуют работы с текстурами.

Сопоставление инструментов и аур

Стационарное сопоставление

Файл config/effective_instruments/instrument_auras.json управляет тем, какие ауры доступны для каждого инструмента и какая автоматически выбирается при открытии.

Поддерживаются два формата на запись:

Строковая сокращённая запись — одна аура, по умолчанию и единственный вариант:

"genshinstrument:windsong_lyre": "zephyrs_blessing"

Объектная форма — аура по умолчанию + дополнительные разрешённые ауры в селекторе:

"genshinstrument:windsong_lyre": {
  "default": "zephyrs_blessing",
  "allowed": ["zephyrs_blessing", "echoes_of_antiquity", "bloom_veil"]
}

• Если инструмент не указан, показываются все включённые ауры (обратная совместимость)
• Аура по умолчанию всегда автоматически включается в список разрешённых

Мобильное сопоставление (новое в 1.3.0)

Файл config/effective_instruments/mobile_instrument_auras.json сопоставляет ID инструментов Immersive Melodies с мобильными пресетами аур. Каждая запись — простая строка (одна аура на инструмент, без селектора):

"immersive_melodies:flute": "windstep_mobile"

Используйте /effectiveinstruments reload, чтобы применить изменения к любому из сопоставлений без перезапуска.

Команды

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

Все файлы конфигурации лежат в одной папке: config/effective_instruments/.

Серверный конфиг (server.toml)

Общие настройки:

Настройки целей:

Настройки мобильного уровня (новое в 1.3.0):

Ничего не делают, если Immersive Melodies не установлен.

Клиентский конфиг (client.toml)

Визуальные эффекты

Когда аура активна, по всему радиусу её действия появляются цветные парящие частицы-ноты. Частицы окрашены в цвет настроенной ауры — бирюзовые дрейфующие ноты для Zephyr's Blessing, багровые для Warcry Cadence, фиолетовые для Moonlit Passage и так далее. Они плавно поднимаются, дрейфуют, пульсируют в размере и затухают.

Отрисовка частиц полностью на стороне клиента. Если частицы вызывают проблемы с производительностью, используйте настройку particlesMode в клиентском конфиге, чтобы уменьшить их количество или отключить.

Умная обработка эффектов

• Побеждает сильнейший: Если у цели уже есть более сильная версия того же эффекта из другого источника (например, маяка или зелья), аура не перезапишет её.
• Чистое переключение: Смена ауры мгновенно снимает эффекты старой ауры со всех целей. Мод точно отслеживает, какие эффекты он наложил на какие сущности, и удаляет только свои.
• Чистое закрытие: Закрытие инструмента снимает ауру и удаляет отслеженные эффекты. Аура по умолчанию для инструмента автоматически выберется при следующем открытии.
• Приоритет уровней: Когда к одному игроку могли бы примениться и стационарный, и мобильный уровень, побеждает стационарный и подавляет мобильный (настраивается).
• Фоновые эффекты: Наложенные аурой эффекты используют флаг ambient (едва заметные кружащиеся частицы), чтобы отличать их от зелий и не создавать визуальный шум.
• Память для каждого инструмента: Если вы переопределите ауру по умолчанию для инструмента, ваш выбор запомнится для этого инструмента в рамках сессии (забывается при выходе).

Совместимость

• Genshin Instruments (обязательно) — все экраны инструментов определяются автоматически
• Even More Instruments (опционально) — все экраны EMI наследуют InstrumentScreen из Genshin Instruments и поддерживаются автоматически, включая все 16 вариантов Note Block Instrument
• Immersive Melodies (опционально, новое в 1.3.0) — включает мобильный пассивный уровень. Классы IM не импортируются, нет рефлексии, нет миксинов. Когда IM отсутствует, слой совместимости — ничего не делающая заглушка с нулевыми затратами
• Другие моды на инструменты — используйте настройку screenClassAllowlist в клиентском конфиге, чтобы добавить поддержку экранов из модов, которые не наследуют InstrumentScreen

Эффекты от других модов (зелья, маяки и т.д.) никогда не снимаются и не перезаписываются, если только аура не даёт более сильную или равную версию.

Требования

• Minecraft 1.20.1
• Forge 47+
• Genshin Instruments 5.0+
• Опционально: Even More Instruments 6.0+
• Опционально: Immersive Melodies 0.6.0+ (включает мобильный уровень)

Быстрый старт

1. Установи мод вместе с Genshin Instruments.
2. Открой любой инструмент в игре. Его уникальная аура выбирается автоматически, а соответствующая кнопка появляется в правом верхнем углу.
3. Начни играть. Союзники поблизости получат бафф.
4. (Опционально) Установи Immersive Melodies. Возьми инструмент IM и начни играть мелодию — пассивные баффы активируются автоматически.
5. Чтобы настроить ауры, отредактируй JSON-файлы в config/effective_instruments/auras/.
6. Чтобы изменить привязку инструментов, отредактируй файлы привязок в config/effective_instruments/.
7. Используй /effectiveinstruments reload, чтобы применить изменения без перезапуска.