BiLauncher/doc/cpp/launcherpaths.md

launcherpaths.h

launcherpaths.h, launcherpaths.cpp

Все пути к данным лаунчера. Пространство имён LauncherPaths из свободных функций, состояния нет: каждая функция просто собирает строку.

Данные лаунчера лежат в папке BiLauncher рядом со стандартной папкой игры, а не в системном каталоге данных приложения. QStandardPaths не используется, поэтому имя приложения и организации из main.cpp на эти пути не влияют.

Где что лежит

containerDir() — папка, в которой живут и игра, и лаунчер:

ОС	containerDir()	папка игры по умолчанию	rootDir()
Windows	%USERPROFILE%/AppData/Roaming	.minecraft	BiLauncher
macOS	~/Library/Application Support	minecraft (без точки, как у официального лаунчера)	BiLauncher
Linux	~	.minecraft	BiLauncher

На Linux папка лаунчера получается ~/BiLauncher, без точки, то есть видимая.

BILAUNCHER_HOME

homeOverride() читает переменную окружения BILAUNCHER_HOME. Если в ней абсолютный путь, он заменяет домашнюю папку (~ и %USERPROFILE% в таблице выше) для всех путей лаунчера, включая папку игры по умолчанию. Пустое или относительное значение не учитывается. Остальной Qt (QDir::homePath(), QStandardPaths) эту переменную не видит.

Переменная нужна тестам и дымовой проверке на Windows: там QDir::homePath() спрашивает профиль у системы и USERPROFILE игнорирует, так что иначе их нельзя увести из настоящего %APPDATA%\BiLauncher. Новых возможностей она не даёт: кто управляет окружением процесса, на Linux и macOS и так подменит HOME. Чтобы случайно оставленную переменную было видно, main.cpp при старте пишет в лог предупреждение с итоговой папкой лаунчера.

Внутри rootDir():

BiLauncher/
├── settings.json          settingsFile()
├── profiles.json          profilesFile()
├── customBuilds.json      customBuildsFile()
├── versions.json          legacyCustomBuildsFile() — старое имя, читается только при миграции
├── builds/                buildStorageDir()
│   ├── index.json         журнал BuildSwitcher
│   └── <id>/              buildDir(id): архив сборки, скачанный пак
│       └── season.json    seasonalStateFile(id)
├── java/                  javaDir(): скачанные сборки Java, каждая в <id>/
├── runtime/               runtimeDir(): authlib-injector.jar
└── cache/                 cacheDir(): всё, что можно удалить без потерь
    ├── version_manifest.json   versionManifestFile()
    ├── java_runtimes.json      javaCatalogFile()
    ├── seasonal_builds.json    seasonalCatalogFile()
    ├── loader_<ключ>.json      loaderCacheFile(key)
    ├── loaders/                loaderDownloadDir(): installer.jar и журналы установщиков
    └── java/                   javaDownloadDir(): архивы Temurin до распаковки

Папка игры задаётся в настройках (gameDir). defaultMinecraftDir() используется, только если там пусто.

ensureRootExists(&error)

Создаёт rootDir, runtime, cache, cache/loaders, builds, java и cache/java, а затем проверяет, что каждая из них действительно папка и в неё можно писать. mkpath возвращает true и для существующей папки без прав на запись, и тогда, когда на месте папки лежит файл. Без этой проверки сохранения потом молча не работали бы.

Вызывается при старте бэкенда, перед каждой записью JSON-файлов бэкенда, перед записью кэшей каталогов и перед установками. Остальные функции только собирают строки и ошибиться не могут.

launcherpaths.cpp подключает localization.h ради текста ошибки, заголовок зависит только от QString.

---

При создании этого документа использовался ИИ.