UnifiedOptions

Если вы читаете это описание, значит я потрудился опубликовать и задокументировать данный мод.

Основная функциональность

Мод объединяет файлы options.txt и настройки клавиш для всех установок Minecraft, в которых он присутствует, создавая единый конфигурационный файл, используемый всеми версиями игры.

Визуальное представление работы мода

Без установленного мода

С установленным модом

Простое использование

Мод работает сразу после установки без дополнительной настройки. При его активации большинство параметров из options.txt перемещаются в файл universal.txt, который располагается в домашней директории:

• Пользователи Windows: %userprofile%/MinecraftOptions
• Пользователи Linux и macOS: ~/MinecraftOptions

Дополнительные возможности

Мод предоставляет функционал, похожий на YOSBR и стандартные настройки, но с отличием: вместо копирования конфигураций из папки внутри директории модпака, он копирует из MinecraftOptions/<версия>/extras. Это позволяет, например, автоматически переносить настройки Journeymap во все модпаки, чтобы карта всегда выглядела одинаково, или отключать назойливые всплывающие подсказки тегов в Immersive Engineering.

Настройка параметров

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

Файл конфигурации находится по пути MinecraftOptions/config.toml и содержит пояснения к каждому параметру.

Для сброса настроек достаточно удалить файл config.toml - мод создаст новый.

По умолчанию следующие параметры НЕ синхронизируются:

• tutorialStep
  • Мод отключает обучающее руководство.

Вы можете добавлять или удалять параметры (включая привязки клавиш) из черного списка. Заблокированные опции будут сохраняться в стандартном файле options.txt.

Местоположение файла universal.txt и дополнительных настроек можно изменить через параметр directory в разделе synchronization. Файл config.toml нельзя переместить.

Особенности версии 1.12

В версии Minecraft 1.12 настройки управления отображаются в числовом формате:

key_key.jump:57
key_key.sneak:42
key_key.sprint:16
key_key.drop:211
key_key.inventory:20
key_key.chat:28
key_key.playerlist:0

В версии 1.16 и выше используются названия клавиш:

key_key.jump:key.keyboard.space
key_key.sneak:key.keyboard.left.shift
key_key.sprint:key.keyboard.left.control
key_key.drop:key.keyboard.q
key_key.inventory:key.keyboard.e
key_key.chat:key.keyboard.t
key_key.playerlist:key.keyboard.tab

Версия мода для 1.12 автоматически преобразует числовые значения в современные названия клавиш. Версии для 1.16 и выше не поддерживают эту функцию, поэтому для конвертации файла options.txt из 1.12 необходимо использовать соответствующую версию мода.

Использование в модпаках

Да, можно использовать.

Maven пакеты для разработчиков

Добавьте в репозитории:

repositories {
    maven { url "https://codeberg.org/api/packages/PORTB/maven" }
}

И добавьте в зависимости:

dependencies {
    //пример: portb:unifiedoptions:1.19.4-1.1
    runtimeOnly fg.deobf("portb:unifiedoptions:<ВЕРСИЯ MC>-<ВЕРСИЯ МОДА>")
}