> For the complete documentation index, see [llms.txt](https://docs.bestway.com.ua/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.bestway.com.ua/gem-rts-v1-ru/redaktor/redaktor-kart/sozdanie-novoi-karty.md).

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

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

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

Инструментом создания и модификации карты является [редактор карт](#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="https://2052154247-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fx2fkAZ6oKGGdByFhKPpa%2Fuploads%2FKDQ39I9wsNQGQ1vCd7QC%2FCreate_new_map.png?alt=media&amp;token=fdcd96c0-7c73-4df5-af64-6ee4302e37c4" alt=""><figcaption><p>Предупреждение при нажатии кнопки New</p></figcaption></figure>

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

<figure><img src="https://2052154247-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fx2fkAZ6oKGGdByFhKPpa%2Fuploads%2FN43deYqYSbuSSJGrFv9o%2F1_1%20%D0%BA%D0%BE%D0%BF%D0%B8%D1%8F.jpg?alt=media&amp;token=5fee2f1a-3696-4bf3-8d95-f1e1f5f1aaf1" 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="https://2052154247-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fx2fkAZ6oKGGdByFhKPpa%2Fuploads%2FYjhOKI848IhnYRE1CUqJ%2F%D0%A1%D0%BD%D0%B8%D0%BC%D0%BE%D0%BA%20%D1%8D%D0%BA%D1%80%D0%B0%D0%BD%D0%B0%202024-04-25%20%D0%B2%2018.31.37.png?alt=media&amp;token=b24a7e9f-65e3-4040-bfe8-364bca9f1cd9" alt=""><figcaption><p>Окно главного меню редактора карт</p></figcaption></figure>

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

<figure><img src="https://2052154247-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fx2fkAZ6oKGGdByFhKPpa%2Fuploads%2FhISsOADiq4aJaJqEkci7%2F7_1%20%D0%BA%D0%BE%D0%BF%D0%B8%D1%8F.jpg?alt=media&amp;token=8c030623-2830-45b8-8a7b-34a829be691b" 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 на клавиатуре