diff --git a/README.md b/README.md
index 8cfd23d..9cdc293 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,123 @@
-# launcher
+# ZernMC Launcher
 
-мяу
\ No newline at end of file
+**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
+
+**Рекомендация:** Не используйте кириллицу в названии сборки!
+
+## Возможные проблемы и решения
+
+### Проблемы с загрузкой ассетов
+Иногда лаунчер неправильно определяет 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`
+отредактируете пути для билда, так как сейчас - он расчитан на разработку только на моём сервере
+`mvn clean package`
+можете начинать!
+Я был бы рад если нашлись люди кто мог бы помочь в разработке лаунчера и добавления к нему хотя бы базового UI чтоб было намногл удобнее работать с ним
+
+
+
+Буду рад помощи в разработке!
+Особенно приветствуется помощь с:
+
+- Переходом на нормальный графический интерфейс (GUI)
+- Улучшением генерации команды запуска
+- Добавлением поддержки Forge / NeoForge / Quilt
+- Стабилизацией серверной части
+- вообще улучшением клиента