PixelLauncher/README.md

PixelLauncher

Компактный оффлайн-лаунчер Minecraft в стиле LiteLauncher: тёмное минималистичное окно, пиксельный пейзаж-баннер, большая зелёная кнопка «ИГРАТЬ» и пилюля с версией.

Возможности

• Оффлайн-режим — ник + сгенерированный по правилам Mojang UUID
• Менеджер аккаунтов — несколько ников, клик по нику в шапке для быстрого переключения, управление в «Аккаунты…»
• Все версии из официального манифеста Mojang (920+): релизы, снапшоты, старые версии
• Лента новостей — последние версии прямо на главном экране (клик выбирает версию)
• Fabric и Quilt — установка модлоадера одной кнопкой (меню → «Установить Fabric/Quilt…»): скачивается JSON профиля, файлы лоадера докачиваются при первом запуске
• Автодокачка client jar, библиотек, нативов и ассетов с проверкой SHA-1 (многопоточно)
• Отмена загрузки — кнопка «■ ОТМЕНА» под статусом во время докачки
• Зеркала скачивания — если официальные серверы Mojang плохо грузятся, укажите зеркала в настройках (по одному в строке)
• Автозагрузка Java — если подходящей Java нет, лаунчер сам скачает JRE с Eclipse Adoptium (~45 МБ) в .launcher/runtime/ и запустит игру
• Детектор вылетов — при ненулевом коде завершения журнал открывается сам и показывает хвост лога с ошибкой
• Живой лог игры — вывод игры течёт в окно «Журнал» в реальном времени
• Очистка версий — меню → «Очистка версий…»: размер каждой установленной версии, удаление ненужных и подчистка неиспользуемых ассетов
• Моды — меню → «Моды…»: список установленных модов с включением/выключением (переименование в mods-disabled), удалением и поиском в Modrinth (нужен только стандартный HTTP) — установка одной кнопкой под текущую версию и загрузчик
• Импорт модпаков .mrpack (CurseForge/Modrinth-пакеты): скачивание файлов по индексу, раскладка оверрайдов, проверка путей
• Обновления модов — в «Моды…» кнопка «Проверить обновления»: включённые моды сверяются с Modrinth по SHA-1 (батчи через POST /version_files), свежие версии скачиваются, старый jar отключается в .disabled
• Разбор вылетов — после аварийного завершения журнал сам называет причину: нехватка ОЗУ (с подсказкой -Xmx), проблема с Java, исключение (корневое Caused by) и виновный мод — с вопросом «Отключить его?»
• Профили запуска — меню → «Профили…»: несколько профилей (ник, версия, ОЗУ, полный экран и по желанию набор включённых модов), переключение одной кнопкой, имя активного профиля в пилюле
• Миры и копии — меню → «Миры и копии…»: список миров с размером и датой, ZIP-копия по одному миру с капом последних копий (настраивается), удаление копий и миров, быстрый переход в папку копий
• Избранные версии — ★ в диалоге версий закрепляет версию сверху, фильтр «только избранные», частые (по статистике запусков) поднимаются вверх списка
• Трей — свёртывание в трей (иконка в области уведомлений), плашки о статусе запуска/вылета, контекстное меню с командами лаунчера
• История и статистика — меню → «История…»: сколько раз запускалась каждая версия, суммарное и последнее время игры, сводка вылетов
• Прокси — настройки → сеть: HTTP и SOCKS5 (с авторизацией), проверка соединения кнопкой
• Настройки запуска игры — профиль: пресеты JVM (мало RAM / быстро / безопасно / чисто / для Fabric), разрешение и полный экран, окно игры
• Архив логов — окно «Журнал» показывает сеанс и все прошлые game-*.log с поиском по тексту (Ctrl+F, «только ошибки»)
• Скин — предпросмотр фронтального вида по нику (кэш mc-heads.net) или своё фото (PNG 64×64), кнопка рядом с ником
• Сцены баннера — день / ночь / незер / пещера или случайная при каждом открытии (меню → «Сцена баннера»)
• Масштаб интерфейса 100/125/150% (настройки), ярлык текущей версии на рабочем столе, экспорт/импорт настроек в JSON
• Быстрые повторные запуски — см. раздел «Скорость»
• Проверка целостности — меню → «Проверить файлы игры…» (полный пересчёт SHA-1)
• Наследование версий (inheritsFrom), виртуальные ассеты для старых версий
• Автоподбор Java под конкретную версию игры (PATH, JAVA_HOME, Program Files, ~/.jdks, /usr/lib/jvm)
• Профиль: ник, ОЗУ (или «авто» по памяти системы), Java, JVM-аргументы
• Резервная копия миров в ZIP
• Выбор версии в отдельном диалоге: поиск-фильтр, даты релиза, отметка снапшотов и локальных (Fabric/Quilt) версий
• Язык интерфейса RU/EN — переключается в настройках
• Акцентный цвет — пять вариантов в настройках
• Окно можно менять по размеру — захват за «◢» в правом нижнем углу
• Быстрый доступ к папкам — игры, миров и скриншотов прямо из меню
• Журнал с цветными сообщениями (успех/ошибка/предупреждение) и Ctrl+C для копирования
• Лог запуска игры — полный вывод пишется в .launcher/logs/game-*.log
• Автообновление лаунчера — меню → «Проверить обновление лаунчера…» и тихая проверка при старте: манифест /update.json, скачивание установщика с проверкой SHA-256, запуск обновления в один клик
• Своё зеркало API — запросы к Modrinth и манифесту Mojang идут через прокси на VPS; при сбое зеркало отключается до конца сессии и запрос уходит напрямую, на официальный путь
• Без сторонних библиотек — только tkinter

Запуск

python main.py

Или двойной клик по run.bat (Windows).

Требуется Python 3.8+ с tkinter. Дополнительные библиотеки ставить не нужно.

Сборка установщика

python make_installer.py

Собирает PixelLauncherSetup<версия>.exe прямо в папке проекта. Внутри — embeddable Python той же версии + заимствованный tkinter/Tcl, приложение и иконка; установка в %LOCALAPPDATA%\PixelLauncher без прав администратора (скрипт installer.iss, нужен Inno Setup 6 с ISCC.exe). Версия в installer.iss должна совпадать с LAUNCHER_VERSION; после новой сборки обновите файл и update.json на сервере.

Плагины и протокол

• Плагины — файлы Python в папке plugins рядом с main.py: константы PLUGIN_NAME/VERSION/AUTHOR/DESCRIPTION, функция on_load(api) (подписки api.on(...), кнопки api.add_action(...)) и необязательный on_unload(). События: launcher_ready, before_launch, after_launch, game_exit, profile_switched, account_switched, launcher_closing. Своё json-хранилище плагина — plugins/storage/. Управление: меню ⚙ → «Плагины…» (пересканирование, удаление) и «Магазин плагинов…» (каталог с сайта).
• Протокол pixellauncher:// — ссылки с сайта: plugin/<файл.py> ставит плагин из магазина, mrpack/<url> скачивает и импортирует модпак. Ключи HKCU пишет установщик; если лаунчер уже открыт, ссылка уходит в очередь и обрабатывается работающей копией.
• Формат плагинов совпадает с верстаком на сайте (/constructor); каталог магазина — /plugins/catalog.json.

Скорость

Повторные запуски не тратят время на лишнюю работу:

• Манифест версий (около 1.5 МБ) не перекачивается каждый раз: свежий кэш (до 1 часа) читается с диска — загрузка списка занимает ~0.1 с вместо ~2 с. «Обновить список версий» в диалоге принудительно ходит в сеть.
• JSON версии кэшируется на 6 часов и не качается заново при каждом запуске.
• Проверка уже скачанных файлов — по размеру (один stat на файл) вместо полного чтения и пересчёта SHA-1. Для версии с 3000+ ассетов это секунды на каждом старте. Полная проверка SHA-1 — по запросу: меню → «Проверить файлы игры…».
• Обнаружение Java кэшируется (.launcher/java_cache.json): java -version прогоняется по кандидатам один раз, повторные запуски берут версию из кэша.
• Нативы распаковываются один раз: повторная распаковка пропускается, пока natives-jar'ы не изменились (сигнатура в .stamp).
• Загрузка файлов — до 32 параллельных потоков, прогресс обновляется по мере готовности каждого файла.

Интерфейс

• Верхняя панель: логотип, ник (клик — переключение аккаунтов), шестерёнка — меню (профиль, профили запуска, аккаунты, версии, Fabric/Quilt, копия, миры и копии, плагины, магазин плагинов, скачивание, очистка, папки, журнал, настройки, о программе)
• Баннер: пиксельный пейзаж с заголовком PIXEL LAUNCHER, тянется на всю ширину окна; сцена переключается в меню (день/ночь/незер/пещера/random)
• ИГРАТЬ — большая зелёная кнопка с анимацией нажатия (цвет = акцентный цвет из настроек)
• Пилюля Minecraft <версия> — клик открывает список версий
• Лента «Последние версии» — 3 свежие версии из манифеста, клик выбирает версию
• Внизу — тонкая полоса прогресса и строка статуса; во время загрузки под статусом появляется кнопка отмены
• Кнопка «—» сворачивает лаунчер в трей (кнопка «×» закрывает)
• Диалоги со списком версий идут в тёмном оформлении (Windows 10/11)

Все файлы игры хранятся в .minecraft рядом с лаунчером (меню → Настройки).

Структура

main.py              точка входа
launcher/
  ui.py              интерфейс: окно, баннер, диалоги
  config.py          настройки (settings.json), аккаунты, зеркала
  i18n.py            перевод интерфейса (RU/EN)
  manifest.py        манифест версий Mojang + кэш, локальные версии
  version.py         разбор JSON версии, classpath, аргументы
  downloader.py      докачка библиотек/ассетов, зеркала, отмена, нативы
  java.py            поиск и выбор Java
  java_fetch.py      автозагрузка JRE с Eclipse Adoptium
  mods.py            установщик Fabric/Quilt + менеджер модов, обновления
  modrinth.py        поиск и установка модов с Modrinth API (+ POST /version_files)
  mrpack.py          импорт модпаков .mrpack
  crash.py           разбор логов вылетов: причина и виновный мод
  worlds.py          список миров, ZIP-копии с капом, удаление
  stats.py           история запусков и статистика игры
  tray.py            иконка в трей, меню и плашки (Windows)
  launch.py          оффлайн-UUID, запуск, живой лог, код завершения
  http.py            HTTP-хелперы: повторы, SHA-1, прогресс, отмена, прокси,
                     зеркала API (одна попытка через зеркало, затем напрямую)
  selfupdate.py      автообновление: манифест /update.json, SHA-256, установщик
  onboarding.py      мастер первого запуска: язык, ник, ОЗУ
  plugins.py         плагины: загрузка .py, события, API, хранилище, магазин
  protocol.py        протокол pixellauncher:// и одна живая копия лаунчера

Примечания

• Работает только оффлайн-режим Minecraft (серверы в offline-режиме).
• Java: 1.20.5+ → Java 21+, 1.16–1.20 → Java 17+, 1.12–1.16 → Java 8/11. Лаунчер подберёт подходящую автоматически, а если Java не найдена — скачает её с Eclipse Adoptium и положит в .launcher/runtime/.
• Лента новостей собирается из манифеста версий Mojang (официальные RSS-эндпоинты minecraft.net закрыты).
• Зеркала скачивания задаются в настройках (по одному URL в строке); SHA-1 у файлов одинаков на любых зеркалах, проверка не меняется.
• Прокси (HTTP/SOCKS5) применяется ко всем запросам лаунчера, включая загрузку файлов игры, поиск модов и установку модпаков.
• Манифест автообновления и зеркала API живут на VPS и доступны по домену: база обновлений — https://pixellauncher.ru (UPDATE_BASE в selfupdate.py), зеркала — https://pixellauncher.ru/proxy/…. HTTPS выпущен Let's Encrypt (certbot), автопродление — snap-таймер certbot.
• Установленный лаунчер не пишет в системные папки: файлы игры, settings.json и сам лаунчер лежат в %LOCALAPPDATA%\PixelLauncher, деинсталлятор не трогает .minecraft и журналы.
• При первом запуске показывается мастер первоначальной настройки (язык, ник, ОЗУ) — launcher/onboarding.py. Он закрывается кнопкой «Пропустить настройку», после чего не появляется снова: флаг onboarding_done в settings.json (апгрейд со старой версии мастер не показывает).