Аргументы и параметры лаунчера
Данные аргументы полезны для упрощения или автоматизации запуска клиента игры или сборок. Также они могут быть использованы для создания портативного клиента игры.
Название параметров командной строки постоянны и не будут меняться на протяжении всего цикла разработки лаунчера, поэтому использование приведенных ниже аргументов исключает сброс необходимых для работы настроек.
Аргументы prebootstrap
Prebootstrap считается устаревшим. Данный абзац приведен для исторических целей.
Если по каким-то причинам вы до сих пор используете prebootstrap - пожалуйста, обновитесь до актуальной портативной сборки
Аргументы prebootstrap можно передать напрямую при запуске из командной строки, в свойствах ярлыка или записать их в файл tl.pbargs. При этом файл с аргументами должен находиться в той же папке, что и исполняемый файл prebootstrap.
| Аргумент | Описание |
|---|---|
--debug | Включить отладку (позволяет понять на каком этапе запуска происходит ошибка) |
--skipUpdate | Пропустить обновление prebootstrap |
--bootstrap <путь> | Путь к bootstrap.jar лаунчера |
--jreDir <путь> | Местоположение папки с хранилищем JRE |
--jre <имя> | Имя JRE, которую следует использовать для запуска Bootstrap (доступны: win64, win86, win64_jre8u45, win86_jre8u45) |
--skipBootstrapUpdate | Не проверять и не обновлять bootstrap.jar |
Арг ументы bootstrap
Bootstrap подготавливает окружение для работы лаунчера, по сути являясь лаунчером для лаунчера. Через его файл аргументов можно задать базовые настройки лаунчера. Это основной jar-файл лаунчера, через который осуществляется его запуск.
Аргументы для Bootstrap можно передать как через файл tl.args, так и через tl.bootargs. В первом случае они передаются как аргументы приложения, во втором – как аргументы Java
Как аргумент приложения (tl.args) | Как аргумент Java (tl.bootargs) | Описание |
|---|---|---|
--targetJar <путь к файлу.jar> | -Dtlauncher.bootstrap.targetJar=<путь к файлу.jar> | Указывает путь к исполняемому файлу лаунчера. |
--targetLibFolder <путь> | -Dtlauncher.bootstrap.targetLibFolder=<путь> | Указывает путь к папке библиотек лаунчера. |
--brand <имя> | -Dtlauncher.bootstrap.brand=<имя> | Переопределяет бренд лаунчера ( legacy, legacy_beta, mcl, …) |
--ignoreUpdate | -Dtlauncher.bootstrap.ignoreUpdate=true | Отключает загрузку файлов лаунчера, игнорирует обновления лаунчера. Не отключает саму проверку обновлений! |
--ignoreSelfUpdate | -Dtlauncher.bootstrap.ignoreSelfUpdate=true | Отключает проверку целостности и загрузку обновлений bootstrap. Не отключает саму проверку обновлений! |
--headlessMode | -Dtlauncher.bootstrap.headlessMode=true | Скрывает интерфейс bootstrap. Не влияет на интерфейс лаунчера. |
--packageMode <режим> | -Dtlauncher.bootstrap.packageMode=<режим> | Включает режим совместимости с различными видами портативных сборок (windows, aur, dmg, …) |
--updateMetaFile <путь> | -Dtlauncher.bootstrap.updateMetaFile=<путь> | Указывает путь к заранее загруженному файлу обновления (bootstrap.json.mgz.signed). Файл должен быть подписан приватным ключом разработчика лаунчера. |
--restartExec <файл> | -Dtlauncher.bootstrap.restartExec=<файл> | Включает функцию перезапуска после обновления: следует указать путь к исполняемому файлу (напр. restart.sh) |
-- | не применимо | Разделяет параметры бус трапа и лаунчера. Все аргументы, переданные после --, считаются аргументами лаунчера |
Аргументы лаунчера
| Аргумент | Описание |
|---|---|
--directory <путь> | Путь к используемой папке игры. Блокирует выбор пути в настройках лаунчера. |
--help | Выводит все доступные аргументы и закрывает лаунчер. |
--java-executable <путь> | Указывает путь к исполняемому файлу JRE (например, java или javaw.exe). |
--jre-dir <путь> | Указывает путь к директории с рекомендумыми Java, которые скачивает сам лаунчер. |
--javaargs <аргументы> | Указывает аргументы для Java. Блокирует редактирование аргументов Java в настройках лаунчера. |
--margs <аргументы> | Указывает аргументы для Minecraft. Блокирует редактирование аргументов Minecraft в настройках лаунчера. |
--settings <путь_к_файлу> | Указывает путь к файлу конфигурации лаунчера. Файл будет создан при его отсутствии. |
--username <имя_пользователя> | Указывает имя пользователя по умолчанию. Если он не существует, то будет создан (только при --usertype plain) |
--usertype <тип_аккаунта> | Указывает тип аккаунта, если по этому имени есть несколько аккаунтов (plain,minecraft (Microsoft), ely). |
--version <версия_игры> | Указывает запускаемую версию игры по умолчанию. |
--window <ширина>;<высота> | Указывает размеры окна лаунчера. |
--background <путь_к_файлу> | Указывает путь к заднему фону лаунчера. Поддерживаются протоколы: http(s), ftp, jar (в качестве zip-архива) и file. Блокирует выбор фона в настройках лаунчера. |
--fullscreen <значение> | true (игра запускается в полноэкранном режиме) или false (игра зап ускается в оконном режиме). |
--launch | Включает функцию «Отложенного запуска» - игра будет запущена автоматически через несколько секунд после открытия окна лаунчера. |