120 lines
4.1 KiB
Markdown
120 lines
4.1 KiB
Markdown
# 📑 Индекс файлов редактора карт
|
||
|
||
## 📚 Документация
|
||
|
||
| Файл | Описание |
|
||
|------|----------|
|
||
| **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
|
||
|
||
|