init

map-editor/QUICKSTART.md

@@ -0,0 +1,71 @@
+# 🚀 Быстрый старт - Редактор карт
+
+## За 2 минуты
+
+### 1️⃣ Открыть редактор
+```bash
+./open-editor.sh
+```
+или просто откройте `index.html` в браузере
+
+### 2️⃣ Создать карту
+1. Установите размеры (например, 15×15)
+2. Выберите тип ячейки из палитры
+3. Рисуйте мышью на карте
+4. Обязательно добавьте точку **Старта** (зелёная, код 5)
+
+### 3️⃣ Сохранить карту
+- Нажмите "📥 Экспорт JSON"
+- Файл скачается автоматически
+
+### 4️⃣ Визуализировать решение (опционально)
+1. Нажмите "📂 Загрузить решение"
+2. Выберите файл с решением (например, `example-solution.json`)
+3. Нажмите ▶ Play
+4. Наслаждайтесь анимацией!
+
+## 🎨 Типы ячеек
+
+| Кнопка | Код | Описание |
+|--------|-----|----------|
+| Дорога | 0 | Обычная дорога (серая) |
+| Камень | 1 | Препятствие (тёмно-серая) |
+| Снег | 2 | Замедление (голубая) |
+| Лёд | 3 | Скользко (светло-голубая) |
+| Чекпоинт | 4 | Контрольная точка (жёлтая, "C") |
+| **Старт** | **5** | **Точка старта (зелёная, "S")** |
+
+## 🎮 Управление визуализацией
+
+| Кнопка | Действие |
+|--------|----------|
+| ▶ Play | Автоматическое воспроизведение |
+| ⏸ Pause | Пауза |
+| ⏮ Reset | Сброс к началу |
+| ⏭ Step | Один шаг вперёд |
+| Slider | Скорость (1x - 10x) |
+
+## 📄 Формат решения
+
+```json
+{
+  "solution": [
+    [1, 0],   // вправо
+    [1, 1],   // вправо-вниз
+    [0, 1],   // вниз
+    [-1, 0],  // торможение по X
+    [0, -1]   // вверх
+  ]
+}
+```
+
+## 💡 Советы
+- Удерживайте мышь для быстрого рисования
+- Используйте Step для детального анализа
+- Начните с примеров: `demo-with-start.json` + `example-solution.json`
+
+---
+
+📖 Полная документация: [README.md](README.md)
+
+