> 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/bazovaya-informaciya-o-resursakh-v-gem-rts/obshaya-informaciya-o-konfiguracionnykh-failakh/instrukciya-include.md).

# Инструкция include

Содержимое SDL-файла можно для удобства разбивать на тематические файлы.\
Также можно выносить общие фрагменты описания компонент и настроек в отдельные файлы.\
Для таких файлов используются расширения **.inc или .ext**

Содержимое таких файлов можно вызывать в нужном месте с помощью инструкции **include** с указанием имени файла в двойных кавычках.\
Если файл находится не в той же папке, что и собираемый SDL, то указывается путь к файлу от корневой папки пакета[^1].

> **Формат вызова инструкции include**
>
> ```
> (include "[path]\filename" [args])
> ```
>
> *\[path] - путь к файлу, опционально*
>
> *filename - имя файла*
>
> *\[args] - аргументы, опционально*

<details>

<summary>Пример вызова инструкции include в файле human.set</summary>

```
;SDL
(include "human_grenade_throw_type.inc")
(include "human_lie.inc")
(include "human_swim.inc")
(include "human_snipe.inc")
(include "human_squat.inc")
(include "human_bazooka.inc")
(include "human_inventory.inc")
(include "human_look.inc")
(include "human_stand.inc")
(include "human_idle.inc")
(include "human_idle_temp.inc")
(include "human_hands.inc")
(include "human_death.inc")
```

*Содержимое файла human.set собирается из нескольких SDL-файлов, которые располагаются в той же папке, что и файл human.set*

</details>

При вызове инструкции **include** можно передавать значения аргументов[^2]

<details>

<summary>Пример вызова инструкции include с аргументами</summary>

```
(include "shadow/stone.inc" sx(1) sy(3))
```

</details>

Другие примеры использования инструкции **include** приведены в таблице.

<table><thead><tr><th width="237">Название файла</th><th>Описание</th></tr></thead><tbody><tr><td>human_death.inc</td><td>В целях удобства в указанный файл вынесено описание выбора анимаций смерти для юнита типа <strong>human.</strong> Содержимое файла human_death.inc включается с помощью инструкции include в файл human.set</td></tr><tr><td>vehicle.ext</td><td><p>В файл вынесены общие свойства для юнитов типа <strong>vehicle.</strong> Содержимое данного файла вызывают с помощью инструкции <strong>include</strong> в файлах с описанием свойств юнитов, являющихся подвидом vehicle:</p><ul><li>car;</li><li>moto;</li><li>airborne;</li><li>marine;</li><li>...</li></ul></td></tr><tr><td>presets_vehicles.inc</td><td>В файл вынесены настройки пресетов юнитов типа <strong>vehicle</strong>. Содержимое этого файла вызывается с помощью Инструкции <strong>include</strong> во всех файлах, содержащих описание режимов игры, в которых используются описанные в resets_vehicles.inc пресеты юнитов</td></tr></tbody></table>

{% hint style="info" %}
Если у вас возникли сложности с пониманием терминологии и сути описания инструкции, то ознакомьтесь с информацией из статьи [Общая информация о конфигурационных файлах](https://bestway-1.gitbook.io/dokumentaciya/nastroiki-igrovykh-parametrov/obshaya-informaciya-o-konfiguracionnykh-failakh)
{% endhint %}

**Дополнительно можно ознакомиться с другими видами Инструкций**

<table data-card-size="large" data-view="cards"><thead><tr><th data-card-target data-type="content-ref"></th><th data-hidden></th><th data-hidden></th><th data-hidden></th><th data-hidden data-card-cover data-type="files"></th></tr></thead><tbody><tr><td><a href="/gem-rts-v1-ru/bazovaya-informaciya-o-resursakh-v-gem-rts/obshaya-informaciya-o-konfiguracionnykh-failakh/instrukciya-define.md">Инструкция define</a></td><td>Текст</td><td></td><td></td><td><a href="https://2052154247-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fx2fkAZ6oKGGdByFhKPpa%2Fuploads%2FrCk1dAvSKKe04Fp9WkP4%2Fsplash_editor_3.jpg?alt=media&amp;token=a89d5e03-56d3-401d-b04b-8da366458bd9">cover picture default</a></td></tr><tr><td><a href="/gem-rts-v1-ru/bazovaya-informaciya-o-resursakh-v-gem-rts/obshaya-informaciya-o-konfiguracionnykh-failakh/instrukciya-mod.md">Инструкция mod</a></td><td>Текст</td><td></td><td></td><td><a href="https://2052154247-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fx2fkAZ6oKGGdByFhKPpa%2Fuploads%2FrCk1dAvSKKe04Fp9WkP4%2Fsplash_editor_3.jpg?alt=media&amp;token=a89d5e03-56d3-401d-b04b-8da366458bd9">cover picture default</a></td></tr></tbody></table>

[^1]: [Пакеты](/gem-rts-v1-ru/bazovaya-informaciya-o-resursakh-v-gem-rts/arkhitektura-resursov-igry/pakety.md#obshie-svedeniya) - папки с ресурсами тематических компонент игры или модов.\
    Находятся в папке packages/

[^2]: [Аргументы](/gem-rts-v1-ru/bazovaya-informaciya-o-resursakh-v-gem-rts/obshaya-informaciya-o-konfiguracionnykh-failakh.md#argumenty) используются для вызова одной и той же инструкции, но с разными значениями параметров. При описании инструкции признаком аргумента является символ процент **%.**

    \
    \\