Documentation
Русский
  • Gem RTS v1 Documentation
  • Foundational Knowledge
    • Game local files and Player Profile locations
    • Game resource architecture
      • Packages
      • Package file structure
    • Basic knowledge about configuration files
      • Include instruction
      • Define instruction
      • Mod instruction
  • Mod Development
    • Creating mod
    • Advanced package configuration
    • Creating Settings templates
  • Editor
    • Camera control in the Editor
    • Useful Editor shortcuts and Console commands
    • Map Editor
      • Creating a new map
      • Scene Editor
      • Entity Editor
      • Landscape Editor
        • Heights Editor
        • Polygons Editor
        • Terrains Editor
        • Color Editor
        • Flags Editor
        • Material Editor
        • Grass Editor
        • Foliage Editor
      • Water Editor
      • Specifics of Map Editing
        • Creating destroyed vehicle entities for map entourage
        • Creating terrain folds
          • Creating Ground Surface relief
          • Rock and cliff entities
        • Stone entities
        • Entity for water sound effects
        • Building entities
      • Creating a minimap
    • Mission Editor
      • Mission Properties Editor
    • FX Editor
    • Environment Editor
      • Basic knowledge about HDR
      • Creating environment preset
      • Setting Environment preset parameters
    • Debug Tools
      • Console
      • Debug Processes Window
      • Render Layer List Window
    • Simulation Mode
  • Textures and Materials
    • Physically Based Rendering
      • Texture compression formats in GEM RTS
      • PBR parameters
      • Texture Conversion in Gem RTS
      • Texture conversion to PBR materials using Nvidia Texture Exporter
  • Modeling
    • 3ds Max Plugin
    • Vehicle Model Setup Pipeline
      • Bone hierarchy in vehicle models
        • Body
        • Turret
        • Engine
        • Gun
        • Secondary bones
        • Transmission
          • Сhassis mechanisms
  • Localization
    • Variable strings in localization
    • Adding a new localization language
  • Game settings
    • Movement on slopes
    • Configuration of movement types for human units
    • Configuring entity interaction with wind
    • Sensor
    • User control sound
Powered by GitBook
On this page
  1. Foundational Knowledge
  2. Basic knowledge about configuration files

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

(include "[path]\filename" [args])

  • [path] - the file path, optional

  • filename - the file name

  • [args] - arguments, optional

Example of calling the include instruction
;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

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

Example

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

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

Filename
Description

human_death.inc

For convenience, this file contains the description of death animations for a human unit. The contents of human_death.inc are included in the human.set file using the include instruction.

vehicle.ext

This file contains common properties for vehicle type units. Its contents are called in files describing properties of units that are subtypes of vehicle: car, moto, airborne, marine, etc.

presets_vehicles.inc

This file contains settings for vehicle unit presets. The contents of this file are called using the include instruction in all files describing game modes that use the presets described in presets_vehicles.inc.

Additionally, you can explore other types of Instructions.

Last updated 1 year ago

If you have difficulties understanding the terminology and the essence of the instruction description, please refer to the article .

Basic knowledge about configuration files
Cover

Define Instruction

Define instruction
Cover

Mod Instruction

Mod instruction