> 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/foundational-knowledge/basic-knowledge-about-configuration-files/include-instruction.md).

# Include instruction

The content of an SDL file can conveniently be divided into thematic files.\
It's also possible to extract common fragments of component descriptions and settings into separate files.\
Such files use the **.inc** or **.ext** extensions.

The content of these files can be invoked at the required location using the `include` instruction with the filename enclosed in double quotes.\
If the file is not in the same folder as the SDL being assembled, then the path from the root folder of the package should be specified.

> **Template for calling the `include` instruction**
>
> ```plaintext
> (include "[path]\filename" [args])
> ```
>
> * `[path]` - the file path, optional
> * `filename` - the file name
> * `[args]` - arguments, optional

<details>

<summary>Example of <strong>calling the <code>include</code> instruction</strong></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")
```

*The content of the `human.set` file is assembled from several SDL files that are located in the same folder as the `human.set` file*

</details>

When calling the `include` instruction, you can pass argument values.

<details>

<summary>Example</summary>

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

</details>

Other examples of using the `include` instruction are provided in the table below.

<table><thead><tr><th width="198">Filename</th><th>Description</th></tr></thead><tbody><tr><td>human_death.inc</td><td>For convenience, this file contains the description of death animations for a human unit.<br>The contents of <code>human_death.inc</code> are included in the <code>human.set</code> file using the <code>include</code> instruction.</td></tr><tr><td>vehicle.ext</td><td>This file contains common properties for vehicle type units.<br>Its contents are called in files describing properties of units that are subtypes of vehicle: car, moto, airborne, marine, etc.</td></tr><tr><td>presets_vehicles.inc</td><td>This file contains settings for vehicle unit presets.<br>The contents of this file are called using the <code>include</code> instruction in all files describing game modes that use the presets described in <code>presets_vehicles.inc</code>.</td></tr></tbody></table>

{% hint style="info" %}
If you have difficulties understanding the terminology and the essence of the instruction description, please refer to the article [**Basic knowledge about configuration files**](/foundational-knowledge/basic-knowledge-about-configuration-files.md).
{% endhint %}

Additionally, you can explore other types of Instructions.

<table data-view="cards"><thead><tr><th></th><th></th><th></th><th data-type="content-ref"></th><th data-hidden data-card-cover data-type="files"></th></tr></thead><tbody><tr><td>Define Instruction</td><td></td><td></td><td><a href="/foundational-knowledge/basic-knowledge-about-configuration-files/define-instruction.md">Define instruction</a></td><td><a href="https://2358506489-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2UV9d5d9aTZPISbocWyo%2Fuploads%2FXqe0ZKqSICsAK0XgCyMC%2Fsplash_editor_3.jpg?alt=media&amp;token=ecb5bb0d-d794-4925-a780-f7d98f315d42">default_cover.jpg</a></td></tr><tr><td>Mod Instruction</td><td></td><td></td><td><a href="/foundational-knowledge/basic-knowledge-about-configuration-files/mod-instruction.md">Mod instruction</a></td><td><a href="https://2358506489-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2UV9d5d9aTZPISbocWyo%2Fuploads%2FXqe0ZKqSICsAK0XgCyMC%2Fsplash_editor_3.jpg?alt=media&amp;token=ecb5bb0d-d794-4925-a780-f7d98f315d42">default_cover.jpg</a></td></tr></tbody></table>