paper-racing-gpi/map-editor/QUICKSTART.md

🚀 Быстрый старт - Редактор карт

За 2 минуты

1️⃣ Открыть редактор

./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)

📄 Формат решения

{
  "solution": [
    [1, 0],   // вправо
    [1, 1],   // вправо-вниз
    [0, 1],   // вниз
    [-1, 0],  // торможение по X
    [0, -1]   // вверх
  ]
}

💡 Советы

• Удерживайте мышь для быстрого рисования
• Используйте Step для детального анализа
• Начните с примеров: demo-with-start.json + example-solution.json

---

📖 Полная документация: README.md