Сборка Xneon Launcher из исходников: dev и production

Xneon Launcher распространяется под лицензией GPL-3.0, исходный код открыт на GitHub. Сборка требует Node.js 22+ и pnpm 11+. В этой статье описаны шаги от клонирования репозитория до production-сборки через electron-builder.

Требования

Node.js: 22 или выше
pnpm: 11 или выше
Git: для клонирования репозитория

Быстрый старт

Клонируйте репозиторий

git clone https://github.com/XneonTeam/Xneon-Launcher.git
cd Xneon-Launcher

Установите зависимости

pnpm install

Запустите в режиме разработки

pnpm run dev

Или ускоренный режим без полной пересборки:

pnpm run dev:fast

Основные команды

Команда	Назначение
`pnpm run dev`	Режим разработки с hot-reload
`pnpm run dev:fast`	Ускоренный dev без полной пересборки
`pnpm run build`	Production-сборка
`pnpm run package`	Сборка инсталляторов через electron-builder (выход в `release/`)
`pnpm run typecheck`	Проверка типов TypeScript
`pnpm run test`	Запуск тестов
`pnpm run sync:xnlc`	Синхронизация с пакетами `@xnlc/*`

Структура репозитория

Xneon-Launcher/
├── components/launcher/     # React-компоненты UI
├── electron/                # Electron-процессы
│   ├── main/                # Главный процесс
│   └── preload.ts           # Preload-скрипт IPC
├── lib/                     # Утилиты и хелперы
├── packages/                # Модули @xnlc/*
│   ├── xnlc-core/           # Ядро запуска Minecraft
│   ├── xnlc-mods/           # Интеграция с каталогами модов
│   ├── xnlc-servers/        # Управление серверами
│   ├── xnlc-skins/          # Система скинов
│   ├── xnlc-nbt/            # NBT-чтение и запись
│   └── xnlc-types/          # Общие типы TypeScript
├── src/                     # Исходники приложения
│   └── i18n/                # Локализация react-i18next
├── public/                  # Статические ресурсы
└── docs/screenshots/        # Скриншоты для документации

Конфигурация окружения

Файл .env используется скриптом scripts/gen-credentials.mjs для генерации electron/main/cloud/credentials.generated.ts. Этот файл добавлен в .gitignore и создается автоматически при сборке.

Добавление нового IPC-канала

Если вы дорабатываете лаунчер и добавляете новый IPC-канал, следуйте четырехэтапной схеме:

Обработчик в electron/main/
Мост в electron/preload.ts (window.electronAPI)
Тип в src/electron.d.ts
Контракт в packages/xnlc-types/src/ipc-contracts.ts

Воркер запуска Minecraft

Запуск игры выполняется в отдельном воркере: electron/main/minecraft-launch-worker.ts. Это изолирует длительные операции (загрузка ассетов, разрешение библиотек) от UI-потока.

Реестр пакетов

Внутренние пакеты @xnlc/* публикуются в реестре:

https://git.xneon.org/api/packages/MAINER4IK/npm/

Известная проблема: EPERM на dxil.dll

Если при сборке (pnpm run build или package) возникает ошибка доступа к dxil.dll, закройте все окна Xneon Launcher и завершите процессы electron. Это происходит, когда запущенный Electron удерживает файл.

Сборка production

pnpm run build
pnpm run package

Результат появится в папке release/ в форматах для целевой платформы: .exe, .dmg, .AppImage, .deb, .rpm, .pacman или .tar.xz.

Следующие шаги

Изучите модули во вкладке Core
Прочитайте про архитектуру лаунчера
Внесите свой вклад через GitHub Issues

Начало работы

Игра

Серверы

Аккаунт и данные

Справка

Сборка Xneon Launcher из исходников: dev и production

Требования

Быстрый старт

Основные команды

Структура репозитория

Конфигурация окружения

Добавление нового IPC-канала

Воркер запуска Minecraft

Реестр пакетов

Известная проблема: EPERM на dxil.dll

Сборка production

Следующие шаги

​Требования

​Быстрый старт

​Основные команды

​Структура репозитория

​Конфигурация окружения

​Добавление нового IPC-канала

​Воркер запуска Minecraft

​Реестр пакетов

​Известная проблема: EPERM на dxil.dll

​Сборка production

​Следующие шаги

Требования

Быстрый старт

Основные команды

Структура репозитория

Конфигурация окружения

Добавление нового IPC-канала

Воркер запуска Minecraft

Реестр пакетов

Известная проблема: EPERM на dxil.dll

Сборка production

Следующие шаги