From 920330bbabbe499f9c74b6df2b11c25cbf1d9d6d Mon Sep 17 00:00:00 2001 From: Sashegdev Date: Tue, 7 Apr 2026 11:17:36 +0300 Subject: [PATCH] =?UTF-8?q?REAMDE.md=20update,=20=D0=BC=D1=8F=D1=83?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- README.md | 77 +++++++++++++++++++++++++++++++++++++++++++++++++++++-- 1 file changed, 75 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index 8cfd23d..d570959 100644 --- a/README.md +++ b/README.md @@ -1,3 +1,76 @@ -# launcher +# ZernMC Launcher -мяу \ No newline at end of file +## Что это? +**ZernMC Launcher** - Это Minecraft ланучер, написанный на Java(клиент) и Python(FastAPI - сервер) + +## Основные особенности +- он написан с 0 +- способен удобно загружать и обновлять сборки(загруженнве с сервера ZernMC) +- имеет ± удобный для чтения код лаунчера и сервера +- позволяет при плохом подключении к какому либо сервису(условно Fabric Maven) использовать сервер(!) как прокси, для установки необходимых данных +- клиент можно запустить даже если нет визуальной оболочки(но тут оговорка: вы не сможете запустить майнкрафт тогда(клиентскую часть)) +- не имеет реуламы +- не имеет сторонних сервисов для телеметрии(слежки) +- вообще не собирает никаких данных о вас +- работает из коробки, достаточно скачать zip архив(он для Windows) и запустить лаунчер, посде чего ≈75% версий можно будет запусиить сразу + +## чего пока в нём нет пока что +- нормальных настроек, сейчас можно только настроить Java и оперативку +- аккаунтов для безопасности(да, это не решает проблему с Offline режимом, но для своих серверов - да это будет решать пробоему) +- запуска Forge версий(science v.1.0.0-?) +- запуска/загрузки: Quilt, LabyMod, NeoForge и других старых лоадеров... +- просмотра новостей об обновах майнкрафта/лаунчера +- выбор параметров оптимизации из списка параметров + +## что надо доработать +- генерацию команды запуска +- авто-обновления лаунчера(они криво работают) +- настройки +- серверную часть что бы она была более стабильной +- прокси режим +- вообще загрузку файлов с сервера + +## ВАЖНЫЙ КРАТКИЙ ЭКСКУРС ПО ЛАУНЧЕРУ +1. он в TUI интерфейсе, а это значит - он не поддерживает управление курсором +2. управление осуществляется W/S(Ц/Ы) (замена ↑/↓ т.к они почему то (science 1.0.0+) тебя переносят на меню ранее а потом вообще крашит), ESC - выход из этого меню(либо "Назад" выбор) ENTER - Выбор в меню +3. если вы всё же умудрились нажать курсором в лаунчере - поздравляю, вы его заморозили, что бы разморозить достаточно нажать любую клавишу на клавиатуре, находясь в окне лаунчера +5. тут нет 4 пункта +6. иногда лаунчер может не удалять сборки корректно, из-за чего они могут оставаться в меню выбора, я позже это пофикшу, но надо удалить в instances то что не удалидось корректо +6.1. как мне найти instances? - он находится в Win: (ваш юзер)/.zernmc/instances Unix: ~/.zernmc/instances + +## как вообще его загрузить? +пока я не настроил GitHub Actions для релизов - https://api.zernmc.ru/launcher/download/latest либо https://api.zernmc.online/launcher/download/latest + +Скачанный архив распаковать в удобную для вас папку + +запустить ZernMCLauncher.exe + +(когда я добавлю аккаунты - зарегаться/залогинится) + +жмём "Начать игру" + +Если нет сборки(хахах, посмотрите на него, у него нет сборки "плак плак") жмём "Установить новую сборку" Далее следуем меню: елси вам надо сборку с ZernMC(позже пофикшу что бы можно было скачать только тем у кого есть проходка) то жмём это, иначе если вам нужен чистый лоадер - вариант с модовыми загрузчиками, а ежели вам надо абсолютно чистую моджанговскую версию - выбираем ваниллу + +в варианте с ZernMC ещё предложит укзаать название папки, лучше всего - использовать то как и называется сборка(Enter просто) НАСТОЯТЕЛЬНО РЕКОМЕНДУЕТСЯ НЕ ИСПОЛЬЗОВАТЬ КИРИЛИЦУ В НАЗВАНИИ +в других вариантах примерно тоже самое, и Я ТАК ЖЕ НАСТОЯТЕЛЬНО РЕКОМЕНДУЮ НЕ ИСПОЛЬЗОВАТЬ КИРИЛИЦУ В НАЗВАНИИ СБОРКИ + +## Возможные проблемы +- подключение к разным сервисам: в идеальном случае если нет коннекта условно к Fabric Maven то это пожключение будет просто проксировано через ZernMC сервер, но иногда и к нему нет доступа... тут уже я не могу помочь, только могу попытаться +- запуск сборки: елси она у вас Forge(science 1.0.0+) то не советую её запускать пока не будет исправлена генерация команды для Forge лоадера, иначе issues и я посмотрю что не так +- "я запустил чистую версию а почти никаких ассетов не загрузилось это че такое?" - Поясняю, я ещё не полностью но доделал генерацию команды запуска, и ИНОГДА оно может брать версию майнкрафта как AssetIndex из-за чего оно не загружает ассеты, пример: версия 1.20.1, ц него ассет индекс 5, при запуске оно может в некоторых случаях брать не 5.json а 1.20.1.json +- - самый простой способ починить AssetIndex - посмотреть логи какой оно пытается взять json для ассетов, скопировать существующий в instances/(название сборки)/assets/indexes/(индекс).json в эту же папку но под названием (то что пытается взять лаунчер).json + +## Issue +- так как лауняер не очищает экран как надо, логи это буквально скролл вверх +- копируйте всё что связано с ошибкой и что вы делали +- отправляете то в issue указав версию лаунчера + +## Билд/Development +### Это часть очень важна для тех кто будет разрабатывать вместе со мной лаунчер +1. git clone https://github.com/SashegDev/launcher +2. заходите в launcher/launcher/pom.xml +3. редактируете пути для билда, так как сейчас - он расчитан на разработку только на моём сервере +4. mvn clean package +5. можете начинать! + +Я был бы рад если нашлись люди кто мог бы помочь в разработке лаунчера и добавления к нему хотя бы базового UI чтоб было намногл удобнее работать с ним