Перейти к содержимому
На этой странице

Как загружаются моды

У Minecraft Bedrock нет собственной поддержки модов: мод — это нативный код, который загрузчик помещает в процесс игры при её запуске. Эта страница объясняет, какие загрузчики использует LeviLauncher, где лежат моды и как связаны разные способы добавить мод.

Где лежат моды Windows

У каждого инстанса есть папка mods\ (см. Папки и файлы). Каждый мод — это папка в ней с файлом manifest.json, который описывает мод:

Поле Значение
name Имя мода.
entry Файл, который загружает загрузчик, относительно папки мода (.dll).
version Версия мода.
type Какой загрузчик его загружает: preload-native — нативный загрузчик LeviLauncher; у модов для LeviLamina свои типы.
author Автор (необязательно).

Моды принадлежат одному инстансу. На них не влияет изоляция, которая касается только игровых данных.

Выключение мода (в Управлении модами или командой LeviLauncher.exe mod disable) переименовывает его manifest.json в manifest.json.close; включение возвращает прежнее имя. Файлы мода остаются на месте, а загрузчик, который ищет manifest.json, больше не находит мод.

Два загрузчика Windows

Нативный загрузчик LeviLauncher

Когда LeviLauncher устанавливает или подготавливает инстанс, он кладёт свой загрузчик LeviLauncher.dll рядом с исполняемым файлом игры и добавляет его в импорты исполняемого файла, чтобы Windows загружала его вместе с игрой. Это работает для сборок x64, как GDK, так и UWP; на этом же держится изоляция.

При запуске игры нативный загрузчик обходит папки в mods\ в порядке их имён и загружает entry каждого мода с type, равным preload-native. Папки без manifest.json и моды других типов пропускаются. Если у инстанса есть другой предзагрузчик (preloader.dll рядом с игрой), нативный загрузчик оставляет всю загрузку модов ему. Нативному загрузчику нужна среда выполнения Visual C++ (x64), которую LeviLauncher проверяет и предлагает установить.

LeviLamina

LeviLamina — загрузчик модов LeviMC. Большинство модов на LeviMC Mods — это моды LeviLamina: им нужна LeviLamina в версии, поддерживающей версию игры инстанса. LeviLauncher устанавливает LeviLamina в инстансы GDK поддерживаемых версий (переключатель Установить LeviLamina при установке версии или вкладка Загрузчик в Настройках инстанса) как пакет встроенного менеджера пакетов.

Три способа добавить мод Windows

Что вы добавляете Что делает LeviLauncher
Мод из LeviMC Mods (или mod install owner/repo) Устанавливает его как пакет встроенным менеджером пакетов, совместимым с lip: скачивает релиз для этой платформы, устанавливает пакеты, от которых он зависит, и записывает его в .lip\state.json инстанса. Если моду нужна LeviLamina, а установленная не подходит (или её нет), сначала устанавливается совместимая LeviLamina. Такие моды можно обновлять и удалять как пакеты.
Пакет .mcmod (или .zip) Распаковывает его в новую папку в mods\. В архиве должен быть manifest.json.
Отдельный .dll Кладёт его в новую папку в mods\ и пишет для него manifest.json: по умолчанию имя файла как имя, preload-native как тип и 0.0.0 как версию.

Пакет указывает, где он работает, полями side (client или server) и platform (например, win-x64) в своём lip.toml и в .lip\state.json. Для клиента LeviLauncher устанавливает вариант мода client, если он есть, иначе вариант по умолчанию. Подробности, включая миграцию старых пакетов, — в разделе Моды и интеграции.

Android Android

Версия для Android загружает нативные моды: библиотеки .so, которые работают в процессе игры. Держите сборки с модами в изолированных версиях и устанавливайте моды только из надёжных источников. Чтобы сделать свой, следуйте Android native mods в документации LeviLamina.

Связанные страницы