Sashegdev
132 lines
7.1 KiB
Markdown
132 lines
7.1 KiB
Markdown
# ZernMC Launcher
|
|
|
|
**ZernMC Launcher** — это полностью самописный Minecraft-лаунчер, созданный с нуля.
|
|
Клиент написан на **Java**, серверная часть — на **Python (FastAPI)**.
|
|
|
|
## Основные особенности
|
|
|
|
- Написан полностью с нуля, без использования готовых решений
|
|
- Удобная загрузка и обновление сборок прямо с сервера ZernMC
|
|
- Чистый и относительно читаемый код как клиента, так и сервера
|
|
- Поддержка **прокси-режима** через свой сервер при проблемах с внешними ресурсами (Fabric/Forge Maven, Mojang и т.д.)
|
|
- Возможность запуска клиента даже без графического интерфейса (TUI-режим)
|
|
- Полное отсутствие рекламы и телеметрии
|
|
- Не собирает никаких данных о пользователе
|
|
- Работает «из коробки»: достаточно распаковать архив и запустить `ZernMCLauncher.exe`
|
|
- Есть система аккаунтов и проходок
|
|
|
|
## Чего пока нет в лаунчере
|
|
|
|
- Нормальных настроек (пока доступна только настройка Java и выделенной оперативной памяти)
|
|
- Поддержки **Forge** (в разработке)
|
|
- Поддержки Quilt, LabyMod, NeoForge и других лоадеров
|
|
- Раздела новостей об обновлениях Minecraft и лаунчера
|
|
- Выбора готовых пресетов оптимизации JVM
|
|
|
|
## Что планируется доработать в ближайшее время
|
|
|
|
- Генерацию команды запуска Minecraft
|
|
- Стабильную работу автообновления лаунчера
|
|
- Полноценные настройки
|
|
- Стабильность и производительность серверной части
|
|
- Улучшение прокси-режима
|
|
- Общую надёжность загрузки файлов с сервера
|
|
- аккаунты, проходки
|
|
|
|
## Важная информация перед использованием
|
|
|
|
### Управление в лаунчере (TUI)
|
|
|
|
Лаунчер использует **текстовый интерфейс (TUI)**:
|
|
|
|
- `W` / `S` (или `Ц` / `Ы`) — перемещение по меню
|
|
- `ENTER` — выбор пункта
|
|
- `ESC` или пункт «Назад» — возврат назад
|
|
|
|
> **Важно:** Стрелки ↑/↓ могут вызывать баги и краши. Используйте только `W`/`S`.
|
|
|
|
Если вы случайно кликнули мышкой в окне лаунчера и он «заморозился» — просто нажмите **любую клавишу** на клавиатуре.
|
|
|
|
### Расположение сборок
|
|
|
|
Все установленные сборки хранятся в папке:
|
|
- **Windows**: `%USERPROFILE%\.zernmc\instances`
|
|
- **Linux**: `~/.zernmc/instances`
|
|
|
|
Если сборка не удаляется корректно — удалите папку вручную.
|
|
|
|
## Как скачать и запустить
|
|
|
|
Пока автообновления и GitHub Releases не настроены, скачать последнюю версию можно по ссылкам:
|
|
|
|
**Скачать лаунчер:**
|
|
- https://api.zernmc.ru/launcher/download/latest
|
|
- https://api.zernmc.online/launcher/download/latest
|
|
|
|
**Инструкция:**
|
|
1. Скачайте zip-архив
|
|
2. Распакуйте в удобную папку
|
|
3. Запустите `ZernMCLauncher.exe`
|
|
4. Нажмите **«Начать игру»**
|
|
|
|
### Установка первой сборки
|
|
|
|
Если у вас ещё нет сборок:
|
|
1. Выберите **«Установить новую сборку»**
|
|
2. Выберите тип сборки:
|
|
- **ZernMC** — готовые сборки с нашего сервера
|
|
- **Модовый загрузчик** — Fabric / Forge / Quilt и т.д.
|
|
- **Ваниль** — чистая версия от Mojang
|
|
|
|
**Рекомендация:** Не используйте кириллицу в названии сборки! (science 1.0.0-1.0.5)
|
|
|
|
## Возможные проблемы и решения
|
|
|
|
### Проблемы с загрузкой ассетов
|
|
Иногда лаунчер неправильно определяет Asset Index.
|
|
**Решение:**
|
|
1. Запустите версию и посмотрите в логах, какой `.json` файл он пытается загрузить.
|
|
2. Скопируйте правильный файл из `assets/indexes/` и переименуйте его в нужное имя.
|
|
|
|
### Forge версии
|
|
Запуск Forge пока работает нестабильно. Рекомендуется дождаться исправления генерации команды запуска.
|
|
|
|
### Прокси-режим
|
|
Если нет доступа к Fabric/Forge Maven или серверам Mojang — лаунчер пытается использовать наш сервер как прокси. Если и к нему нет доступа — загрузка может не работать.
|
|
|
|
## Как сообщить об ошибке (Issue)
|
|
|
|
1. Скопируйте весь текст ошибки из логов (лаунчер не очищает экран, поэтому просто скролльте вверх)
|
|
2. Укажите, что вы делали перед ошибкой
|
|
3. Укажите версию лаунчера
|
|
4. Создайте Issue на GitHub
|
|
|
|
## Разработка (для желающих помочь)
|
|
|
|
```bash
|
|
git clone https://github.com/SashegDev/launcher
|
|
```
|
|
Откройте `launcher/launcher/pom.xml`
|
|
отредактируете пути для билда, так как сейчас - он расчитан на разработку только на моём сервере
|
|
```bash
|
|
mvn clean package
|
|
```
|
|
можете начинать!
|
|
|
|
### Благодарность
|
|
Glitch135 - За бета-тест лаунчера и фидбеки
|
|
|
|
### помощь
|
|
Я был бы рад если нашлись люди кто мог бы помочь в разработке лаунчера и добавления к нему хотя бы базового UI чтоб было намногл удобнее работать с ним
|
|
|
|
|
|
|
|
Буду рад помощи в разработке!
|
|
Особенно приветствуется помощь с:
|
|
|
|
- Переходом на нормальный графический интерфейс (GUI)
|
|
- Улучшением генерации команды запуска
|
|
- Добавлением поддержки Forge / NeoForge / Quilt
|
|
- Стабилизацией серверной части
|
|
- вообще улучшением клиента
|