Сборки и Java в S3

Backend не хранит игровые файлы на локальном диске. Он читает метаданные из S3 и выдаёт авторизованному лаунчеру короткоживущие signed URL только для разрешённых файлов.

Дерево объектов

launcher/
├── servers/
│   └── {serverId}/
│       └── releases/{releaseId}/
│           ├── profile.json
│           ├── manifest.json
│           ├── manifest.envelope.pb
│           ├── files/{relativePath}
│           ├── assets/{assetIndex}/...
│           └── runtimes/java-{version}-win32-x64/...

serverId — числовой id строки из таблицы servers. Backend возвращает профиль только для существующего видимого сервера.

Профиль сборки

profile.json является источником правил запуска и управления файлами. Пример находится в E:\Wraithbound\wraithbound-launcher-platform\apps\launcher\resources\build-profile.example.json.

Поле	Назначение
`title`, `uuid`, `version`, `dir`	Идентификация клиента и локальный каталог
`assetIndex`, `assetDir`	Индекс и каталог Minecraft assets
`update`	Всегда перекачиваемые файлы
`updateVerify`	Проверяемые и восстанавливаемые файлы
`updateExclusions`	Полностью исключённые пользовательские файлы
`jvmArgs`	Постоянные аргументы JVM
`classPath`, `altClassPath`	JAR и каталоги classpath
`clientArgs`	Дополнительные аргументы Minecraft
`mainClass`	Главный Java-класс
`recommendJavaVersion`	Runtime, который backend добавит в ответ
`minJavaVersion`, `maxJavaVersion`	Допустимый диапазон Java
`settings.ram`	Память в МБ; `0` означает автоматический выбор
`settings.autoEnter`	Добавить адрес default-сервера в game args
`settings.fullScreen`	Добавить `--fullscreen`

Селекторы путей не являются glob-выражениями. libraries означает сам каталог и всё его содержимое. Абсолютные пути, .., обратные слеши и glob метасимволы отклоняются backend’ом.

Manifest сборки

manifest.json создаёт Rust manifest-builder. Для каждого файла он хранит:

{
  "path": "libraries/example.jar",
  "size": 1048576,
  "sha256": "64-hex-characters",
  "kind": "java_library",
  "optional": false
}

Publisher один раз фильтрует manifest до подписи и публикации:

оставляет файлы внутри update + updateVerify;
удаляет элементы, попавшие в updateExclusions;
формирует forceDownload из файлов внутри update;
вычисляет revision из UUID профиля, версии, правил и хешей файлов.

Для versioned-релиза backend больше не меняет инвентарь: он проверяет, что все файлы входят в подписанную управляемую область, и отдаёт его без преобразований.

Java runtime

Runtime выбирается по recommendJavaVersion:

recommendJavaVersion: 8  → launcher/servers/{serverId}/releases/{releaseId}/runtimes/java-8-win32-x64/
recommendJavaVersion: 17 → launcher/servers/{serverId}/releases/{releaseId}/runtimes/java-17-win32-x64/
recommendJavaVersion: 21 → launcher/servers/{serverId}/releases/{releaseId}/runtimes/java-21-win32-x64/

Manifest Java имеет тот же schemaVersion и формат файлов, что manifest сборки. Обязательные файлы:

bin/java.exe
bin/javaw.exe

Они должны быть обычными не optional-файлами. В files/ кладётся уже распакованный runtime целиком. Архив .zip не подходит: Guardian запускает bin/javaw.exe непосредственно из проверенного каталога.

Используйте runtime из доверенного дистрибутива. После публикации manifest нельзя заменять отдельные файлы без повторной генерации manifest: лаунчер обнаружит несовпадение SHA-256.

Автоматическая публикация

Основной способ — операторский Rust CLI wraithbound-publisher. Он получает Mojang assets, при необходимости скачивает и проверяет Java runtime, строит все manifests и синхронизирует точные S3 keys:

cd E:\Wraithbound\wraithbound-launcher-platform
target\release\wraithbound-publisher.exe check --config publisher.toml
target\release\wraithbound-publisher.exe publish --config publisher.toml --dry-run
target\release\wraithbound-publisher.exe publish --config publisher.toml

Credentials передаются через стандартные AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY и опциональный AWS_SESSION_TOKEN. Они не записываются в launcher config или manifest.

Ручная генерация одного manifest

Совместимый manifest-builder остаётся для диагностики и нестандартных операций. В штатном release flow использовать его вручную не требуется. Сборка:

E:\Wraithbound\wraithbound-launcher-platform\target\release\manifest-builder.exe `
  --root "E:\Builds\Create" `
  --output "E:\Builds\Create.manifest.json" `
  --profile-id "fa9c1a52-6fa9-4da6-a488-9fc80250095c" `
  --version "1.21.1" `
  --exclude "logs/**" `
  --exclude "screenshots/**" `
  --progress

Java 21:

E:\Wraithbound\wraithbound-launcher-platform\target\release\manifest-builder.exe `
  --root "E:\Runtimes\java-21-win32-x64" `
  --output "E:\Runtimes\java-21-win32-x64.manifest.json" `
  --version "21" `
  --progress

Порядок публикации CLI

Подготовьте чистый каталог кастомного клиента и profile.json без комментариев.
Запустите check, затем обязательный первый publish --dry-run.
Запустите publish: CLI подготовит assets/runtime и построит manifests.
CLI загрузит тела файлов, затем manifests и profile.json в новый release-каталог.
Установите envelope в launcher-server и отдельно активируйте релиз.
Вызовите launcher/builds/profile с server_id, release_id и тестовым Bearer token.
Проверьте, что ответ содержит profile, build, assets и runtime.
Запустите клиент и убедитесь, что все финальные проверки завершились.

Порядок metadata-last обеспечивается CLI. Remote prune по умолчанию отсутствует, поэтому publisher не удалит файлы из-за ошибочного glob.

Signed URL

Для файлов клиента используется POST launcher/builds/resolve, для Java — POST launcher/builds/runtime/resolve. Новые клиенты передают в каждом запросе server_id и выбранный control-plane release_id; legacy-запрос без release ID оставлен только на время миграции. Backend:

проверяет Bearer session;
повторно загружает активный manifest;
отклоняет путь, которого нет в manifest;
ограничивает batch 500 файлами;
создаёт URL на 15 минут.

S3 access key, secret key и endpoint никогда не попадают в Electron config.

Устройство

Launcher API

Production

Дерево объектов

Профиль сборки

Manifest сборки

Java runtime

Автоматическая публикация

Ручная генерация одного manifest

Порядок публикации CLI

Signed URL

​Дерево объектов

​Профиль сборки

​Manifest сборки

​Java runtime

​Автоматическая публикация

​Ручная генерация одного manifest

​Порядок публикации CLI

​Signed URL

Дерево объектов

Профиль сборки

Manifest сборки

Java runtime

Автоматическая публикация

Ручная генерация одного manifest

Порядок публикации CLI

Signed URL