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

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

| Файл | Описание |
|------|----------|
| **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)
```json
{
  "map": [[0, 1, 2], [3, 4, 5]]
}
```

### Решение (solution)
```json
{
  "solution": [[1, 0], [0, 1], [-1, 0]]
}
```

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

- [Основной README проекта](../README.md)
- [Документация BFS алгоритма](../README.md)
- [Документация A* алгоритма](../ASTAR-README.md)

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

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

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

---

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