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

📑 Индекс файлов редактора карт

📚 Документация

Файл	Описание
README.md	Полная документация с инструкциями
QUICKSTART.md	Быстрый старт за 2 минуты
FEATURES.md	Подробное описание всех возможностей
INDEX.md	Этот файл - навигация по проекту

🎯 Основные файлы

Файл	Тип	Описание
index.html	HTML	Главная страница редактора
editor.js	JS	Логика редактора и визуализации
open-editor.sh	Shell	Скрипт для быстрого запуска

🗺️ Примеры карт

Файл	Размер	Описание
simple-track.json	10×10	Простая трасса для начинающих
demo-with-start.json	15×15	Демонстрационная карта с препятствиями
example-maps.json	Разные	Коллекция из 5 различных карт

Содержимое example-maps.json:

1. Simple Track (10×10) - простая трасса
2. Ice Circuit (10×10) - карта с ледяными участками
3. Obstacle Course (15×15) - сложная карта с препятствиями
4. Minimal (5×5) - минимальная карта для тестирования
5. Empty Large (20×20) - пустая карта для создания

🎬 Примеры решений

Файл	Шагов	Сложность	Рекомендуется для
example-solution.json	10	Простая	simple-track.json
complex-solution.json	20	Сложная	Любой карты
demo-solution.json	15	Средняя	demo-with-start.json

🚀 Быстрый старт

Вариант 1: Просмотр примера

1. Откройте index.html
2. Импортируйте demo-with-start.json
3. Загрузите решение demo-solution.json
4. Нажмите ▶ Play

Вариант 2: Создание своей карты

1. Откройте index.html
2. Создайте карту с помощью инструментов
3. Экспортируйте в JSON
4. Используйте в игре

📖 Рекомендуемый порядок чтения

Для новичков:

1. 📄 QUICKSTART.md - начните здесь
2. 🎮 Поэкспериментируйте с редактором
3. 📚 README.md - полная документация
4. 🎯 FEATURES.md - подробности

Для опытных:

1. 📚 README.md - вся информация сразу
2. 🎯 FEATURES.md - технические детали

🎨 Типы ячеек

Код	Тип	Цвет	Маркер
0	Дорога	Светло-серый	-
1	Камень	Тёмно-серый	-
2	Снег	Голубой	-
3	Лёд	Светло-голубой	-
4	Чекпоинт	Жёлтый	C
5	Старт	Зелёный	S

📦 Форматы файлов

Карта (map)

{
  "map": [[0, 1, 2], [3, 4, 5]]
}

Решение (solution)

{
  "solution": [[1, 0], [0, 1], [-1, 0]]
}

🔗 Полезные ссылки

• Основной README проекта
• Документация BFS алгоритма
• Документация A* алгоритма

💡 Быстрые команды

# Открыть редактор
./open-editor.sh

# Или напрямую в браузере
firefox index.html
chrome index.html

---

Создано: 2025-10-19
Версия: 2.0 (с визуализацией решений)
Технологии: HTML5, CSS3, JavaScript ES6+, Canvas API