docs: add README with game description and mechanics

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

Author: samvelkoch

README.md

@@ -0,0 +1,114 @@
+# Подземелья Чёрного замка — Android-приложение
+
+Мобильная книга-игра по мотивам произведения **Дмитрия Юрьевича Браславского**
+(серия «Хроники Элгариола», книга 1).
+
+> Проект создан с глубоким уважением к автору оригинала.
+> Все права на литературное произведение принадлежат Д. Ю. Браславскому.
+> Данное приложение является некоммерческим фанатским проектом.
+
+---
+
+## О книге-игре
+
+«Подземелья Чёрного замка» — классическая книга-игра в жанре «выбери своё приключение».
+1228 параграфов, сотни развилок, множество концовок.
+Вы исследуете подземелья, сражаетесь с монстрами, решаете загадки и ищете выход
+из замка — каждый раз неповторимым путём.
+
+---
+
+## Механика игры
+
+### Персонаж
+
+При создании персонажа случайно (кубики d6) определяются три характеристики:
+
+| Характеристика | Формула    | Описание                              |
+|----------------|------------|---------------------------------------|
+| **Мастерство** | d6 + 6     | Боевые навыки (7–12)                  |
+| **Выносливость** | 2d6 + 12 | Очки здоровья (14–24)                 |
+| **Удача**      | d6 + 6     | Шанс на удачный бросок (7–12)         |
+
+Также выдаётся **15 золотых** и набор начальных заклинаний.
+
+### Бой
+
+Каждый раунд боя:
+1. Игрок и враг бросают **2d6**, добавляют своё **Мастерство**
+2. Кто набрал больше — наносит **2 единицы урона** сопернику
+3. При равенстве — раунд ничейный, никто не получает урона
+
+Когда **Выносливость** противника достигает 0 — он побеждён.
+Когда **Выносливость** игрока достигает 0 — игра окончена.
+
+### Удача
+
+В ключевые моменты можно **испытать Удачу**: бросок 2d6 ≤ текущей Удаче = успех.
+Каждое использование уменьшает Удачу на 1.
+
+В бою удачный бросок даёт дополнительный урон врагу или снижает урон себе.
+
+### Заклинания
+
+Заклинания применяются в бою и на развилках:
+
+| Заклинание    | Эффект                                   |
+|---------------|------------------------------------------|
+| Исцеления     | +8 Выносливости (не во время боя)        |
+| Силы          | +2 Мастерства на один раунд боя          |
+| Слабости      | −2 Мастерства врагу на один раунд        |
+| Огня          | Наносит 2 урона врагу мгновенно          |
+| Иллюзии       | Уйти из боя без потерь                   |
+| Левитации     | Перелететь преграду по воздуху           |
+| Плавания      | Переплыть водную преграду                |
+
+Каждое заклинание имеет ограниченное число зарядов.
+
+### Карта
+
+В приложении доступна **интерактивная карта** связей между параграфами с туманом войны —
+посещённые параграфы открываются, неизвестные остаются скрытыми.
+
+---
+
+## Скриншоты
+
+*(скоро)*
+
+---
+
+## Технологии
+
+- Python 3 + [Kivy 2.3](https://kivy.org/) + [KivyMD 1.2](https://kivymd.readthedocs.io/)
+- Сборка APK: [Buildozer](https://buildozer.readthedocs.io/) + GitHub Actions (Ubuntu)
+- Целевая платформа: Android 7.0+ (API 24+), arm64-v8a / armeabi-v7a
+
+---
+
+## Установка
+
+Скачайте последний APK из раздела [Actions → Artifacts](../../actions) и установите на Android-устройство.
+
+> Для установки из неизвестных источников: Настройки → Безопасность → Разрешить установку из неизвестных источников.
+
+---
+
+## Разработка
+
+```bash
+# Запуск на рабочем столе
+cd android_app
+pip install kivy kivymd
+python main.py
+
+# Сборка APK (через GitHub Actions — push в feature/material-design)
+```
+
+---
+
+## Лицензия и права
+
+Литературное произведение © Дмитрий Юрьевич Браславский.
+Код приложения: MIT License.
+Некоммерческий фанатский проект — не для продажи.