# Создание новой карты

## Карта. Общая информация

**Карта** - это игровой уровень, который обычно не содержит сценарной логики (скриптов). Содержит ландшафтную поверхность, объекты карты (деревья, заборы, дома и т.д.), звуковые и визуальные эффекты. 

Инструментом создания и модификации карты является [редактор карт](#user-content-fn-1)[^1].

{% hint style="info" %}
Ландшафтная поверхность представляет собой меш, состоящий из полигонов - треугольников. Форма и размер полигонов влияют на способ наложения текстур и, в итоге, на качество визуальной проработки поверхности земли. 
{% endhint %}

{% hint style="info" %}
Чем менше размер полигона, тем плавнее и качественнее будут переходы между текстурами. \
В тоже время малый размер полигонов приведет к значительному увеличению их количества, что негативно скажется на производительности игры (fps)
{% endhint %}

## Создание новой карты

**Порядок действий**

1. Вызвать [главное меню редактора карт](#user-content-fn-2)[^2]
2. Выбрать пункт меню **New**
3. Подтвердить намерение, нажав кнопку **Yes**.

<figure><img src="/files/IlSmt2exb0rCZzh7T1c1" alt=""><figcaption><p>Предупреждение при нажатии кнопки New</p></figcaption></figure>

### Окно настройки базовых параметров карты

<figure><img src="/files/gyF7efVuHbg1LFaTwIFr" alt=""><figcaption><p>Окно базовых параметров при создании новой карты</p></figcaption></figure>

<table><thead><tr><th width="173">Параметр</th><th width="277">Описание</th><th>Примечание</th></tr></thead><tbody><tr><td>polygon</td><td>Блок параметров полигонов меша поверхности земли</td><td>.<br><br></td></tr><tr><td>polygon/<strong>triangle</strong></td><td><p>Вид полигона:</p><ul><li>90 - прямоугольный</li><li>60 - равносторонний</li></ul></td><td>Рекомендуемый вид полигона - прямоугольный.<br>Вид полигона влияет на качество смешивания текстур по линиям переходов</td></tr><tr><td>polygon/<strong>side</strong></td><td>Размер стороны полигона</td><td>Рекомендуемый размер выставлен по умолчанию.<br>Размер полигона влияет на детализацию прорисовки поверхносности земли текстурами и цветами. <br></td></tr><tr><td>texture</td><td>Блок параметров базового материала</td><td></td></tr><tr><td>texture/<strong>size</strong></td><td>Размер тайла базовой текстуры</td><td>Влияет на среднюю плотность текстуры</td></tr><tr><td>texture/<strong>bitmap</strong></td><td>Название базовой текстуры</td><td>Выбирается из доступных в списке. <br>При создании новой карты можно оставить в качестве базовой текстуры разметку (grid001)</td></tr><tr><td>terrain</td><td>Базовый тип территории</td><td>По умолчанию ground, менять не рекомендуется</td></tr><tr><td>mapSize</td><td>Размер карты в условных единицах длины</td><td>Рекомендуемый размер 600х600</td></tr></tbody></table>

После установки базовых параметров поверхности карты нажать кнопку "Ок" - редактор создаст ровный, однородно окрашенный меш поверхности земли с заданными параметрами. Заготовка для карты создана.

Следующим шагом необходимо сохранить карту под нужным именем. \
Процесс первого сохранения карты автоматически создаст папку для ее файлов.

### Правила именования карт

Имя карты может содержать:

* буквы латинского алфавита;
* арабские цифры;
* знаки дефис и нижнее подчеркивание.

{% hint style="warning" %}
Движок Gem RTS не учитывает регистр ввода в именах карт
{% endhint %}

### Сохранение карты

**Порядок действий**

1. Вызвать [главное меню редактора карт](#user-content-fn-2)[^2]
2. Нажать кнопку "Сохранить как" (Save as)

<figure><img src="/files/zRUdk6vHAMhFMhxfpENS" alt=""><figcaption><p>Окно главного меню редактора карт</p></figcaption></figure>

3. Ввести имя карты в поле File:  и нажать кнопку Ok

<figure><img src="/files/4E6SzbWYAklGsWMnf0DU" alt=""><figcaption><p>Название новой карты в поле File окна Save as</p></figcaption></figure>

{% hint style="info" %}
Знак слеша "/" в имени карты автоматически создает дополнительную промежуточную папку (если ее не существует) и задает путь сохранения файлов карты.\
Например, если ввести в качестве имени "multi/first\_map", то редактор сохранит карту в папку map\multi\first\_map
{% endhint %}

{% hint style="warning" %}
Можно сохранить карту под уже существующим именем, выбрав нужное имя из списка. \
Перед сохранением редактор выдаст предупреждение о перезаписи карты. \
После сохранения восстановить исходную карту будет невозможно.
{% endhint %}

### Файлы карты

После первого сохранения карты редактор создаст именную папку с тремя главными файлами карты.

<table><thead><tr><th width="180">Название файла</th><th width="567">Назначение</th></tr></thead><tbody><tr><td>map</td><td>Файл с данными о расположении объектов на карте и свойствами объектов</td></tr><tr><td>map.ply</td><td>Модель поверхности земли карты</td></tr><tr><td>map.net</td><td>Карта высот.<br>Используется игровым движком для вычислений целого ряда игровых компонент и параметров игры.</td></tr></tbody></table>

Новая карта готова к созданию игрового уровня и сценария.

[^1]: При запуске редактора пользователь по умолчанию попадает в редактор карт и может вернуться в него из других редакторов по нажатию функциональной клавиши **F2** на клавиатуре.

[^2]: Окно главного меню (**Map editor menu)** можно вызвать двумя способами:

    * по нажатию на кнопку Map: \<name> в шапке рабочей панели редактора карт
    * по нажатию клавиши Esc на клавиатуре


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://bestway-1.gitbook.io/documentation/gem-rts-v1-ru/redaktor/redaktor-kart/sozdanie-novoi-karty.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.