MEOWS

MEOWS

мои существующие настройки выживут

Что это?

Похоже на YOSBR или Configured Defaults, этот мод позволяет копировать стандартные файлы игры при запуске Minecraft. Это полезно для создателей модпаков, которым нужно включить файлы конфигурации, но не хочется сбрасывать изменения пользователя после каждого обновления.

В отличие от вышеупомянутых модов, MEOWS реализует систему «действий», в которой при запуске можно выполнять определённые действия, например перезаписывать или удалять указанные файлы. Действия выполняются только один раз.

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

Каждый файл в директории defaults будет скопирован в соответствующее место в корневой директории игры. Например, .minecraft/defaults/options.txt будет скопирован в .minecraft/options.txt, если файла там ещё нет.

Мод настраивается через файл config/meows/config.json. Это включает текущую версию стандартных файлов (для действий) и действия, выполняемые для каждой версии. Чтобы использовать MEOWS как YOSBR или Configured Defaults, эти параметры можно игнорировать.

Действия хранятся в виде массива объектов, каждый из которых содержит массив файлов для перезаписи или удаления и соответствующую версию. Вот пример, который перезапишет файл options.txt:

{
  "version": 2,
  "actions": [
    {
      "version": 2,
      "overwrite": [
        "options.txt"
      ]
    }
  ]
}

При запуске игры MEOWS выполнит эти действия, если они ещё не выполнялись. Затем локальная версия MEOWS будет обновлена, чтобы эти действия больше не могли выполниться.

Для действий перезаписи файл должен иметь соответствующий файл в директории defaults.

{
  "version": 3,
  "actions": [
    {
      "version": 3,
      "delete": [
        "options.txt"
      ]
    },
    {
      "version": 2,
      "overwrite": [
        "options.txt"
      ]
    }
  ]
}

В этом примере верхнее действие имеет приоритет. options.txt будет удалён, несмотря на то что он перезаписывался в предыдущей версии.

Учтите: если файл options.txt всё ещё присутствует в директории defaults, он будет скопирован, если его нет, при следующем запуске игры, так как действия обрабатываются только один раз.

Зачем?

Из моего опыта поддержки модпаков я обнаружил, что похожие моды упускают одну важную вещь: как автор модпака может управлять изменениями файлов? В конце концов, они копируют файлы только если их ещё нет, а значит, крупные изменения в файлах конфигурации или обновление уже созданных файлов невозможны. MEOWS решает эту проблему своей системой действий, предоставляя способ выполнения одноразовых операций над файлами.

FAQ

Будет ли это портировано на другие загрузчики модов?

В будущем, вероятно.

Будет ли это портировано на другие версии Minecraft?

В будущем, вероятно.

Почему здесь используется preLaunch, а не language provider на Fabric?

В идеале этот мод должен быть абсолютно неприхотлив в поддержке. Поэтому я выбрал «правильные» пути во многих архитектурных решениях, в частности избегая хакерского метода language provider, который используют другие похожие моды, чтобы запуститься как можно раньше. Это означает, что некоторые другие моды могут создавать файлы до того, как MEOWS сможет скопировать их стандартные значения. Однако я обнаружил, что такие случаи достаточно редки, чтобы не быть большой проблемой.