# CMC Launcher — офлайн‑лаунчер Minecraft на C

Без аккаунта Microsoft: вводите любой ник (офлайн UUID как у Java `nameUUIDFromBytes("OfflinePlayer:"+ник)`).
Все версии Java Edition (релизы, снапшоты, alpha/beta), загрузчики модов **Fabric, Quilt, Forge, NeoForge**.
Нужная Java (8/16/17/21/25) скачивается автоматически (Mojang runtime, запасной вариант — Adoptium).
С версии 1.1 лаунчер работает со **сборками (instances)** как Modrinth App и умеет ставить моды с **Modrinth** и **CurseForge**.
С версии 1.2 есть **Windows x64** (установщик и портативная версия) и выбор папки для игр на любом диске.
С версии 1.3 можно войти в **аккаунт themaster2009sf ID** (https://auth.themaster2009sf.ru): свой UUID, скины и сетевая игра.
Офлайн-режим остался.

## Аккаунт themaster2009sf ID
- GUI: в блоке «Профиль» переключатель «Офлайн / Аккаунт», логин, пароль, «Войти». Регистрация: https://auth.themaster2009sf.ru/web/registration
- CLI: `cmc login <логин>` (пароль спросит без отображения), `cmc whoami`, `cmc logout`; `--offline` — запустить офлайн, даже если вошли.
- Пароль не сохраняется. В `account.json` (права 0600) лежит только токен, он обновляется перед каждым запуском.
- В игру подключается authlib-injector (скачивается один раз в папку данных) и флаги `-Dminecraft.api.*.host`.

## Диагностика
В папке данных `logs/`: `launcher.log`, при вылете `crash.txt` (+ `crash.dmp` на Windows), при зависании окна `hang.txt`.
«Настройки → Отрисовка интерфейса»: Авто / OpenGL / Vulkan / Программная. После сбоя внутри видеодрайвера
лаунчер сам включает программную отрисовку.

## Windows
- **CMC-Launcher-Setup-x64.exe** — установщик (русский/английский). Можно поставить на любой диск и в любую папку
  (например `D:\Games\CMC`), отдельным шагом выбирается папка для игр и данных (по умолчанию `<папка программы>\data`).
  Ярлык в «Пуск», по желанию — на рабочем столе, запись в «Установка и удаление программ». Деинсталлятор спрашивает,
  удалять ли игровые данные (миры, сборки, моды).
  Тихая установка: `CMC-Launcher-Setup-x64.exe /S /D=D:\Games\CMC` (опции `/DATA=E:\MC-Data`, `/NODESKTOP`).
- **CMC-Launcher-Portable-x64.zip** — распакуйте куда угодно и запустите `CMCLauncher.exe`; всё хранится в папке `data` рядом.
- `CMCLauncher.exe` — окно без консоли; `cmc.exe` — то же самое + командная строка (`cmc.exe list`, `cmc.exe launch ...`).
- Нужная Java для Windows скачивается автоматически. Программа не подписана — SmartScreen может предупредить:
  «Подробнее» → «Выполнить в любом случае».

### Где хранятся игры (папка данных)
Порядок выбора: 1) `--data-dir <папка>` в командной строке; 2) `cmc.ini` рядом с `cmc.exe` со строкой `data_dir=...`
(относительный путь считается от папки exe; установщик пишет сюда выбранную папку); 3) если лаунчер стоит **не** в
`Program Files` — папка `data` рядом с exe (поставили на D: — всё остаётся на D:); 4) иначе `%APPDATA%\cmc-launcher`.
Сменить потом: «Настройки → Папка игры и данных → Изменить…» (можно перенести уже скачанное) или
`cmc datadir D:\Новая\Папка --move`. Java, версии, библиотеки, ресурсы и сборки — всё внутри папки данных.

## Интерфейс (вкладки)
- **Главная** — баннер выбранной сборки, карточки всех сборок (клик — выбрать, двойной клик/«Играть» — запуск,
  «Папка» — открыть папку сборки, «✕» — удалить с подтверждением). Внизу — выбор установленной сборки и кнопка **ИГРАТЬ**,
  рядом маленькая строка статуса (без постоянной полосы загрузки).
- **Создать** — название сборки (уникальное), версия Minecraft (фильтры «Снапшоты», «Alpha/Beta»), загрузчик и его версия,
  кнопка «Установить» с прогрессом прямо на странице. Готовая сборка появляется на Главной.
- **Контент** — выбор сборки, площадка **Все / Modrinth / CurseForge**, тип (моды / ресурспаки / шейдеры / датапаки /
  миры / модпаки), поиск. Показываются только проекты, совместимые с версией и загрузчиком сборки (иконка, автор,
  загрузки, метка площадки). «Установить» берёт самый новый совместимый файл и **сам ставит обязательные зависимости**
  (например Iris → Sodium, JEI → …). Датапак спрашивает мир, мир распаковывается в `saves/`. Справа — установленное
  с кнопками «Обновить» и «Удалить». Тип «Модпаки» → «Создать сборку»; кнопка **«Импорт»** — модпак из файла
  (`.mrpack` Modrinth или `.zip` CurseForge). Если автор мода на CurseForge запретил скачивание сторонними
  лаунчерами — появится окно со ссылкой и папкой, куда положить файл; остальное ставится дальше.
- **Настройки** — ник, ОЗУ по умолчанию, путь к Java, аргументы JVM, размер окна игры, скрытие лаунчера во время игры,
  автовход на сервер, **CurseForge API key**, папка данных.
- **Журнал** — лог установки и вывод игры.

### api.themaster2009sf.ru (с 1.5.0)
Версии Minecraft, Java (Adoptium), загрузчики (Fabric/Quilt/Forge/NeoForge), поиск и файлы CurseForge + Modrinth,
модпаки идут через `https://api.themaster2009sf.ru` — **ключ CurseForge не нужен** (он хранится только на сервере).
Файлы с maven Forge/NeoForge/Fabric, Modrinth CDN, forgecdn, Adoptium качаются через кэширующий прокси API
(`/v1/download`), поэтому работают и там, где эти сайты напрямую недоступны. Mojang (ассеты, библиотеки) — напрямую,
при недоступности — через API. Если API недоступен, лаунчер сам переходит на прямые адреса, как в 1.4;
уже установленные сборки запускаются без API. Свой адрес: `cmc config api_url URL` или переменная `CMC_API`.
Старое поле «CurseForge API key» используется только как запасной путь, когда API недоступен.

## Командная строка
    ./cmc                                   # графический интерфейс (GTK4)
    ./cmc instances                         # список сборок
    ./cmc create "Моя сборка" 1.21.11 --loader fabric [--loader-version 0.20.1]
    ./cmc launch --instance "Моя сборка" --name Ник [--ram 6G] [--server host:port]
    ./cmc delete "Моя сборка"
    ./cmc mods search sodium --instance "Моя сборка" [--source modrinth|curseforge] [--type mod|resourcepack|shader]
    ./cmc mods install iris --instance "Моя сборка"      # slug или id, + обязательные зависимости
    ./cmc mods list --instance "Моя сборка"
    ./cmc mods remove sodium-fabric-0.8.14+mc1.21.11.jar --instance "Моя сборка"
    ./cmc mods update sodium-fabric-0.8.14+mc1.21.11.jar --instance "Моя сборка"   # до новой совместимой версии
    ./cmc search sodium [--type mod|resourcepack|shader|datapack|world|modpack] [--mc 1.21.1] [--loader fabric] [--source all|curseforge|modrinth]
    ./cmc add "Моя сборка" modrinth:sodium            # или curseforge:238222; + обязательные зависимости; датапак: --world Мир
    ./cmc modpack pack.mrpack [--name "Имя"]          # .mrpack / .zip CurseForge / modrinth:slug / curseforge:ID → новая сборка
    ./cmc loaders forge 1.16.5                        # версии загрузчика (Forge: recommended первым)
    ./cmc config [ключ значение]            # nick, ram_gb, java_path, jvm_args, width, height, curseforge_api_key
    ./cmc list [--snapshots] [--old] [--all]
    ./cmc loaders 1.21.11 [--loader fabric]   # старая форма тоже работает
    ./cmc install 1.21.11 --loader fabric   # только установить версию (без сборки)
    ./cmc launch 1.21.11 --name Ник --loader neoforge   # старый режим запуска без сборки
    ./cmc installed
    ./cmc datadir [новая_папка] [--move]   # показать/сменить папку данных

## Данные
Linux: `--data-dir`, `$CMC_HOME`, `~/.config/cmc-launcher/cmc.ini` (`data_dir=...`, пишется командой `cmc datadir`),
иначе `~/.local/share/cmc-launcher`:
- `versions/ libraries/ assets/ java/` — общие файлы игры;
- `instances/<сборка>/` — папка игры сборки: `instance.json`, `cmc-content.json` (что поставлено из Modrinth/CurseForge: source, project, file, filename, sha1),
  `mods/ resourcepacks/ shaderpacks/ saves/ config/`;
- `settings.json` — настройки (старый `settings.txt` переносится автоматически);
- `~/.cache/cmc-launcher/icons/<sha1(url)>` — кэш иконок (Windows: `cache/icons/` в папке данных).

Старые папки `instances/<профиль>/` от версии 1.0 автоматически становятся сборками.
Своя Java: `CMC_JAVA=/usr/bin/java ./cmc ...` или поле «Путь к Java» в настройках.

## Зависимости (Arch Linux)
    sudo pacman -S --needed curl openssl gtk4 zlib xorg-xrandr tar
(`xorg-xrandr` нужен только для старых версий до 1.13 на LWJGL2. Иконки Modrinth в формате WebP показываются,
если есть `webp-pixbuf-loader` или ImageMagick.)

## Сборка из исходников
    sudo pacman -S --needed base-devel pkgconf curl openssl gtk4 zlib
    make            # или make NOGUI=1 (только CLI, без GTK)
    make win        # Windows x64: кросс-сборка mingw-w64 + MSYS2 UCRT64 (win/build.sh, win/fetch_msys2.py),
                    # установщик: makensis win/installer.nsi
    sudo make install PREFIX=/usr/local

Debian/Ubuntu: `sudo apt install build-essential pkg-config libcurl4-openssl-dev libssl-dev libgtk-4-dev zlib1g-dev x11-xserver-utils`.

Или одной командой: `curl -sL https://themaster2009sf.ru/dl/cmc-launcher/install.sh | bash`
