UFOpaedia - User contributions [en]

Ruleset Reference (OpenXcom)

2015-02-07T13:15:35Z

Falko: Undo revision 62925 by Falko ups my mistake still relevant for 1.0

A reference of all the customizable values of everything in a [[Rulesets (OpenXcom)|ruleset]] for the current stable version (1.0) of OpenXcom. For the current nightly versions (with the advanced features currently in development) check [[Ruleset Reference Nightly (OpenXcom)|Ruleset Reference Nightly]].

Some guidelines:
* If a value is omitted from the ruleset, the default is used. You cannot omit ''required'' values.
* Text strings (eg. names) are represented by string IDs from the [[Translations (OpenXcom)|language files]]
* Numerical IDs (used for sprites, sounds, etc.) start at 0, not 1.
* Boolean (yes/no) values are represented by true/false.
* World coordinates are represented in degrees (see [[WORLD.DAT]]).
* Money amounts (prices, costs, etc.) are represented in dollars.
* All paths are '''case sensitive'''! If your ruleset uses external files, make sure that they named properly as described in ruleset.

Items are ordered as they come in the ruleset. To override this, you can specify a ''listOrder''. You can find the default listOrders in [[Ruleset List Order (OpenXcom)|Ruleset List Order]].

=== Countries ===

Defines one of the [[Country Funding (EU)|funding nations]], listed in ''"countries:"''. They're used for activity graphs and player scoring.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the country name.
| ''required''
|-
| '''fundingBase'''
| Country's base funding, in thousands. The starting funding can be anywhere between 1x and 2x the base funding.
| 0
|-
| '''fundingCap'''
| Country's funding cap, in thousands. Once a country reaches this maximum, it will no longer increase its funding.
| 0
|-
| '''labelLon'''
'''labelLat'''
| Longitude and latitude coordinates of the country's label on the globe. This label is only shown when the globe is zoomed in and "detail" is turned on.
| 0.0
0.0
|-
| '''areas'''
| List of "rectangles" on the globe defined as [''lon1'' ''lat1'' ''lon2'' ''lat2'']. Any activity within these areas counts towards the country's graph activity and affects their opinion of the player.
| -
|}

=== Regions ===

Defines one of the [[Geoscape (EU)#World Regions/Countries|world regions]], listed in ''"regions:"''. They're used for base placement, activity graphs and mission spawning.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the region name.
| ''required''
|-
| '''cost'''
| Amount of money spent building an X-COM base in this region (first base is free).
| 0
|-
| '''areas'''
| List of "rectangles" on the globe defined as ''[lon1, lat1, lon2, lat2]''. Any activity within these areas counts towards the region's graph activity.
| -
|-
| '''cities'''
| List of cities belonging to this region. They will be displayed on the globe and used for terror site missions. Each city is defined by their '''lon''' and '''lat''' coordinates and a '''name''' string ID.
| -
|-
| '''regionWeight'''
| Weight of this region when selecting regions for alien missions.
| 0
|-
| '''missionWeights'''
| Weighted list of the different mission types for this region (eg. ''STR_ALIEN_RESEARCH: 14'').
| -
|-
| '''missionZones'''
| List of "rectangles" (''[lon1, lat1, lon2, lat2]'') defining the mission zones for this region. Mission zones are waypoints for UFO trajectories.
| -
|-
| '''missionRegion'''
| Spawn mission in this region instead (used for regions without land).
| -
|}

=== Base Facilities ===

Defines one of the [[Base Facilities (EU)|facilities]] that can be built in an X-COM base, listed in ''"facilities:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the facility name.
| ''required''
|-
| '''requires'''
| List of [[#Research|topics]] (string IDs) that must be researched to unlock this facility. If none are specified, this facility is unlocked from the start.
| -
|-
| '''spriteShape'''
| Sprite ID from [[BASEBITS.PCK]] used to draw the facility's outer shape in the Basescape and UFOpaedia.
| -1
|-
| '''spriteFacility'''
| Sprite ID from [[BASEBITS.PCK]] used to draw the facility's contents in the Basescape and UFOpaedia. Drawn on top of '''spriteShape'''.
| -1
|-
| '''lift'''
| Is this facility an [[Access Lift]]? All base facilities must be connected to the lift.
| false
|-
| '''hyper'''
| Is this facility a [[Hyperwave Decoder]]? Displays extra information for detected UFOs. Only valid for radar facilities.
| false
|-
| '''mind'''
| Is this facility a [[Mind Shield]]? Reduces the chance of UFOs finding your base. Does not stack.
| false
|-
| '''grav'''
| Is this facility a [[Grav Shield]]? Doubles the power of your base defenses. Does not stack.
| false
|-
| '''size'''
| Size of the facility, in grid units. Every facility is square, so a size of 1 means 1x1, 2 means 2x2, etc. Bigger facilities are made up of multiple sprites, for example a 2x2 facility will use 4 sprites for '''spriteShape''' and 4 sprites for '''spriteFacility''' (top-left, top-right, bottom-left, bottom-right).
| 1
|-
| '''buildCost'''
| Amount of money spent to build this facility in the base.
| 0
|-
| '''buildTime'''
| Amount of days it takes for this facility to be built.
| 0
|-
| '''monthlyCost'''
| Amount of money spent monthly for the maintenance of this facility.
| 0
|-
| '''storage'''
| Amount of storage space (for items) this facility provides. See [[Base Stores]].
| 0
|-
| '''personnel'''
| Amount of personnel (soldiers, scientsts, engineers) these quarters can contain.
| 0
|-
| '''aliens'''
| Amount of live aliens this facility can contain. Only checked if the ''alienContainmentLimitEnforced'' option is enabled.
| 0
|-
| '''crafts'''
| Amount of X-COM craft this facility can contain.
| 0
|-
| '''labs'''
| Amount of lab space this facility provides for research projects.
| 0
|-
| '''workshops'''
| Amount of workshop space this facility provides for manufacture projects.
| 0
|-
| '''psiLabs'''
| Amount of soldier space this facility provides for psionic training.
| 0
|-
| '''radarRange'''
| Maximum radar detection range of this facility, in nautical miles.
| 0
|-
| '''radarChance'''
| Chance (0-100%) of this radar detecting a UFO that enters its range.
| 0
|-
| '''defense'''
| Offensive power provided by this base defense against attacking UFOs.
| 0
|-
| '''hitRatio'''
| Chance (0-100) of the base defense hitting an attacking UFO.
| 0
|-
| '''fireSound'''
| Sound ID from [[#Extra_Sounds|GEO.CAT]] played when the base defense fires.
| -1
|-
| '''hitSound'''
| Sound ID from [[#Extra_Sounds|GEO.CAT]] played when the base defense hits a target.
| -1
|-
| '''mapName'''
| [[MAPS|Map]] associated to this facility in Battlescape base defenses.
| -
|-
|}

=== Crafts ===

Defines one of the [[Craft|X-COM crafts]] that go on interception missions, listed in ''"crafts:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the craft name.
| ''required''
|-
| '''requires'''
| List of [[#Research|topics]] (string IDs) that must be researched to unlock this craft. If none are specified, this craft is unlocked from the start.
| -
|-
| '''sprite'''
| Sprite ID from [[BASEBITS.PCK]] used to draw this craft in the Basescape and from [[INTICON.PCK]] used to draw the damage indicator in dogfights.
modders: the corresponding extrasprite file id for BASEBITS.PCK is sprite+33 INTICON.PCK contains a minimized icon id=sprite the file id for the dogfight image is sprite+11
| -1
|-
| '''fuelMax'''
| Maximum amount of fuel this craft can carry. Crafts use up fuel based on their speed while travelling.
| 0
|-
| '''damageMax'''
| Maximum amount of damage this craft can take. If this amount is exceeded, the craft is destroyed.
| 0
|-
| '''speedMax'''
| Maximum speed in nautical miles. Crafts travel at max speed when flying and half speed when patrolling.
| 0
|-
| '''accel'''
| Aceeleration value shown in the UFOpaedia.
| 0
|-
| '''weapons'''
| Amount of craft weapons this craft can equip. The UI can only display a max of 2 weapons.
| 0
|-
| '''soldiers'''
| Amount of soldiers this craft can carry.
| 0
|-
| '''maxItems'''
| Amount of items this craft can carry.
| 80
|-
| '''vehicles'''
| Amount of vehicles this craft can carry.
| 0
|-
| '''costBuy'''
| Amount of money spent for purchasing this craft. If set to 0, the craft will not be available in the Purchase/Recruit screen.
| 0
|-
| '''costRent'''
| Amount of money spent monthly for renting this craft. If set to 0, the craft is not on rental and won't count towards base maintenance.
| 0
|-
| '''costSell'''
| Amount of money gained for selling this craft.
| 0
|-
| '''refuelItem'''
| Item required for refuelling this craft. If no item is specified, the craft uses human fuel.
| 0
|-
| '''repairRate'''
| Amount of damage restored every hour while [[Repairs|Repairing]] in base.
| 1
|-
| '''refuelRate'''
| Amount of fuel restored every 30 mins while [[Refueling]] in base. If specified, a '''refuelItem''' is spent each time.
| 1
|-
| '''radarRange'''
| Detection range of the craft's radar in nautical miles. Every craft radar has a 100% detection chance.
| 600
|-
| '''transferTime'''
| Number of hours it takes to purchase/transfer this craft to a base.
| 0
|-
| '''score'''
| [[Score]] lost when this craft is destroyed.
| 0
|-
| '''spacecraft'''
| Can this craft go to [[Cydonia]]?
| false
|-
| '''battlescapeTerrainData'''
| [[#Terrains|Terrain]] associated to this craft in Battlescape missions.
| -
|-
| '''deployment'''
| Custom positions for the unit deployment in the craft, listed as: ''[x, y, z, facing]''
If not specified, units are placed on empty spots from top-left to bottom-right facing top-right.
| -
|}

=== Craft Weapons ===

Defines one of the [[Craft Armaments|weapons]] equipped by X-COM craft for shooting down UFOs, listed in ''"craftWeapons:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the weapon name.
| ''required''
|-
| '''sprite'''
| Sprite ID from [[BASEBITS.PCK]] used to draw the weapon in the Basescape and from [[INTICON.PCK]] used to draw the weapon in dogfights.
modders: the corresponding extrasprites file id for INTICON.PCK is sprite+5 and sprite+48 for BASEBITS.PCK
| -1
|-
| '''sound'''
| Sound ID from [[#Extra_Sounds|GEO.CAT]] played when this weapon fires.
| -1
|-
| '''damage'''
| Amount of damage this weapon does to enemy UFOs.
| 0
|-
| '''range'''
| Maximum range of this weapon in dogfights (in meters).
| 0
|-
| '''accuracy'''
| Chance (0-100%) of each shot hitting the enemy UFO.
| 0
|-
| '''reloadCautious'''
| Time this weapon takes to fire between each shot in ''Cautious Mode''.
| 0
|-
| '''reloadStandard'''
| Time this weapon takes to fire between each shot in ''Standard Mode''.
| 0
|-
| '''reloadAggressive'''
| Time this weapon takes to fire between each shot in ''Aggressive Mode''.
| 0
|-
| '''ammoMax'''
| Maximum amount of ammo this weapon can carry.
| 0
|-
| '''rearmRate'''
| Amount of ammo restored every 30 mins while the craft is [[Rearming]] in base. If specified, '''clip'''s are spent depending on their '''clipSize'''. If the '''clipSize''' of the specified ammo is 0, no '''clip'''s are spent.
| 1
|-
| '''projectileType'''
| Type of the weapon projectile, used for the projectile sprite in dogfights:
* 0 - [[Stingray]]
* 1 - [[Avalanche]]
* 2 - [[Cannon]]
* 3 - [[Fusion Ball]]
* 4 - [[Laser Cannon]]
* 5 - [[Plasma Beam]]
| 2
|-
| '''projectileSpeed'''
| Speed of the weapon projectile in dogfights.
| 0
|-
| '''launcher'''
| String ID of the [[#Items|item]] required to equip this weapon.
| -
|-
| '''clip'''
| String ID of the [[#Items|item]] required to rearm this weapon.
| -
|}

=== Items ===

Defines the Geoscape and Battlescape properties of an [[Equipment (EU)|item]] that can be stored in X-COM bases, listed in ''"items:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the internal item name.
| ''required''
|-
| '''name'''
| String ID of the displayed item name, for cases where it's different from the internal name. If omitted, '''type''' is used.
| -
|-
| '''requires'''
| List of [[#Research|topics]] (string IDs) that must be researched to unlock this item. If none are specified, this item is unlocked from the start. Soldiers can only use unlocked items in the Battlescape.
| -
|-
| '''size'''
| Space occupied by this item in [[Base Stores]]. Can be a decimal value.
| 0.0
|-
| '''costBuy'''
| Amount of money spent for purchasing this item. If set to 0, this item will not be available in the Purchase/Recruit screen.
| 0
|-
| '''costSell'''
| Amount of money gained for selling this item.
| 0
|-
| '''transferTime'''
| Number of hours it takes to purchase/transfer this item to a base.
| 24
|-
| '''weight'''
| [[Item_Weight|Weight]] occupied by this item in a soldier's inventory.
| 999
|-
| '''bigSprite'''
| Sprite ID from [[BIGOBS.PCK]] used to draw this item in a soldier's inventory and UFOpaedia.
| -1
|-
| '''floorSprite'''
| Sprite ID from [[FLOOROB.PCK]] used to draw this item on the floor of a Battlescape tile.
| -1
|-
| '''handSprite'''
| Sprite ID from [[HANDOB.PCK]] used to draw this item on a soldier's hand in the Battlescape.
modders: each handobject needs 8 images (8 directions) define the extrasprites accordingly
| 120
|-
| '''bulletSprite'''
| Sprite ID from ''BulletSprites.png'' used to draw this weapon's projectile on the Battlescape:
* 0 - [[Rocket Launcher]]
* 1 - [[Pistol]]
* 2 - [[Rifle]]
* 3 - [[Auto Cannon]]
* 4 - [[Heavy Cannon]]
* 5 - [[Laser Pistol]]
* 6 - [[Laser Rifle]]
* 7 - [[Heavy Laser]]
* 8 - [[Plasma Rifle|Plasma]]
* 9 - [[Small Launcher]]
* 10 - [[Blaster Launcher]]
for modders: the bulletsprite needs to be put into the extraSprites type "Projectiles" the bulletsprite can contain up to 35 3x3 images. The corresponding file id is 35*[bulletSprite]
| -1
|-
| '''fireSound'''
| Sound ID from [[#Extra_Sounds|BATTLE.CAT]] played when this weapon fires.
| -1
|-
| '''hitSound'''
| Sound ID from [[#Extra_Sounds|BATTLE.CAT]] played when this weapon hits a target.
| -1
|-
| '''hitAnimation'''
| Sprite ID from [[SMOKE.PCK]] used to draw the weapon's "hit explosion".
'''NOTE''': Do not define this value for melee/psi weapons, they use [[HIT.PCK]] and therefore meleeAnimation instead.
| 0
|-
| '''power'''
| Average damage of the weapon, in most cases it will be +-50% this value.
| 0
|-
| '''strengthApplied'''
| Add the attacking unit's strength to this weapon's damage.
| false
|-
| '''compatibleAmmo'''
| List of string IDs of the ammo items that can be loaded on this weapon. If none are specified, the weapon doesn't need ammo.
| -
|-
| '''damageType'''
| What type of [[damage]] does this weapon do:
* 0 - None
* 1 - Armor Piercing
* 2 - Incendiary
* 3 - High Explosive
* 4 - Laser
* 5 - Plasma
* 6 - Stun
* 7 - Melee
* 8 - Acid
* 9 - Smoke
'''NOTE:''' A damage type other than 0-9 will do nothing.
| 0
|-
| '''tuAuto'''
'''accuracyAuto'''
| The percentage (0-100%) of [[Time Units]] (from the soldier's total) required to fire an Auto Shot. If 0, the weapon does not have an Auto Shot.
The base accuracy (0-100%) applied to a soldier's [[Firing Accuracy]] when firing an Auto Shot.
| 0
0
|-
| '''tuSnap'''
'''accuracySnap'''
| The percentage (0-100%) of [[Time Units]] (from the soldier's total) required to fire a Snap Shot. If 0, the weapon does not have a Snap Shot.
The base accuracy (0-100%) applied to a soldier's [[Firing Accuracy]] when firing a Snap Shot.
| 0
0
|-
| '''tuAimed'''
'''accuracyAimed'''
| The percentage (0-100%) of [[Time Units]] (from the soldier's total) required to fire an Aimed Shot. If 0, the weapon does not have an Aimed Shot.
The base accuracy (0-100%) applied to a soldier's [[Firing Accuracy]] when firing an Aimed Shot.
| 0
0
|-
|-
| '''tuMelee'''
'''accuracyMelee'''
| The percentage (0-100%) of [[Time Units]] (from the soldier's total) required to do a melee attack (Hit). If 0, the weapon does not have a melee attack.
The base accuracy (0-100%) applied to a soldier's [[Melee Accuracy]] when doing a melee attack.
| 0
0
|-
| '''clipSize'''
| The amount of ammo stored in each weapon clip. If -1 is specified, this weapon has infinite ammo.
| 0
|-
| '''battleType'''
| Defines the weapon's behavior in the Battlescape:
* 0 - None (Geoscape-only item)
* 1 - [[Weapons|Firearm]]
* 2 - Ammo
* 3 - Melee
* 4 - [[Grenade]]
* 5 - [[Proximity Grenade]]
* 6 - [[Medi-Kit (EU)|Medi-Kit]]
* 7 - [[Motion Scanner]]
* 8 - [[Mind Probe]]
* 9 - [[Psi-Amp]]
* 10 - [[Electro-flare]]
* 11 - Corpse
| 0
|-
| '''twoHanded'''
| Is this weapon two-handed? If true, incurs an accuracy penalty if used with both hands occupied. Note that the handsprite of a twoHanded item is also drawn at a slightly different position than a one handed item.
| false
|-
| '''waypoint'''
| Does this weapon use waypoints? (eg. [[Blaster Launcher]]). Can also be used to make ammo items use the waypoint system.
| false
|-
| '''fixedWeapon'''
| Is this weapon fixed? (it's part of a unit, eg. tanks and terrorist units)
| false
|-
| '''invWidth'''
| Item width in a soldier's inventory (in grid units).
| 1
|-
| '''invHeight'''
| Item height in a soldier's inventory (in grid units).
| 1
|-
| '''painKiller'''
| Amount of painkillers contained in a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''heal'''
| Amount of heal's contained in a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''stimulant'''
| Amount of stimulants contained in a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''woundRecovery'''
| Amount of [[Fatal Wounds]] treated by each heal of a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''healthRecovery'''
| Amount of [[Health]] recovered by each heal of a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''stunRecovery'''
| Amount of [[Stun]] removed by each stimulant of a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''energyRecovery'''
| Amount of [[Energy]] recovered by each stimulant of a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''tuUse'''
| Amount of [[Time Units]] required to use this item (for non-offensive items). It's a flat rate if '''flatRate''' is true, otherwise it's a percentage (0-100%).
| 0
|-
| '''recoveryPoints'''
| [[Score]] gained for recovering this alien artifact.
| 0
|-
| '''armor'''
| How much damage is needed to destroy this item on the ground.
| 20
|-
| '''recover'''
| Is this item recoverable? (gets transported to the X-COM base on mission success)
| true
|-
| '''turretType'''
| Sprite ID from [[TANKS.PCK]] of the turret to assign to this tank:
* 0 - [[Tank/Cannon]]
* 1 - [[Tank/Rocket Launcher]]
* 2 - [[Tank/Laser Cannon]]
* 3 - [[Hovertank/Plasma]]
* 4 - [[Hovertank/Launcher]]
| -1
|-
| '''liveAlien'''
| Does this item represent a live alien? (counts towards [[Alien Containment]])
| false
|-
| '''blastRadius'''
| Size of the projectile explosions. 0 for no explosion. -1 to automatically calculate based on weapon power and damage type (actual '''blastRadius''' currently is capped due [[Explosions#Playing_With_Fire|Explosion calculations]]).
| -1
|-
| '''flatRate'''
| If true, then TU costs for this weapon are a flat rate (instead of a percentage of unit TUs).
| false
|-
| '''arcingShot'''
| Does this weapon fire in an arc?
| false
|-
| '''attraction'''
| Represents how likely an alien is to pick up this item. Values below 5 will be ignored (by design).
| 0
|-
| '''maxRange'''
| Maximum range at which this weapon can operate.
| 200
|-
| '''aimRange'''
| Maximum effective range with this weapon before which range-based dropoff occurs.
| 200
|-
| '''snapRange'''
| Maximum effective range with snap shot before which range-based dropoff occurs. (ufoextender accuracy only)
| 15
|-
| '''autoRange'''
| Maximum effective range with auto shot before which range-based dropoff occurs. (ufoextender accuracy only)
| 7
|-
| '''minRange'''
| Range-based dropoff will work in reverse for ranges below this.
| 0
|-
| '''dropoff'''
| The value by which the accuracy lowers for each tile after (or before) the thresholds above.
| 2
|-
| '''bulletSpeed'''
| How much faster (or slower, if you use a negative number) is a projectile fired from this weapon compared to the average.
| 0
|-
| '''autoShots'''
| How many auto shots does this weapon fire.
| 3
|-
| '''shotgunPellets'''
| Number of projectiles fired per unit of ammunition. (note: due to engine limitations it is currently impossible to draw multiple projectiles in flight.)
| 0
|-
| '''zombieUnit'''
| String ID of the unit used for zombification (eg. [[Chrysallid]]s turn units into [[Zombie]]s).
| none
|-
| '''meleeSound'''
| Sound ID from [[#Extra_Sounds|BATTLE.CAT]] played when this weapon attacks a target with melee.
| 39
|-
| '''meleeHitSound'''
| Sound ID from [[#Extra_Sounds|BATTLE.CAT]] played when this weapon HITS a target with melee.
| -1
|-
| '''meleeAnimation'''
| Sprite ID from HIT.PCK played when this weapon attacks a target with melee.
| 0
|-
| '''meleePower'''
| Damage this weapon will do when using melee. This only applies to Firearms, and is only available as stun damage. For normal melee weapons, use regular power and damage types.
| 0
|-
| '''LOSRequired'''
| Does this item require line of sight? (only applies to mind probes and psi-amps)
| false
|-
| '''skillApplied'''
| Is melee skill applied to the accuracy of an attack made with this object?
| true
|-
|}

=== UFOs ===

Defines one of the [[UFOs]] that invade Earth, listed in ''"ufos:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the UFO name.
| ''required''
|-
| '''size'''
| String ID of the UFO size.
| STR_VERY_SMALL
|-
| '''sprite'''
| Sprite ID from [[INTERWIN.DAT]] used to draw this UFO in the dogfight view and UFOpaedia.
don't try to add more images if you don't want to punch yourself in the face - use modsprite
| -1
|-
| '''modSprite'''
| Filename used to draw this UFO in the dogfight view and UFOpaedia.
| -
|-
| '''damageMax'''
| Maximum amount of damage this UFO can take. If the UFO takes 50% damage, it crash lands. If it takes 100% damage, it is destroyed.
| 0
|-
| '''speedMax'''
| Maximum speed in nautical miles.
| 0
|-
| '''accel'''
| Aceeleration value shown in the UFOpaedia.
| 0
|-
| '''power'''
| Damage power of this UFO's weapon in dogfights.
| 0
|-
| '''range'''
| Maximum range of this UFO's weapon in dogfights (in meters).
| 0
|-
| '''score'''
| [[Score]] gained when this UFO is destroyed, or half this score if it crash lands.
| 0
|-
| '''reload'''
| Time the UFO's weapon takes to fire between each shot.
| 0
|-
| '''breakOffTime'''
| Minimum amount of time for the UFO to be able to break off of a dogfight.
| 0
|-
| '''battlescapeTerrainData'''
| [[#Terrains|Terrain]] associated to this UFO in Battlescape missions.
| ''required''
|-
|}

=== Inventory Sections ===

Defines one of the sections of the [[Inventory TU Table|Battlescape inventory]] (eg. Backpack), listed in ''"invs:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the inventory name.
| ''required''
|-
| '''x'''
'''y'''
| Pixel coordinates of this section on the inventory screen.
| 0
0
|-
| '''type'''
| Type of this section:
* 0 = Slot section, can contain as many items as will fit on the slots.
* 1 = Hand section, can only contain one item regardless of size.
* 2 = Ground section, can contain infinite items.
| 0
|-
| '''slots'''
| List of the grid slots (''[x, y]'') that this section is composed of. For example, to make a 2x2 section, you would have ''[0, 0] [0, 1] [1, 0] [1, 1]''.
| -
|-
| '''costs'''
| List of [[Time Units]] costs to move an item from this section to another one (eg. ''STR_BACKPACK: 16'' means it will cost 16 TUs to move an item from this section to the Backpack).
| -
|-
|}

=== Terrains ===

Defines one of the [[TERRAIN|terrains]] used to generate a Battlescape map, listed in "terrains:".

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''name'''
| String ID of the terrain name.
| ''required''
|-
| '''largeBlockLimit'''
| Maximum amount of large blocks that can be used on map generation.
| 0
|-
| '''textures'''
| List of [[TEXTURE.DAT|Geoscape textures]] that correspond to this terrain.
| -
|-
| '''hemisphere'''
| Geoscape hemisphere associated with this terrain:
* -1 - Northern hemisphere.
* 0 - Both hemispheres.
* 1 - Southern hemisphere.
| 0
|-
| '''mapDataSets'''
| List of filenames (each with matching [[MCD]]/[[Image Formats#PCK|PCK/TAB]] files) that contain the tiles of this terrain.
| -
|-
| '''mapBlocks'''
| List of map blocks (see below) that are used for generating a map.
| -
|-
| '''roadTypeOdds'''
| Odds as a % of generating each type of road (E-W Road, N-S Road, Crossing) odds for crossing are: 100 - EW - NS.
| [0 0]
|-|-
| '''civilianTypes'''
| List of units to use as civilians for this mission.
| [MALE_CIVILIAN, FEMALE_CIVILIAN]
|-
|}

==== Map Blocks ====

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''name'''
| Filename of the [[MAPS|map]].
| ''required''
|-
| '''width'''
| Width of this map block in Battlescape grid units.
| 0
|-
| '''length'''
| Length of this map block in Battlescape grid units.
| 0
|-
| '''height'''
| Height of this map block in Battlescape grid units.
| 1
|-
| '''type'''
| Type of this map block:
* -1 - Undefined
* 0 - Default
* 1 - Landing Zone (for placing X-COM / alien craft)
* 2 - E-W Road (for city maps)
* 3 - N-S Road (for city maps)
* 4 - Road Crossing (for city maps)
* 5 - Dirt (for filling empty base blocks)
* 6 - X-COM spawn point (for [[Alien Base]] / [[Cydonia]] missions)
* 7 - [[Alien Base]] Target
* 8 - [[Cydonia]] Target
| -1
|-
| '''subType'''
| Sub-type of this map block (see '''type''').
| -1
|-
| '''frequency'''
| Frequency of this block in a map.
| 1
|-
| '''maxCount'''
| Maximum amount of times this block can be used in a map. If -1 there is no limit.
| -1
|}

*'''frequency''' defines the odds of the map appearing on the map
** The value assigned (default: 1) is used in ''x/n'', which defines the probability of being chosen.
** ''x'' is the integer defined for the map block's frequency and ''n'' is the combined total of probabilities for all the map types combined.
** This property can only be used in type 0 map blocks.
*'''maxCount''' is the maximum number of times it can be used.
** The value assigned is also used in ''x/n'' to determine the probability of being chosen.
** Each use reduces ''x'' by -1, with the caveat that being used as a Landing Zone type will not reduce the x value since it could result in no available Landing Zones.
** This property can only be used in type 0 map blocks.
* '''hemisphere''' only applies to UFO missions, not Terror ones.
*'''width/length''' defines the size of the map
** be aware that the mapview "width"-label is the openxcom ruleset length parameter
** be aware that the mapview "length"-label is the openxcom ruleset width parameter

==== Guidelines/Tips ====
* All maps with an XCOM/Alien craft require at least one type 1 map block. This map block can only contain ground tiles (no walls or objects), otherwise the game will crash or the walls/objects will be removed.
* All Terror terrains (listed under STR_TERROR_MISSION) require at least 1 map block of '''Types''' 2, 3 and 4 (for a total of 3 maps, which are required to place roads) and the corresponding '''roadTypeOdds''' added to the ruleset.
* If there isn't any map blocks designed as roads since you want to keep your terrain 'random', this can be circumvented by designating all 10x10 map blocks, excluding the one(s) used for the XCOM craft, as either '''Type''' 2, 3 and 4 and by defining their '''subType''' to 0. The game will then randomly choose between the map blocks for each type used in the roads, making them map more random.

=== Armor ===

Defines a Battlescape unit's [[armor]] as well as visual representation (so every unit has an armor), listed in ''"armors:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the armor name.
| ''required''
|-
| '''spriteSheet'''
| Sprite sheet from [[UNITS]] used to draw a unit wearing this armor.
| -
|-
| '''spriteInv'''
| Sprite used for the [[Inventory Backgrounds]] of a unit wearing this armor.
| -
|-
| '''corpseBattle'''
| List of string IDs of the corpse [[#Items|items]] generated when a unit wearing this armor is killed (one per unit tile) on the Battlescape.
| -
|-
| '''corpseGeo'''
| String ID of the corpse [[#Items|item]] associated with this unit on the Geoscape.
| -
|-
| '''storeItem'''
| String ID of the [[#Items|item]] that represents this armor in [[Base Stores]] for equipping.
| -
|-
| '''weight'''
| Physical weight of the armor when worn
| 6
|-
| '''stats'''
| like soldier stats (see below) but these are treated as stat bonuses for wearing the specific armor.
| -
|-
| '''frontArmor'''
| Protection provided on the front of the unit.
| 0
|-
| '''sideArmor'''
| Protection provided on the sides of the unit.
| 0
|-
| '''rearArmor'''
| Protection provided on the rear of the unit.
| 0
|-
| '''underArmor'''
| Protection provided under the unit (eg. from explosions).
| 0
|-
| '''drawingRoutine'''
| Drawing routine used to put together the body parts in the unit's '''spriteSheet''':
* 0 = [[Soldier]], [[Sectoid]]
* 1 = [[Floater]]
* 2 = [[HWP]]
* 3 = [[Cyberdisk]]
* 4 = [[Civilian]], [[Ethereal]]
* 5 = [[Sectopod]], [[Reaper]]
* 6 = [[Snakeman]]
* 7 = [[Chryssalid]]
* 8 = [[Silacoid]]
* 9 = [[Celatid]]
* 10 = [[Muton]]
| 0
|-
| '''movementType'''
| Type of movement provided by this armor:
* 0 = Walking
* 1 = Flying
* 2 = Sliding (no walking animation)
it also defines the body of an tank (32-images) in your spriteSheet or the change in sprites while flying using a flying armour see: [[TANKS.PCK]], [[XCOM_2.PCK]]
| 0
|-
| '''damageModifier'''
| List of decimal damage modifiers (1.0 = 100%) this armor applies to each damage type (see [[#Items|Items section]]) received. Modifiers must be specified for all damage types, in this order:
* None
* Armor Piercing
* Incendiary
* High Explosive
* Laser
* Plasma
* Stun
* Melee
* Acid
* Smoke
|
- 1.0 
- 1.0 
- 1.0 
- 1.0 
- 1.0 
- 1.0 
- 1.0 
- 1.0 
- 1.0 
- 1.0
|-
| '''size'''
| Size of the unit wearing this armor, in Battlescape grid units. Every unit is square, so a size of 2 means 2x2.
| 1
|-
| '''loftempsSet'''
| List of [[LOFTEMPS]] IDs (one per unit tile, so a 1x1 unit has 1, a 2x2 unit has 4, etc.) used to represent a unit wearing this armor in 3D space.
| -
|-
| '''loftemps'''
| loftemps is a deprecated option that only works for 1x1 sized units.
| -
|}

=== Player Units (Soldiers) ===

Defines a [[soldier]] recruited by X-COM, listed in ''"soldiers:"''. Currently only one soldier unit type (''XCOM'') is supported.

Unit stats are represented as follows:
* [[Time Units|tu]]
* [[Energy|stamina]]
* [[Health|health]]
* [[Bravery|bravery]] (always a multiple of 10)
* [[Reactions|reactions]]
* [[Firing Accuracy|firing]]
* [[Throwing Accuracy|throwing]]
* [[Strength|strength]]
* [[Psi Strength|psiStrength]]
* [[Psi Skill|psiSkill]]
* [[Melee Accuracy|melee]] (not visible)

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the soldier name.
| ''required''
|-
| '''minStats'''
| Minimum values used to generate the soldier's [[Starting Stats]]. In this case, ''psiSkill'' is treated as the initial stat (not generated).
| -
|-
| '''maxStats'''
| Maximum values used to generate the soldier's [[Starting Stats]]. In this case, ''psiSkill'' is treated as the minimum value for the first month of psi training (actual value is 100%-150%).
| -
|-
| '''statCaps'''
| Maximum stats this soldier can gain through [[Experience]]. '''NOTE:''' A stat will still go over the limit once, and then will no longer increase (see [[Experience#Regarding Caps|Regarding Caps]]).
| -
|-
| '''armor'''
| String ID of the [[#Armor|armor]] this soldier uses by default.
| -
|-
| '''standHeight'''
| Height of this soldier when standing.
| 0
|-
| '''kneelHeight'''
| Height of this soldier when kneeling.
| 0
|-
| '''floatHeight'''
| Distance between the bottom of this unit and the ground.
| 0
|}

=== AI Units (Aliens/Civilians) ===

Defines an [[Alien Life Forms|alien]] (enemy) or [[civilian]] (neutral) unit, listed in ''"units:"''. Every different alien rank is a different unit, since they have completely different stats. Unit stats are represented as follows:
* [[Time Units|tu]]
* [[Energy|stamina]]
* [[Health|health]]
* [[Bravery|bravery]] (always a multiple of 10)
* [[Reactions|reactions]]
* [[Firing Accuracy|firing]]
* [[Throwing Accuracy|throwing]]
* [[Strength|strength]]
* [[Psi Strength|psiStrength]]
* [[Psi Skill|psiSkill]]
* [[Melee Accuracy|melee]] (not visible)

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the unit name.
| ''required''
|-
| '''race'''
| String ID of the unit race (for alien units).
| -
|-
| '''rank'''
| String ID of the unit rank (for alien units).
| -
|-
| '''stats'''
| Battlescape stats of this unit.
| -
|-
| '''armor'''
| String ID of the [[#Armor|armor]] this unit uses by default.
| -
|-
| '''standHeight'''
| Height of this unit when standing.
| 0
|-
| '''floatHeight'''
| Distance between the bottom of this unit and the ground.
| 0
|-
| '''value'''
| [[Score]] this unit is worth.
| 0
|-
| '''deathSound'''
| Sound ID from [[#Extra_Sounds|BATTLE.CAT]] played when this unit dies.
| -1
|-
| '''aggroSound'''
| Sound ID from [[#Extra_Sounds|BATTLE.CAT]] played when this unit aggros.
| -1
|-
| '''moveSound'''
| Sound ID from [[#Extra_Sounds|BATTLE.CAT]] played when this unit moves.
| -1
|-
| '''intelligence'''
| Intelligence of this unit's AI. The higher the value, the longer this unit remembers player troops between turns.
| 0
|-
| '''aggression'''
| Aggression of this unit's AI. The higher the value, the more ruthless the unit, the more likely to make a frontal assault. Less aggressive units tend to set up ambushes.
Vanilla values are:
* 0 = mostly passive
* 1 = balanced
* 2 = mostly aggresive
| 0
|-
| '''energyRecovery'''
| Energy recovered by the unit each turn (needs verification)
| 40 (?)
|-
| '''specab'''
| Special ability of this unit:
* 0 = None
* 1 = [[Cyberdisc|Explodes on Death]] (Requires '''power''' and '''blastRadius''' properties to be set on the corpse)
* 2 = [[Bio-Drone|Burns Floor]]
* 3 = [[Zombie|Respawns on Death]]
| 0
|-
| '''spawnUnit'''
| String ID of the unit used to respawn on death (eg. [[Zombie]]s respawn as [[Chrysallid]]s).
| -
|-
| '''livingWeapon'''
| Is this unit a living weapon? (only attacks with a '''fixedWeapon''')
| false
|-
|}

=== Alien Races ===

Defines a [[Alien Life Forms|race]] used in [[Alien Missions]], listed in ''"alienRaces:"''. Heavily tied with deployment data.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''id'''
| String ID of the alien race name.
| ''required''
|-
| '''members'''
| Alien crew associated with this alien race (eg. race units + terrorist units), defined by a list of unit string IDs. Order here will define rank in terms of deployment. generally speaking the order is:
* 0 - Commander
* 1 - Leader
* 2 - Engineer
* 3 - Medic
* 4 - Navigator
* 5 - Soldier
* 6 - Terrorist 1
* 7 - Terrorist 2
but of course, not all races have all ranks, so the "fill in" rank would be listed multiple times (see ethereals).
| -
|-
| '''retaliation'''
| retaliation enables/disables the race for retaliation missions.
| ''True''
|-
|}

=== Alien Deployments ===

Defines a Battlescape deployment data used in [[Alien Missions]] (such as alien and map configurations), listed in ''"alienDeployments:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the deployment name.
| ''required''
|-
| '''width'''
| Width of the Battlescape map in grid units.
| 0
|-
| '''length'''
| Length of the Battlescape map in grid units.
| 0
|-
| '''height'''
| Vertical height of the Battlescape map in grid units.
| 0
|-
| '''terrains'''
| list of string IDs of the [[#Terrains|terrain]] to choose from to generate this map. This is not used for UFO sites where the terrain comes from the Geoscape.
| -
|-
| '''shade'''
| Shade of the map (0-15, where 0 is full daytime and 15 is full nighttime). This is not used for UFO sites where the shade comes from the Geoscape.
| 0
|-
| '''nextStage'''
| String ID of the next deployment stage to use after this one, for multi-stage missions.
| -
|-
| '''data'''
| List of deployment data for each alien rank on this mission (see below).
| -
|}

Notes:
* '''terrains''' can also be used with UFOs, with the game using instead the listed terrain rather than the location of the UFO on Geoscape.
==== Deployment Data ====

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''alienRank'''
| [[Alien Rank|Rank]] associated with this deployment data, as defined by the order of the race in question (see above)
| ''required''
|-
| '''lowQty'''
| Minimum quantity of aliens to spawn on beginner/experienced.
| 0
|-
| '''highQty'''
| Minimum quantity of aliens to spawn on superhuman. (minimum quantity for veteran/genius is the median of this and the previous value)
| 0
|-
| '''dQty'''
| Delta in Quantity. ie: random number of aliens to spawn on top of the minimum (all difficulties).
| 0
|-
| '''percentageOutsideUfo'''
| Percentage (0-100%) of aliens to spawn outside in UFO sites.
| 0
|-
| '''itemSets'''
| Three lists (one for each alien technology level) of [[#Items|items]] (string IDs) for the aliens to equip.
| ''required''
|-
|}

=== Research ===

Defines a [[Research|research topic]] that X-COM scientists can investigate, listed in ''"research:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''name'''
| String ID of the research project's name (or item, if a '''lookup''' is defined).
| ''required''
|-
| '''lookup'''
| String ID of the research project's display name and UFOPaedia article reference.
| -
|-
| '''cost'''
| Number of man hours (on average) required to complete this project.
| 0
|-
| '''points'''
| [[Score]] earned for completing this project.
| 0
|-
| '''needItem'''
| Does this project require an [[#Items|item]] of the same name?
| false
|-
| '''dependencies'''
| List of research projects that can unlock access to this one. If the full list is researched, or if one of the projects on the list "unlocks" this one, it becomes available.
| -
|-
| '''unlocks'''
| List of research projects unlocked, regardless of other dependencies, but not requirements, by completing this project (for example, any live alien unlocks "alien origins").
| -
|-
| '''requires'''
| List of research projects unilaterally required before this project can be unlocked (for example, "the martian solution" will not even be considered for unlocking until AFTER "alien origins" is completed).
| -
|-
| '''getOneFree'''
| List of "bonus" research projects that may be granted when completing this project (for example, alien medics will give you information on other alien races). Only applies to living aliens.
| -
|-
|}

=== Manufacture ===

Defines a [[Manufacture|manufacture project]] that X-COM engineers can produce, listed in ''"manufacture:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''name'''
| String ID of the manufacturing project's name (and the item it produces).
| ''required''
|-
| '''category'''
| String ID of the manufacturing project's category.
| -
|-
| '''requires'''
| List of [[#Research|topics]] (string IDs) that must be researched to unlock this project. If none are specified, this project is unlocked from the start.
| -
|-
| '''space'''
| Amount of [[Workshop]] space required to begin this project.
| 0
|-
| '''time'''
| Number of man hours (on average) required per item.
| 0
|-
| '''cost'''
| Monetary deduction per item manufactured.
| 0
|-
| '''requiredItems'''
| List of [[#Items|items]] required and consumed per item manufactured.
| -
|-
| '''producedItems'''
| List of [[#Items|items]] produced per each item consumed. If not specified, defaults to 1 item with the same string ID as the manufacture.
| 1
|-
|}

=== UFOpaedia Article ===

Defines an article in the in-game [[UFOpaedia]], listed in ''"ufopaedia:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''id'''
| String ID of the article name. This must match the ID of the object associated with this article, if applicable.
| ''required''
|-
| '''title'''
| String ID of the article title. If omitted, the '''id''' is used.
| -
|-
| '''type_id'''
| Type of this article:
* 0 = Unknown
* 1 = [[Craft]]
* 2 = [[Craft Armaments]]
* 3 = [[HWP]]
* 4 = [[Equipment (EU)|Equipment]]
* 5 = [[Armour]]
* 6 = [[Base Facilities]]
* 7 = Text & Image (eg. [[Alien Life Forms]], [[UFO Components]])
* 8 = Text (eg. [[Alien Research]])
* 9 = [[UFO]]
| 0
|-
| '''section'''
| String ID of the UFOpaedia section this article belongs in.
| -
|-
| '''requires'''
| List of [[#Research|topics]] (string IDs) that must be researched to unlock this article. If none are specified, this article is unlocked from the start.
| -
|-
| '''image_id'''
| Filename of the [[UP001.SPK-UP042.SPK|background image]] displayed on this article, if applicable.
| -
|-
| '''text'''
| String ID of the description displayed on this article.
| -
|-
| '''text_width'''
| Maximum width of the text displayed, only applicable to ''Text & Image'' articles.
| 0
|-
| '''rect_stats'''
| Rectangle ('''x''', '''y''', '''width''', '''height''') of the stats text on the screen, only applicable to ''Craft'' articles.
| 0
|-
| '''rect_text'''
| Rectangle ('''x''', '''y''', '''width''', '''height''') of the description text on the screen, only applicable to ''Craft'' articles.
| 0
|-
| '''weapon'''
| String ID of the weapon, only applicable to ''HWP'' articles.
| -
|}

=== UFO Trajectories ===

Defines a trajectory carried out by an UFO during an [[#Alien Missions|alien mission]], listed in ''"ufoTrajectories:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''id'''
| String ID of the trajectory name.
| ''required''
|-
| '''groundTimer'''
| Amount of seconds for the UFO to spend on Ground waypoints.
| 0
|-
| '''waypoints'''
| List of waypoints for the UFO to traverse, defined as ''[zone, altitude, speed]''. 
'''zone''': Globe zone where the waypoint is located. 
'''altitude''': UFO altitude after reaching this waypoint:
* 0 - Ground
* 1 - Very Low
* 2 - Low
* 3 - High
* 4 - Very High
'''speed''': UFO speed after reaching this waypoint, as a percentage (0-100%) of its maximum speed.
| -
|}

=== Alien Missions ===

Defines an [[Alien Missions|alien mission]] carried out by UFOs on the Geoscape, listed in ''"alienMissions:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the mission type.
| ''required''
|-
| '''points'''
| [[Score]] allocated to aliens for successfully completing this mission.
| 0
|-
| '''raceWeights'''
| List of alien races likely to carry out this mission, and the % chance of them being allocated to this mission, listed by "number of months after game beginning".
| ''required''
|-
| '''waves'''
| List of UFO waves to spawn as this mission progresses, as described below.
| ''required''
|}

==== Waves ====

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''ufo'''
| String ID of the [[#UFOs|UFO]] to spawn.
| ''required''
|-
| '''count'''
| Number of UFOs to spawn.
| 0
|-
| '''trajectory'''
| String ID of the [[#UFO Trajectories|trajectory]] for this UFO to use when entering Earth's atmosphere.
| ''required''
|-
| '''timer'''
| How long after the previous wave should this wave arrive? (in seconds)
| 0
|-
|}

=== Alien Item Levels ===

This is a list of item level probabilities, with a number between 0 and 2 representing an item level from plasma pistols to heavy plasmas, as defined in the deployments, expressing a 10% probability for that item level being used.

0 = first set (plasma pistol/clip)
1 = second set (plasma rifle/clip)
2 = third set (heavy plasma/clip)

For example:
[ 2, 0, 0, 0, 0, 0, 0, 1, 1, 1 ]
would represent a 60% chance for pistols, 30% rifles, and 10% heavy weapons. 
Note that the order does not matter, but the length DOES. each line MUST have 10 digits.

The above can be confusing. There are 10 fields; each number represents 10%. 
There are six instances of '0'. 6x10% = 60% chance of plasma pistol 
There are three instances of '1'. 3x10% = 30% chance of plasma rifle 
There is only one instance of '2'. 1x10% = 10% chance of heavy plasma 

Each line represents a month after the beginning of the game, and there is no limit to the number defined. 
OpenXCom will use the most recently available item level in the event the game goes on forever.

=== Extra Sprites ===

Adds or replaces sprites in an existing [[Image Formats|X-COM image file]], listed in ''"extraSprites:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| Filename of the original/new image to modify.
| ''required''
|-
| '''width'''
'''height'''
| Size of the sprite(s) in pixels.
| 0
0
|-
| '''singleImage'''
| Is the image file just a single sprite (true) or a spritesheet (false)?
| false
|-
| '''subX'''
'''subY'''
| Size of the subdivision in pixels. If a subdivision is specified, then the image file is divided into chunks to form the sprites (eg. spritesheets).
| 0
0
|-
| '''files'''
| List of the new sprites to add/replace, listed as ''spriteID: filename''.
| -
|}

Example:
- type: GIANTBUNNY.PCK
width: 32
height: 40
files:
0: Resources/Bunny/Bunny00.png
1: Resources/Bunny/Bunny01.bmp
2: Resources/Bunny/Bunny02.gif

=== Extra Sounds ===

Adds or replaces sounds in an existing [[SOUND|X-COM sound file]], listed in ''"extraSounds:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| ID of the original sound file to modify:
* BATTLE.CAT - Battlescape sounds, corresponds to ''SOUND1.CAT'' or ''SAMPLE2.CAT'' (55 sounds).
* INTRO.CAT - Intro sounds, corresponds to ''INTRO.CAT'' or ''SAMPLE3.CAT'', probably best not to mess with these.
* GEO.CAT - Geoscape sounds, corresponds to ''SOUND2.CAT'' or ''SAMPLE.CAT'' (14 sounds).
| ''required''
|-
| '''files'''
| List of the new sounds to add/replace, listed as ''soundID: filename''.
| -
|}

Example:
- type: BATTLE.CAT
files:
55: Resources/Sounds/sample.wav

=== Extra Strings ===

Adds or replaces text strings in an existing [[Translations (OpenXcom)|OpenXcom language file]], listed in ''"extraStrings:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| Filename of the original language file to modify, sans extension.
| ''required''
|-
| '''strings'''
| List of the new strings to add/replace, listed as ''stringID: text''.
| -
|}

Example:
- type: en-US
strings:
STR_SNIPER_RIFLE: Sniper Rifle
STR_SNIPER_RIFLE_CLIP: Sniper Rifle Clip
- type: en-GB
strings:
STR_SNIPER_RIFLE: Sniper Rifle
STR_SNIPER_RIFLE_CLIP: Sniper Rifle Clip
- type: de
strings:
STR_SNIPER_RIFLE: Scharfschützengewehr
STR_SNIPER_RIFLE_CLIP: Scharfschützengewehrmunition
- type: ru
strings:
STR_SNIPER_RIFLE: Снайперская винтовка
STR_SNIPER_RIFLE_CLIP: Магазин к снайп. винтовке

=== StatStrings ===

[[Statstrings]] are used for automatically renaming soldiers. They are case sensitive and they are processed in the order in which they are specified.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''string'''
| String to add to name.
| ''required''
|-
| '''psiStrength''' 
'''psiSkill''' 
'''bravery''' 
'''strength''' 
'''firing''' 
'''reactions''' 
'''stamina''' 
'''tu''' 
'''health''' 
'''throwing'''
| One or more stat ranges are ANDed together for success. Each range has a minVal and maxVal. Use YAML standard tilde (~) to indicate null. ((~) = 0 as minvalue; (~) =255 as maxvalue)
| -
|}

Example:
statStrings:
- string: "x"
psiStrength: [~, 30]
- string: "P"
psiStrength: [80, ~]
- string: "p"
psiStrength: [60, 79]
- string: "K"
psiSkill: [60, ~]
- string: "k"
psiSkill: [30, 59]
- string: "b"
bravery: [60, ~]
- string: "c"
bravery: [~, 10]
- string: "w"
strength: [~, 25]
- string: "Snpr"
firing: [60, ~]
reactions: [60, ~]
- string: "M"
firing: [70, ~]
- string: "m"
firing: [60, 69]
- string: "Sct"
reactions: [50, ~]
tu: [60, ~]
- string: "R"
reactions: [60, ~]
- string: "r"
reactions: [50, 59]

==References==
<references />

[[Category:OpenXcom]]

Ruleset Reference (OpenXcom)

2015-02-07T13:01:26Z

Falko: Undo revision 62919 by Kkmic (talk) - not relevant for 1.0

A reference of all the customizable values of everything in a [[Rulesets (OpenXcom)|ruleset]] for the current stable version (1.0) of OpenXcom. For the current nightly versions (with the advanced features currently in development) check [[Ruleset Reference Nightly (OpenXcom)|Ruleset Reference Nightly]].

Some guidelines:
* If a value is omitted from the ruleset, the default is used. You cannot omit ''required'' values.
* Text strings (eg. names) are represented by string IDs from the [[Translations (OpenXcom)|language files]]
* Numerical IDs (used for sprites, sounds, etc.) start at 0, not 1.
* Boolean (yes/no) values are represented by true/false.
* World coordinates are represented in degrees (see [[WORLD.DAT]]).
* Money amounts (prices, costs, etc.) are represented in dollars.
* All paths are '''case sensitive'''! If your ruleset uses external files, make sure that they named properly as described in ruleset.

Items are ordered as they come in the ruleset. To override this, you can specify a ''listOrder''. You can find the default listOrders in [[Ruleset List Order (OpenXcom)|Ruleset List Order]].

=== Countries ===

Defines one of the [[Country Funding (EU)|funding nations]], listed in ''"countries:"''. They're used for activity graphs and player scoring.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the country name.
| ''required''
|-
| '''fundingBase'''
| Country's base funding, in thousands. The starting funding can be anywhere between 1x and 2x the base funding.
| 0
|-
| '''fundingCap'''
| Country's funding cap, in thousands. Once a country reaches this maximum, it will no longer increase its funding.
| 0
|-
| '''labelLon'''
'''labelLat'''
| Longitude and latitude coordinates of the country's label on the globe. This label is only shown when the globe is zoomed in and "detail" is turned on.
| 0.0
0.0
|-
| '''areas'''
| List of "rectangles" on the globe defined as [''lon1'' ''lat1'' ''lon2'' ''lat2'']. Any activity within these areas counts towards the country's graph activity and affects their opinion of the player.
| -
|}

=== Regions ===

Defines one of the [[Geoscape (EU)#World Regions/Countries|world regions]], listed in ''"regions:"''. They're used for base placement, activity graphs and mission spawning.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the region name.
| ''required''
|-
| '''cost'''
| Amount of money spent building an X-COM base in this region (first base is free).
| 0
|-
| '''areas'''
| List of "rectangles" on the globe defined as ''[lon1, lat1, lon2, lat2]''. Any activity within these areas counts towards the region's graph activity.
| -
|-
| '''cities'''
| List of cities belonging to this region. They will be displayed on the globe and used for terror site missions. Each city is defined by their '''lon''' and '''lat''' coordinates and a '''name''' string ID.
| -
|-
| '''regionWeight'''
| Weight of this region when selecting regions for alien missions.
| 0
|-
| '''missionWeights'''
| Weighted list of the different mission types for this region (eg. ''STR_ALIEN_RESEARCH: 14'').
| -
|-
| '''missionZones'''
| List of "rectangles" (''[lon1, lat1, lon2, lat2]'') defining the mission zones for this region. Mission zones are waypoints for UFO trajectories.
| -
|-
| '''missionRegion'''
| Spawn mission in this region instead (used for regions without land).
| -
|}

=== Base Facilities ===

Defines one of the [[Base Facilities (EU)|facilities]] that can be built in an X-COM base, listed in ''"facilities:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the facility name.
| ''required''
|-
| '''requires'''
| List of [[#Research|topics]] (string IDs) that must be researched to unlock this facility. If none are specified, this facility is unlocked from the start.
| -
|-
| '''spriteShape'''
| Sprite ID from [[BASEBITS.PCK]] used to draw the facility's outer shape in the Basescape and UFOpaedia.
| -1
|-
| '''spriteFacility'''
| Sprite ID from [[BASEBITS.PCK]] used to draw the facility's contents in the Basescape and UFOpaedia. Drawn on top of '''spriteShape'''.
| -1
|-
| '''lift'''
| Is this facility an [[Access Lift]]? All base facilities must be connected to the lift.
| false
|-
| '''hyper'''
| Is this facility a [[Hyperwave Decoder]]? Displays extra information for detected UFOs. Only valid for radar facilities.
| false
|-
| '''mind'''
| Is this facility a [[Mind Shield]]? Reduces the chance of UFOs finding your base. Does not stack.
| false
|-
| '''grav'''
| Is this facility a [[Grav Shield]]? Doubles the power of your base defenses. Does not stack.
| false
|-
| '''size'''
| Size of the facility, in grid units. Every facility is square, so a size of 1 means 1x1, 2 means 2x2, etc. Bigger facilities are made up of multiple sprites, for example a 2x2 facility will use 4 sprites for '''spriteShape''' and 4 sprites for '''spriteFacility''' (top-left, top-right, bottom-left, bottom-right).
| 1
|-
| '''buildCost'''
| Amount of money spent to build this facility in the base.
| 0
|-
| '''buildTime'''
| Amount of days it takes for this facility to be built.
| 0
|-
| '''monthlyCost'''
| Amount of money spent monthly for the maintenance of this facility.
| 0
|-
| '''storage'''
| Amount of storage space (for items) this facility provides. See [[Base Stores]].
| 0
|-
| '''personnel'''
| Amount of personnel (soldiers, scientsts, engineers) these quarters can contain.
| 0
|-
| '''aliens'''
| Amount of live aliens this facility can contain. Only checked if the ''alienContainmentLimitEnforced'' option is enabled.
| 0
|-
| '''crafts'''
| Amount of X-COM craft this facility can contain.
| 0
|-
| '''labs'''
| Amount of lab space this facility provides for research projects.
| 0
|-
| '''workshops'''
| Amount of workshop space this facility provides for manufacture projects.
| 0
|-
| '''psiLabs'''
| Amount of soldier space this facility provides for psionic training.
| 0
|-
| '''radarRange'''
| Maximum radar detection range of this facility, in nautical miles.
| 0
|-
| '''radarChance'''
| Chance (0-100%) of this radar detecting a UFO that enters its range.
| 0
|-
| '''defense'''
| Offensive power provided by this base defense against attacking UFOs.
| 0
|-
| '''hitRatio'''
| Chance (0-100) of the base defense hitting an attacking UFO.
| 0
|-
| '''fireSound'''
| Sound ID from [[#Extra_Sounds|GEO.CAT]] played when the base defense fires.
| -1
|-
| '''hitSound'''
| Sound ID from [[#Extra_Sounds|GEO.CAT]] played when the base defense hits a target.
| -1
|-
| '''mapName'''
| [[MAPS|Map]] associated to this facility in Battlescape base defenses.
| -
|-
|}

=== Crafts ===

Defines one of the [[Craft|X-COM crafts]] that go on interception missions, listed in ''"crafts:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the craft name.
| ''required''
|-
| '''requires'''
| List of [[#Research|topics]] (string IDs) that must be researched to unlock this craft. If none are specified, this craft is unlocked from the start.
| -
|-
| '''sprite'''
| Sprite ID from [[BASEBITS.PCK]] used to draw this craft in the Basescape and from [[INTICON.PCK]] used to draw the damage indicator in dogfights.
modders: the corresponding extrasprite file id for BASEBITS.PCK is sprite+33 INTICON.PCK contains a minimized icon id=sprite the file id for the dogfight image is sprite+11
| -1
|-
| '''fuelMax'''
| Maximum amount of fuel this craft can carry. Crafts use up fuel based on their speed while travelling.
| 0
|-
| '''damageMax'''
| Maximum amount of damage this craft can take. If this amount is exceeded, the craft is destroyed.
| 0
|-
| '''speedMax'''
| Maximum speed in nautical miles. Crafts travel at max speed when flying and half speed when patrolling.
| 0
|-
| '''accel'''
| Aceeleration value shown in the UFOpaedia.
| 0
|-
| '''weapons'''
| Amount of craft weapons this craft can equip. The UI can only display a max of 2 weapons.
| 0
|-
| '''soldiers'''
| Amount of soldiers this craft can carry.
| 0
|-
| '''maxItems'''
| Amount of items this craft can carry.
| 80
|-
| '''vehicles'''
| Amount of vehicles this craft can carry.
| 0
|-
| '''costBuy'''
| Amount of money spent for purchasing this craft. If set to 0, the craft will not be available in the Purchase/Recruit screen.
| 0
|-
| '''costRent'''
| Amount of money spent monthly for renting this craft. If set to 0, the craft is not on rental and won't count towards base maintenance.
| 0
|-
| '''costSell'''
| Amount of money gained for selling this craft.
| 0
|-
| '''refuelItem'''
| Item required for refuelling this craft. If no item is specified, the craft uses human fuel.
| 0
|-
| '''repairRate'''
| Amount of damage restored every hour while [[Repairs|Repairing]] in base.
| 1
|-
| '''refuelRate'''
| Amount of fuel restored every 30 mins while [[Refueling]] in base. If specified, a '''refuelItem''' is spent each time.
| 1
|-
| '''radarRange'''
| Detection range of the craft's radar in nautical miles. Every craft radar has a 100% detection chance.
| 600
|-
| '''transferTime'''
| Number of hours it takes to purchase/transfer this craft to a base.
| 0
|-
| '''score'''
| [[Score]] lost when this craft is destroyed.
| 0
|-
| '''spacecraft'''
| Can this craft go to [[Cydonia]]?
| false
|-
| '''battlescapeTerrainData'''
| [[#Terrains|Terrain]] associated to this craft in Battlescape missions.
| -
|-
| '''deployment'''
| Custom positions for the unit deployment in the craft, listed as: ''[x, y, z, facing]''
If not specified, units are placed on empty spots from top-left to bottom-right facing top-right.
| -
|}

=== Craft Weapons ===

Defines one of the [[Craft Armaments|weapons]] equipped by X-COM craft for shooting down UFOs, listed in ''"craftWeapons:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the weapon name.
| ''required''
|-
| '''sprite'''
| Sprite ID from [[BASEBITS.PCK]] used to draw the weapon in the Basescape and from [[INTICON.PCK]] used to draw the weapon in dogfights.
modders: the corresponding extrasprites file id for INTICON.PCK is sprite+5 and sprite+48 for BASEBITS.PCK
| -1
|-
| '''sound'''
| Sound ID from [[#Extra_Sounds|GEO.CAT]] played when this weapon fires.
| -1
|-
| '''damage'''
| Amount of damage this weapon does to enemy UFOs.
| 0
|-
| '''range'''
| Maximum range of this weapon in dogfights (in meters).
| 0
|-
| '''accuracy'''
| Chance (0-100%) of each shot hitting the enemy UFO.
| 0
|-
| '''reloadCautious'''
| Time this weapon takes to fire between each shot in ''Cautious Mode''.
| 0
|-
| '''reloadStandard'''
| Time this weapon takes to fire between each shot in ''Standard Mode''.
| 0
|-
| '''reloadAggressive'''
| Time this weapon takes to fire between each shot in ''Aggressive Mode''.
| 0
|-
| '''ammoMax'''
| Maximum amount of ammo this weapon can carry.
| 0
|-
| '''rearmRate'''
| Amount of ammo restored every 30 mins while the craft is [[Rearming]] in base. If specified, '''clip'''s are spent depending on their '''clipSize'''. If the '''clipSize''' of the specified ammo is 0, no '''clip'''s are spent.
| 1
|-
| '''projectileType'''
| Type of the weapon projectile, used for the projectile sprite in dogfights:
* 0 - [[Stingray]]
* 1 - [[Avalanche]]
* 2 - [[Cannon]]
* 3 - [[Fusion Ball]]
* 4 - [[Laser Cannon]]
* 5 - [[Plasma Beam]]
| 2
|-
| '''projectileSpeed'''
| Speed of the weapon projectile in dogfights.
| 0
|-
| '''launcher'''
| String ID of the [[#Items|item]] required to equip this weapon.
| -
|-
| '''clip'''
| String ID of the [[#Items|item]] required to rearm this weapon.
| -
|}

=== Items ===

Defines the Geoscape and Battlescape properties of an [[Equipment (EU)|item]] that can be stored in X-COM bases, listed in ''"items:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the internal item name.
| ''required''
|-
| '''name'''
| String ID of the displayed item name, for cases where it's different from the internal name. If omitted, '''type''' is used.
| -
|-
| '''requires'''
| List of [[#Research|topics]] (string IDs) that must be researched to unlock this item. If none are specified, this item is unlocked from the start. Soldiers can only use unlocked items in the Battlescape.
| -
|-
| '''size'''
| Space occupied by this item in [[Base Stores]]. Can be a decimal value.
| 0.0
|-
| '''costBuy'''
| Amount of money spent for purchasing this item. If set to 0, this item will not be available in the Purchase/Recruit screen.
| 0
|-
| '''costSell'''
| Amount of money gained for selling this item.
| 0
|-
| '''transferTime'''
| Number of hours it takes to purchase/transfer this item to a base.
| 24
|-
| '''weight'''
| [[Item_Weight|Weight]] occupied by this item in a soldier's inventory.
| 999
|-
| '''bigSprite'''
| Sprite ID from [[BIGOBS.PCK]] used to draw this item in a soldier's inventory and UFOpaedia.
| -1
|-
| '''floorSprite'''
| Sprite ID from [[FLOOROB.PCK]] used to draw this item on the floor of a Battlescape tile.
| -1
|-
| '''handSprite'''
| Sprite ID from [[HANDOB.PCK]] used to draw this item on a soldier's hand in the Battlescape.
modders: each handobject needs 8 images (8 directions) define the extrasprites accordingly
| 120
|-
| '''bulletSprite'''
| Sprite ID from ''BulletSprites.png'' used to draw this weapon's projectile on the Battlescape:
* 0 - [[Rocket Launcher]]
* 1 - [[Pistol]]
* 2 - [[Rifle]]
* 3 - [[Auto Cannon]]
* 4 - [[Heavy Cannon]]
* 5 - [[Laser Pistol]]
* 6 - [[Laser Rifle]]
* 7 - [[Heavy Laser]]
* 8 - [[Plasma Rifle|Plasma]]
* 9 - [[Small Launcher]]
* 10 - [[Blaster Launcher]]
for modders: the bulletsprite needs to be put into the extraSprites type "Projectiles" the bulletsprite can contain up to 35 3x3 images. The corresponding file id is 35*[bulletSprite]
| -1
|-
| '''fireSound'''
| Sound ID from [[#Extra_Sounds|BATTLE.CAT]] played when this weapon fires.
| -1
|-
| '''hitSound'''
| Sound ID from [[#Extra_Sounds|BATTLE.CAT]] played when this weapon hits a target.
| -1
|-
| '''hitAnimation'''
| Sprite ID from [[SMOKE.PCK]] used to draw the weapon's "hit explosion".
'''NOTE''': Do not define this value for melee/psi weapons, they use [[HIT.PCK]] and therefore meleeAnimation instead.
| 0
|-
| '''power'''
| Average damage of the weapon, in most cases it will be +-50% this value.
| 0
|-
| '''strengthApplied'''
| Add the attacking unit's strength to this weapon's damage.
| false
|-
| '''compatibleAmmo'''
| List of string IDs of the ammo items that can be loaded on this weapon. If none are specified, the weapon doesn't need ammo.
| -
|-
| '''damageType'''
| What type of [[damage]] does this weapon do:
* 0 - None
* 1 - Armor Piercing
* 2 - Incendiary
* 3 - High Explosive
* 4 - Laser
* 5 - Plasma
* 6 - Stun
* 7 - Melee
* 8 - Acid
* 9 - Smoke
'''NOTE:''' A damage type other than 0-9 will do nothing.
| 0
|-
| '''tuAuto'''
'''accuracyAuto'''
| The percentage (0-100%) of [[Time Units]] (from the soldier's total) required to fire an Auto Shot. If 0, the weapon does not have an Auto Shot.
The base accuracy (0-100%) applied to a soldier's [[Firing Accuracy]] when firing an Auto Shot.
| 0
0
|-
| '''tuSnap'''
'''accuracySnap'''
| The percentage (0-100%) of [[Time Units]] (from the soldier's total) required to fire a Snap Shot. If 0, the weapon does not have a Snap Shot.
The base accuracy (0-100%) applied to a soldier's [[Firing Accuracy]] when firing a Snap Shot.
| 0
0
|-
| '''tuAimed'''
'''accuracyAimed'''
| The percentage (0-100%) of [[Time Units]] (from the soldier's total) required to fire an Aimed Shot. If 0, the weapon does not have an Aimed Shot.
The base accuracy (0-100%) applied to a soldier's [[Firing Accuracy]] when firing an Aimed Shot.
| 0
0
|-
|-
| '''tuMelee'''
'''accuracyMelee'''
| The percentage (0-100%) of [[Time Units]] (from the soldier's total) required to do a melee attack (Hit). If 0, the weapon does not have a melee attack.
The base accuracy (0-100%) applied to a soldier's [[Melee Accuracy]] when doing a melee attack.
| 0
0
|-
| '''clipSize'''
| The amount of ammo stored in each weapon clip. If -1 is specified, this weapon has infinite ammo.
| 0
|-
| '''battleType'''
| Defines the weapon's behavior in the Battlescape:
* 0 - None (Geoscape-only item)
* 1 - [[Weapons|Firearm]]
* 2 - Ammo
* 3 - Melee
* 4 - [[Grenade]]
* 5 - [[Proximity Grenade]]
* 6 - [[Medi-Kit (EU)|Medi-Kit]]
* 7 - [[Motion Scanner]]
* 8 - [[Mind Probe]]
* 9 - [[Psi-Amp]]
* 10 - [[Electro-flare]]
* 11 - Corpse
| 0
|-
| '''twoHanded'''
| Is this weapon two-handed? If true, incurs an accuracy penalty if used with both hands occupied. Note that the handsprite of a twoHanded item is also drawn at a slightly different position than a one handed item.
| false
|-
| '''waypoint'''
| Does this weapon use waypoints? (eg. [[Blaster Launcher]]). Can also be used to make ammo items use the waypoint system.
| false
|-
| '''fixedWeapon'''
| Is this weapon fixed? (it's part of a unit, eg. tanks and terrorist units)
| false
|-
| '''invWidth'''
| Item width in a soldier's inventory (in grid units).
| 1
|-
| '''invHeight'''
| Item height in a soldier's inventory (in grid units).
| 1
|-
| '''painKiller'''
| Amount of painkillers contained in a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''heal'''
| Amount of heal's contained in a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''stimulant'''
| Amount of stimulants contained in a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''woundRecovery'''
| Amount of [[Fatal Wounds]] treated by each heal of a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''healthRecovery'''
| Amount of [[Health]] recovered by each heal of a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''stunRecovery'''
| Amount of [[Stun]] removed by each stimulant of a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''energyRecovery'''
| Amount of [[Energy]] recovered by each stimulant of a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''tuUse'''
| Amount of [[Time Units]] required to use this item (for non-offensive items). It's a flat rate if '''flatRate''' is true, otherwise it's a percentage (0-100%).
| 0
|-
| '''recoveryPoints'''
| [[Score]] gained for recovering this alien artifact.
| 0
|-
| '''armor'''
| How much damage is needed to destroy this item on the ground.
| 20
|-
| '''recover'''
| Is this item recoverable? (gets transported to the X-COM base on mission success)
| true
|-
| '''turretType'''
| Sprite ID from [[TANKS.PCK]] of the turret to assign to this tank:
* 0 - [[Tank/Cannon]]
* 1 - [[Tank/Rocket Launcher]]
* 2 - [[Tank/Laser Cannon]]
* 3 - [[Hovertank/Plasma]]
* 4 - [[Hovertank/Launcher]]
| -1
|-
| '''liveAlien'''
| Does this item represent a live alien? (counts towards [[Alien Containment]])
| false
|-
| '''blastRadius'''
| Size of the projectile explosions. 0 for no explosion. -1 to automatically calculate based on weapon power and damage type (actual '''blastRadius''' currently is capped due [[Explosions#Playing_With_Fire|Explosion calculations]]).
| -1
|-
| '''flatRate'''
| If true, then TU costs for this weapon are a flat rate (instead of a percentage of unit TUs).
| false
|-
| '''arcingShot'''
| Does this weapon fire in an arc?
| false
|-
| '''attraction'''
| Represents how likely an alien is to pick up this item. Values below 5 will be ignored (by design).
| 0
|-
| '''maxRange'''
| Maximum range at which this weapon can operate.
| 200
|-
| '''aimRange'''
| Maximum effective range with this weapon before which range-based dropoff occurs.
| 200
|-
| '''snapRange'''
| Maximum effective range with snap shot before which range-based dropoff occurs. (ufoextender accuracy only)
| 15
|-
| '''autoRange'''
| Maximum effective range with auto shot before which range-based dropoff occurs. (ufoextender accuracy only)
| 7
|-
| '''minRange'''
| Range-based dropoff will work in reverse for ranges below this.
| 0
|-
| '''dropoff'''
| The value by which the accuracy lowers for each tile after (or before) the thresholds above.
| 2
|-
| '''bulletSpeed'''
| How much faster (or slower, if you use a negative number) is a projectile fired from this weapon compared to the average.
| 0
|-
| '''autoShots'''
| How many auto shots does this weapon fire.
| 3
|-
| '''shotgunPellets'''
| Number of projectiles fired per unit of ammunition. (note: due to engine limitations it is currently impossible to draw multiple projectiles in flight.)
| 0
|-
| '''zombieUnit'''
| String ID of the unit used for zombification (eg. [[Chrysallid]]s turn units into [[Zombie]]s).
| none
|-
| '''meleeSound'''
| Sound ID from [[#Extra_Sounds|BATTLE.CAT]] played when this weapon attacks a target with melee.
| 39
|-
| '''meleeHitSound'''
| Sound ID from [[#Extra_Sounds|BATTLE.CAT]] played when this weapon HITS a target with melee.
| -1
|-
| '''meleeAnimation'''
| Sprite ID from HIT.PCK played when this weapon attacks a target with melee.
| 0
|-
| '''meleePower'''
| Damage this weapon will do when using melee. This only applies to Firearms, and is only available as stun damage. For normal melee weapons, use regular power and damage types.
| 0
|-
| '''LOSRequired'''
| Does this item require line of sight? (only applies to mind probes and psi-amps)
| false
|-
| '''skillApplied'''
| Is melee skill applied to the accuracy of an attack made with this object?
| true
|-
|}

=== UFOs ===

Defines one of the [[UFOs]] that invade Earth, listed in ''"ufos:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the UFO name.
| ''required''
|-
| '''size'''
| String ID of the UFO size.
| STR_VERY_SMALL
|-
| '''sprite'''
| Sprite ID from [[INTERWIN.DAT]] used to draw this UFO in the dogfight view and UFOpaedia.
don't try to add more images if you don't want to punch yourself in the face - use modsprite
| -1
|-
| '''modSprite'''
| Filename used to draw this UFO in the dogfight view and UFOpaedia.
| -
|-
| '''damageMax'''
| Maximum amount of damage this UFO can take. If the UFO takes 50% damage, it crash lands. If it takes 100% damage, it is destroyed.
| 0
|-
| '''speedMax'''
| Maximum speed in nautical miles.
| 0
|-
| '''accel'''
| Aceeleration value shown in the UFOpaedia.
| 0
|-
| '''power'''
| Damage power of this UFO's weapon in dogfights.
| 0
|-
| '''range'''
| Maximum range of this UFO's weapon in dogfights (in meters).
| 0
|-
| '''score'''
| [[Score]] gained when this UFO is destroyed, or half this score if it crash lands.
| 0
|-
| '''reload'''
| Time the UFO's weapon takes to fire between each shot.
| 0
|-
| '''breakOffTime'''
| Minimum amount of time for the UFO to be able to break off of a dogfight.
| 0
|-
| '''battlescapeTerrainData'''
| [[#Terrains|Terrain]] associated to this UFO in Battlescape missions.
| ''required''
|-
|}

=== Inventory Sections ===

Defines one of the sections of the [[Inventory TU Table|Battlescape inventory]] (eg. Backpack), listed in ''"invs:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the inventory name.
| ''required''
|-
| '''x'''
'''y'''
| Pixel coordinates of this section on the inventory screen.
| 0
0
|-
| '''type'''
| Type of this section:
* 0 = Slot section, can contain as many items as will fit on the slots.
* 1 = Hand section, can only contain one item regardless of size.
* 2 = Ground section, can contain infinite items.
| 0
|-
| '''slots'''
| List of the grid slots (''[x, y]'') that this section is composed of. For example, to make a 2x2 section, you would have ''[0, 0] [0, 1] [1, 0] [1, 1]''.
| -
|-
| '''costs'''
| List of [[Time Units]] costs to move an item from this section to another one (eg. ''STR_BACKPACK: 16'' means it will cost 16 TUs to move an item from this section to the Backpack).
| -
|-
|}

=== Terrains ===

Defines one of the [[TERRAIN|terrains]] used to generate a Battlescape map, listed in "terrains:".

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''name'''
| String ID of the terrain name.
| ''required''
|-
| '''largeBlockLimit'''
| Maximum amount of large blocks that can be used on map generation.
| 0
|-
| '''textures'''
| List of [[TEXTURE.DAT|Geoscape textures]] that correspond to this terrain.
| -
|-
| '''hemisphere'''
| Geoscape hemisphere associated with this terrain:
* -1 - Northern hemisphere.
* 0 - Both hemispheres.
* 1 - Southern hemisphere.
| 0
|-
| '''mapDataSets'''
| List of filenames (each with matching [[MCD]]/[[Image Formats#PCK|PCK/TAB]] files) that contain the tiles of this terrain.
| -
|-
| '''mapBlocks'''
| List of map blocks (see below) that are used for generating a map.
| -
|-
| '''roadTypeOdds'''
| Odds as a % of generating each type of road (E-W Road, N-S Road, Crossing) odds for crossing are: 100 - EW - NS.
| [0 0]
|-|-
| '''civilianTypes'''
| List of units to use as civilians for this mission.
| [MALE_CIVILIAN, FEMALE_CIVILIAN]
|-
|}

==== Map Blocks ====

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''name'''
| Filename of the [[MAPS|map]].
| ''required''
|-
| '''width'''
| Width of this map block in Battlescape grid units.
| 0
|-
| '''length'''
| Length of this map block in Battlescape grid units.
| 0
|-
| '''height'''
| Height of this map block in Battlescape grid units.
| 1
|-
| '''type'''
| Type of this map block:
* -1 - Undefined
* 0 - Default
* 1 - Landing Zone (for placing X-COM / alien craft)
* 2 - E-W Road (for city maps)
* 3 - N-S Road (for city maps)
* 4 - Road Crossing (for city maps)
* 5 - Dirt (for filling empty base blocks)
* 6 - X-COM spawn point (for [[Alien Base]] / [[Cydonia]] missions)
* 7 - [[Alien Base]] Target
* 8 - [[Cydonia]] Target
| -1
|-
| '''subType'''
| Sub-type of this map block (see '''type''').
| -1
|-
| '''frequency'''
| Frequency of this block in a map.
| 1
|-
| '''maxCount'''
| Maximum amount of times this block can be used in a map. If -1 there is no limit.
| -1
|}

*'''frequency''' defines the odds of the map appearing on the map
** The value assigned (default: 1) is used in ''x/n'', which defines the probability of being chosen.
** ''x'' is the integer defined for the map block's frequency and ''n'' is the combined total of probabilities for all the map types combined.
** This property can only be used in type 0 map blocks.
*'''maxCount''' is the maximum number of times it can be used.
** The value assigned is also used in ''x/n'' to determine the probability of being chosen.
** Each use reduces ''x'' by -1, with the caveat that being used as a Landing Zone type will not reduce the x value since it could result in no available Landing Zones.
** This property can only be used in type 0 map blocks.
* '''hemisphere''' only applies to UFO missions, not Terror ones.
*'''width/length''' defines the size of the map
** be aware that the mapview "width"-label is the openxcom ruleset length parameter
** be aware that the mapview "length"-label is the openxcom ruleset width parameter

==== Guidelines/Tips ====
* All maps with an XCOM/Alien craft require at least one type 1 map block. This map block can only contain ground tiles (no walls or objects), otherwise the game will crash or the walls/objects will be removed.
* All Terror terrains (listed under STR_TERROR_MISSION) require at least 1 map block of '''Types''' 2, 3 and 4 (for a total of 3 maps, which are required to place roads) and the corresponding '''roadTypeOdds''' added to the ruleset.
* If there isn't any map blocks designed as roads since you want to keep your terrain 'random', this can be circumvented by designating all 10x10 map blocks, excluding the one(s) used for the XCOM craft, as either '''Type''' 2, 3 and 4 and by defining their '''subType''' to 0. The game will then randomly choose between the map blocks for each type used in the roads, making them map more random.

=== Armor ===

Defines a Battlescape unit's [[armor]] as well as visual representation (so every unit has an armor), listed in ''"armors:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the armor name.
| ''required''
|-
| '''spriteSheet'''
| Sprite sheet from [[UNITS]] used to draw a unit wearing this armor.
| -
|-
| '''spriteInv'''
| Sprite used for the [[Inventory Backgrounds]] of a unit wearing this armor.
| -
|-
| '''corpseBattle'''
| List of string IDs of the corpse [[#Items|items]] generated when a unit wearing this armor is killed (one per unit tile) on the Battlescape.
| -
|-
| '''corpseGeo'''
| String ID of the corpse [[#Items|item]] associated with this unit on the Geoscape.
| -
|-
| '''storeItem'''
| String ID of the [[#Items|item]] that represents this armor in [[Base Stores]] for equipping.
| -
|-
| '''weight'''
| Physical weight of the armor when worn
| 6
|-
| '''stats'''
| like soldier stats (see below) but these are treated as stat bonuses for wearing the specific armor.
| -
|-
| '''frontArmor'''
| Protection provided on the front of the unit.
| 0
|-
| '''sideArmor'''
| Protection provided on the sides of the unit.
| 0
|-
| '''rearArmor'''
| Protection provided on the rear of the unit.
| 0
|-
| '''underArmor'''
| Protection provided under the unit (eg. from explosions).
| 0
|-
| '''drawingRoutine'''
| Drawing routine used to put together the body parts in the unit's '''spriteSheet''':
* 0 = [[Soldier]], [[Sectoid]]
* 1 = [[Floater]]
* 2 = [[HWP]]
* 3 = [[Cyberdisk]]
* 4 = [[Civilian]], [[Ethereal]]
* 5 = [[Sectopod]], [[Reaper]]
* 6 = [[Snakeman]]
* 7 = [[Chryssalid]]
* 8 = [[Silacoid]]
* 9 = [[Celatid]]
* 10 = [[Muton]]
| 0
|-
| '''movementType'''
| Type of movement provided by this armor:
* 0 = Walking
* 1 = Flying
* 2 = Sliding (no walking animation)
it also defines the body of an tank (32-images) in your spriteSheet or the change in sprites while flying using a flying armour see: [[TANKS.PCK]], [[XCOM_2.PCK]]
| 0
|-
| '''damageModifier'''
| List of decimal damage modifiers (1.0 = 100%) this armor applies to each damage type (see [[#Items|Items section]]) received. Modifiers must be specified for all damage types, in this order:
* None
* Armor Piercing
* Incendiary
* High Explosive
* Laser
* Plasma
* Stun
* Melee
* Acid
* Smoke
|
- 1.0 
- 1.0 
- 1.0 
- 1.0 
- 1.0 
- 1.0 
- 1.0 
- 1.0 
- 1.0 
- 1.0
|-
| '''size'''
| Size of the unit wearing this armor, in Battlescape grid units. Every unit is square, so a size of 2 means 2x2.
| 1
|-
| '''loftempsSet'''
| List of [[LOFTEMPS]] IDs (one per unit tile, so a 1x1 unit has 1, a 2x2 unit has 4, etc.) used to represent a unit wearing this armor in 3D space.
| -
|-
| '''loftemps'''
| loftemps is a deprecated option that only works for 1x1 sized units.
| -
|}

=== Player Units (Soldiers) ===

Defines a [[soldier]] recruited by X-COM, listed in ''"soldiers:"''. Currently only one soldier unit type (''XCOM'') is supported.

Unit stats are represented as follows:
* [[Time Units|tu]]
* [[Energy|stamina]]
* [[Health|health]]
* [[Bravery|bravery]] (always a multiple of 10)
* [[Reactions|reactions]]
* [[Firing Accuracy|firing]]
* [[Throwing Accuracy|throwing]]
* [[Strength|strength]]
* [[Psi Strength|psiStrength]]
* [[Psi Skill|psiSkill]]
* [[Melee Accuracy|melee]] (not visible)

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the soldier name.
| ''required''
|-
| '''minStats'''
| Minimum values used to generate the soldier's [[Starting Stats]]. In this case, ''psiSkill'' is treated as the initial stat (not generated).
| -
|-
| '''maxStats'''
| Maximum values used to generate the soldier's [[Starting Stats]]. In this case, ''psiSkill'' is treated as the minimum value for the first month of psi training (actual value is 100%-150%).
| -
|-
| '''statCaps'''
| Maximum stats this soldier can gain through [[Experience]]. '''NOTE:''' A stat will still go over the limit once, and then will no longer increase (see [[Experience#Regarding Caps|Regarding Caps]]).
| -
|-
| '''armor'''
| String ID of the [[#Armor|armor]] this soldier uses by default.
| -
|-
| '''standHeight'''
| Height of this soldier when standing.
| 0
|-
| '''kneelHeight'''
| Height of this soldier when kneeling.
| 0
|-
| '''floatHeight'''
| Distance between the bottom of this unit and the ground.
| 0
|}

=== AI Units (Aliens/Civilians) ===

Defines an [[Alien Life Forms|alien]] (enemy) or [[civilian]] (neutral) unit, listed in ''"units:"''. Every different alien rank is a different unit, since they have completely different stats. Unit stats are represented as follows:
* [[Time Units|tu]]
* [[Energy|stamina]]
* [[Health|health]]
* [[Bravery|bravery]] (always a multiple of 10)
* [[Reactions|reactions]]
* [[Firing Accuracy|firing]]
* [[Throwing Accuracy|throwing]]
* [[Strength|strength]]
* [[Psi Strength|psiStrength]]
* [[Psi Skill|psiSkill]]
* [[Melee Accuracy|melee]] (not visible)

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the unit name.
| ''required''
|-
| '''race'''
| String ID of the unit race (for alien units).
| -
|-
| '''rank'''
| String ID of the unit rank (for alien units).
| -
|-
| '''stats'''
| Battlescape stats of this unit.
| -
|-
| '''armor'''
| String ID of the [[#Armor|armor]] this unit uses by default.
| -
|-
| '''standHeight'''
| Height of this unit when standing.
| 0
|-
| '''floatHeight'''
| Distance between the bottom of this unit and the ground.
| 0
|-
| '''value'''
| [[Score]] this unit is worth.
| 0
|-
| '''deathSound'''
| Sound ID from [[#Extra_Sounds|BATTLE.CAT]] played when this unit dies.
| -1
|-
| '''aggroSound'''
| Sound ID from [[#Extra_Sounds|BATTLE.CAT]] played when this unit aggros.
| -1
|-
| '''moveSound'''
| Sound ID from [[#Extra_Sounds|BATTLE.CAT]] played when this unit moves.
| -1
|-
| '''intelligence'''
| Intelligence of this unit's AI. The higher the value, the longer this unit remembers player troops between turns.
| 0
|-
| '''aggression'''
| Aggression of this unit's AI. The higher the value, the more ruthless the unit, the more likely to make a frontal assault. Less aggressive units tend to set up ambushes.
Vanilla values are:
* 0 = mostly passive
* 1 = balanced
* 2 = mostly aggresive
| 0
|-
| '''energyRecovery'''
| Energy recovered by the unit each turn (needs verification)
| 40 (?)
|-
| '''specab'''
| Special ability of this unit:
* 0 = None
* 1 = [[Cyberdisc|Explodes on Death]]
* 2 = [[Bio-Drone|Burns Floor]]
* 3 = [[Zombie|Respawns on Death]]
| 0
|-
| '''spawnUnit'''
| String ID of the unit used to respawn on death (eg. [[Zombie]]s respawn as [[Chrysallid]]s).
| -
|-
| '''livingWeapon'''
| Is this unit a living weapon? (only attacks with a '''fixedWeapon''')
| false
|-
|}

=== Alien Races ===

Defines a [[Alien Life Forms|race]] used in [[Alien Missions]], listed in ''"alienRaces:"''. Heavily tied with deployment data.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''id'''
| String ID of the alien race name.
| ''required''
|-
| '''members'''
| Alien crew associated with this alien race (eg. race units + terrorist units), defined by a list of unit string IDs. Order here will define rank in terms of deployment. generally speaking the order is:
* 0 - Commander
* 1 - Leader
* 2 - Engineer
* 3 - Medic
* 4 - Navigator
* 5 - Soldier
* 6 - Terrorist 1
* 7 - Terrorist 2
but of course, not all races have all ranks, so the "fill in" rank would be listed multiple times (see ethereals).
| -
|-
| '''retaliation'''
| retaliation enables/disables the race for retaliation missions.
| ''True''
|-
|}

=== Alien Deployments ===

Defines a Battlescape deployment data used in [[Alien Missions]] (such as alien and map configurations), listed in ''"alienDeployments:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the deployment name.
| ''required''
|-
| '''width'''
| Width of the Battlescape map in grid units.
| 0
|-
| '''length'''
| Length of the Battlescape map in grid units.
| 0
|-
| '''height'''
| Vertical height of the Battlescape map in grid units.
| 0
|-
| '''terrains'''
| list of string IDs of the [[#Terrains|terrain]] to choose from to generate this map. This is not used for UFO sites where the terrain comes from the Geoscape.
| -
|-
| '''shade'''
| Shade of the map (0-15, where 0 is full daytime and 15 is full nighttime). This is not used for UFO sites where the shade comes from the Geoscape.
| 0
|-
| '''nextStage'''
| String ID of the next deployment stage to use after this one, for multi-stage missions.
| -
|-
| '''data'''
| List of deployment data for each alien rank on this mission (see below).
| -
|}

Notes:
* '''terrains''' can also be used with UFOs, with the game using instead the listed terrain rather than the location of the UFO on Geoscape.
==== Deployment Data ====

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''alienRank'''
| [[Alien Rank|Rank]] associated with this deployment data, as defined by the order of the race in question (see above)
| ''required''
|-
| '''lowQty'''
| Minimum quantity of aliens to spawn on beginner/experienced.
| 0
|-
| '''highQty'''
| Minimum quantity of aliens to spawn on superhuman. (minimum quantity for veteran/genius is the median of this and the previous value)
| 0
|-
| '''dQty'''
| Delta in Quantity. ie: random number of aliens to spawn on top of the minimum (all difficulties).
| 0
|-
| '''percentageOutsideUfo'''
| Percentage (0-100%) of aliens to spawn outside in UFO sites.
| 0
|-
| '''itemSets'''
| Three lists (one for each alien technology level) of [[#Items|items]] (string IDs) for the aliens to equip.
| ''required''
|-
|}

=== Research ===

Defines a [[Research|research topic]] that X-COM scientists can investigate, listed in ''"research:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''name'''
| String ID of the research project's name (or item, if a '''lookup''' is defined).
| ''required''
|-
| '''lookup'''
| String ID of the research project's display name and UFOPaedia article reference.
| -
|-
| '''cost'''
| Number of man hours (on average) required to complete this project.
| 0
|-
| '''points'''
| [[Score]] earned for completing this project.
| 0
|-
| '''needItem'''
| Does this project require an [[#Items|item]] of the same name?
| false
|-
| '''dependencies'''
| List of research projects that can unlock access to this one. If the full list is researched, or if one of the projects on the list "unlocks" this one, it becomes available.
| -
|-
| '''unlocks'''
| List of research projects unlocked, regardless of other dependencies, but not requirements, by completing this project (for example, any live alien unlocks "alien origins").
| -
|-
| '''requires'''
| List of research projects unilaterally required before this project can be unlocked (for example, "the martian solution" will not even be considered for unlocking until AFTER "alien origins" is completed).
| -
|-
| '''getOneFree'''
| List of "bonus" research projects that may be granted when completing this project (for example, alien medics will give you information on other alien races). Only applies to living aliens.
| -
|-
|}

=== Manufacture ===

Defines a [[Manufacture|manufacture project]] that X-COM engineers can produce, listed in ''"manufacture:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''name'''
| String ID of the manufacturing project's name (and the item it produces).
| ''required''
|-
| '''category'''
| String ID of the manufacturing project's category.
| -
|-
| '''requires'''
| List of [[#Research|topics]] (string IDs) that must be researched to unlock this project. If none are specified, this project is unlocked from the start.
| -
|-
| '''space'''
| Amount of [[Workshop]] space required to begin this project.
| 0
|-
| '''time'''
| Number of man hours (on average) required per item.
| 0
|-
| '''cost'''
| Monetary deduction per item manufactured.
| 0
|-
| '''requiredItems'''
| List of [[#Items|items]] required and consumed per item manufactured.
| -
|-
| '''producedItems'''
| List of [[#Items|items]] produced per each item consumed. If not specified, defaults to 1 item with the same string ID as the manufacture.
| 1
|-
|}

=== UFOpaedia Article ===

Defines an article in the in-game [[UFOpaedia]], listed in ''"ufopaedia:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''id'''
| String ID of the article name. This must match the ID of the object associated with this article, if applicable.
| ''required''
|-
| '''title'''
| String ID of the article title. If omitted, the '''id''' is used.
| -
|-
| '''type_id'''
| Type of this article:
* 0 = Unknown
* 1 = [[Craft]]
* 2 = [[Craft Armaments]]
* 3 = [[HWP]]
* 4 = [[Equipment (EU)|Equipment]]
* 5 = [[Armour]]
* 6 = [[Base Facilities]]
* 7 = Text & Image (eg. [[Alien Life Forms]], [[UFO Components]])
* 8 = Text (eg. [[Alien Research]])
* 9 = [[UFO]]
| 0
|-
| '''section'''
| String ID of the UFOpaedia section this article belongs in.
| -
|-
| '''requires'''
| List of [[#Research|topics]] (string IDs) that must be researched to unlock this article. If none are specified, this article is unlocked from the start.
| -
|-
| '''image_id'''
| Filename of the [[UP001.SPK-UP042.SPK|background image]] displayed on this article, if applicable.
| -
|-
| '''text'''
| String ID of the description displayed on this article.
| -
|-
| '''text_width'''
| Maximum width of the text displayed, only applicable to ''Text & Image'' articles.
| 0
|-
| '''rect_stats'''
| Rectangle ('''x''', '''y''', '''width''', '''height''') of the stats text on the screen, only applicable to ''Craft'' articles.
| 0
|-
| '''rect_text'''
| Rectangle ('''x''', '''y''', '''width''', '''height''') of the description text on the screen, only applicable to ''Craft'' articles.
| 0
|-
| '''weapon'''
| String ID of the weapon, only applicable to ''HWP'' articles.
| -
|}

=== UFO Trajectories ===

Defines a trajectory carried out by an UFO during an [[#Alien Missions|alien mission]], listed in ''"ufoTrajectories:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''id'''
| String ID of the trajectory name.
| ''required''
|-
| '''groundTimer'''
| Amount of seconds for the UFO to spend on Ground waypoints.
| 0
|-
| '''waypoints'''
| List of waypoints for the UFO to traverse, defined as ''[zone, altitude, speed]''. 
'''zone''': Globe zone where the waypoint is located. 
'''altitude''': UFO altitude after reaching this waypoint:
* 0 - Ground
* 1 - Very Low
* 2 - Low
* 3 - High
* 4 - Very High
'''speed''': UFO speed after reaching this waypoint, as a percentage (0-100%) of its maximum speed.
| -
|}

=== Alien Missions ===

Defines an [[Alien Missions|alien mission]] carried out by UFOs on the Geoscape, listed in ''"alienMissions:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the mission type.
| ''required''
|-
| '''points'''
| [[Score]] allocated to aliens for successfully completing this mission.
| 0
|-
| '''raceWeights'''
| List of alien races likely to carry out this mission, and the % chance of them being allocated to this mission, listed by "number of months after game beginning".
| ''required''
|-
| '''waves'''
| List of UFO waves to spawn as this mission progresses, as described below.
| ''required''
|}

==== Waves ====

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''ufo'''
| String ID of the [[#UFOs|UFO]] to spawn.
| ''required''
|-
| '''count'''
| Number of UFOs to spawn.
| 0
|-
| '''trajectory'''
| String ID of the [[#UFO Trajectories|trajectory]] for this UFO to use when entering Earth's atmosphere.
| ''required''
|-
| '''timer'''
| How long after the previous wave should this wave arrive? (in seconds)
| 0
|-
|}

=== Alien Item Levels ===

This is a list of item level probabilities, with a number between 0 and 2 representing an item level from plasma pistols to heavy plasmas, as defined in the deployments, expressing a 10% probability for that item level being used.

0 = first set (plasma pistol/clip)
1 = second set (plasma rifle/clip)
2 = third set (heavy plasma/clip)

For example:
[ 2, 0, 0, 0, 0, 0, 0, 1, 1, 1 ]
would represent a 60% chance for pistols, 30% rifles, and 10% heavy weapons. 
Note that the order does not matter, but the length DOES. each line MUST have 10 digits.

The above can be confusing. There are 10 fields; each number represents 10%. 
There are six instances of '0'. 6x10% = 60% chance of plasma pistol 
There are three instances of '1'. 3x10% = 30% chance of plasma rifle 
There is only one instance of '2'. 1x10% = 10% chance of heavy plasma 

Each line represents a month after the beginning of the game, and there is no limit to the number defined. 
OpenXCom will use the most recently available item level in the event the game goes on forever.

=== Extra Sprites ===

Adds or replaces sprites in an existing [[Image Formats|X-COM image file]], listed in ''"extraSprites:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| Filename of the original/new image to modify.
| ''required''
|-
| '''width'''
'''height'''
| Size of the sprite(s) in pixels.
| 0
0
|-
| '''singleImage'''
| Is the image file just a single sprite (true) or a spritesheet (false)?
| false
|-
| '''subX'''
'''subY'''
| Size of the subdivision in pixels. If a subdivision is specified, then the image file is divided into chunks to form the sprites (eg. spritesheets).
| 0
0
|-
| '''files'''
| List of the new sprites to add/replace, listed as ''spriteID: filename''.
| -
|}

Example:
- type: GIANTBUNNY.PCK
width: 32
height: 40
files:
0: Resources/Bunny/Bunny00.png
1: Resources/Bunny/Bunny01.bmp
2: Resources/Bunny/Bunny02.gif

=== Extra Sounds ===

Adds or replaces sounds in an existing [[SOUND|X-COM sound file]], listed in ''"extraSounds:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| ID of the original sound file to modify:
* BATTLE.CAT - Battlescape sounds, corresponds to ''SOUND1.CAT'' or ''SAMPLE2.CAT'' (55 sounds).
* INTRO.CAT - Intro sounds, corresponds to ''INTRO.CAT'' or ''SAMPLE3.CAT'', probably best not to mess with these.
* GEO.CAT - Geoscape sounds, corresponds to ''SOUND2.CAT'' or ''SAMPLE.CAT'' (14 sounds).
| ''required''
|-
| '''files'''
| List of the new sounds to add/replace, listed as ''soundID: filename''.
| -
|}

Example:
- type: BATTLE.CAT
files:
55: Resources/Sounds/sample.wav

=== Extra Strings ===

Adds or replaces text strings in an existing [[Translations (OpenXcom)|OpenXcom language file]], listed in ''"extraStrings:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| Filename of the original language file to modify, sans extension.
| ''required''
|-
| '''strings'''
| List of the new strings to add/replace, listed as ''stringID: text''.
| -
|}

Example:
- type: en-US
strings:
STR_SNIPER_RIFLE: Sniper Rifle
STR_SNIPER_RIFLE_CLIP: Sniper Rifle Clip
- type: en-GB
strings:
STR_SNIPER_RIFLE: Sniper Rifle
STR_SNIPER_RIFLE_CLIP: Sniper Rifle Clip
- type: de
strings:
STR_SNIPER_RIFLE: Scharfschützengewehr
STR_SNIPER_RIFLE_CLIP: Scharfschützengewehrmunition
- type: ru
strings:
STR_SNIPER_RIFLE: Снайперская винтовка
STR_SNIPER_RIFLE_CLIP: Магазин к снайп. винтовке

=== StatStrings ===

[[Statstrings]] are used for automatically renaming soldiers. They are case sensitive and they are processed in the order in which they are specified.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''string'''
| String to add to name.
| ''required''
|-
| '''psiStrength''' 
'''psiSkill''' 
'''bravery''' 
'''strength''' 
'''firing''' 
'''reactions''' 
'''stamina''' 
'''tu''' 
'''health''' 
'''throwing'''
| One or more stat ranges are ANDed together for success. Each range has a minVal and maxVal. Use YAML standard tilde (~) to indicate null. ((~) = 0 as minvalue; (~) =255 as maxvalue)
| -
|}

Example:
statStrings:
- string: "x"
psiStrength: [~, 30]
- string: "P"
psiStrength: [80, ~]
- string: "p"
psiStrength: [60, 79]
- string: "K"
psiSkill: [60, ~]
- string: "k"
psiSkill: [30, 59]
- string: "b"
bravery: [60, ~]
- string: "c"
bravery: [~, 10]
- string: "w"
strength: [~, 25]
- string: "Snpr"
firing: [60, ~]
reactions: [60, ~]
- string: "M"
firing: [70, ~]
- string: "m"
firing: [60, 69]
- string: "Sct"
reactions: [50, ~]
tu: [60, ~]
- string: "R"
reactions: [60, ~]
- string: "r"
reactions: [50, 59]

==References==
<references />

[[Category:OpenXcom]]

Ruleset Reference Nightly (OpenXcom)

2014-12-14T16:37:51Z

Falko: /* Armor */

A reference of all the customizable values of everything in a [[Rulesets (OpenXcom)|ruleset]], according to the latest nightly. This page should be updated as new versions become available in order to explain the changes from [[Ruleset Reference (OpenXcom)|version 1.0]].

Some guidelines:
* If a value is omitted from the ruleset, the default is used. You cannot omit ''required'' values.
* Text strings (eg. names) are represented by string IDs from the [[Translations (OpenXcom)|language files]]
* Numerical IDs (used for sprites, sounds, etc.) start at 0, not 1.
* Boolean (yes/no) values are represented by true/false.
* World coordinates are represented in degrees (see [[WORLD.DAT]]).
* Money amounts (prices, costs, etc.) are represented in dollars.
* All paths are '''case sensitive'''! If your ruleset uses external files, make sure that they named properly as described in ruleset.

Items are ordered as they come in the ruleset. To override this, you can specify a ''listOrder''. You can find the default listOrders in [[Ruleset List Order (OpenXcom)|Ruleset List Order]].

=== Globe ===

Defines the drawing of landmasses and borders on the globe.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''data'''
| Path name of file which contains polygon and texture information. (For example WORLD.DAT).
| -
|-
| '''polygons'''
| List of polygons drawn on the globe surface. A triangle consist of seven values: the first number defines the texture, followed by three pairs of (x,y) globe coordinates. Only polygons with 3 or 4 vertices are reliable shown on the globe = 7 or 9 values per entry.
| -
|-
| '''polylines'''
| List of border lines. Each list entry consist of a list of (x,y) globe coordinates.
| -
|}

=== Countries ===

Defines one of the [[Country Funding (EU)|funding nations]], listed in ''"countries:"''. They're used for activity graphs and player scoring.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the country name.
| ''required''
|-
| '''fundingBase'''
| Country's base funding, in thousands. The starting funding can be anywhere between 1x and 2x the base funding.
| 0
|-
| '''fundingCap'''
| Country's funding cap, in thousands. Once a country reaches this maximum, it will no longer increase its funding.
| 0
|-
| '''labelLon'''
'''labelLat'''
| Longitude and latitude coordinates of the country's label on the globe. This label is only shown when the globe is zoomed in and "detail" is turned on.
| 0.0
0.0
|-
| '''areas'''
| List of "rectangles" on the globe defined as [''lon1'' ''lat1'' ''lon2'' ''lat2'']. Any activity within these areas counts towards the country's graph activity and affects their opinion of the player.
| -
|}

=== Regions ===

Defines one of the [[Geoscape (EU)#World Regions/Countries|world regions]], listed in ''"regions:"''. They're used for base placement, activity graphs and mission spawning.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the region name.
| ''required''
|-
| '''cost'''
| Amount of money spent building an X-COM base in this region (first base is free).
| 0
|-
| '''areas'''
| List of "rectangles" on the globe defined as ''[lon1, lat1, lon2, lat2]''. Any activity within these areas counts towards the region's graph activity.
| -
|-
| '''cities'''
| List of cities belonging to this region. They will be displayed on the globe and used for terror site missions. Each city is defined by their '''lon''' and '''lat''' coordinates and a '''name''' string ID.
| -
|-
| '''regionWeight'''
| Weight of this region when selecting regions for alien missions.
| 0
|-
| '''missionWeights'''
| Weighted list of the different mission types for this region (eg. ''STR_ALIEN_RESEARCH: 14'').
| -
|-
| '''missionZones'''
| List of "rectangles" (''[lon1, lat1, lon2, lat2]'') defining the mission zones for this region. Mission zones are waypoints for UFO trajectories.
| -
|-
| '''missionRegion'''
| Spawn mission in this region instead (used for regions without land).
| -
|}

=== Base Facilities ===

Defines one of the [[Base Facilities (EU)|facilities]] that can be built in an X-COM base, listed in ''"facilities:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the facility name.
| ''required''
|-
| '''requires'''
| List of [[#Research|topics]] (string IDs) that must be researched to unlock this facility. If none are specified, this facility is unlocked from the start.
| -
|-
| '''spriteShape'''
| Sprite ID from [[BASEBITS.PCK]] used to draw the facility's outer shape in the Basescape and UFOpaedia.
| -1
|-
| '''spriteFacility'''
| Sprite ID from [[BASEBITS.PCK]] used to draw the facility's contents in the Basescape and UFOpaedia. Drawn on top of '''spriteShape'''.
| -1
|-
| '''lift'''
| Is this facility an [[Access Lift]]? All base facilities must be connected to the lift.
| false
|-
| '''hyper'''
| Is this facility a [[Hyperwave Decoder]]? Displays extra information for detected UFOs. Only valid for radar facilities.
| false
|-
| '''mind'''
| Is this facility a [[Mind Shield]]? Reduces the chance of UFOs finding your base. Does not stack.
| false
|-
| '''grav'''
| Is this facility a [[Grav Shield]]? Doubles the power of your base defenses. Does not stack.
| false
|-
| '''size'''
| Size of the facility, in grid units. Every facility is square, so a size of 1 means 1x1, 2 means 2x2, etc. Bigger facilities are made up of multiple sprites, for example a 2x2 facility will use 4 sprites for '''spriteShape''' and 4 sprites for '''spriteFacility''' (top-left, top-right, bottom-left, bottom-right).
| 1
|-
| '''buildCost'''
| Amount of money spent to build this facility in the base.
| 0
|-
| '''buildTime'''
| Amount of days it takes for this facility to be built.
| 0
|-
| '''monthlyCost'''
| Amount of money spent monthly for the maintenance of this facility.
| 0
|-
| '''storage'''
| Amount of storage space (for items) this facility provides. See [[Base Stores]].
| 0
|-
| '''personnel'''
| Amount of personnel (soldiers, scientsts, engineers) these quarters can contain.
| 0
|-
| '''aliens'''
| Amount of live aliens this facility can contain. Only checked if the ''alienContainmentLimitEnforced'' option is enabled.
| 0
|-
| '''crafts'''
| Amount of X-COM craft this facility can contain.
| 0
|-
| '''labs'''
| Amount of lab space this facility provides for research projects.
| 0
|-
| '''workshops'''
| Amount of workshop space this facility provides for manufacture projects.
| 0
|-
| '''psiLabs'''
| Amount of soldier space this facility provides for psionic training.
| 0
|-
| '''radarRange'''
| Maximum radar detection range of this facility, in nautical miles.
| 0
|-
| '''radarChance'''
| Chance (0-100%) of this radar detecting a UFO that enters its range.
| 0
|-
| '''defense'''
| Offensive power provided by this base defense against attacking UFOs.
| 0
|-
| '''hitRatio'''
| Chance (0-100) of the base defense hitting an attacking UFO.
| 0
|-
| '''fireSound'''
| Sound ID from [[#Extra_Sounds|GEO.CAT]] played when the base defense fires.
| -1
|-
| '''hitSound'''
| Sound ID from [[#Extra_Sounds|GEO.CAT]] played when the base defense hits a target.
| -1
|-
| '''mapName'''
| [[MAPS|Map]] associated to this facility in Battlescape base defenses.
| -
|-
|}

=== Crafts ===

Defines one of the [[Craft|X-COM crafts]] that go on interception missions, listed in ''"crafts:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the craft name.
| ''required''
|-
| '''requires'''
| List of [[#Research|topics]] (string IDs) that must be researched to unlock this craft. If none are specified, this craft is unlocked from the start.
| -
|-
| '''sprite'''
| Sprite ID from [[BASEBITS.PCK]] used to draw this craft in the Basescape and from [[INTICON.PCK]] used to draw the damage indicator in dogfights.
modders: the corresponding extrasprite file id for BASEBITS.PCK is sprite+33 INTICON.PCK contains a minimized icon id=sprite the file id for the dogfight image is sprite+11
| -1
|-
| '''fuelMax'''
| Maximum amount of fuel this craft can carry. Crafts use up fuel based on their speed while travelling.
| 0
|-
| '''damageMax'''
| Maximum amount of damage this craft can take. If this amount is exceeded, the craft is destroyed.
| 0
|-
| '''speedMax'''
| Maximum speed in nautical miles. Crafts travel at max speed when flying and half speed when patrolling.
| 0
|-
| '''accel'''
| Aceeleration value shown in the UFOpaedia.
| 0
|-
| '''weapons'''
| Amount of craft weapons this craft can equip. The UI can only display a max of 2 weapons.
| 0
|-
| '''soldiers'''
| Amount of soldiers this craft can carry.
| 0
|-
| '''maxItems'''
| Amount of items this craft can carry.
| 80
|-
| '''vehicles'''
| Amount of vehicles this craft can carry.
| 0
|-
| '''costBuy'''
| Amount of money spent for purchasing this craft. If set to 0, the craft will not be available in the Purchase/Recruit screen.
| 0
|-
| '''costRent'''
| Amount of money spent monthly for renting this craft. If set to 0, the craft is not on rental and won't count towards base maintenance.
| 0
|-
| '''costSell'''
| Amount of money gained for selling this craft.
| 0
|-
| '''refuelItem'''
| Item required for refuelling this craft. If no item is specified, the craft uses human fuel.
| 0
|-
| '''repairRate'''
| Amount of damage restored every hour while [[Repairs|Repairing]] in base.
| 1
|-
| '''refuelRate'''
| Amount of fuel restored every 30 mins while [[Refueling]] in base. If specified, a '''refuelItem''' is spent each time.
| 1
|-
| '''radarRange'''
| Detection range of the craft's radar in nautical miles. Every craft radar has a 100% detection chance.
| 600
|-
| '''transferTime'''
| Number of hours it takes to purchase/transfer this craft to a base.
| 0
|-
| '''score'''
| [[Score]] lost when this craft is destroyed.
| 0
|-
| '''spacecraft'''
| Can this craft go to [[Cydonia]]?
| false
|-
| '''battlescapeTerrainData'''
| [[#Terrains|Terrain]] associated to this craft in Battlescape missions.
| -
|}

=== Craft Weapons ===

Defines one of the [[Craft Armaments|weapons]] equipped by X-COM craft for shooting down UFOs, listed in ''"craftWeapons:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the weapon name.
| ''required''
|-
| '''sprite'''
| Sprite ID from [[BASEBITS.PCK]] used to draw the weapon in the Basescape and from [[INTICON.PCK]] used to draw the weapon in dogfights.
modders: the corresponding extrasprites file id for INTICON.PCK is sprite+5 and sprite+48 for BASEBITS.PCK
| -1
|-
| '''sound'''
| Sound ID from [[#Extra_Sounds|GEO.CAT]] played when this weapon fires.
| -1
|-
| '''damage'''
| Amount of damage this weapon does to enemy UFOs.
| 0
|-
| '''range'''
| Maximum range of this weapon in dogfights (in meters).
| 0
|-
| '''accuracy'''
| Chance (0-100%) of each shot hitting the enemy UFO.
| 0
|-
| '''reloadCautious'''
| Time this weapon takes to fire between each shot in ''Cautious Mode''.
| 0
|-
| '''reloadStandard'''
| Time this weapon takes to fire between each shot in ''Standard Mode''.
| 0
|-
| '''reloadAggressive'''
| Time this weapon takes to fire between each shot in ''Aggressive Mode''.
| 0
|-
| '''ammoMax'''
| Maximum amount of ammo this weapon can carry.
| 0
|-
| '''rearmRate'''
| Amount of ammo restored every 30 mins while the craft is [[Rearming]] in base. If specified, '''clip'''s are spent depending on their '''clipSize'''. If the '''clipSize''' of the specified ammo is 0, no '''clip'''s are spent.
| 1
|-
| '''projectileType'''
| Type of the weapon projectile, used for the projectile sprite in dogfights:
* 0 - [[Stingray]]
* 1 - [[Avalanche]]
* 2 - [[Cannon]]
* 3 - [[Fusion Ball]]
* 4 - [[Laser Cannon]]
* 5 - [[Plasma Beam]]
| 2
|-
| '''projectileSpeed'''
| Speed of the weapon projectile in dogfights.
| 0
|-
| '''launcher'''
| String ID of the [[#Items|item]] required to equip this weapon.
| -
|-
| '''clip'''
| String ID of the [[#Items|item]] required to rearm this weapon.
| -
|}

=== Items ===

Defines the Geoscape and Battlescape properties of an [[Equipment (EU)|item]] that can be stored in X-COM bases, listed in ''"items:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the internal item name.
| ''required''
|-
| '''name'''
| String ID of the displayed item name, for cases where it's different from the internal name. If omitted, '''type''' is used.
| -
|-
| '''requires'''
| List of [[#Research|topics]] (string IDs) that must be researched to unlock this item. If none are specified, this item is unlocked from the start. Soldiers can only use unlocked items in the Battlescape.
| -
|-
| '''size'''
| Space occupied by this item in [[Base Stores]]. Can be a decimal value.
| 0.0
|-
| '''costBuy'''
| Amount of money spent for purchasing this item. If set to 0, this item will not be available in the Purchase/Recruit screen.
| 0
|-
| '''costSell'''
| Amount of money gained for selling this item.
| 0
|-
| '''transferTime'''
| Number of hours it takes to purchase/transfer this item to a base.
| 24
|-
| '''weight'''
| [[Item_Weight|Weight]] occupied by this item in a soldier's inventory.
| 999
|-
| '''bigSprite'''
| Sprite ID from [[BIGOBS.PCK]] used to draw this item in a soldier's inventory and UFOpaedia.
| -1
|-
| '''floorSprite'''
| Sprite ID from [[FLOOROB.PCK]] used to draw this item on the floor of a Battlescape tile.
| -1
|-
| '''handSprite'''
| Sprite ID from [[HANDOB.PCK]] used to draw this item on a soldier's hand in the Battlescape.
modders: each handobject needs 8 images (8 directions) define the extrasprites accordingly
| 120
|-
| '''bulletSprite'''
| Sprite ID from ''BulletSprites.png'' used to draw this weapon's projectile on the Battlescape:
* 0 - [[Rocket Launcher]]
* 1 - [[Pistol]]
* 2 - [[Rifle]]
* 3 - [[Auto Cannon]]
* 4 - [[Heavy Cannon]]
* 5 - [[Laser Pistol]]
* 6 - [[Laser Rifle]]
* 7 - [[Heavy Laser]]
* 8 - [[Plasma Rifle|Plasma]]
* 9 - [[Small Launcher]]
* 10 - [[Blaster Launcher]]
for modders: the bulletsprite needs to be put into the extraSprites type "Projectiles" the bulletsprite can contain up to 35 3x3 images. The corresponding file id is 35*[bulletSprite]
| -1
|-
| '''fireSound'''
| Sound ID from [[#Extra_Sounds|BATTLE.CAT]] played when this weapon fires.
| -1
|-
| '''hitSound'''
| Sound ID from [[#Extra_Sounds|BATTLE.CAT]] played when this weapon hits a target.
| -1
|-
| '''hitAnimation'''
| Sprite ID from [[SMOKE.PCK]] used to draw the weapon's "hit explosion".
'''NOTE''': Do not define this value for melee/psi weapons, they use [[HIT.PCK]] and therefore meleeAnimation instead.
| 0
|-
| '''power'''
| Average damage of the weapon, in most cases it will be +-50% this value.
| 0
|-
| '''strengthApplied'''
| Add the attacking unit's strength to this weapon's damage.
| false
|-
| '''compatibleAmmo'''
| List of string IDs of the ammo items that can be loaded on this weapon. If none are specified, the weapon doesn't need ammo.
| -
|-
| '''damageType'''
| What type of [[damage]] does this weapon do:
* 0 - None
* 1 - Armor Piercing
* 2 - Incendiary
* 3 - High Explosive
* 4 - Laser
* 5 - Plasma
* 6 - Stun
* 7 - Melee
* 8 - Acid
* 9 - Smoke
'''NOTE:''' A damage type other than 0-9 will do nothing.
| 0
|-
| '''tuAuto'''
'''accuracyAuto'''
| The percentage (0-100%) of [[Time Units]] (from the soldier's total) required to fire an Auto Shot. If 0, the weapon does not have an Auto Shot.
The base accuracy (0-100%) applied to a soldier's [[Firing Accuracy]] when firing an Auto Shot.
| 0
0
|-
| '''tuSnap'''
'''accuracySnap'''
| The percentage (0-100%) of [[Time Units]] (from the soldier's total) required to fire a Snap Shot. If 0, the weapon does not have a Snap Shot.
The base accuracy (0-100%) applied to a soldier's [[Firing Accuracy]] when firing a Snap Shot.
| 0
0
|-
| '''tuAimed'''
'''accuracyAimed'''
| The percentage (0-100%) of [[Time Units]] (from the soldier's total) required to fire an Aimed Shot. If 0, the weapon does not have an Aimed Shot.
The base accuracy (0-100%) applied to a soldier's [[Firing Accuracy]] when firing an Aimed Shot.
| 0
0
|-
|-
| '''tuMelee'''
'''accuracyMelee'''
| The percentage (0-100%) of [[Time Units]] (from the soldier's total) required to do a melee attack (Hit). If 0, the weapon does not have a melee attack.
The base accuracy (0-100%) applied to a soldier's [[Melee Accuracy]] when doing a melee attack.
| 0
0
|-
| '''clipSize'''
| The amount of ammo stored in each weapon clip. If -1 is specified, this weapon has infinite ammo.
| 0
|-
| '''battleType'''
| Defines the weapon's behavior in the Battlescape:
* 0 - None (Geoscape-only item)
* 1 - [[Weapons|Firearm]]
* 2 - Ammo
* 3 - Melee
* 4 - [[Grenade]]
* 5 - [[Proximity Grenade]]
* 6 - [[Medi-Kit (EU)|Medi-Kit]]
* 7 - [[Motion Scanner]]
* 8 - [[Mind Probe]]
* 9 - [[Psi-Amp]]
* 10 - [[Electro-flare]]
* 11 - Corpse
| 0
|-
| '''twoHanded'''
| Is this weapon two-handed? If true, incurs an accuracy penalty if used with both hands occupied. Note that the handsprite of a twoHanded item is also drawn at a slightly different position than a one handed item.
| false
|-
| '''waypoint'''
| Does this weapon use waypoints? (eg. [[Blaster Launcher]]). Can also be used to make ammo items use the waypoint system.
| false
|-
| '''fixedWeapon'''
| Is this weapon fixed? (it's part of a unit, eg. tanks and terrorist units)
| false
|-
| '''invWidth'''
| Item width in a soldier's inventory (in grid units).
| 1
|-
| '''invHeight'''
| Item height in a soldier's inventory (in grid units).
| 1
|-
| '''painKiller'''
| Amount of painkillers contained in a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''heal'''
| Amount of heal's contained in a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''stimulant'''
| Amount of stimulants contained in a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''woundRecovery'''
| Amount of [[Fatal Wounds]] treated by each heal of a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''healthRecovery'''
| Amount of [[Health]] recovered by each heal of a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''stunRecovery'''
| Amount of [[Stun]] removed by each stimulant of a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''energyRecovery'''
| Amount of [[Energy]] recovered by each stimulant of a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''tuUse'''
| Amount of [[Time Units]] required to use this item (for non-offensive items). It's a flat rate if '''flatRate''' is true, otherwise it's a percentage (0-100%).
| 0
|-
| '''recoveryPoints'''
| [[Score]] gained for recovering this alien artifact.
| 0
|-
| '''armor'''
| How much damage is needed to destroy this item on the ground.
| 20
|-
| '''recover'''
| Is this item recoverable? (gets transported to the X-COM base on mission success)
| true
|-
| '''turretType'''
| Sprite ID from [[TANKS.PCK]] of the turret to assign to this tank:
* 0 - [[Tank/Cannon]]
* 1 - [[Tank/Rocket Launcher]]
* 2 - [[Tank/Laser Cannon]]
* 3 - [[Hovertank/Plasma]]
* 4 - [[Hovertank/Launcher]]
| -1
|-
| '''liveAlien'''
| Does this item represent a live alien? (counts towards [[Alien Containment]])
| false
|-
| '''blastRadius'''
| Size of the projectile explosions. 0 for no explosion. -1 to automatically calculate based on weapon power and damage type (actual '''blastRadius''' currently is capped due [[Explosions#Playing_With_Fire|Explosion calculations]]).
| -1
|-
| '''flatRate'''
| If true, then TU costs for this weapon are a flat rate (instead of a percentage of unit TUs).
| false
|-
| '''arcingShot'''
| Does this weapon fire in an arc?
| false
|-
| '''attraction'''
| Represents how likely an alien is to pick up this item. Values below 5 will be ignored (by design).
| 0
|-
| '''maxRange'''
| Maximum range at which this weapon can operate.
| 200
|-
| '''aimRange'''
| Maximum effective range with this weapon before which range-based dropoff occurs.
| 200
|-
| '''snapRange'''
| Maximum effective range with snap shot before which range-based dropoff occurs. (ufoextender accuracy only)
| 15
|-
| '''autoRange'''
| Maximum effective range with auto shot before which range-based dropoff occurs. (ufoextender accuracy only)
| 7
|-
| '''minRange'''
| Range-based dropoff will work in reverse for ranges below this.
| 0
|-
| '''dropoff'''
| The value by which the accuracy lowers for each tile after (or before) the thresholds above.
| 2
|-
| '''bulletSpeed'''
| How much faster (or slower, if you use a negative number) is a projectile fired from this weapon compared to the average.
| 0
|-
| '''autoShots'''
| How many auto shots does this weapon fire.
| 3
|-
| '''shotgunPellets'''
| Number of projectiles fired per unit of ammunition. (note: due to engine limitations it is currently impossible to draw multiple projectiles in flight.)
| 0
|-
| '''zombieUnit'''
| String ID of the unit used for zombification (eg. [[Chrysallid]]s turn units into [[Zombie]]s).
| none
|-
| '''meleeSound'''
| Sound ID from [[#Extra_Sounds|BATTLE.CAT]] played when this weapon attacks a target with melee.
| 39
|-
| '''meleeHitSound'''
| Sound ID from [[#Extra_Sounds|BATTLE.CAT]] played when this weapon HITS a target with melee.
| -1
|-
| '''meleeAnimation'''
| Sprite ID from HIT.PCK played when this weapon attacks a target with melee.
| 0
|-
| '''meleePower'''
| Damage this weapon will do when using melee. This only applies to Firearms, and is only available as stun damage. For normal melee weapons, use regular power and damage types.
| 0
|-
| '''LOSRequired'''
| Does this item require line of sight? (only applies to mind probes and psi-amps)
| false
|-
| '''skillApplied'''
| Is melee skill applied to the accuracy of an attack made with this object?
| true
|-
|}

=== UFOs ===

Defines one of the [[UFOs]] that invade Earth, listed in ''"ufos:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the UFO name.
| ''required''
|-
| '''size'''
| String ID of the UFO size.
| STR_VERY_SMALL
|-
| '''sprite'''
| Sprite ID from [[INTERWIN.DAT]] used to draw this UFO in the dogfight view and UFOpaedia.
don't try to add more images if you don't want to punch yourself in the face - use modsprite
| -1
|-
| '''modSprite'''
| Filename used to draw this UFO in the dogfight view and UFOpaedia.
| -
|-
| '''damageMax'''
| Maximum amount of damage this UFO can take. If the UFO takes 50% damage, it crash lands. If it takes 100% damage, it is destroyed.
| 0
|-
| '''speedMax'''
| Maximum speed in nautical miles.
| 0
|-
| '''accel'''
| Aceeleration value shown in the UFOpaedia.
| 0
|-
| '''power'''
| Damage power of this UFO's weapon in dogfights.
| 0
|-
| '''range'''
| Maximum range of this UFO's weapon in dogfights (in meters).
| 0
|-
| '''score'''
| [[Score]] gained when this UFO is destroyed, or half this score if it crash lands.
| 0
|-
| '''reload'''
| Time the UFO's weapon takes to fire between each shot.
| 0
|-
| '''breakOffTime'''
| Minimum amount of time for the UFO to be able to break off of a dogfight.
| 0
|-
| '''battlescapeTerrainData'''
| [[#Terrains|Terrain]] associated to this UFO in Battlescape missions.
| ''required''
|-
|}

=== Inventory Sections ===

Defines one of the sections of the [[Inventory TU Table|Battlescape inventory]] (eg. Backpack), listed in ''"invs:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the inventory name.
| ''required''
|-
| '''x'''
'''y'''
| Pixel coordinates of this section on the inventory screen.
| 0
0
|-
| '''type'''
| Type of this section:
* 0 = Slot section, can contain as many items as will fit on the slots.
* 1 = Hand section, can only contain one item regardless of size.
* 2 = Ground section, can contain infinite items.
| 0
|-
| '''slots'''
| List of the grid slots (''[x, y]'') that this section is composed of. For example, to make a 2x2 section, you would have ''[0, 0] [0, 1] [1, 0] [1, 1]''.
| -
|-
| '''costs'''
| List of [[Time Units]] costs to move an item from this section to another one (eg. ''STR_BACKPACK: 16'' means it will cost 16 TUs to move an item from this section to the Backpack).
| -
|-
|}

=== Terrains ===

Defines one of the [[TERRAIN|terrains]] used to generate a Battlescape map, listed in "terrains:".

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''name'''
| String ID of the terrain name.
| ''required''
|-
| '''textures'''
| List of [[TEXTURE.DAT|Geoscape textures]] that correspond to this terrain.
| -
|-
| '''hemisphere'''
| Geoscape hemisphere associated with this terrain:
* -1 - Northern hemisphere.
* 0 - Both hemispheres.
* 1 - Southern hemisphere.
| 0
|-
| '''mapDataSets'''
| List of filenames (each with matching [[MCD]]/[[Image Formats#PCK|PCK/TAB]] files) that contain the tiles of this terrain.
| -
|-
| '''mapBlocks'''
| List of map blocks (see below) that are used for generating a map.
| -
|-
| '''civilianTypes'''
| List of units to use as civilians for this mission.
| [MALE_CIVILIAN, FEMALE_CIVILIAN]
|-
|}

==== Map Blocks ====

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''name'''
| Filename of the [[MAPS|map]].
| ''required''
|-
| '''width'''
| Width of this map block in Battlescape grid units.
| 0
|-
| '''length'''
| Length of this map block in Battlescape grid units.
| 0
|-
| '''height'''
| Height of this map block in Battlescape grid units.
| 1
|-
| '''groups'''
| List (or single number) of groups this mapblock belongs to (used in mapscripts)
default usage:
* 0 - Default
* 1 - Landing Zone (for placing X-COM / alien craft) (used in addcraft/ufo command)
* 2 - E-W Road (for city maps) (used in addline command)
* 3 - N-S Road (for city maps) (used in addline command)
* 4 - Road Crossing (for city maps) (used in addline command)
| 0
|-
| '''items'''
| An array of items to add to this mapblock, an the positions to place them at.
| -1
|}

* '''hemisphere''' only applies to UFO missions, not Terror ones.
*'''width/length''' defines the size of the map
** be aware that the mapview "width"-label is the openxcom ruleset length parameter
** be aware that the mapview "length"-label is the openxcom ruleset width parameter

==== Guidelines/Tips ====
* All maps with an XCOM/Alien craft require at least one map block assigned to Group 1. This map block can only contain ground tiles (no walls or objects), otherwise the game will crash or the walls/objects will be removed.
* All Terror terrains (listed under STR_TERROR_MISSION) require the Groups of '''Types''' 2, 3 and 4 (for a total of 3 maps, which are required to place roads).

=== Map Scripts ===

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| name of the script
| ''required''
|-
| '''commands'''
| List of MapCommands
| -
|}

==== Map Command ====

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| Currently these commands are implemented:
* addBlock
* addLine
* addCraft
* addUFO
* digTunnel
* fillArea
* checkBlock
* removeBlock
* resize
depending on the command type some of the following parameters are needed
| ''required''
|-
| '''label'''
| A numeric label that can be used for conditional execution of commands.
Each label should be unique within the command list (0=default no need for uniqueness).
| 0
|-
| '''conditionals'''
| Defines the conditions that allows the execution of this command.
eg. [1, -4] means it will be executed if command with label 1 was a success and command with label 4 failed.
commands that are not yet executed are always in failed state.
| 0
|-
| '''executionChances'''
| the chance that this command will be executed (or fails)
| 100
|-
| '''executions'''
| this command will be executed multiple times with a value > 1
| 1
|-
| '''groups'''
| Defines the what mapblock are used within this command. Can be list of goups or a single number.
| 0
|-
| '''blocks'''
| Alternative to groups. Here we define a list of mapblocks that are used within this command.
| 0
|-
| '''rects'''
| A list of possible ranges where (random) placement/checks/removal can happen in a map.
Is a list of a list of four integers.
| ?
|-
| '''size'''
| size of mapblocks that can be placed/checked/removed within rects. Also used for resize command type.
| ?
|-
| '''freqs'''
| For a list of mapblocks (defined by blocks?) we can define distribution frequency here.
| 1
|-
| '''maxUses'''
| For a list of mapblocks (defined by blocks?) we can define the maximal amount a mapblock can be used here.
| -1
|-
| '''direction'''
| used for addLine command type. Values are both, horizontal or vertical. Typically defines the road type distribution.
| -1
|-
| '''tunnelData'''
| Parameter for digTunnel command type. Contains level (default: 0) and a list of MCD replacement rules (MCDReplacements)
| 0
|}

==== Guidelines/Tips ====
* The Mapscript is still somewhat in development

=== Armor ===

Defines a Battlescape unit's [[armor]] as well as visual representation (so every unit has an armor), listed in ''"armors:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the armor name.
| ''required''
|-
| '''spriteSheet'''
| Sprite sheet from [[UNITS]] used to draw a unit wearing this armor.
| -
|-
| '''spriteInv'''
| Sprite used for the [[Inventory Backgrounds]] of a unit wearing this armor.
| -
|-
| '''corpseBattle'''
| List of string IDs of the corpse [[#Items|items]] generated when a unit wearing this armor is killed (one per unit tile) on the Battlescape.
| -
|-
| '''corpseGeo'''
| String ID of the corpse [[#Items|item]] associated with this unit on the Geoscape.
| -
|-
| '''storeItem'''
| String ID of the [[#Items|item]] that represents this armor in [[Base Stores]] for equipping.
| -
|-
| '''weight'''
| Physical weight of the armor when worn
| 6
|-
| '''stats'''
| like soldier stats (see below) but these are treated as stat bonuses for wearing the specific armor.
| -
|-
| '''frontArmor'''
| Protection provided on the front of the unit.
| 0
|-
| '''sideArmor'''
| Protection provided on the sides of the unit.
| 0
|-
| '''rearArmor'''
| Protection provided on the rear of the unit.
| 0
|-
| '''underArmor'''
| Protection provided under the unit (eg. from explosions).
| 0
|-
| '''drawingRoutine'''
| Drawing routine used to put together the body parts in the unit's '''spriteSheet''':
* 0 = [[Soldier]], [[Sectoid]]
* 1 = [[Floater]]
* 2 = [[HWP]]
* 3 = [[Cyberdisk]]
* 4 = [[Civilian]], [[Ethereal]]
* 5 = [[Sectopod]], [[Reaper]]
* 6 = [[Snakeman]]
* 7 = [[Chryssalid]]
* 8 = [[Silacoid]]
* 9 = [[Celatid]]
* 10 = [[Muton]]
* 11 = [[Submersible Weapons Systems]]
* 12 = [[Hallucinoid]]
* 13 = [[Aquanauts]]
* 14 = [[Calcinite]], [[Deep One]], [[Gillman]], [[Lobster Man]], [[Tasoth]]
* 15 = [[Aquatoid]]
* 16 = [[Bio-Drone]]
* 17 = TFTD Civilians type A and [[Zombie_(TFTD)]]
* 18 = TFTD Civilians type B
* 19 = [[Tentaculat]]
* 20 = [[Triscene]]
* 21 = [[Xarquid]]
| 0
|-
| '''movementType'''
| Type of movement provided by this armor:
* 0 = Walking
* 1 = Flying
* 2 = Sliding (no walking animation)
it also defines the body of an tank (32-images) in your spriteSheet or the change in sprites while flying using a flying armour see: [[TANKS.PCK]], [[XCOM_2.PCK]]
| 0
|-
| '''damageModifier'''
| List of decimal damage modifiers (1.0 = 100%) this armor applies to each damage type (see [[#Items|Items section]]) received. Modifiers must be specified for all damage types, in this order:
* None
* Armor Piercing
* Incendiary
* High Explosive
* Laser
* Plasma
* Stun
* Melee
* Acid
* Smoke
|
- 1.0 
- 1.0 
- 1.0 
- 1.0 
- 1.0 
- 1.0 
- 1.0 
- 1.0 
- 1.0 
- 1.0
|-
| '''size'''
| Size of the unit wearing this armor, in Battlescape grid units. Every unit is square, so a size of 2 means 2x2.
| 1
|-
| '''loftempsSet'''
| List of [[LOFTEMPS]] IDs (one per unit tile, so a 1x1 unit has 1, a 2x2 unit has 4, etc.) used to represent a unit wearing this armor in 3D space.
| -
|-
| '''loftemps'''
| loftemps is a deprecated option that only works for 1x1 sized units.
| -
|-
| '''forcedTorso'''
| soldier sprites have female and male torsos. some armours reuse these sprites for flying/non flying torso without difference between genders. This can be controlled by the parameter: 0 = use genderrelated torso, 1 = use male torso, 2 = use female torso
| 0

|}

=== Player Units (Soldiers) ===

Defines a [[soldier]] recruited by X-COM, listed in ''"soldiers:"''. Currently only one soldier unit type (''XCOM'') is supported.

Unit stats are represented as follows:
* [[Time Units|tu]]
* [[Energy|stamina]]
* [[Health|health]]
* [[Bravery|bravery]] (always a multiple of 10)
* [[Reactions|reactions]]
* [[Firing Accuracy|firing]]
* [[Throwing Accuracy|throwing]]
* [[Strength|strength]]
* [[Psi Strength|psiStrength]]
* [[Psi Skill|psiSkill]]
* [[Melee Accuracy|melee]] (not visible)

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the soldier name.
| ''required''
|-
| '''minStats'''
| Minimum values used to generate the soldier's [[Starting Stats]]. In this case, ''psiSkill'' is treated as the initial stat (not generated).
| -
|-
| '''maxStats'''
| Maximum values used to generate the soldier's [[Starting Stats]]. In this case, ''psiSkill'' is treated as the minimum value for the first month of psi training (actual value is 100%-150%).
| -
|-
| '''statCaps'''
| Maximum stats this soldier can gain through [[Experience]]. '''NOTE:''' A stat will still go over the limit once, and then will no longer increase (see [[Experience#Regarding Caps|Regarding Caps]]).
| -
|-
| '''armor'''
| String ID of the [[#Armor|armor]] this soldier uses by default.
| -
|-
| '''standHeight'''
| Height of this soldier when standing.
| 0
|-
| '''kneelHeight'''
| Height of this soldier when kneeling.
| 0
|-
| '''floatHeight'''
| Distance between the bottom of this unit and the ground.
| 0
|-
| '''femaleFrequency'''
| The probability that a female soldier is hired.
| 50
|}

=== AI Units (Aliens/Civilians) ===

Defines an [[Alien Life Forms|alien]] (enemy) or [[civilian]] (neutral) unit, listed in ''"units:"''. Every different alien rank is a different unit, since they have completely different stats. Unit stats are represented as follows:
* [[Time Units|tu]]
* [[Energy|stamina]]
* [[Health|health]]
* [[Bravery|bravery]] (always a multiple of 10)
* [[Reactions|reactions]]
* [[Firing Accuracy|firing]]
* [[Throwing Accuracy|throwing]]
* [[Strength|strength]]
* [[Psi Strength|psiStrength]]
* [[Psi Skill|psiSkill]]
* [[Melee Accuracy|melee]] (not visible)

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the unit name.
| ''required''
|-
| '''race'''
| String ID of the unit race (for alien units).
| -
|-
| '''rank'''
| String ID of the unit rank (for alien units).
| -
|-
| '''stats'''
| Battlescape stats of this unit.
| -
|-
| '''armor'''
| String ID of the [[#Armor|armor]] this unit uses by default.
| -
|-
| '''standHeight'''
| Height of this unit when standing.
| 0
|-
| '''floatHeight'''
| Distance between the bottom of this unit and the ground.
| 0
|-
| '''value'''
| [[Score]] this unit is worth.
| 0
|-
| '''deathSound'''
| Sound ID from [[#Extra_Sounds|BATTLE.CAT]] played when this unit dies.
| -1
|-
| '''aggroSound'''
| Sound ID from [[#Extra_Sounds|BATTLE.CAT]] played when this unit aggros.
| -1
|-
| '''moveSound'''
| Sound ID from [[#Extra_Sounds|BATTLE.CAT]] played when this unit moves.
| -1
|-
| '''intelligence'''
| Intelligence of this unit's AI. The higher the value, the longer this unit remembers player troops between turns.
| 0
|-
| '''aggression'''
| Aggression of this unit's AI. The higher the value, the more ruthless the unit, the more likely to make a frontal assault. Less aggressive units tend to set up ambushes.
Vanilla values are:
* 0 = mostly passive
* 1 = balanced
* 2 = mostly aggresive
| 0
|-
| '''energyRecovery'''
| Energy recovered by the unit each turn (needs verification)
| 40 (?)
|-
| '''specab'''
| Special ability of this unit:
* 0 = None
* 1 = [[Cyberdisc|Explodes on Death]]
* 2 = [[Silacoid|Burns Floor]]
* 3 = [[Bio-Drone|Burns Floor and explodes on Death]]
| 0
|-
| '''spawnUnit'''
| String ID of the unit used to respawn on death (eg. [[Zombie]]s respawn as [[Chrysallid]]s).
| -
|-
| '''livingWeapon'''
| Is this unit a living weapon? (only attacks with a '''fixedWeapon''')
| false
|-
| '''female'''
| Is this unit a female? (used for TFTD civilian types)
| false
|-
|}

=== Alien Races ===

Defines a [[Alien Life Forms|race]] used in [[Alien Missions]], listed in ''"alienRaces:"''. Heavily tied with deployment data.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''id'''
| String ID of the alien race name.
| ''required''
|-
| '''members'''
| Alien crew associated with this alien race (eg. race units + terrorist units), defined by a list of unit string IDs. Order here will define rank in terms of deployment. generally speaking the order is:
* 0 - Commander
* 1 - Leader
* 2 - Engineer
* 3 - Medic
* 4 - Navigator
* 5 - Soldier
* 6 - Terrorist 1
* 7 - Terrorist 2
but of course, not all races have all ranks, so the "fill in" rank would be listed multiple times (see ethereals).
| -
|-
| '''retaliation'''
| retaliation enables/disables the race for retaliation missions.
| ''True''
|-
|}

=== Alien Deployments ===

Defines a Battlescape deployment data used in [[Alien Missions]] (such as alien and map configurations), listed in ''"alienDeployments:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the deployment name.
| ''required''
|-
| '''width'''
| Width of the Battlescape map in grid units.
| 0
|-
| '''length'''
| Length of the Battlescape map in grid units.
| 0
|-
| '''height'''
| Vertical height of the Battlescape map in grid units.
| 0
|-
| '''terrains'''
| list of string IDs of the [[#Terrains|terrain]] to choose from to generate this map. This is not used for UFO sites where the terrain comes from the Geoscape.
| -
|-
| '''shade'''
| Shade of the map (0-15, where 0 is full daytime and 15 is full nighttime). This is not used for UFO sites where the shade comes from the Geoscape.
| 0
|-
| '''nextStage'''
| String ID of the next deployment stage to use after this one, for multi-stage missions.
| -
|-
| '''race'''
| Sets the race to use in the next stage.
| ""
|-
| '''script'''
| Reference to a mapScript.
| ""
|-
| '''data'''
| List of deployment data for each alien rank on this mission (see below).
| -
|}

Notes:
* '''terrains''' can also be used with UFOs, with the game using instead the listed terrain rather than the location of the UFO on Geoscape.
==== Deployment Data ====

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''alienRank'''
| [[Alien Rank|Rank]] associated with this deployment data, as defined by the order of the race in question (see above)
| ''required''
|-
| '''lowQty'''
| Maximum quantity of aliens to spawn (beginner).
| 0
|-
| '''highQty'''
| Maximum quantity of aliens to spawn (superhuman).
| 0
|-
| '''dQty'''
| Minimum Desired Quantity of aliens to spawn.
| 0
|-
| '''extraQty'''
| spawns a random number of additional aliens.
| 0
|-
| '''percentageOutsideUfo'''
| Percentage (0-100%) of aliens to spawn outside in UFO sites.
| 0
|-
| '''itemSets'''
| Three lists (one for each alien technology level) of [[#Items|items]] (string IDs) for the aliens to equip.
| ''required''
|-
|}

=== Research ===

Defines a [[Research|research topic]] that X-COM scientists can investigate, listed in ''"research:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''name'''
| String ID of the research project's name (or item, if a '''lookup''' is defined).
| ''required''
|-
| '''lookup'''
| String ID of the research project's display name and UFOPaedia article reference.
| -
|-
| '''cost'''
| Number of man hours (on average) required to complete this project.
| 0
|-
| '''points'''
| [[Score]] earned for completing this project.
| 0
|-
| '''needItem'''
| Does this project require an [[#Items|item]] of the same name?
| false
|-
| '''dependencies'''
| List of research projects that can unlock access to this one. If the full list is researched, or if one of the projects on the list "unlocks" this one, it becomes available.
| -
|-
| '''unlocks'''
| List of research projects unlocked, regardless of other dependencies, but not requirements, by completing this project (for example, any live alien unlocks "alien origins").
| -
|-
| '''requires'''
| List of research projects unilaterally required before this project can be unlocked (for example, "the martian solution" will not even be considered for unlocking until AFTER "alien origins" is completed).
| -
|-
| '''getOneFree'''
| List of "bonus" research projects that may be granted when completing this project (for example, alien medics will give you information on other alien races). Only applies to living aliens.
| -
|-
|}

=== Manufacture ===

Defines a [[Manufacture|manufacture project]] that X-COM engineers can produce, listed in ''"manufacture:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''name'''
| String ID of the manufacturing project's name (and the item it produces).
| ''required''
|-
| '''category'''
| String ID of the manufacturing project's category.
| -
|-
| '''requires'''
| List of [[#Research|topics]] (string IDs) that must be researched to unlock this project. If none are specified, this project is unlocked from the start.
| -
|-
| '''space'''
| Amount of [[Workshop]] space required to begin this project.
| 0
|-
| '''time'''
| Number of man hours (on average) required per item.
| 0
|-
| '''cost'''
| Monetary deduction per item manufactured.
| 0
|-
| '''requiredItems'''
| List of [[#Items|items]] required and consumed per item manufactured.
| -
|-
| '''producedItems'''
| List of [[#Items|items]] produced per each item consumed. If not specified, defaults to 1 item with the same string ID as the manufacture.
| 1
|-
|}

=== UFOpaedia Article ===

Defines an article in the in-game [[UFOpaedia]], listed in ''"ufopaedia:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''id'''
| String ID of the article name. This must match the ID of the object associated with this article, if applicable.
| ''required''
|-
| '''title'''
| String ID of the article title. If omitted, the '''id''' is used.
| -
|-
| '''type_id'''
| Type of this article:
* 0 = Unknown
* 1 = [[Craft]]
* 2 = [[Craft Armaments]]
* 3 = [[HWP]]
* 4 = [[Equipment (EU)|Equipment]]
* 5 = [[Armour]]
* 6 = [[Base Facilities]]
* 7 = Text & Image (eg. [[Alien Life Forms]], [[UFO Components]])
* 8 = Text (eg. [[Alien Research]])
* 9 = [[UFO]]
* 10 = [[TFTD]]
* 11 = TFTD [[Subs]]
* 12 = TFTD [[Sub_Armaments]]
* 13 = TFTD [[Submersible_Weapons_Systems]]
* 14 = TFTD [[Equipment_(TFTD)]]
* 15 = TFTD Armour
* 16 = TFTD [[Base_Facilities_(TFTD)]]
* 17 = TFTD [[Alien_Subs]]
| 0
|-
| '''section'''
| String ID of the UFOpaedia section this article belongs in.
| -
|-
| '''requires'''
| List of [[#Research|topics]] (string IDs) that must be researched to unlock this article. If none are specified, this article is unlocked from the start.
| -
|-
| '''image_id'''
| Filename of the [[UP001.SPK-UP042.SPK|background image]] displayed on this article, if applicable.
| -
|-
| '''text'''
| String ID of the description displayed on this article.
| -
|-
| '''text_width'''
| Maximum width of the text displayed, only applicable to ''Text & Image'' articles.
| 150
|-
| '''rect_stats'''
| Rectangle ('''x''', '''y''', '''width''', '''height''') of the stats text on the screen, only applicable to ''Craft'' articles.
| 0
|-
| '''rect_text'''
| Rectangle ('''x''', '''y''', '''width''', '''height''') of the description text on the screen, only applicable to ''Craft'' articles.
| 0
|-
| '''weapon'''
| String ID of the weapon, only applicable to ''HWP'' articles.
| -
|}

=== UFO Trajectories ===

Defines a trajectory carried out by an UFO during an [[#Alien Missions|alien mission]], listed in ''"ufoTrajectories:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''id'''
| String ID of the trajectory name.
| ''required''
|-
| '''groundTimer'''
| Amount of seconds for the UFO to spend on Ground waypoints.
| 0
|-
| '''waypoints'''
| List of waypoints for the UFO to traverse, defined as ''[zone, altitude, speed]''. 
'''zone''': Globe zone where the waypoint is located. 
'''altitude''': UFO altitude after reaching this waypoint:
* 0 - Ground
* 1 - Very Low
* 2 - Low
* 3 - High
* 4 - Very High
'''speed''': UFO speed after reaching this waypoint, as a percentage (0-100%) of its maximum speed.
| -
|}

=== Alien Missions ===

Defines an [[Alien Missions|alien mission]] carried out by UFOs on the Geoscape, listed in ''"alienMissions:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the mission type.
| ''required''
|-
| '''points'''
| [[Score]] allocated to aliens for successfully completing this mission.
| 0
|-
| '''raceWeights'''
| List of alien races likely to carry out this mission, and the % chance of them being allocated to this mission, listed by "number of months after game beginning".
| ''required''
|-
| '''waves'''
| List of UFO waves to spawn as this mission progresses, as described below.
| ''required''
|}

==== Waves ====

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''ufo'''
| String ID of the [[#UFOs|UFO]] to spawn.
| ''required''
|-
| '''count'''
| Number of UFOs to spawn.
| 0
|-
| '''trajectory'''
| String ID of the [[#UFO Trajectories|trajectory]] for this UFO to use when entering Earth's atmosphere.
| ''required''
|-
| '''timer'''
| How long after the previous wave should this wave arrive? (in seconds)
| 0
|-
|}

=== Alien Item Levels ===

This is a list of item level probabilities, with a number between 0 and 2 representing an item level from plasma pistols to heavy plasmas, as defined in the deployments, expressing a 10% probability for that item level being used.

0 = first set (plasma pistol/clip)
1 = second set (plasma rifle/clip)
2 = third set (heavy plasma/clip)

For example:
[ 2, 0, 0, 0, 0, 0, 0, 1, 1, 1 ]
would represent a 60% chance for pistols, 30% rifles, and 10% heavy weapons. 
Note that the order does not matter, but the length DOES. each line MUST have 10 digits.

The above can be confusing. There are 10 fields; each number represents 10%. 
There are six instances of '0'. 6x10% = 60% chance of plasma pistol 
There are three instances of '1'. 3x10% = 30% chance of plasma rifle 
There is only one instance of '2'. 1x10% = 10% chance of heavy plasma 

Each line represents a month after the beginning of the game, and there is no limit to the number defined. 
OpenXCom will use the most recently available item level in the event the game goes on forever.

=== Extra Sprites ===

Adds or replaces sprites in an existing [[Image Formats|X-COM image file]], listed in ''"extraSprites:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| Filename of the original/new image to modify.
| ''required''
|-
| '''width'''
'''height'''
| Size of the sprite(s) in pixels.
| 0
0
|-
| '''singleImage'''
| Is the image file just a single sprite (true) or a spritesheet (false)?
| false
|-
| '''subX'''
'''subY'''
| Size of the subdivision in pixels. If a subdivision is specified, then the image file is divided into chunks to form the sprites (eg. spritesheets).
| 0
0
|-
| '''files'''
| List of the new sprites to add/replace, listed as ''spriteID: filename''.
| -
|}

Example:
- type: GIANTBUNNY.PCK
width: 32
height: 40
files:
0: Resources/Bunny/Bunny00.png
1: Resources/Bunny/Bunny01.bmp
2: Resources/Bunny/Bunny02.gif

=== Extra Sounds ===

Adds or replaces sounds in an existing [[SOUND|X-COM sound file]], listed in ''"extraSounds:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| ID of the original sound file to modify:
* BATTLE.CAT - Battlescape sounds, corresponds to ''SOUND1.CAT'' or ''SAMPLE2.CAT'' (55 sounds).
* INTRO.CAT - Intro sounds, corresponds to ''INTRO.CAT'' or ''SAMPLE3.CAT'', probably best not to mess with these.
* GEO.CAT - Geoscape sounds, corresponds to ''SOUND2.CAT'' or ''SAMPLE.CAT'' (14 sounds).
| ''required''
|-
| '''files'''
| List of the new sounds to add/replace, listed as ''soundID: filename''.
| -
|}

Example:
- type: BATTLE.CAT
files:
55: Resources/Sounds/sample.wav

=== Extra Strings ===

Adds or replaces text strings in an existing [[Translations (OpenXcom)|OpenXcom language file]], listed in ''"extraStrings:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| Filename of the original language file to modify, sans extension.
| ''required''
|-
| '''strings'''
| List of the new strings to add/replace, listed as ''stringID: text''.
| -
|}

Example:
- type: en-US
strings:
STR_SNIPER_RIFLE: Sniper Rifle
STR_SNIPER_RIFLE_CLIP: Sniper Rifle Clip
- type: en-GB
strings:
STR_SNIPER_RIFLE: Sniper Rifle
STR_SNIPER_RIFLE_CLIP: Sniper Rifle Clip
- type: de
strings:
STR_SNIPER_RIFLE: Scharfschützengewehr
STR_SNIPER_RIFLE_CLIP: Scharfschützengewehrmunition
- type: ru
strings:
STR_SNIPER_RIFLE: Снайперская винтовка
STR_SNIPER_RIFLE_CLIP: Магазин к снайп. винтовке

=== Interfaces ===

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| ''?''
| -
|-
| '''elements'''
| ''?''
| -
|-
| '''id'''
| ''?''
| -
|-
| '''color'''
| ''?''
| -
|}

=== StatStrings ===

[[Statstrings]] are used for automatically renaming soldiers. They are case sensitive and they are processed in the order in which they are specified.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''string'''
| String to add to name.
| ''required''
|-
| '''psiStrength''' 
'''psiSkill''' 
'''bravery''' 
'''strength''' 
'''firing''' 
'''reactions''' 
'''stamina''' 
'''tu''' 
'''health''' 
'''throwing'''
| One or more stat ranges are ANDed together for success. Each range has a minVal and maxVal. Use YAML standard tilde (~) to indicate null. ((~) = 0 as minvalue; (~) =255 as maxvalue)
| -
|}

Example:
statStrings:
- string: "x"
psiStrength: [~, 30]
- string: "P"
psiStrength: [80, ~]
- string: "p"
psiStrength: [60, 79]
- string: "K"
psiSkill: [60, ~]
- string: "k"
psiSkill: [30, 59]
- string: "b"
bravery: [60, ~]
- string: "c"
bravery: [~, 10]
- string: "w"
strength: [~, 25]
- string: "Snpr"
firing: [60, ~]
reactions: [60, ~]
- string: "M"
firing: [70, ~]
- string: "m"
firing: [60, 69]
- string: "Sct"
reactions: [50, ~]
tu: [60, ~]
- string: "R"
reactions: [60, ~]
- string: "r"
reactions: [50, 59]

==References==
<references />

[[Category:OpenXcom]]

Ruleset Reference Nightly (OpenXcom)

2014-12-10T16:46:48Z

Falko: /* Map Command */

A reference of all the customizable values of everything in a [[Rulesets (OpenXcom)|ruleset]], according to the latest nightly. This page should be updated as new versions become available in order to explain the changes from [[Ruleset Reference (OpenXcom)|version 1.0]].

Some guidelines:
* If a value is omitted from the ruleset, the default is used. You cannot omit ''required'' values.
* Text strings (eg. names) are represented by string IDs from the [[Translations (OpenXcom)|language files]]
* Numerical IDs (used for sprites, sounds, etc.) start at 0, not 1.
* Boolean (yes/no) values are represented by true/false.
* World coordinates are represented in degrees (see [[WORLD.DAT]]).
* Money amounts (prices, costs, etc.) are represented in dollars.
* All paths are '''case sensitive'''! If your ruleset uses external files, make sure that they named properly as described in ruleset.

Items are ordered as they come in the ruleset. To override this, you can specify a ''listOrder''. You can find the default listOrders in [[Ruleset List Order (OpenXcom)|Ruleset List Order]].

=== Globe ===

Defines the drawing of landmasses and borders on the globe.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''data'''
| Path name of file which contains polygon and texture information. (For example WORLD.DAT).
| -
|-
| '''polygons'''
| List of polygons drawn on the globe surface. A triangle consist of seven values: the first number defines the texture, followed by three pairs of (x,y) globe coordinates. Only polygons with 3 or 4 vertices are reliable shown on the globe = 7 or 9 values per entry.
| -
|-
| '''polylines'''
| List of border lines. Each list entry consist of a list of (x,y) globe coordinates.
| -
|}

=== Countries ===

Defines one of the [[Country Funding (EU)|funding nations]], listed in ''"countries:"''. They're used for activity graphs and player scoring.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the country name.
| ''required''
|-
| '''fundingBase'''
| Country's base funding, in thousands. The starting funding can be anywhere between 1x and 2x the base funding.
| 0
|-
| '''fundingCap'''
| Country's funding cap, in thousands. Once a country reaches this maximum, it will no longer increase its funding.
| 0
|-
| '''labelLon'''
'''labelLat'''
| Longitude and latitude coordinates of the country's label on the globe. This label is only shown when the globe is zoomed in and "detail" is turned on.
| 0.0
0.0
|-
| '''areas'''
| List of "rectangles" on the globe defined as [''lon1'' ''lat1'' ''lon2'' ''lat2'']. Any activity within these areas counts towards the country's graph activity and affects their opinion of the player.
| -
|}

=== Regions ===

Defines one of the [[Geoscape (EU)#World Regions/Countries|world regions]], listed in ''"regions:"''. They're used for base placement, activity graphs and mission spawning.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the region name.
| ''required''
|-
| '''cost'''
| Amount of money spent building an X-COM base in this region (first base is free).
| 0
|-
| '''areas'''
| List of "rectangles" on the globe defined as ''[lon1, lat1, lon2, lat2]''. Any activity within these areas counts towards the region's graph activity.
| -
|-
| '''cities'''
| List of cities belonging to this region. They will be displayed on the globe and used for terror site missions. Each city is defined by their '''lon''' and '''lat''' coordinates and a '''name''' string ID.
| -
|-
| '''regionWeight'''
| Weight of this region when selecting regions for alien missions.
| 0
|-
| '''missionWeights'''
| Weighted list of the different mission types for this region (eg. ''STR_ALIEN_RESEARCH: 14'').
| -
|-
| '''missionZones'''
| List of "rectangles" (''[lon1, lat1, lon2, lat2]'') defining the mission zones for this region. Mission zones are waypoints for UFO trajectories.
| -
|-
| '''missionRegion'''
| Spawn mission in this region instead (used for regions without land).
| -
|}

=== Base Facilities ===

Defines one of the [[Base Facilities (EU)|facilities]] that can be built in an X-COM base, listed in ''"facilities:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the facility name.
| ''required''
|-
| '''requires'''
| List of [[#Research|topics]] (string IDs) that must be researched to unlock this facility. If none are specified, this facility is unlocked from the start.
| -
|-
| '''spriteShape'''
| Sprite ID from [[BASEBITS.PCK]] used to draw the facility's outer shape in the Basescape and UFOpaedia.
| -1
|-
| '''spriteFacility'''
| Sprite ID from [[BASEBITS.PCK]] used to draw the facility's contents in the Basescape and UFOpaedia. Drawn on top of '''spriteShape'''.
| -1
|-
| '''lift'''
| Is this facility an [[Access Lift]]? All base facilities must be connected to the lift.
| false
|-
| '''hyper'''
| Is this facility a [[Hyperwave Decoder]]? Displays extra information for detected UFOs. Only valid for radar facilities.
| false
|-
| '''mind'''
| Is this facility a [[Mind Shield]]? Reduces the chance of UFOs finding your base. Does not stack.
| false
|-
| '''grav'''
| Is this facility a [[Grav Shield]]? Doubles the power of your base defenses. Does not stack.
| false
|-
| '''size'''
| Size of the facility, in grid units. Every facility is square, so a size of 1 means 1x1, 2 means 2x2, etc. Bigger facilities are made up of multiple sprites, for example a 2x2 facility will use 4 sprites for '''spriteShape''' and 4 sprites for '''spriteFacility''' (top-left, top-right, bottom-left, bottom-right).
| 1
|-
| '''buildCost'''
| Amount of money spent to build this facility in the base.
| 0
|-
| '''buildTime'''
| Amount of days it takes for this facility to be built.
| 0
|-
| '''monthlyCost'''
| Amount of money spent monthly for the maintenance of this facility.
| 0
|-
| '''storage'''
| Amount of storage space (for items) this facility provides. See [[Base Stores]].
| 0
|-
| '''personnel'''
| Amount of personnel (soldiers, scientsts, engineers) these quarters can contain.
| 0
|-
| '''aliens'''
| Amount of live aliens this facility can contain. Only checked if the ''alienContainmentLimitEnforced'' option is enabled.
| 0
|-
| '''crafts'''
| Amount of X-COM craft this facility can contain.
| 0
|-
| '''labs'''
| Amount of lab space this facility provides for research projects.
| 0
|-
| '''workshops'''
| Amount of workshop space this facility provides for manufacture projects.
| 0
|-
| '''psiLabs'''
| Amount of soldier space this facility provides for psionic training.
| 0
|-
| '''radarRange'''
| Maximum radar detection range of this facility, in nautical miles.
| 0
|-
| '''radarChance'''
| Chance (0-100%) of this radar detecting a UFO that enters its range.
| 0
|-
| '''defense'''
| Offensive power provided by this base defense against attacking UFOs.
| 0
|-
| '''hitRatio'''
| Chance (0-100) of the base defense hitting an attacking UFO.
| 0
|-
| '''fireSound'''
| Sound ID from [[#Extra_Sounds|GEO.CAT]] played when the base defense fires.
| -1
|-
| '''hitSound'''
| Sound ID from [[#Extra_Sounds|GEO.CAT]] played when the base defense hits a target.
| -1
|-
| '''mapName'''
| [[MAPS|Map]] associated to this facility in Battlescape base defenses.
| -
|-
|}

=== Crafts ===

Defines one of the [[Craft|X-COM crafts]] that go on interception missions, listed in ''"crafts:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the craft name.
| ''required''
|-
| '''requires'''
| List of [[#Research|topics]] (string IDs) that must be researched to unlock this craft. If none are specified, this craft is unlocked from the start.
| -
|-
| '''sprite'''
| Sprite ID from [[BASEBITS.PCK]] used to draw this craft in the Basescape and from [[INTICON.PCK]] used to draw the damage indicator in dogfights.
modders: the corresponding extrasprite file id for BASEBITS.PCK is sprite+33 INTICON.PCK contains a minimized icon id=sprite the file id for the dogfight image is sprite+11
| -1
|-
| '''fuelMax'''
| Maximum amount of fuel this craft can carry. Crafts use up fuel based on their speed while travelling.
| 0
|-
| '''damageMax'''
| Maximum amount of damage this craft can take. If this amount is exceeded, the craft is destroyed.
| 0
|-
| '''speedMax'''
| Maximum speed in nautical miles. Crafts travel at max speed when flying and half speed when patrolling.
| 0
|-
| '''accel'''
| Aceeleration value shown in the UFOpaedia.
| 0
|-
| '''weapons'''
| Amount of craft weapons this craft can equip. The UI can only display a max of 2 weapons.
| 0
|-
| '''soldiers'''
| Amount of soldiers this craft can carry.
| 0
|-
| '''maxItems'''
| Amount of items this craft can carry.
| 80
|-
| '''vehicles'''
| Amount of vehicles this craft can carry.
| 0
|-
| '''costBuy'''
| Amount of money spent for purchasing this craft. If set to 0, the craft will not be available in the Purchase/Recruit screen.
| 0
|-
| '''costRent'''
| Amount of money spent monthly for renting this craft. If set to 0, the craft is not on rental and won't count towards base maintenance.
| 0
|-
| '''costSell'''
| Amount of money gained for selling this craft.
| 0
|-
| '''refuelItem'''
| Item required for refuelling this craft. If no item is specified, the craft uses human fuel.
| 0
|-
| '''repairRate'''
| Amount of damage restored every hour while [[Repairs|Repairing]] in base.
| 1
|-
| '''refuelRate'''
| Amount of fuel restored every 30 mins while [[Refueling]] in base. If specified, a '''refuelItem''' is spent each time.
| 1
|-
| '''radarRange'''
| Detection range of the craft's radar in nautical miles. Every craft radar has a 100% detection chance.
| 600
|-
| '''transferTime'''
| Number of hours it takes to purchase/transfer this craft to a base.
| 0
|-
| '''score'''
| [[Score]] lost when this craft is destroyed.
| 0
|-
| '''spacecraft'''
| Can this craft go to [[Cydonia]]?
| false
|-
| '''battlescapeTerrainData'''
| [[#Terrains|Terrain]] associated to this craft in Battlescape missions.
| -
|}

=== Craft Weapons ===

Defines one of the [[Craft Armaments|weapons]] equipped by X-COM craft for shooting down UFOs, listed in ''"craftWeapons:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the weapon name.
| ''required''
|-
| '''sprite'''
| Sprite ID from [[BASEBITS.PCK]] used to draw the weapon in the Basescape and from [[INTICON.PCK]] used to draw the weapon in dogfights.
modders: the corresponding extrasprites file id for INTICON.PCK is sprite+5 and sprite+48 for BASEBITS.PCK
| -1
|-
| '''sound'''
| Sound ID from [[#Extra_Sounds|GEO.CAT]] played when this weapon fires.
| -1
|-
| '''damage'''
| Amount of damage this weapon does to enemy UFOs.
| 0
|-
| '''range'''
| Maximum range of this weapon in dogfights (in meters).
| 0
|-
| '''accuracy'''
| Chance (0-100%) of each shot hitting the enemy UFO.
| 0
|-
| '''reloadCautious'''
| Time this weapon takes to fire between each shot in ''Cautious Mode''.
| 0
|-
| '''reloadStandard'''
| Time this weapon takes to fire between each shot in ''Standard Mode''.
| 0
|-
| '''reloadAggressive'''
| Time this weapon takes to fire between each shot in ''Aggressive Mode''.
| 0
|-
| '''ammoMax'''
| Maximum amount of ammo this weapon can carry.
| 0
|-
| '''rearmRate'''
| Amount of ammo restored every 30 mins while the craft is [[Rearming]] in base. If specified, '''clip'''s are spent depending on their '''clipSize'''. If the '''clipSize''' of the specified ammo is 0, no '''clip'''s are spent.
| 1
|-
| '''projectileType'''
| Type of the weapon projectile, used for the projectile sprite in dogfights:
* 0 - [[Stingray]]
* 1 - [[Avalanche]]
* 2 - [[Cannon]]
* 3 - [[Fusion Ball]]
* 4 - [[Laser Cannon]]
* 5 - [[Plasma Beam]]
| 2
|-
| '''projectileSpeed'''
| Speed of the weapon projectile in dogfights.
| 0
|-
| '''launcher'''
| String ID of the [[#Items|item]] required to equip this weapon.
| -
|-
| '''clip'''
| String ID of the [[#Items|item]] required to rearm this weapon.
| -
|}

=== Items ===

Defines the Geoscape and Battlescape properties of an [[Equipment (EU)|item]] that can be stored in X-COM bases, listed in ''"items:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the internal item name.
| ''required''
|-
| '''name'''
| String ID of the displayed item name, for cases where it's different from the internal name. If omitted, '''type''' is used.
| -
|-
| '''requires'''
| List of [[#Research|topics]] (string IDs) that must be researched to unlock this item. If none are specified, this item is unlocked from the start. Soldiers can only use unlocked items in the Battlescape.
| -
|-
| '''size'''
| Space occupied by this item in [[Base Stores]]. Can be a decimal value.
| 0.0
|-
| '''costBuy'''
| Amount of money spent for purchasing this item. If set to 0, this item will not be available in the Purchase/Recruit screen.
| 0
|-
| '''costSell'''
| Amount of money gained for selling this item.
| 0
|-
| '''transferTime'''
| Number of hours it takes to purchase/transfer this item to a base.
| 24
|-
| '''weight'''
| [[Item_Weight|Weight]] occupied by this item in a soldier's inventory.
| 999
|-
| '''bigSprite'''
| Sprite ID from [[BIGOBS.PCK]] used to draw this item in a soldier's inventory and UFOpaedia.
| -1
|-
| '''floorSprite'''
| Sprite ID from [[FLOOROB.PCK]] used to draw this item on the floor of a Battlescape tile.
| -1
|-
| '''handSprite'''
| Sprite ID from [[HANDOB.PCK]] used to draw this item on a soldier's hand in the Battlescape.
modders: each handobject needs 8 images (8 directions) define the extrasprites accordingly
| 120
|-
| '''bulletSprite'''
| Sprite ID from ''BulletSprites.png'' used to draw this weapon's projectile on the Battlescape:
* 0 - [[Rocket Launcher]]
* 1 - [[Pistol]]
* 2 - [[Rifle]]
* 3 - [[Auto Cannon]]
* 4 - [[Heavy Cannon]]
* 5 - [[Laser Pistol]]
* 6 - [[Laser Rifle]]
* 7 - [[Heavy Laser]]
* 8 - [[Plasma Rifle|Plasma]]
* 9 - [[Small Launcher]]
* 10 - [[Blaster Launcher]]
for modders: the bulletsprite needs to be put into the extraSprites type "Projectiles" the bulletsprite can contain up to 35 3x3 images. The corresponding file id is 35*[bulletSprite]
| -1
|-
| '''fireSound'''
| Sound ID from [[#Extra_Sounds|BATTLE.CAT]] played when this weapon fires.
| -1
|-
| '''hitSound'''
| Sound ID from [[#Extra_Sounds|BATTLE.CAT]] played when this weapon hits a target.
| -1
|-
| '''hitAnimation'''
| Sprite ID from [[SMOKE.PCK]] used to draw the weapon's "hit explosion".
'''NOTE''': Do not define this value for melee/psi weapons, they use [[HIT.PCK]] and therefore meleeAnimation instead.
| 0
|-
| '''power'''
| Average damage of the weapon, in most cases it will be +-50% this value.
| 0
|-
| '''strengthApplied'''
| Add the attacking unit's strength to this weapon's damage.
| false
|-
| '''compatibleAmmo'''
| List of string IDs of the ammo items that can be loaded on this weapon. If none are specified, the weapon doesn't need ammo.
| -
|-
| '''damageType'''
| What type of [[damage]] does this weapon do:
* 0 - None
* 1 - Armor Piercing
* 2 - Incendiary
* 3 - High Explosive
* 4 - Laser
* 5 - Plasma
* 6 - Stun
* 7 - Melee
* 8 - Acid
* 9 - Smoke
'''NOTE:''' A damage type other than 0-9 will do nothing.
| 0
|-
| '''tuAuto'''
'''accuracyAuto'''
| The percentage (0-100%) of [[Time Units]] (from the soldier's total) required to fire an Auto Shot. If 0, the weapon does not have an Auto Shot.
The base accuracy (0-100%) applied to a soldier's [[Firing Accuracy]] when firing an Auto Shot.
| 0
0
|-
| '''tuSnap'''
'''accuracySnap'''
| The percentage (0-100%) of [[Time Units]] (from the soldier's total) required to fire a Snap Shot. If 0, the weapon does not have a Snap Shot.
The base accuracy (0-100%) applied to a soldier's [[Firing Accuracy]] when firing a Snap Shot.
| 0
0
|-
| '''tuAimed'''
'''accuracyAimed'''
| The percentage (0-100%) of [[Time Units]] (from the soldier's total) required to fire an Aimed Shot. If 0, the weapon does not have an Aimed Shot.
The base accuracy (0-100%) applied to a soldier's [[Firing Accuracy]] when firing an Aimed Shot.
| 0
0
|-
|-
| '''tuMelee'''
'''accuracyMelee'''
| The percentage (0-100%) of [[Time Units]] (from the soldier's total) required to do a melee attack (Hit). If 0, the weapon does not have a melee attack.
The base accuracy (0-100%) applied to a soldier's [[Melee Accuracy]] when doing a melee attack.
| 0
0
|-
| '''clipSize'''
| The amount of ammo stored in each weapon clip. If -1 is specified, this weapon has infinite ammo.
| 0
|-
| '''battleType'''
| Defines the weapon's behavior in the Battlescape:
* 0 - None (Geoscape-only item)
* 1 - [[Weapons|Firearm]]
* 2 - Ammo
* 3 - Melee
* 4 - [[Grenade]]
* 5 - [[Proximity Grenade]]
* 6 - [[Medi-Kit (EU)|Medi-Kit]]
* 7 - [[Motion Scanner]]
* 8 - [[Mind Probe]]
* 9 - [[Psi-Amp]]
* 10 - [[Electro-flare]]
* 11 - Corpse
| 0
|-
| '''twoHanded'''
| Is this weapon two-handed? If true, incurs an accuracy penalty if used with both hands occupied. Note that the handsprite of a twoHanded item is also drawn at a slightly different position than a one handed item.
| false
|-
| '''waypoint'''
| Does this weapon use waypoints? (eg. [[Blaster Launcher]]). Can also be used to make ammo items use the waypoint system.
| false
|-
| '''fixedWeapon'''
| Is this weapon fixed? (it's part of a unit, eg. tanks and terrorist units)
| false
|-
| '''invWidth'''
| Item width in a soldier's inventory (in grid units).
| 1
|-
| '''invHeight'''
| Item height in a soldier's inventory (in grid units).
| 1
|-
| '''painKiller'''
| Amount of painkillers contained in a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''heal'''
| Amount of heal's contained in a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''stimulant'''
| Amount of stimulants contained in a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''woundRecovery'''
| Amount of [[Fatal Wounds]] treated by each heal of a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''healthRecovery'''
| Amount of [[Health]] recovered by each heal of a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''stunRecovery'''
| Amount of [[Stun]] removed by each stimulant of a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''energyRecovery'''
| Amount of [[Energy]] recovered by each stimulant of a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''tuUse'''
| Amount of [[Time Units]] required to use this item (for non-offensive items). It's a flat rate if '''flatRate''' is true, otherwise it's a percentage (0-100%).
| 0
|-
| '''recoveryPoints'''
| [[Score]] gained for recovering this alien artifact.
| 0
|-
| '''armor'''
| How much damage is needed to destroy this item on the ground.
| 20
|-
| '''recover'''
| Is this item recoverable? (gets transported to the X-COM base on mission success)
| true
|-
| '''turretType'''
| Sprite ID from [[TANKS.PCK]] of the turret to assign to this tank:
* 0 - [[Tank/Cannon]]
* 1 - [[Tank/Rocket Launcher]]
* 2 - [[Tank/Laser Cannon]]
* 3 - [[Hovertank/Plasma]]
* 4 - [[Hovertank/Launcher]]
| -1
|-
| '''liveAlien'''
| Does this item represent a live alien? (counts towards [[Alien Containment]])
| false
|-
| '''blastRadius'''
| Size of the projectile explosions. 0 for no explosion. -1 to automatically calculate based on weapon power and damage type (actual '''blastRadius''' currently is capped due [[Explosions#Playing_With_Fire|Explosion calculations]]).
| -1
|-
| '''flatRate'''
| If true, then TU costs for this weapon are a flat rate (instead of a percentage of unit TUs).
| false
|-
| '''arcingShot'''
| Does this weapon fire in an arc?
| false
|-
| '''attraction'''
| Represents how likely an alien is to pick up this item. Values below 5 will be ignored (by design).
| 0
|-
| '''maxRange'''
| Maximum range at which this weapon can operate.
| 200
|-
| '''aimRange'''
| Maximum effective range with this weapon before which range-based dropoff occurs.
| 200
|-
| '''snapRange'''
| Maximum effective range with snap shot before which range-based dropoff occurs. (ufoextender accuracy only)
| 15
|-
| '''autoRange'''
| Maximum effective range with auto shot before which range-based dropoff occurs. (ufoextender accuracy only)
| 7
|-
| '''minRange'''
| Range-based dropoff will work in reverse for ranges below this.
| 0
|-
| '''dropoff'''
| The value by which the accuracy lowers for each tile after (or before) the thresholds above.
| 2
|-
| '''bulletSpeed'''
| How much faster (or slower, if you use a negative number) is a projectile fired from this weapon compared to the average.
| 0
|-
| '''autoShots'''
| How many auto shots does this weapon fire.
| 3
|-
| '''shotgunPellets'''
| Number of projectiles fired per unit of ammunition. (note: due to engine limitations it is currently impossible to draw multiple projectiles in flight.)
| 0
|-
| '''zombieUnit'''
| String ID of the unit used for zombification (eg. [[Chrysallid]]s turn units into [[Zombie]]s).
| none
|-
| '''meleeSound'''
| Sound ID from [[#Extra_Sounds|BATTLE.CAT]] played when this weapon attacks a target with melee.
| 39
|-
| '''meleeHitSound'''
| Sound ID from [[#Extra_Sounds|BATTLE.CAT]] played when this weapon HITS a target with melee.
| -1
|-
| '''meleeAnimation'''
| Sprite ID from HIT.PCK played when this weapon attacks a target with melee.
| 0
|-
| '''meleePower'''
| Damage this weapon will do when using melee. This only applies to Firearms, and is only available as stun damage. For normal melee weapons, use regular power and damage types.
| 0
|-
| '''LOSRequired'''
| Does this item require line of sight? (only applies to mind probes and psi-amps)
| false
|-
| '''skillApplied'''
| Is melee skill applied to the accuracy of an attack made with this object?
| true
|-
|}

=== UFOs ===

Defines one of the [[UFOs]] that invade Earth, listed in ''"ufos:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the UFO name.
| ''required''
|-
| '''size'''
| String ID of the UFO size.
| STR_VERY_SMALL
|-
| '''sprite'''
| Sprite ID from [[INTERWIN.DAT]] used to draw this UFO in the dogfight view and UFOpaedia.
don't try to add more images if you don't want to punch yourself in the face - use modsprite
| -1
|-
| '''modSprite'''
| Filename used to draw this UFO in the dogfight view and UFOpaedia.
| -
|-
| '''damageMax'''
| Maximum amount of damage this UFO can take. If the UFO takes 50% damage, it crash lands. If it takes 100% damage, it is destroyed.
| 0
|-
| '''speedMax'''
| Maximum speed in nautical miles.
| 0
|-
| '''accel'''
| Aceeleration value shown in the UFOpaedia.
| 0
|-
| '''power'''
| Damage power of this UFO's weapon in dogfights.
| 0
|-
| '''range'''
| Maximum range of this UFO's weapon in dogfights (in meters).
| 0
|-
| '''score'''
| [[Score]] gained when this UFO is destroyed, or half this score if it crash lands.
| 0
|-
| '''reload'''
| Time the UFO's weapon takes to fire between each shot.
| 0
|-
| '''breakOffTime'''
| Minimum amount of time for the UFO to be able to break off of a dogfight.
| 0
|-
| '''battlescapeTerrainData'''
| [[#Terrains|Terrain]] associated to this UFO in Battlescape missions.
| ''required''
|-
|}

=== Inventory Sections ===

Defines one of the sections of the [[Inventory TU Table|Battlescape inventory]] (eg. Backpack), listed in ''"invs:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the inventory name.
| ''required''
|-
| '''x'''
'''y'''
| Pixel coordinates of this section on the inventory screen.
| 0
0
|-
| '''type'''
| Type of this section:
* 0 = Slot section, can contain as many items as will fit on the slots.
* 1 = Hand section, can only contain one item regardless of size.
* 2 = Ground section, can contain infinite items.
| 0
|-
| '''slots'''
| List of the grid slots (''[x, y]'') that this section is composed of. For example, to make a 2x2 section, you would have ''[0, 0] [0, 1] [1, 0] [1, 1]''.
| -
|-
| '''costs'''
| List of [[Time Units]] costs to move an item from this section to another one (eg. ''STR_BACKPACK: 16'' means it will cost 16 TUs to move an item from this section to the Backpack).
| -
|-
|}

=== Terrains ===

Defines one of the [[TERRAIN|terrains]] used to generate a Battlescape map, listed in "terrains:".

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''name'''
| String ID of the terrain name.
| ''required''
|-
| '''textures'''
| List of [[TEXTURE.DAT|Geoscape textures]] that correspond to this terrain.
| -
|-
| '''hemisphere'''
| Geoscape hemisphere associated with this terrain:
* -1 - Northern hemisphere.
* 0 - Both hemispheres.
* 1 - Southern hemisphere.
| 0
|-
| '''mapDataSets'''
| List of filenames (each with matching [[MCD]]/[[Image Formats#PCK|PCK/TAB]] files) that contain the tiles of this terrain.
| -
|-
| '''mapBlocks'''
| List of map blocks (see below) that are used for generating a map.
| -
|-
| '''civilianTypes'''
| List of units to use as civilians for this mission.
| [MALE_CIVILIAN, FEMALE_CIVILIAN]
|-
|}

==== Map Blocks ====

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''name'''
| Filename of the [[MAPS|map]].
| ''required''
|-
| '''width'''
| Width of this map block in Battlescape grid units.
| 0
|-
| '''length'''
| Length of this map block in Battlescape grid units.
| 0
|-
| '''height'''
| Height of this map block in Battlescape grid units.
| 1
|-
| '''groups'''
| List (or single number) of groups this mapblock belongs to (used in mapscripts)
default usage:
* 0 - Default
* 1 - Landing Zone (for placing X-COM / alien craft) (used in addcraft/ufo command)
* 2 - E-W Road (for city maps) (used in addline command)
* 3 - N-S Road (for city maps) (used in addline command)
* 4 - Road Crossing (for city maps) (used in addline command)
| 0
|-
| '''items'''
| An array of items to add to this mapblock, an the positions to place them at.
| -1
|}

* '''hemisphere''' only applies to UFO missions, not Terror ones.
*'''width/length''' defines the size of the map
** be aware that the mapview "width"-label is the openxcom ruleset length parameter
** be aware that the mapview "length"-label is the openxcom ruleset width parameter

==== Guidelines/Tips ====
* All maps with an XCOM/Alien craft require at least one map block assigned to Group 1. This map block can only contain ground tiles (no walls or objects), otherwise the game will crash or the walls/objects will be removed.
* All Terror terrains (listed under STR_TERROR_MISSION) require the Groups of '''Types''' 2, 3 and 4 (for a total of 3 maps, which are required to place roads).

=== Map Scripts ===

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| name of the script
| ''required''
|-
| '''commands'''
| List of MapCommands
| -
|}

==== Map Command ====

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| Currently these commands are implemented:
* addBlock
* addLine
* addCraft
* addUFO
* digTunnel
* fillArea
* checkBlock
* removeBlock
* resize
depending on the command type some of the following parameters are needed
| ''required''
|-
| '''label'''
| A numeric label that can be used for conditional execution of commands.
Each label should be unique within the command list (0=default no need for uniqueness).
| 0
|-
| '''conditionals'''
| Defines the conditions that allows the execution of this command.
eg. [1, -4] means it will be executed if command with label 1 was a success and command with label 4 failed.
commands that are not yet executed are always in failed state.
| 0
|-
| '''executionChances'''
| the chance that this command will be executed (or fails)
| 100
|-
| '''executions'''
| this command will be executed multiple times with a value > 1
| 1
|-
| '''groups'''
| Defines the what mapblock are used within this command. Can be list of goups or a single number.
| 0
|-
| '''blocks'''
| Alternative to groups. Here we define a list of mapblocks that are used within this command.
| 0
|-
| '''rects'''
| A list of possible ranges where (random) placement/checks/removal can happen in a map.
Is a list of a list of four integers.
| ?
|-
| '''size'''
| size of mapblocks that can be placed/checked/removed within rects. Also used for resize command type.
| ?
|-
| '''freqs'''
| For a list of mapblocks (defined by blocks?) we can define distribution frequency here.
| 1
|-
| '''maxUses'''
| For a list of mapblocks (defined by blocks?) we can define the maximal amount a mapblock can be used here.
| -1
|-
| '''direction'''
| used for addLine command type. Values are both, horizontal or vertical. Typically defines the road type distribution.
| -1
|-
| '''tunnelData'''
| Parameter for digTunnel command type. Contains level (default: 0) and a list of MCD replacement rules (MCDReplacements)
| 0
|}

==== Guidelines/Tips ====
* The Mapscript is still somewhat in development

=== Armor ===

Defines a Battlescape unit's [[armor]] as well as visual representation (so every unit has an armor), listed in ''"armors:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the armor name.
| ''required''
|-
| '''spriteSheet'''
| Sprite sheet from [[UNITS]] used to draw a unit wearing this armor.
| -
|-
| '''spriteInv'''
| Sprite used for the [[Inventory Backgrounds]] of a unit wearing this armor.
| -
|-
| '''corpseBattle'''
| List of string IDs of the corpse [[#Items|items]] generated when a unit wearing this armor is killed (one per unit tile) on the Battlescape.
| -
|-
| '''corpseGeo'''
| String ID of the corpse [[#Items|item]] associated with this unit on the Geoscape.
| -
|-
| '''storeItem'''
| String ID of the [[#Items|item]] that represents this armor in [[Base Stores]] for equipping.
| -
|-
| '''weight'''
| Physical weight of the armor when worn
| 6
|-
| '''stats'''
| like soldier stats (see below) but these are treated as stat bonuses for wearing the specific armor.
| -
|-
| '''frontArmor'''
| Protection provided on the front of the unit.
| 0
|-
| '''sideArmor'''
| Protection provided on the sides of the unit.
| 0
|-
| '''rearArmor'''
| Protection provided on the rear of the unit.
| 0
|-
| '''underArmor'''
| Protection provided under the unit (eg. from explosions).
| 0
|-
| '''drawingRoutine'''
| Drawing routine used to put together the body parts in the unit's '''spriteSheet''':
* 0 = [[Soldier]], [[Sectoid]]
* 1 = [[Floater]]
* 2 = [[HWP]]
* 3 = [[Cyberdisk]]
* 4 = [[Civilian]], [[Ethereal]]
* 5 = [[Sectopod]], [[Reaper]]
* 6 = [[Snakeman]]
* 7 = [[Chryssalid]]
* 8 = [[Silacoid]]
* 9 = [[Celatid]]
* 10 = [[Muton]]
* 11 = [[Submersible Weapons Systems]]
* 12 = [[Hallucinoid]]
* 13 = [[Aquanauts]]
* 14 = [[Calcinite]], [[Deep One]], [[Gillman]], [[Lobster Man]], [[Tasoth]]
* 15 = [[Aquatoid]]
* 16 = [[Bio-Drone]]
| 0
|-
| '''movementType'''
| Type of movement provided by this armor:
* 0 = Walking
* 1 = Flying
* 2 = Sliding (no walking animation)
it also defines the body of an tank (32-images) in your spriteSheet or the change in sprites while flying using a flying armour see: [[TANKS.PCK]], [[XCOM_2.PCK]]
| 0
|-
| '''damageModifier'''
| List of decimal damage modifiers (1.0 = 100%) this armor applies to each damage type (see [[#Items|Items section]]) received. Modifiers must be specified for all damage types, in this order:
* None
* Armor Piercing
* Incendiary
* High Explosive
* Laser
* Plasma
* Stun
* Melee
* Acid
* Smoke
|
- 1.0 
- 1.0 
- 1.0 
- 1.0 
- 1.0 
- 1.0 
- 1.0 
- 1.0 
- 1.0 
- 1.0
|-
| '''size'''
| Size of the unit wearing this armor, in Battlescape grid units. Every unit is square, so a size of 2 means 2x2.
| 1
|-
| '''loftempsSet'''
| List of [[LOFTEMPS]] IDs (one per unit tile, so a 1x1 unit has 1, a 2x2 unit has 4, etc.) used to represent a unit wearing this armor in 3D space.
| -
|-
| '''loftemps'''
| loftemps is a deprecated option that only works for 1x1 sized units.
| -
|-
| '''forcedTorso'''
| soldier sprites have female and male torsos. some armours reuse these sprites for flying/non flying torso without difference between genders. This can be controlled by the parameter: 0 = use genderrelated torso, 1 = use male torso, 2 = use female torso
| 0

|}

=== Player Units (Soldiers) ===

Defines a [[soldier]] recruited by X-COM, listed in ''"soldiers:"''. Currently only one soldier unit type (''XCOM'') is supported.

Unit stats are represented as follows:
* [[Time Units|tu]]
* [[Energy|stamina]]
* [[Health|health]]
* [[Bravery|bravery]] (always a multiple of 10)
* [[Reactions|reactions]]
* [[Firing Accuracy|firing]]
* [[Throwing Accuracy|throwing]]
* [[Strength|strength]]
* [[Psi Strength|psiStrength]]
* [[Psi Skill|psiSkill]]
* [[Melee Accuracy|melee]] (not visible)

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the soldier name.
| ''required''
|-
| '''minStats'''
| Minimum values used to generate the soldier's [[Starting Stats]]. In this case, ''psiSkill'' is treated as the initial stat (not generated).
| -
|-
| '''maxStats'''
| Maximum values used to generate the soldier's [[Starting Stats]]. In this case, ''psiSkill'' is treated as the minimum value for the first month of psi training (actual value is 100%-150%).
| -
|-
| '''statCaps'''
| Maximum stats this soldier can gain through [[Experience]]. '''NOTE:''' A stat will still go over the limit once, and then will no longer increase (see [[Experience#Regarding Caps|Regarding Caps]]).
| -
|-
| '''armor'''
| String ID of the [[#Armor|armor]] this soldier uses by default.
| -
|-
| '''standHeight'''
| Height of this soldier when standing.
| 0
|-
| '''kneelHeight'''
| Height of this soldier when kneeling.
| 0
|-
| '''floatHeight'''
| Distance between the bottom of this unit and the ground.
| 0
|-
| '''femaleFrequency'''
| The probability that a female soldier is hired.
| 50
|}

=== AI Units (Aliens/Civilians) ===

Defines an [[Alien Life Forms|alien]] (enemy) or [[civilian]] (neutral) unit, listed in ''"units:"''. Every different alien rank is a different unit, since they have completely different stats. Unit stats are represented as follows:
* [[Time Units|tu]]
* [[Energy|stamina]]
* [[Health|health]]
* [[Bravery|bravery]] (always a multiple of 10)
* [[Reactions|reactions]]
* [[Firing Accuracy|firing]]
* [[Throwing Accuracy|throwing]]
* [[Strength|strength]]
* [[Psi Strength|psiStrength]]
* [[Psi Skill|psiSkill]]
* [[Melee Accuracy|melee]] (not visible)

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the unit name.
| ''required''
|-
| '''race'''
| String ID of the unit race (for alien units).
| -
|-
| '''rank'''
| String ID of the unit rank (for alien units).
| -
|-
| '''stats'''
| Battlescape stats of this unit.
| -
|-
| '''armor'''
| String ID of the [[#Armor|armor]] this unit uses by default.
| -
|-
| '''standHeight'''
| Height of this unit when standing.
| 0
|-
| '''floatHeight'''
| Distance between the bottom of this unit and the ground.
| 0
|-
| '''value'''
| [[Score]] this unit is worth.
| 0
|-
| '''deathSound'''
| Sound ID from [[#Extra_Sounds|BATTLE.CAT]] played when this unit dies.
| -1
|-
| '''aggroSound'''
| Sound ID from [[#Extra_Sounds|BATTLE.CAT]] played when this unit aggros.
| -1
|-
| '''moveSound'''
| Sound ID from [[#Extra_Sounds|BATTLE.CAT]] played when this unit moves.
| -1
|-
| '''intelligence'''
| Intelligence of this unit's AI. The higher the value, the longer this unit remembers player troops between turns.
| 0
|-
| '''aggression'''
| Aggression of this unit's AI. The higher the value, the more ruthless the unit, the more likely to make a frontal assault. Less aggressive units tend to set up ambushes.
Vanilla values are:
* 0 = mostly passive
* 1 = balanced
* 2 = mostly aggresive
| 0
|-
| '''energyRecovery'''
| Energy recovered by the unit each turn (needs verification)
| 40 (?)
|-
| '''specab'''
| Special ability of this unit:
* 0 = None
* 1 = [[Cyberdisc|Explodes on Death]]
* 2 = [[Silacoid|Burns Floor]]
* 3 = [[Bio-Drone|Burns Floor and explodes on Death]]
| 0
|-
| '''spawnUnit'''
| String ID of the unit used to respawn on death (eg. [[Zombie]]s respawn as [[Chrysallid]]s).
| -
|-
| '''livingWeapon'''
| Is this unit a living weapon? (only attacks with a '''fixedWeapon''')
| false
|-
| '''female'''
| Is this unit a female? (used for TFTD civilian types)
| false
|-
|}

=== Alien Races ===

Defines a [[Alien Life Forms|race]] used in [[Alien Missions]], listed in ''"alienRaces:"''. Heavily tied with deployment data.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''id'''
| String ID of the alien race name.
| ''required''
|-
| '''members'''
| Alien crew associated with this alien race (eg. race units + terrorist units), defined by a list of unit string IDs. Order here will define rank in terms of deployment. generally speaking the order is:
* 0 - Commander
* 1 - Leader
* 2 - Engineer
* 3 - Medic
* 4 - Navigator
* 5 - Soldier
* 6 - Terrorist 1
* 7 - Terrorist 2
but of course, not all races have all ranks, so the "fill in" rank would be listed multiple times (see ethereals).
| -
|-
| '''retaliation'''
| retaliation enables/disables the race for retaliation missions.
| ''True''
|-
|}

=== Alien Deployments ===

Defines a Battlescape deployment data used in [[Alien Missions]] (such as alien and map configurations), listed in ''"alienDeployments:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the deployment name.
| ''required''
|-
| '''width'''
| Width of the Battlescape map in grid units.
| 0
|-
| '''length'''
| Length of the Battlescape map in grid units.
| 0
|-
| '''height'''
| Vertical height of the Battlescape map in grid units.
| 0
|-
| '''terrains'''
| list of string IDs of the [[#Terrains|terrain]] to choose from to generate this map. This is not used for UFO sites where the terrain comes from the Geoscape.
| -
|-
| '''shade'''
| Shade of the map (0-15, where 0 is full daytime and 15 is full nighttime). This is not used for UFO sites where the shade comes from the Geoscape.
| 0
|-
| '''nextStage'''
| String ID of the next deployment stage to use after this one, for multi-stage missions.
| -
|-
| '''race'''
| Sets the race to use in the next stage.
| ""
|-
| '''script'''
| Reference to a mapScript.
| ""
|-
| '''data'''
| List of deployment data for each alien rank on this mission (see below).
| -
|}

Notes:
* '''terrains''' can also be used with UFOs, with the game using instead the listed terrain rather than the location of the UFO on Geoscape.
==== Deployment Data ====

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''alienRank'''
| [[Alien Rank|Rank]] associated with this deployment data, as defined by the order of the race in question (see above)
| ''required''
|-
| '''lowQty'''
| Maximum quantity of aliens to spawn (beginner).
| 0
|-
| '''highQty'''
| Maximum quantity of aliens to spawn (superhuman).
| 0
|-
| '''dQty'''
| Minimum Desired Quantity of aliens to spawn.
| 0
|-
| '''extraQty'''
| spawns a random number of additional aliens.
| 0
|-
| '''percentageOutsideUfo'''
| Percentage (0-100%) of aliens to spawn outside in UFO sites.
| 0
|-
| '''itemSets'''
| Three lists (one for each alien technology level) of [[#Items|items]] (string IDs) for the aliens to equip.
| ''required''
|-
|}

=== Research ===

Defines a [[Research|research topic]] that X-COM scientists can investigate, listed in ''"research:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''name'''
| String ID of the research project's name (or item, if a '''lookup''' is defined).
| ''required''
|-
| '''lookup'''
| String ID of the research project's display name and UFOPaedia article reference.
| -
|-
| '''cost'''
| Number of man hours (on average) required to complete this project.
| 0
|-
| '''points'''
| [[Score]] earned for completing this project.
| 0
|-
| '''needItem'''
| Does this project require an [[#Items|item]] of the same name?
| false
|-
| '''dependencies'''
| List of research projects that can unlock access to this one. If the full list is researched, or if one of the projects on the list "unlocks" this one, it becomes available.
| -
|-
| '''unlocks'''
| List of research projects unlocked, regardless of other dependencies, but not requirements, by completing this project (for example, any live alien unlocks "alien origins").
| -
|-
| '''requires'''
| List of research projects unilaterally required before this project can be unlocked (for example, "the martian solution" will not even be considered for unlocking until AFTER "alien origins" is completed).
| -
|-
| '''getOneFree'''
| List of "bonus" research projects that may be granted when completing this project (for example, alien medics will give you information on other alien races). Only applies to living aliens.
| -
|-
|}

=== Manufacture ===

Defines a [[Manufacture|manufacture project]] that X-COM engineers can produce, listed in ''"manufacture:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''name'''
| String ID of the manufacturing project's name (and the item it produces).
| ''required''
|-
| '''category'''
| String ID of the manufacturing project's category.
| -
|-
| '''requires'''
| List of [[#Research|topics]] (string IDs) that must be researched to unlock this project. If none are specified, this project is unlocked from the start.
| -
|-
| '''space'''
| Amount of [[Workshop]] space required to begin this project.
| 0
|-
| '''time'''
| Number of man hours (on average) required per item.
| 0
|-
| '''cost'''
| Monetary deduction per item manufactured.
| 0
|-
| '''requiredItems'''
| List of [[#Items|items]] required and consumed per item manufactured.
| -
|-
| '''producedItems'''
| List of [[#Items|items]] produced per each item consumed. If not specified, defaults to 1 item with the same string ID as the manufacture.
| 1
|-
|}

=== UFOpaedia Article ===

Defines an article in the in-game [[UFOpaedia]], listed in ''"ufopaedia:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''id'''
| String ID of the article name. This must match the ID of the object associated with this article, if applicable.
| ''required''
|-
| '''title'''
| String ID of the article title. If omitted, the '''id''' is used.
| -
|-
| '''type_id'''
| Type of this article:
* 0 = Unknown
* 1 = [[Craft]]
* 2 = [[Craft Armaments]]
* 3 = [[HWP]]
* 4 = [[Equipment (EU)|Equipment]]
* 5 = [[Armour]]
* 6 = [[Base Facilities]]
* 7 = Text & Image (eg. [[Alien Life Forms]], [[UFO Components]])
* 8 = Text (eg. [[Alien Research]])
* 9 = [[UFO]]
* 10 = [[TFTD]]
* 11 = TFTD [[Subs]]
* 12 = TFTD [[Sub_Armaments]]
* 13 = TFTD [[Submersible_Weapons_Systems]]
* 14 = TFTD [[Equipment_(TFTD)]]
* 15 = TFTD Armour
* 16 = TFTD [[Base_Facilities_(TFTD)]]
* 17 = TFTD [[Alien_Subs]]
| 0
|-
| '''section'''
| String ID of the UFOpaedia section this article belongs in.
| -
|-
| '''requires'''
| List of [[#Research|topics]] (string IDs) that must be researched to unlock this article. If none are specified, this article is unlocked from the start.
| -
|-
| '''image_id'''
| Filename of the [[UP001.SPK-UP042.SPK|background image]] displayed on this article, if applicable.
| -
|-
| '''text'''
| String ID of the description displayed on this article.
| -
|-
| '''text_width'''
| Maximum width of the text displayed, only applicable to ''Text & Image'' articles.
| 150
|-
| '''rect_stats'''
| Rectangle ('''x''', '''y''', '''width''', '''height''') of the stats text on the screen, only applicable to ''Craft'' articles.
| 0
|-
| '''rect_text'''
| Rectangle ('''x''', '''y''', '''width''', '''height''') of the description text on the screen, only applicable to ''Craft'' articles.
| 0
|-
| '''weapon'''
| String ID of the weapon, only applicable to ''HWP'' articles.
| -
|}

=== UFO Trajectories ===

Defines a trajectory carried out by an UFO during an [[#Alien Missions|alien mission]], listed in ''"ufoTrajectories:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''id'''
| String ID of the trajectory name.
| ''required''
|-
| '''groundTimer'''
| Amount of seconds for the UFO to spend on Ground waypoints.
| 0
|-
| '''waypoints'''
| List of waypoints for the UFO to traverse, defined as ''[zone, altitude, speed]''. 
'''zone''': Globe zone where the waypoint is located. 
'''altitude''': UFO altitude after reaching this waypoint:
* 0 - Ground
* 1 - Very Low
* 2 - Low
* 3 - High
* 4 - Very High
'''speed''': UFO speed after reaching this waypoint, as a percentage (0-100%) of its maximum speed.
| -
|}

=== Alien Missions ===

Defines an [[Alien Missions|alien mission]] carried out by UFOs on the Geoscape, listed in ''"alienMissions:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the mission type.
| ''required''
|-
| '''points'''
| [[Score]] allocated to aliens for successfully completing this mission.
| 0
|-
| '''raceWeights'''
| List of alien races likely to carry out this mission, and the % chance of them being allocated to this mission, listed by "number of months after game beginning".
| ''required''
|-
| '''waves'''
| List of UFO waves to spawn as this mission progresses, as described below.
| ''required''
|}

==== Waves ====

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''ufo'''
| String ID of the [[#UFOs|UFO]] to spawn.
| ''required''
|-
| '''count'''
| Number of UFOs to spawn.
| 0
|-
| '''trajectory'''
| String ID of the [[#UFO Trajectories|trajectory]] for this UFO to use when entering Earth's atmosphere.
| ''required''
|-
| '''timer'''
| How long after the previous wave should this wave arrive? (in seconds)
| 0
|-
|}

=== Alien Item Levels ===

This is a list of item level probabilities, with a number between 0 and 2 representing an item level from plasma pistols to heavy plasmas, as defined in the deployments, expressing a 10% probability for that item level being used.

0 = first set (plasma pistol/clip)
1 = second set (plasma rifle/clip)
2 = third set (heavy plasma/clip)

For example:
[ 2, 0, 0, 0, 0, 0, 0, 1, 1, 1 ]
would represent a 60% chance for pistols, 30% rifles, and 10% heavy weapons. 
Note that the order does not matter, but the length DOES. each line MUST have 10 digits.

The above can be confusing. There are 10 fields; each number represents 10%. 
There are six instances of '0'. 6x10% = 60% chance of plasma pistol 
There are three instances of '1'. 3x10% = 30% chance of plasma rifle 
There is only one instance of '2'. 1x10% = 10% chance of heavy plasma 

Each line represents a month after the beginning of the game, and there is no limit to the number defined. 
OpenXCom will use the most recently available item level in the event the game goes on forever.

=== Extra Sprites ===

Adds or replaces sprites in an existing [[Image Formats|X-COM image file]], listed in ''"extraSprites:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| Filename of the original/new image to modify.
| ''required''
|-
| '''width'''
'''height'''
| Size of the sprite(s) in pixels.
| 0
0
|-
| '''singleImage'''
| Is the image file just a single sprite (true) or a spritesheet (false)?
| false
|-
| '''subX'''
'''subY'''
| Size of the subdivision in pixels. If a subdivision is specified, then the image file is divided into chunks to form the sprites (eg. spritesheets).
| 0
0
|-
| '''files'''
| List of the new sprites to add/replace, listed as ''spriteID: filename''.
| -
|}

Example:
- type: GIANTBUNNY.PCK
width: 32
height: 40
files:
0: Resources/Bunny/Bunny00.png
1: Resources/Bunny/Bunny01.bmp
2: Resources/Bunny/Bunny02.gif

=== Extra Sounds ===

Adds or replaces sounds in an existing [[SOUND|X-COM sound file]], listed in ''"extraSounds:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| ID of the original sound file to modify:
* BATTLE.CAT - Battlescape sounds, corresponds to ''SOUND1.CAT'' or ''SAMPLE2.CAT'' (55 sounds).
* INTRO.CAT - Intro sounds, corresponds to ''INTRO.CAT'' or ''SAMPLE3.CAT'', probably best not to mess with these.
* GEO.CAT - Geoscape sounds, corresponds to ''SOUND2.CAT'' or ''SAMPLE.CAT'' (14 sounds).
| ''required''
|-
| '''files'''
| List of the new sounds to add/replace, listed as ''soundID: filename''.
| -
|}

Example:
- type: BATTLE.CAT
files:
55: Resources/Sounds/sample.wav

=== Extra Strings ===

Adds or replaces text strings in an existing [[Translations (OpenXcom)|OpenXcom language file]], listed in ''"extraStrings:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| Filename of the original language file to modify, sans extension.
| ''required''
|-
| '''strings'''
| List of the new strings to add/replace, listed as ''stringID: text''.
| -
|}

Example:
- type: en-US
strings:
STR_SNIPER_RIFLE: Sniper Rifle
STR_SNIPER_RIFLE_CLIP: Sniper Rifle Clip
- type: en-GB
strings:
STR_SNIPER_RIFLE: Sniper Rifle
STR_SNIPER_RIFLE_CLIP: Sniper Rifle Clip
- type: de
strings:
STR_SNIPER_RIFLE: Scharfschützengewehr
STR_SNIPER_RIFLE_CLIP: Scharfschützengewehrmunition
- type: ru
strings:
STR_SNIPER_RIFLE: Снайперская винтовка
STR_SNIPER_RIFLE_CLIP: Магазин к снайп. винтовке

=== Interfaces ===

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| ''?''
| -
|-
| '''elements'''
| ''?''
| -
|-
| '''id'''
| ''?''
| -
|-
| '''color'''
| ''?''
| -
|}

=== StatStrings ===

[[Statstrings]] are used for automatically renaming soldiers. They are case sensitive and they are processed in the order in which they are specified.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''string'''
| String to add to name.
| ''required''
|-
| '''psiStrength''' 
'''psiSkill''' 
'''bravery''' 
'''strength''' 
'''firing''' 
'''reactions''' 
'''stamina''' 
'''tu''' 
'''health''' 
'''throwing'''
| One or more stat ranges are ANDed together for success. Each range has a minVal and maxVal. Use YAML standard tilde (~) to indicate null. ((~) = 0 as minvalue; (~) =255 as maxvalue)
| -
|}

Example:
statStrings:
- string: "x"
psiStrength: [~, 30]
- string: "P"
psiStrength: [80, ~]
- string: "p"
psiStrength: [60, 79]
- string: "K"
psiSkill: [60, ~]
- string: "k"
psiSkill: [30, 59]
- string: "b"
bravery: [60, ~]
- string: "c"
bravery: [~, 10]
- string: "w"
strength: [~, 25]
- string: "Snpr"
firing: [60, ~]
reactions: [60, ~]
- string: "M"
firing: [70, ~]
- string: "m"
firing: [60, 69]
- string: "Sct"
reactions: [50, ~]
tu: [60, ~]
- string: "R"
reactions: [60, ~]
- string: "r"
reactions: [50, 59]

==References==
<references />

[[Category:OpenXcom]]

Ruleset Reference Nightly (OpenXcom)

2014-12-10T00:37:04Z

Falko:

A reference of all the customizable values of everything in a [[Rulesets (OpenXcom)|ruleset]], according to the latest nightly. This page should be updated as new versions become available in order to explain the changes from [[Ruleset Reference (OpenXcom)|version 1.0]].

Some guidelines:
* If a value is omitted from the ruleset, the default is used. You cannot omit ''required'' values.
* Text strings (eg. names) are represented by string IDs from the [[Translations (OpenXcom)|language files]]
* Numerical IDs (used for sprites, sounds, etc.) start at 0, not 1.
* Boolean (yes/no) values are represented by true/false.
* World coordinates are represented in degrees (see [[WORLD.DAT]]).
* Money amounts (prices, costs, etc.) are represented in dollars.
* All paths are '''case sensitive'''! If your ruleset uses external files, make sure that they named properly as described in ruleset.

Items are ordered as they come in the ruleset. To override this, you can specify a ''listOrder''. You can find the default listOrders in [[Ruleset List Order (OpenXcom)|Ruleset List Order]].

=== Globe ===

Defines the drawing of landmasses and borders on the globe.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''data'''
| Path name of file which contains polygon and texture information. (For example WORLD.DAT).
| -
|-
| '''polygons'''
| List of polygons drawn on the globe surface. A triangle consist of seven values: the first number defines the texture, followed by three pairs of (x,y) globe coordinates. Only polygons with 3 or 4 vertices are reliable shown on the globe = 7 or 9 values per entry.
| -
|-
| '''polylines'''
| List of border lines. Each list entry consist of a list of (x,y) globe coordinates.
| -
|}

=== Countries ===

Defines one of the [[Country Funding (EU)|funding nations]], listed in ''"countries:"''. They're used for activity graphs and player scoring.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the country name.
| ''required''
|-
| '''fundingBase'''
| Country's base funding, in thousands. The starting funding can be anywhere between 1x and 2x the base funding.
| 0
|-
| '''fundingCap'''
| Country's funding cap, in thousands. Once a country reaches this maximum, it will no longer increase its funding.
| 0
|-
| '''labelLon'''
'''labelLat'''
| Longitude and latitude coordinates of the country's label on the globe. This label is only shown when the globe is zoomed in and "detail" is turned on.
| 0.0
0.0
|-
| '''areas'''
| List of "rectangles" on the globe defined as [''lon1'' ''lat1'' ''lon2'' ''lat2'']. Any activity within these areas counts towards the country's graph activity and affects their opinion of the player.
| -
|}

=== Regions ===

Defines one of the [[Geoscape (EU)#World Regions/Countries|world regions]], listed in ''"regions:"''. They're used for base placement, activity graphs and mission spawning.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the region name.
| ''required''
|-
| '''cost'''
| Amount of money spent building an X-COM base in this region (first base is free).
| 0
|-
| '''areas'''
| List of "rectangles" on the globe defined as ''[lon1, lat1, lon2, lat2]''. Any activity within these areas counts towards the region's graph activity.
| -
|-
| '''cities'''
| List of cities belonging to this region. They will be displayed on the globe and used for terror site missions. Each city is defined by their '''lon''' and '''lat''' coordinates and a '''name''' string ID.
| -
|-
| '''regionWeight'''
| Weight of this region when selecting regions for alien missions.
| 0
|-
| '''missionWeights'''
| Weighted list of the different mission types for this region (eg. ''STR_ALIEN_RESEARCH: 14'').
| -
|-
| '''missionZones'''
| List of "rectangles" (''[lon1, lat1, lon2, lat2]'') defining the mission zones for this region. Mission zones are waypoints for UFO trajectories.
| -
|-
| '''missionRegion'''
| Spawn mission in this region instead (used for regions without land).
| -
|}

=== Base Facilities ===

Defines one of the [[Base Facilities (EU)|facilities]] that can be built in an X-COM base, listed in ''"facilities:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the facility name.
| ''required''
|-
| '''requires'''
| List of [[#Research|topics]] (string IDs) that must be researched to unlock this facility. If none are specified, this facility is unlocked from the start.
| -
|-
| '''spriteShape'''
| Sprite ID from [[BASEBITS.PCK]] used to draw the facility's outer shape in the Basescape and UFOpaedia.
| -1
|-
| '''spriteFacility'''
| Sprite ID from [[BASEBITS.PCK]] used to draw the facility's contents in the Basescape and UFOpaedia. Drawn on top of '''spriteShape'''.
| -1
|-
| '''lift'''
| Is this facility an [[Access Lift]]? All base facilities must be connected to the lift.
| false
|-
| '''hyper'''
| Is this facility a [[Hyperwave Decoder]]? Displays extra information for detected UFOs. Only valid for radar facilities.
| false
|-
| '''mind'''
| Is this facility a [[Mind Shield]]? Reduces the chance of UFOs finding your base. Does not stack.
| false
|-
| '''grav'''
| Is this facility a [[Grav Shield]]? Doubles the power of your base defenses. Does not stack.
| false
|-
| '''size'''
| Size of the facility, in grid units. Every facility is square, so a size of 1 means 1x1, 2 means 2x2, etc. Bigger facilities are made up of multiple sprites, for example a 2x2 facility will use 4 sprites for '''spriteShape''' and 4 sprites for '''spriteFacility''' (top-left, top-right, bottom-left, bottom-right).
| 1
|-
| '''buildCost'''
| Amount of money spent to build this facility in the base.
| 0
|-
| '''buildTime'''
| Amount of days it takes for this facility to be built.
| 0
|-
| '''monthlyCost'''
| Amount of money spent monthly for the maintenance of this facility.
| 0
|-
| '''storage'''
| Amount of storage space (for items) this facility provides. See [[Base Stores]].
| 0
|-
| '''personnel'''
| Amount of personnel (soldiers, scientsts, engineers) these quarters can contain.
| 0
|-
| '''aliens'''
| Amount of live aliens this facility can contain. Only checked if the ''alienContainmentLimitEnforced'' option is enabled.
| 0
|-
| '''crafts'''
| Amount of X-COM craft this facility can contain.
| 0
|-
| '''labs'''
| Amount of lab space this facility provides for research projects.
| 0
|-
| '''workshops'''
| Amount of workshop space this facility provides for manufacture projects.
| 0
|-
| '''psiLabs'''
| Amount of soldier space this facility provides for psionic training.
| 0
|-
| '''radarRange'''
| Maximum radar detection range of this facility, in nautical miles.
| 0
|-
| '''radarChance'''
| Chance (0-100%) of this radar detecting a UFO that enters its range.
| 0
|-
| '''defense'''
| Offensive power provided by this base defense against attacking UFOs.
| 0
|-
| '''hitRatio'''
| Chance (0-100) of the base defense hitting an attacking UFO.
| 0
|-
| '''fireSound'''
| Sound ID from [[#Extra_Sounds|GEO.CAT]] played when the base defense fires.
| -1
|-
| '''hitSound'''
| Sound ID from [[#Extra_Sounds|GEO.CAT]] played when the base defense hits a target.
| -1
|-
| '''mapName'''
| [[MAPS|Map]] associated to this facility in Battlescape base defenses.
| -
|-
|}

=== Crafts ===

Defines one of the [[Craft|X-COM crafts]] that go on interception missions, listed in ''"crafts:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the craft name.
| ''required''
|-
| '''requires'''
| List of [[#Research|topics]] (string IDs) that must be researched to unlock this craft. If none are specified, this craft is unlocked from the start.
| -
|-
| '''sprite'''
| Sprite ID from [[BASEBITS.PCK]] used to draw this craft in the Basescape and from [[INTICON.PCK]] used to draw the damage indicator in dogfights.
modders: the corresponding extrasprite file id for BASEBITS.PCK is sprite+33 INTICON.PCK contains a minimized icon id=sprite the file id for the dogfight image is sprite+11
| -1
|-
| '''fuelMax'''
| Maximum amount of fuel this craft can carry. Crafts use up fuel based on their speed while travelling.
| 0
|-
| '''damageMax'''
| Maximum amount of damage this craft can take. If this amount is exceeded, the craft is destroyed.
| 0
|-
| '''speedMax'''
| Maximum speed in nautical miles. Crafts travel at max speed when flying and half speed when patrolling.
| 0
|-
| '''accel'''
| Aceeleration value shown in the UFOpaedia.
| 0
|-
| '''weapons'''
| Amount of craft weapons this craft can equip. The UI can only display a max of 2 weapons.
| 0
|-
| '''soldiers'''
| Amount of soldiers this craft can carry.
| 0
|-
| '''maxItems'''
| Amount of items this craft can carry.
| 80
|-
| '''vehicles'''
| Amount of vehicles this craft can carry.
| 0
|-
| '''costBuy'''
| Amount of money spent for purchasing this craft. If set to 0, the craft will not be available in the Purchase/Recruit screen.
| 0
|-
| '''costRent'''
| Amount of money spent monthly for renting this craft. If set to 0, the craft is not on rental and won't count towards base maintenance.
| 0
|-
| '''costSell'''
| Amount of money gained for selling this craft.
| 0
|-
| '''refuelItem'''
| Item required for refuelling this craft. If no item is specified, the craft uses human fuel.
| 0
|-
| '''repairRate'''
| Amount of damage restored every hour while [[Repairs|Repairing]] in base.
| 1
|-
| '''refuelRate'''
| Amount of fuel restored every 30 mins while [[Refueling]] in base. If specified, a '''refuelItem''' is spent each time.
| 1
|-
| '''radarRange'''
| Detection range of the craft's radar in nautical miles. Every craft radar has a 100% detection chance.
| 600
|-
| '''transferTime'''
| Number of hours it takes to purchase/transfer this craft to a base.
| 0
|-
| '''score'''
| [[Score]] lost when this craft is destroyed.
| 0
|-
| '''spacecraft'''
| Can this craft go to [[Cydonia]]?
| false
|-
| '''battlescapeTerrainData'''
| [[#Terrains|Terrain]] associated to this craft in Battlescape missions.
| -
|}

=== Craft Weapons ===

Defines one of the [[Craft Armaments|weapons]] equipped by X-COM craft for shooting down UFOs, listed in ''"craftWeapons:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the weapon name.
| ''required''
|-
| '''sprite'''
| Sprite ID from [[BASEBITS.PCK]] used to draw the weapon in the Basescape and from [[INTICON.PCK]] used to draw the weapon in dogfights.
modders: the corresponding extrasprites file id for INTICON.PCK is sprite+5 and sprite+48 for BASEBITS.PCK
| -1
|-
| '''sound'''
| Sound ID from [[#Extra_Sounds|GEO.CAT]] played when this weapon fires.
| -1
|-
| '''damage'''
| Amount of damage this weapon does to enemy UFOs.
| 0
|-
| '''range'''
| Maximum range of this weapon in dogfights (in meters).
| 0
|-
| '''accuracy'''
| Chance (0-100%) of each shot hitting the enemy UFO.
| 0
|-
| '''reloadCautious'''
| Time this weapon takes to fire between each shot in ''Cautious Mode''.
| 0
|-
| '''reloadStandard'''
| Time this weapon takes to fire between each shot in ''Standard Mode''.
| 0
|-
| '''reloadAggressive'''
| Time this weapon takes to fire between each shot in ''Aggressive Mode''.
| 0
|-
| '''ammoMax'''
| Maximum amount of ammo this weapon can carry.
| 0
|-
| '''rearmRate'''
| Amount of ammo restored every 30 mins while the craft is [[Rearming]] in base. If specified, '''clip'''s are spent depending on their '''clipSize'''. If the '''clipSize''' of the specified ammo is 0, no '''clip'''s are spent.
| 1
|-
| '''projectileType'''
| Type of the weapon projectile, used for the projectile sprite in dogfights:
* 0 - [[Stingray]]
* 1 - [[Avalanche]]
* 2 - [[Cannon]]
* 3 - [[Fusion Ball]]
* 4 - [[Laser Cannon]]
* 5 - [[Plasma Beam]]
| 2
|-
| '''projectileSpeed'''
| Speed of the weapon projectile in dogfights.
| 0
|-
| '''launcher'''
| String ID of the [[#Items|item]] required to equip this weapon.
| -
|-
| '''clip'''
| String ID of the [[#Items|item]] required to rearm this weapon.
| -
|}

=== Items ===

Defines the Geoscape and Battlescape properties of an [[Equipment (EU)|item]] that can be stored in X-COM bases, listed in ''"items:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the internal item name.
| ''required''
|-
| '''name'''
| String ID of the displayed item name, for cases where it's different from the internal name. If omitted, '''type''' is used.
| -
|-
| '''requires'''
| List of [[#Research|topics]] (string IDs) that must be researched to unlock this item. If none are specified, this item is unlocked from the start. Soldiers can only use unlocked items in the Battlescape.
| -
|-
| '''size'''
| Space occupied by this item in [[Base Stores]]. Can be a decimal value.
| 0.0
|-
| '''costBuy'''
| Amount of money spent for purchasing this item. If set to 0, this item will not be available in the Purchase/Recruit screen.
| 0
|-
| '''costSell'''
| Amount of money gained for selling this item.
| 0
|-
| '''transferTime'''
| Number of hours it takes to purchase/transfer this item to a base.
| 24
|-
| '''weight'''
| [[Item_Weight|Weight]] occupied by this item in a soldier's inventory.
| 999
|-
| '''bigSprite'''
| Sprite ID from [[BIGOBS.PCK]] used to draw this item in a soldier's inventory and UFOpaedia.
| -1
|-
| '''floorSprite'''
| Sprite ID from [[FLOOROB.PCK]] used to draw this item on the floor of a Battlescape tile.
| -1
|-
| '''handSprite'''
| Sprite ID from [[HANDOB.PCK]] used to draw this item on a soldier's hand in the Battlescape.
modders: each handobject needs 8 images (8 directions) define the extrasprites accordingly
| 120
|-
| '''bulletSprite'''
| Sprite ID from ''BulletSprites.png'' used to draw this weapon's projectile on the Battlescape:
* 0 - [[Rocket Launcher]]
* 1 - [[Pistol]]
* 2 - [[Rifle]]
* 3 - [[Auto Cannon]]
* 4 - [[Heavy Cannon]]
* 5 - [[Laser Pistol]]
* 6 - [[Laser Rifle]]
* 7 - [[Heavy Laser]]
* 8 - [[Plasma Rifle|Plasma]]
* 9 - [[Small Launcher]]
* 10 - [[Blaster Launcher]]
for modders: the bulletsprite needs to be put into the extraSprites type "Projectiles" the bulletsprite can contain up to 35 3x3 images. The corresponding file id is 35*[bulletSprite]
| -1
|-
| '''fireSound'''
| Sound ID from [[#Extra_Sounds|BATTLE.CAT]] played when this weapon fires.
| -1
|-
| '''hitSound'''
| Sound ID from [[#Extra_Sounds|BATTLE.CAT]] played when this weapon hits a target.
| -1
|-
| '''hitAnimation'''
| Sprite ID from [[SMOKE.PCK]] used to draw the weapon's "hit explosion".
'''NOTE''': Do not define this value for melee/psi weapons, they use [[HIT.PCK]] and therefore meleeAnimation instead.
| 0
|-
| '''power'''
| Average damage of the weapon, in most cases it will be +-50% this value.
| 0
|-
| '''strengthApplied'''
| Add the attacking unit's strength to this weapon's damage.
| false
|-
| '''compatibleAmmo'''
| List of string IDs of the ammo items that can be loaded on this weapon. If none are specified, the weapon doesn't need ammo.
| -
|-
| '''damageType'''
| What type of [[damage]] does this weapon do:
* 0 - None
* 1 - Armor Piercing
* 2 - Incendiary
* 3 - High Explosive
* 4 - Laser
* 5 - Plasma
* 6 - Stun
* 7 - Melee
* 8 - Acid
* 9 - Smoke
'''NOTE:''' A damage type other than 0-9 will do nothing.
| 0
|-
| '''tuAuto'''
'''accuracyAuto'''
| The percentage (0-100%) of [[Time Units]] (from the soldier's total) required to fire an Auto Shot. If 0, the weapon does not have an Auto Shot.
The base accuracy (0-100%) applied to a soldier's [[Firing Accuracy]] when firing an Auto Shot.
| 0
0
|-
| '''tuSnap'''
'''accuracySnap'''
| The percentage (0-100%) of [[Time Units]] (from the soldier's total) required to fire a Snap Shot. If 0, the weapon does not have a Snap Shot.
The base accuracy (0-100%) applied to a soldier's [[Firing Accuracy]] when firing a Snap Shot.
| 0
0
|-
| '''tuAimed'''
'''accuracyAimed'''
| The percentage (0-100%) of [[Time Units]] (from the soldier's total) required to fire an Aimed Shot. If 0, the weapon does not have an Aimed Shot.
The base accuracy (0-100%) applied to a soldier's [[Firing Accuracy]] when firing an Aimed Shot.
| 0
0
|-
|-
| '''tuMelee'''
'''accuracyMelee'''
| The percentage (0-100%) of [[Time Units]] (from the soldier's total) required to do a melee attack (Hit). If 0, the weapon does not have a melee attack.
The base accuracy (0-100%) applied to a soldier's [[Melee Accuracy]] when doing a melee attack.
| 0
0
|-
| '''clipSize'''
| The amount of ammo stored in each weapon clip. If -1 is specified, this weapon has infinite ammo.
| 0
|-
| '''battleType'''
| Defines the weapon's behavior in the Battlescape:
* 0 - None (Geoscape-only item)
* 1 - [[Weapons|Firearm]]
* 2 - Ammo
* 3 - Melee
* 4 - [[Grenade]]
* 5 - [[Proximity Grenade]]
* 6 - [[Medi-Kit (EU)|Medi-Kit]]
* 7 - [[Motion Scanner]]
* 8 - [[Mind Probe]]
* 9 - [[Psi-Amp]]
* 10 - [[Electro-flare]]
* 11 - Corpse
| 0
|-
| '''twoHanded'''
| Is this weapon two-handed? If true, incurs an accuracy penalty if used with both hands occupied. Note that the handsprite of a twoHanded item is also drawn at a slightly different position than a one handed item.
| false
|-
| '''waypoint'''
| Does this weapon use waypoints? (eg. [[Blaster Launcher]]). Can also be used to make ammo items use the waypoint system.
| false
|-
| '''fixedWeapon'''
| Is this weapon fixed? (it's part of a unit, eg. tanks and terrorist units)
| false
|-
| '''invWidth'''
| Item width in a soldier's inventory (in grid units).
| 1
|-
| '''invHeight'''
| Item height in a soldier's inventory (in grid units).
| 1
|-
| '''painKiller'''
| Amount of painkillers contained in a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''heal'''
| Amount of heal's contained in a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''stimulant'''
| Amount of stimulants contained in a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''woundRecovery'''
| Amount of [[Fatal Wounds]] treated by each heal of a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''healthRecovery'''
| Amount of [[Health]] recovered by each heal of a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''stunRecovery'''
| Amount of [[Stun]] removed by each stimulant of a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''energyRecovery'''
| Amount of [[Energy]] recovered by each stimulant of a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''tuUse'''
| Amount of [[Time Units]] required to use this item (for non-offensive items). It's a flat rate if '''flatRate''' is true, otherwise it's a percentage (0-100%).
| 0
|-
| '''recoveryPoints'''
| [[Score]] gained for recovering this alien artifact.
| 0
|-
| '''armor'''
| How much damage is needed to destroy this item on the ground.
| 20
|-
| '''recover'''
| Is this item recoverable? (gets transported to the X-COM base on mission success)
| true
|-
| '''turretType'''
| Sprite ID from [[TANKS.PCK]] of the turret to assign to this tank:
* 0 - [[Tank/Cannon]]
* 1 - [[Tank/Rocket Launcher]]
* 2 - [[Tank/Laser Cannon]]
* 3 - [[Hovertank/Plasma]]
* 4 - [[Hovertank/Launcher]]
| -1
|-
| '''liveAlien'''
| Does this item represent a live alien? (counts towards [[Alien Containment]])
| false
|-
| '''blastRadius'''
| Size of the projectile explosions. 0 for no explosion. -1 to automatically calculate based on weapon power and damage type (actual '''blastRadius''' currently is capped due [[Explosions#Playing_With_Fire|Explosion calculations]]).
| -1
|-
| '''flatRate'''
| If true, then TU costs for this weapon are a flat rate (instead of a percentage of unit TUs).
| false
|-
| '''arcingShot'''
| Does this weapon fire in an arc?
| false
|-
| '''attraction'''
| Represents how likely an alien is to pick up this item. Values below 5 will be ignored (by design).
| 0
|-
| '''maxRange'''
| Maximum range at which this weapon can operate.
| 200
|-
| '''aimRange'''
| Maximum effective range with this weapon before which range-based dropoff occurs.
| 200
|-
| '''snapRange'''
| Maximum effective range with snap shot before which range-based dropoff occurs. (ufoextender accuracy only)
| 15
|-
| '''autoRange'''
| Maximum effective range with auto shot before which range-based dropoff occurs. (ufoextender accuracy only)
| 7
|-
| '''minRange'''
| Range-based dropoff will work in reverse for ranges below this.
| 0
|-
| '''dropoff'''
| The value by which the accuracy lowers for each tile after (or before) the thresholds above.
| 2
|-
| '''bulletSpeed'''
| How much faster (or slower, if you use a negative number) is a projectile fired from this weapon compared to the average.
| 0
|-
| '''autoShots'''
| How many auto shots does this weapon fire.
| 3
|-
| '''shotgunPellets'''
| Number of projectiles fired per unit of ammunition. (note: due to engine limitations it is currently impossible to draw multiple projectiles in flight.)
| 0
|-
| '''zombieUnit'''
| String ID of the unit used for zombification (eg. [[Chrysallid]]s turn units into [[Zombie]]s).
| none
|-
| '''meleeSound'''
| Sound ID from [[#Extra_Sounds|BATTLE.CAT]] played when this weapon attacks a target with melee.
| 39
|-
| '''meleeHitSound'''
| Sound ID from [[#Extra_Sounds|BATTLE.CAT]] played when this weapon HITS a target with melee.
| -1
|-
| '''meleeAnimation'''
| Sprite ID from HIT.PCK played when this weapon attacks a target with melee.
| 0
|-
| '''meleePower'''
| Damage this weapon will do when using melee. This only applies to Firearms, and is only available as stun damage. For normal melee weapons, use regular power and damage types.
| 0
|-
| '''LOSRequired'''
| Does this item require line of sight? (only applies to mind probes and psi-amps)
| false
|-
| '''skillApplied'''
| Is melee skill applied to the accuracy of an attack made with this object?
| true
|-
|}

=== UFOs ===

Defines one of the [[UFOs]] that invade Earth, listed in ''"ufos:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the UFO name.
| ''required''
|-
| '''size'''
| String ID of the UFO size.
| STR_VERY_SMALL
|-
| '''sprite'''
| Sprite ID from [[INTERWIN.DAT]] used to draw this UFO in the dogfight view and UFOpaedia.
don't try to add more images if you don't want to punch yourself in the face - use modsprite
| -1
|-
| '''modSprite'''
| Filename used to draw this UFO in the dogfight view and UFOpaedia.
| -
|-
| '''damageMax'''
| Maximum amount of damage this UFO can take. If the UFO takes 50% damage, it crash lands. If it takes 100% damage, it is destroyed.
| 0
|-
| '''speedMax'''
| Maximum speed in nautical miles.
| 0
|-
| '''accel'''
| Aceeleration value shown in the UFOpaedia.
| 0
|-
| '''power'''
| Damage power of this UFO's weapon in dogfights.
| 0
|-
| '''range'''
| Maximum range of this UFO's weapon in dogfights (in meters).
| 0
|-
| '''score'''
| [[Score]] gained when this UFO is destroyed, or half this score if it crash lands.
| 0
|-
| '''reload'''
| Time the UFO's weapon takes to fire between each shot.
| 0
|-
| '''breakOffTime'''
| Minimum amount of time for the UFO to be able to break off of a dogfight.
| 0
|-
| '''battlescapeTerrainData'''
| [[#Terrains|Terrain]] associated to this UFO in Battlescape missions.
| ''required''
|-
|}

=== Inventory Sections ===

Defines one of the sections of the [[Inventory TU Table|Battlescape inventory]] (eg. Backpack), listed in ''"invs:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the inventory name.
| ''required''
|-
| '''x'''
'''y'''
| Pixel coordinates of this section on the inventory screen.
| 0
0
|-
| '''type'''
| Type of this section:
* 0 = Slot section, can contain as many items as will fit on the slots.
* 1 = Hand section, can only contain one item regardless of size.
* 2 = Ground section, can contain infinite items.
| 0
|-
| '''slots'''
| List of the grid slots (''[x, y]'') that this section is composed of. For example, to make a 2x2 section, you would have ''[0, 0] [0, 1] [1, 0] [1, 1]''.
| -
|-
| '''costs'''
| List of [[Time Units]] costs to move an item from this section to another one (eg. ''STR_BACKPACK: 16'' means it will cost 16 TUs to move an item from this section to the Backpack).
| -
|-
|}

=== Terrains ===

Defines one of the [[TERRAIN|terrains]] used to generate a Battlescape map, listed in "terrains:".

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''name'''
| String ID of the terrain name.
| ''required''
|-
| '''textures'''
| List of [[TEXTURE.DAT|Geoscape textures]] that correspond to this terrain.
| -
|-
| '''hemisphere'''
| Geoscape hemisphere associated with this terrain:
* -1 - Northern hemisphere.
* 0 - Both hemispheres.
* 1 - Southern hemisphere.
| 0
|-
| '''mapDataSets'''
| List of filenames (each with matching [[MCD]]/[[Image Formats#PCK|PCK/TAB]] files) that contain the tiles of this terrain.
| -
|-
| '''mapBlocks'''
| List of map blocks (see below) that are used for generating a map.
| -
|-
| '''civilianTypes'''
| List of units to use as civilians for this mission.
| [MALE_CIVILIAN, FEMALE_CIVILIAN]
|-
|}

==== Map Blocks ====

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''name'''
| Filename of the [[MAPS|map]].
| ''required''
|-
| '''width'''
| Width of this map block in Battlescape grid units.
| 0
|-
| '''length'''
| Length of this map block in Battlescape grid units.
| 0
|-
| '''height'''
| Height of this map block in Battlescape grid units.
| 1
|-
| '''groups'''
| List (or single number) of groups this mapblock belongs to (used in mapscripts)
default usage:
* 0 - Default
* 1 - Landing Zone (for placing X-COM / alien craft) (used in addcraft/ufo command)
* 2 - E-W Road (for city maps) (used in addline command)
* 3 - N-S Road (for city maps) (used in addline command)
* 4 - Road Crossing (for city maps) (used in addline command)
| 0
|-
| '''items'''
| An array of items to add to this mapblock, an the positions to place them at.
| -1
|}

* '''hemisphere''' only applies to UFO missions, not Terror ones.
*'''width/length''' defines the size of the map
** be aware that the mapview "width"-label is the openxcom ruleset length parameter
** be aware that the mapview "length"-label is the openxcom ruleset width parameter

==== Guidelines/Tips ====
* All maps with an XCOM/Alien craft require at least one map block assigned to Group 1. This map block can only contain ground tiles (no walls or objects), otherwise the game will crash or the walls/objects will be removed.
* All Terror terrains (listed under STR_TERROR_MISSION) require the Groups of '''Types''' 2, 3 and 4 (for a total of 3 maps, which are required to place roads).

=== Map Scripts ===

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| name of the script
| ''required''
|-
| '''commands'''
| List of MapCommands
| -
|}

==== Map Command ====

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| Currently these commands are implemented:
* addBlock
* addLine
* addCraft
* addUFO
* digTunnel
* fillArea
* checkBlock
* removeBlock
* resize
depending on the command type some of the following parameters are needed
| ''required''
|-
| '''label'''
| A numeric label that can be used for conditional execution of commands.
Each label should be unique within the terrain list (0=default no need for uniqueness).
| 0
|-
| '''conditionals'''
| Defines the conditions that allows the execution of this command.
eg. [1, -4] means it will be executed if command with label 1 was a success and command with label 4 failed.
commands that are not yet executed are always in failed state.
| 0
|-
| '''executionChances'''
| the chance that this command will be executed (or fails)
| 100
|-
| '''executions'''
| this command will be executed multiple times with a value > 1
| 1
|-
| '''groups'''
| Defines the what mapblock are used within this command. Can be list of goups or a single number.
| 0
|-
| '''blocks'''
| Alternative to groups. Here we define a list of mapblocks that are used within this command.
| 0
|-
| '''rects'''
| A list of possible ranges where (random) placement/checks/removal can happen in a map.
Is a list of a list of four integers.
| ?
|-
| '''size'''
| size of mapblocks that can be placed/checked/removed within rects. Also used for resize command type.
| ?
|-
| '''freqs'''
| For a list of mapblocks (defined by blocks?) we can define distribution frequency here.
| 1
|-
| '''maxUses'''
| For a list of mapblocks (defined by blocks?) we can define the maximal amount a mapblock can be used here.
| -1
|-
| '''direction'''
| used for addLine command type. Values are both, horizontal or vertical. Typically defines the road type distribution.
| -1
|-
| '''tunnelData'''
| Parameter for digTunnel command type. Contains level (default: 0) and a list of MCD replacement rules (MCDReplacements)
| 0
|}

==== Guidelines/Tips ====
* The Mapscript is still somewhat in development

=== Armor ===

Defines a Battlescape unit's [[armor]] as well as visual representation (so every unit has an armor), listed in ''"armors:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the armor name.
| ''required''
|-
| '''spriteSheet'''
| Sprite sheet from [[UNITS]] used to draw a unit wearing this armor.
| -
|-
| '''spriteInv'''
| Sprite used for the [[Inventory Backgrounds]] of a unit wearing this armor.
| -
|-
| '''corpseBattle'''
| List of string IDs of the corpse [[#Items|items]] generated when a unit wearing this armor is killed (one per unit tile) on the Battlescape.
| -
|-
| '''corpseGeo'''
| String ID of the corpse [[#Items|item]] associated with this unit on the Geoscape.
| -
|-
| '''storeItem'''
| String ID of the [[#Items|item]] that represents this armor in [[Base Stores]] for equipping.
| -
|-
| '''weight'''
| Physical weight of the armor when worn
| 6
|-
| '''stats'''
| like soldier stats (see below) but these are treated as stat bonuses for wearing the specific armor.
| -
|-
| '''frontArmor'''
| Protection provided on the front of the unit.
| 0
|-
| '''sideArmor'''
| Protection provided on the sides of the unit.
| 0
|-
| '''rearArmor'''
| Protection provided on the rear of the unit.
| 0
|-
| '''underArmor'''
| Protection provided under the unit (eg. from explosions).
| 0
|-
| '''drawingRoutine'''
| Drawing routine used to put together the body parts in the unit's '''spriteSheet''':
* 0 = [[Soldier]], [[Sectoid]]
* 1 = [[Floater]]
* 2 = [[HWP]]
* 3 = [[Cyberdisk]]
* 4 = [[Civilian]], [[Ethereal]]
* 5 = [[Sectopod]], [[Reaper]]
* 6 = [[Snakeman]]
* 7 = [[Chryssalid]]
* 8 = [[Silacoid]]
* 9 = [[Celatid]]
* 10 = [[Muton]]
* 11 = [[Submersible Weapons Systems]]
* 12 = [[Hallucinoid]]
* 13 = [[Aquanauts]]
* 14 = [[Calcinite]], [[Deep One]], [[Gillman]], [[Lobster Man]], [[Tasoth]]
* 15 = [[Aquatoid]]
* 16 = [[Bio-Drone]]
| 0
|-
| '''movementType'''
| Type of movement provided by this armor:
* 0 = Walking
* 1 = Flying
* 2 = Sliding (no walking animation)
it also defines the body of an tank (32-images) in your spriteSheet or the change in sprites while flying using a flying armour see: [[TANKS.PCK]], [[XCOM_2.PCK]]
| 0
|-
| '''damageModifier'''
| List of decimal damage modifiers (1.0 = 100%) this armor applies to each damage type (see [[#Items|Items section]]) received. Modifiers must be specified for all damage types, in this order:
* None
* Armor Piercing
* Incendiary
* High Explosive
* Laser
* Plasma
* Stun
* Melee
* Acid
* Smoke
|
- 1.0 
- 1.0 
- 1.0 
- 1.0 
- 1.0 
- 1.0 
- 1.0 
- 1.0 
- 1.0 
- 1.0
|-
| '''size'''
| Size of the unit wearing this armor, in Battlescape grid units. Every unit is square, so a size of 2 means 2x2.
| 1
|-
| '''loftempsSet'''
| List of [[LOFTEMPS]] IDs (one per unit tile, so a 1x1 unit has 1, a 2x2 unit has 4, etc.) used to represent a unit wearing this armor in 3D space.
| -
|-
| '''loftemps'''
| loftemps is a deprecated option that only works for 1x1 sized units.
| -
|-
| '''forcedTorso'''
| soldier sprites have female and male torsos. some armours reuse these sprites for flying/non flying torso without difference between genders. This can be controlled by the parameter: 0 = use genderrelated torso, 1 = use male torso, 2 = use female torso
| 0

|}

=== Player Units (Soldiers) ===

Defines a [[soldier]] recruited by X-COM, listed in ''"soldiers:"''. Currently only one soldier unit type (''XCOM'') is supported.

Unit stats are represented as follows:
* [[Time Units|tu]]
* [[Energy|stamina]]
* [[Health|health]]
* [[Bravery|bravery]] (always a multiple of 10)
* [[Reactions|reactions]]
* [[Firing Accuracy|firing]]
* [[Throwing Accuracy|throwing]]
* [[Strength|strength]]
* [[Psi Strength|psiStrength]]
* [[Psi Skill|psiSkill]]
* [[Melee Accuracy|melee]] (not visible)

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the soldier name.
| ''required''
|-
| '''minStats'''
| Minimum values used to generate the soldier's [[Starting Stats]]. In this case, ''psiSkill'' is treated as the initial stat (not generated).
| -
|-
| '''maxStats'''
| Maximum values used to generate the soldier's [[Starting Stats]]. In this case, ''psiSkill'' is treated as the minimum value for the first month of psi training (actual value is 100%-150%).
| -
|-
| '''statCaps'''
| Maximum stats this soldier can gain through [[Experience]]. '''NOTE:''' A stat will still go over the limit once, and then will no longer increase (see [[Experience#Regarding Caps|Regarding Caps]]).
| -
|-
| '''armor'''
| String ID of the [[#Armor|armor]] this soldier uses by default.
| -
|-
| '''standHeight'''
| Height of this soldier when standing.
| 0
|-
| '''kneelHeight'''
| Height of this soldier when kneeling.
| 0
|-
| '''floatHeight'''
| Distance between the bottom of this unit and the ground.
| 0
|-
| '''femaleFrequency'''
| The probability that a female soldier is hired.
| 50
|}

=== AI Units (Aliens/Civilians) ===

Defines an [[Alien Life Forms|alien]] (enemy) or [[civilian]] (neutral) unit, listed in ''"units:"''. Every different alien rank is a different unit, since they have completely different stats. Unit stats are represented as follows:
* [[Time Units|tu]]
* [[Energy|stamina]]
* [[Health|health]]
* [[Bravery|bravery]] (always a multiple of 10)
* [[Reactions|reactions]]
* [[Firing Accuracy|firing]]
* [[Throwing Accuracy|throwing]]
* [[Strength|strength]]
* [[Psi Strength|psiStrength]]
* [[Psi Skill|psiSkill]]
* [[Melee Accuracy|melee]] (not visible)

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the unit name.
| ''required''
|-
| '''race'''
| String ID of the unit race (for alien units).
| -
|-
| '''rank'''
| String ID of the unit rank (for alien units).
| -
|-
| '''stats'''
| Battlescape stats of this unit.
| -
|-
| '''armor'''
| String ID of the [[#Armor|armor]] this unit uses by default.
| -
|-
| '''standHeight'''
| Height of this unit when standing.
| 0
|-
| '''floatHeight'''
| Distance between the bottom of this unit and the ground.
| 0
|-
| '''value'''
| [[Score]] this unit is worth.
| 0
|-
| '''deathSound'''
| Sound ID from [[#Extra_Sounds|BATTLE.CAT]] played when this unit dies.
| -1
|-
| '''aggroSound'''
| Sound ID from [[#Extra_Sounds|BATTLE.CAT]] played when this unit aggros.
| -1
|-
| '''moveSound'''
| Sound ID from [[#Extra_Sounds|BATTLE.CAT]] played when this unit moves.
| -1
|-
| '''intelligence'''
| Intelligence of this unit's AI. The higher the value, the longer this unit remembers player troops between turns.
| 0
|-
| '''aggression'''
| Aggression of this unit's AI. The higher the value, the more ruthless the unit, the more likely to make a frontal assault. Less aggressive units tend to set up ambushes.
Vanilla values are:
* 0 = mostly passive
* 1 = balanced
* 2 = mostly aggresive
| 0
|-
| '''energyRecovery'''
| Energy recovered by the unit each turn (needs verification)
| 40 (?)
|-
| '''specab'''
| Special ability of this unit:
* 0 = None
* 1 = [[Cyberdisc|Explodes on Death]]
* 2 = [[Silacoid|Burns Floor]]
* 3 = [[Bio-Drone|Burns Floor and explodes on Death]]
| 0
|-
| '''spawnUnit'''
| String ID of the unit used to respawn on death (eg. [[Zombie]]s respawn as [[Chrysallid]]s).
| -
|-
| '''livingWeapon'''
| Is this unit a living weapon? (only attacks with a '''fixedWeapon''')
| false
|-
| '''female'''
| Is this unit a female? (used for TFTD civilian types)
| false
|-
|}

=== Alien Races ===

Defines a [[Alien Life Forms|race]] used in [[Alien Missions]], listed in ''"alienRaces:"''. Heavily tied with deployment data.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''id'''
| String ID of the alien race name.
| ''required''
|-
| '''members'''
| Alien crew associated with this alien race (eg. race units + terrorist units), defined by a list of unit string IDs. Order here will define rank in terms of deployment. generally speaking the order is:
* 0 - Commander
* 1 - Leader
* 2 - Engineer
* 3 - Medic
* 4 - Navigator
* 5 - Soldier
* 6 - Terrorist 1
* 7 - Terrorist 2
but of course, not all races have all ranks, so the "fill in" rank would be listed multiple times (see ethereals).
| -
|-
| '''retaliation'''
| retaliation enables/disables the race for retaliation missions.
| ''True''
|-
|}

=== Alien Deployments ===

Defines a Battlescape deployment data used in [[Alien Missions]] (such as alien and map configurations), listed in ''"alienDeployments:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the deployment name.
| ''required''
|-
| '''width'''
| Width of the Battlescape map in grid units.
| 0
|-
| '''length'''
| Length of the Battlescape map in grid units.
| 0
|-
| '''height'''
| Vertical height of the Battlescape map in grid units.
| 0
|-
| '''terrains'''
| list of string IDs of the [[#Terrains|terrain]] to choose from to generate this map. This is not used for UFO sites where the terrain comes from the Geoscape.
| -
|-
| '''shade'''
| Shade of the map (0-15, where 0 is full daytime and 15 is full nighttime). This is not used for UFO sites where the shade comes from the Geoscape.
| 0
|-
| '''nextStage'''
| String ID of the next deployment stage to use after this one, for multi-stage missions.
| -
|-
| '''race'''
| Sets the race to use in the next stage.
| ""
|-
| '''script'''
| Reference to a mapScript.
| ""
|-
| '''data'''
| List of deployment data for each alien rank on this mission (see below).
| -
|}

Notes:
* '''terrains''' can also be used with UFOs, with the game using instead the listed terrain rather than the location of the UFO on Geoscape.
==== Deployment Data ====

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''alienRank'''
| [[Alien Rank|Rank]] associated with this deployment data, as defined by the order of the race in question (see above)
| ''required''
|-
| '''lowQty'''
| Maximum quantity of aliens to spawn (beginner).
| 0
|-
| '''highQty'''
| Maximum quantity of aliens to spawn (superhuman).
| 0
|-
| '''dQty'''
| Minimum Desired Quantity of aliens to spawn.
| 0
|-
| '''extraQty'''
| spawns a random number of additional aliens.
| 0
|-
| '''percentageOutsideUfo'''
| Percentage (0-100%) of aliens to spawn outside in UFO sites.
| 0
|-
| '''itemSets'''
| Three lists (one for each alien technology level) of [[#Items|items]] (string IDs) for the aliens to equip.
| ''required''
|-
|}

=== Research ===

Defines a [[Research|research topic]] that X-COM scientists can investigate, listed in ''"research:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''name'''
| String ID of the research project's name (or item, if a '''lookup''' is defined).
| ''required''
|-
| '''lookup'''
| String ID of the research project's display name and UFOPaedia article reference.
| -
|-
| '''cost'''
| Number of man hours (on average) required to complete this project.
| 0
|-
| '''points'''
| [[Score]] earned for completing this project.
| 0
|-
| '''needItem'''
| Does this project require an [[#Items|item]] of the same name?
| false
|-
| '''dependencies'''
| List of research projects that can unlock access to this one. If the full list is researched, or if one of the projects on the list "unlocks" this one, it becomes available.
| -
|-
| '''unlocks'''
| List of research projects unlocked, regardless of other dependencies, but not requirements, by completing this project (for example, any live alien unlocks "alien origins").
| -
|-
| '''requires'''
| List of research projects unilaterally required before this project can be unlocked (for example, "the martian solution" will not even be considered for unlocking until AFTER "alien origins" is completed).
| -
|-
| '''getOneFree'''
| List of "bonus" research projects that may be granted when completing this project (for example, alien medics will give you information on other alien races). Only applies to living aliens.
| -
|-
|}

=== Manufacture ===

Defines a [[Manufacture|manufacture project]] that X-COM engineers can produce, listed in ''"manufacture:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''name'''
| String ID of the manufacturing project's name (and the item it produces).
| ''required''
|-
| '''category'''
| String ID of the manufacturing project's category.
| -
|-
| '''requires'''
| List of [[#Research|topics]] (string IDs) that must be researched to unlock this project. If none are specified, this project is unlocked from the start.
| -
|-
| '''space'''
| Amount of [[Workshop]] space required to begin this project.
| 0
|-
| '''time'''
| Number of man hours (on average) required per item.
| 0
|-
| '''cost'''
| Monetary deduction per item manufactured.
| 0
|-
| '''requiredItems'''
| List of [[#Items|items]] required and consumed per item manufactured.
| -
|-
| '''producedItems'''
| List of [[#Items|items]] produced per each item consumed. If not specified, defaults to 1 item with the same string ID as the manufacture.
| 1
|-
|}

=== UFOpaedia Article ===

Defines an article in the in-game [[UFOpaedia]], listed in ''"ufopaedia:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''id'''
| String ID of the article name. This must match the ID of the object associated with this article, if applicable.
| ''required''
|-
| '''title'''
| String ID of the article title. If omitted, the '''id''' is used.
| -
|-
| '''type_id'''
| Type of this article:
* 0 = Unknown
* 1 = [[Craft]]
* 2 = [[Craft Armaments]]
* 3 = [[HWP]]
* 4 = [[Equipment (EU)|Equipment]]
* 5 = [[Armour]]
* 6 = [[Base Facilities]]
* 7 = Text & Image (eg. [[Alien Life Forms]], [[UFO Components]])
* 8 = Text (eg. [[Alien Research]])
* 9 = [[UFO]]
* 10 = [[TFTD]]
* 11 = TFTD [[Subs]]
* 12 = TFTD [[Sub_Armaments]]
* 13 = TFTD [[Submersible_Weapons_Systems]]
* 14 = TFTD [[Equipment_(TFTD)]]
* 15 = TFTD Armour
* 16 = TFTD [[Base_Facilities_(TFTD)]]
* 17 = TFTD [[Alien_Subs]]
| 0
|-
| '''section'''
| String ID of the UFOpaedia section this article belongs in.
| -
|-
| '''requires'''
| List of [[#Research|topics]] (string IDs) that must be researched to unlock this article. If none are specified, this article is unlocked from the start.
| -
|-
| '''image_id'''
| Filename of the [[UP001.SPK-UP042.SPK|background image]] displayed on this article, if applicable.
| -
|-
| '''text'''
| String ID of the description displayed on this article.
| -
|-
| '''text_width'''
| Maximum width of the text displayed, only applicable to ''Text & Image'' articles.
| 150
|-
| '''rect_stats'''
| Rectangle ('''x''', '''y''', '''width''', '''height''') of the stats text on the screen, only applicable to ''Craft'' articles.
| 0
|-
| '''rect_text'''
| Rectangle ('''x''', '''y''', '''width''', '''height''') of the description text on the screen, only applicable to ''Craft'' articles.
| 0
|-
| '''weapon'''
| String ID of the weapon, only applicable to ''HWP'' articles.
| -
|}

=== UFO Trajectories ===

Defines a trajectory carried out by an UFO during an [[#Alien Missions|alien mission]], listed in ''"ufoTrajectories:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''id'''
| String ID of the trajectory name.
| ''required''
|-
| '''groundTimer'''
| Amount of seconds for the UFO to spend on Ground waypoints.
| 0
|-
| '''waypoints'''
| List of waypoints for the UFO to traverse, defined as ''[zone, altitude, speed]''. 
'''zone''': Globe zone where the waypoint is located. 
'''altitude''': UFO altitude after reaching this waypoint:
* 0 - Ground
* 1 - Very Low
* 2 - Low
* 3 - High
* 4 - Very High
'''speed''': UFO speed after reaching this waypoint, as a percentage (0-100%) of its maximum speed.
| -
|}

=== Alien Missions ===

Defines an [[Alien Missions|alien mission]] carried out by UFOs on the Geoscape, listed in ''"alienMissions:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the mission type.
| ''required''
|-
| '''points'''
| [[Score]] allocated to aliens for successfully completing this mission.
| 0
|-
| '''raceWeights'''
| List of alien races likely to carry out this mission, and the % chance of them being allocated to this mission, listed by "number of months after game beginning".
| ''required''
|-
| '''waves'''
| List of UFO waves to spawn as this mission progresses, as described below.
| ''required''
|}

==== Waves ====

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''ufo'''
| String ID of the [[#UFOs|UFO]] to spawn.
| ''required''
|-
| '''count'''
| Number of UFOs to spawn.
| 0
|-
| '''trajectory'''
| String ID of the [[#UFO Trajectories|trajectory]] for this UFO to use when entering Earth's atmosphere.
| ''required''
|-
| '''timer'''
| How long after the previous wave should this wave arrive? (in seconds)
| 0
|-
|}

=== Alien Item Levels ===

This is a list of item level probabilities, with a number between 0 and 2 representing an item level from plasma pistols to heavy plasmas, as defined in the deployments, expressing a 10% probability for that item level being used.

0 = first set (plasma pistol/clip)
1 = second set (plasma rifle/clip)
2 = third set (heavy plasma/clip)

For example:
[ 2, 0, 0, 0, 0, 0, 0, 1, 1, 1 ]
would represent a 60% chance for pistols, 30% rifles, and 10% heavy weapons. 
Note that the order does not matter, but the length DOES. each line MUST have 10 digits.

The above can be confusing. There are 10 fields; each number represents 10%. 
There are six instances of '0'. 6x10% = 60% chance of plasma pistol 
There are three instances of '1'. 3x10% = 30% chance of plasma rifle 
There is only one instance of '2'. 1x10% = 10% chance of heavy plasma 

Each line represents a month after the beginning of the game, and there is no limit to the number defined. 
OpenXCom will use the most recently available item level in the event the game goes on forever.

=== Extra Sprites ===

Adds or replaces sprites in an existing [[Image Formats|X-COM image file]], listed in ''"extraSprites:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| Filename of the original/new image to modify.
| ''required''
|-
| '''width'''
'''height'''
| Size of the sprite(s) in pixels.
| 0
0
|-
| '''singleImage'''
| Is the image file just a single sprite (true) or a spritesheet (false)?
| false
|-
| '''subX'''
'''subY'''
| Size of the subdivision in pixels. If a subdivision is specified, then the image file is divided into chunks to form the sprites (eg. spritesheets).
| 0
0
|-
| '''files'''
| List of the new sprites to add/replace, listed as ''spriteID: filename''.
| -
|}

Example:
- type: GIANTBUNNY.PCK
width: 32
height: 40
files:
0: Resources/Bunny/Bunny00.png
1: Resources/Bunny/Bunny01.bmp
2: Resources/Bunny/Bunny02.gif

=== Extra Sounds ===

Adds or replaces sounds in an existing [[SOUND|X-COM sound file]], listed in ''"extraSounds:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| ID of the original sound file to modify:
* BATTLE.CAT - Battlescape sounds, corresponds to ''SOUND1.CAT'' or ''SAMPLE2.CAT'' (55 sounds).
* INTRO.CAT - Intro sounds, corresponds to ''INTRO.CAT'' or ''SAMPLE3.CAT'', probably best not to mess with these.
* GEO.CAT - Geoscape sounds, corresponds to ''SOUND2.CAT'' or ''SAMPLE.CAT'' (14 sounds).
| ''required''
|-
| '''files'''
| List of the new sounds to add/replace, listed as ''soundID: filename''.
| -
|}

Example:
- type: BATTLE.CAT
files:
55: Resources/Sounds/sample.wav

=== Extra Strings ===

Adds or replaces text strings in an existing [[Translations (OpenXcom)|OpenXcom language file]], listed in ''"extraStrings:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| Filename of the original language file to modify, sans extension.
| ''required''
|-
| '''strings'''
| List of the new strings to add/replace, listed as ''stringID: text''.
| -
|}

Example:
- type: en-US
strings:
STR_SNIPER_RIFLE: Sniper Rifle
STR_SNIPER_RIFLE_CLIP: Sniper Rifle Clip
- type: en-GB
strings:
STR_SNIPER_RIFLE: Sniper Rifle
STR_SNIPER_RIFLE_CLIP: Sniper Rifle Clip
- type: de
strings:
STR_SNIPER_RIFLE: Scharfschützengewehr
STR_SNIPER_RIFLE_CLIP: Scharfschützengewehrmunition
- type: ru
strings:
STR_SNIPER_RIFLE: Снайперская винтовка
STR_SNIPER_RIFLE_CLIP: Магазин к снайп. винтовке

=== Interfaces ===

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| ''?''
| -
|-
| '''elements'''
| ''?''
| -
|-
| '''id'''
| ''?''
| -
|-
| '''color'''
| ''?''
| -
|}

=== StatStrings ===

[[Statstrings]] are used for automatically renaming soldiers. They are case sensitive and they are processed in the order in which they are specified.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''string'''
| String to add to name.
| ''required''
|-
| '''psiStrength''' 
'''psiSkill''' 
'''bravery''' 
'''strength''' 
'''firing''' 
'''reactions''' 
'''stamina''' 
'''tu''' 
'''health''' 
'''throwing'''
| One or more stat ranges are ANDed together for success. Each range has a minVal and maxVal. Use YAML standard tilde (~) to indicate null. ((~) = 0 as minvalue; (~) =255 as maxvalue)
| -
|}

Example:
statStrings:
- string: "x"
psiStrength: [~, 30]
- string: "P"
psiStrength: [80, ~]
- string: "p"
psiStrength: [60, 79]
- string: "K"
psiSkill: [60, ~]
- string: "k"
psiSkill: [30, 59]
- string: "b"
bravery: [60, ~]
- string: "c"
bravery: [~, 10]
- string: "w"
strength: [~, 25]
- string: "Snpr"
firing: [60, ~]
reactions: [60, ~]
- string: "M"
firing: [70, ~]
- string: "m"
firing: [60, 69]
- string: "Sct"
reactions: [50, ~]
tu: [60, ~]
- string: "R"
reactions: [60, ~]
- string: "r"
reactions: [50, 59]

==References==
<references />

[[Category:OpenXcom]]

Ruleset Reference (OpenXcom)

2014-12-06T16:33:42Z

Falko:

A reference of all the customizable values of everything in a [[Rulesets (OpenXcom)|ruleset]] for the current stable version (1.0) of OpenXcom. For the current nightly versions (with the advanced features currently in development) check [[Ruleset Reference Nightly (OpenXcom)|Ruleset Reference Nightly]].

Some guidelines:
* If a value is omitted from the ruleset, the default is used. You cannot omit ''required'' values.
* Text strings (eg. names) are represented by string IDs from the [[Translations (OpenXcom)|language files]]
* Numerical IDs (used for sprites, sounds, etc.) start at 0, not 1.
* Boolean (yes/no) values are represented by true/false.
* World coordinates are represented in degrees (see [[WORLD.DAT]]).
* Money amounts (prices, costs, etc.) are represented in dollars.
* All paths are '''case sensitive'''! If your ruleset uses external files, make sure that they named properly as described in ruleset.

Items are ordered as they come in the ruleset. To override this, you can specify a ''listOrder''. You can find the default listOrders in [[Ruleset List Order (OpenXcom)|Ruleset List Order]].

=== Countries ===

Defines one of the [[Country Funding (EU)|funding nations]], listed in ''"countries:"''. They're used for activity graphs and player scoring.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the country name.
| ''required''
|-
| '''fundingBase'''
| Country's base funding, in thousands. The starting funding can be anywhere between 1x and 2x the base funding.
| 0
|-
| '''fundingCap'''
| Country's funding cap, in thousands. Once a country reaches this maximum, it will no longer increase its funding.
| 0
|-
| '''labelLon'''
'''labelLat'''
| Longitude and latitude coordinates of the country's label on the globe. This label is only shown when the globe is zoomed in and "detail" is turned on.
| 0.0
0.0
|-
| '''areas'''
| List of "rectangles" on the globe defined as [''lon1'' ''lat1'' ''lon2'' ''lat2'']. Any activity within these areas counts towards the country's graph activity and affects their opinion of the player.
| -
|}

=== Regions ===

Defines one of the [[Geoscape (EU)#World Regions/Countries|world regions]], listed in ''"regions:"''. They're used for base placement, activity graphs and mission spawning.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the region name.
| ''required''
|-
| '''cost'''
| Amount of money spent building an X-COM base in this region (first base is free).
| 0
|-
| '''areas'''
| List of "rectangles" on the globe defined as ''[lon1, lat1, lon2, lat2]''. Any activity within these areas counts towards the region's graph activity.
| -
|-
| '''cities'''
| List of cities belonging to this region. They will be displayed on the globe and used for terror site missions. Each city is defined by their '''lon''' and '''lat''' coordinates and a '''name''' string ID.
| -
|-
| '''regionWeight'''
| Weight of this region when selecting regions for alien missions.
| 0
|-
| '''missionWeights'''
| Weighted list of the different mission types for this region (eg. ''STR_ALIEN_RESEARCH: 14'').
| -
|-
| '''missionZones'''
| List of "rectangles" (''[lon1, lat1, lon2, lat2]'') defining the mission zones for this region. Mission zones are waypoints for UFO trajectories.
| -
|-
| '''missionRegion'''
| Spawn mission in this region instead (used for regions without land).
| -
|}

=== Base Facilities ===

Defines one of the [[Base Facilities (EU)|facilities]] that can be built in an X-COM base, listed in ''"facilities:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the facility name.
| ''required''
|-
| '''requires'''
| List of [[#Research|topics]] (string IDs) that must be researched to unlock this facility. If none are specified, this facility is unlocked from the start.
| -
|-
| '''spriteShape'''
| Sprite ID from [[BASEBITS.PCK]] used to draw the facility's outer shape in the Basescape and UFOpaedia.
| -1
|-
| '''spriteFacility'''
| Sprite ID from [[BASEBITS.PCK]] used to draw the facility's contents in the Basescape and UFOpaedia. Drawn on top of '''spriteShape'''.
| -1
|-
| '''lift'''
| Is this facility an [[Access Lift]]? All base facilities must be connected to the lift.
| false
|-
| '''hyper'''
| Is this facility a [[Hyperwave Decoder]]? Displays extra information for detected UFOs. Only valid for radar facilities.
| false
|-
| '''mind'''
| Is this facility a [[Mind Shield]]? Reduces the chance of UFOs finding your base. Does not stack.
| false
|-
| '''grav'''
| Is this facility a [[Grav Shield]]? Doubles the power of your base defenses. Does not stack.
| false
|-
| '''size'''
| Size of the facility, in grid units. Every facility is square, so a size of 1 means 1x1, 2 means 2x2, etc. Bigger facilities are made up of multiple sprites, for example a 2x2 facility will use 4 sprites for '''spriteShape''' and 4 sprites for '''spriteFacility''' (top-left, top-right, bottom-left, bottom-right).
| 1
|-
| '''buildCost'''
| Amount of money spent to build this facility in the base.
| 0
|-
| '''buildTime'''
| Amount of days it takes for this facility to be built.
| 0
|-
| '''monthlyCost'''
| Amount of money spent monthly for the maintenance of this facility.
| 0
|-
| '''storage'''
| Amount of storage space (for items) this facility provides. See [[Base Stores]].
| 0
|-
| '''personnel'''
| Amount of personnel (soldiers, scientsts, engineers) these quarters can contain.
| 0
|-
| '''aliens'''
| Amount of live aliens this facility can contain. Only checked if the ''alienContainmentLimitEnforced'' option is enabled.
| 0
|-
| '''crafts'''
| Amount of X-COM craft this facility can contain.
| 0
|-
| '''labs'''
| Amount of lab space this facility provides for research projects.
| 0
|-
| '''workshops'''
| Amount of workshop space this facility provides for manufacture projects.
| 0
|-
| '''psiLabs'''
| Amount of soldier space this facility provides for psionic training.
| 0
|-
| '''radarRange'''
| Maximum radar detection range of this facility, in nautical miles.
| 0
|-
| '''radarChance'''
| Chance (0-100%) of this radar detecting a UFO that enters its range.
| 0
|-
| '''defense'''
| Offensive power provided by this base defense against attacking UFOs.
| 0
|-
| '''hitRatio'''
| Chance (0-100) of the base defense hitting an attacking UFO.
| 0
|-
| '''fireSound'''
| Sound ID from [[#Extra_Sounds|GEO.CAT]] played when the base defense fires.
| -1
|-
| '''hitSound'''
| Sound ID from [[#Extra_Sounds|GEO.CAT]] played when the base defense hits a target.
| -1
|-
| '''mapName'''
| [[MAPS|Map]] associated to this facility in Battlescape base defenses.
| -
|-
|}

=== Crafts ===

Defines one of the [[Craft|X-COM crafts]] that go on interception missions, listed in ''"crafts:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the craft name.
| ''required''
|-
| '''requires'''
| List of [[#Research|topics]] (string IDs) that must be researched to unlock this craft. If none are specified, this craft is unlocked from the start.
| -
|-
| '''sprite'''
| Sprite ID from [[BASEBITS.PCK]] used to draw this craft in the Basescape and from [[INTICON.PCK]] used to draw the damage indicator in dogfights.
modders: the corresponding extrasprite file id for BASEBITS.PCK is sprite+33 INTICON.PCK contains a minimized icon id=sprite the file id for the dogfight image is sprite+11
| -1
|-
| '''fuelMax'''
| Maximum amount of fuel this craft can carry. Crafts use up fuel based on their speed while travelling.
| 0
|-
| '''damageMax'''
| Maximum amount of damage this craft can take. If this amount is exceeded, the craft is destroyed.
| 0
|-
| '''speedMax'''
| Maximum speed in nautical miles. Crafts travel at max speed when flying and half speed when patrolling.
| 0
|-
| '''accel'''
| Aceeleration value shown in the UFOpaedia.
| 0
|-
| '''weapons'''
| Amount of craft weapons this craft can equip. The UI can only display a max of 2 weapons.
| 0
|-
| '''soldiers'''
| Amount of soldiers this craft can carry.
| 0
|-
| '''maxItems'''
| Amount of items this craft can carry.
| 80
|-
| '''vehicles'''
| Amount of vehicles this craft can carry.
| 0
|-
| '''costBuy'''
| Amount of money spent for purchasing this craft. If set to 0, the craft will not be available in the Purchase/Recruit screen.
| 0
|-
| '''costRent'''
| Amount of money spent monthly for renting this craft. If set to 0, the craft is not on rental and won't count towards base maintenance.
| 0
|-
| '''costSell'''
| Amount of money gained for selling this craft.
| 0
|-
| '''refuelItem'''
| Item required for refuelling this craft. If no item is specified, the craft uses human fuel.
| 0
|-
| '''repairRate'''
| Amount of damage restored every hour while [[Repairs|Repairing]] in base.
| 1
|-
| '''refuelRate'''
| Amount of fuel restored every 30 mins while [[Refueling]] in base. If specified, a '''refuelItem''' is spent each time.
| 1
|-
| '''radarRange'''
| Detection range of the craft's radar in nautical miles. Every craft radar has a 100% detection chance.
| 600
|-
| '''transferTime'''
| Number of hours it takes to purchase/transfer this craft to a base.
| 0
|-
| '''score'''
| [[Score]] lost when this craft is destroyed.
| 0
|-
| '''spacecraft'''
| Can this craft go to [[Cydonia]]?
| false
|-
| '''battlescapeTerrainData'''
| [[#Terrains|Terrain]] associated to this craft in Battlescape missions.
| -
|}

=== Craft Weapons ===

Defines one of the [[Craft Armaments|weapons]] equipped by X-COM craft for shooting down UFOs, listed in ''"craftWeapons:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the weapon name.
| ''required''
|-
| '''sprite'''
| Sprite ID from [[BASEBITS.PCK]] used to draw the weapon in the Basescape and from [[INTICON.PCK]] used to draw the weapon in dogfights.
modders: the corresponding extrasprites file id for INTICON.PCK is sprite+5 and sprite+48 for BASEBITS.PCK
| -1
|-
| '''sound'''
| Sound ID from [[#Extra_Sounds|GEO.CAT]] played when this weapon fires.
| -1
|-
| '''damage'''
| Amount of damage this weapon does to enemy UFOs.
| 0
|-
| '''range'''
| Maximum range of this weapon in dogfights (in meters).
| 0
|-
| '''accuracy'''
| Chance (0-100%) of each shot hitting the enemy UFO.
| 0
|-
| '''reloadCautious'''
| Time this weapon takes to fire between each shot in ''Cautious Mode''.
| 0
|-
| '''reloadStandard'''
| Time this weapon takes to fire between each shot in ''Standard Mode''.
| 0
|-
| '''reloadAggressive'''
| Time this weapon takes to fire between each shot in ''Aggressive Mode''.
| 0
|-
| '''ammoMax'''
| Maximum amount of ammo this weapon can carry.
| 0
|-
| '''rearmRate'''
| Amount of ammo restored every 30 mins while the craft is [[Rearming]] in base. If specified, '''clip'''s are spent depending on their '''clipSize'''. If the '''clipSize''' of the specified ammo is 0, no '''clip'''s are spent.
| 1
|-
| '''projectileType'''
| Type of the weapon projectile, used for the projectile sprite in dogfights:
* 0 - [[Stingray]]
* 1 - [[Avalanche]]
* 2 - [[Cannon]]
* 3 - [[Fusion Ball]]
* 4 - [[Laser Cannon]]
* 5 - [[Plasma Beam]]
| 2
|-
| '''projectileSpeed'''
| Speed of the weapon projectile in dogfights.
| 0
|-
| '''launcher'''
| String ID of the [[#Items|item]] required to equip this weapon.
| -
|-
| '''clip'''
| String ID of the [[#Items|item]] required to rearm this weapon.
| -
|}

=== Items ===

Defines the Geoscape and Battlescape properties of an [[Equipment (EU)|item]] that can be stored in X-COM bases, listed in ''"items:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the internal item name.
| ''required''
|-
| '''name'''
| String ID of the displayed item name, for cases where it's different from the internal name. If omitted, '''type''' is used.
| -
|-
| '''requires'''
| List of [[#Research|topics]] (string IDs) that must be researched to unlock this item. If none are specified, this item is unlocked from the start. Soldiers can only use unlocked items in the Battlescape.
| -
|-
| '''size'''
| Space occupied by this item in [[Base Stores]]. Can be a decimal value.
| 0.0
|-
| '''costBuy'''
| Amount of money spent for purchasing this item. If set to 0, this item will not be available in the Purchase/Recruit screen.
| 0
|-
| '''costSell'''
| Amount of money gained for selling this item.
| 0
|-
| '''transferTime'''
| Number of hours it takes to purchase/transfer this item to a base.
| 24
|-
| '''weight'''
| [[Item_Weight|Weight]] occupied by this item in a soldier's inventory.
| 999
|-
| '''bigSprite'''
| Sprite ID from [[BIGOBS.PCK]] used to draw this item in a soldier's inventory and UFOpaedia.
| -1
|-
| '''floorSprite'''
| Sprite ID from [[FLOOROB.PCK]] used to draw this item on the floor of a Battlescape tile.
| -1
|-
| '''handSprite'''
| Sprite ID from [[HANDOB.PCK]] used to draw this item on a soldier's hand in the Battlescape.
modders: each handobject needs 8 images (8 directions) define the extrasprites accordingly
| 120
|-
| '''bulletSprite'''
| Sprite ID from ''BulletSprites.png'' used to draw this weapon's projectile on the Battlescape:
* 0 - [[Rocket Launcher]]
* 1 - [[Pistol]]
* 2 - [[Rifle]]
* 3 - [[Auto Cannon]]
* 4 - [[Heavy Cannon]]
* 5 - [[Laser Pistol]]
* 6 - [[Laser Rifle]]
* 7 - [[Heavy Laser]]
* 8 - [[Plasma Rifle|Plasma]]
* 9 - [[Small Launcher]]
* 10 - [[Blaster Launcher]]
for modders: the bulletsprite needs to be put into the extraSprites type "Projectiles" the bulletsprite can contain up to 35 3x3 images. The corresponding file id is 35*[bulletSprite]
| -1
|-
| '''fireSound'''
| Sound ID from [[#Extra_Sounds|BATTLE.CAT]] played when this weapon fires.
| -1
|-
| '''hitSound'''
| Sound ID from [[#Extra_Sounds|BATTLE.CAT]] played when this weapon hits a target.
| -1
|-
| '''hitAnimation'''
| Sprite ID from [[SMOKE.PCK]] used to draw the weapon's "hit explosion".
'''NOTE''': Do not define this value for melee/psi weapons, they use [[HIT.PCK]] and therefore meleeAnimation instead.
| 0
|-
| '''power'''
| Average damage of the weapon, in most cases it will be +-50% this value.
| 0
|-
| '''strengthApplied'''
| Add the attacking unit's strength to this weapon's damage.
| false
|-
| '''compatibleAmmo'''
| List of string IDs of the ammo items that can be loaded on this weapon. If none are specified, the weapon doesn't need ammo.
| -
|-
| '''damageType'''
| What type of [[damage]] does this weapon do:
* 0 - None
* 1 - Armor Piercing
* 2 - Incendiary
* 3 - High Explosive
* 4 - Laser
* 5 - Plasma
* 6 - Stun
* 7 - Melee
* 8 - Acid
* 9 - Smoke
'''NOTE:''' A damage type other than 0-9 will do nothing.
| 0
|-
| '''tuAuto'''
'''accuracyAuto'''
| The percentage (0-100%) of [[Time Units]] (from the soldier's total) required to fire an Auto Shot. If 0, the weapon does not have an Auto Shot.
The base accuracy (0-100%) applied to a soldier's [[Firing Accuracy]] when firing an Auto Shot.
| 0
0
|-
| '''tuSnap'''
'''accuracySnap'''
| The percentage (0-100%) of [[Time Units]] (from the soldier's total) required to fire a Snap Shot. If 0, the weapon does not have a Snap Shot.
The base accuracy (0-100%) applied to a soldier's [[Firing Accuracy]] when firing a Snap Shot.
| 0
0
|-
| '''tuAimed'''
'''accuracyAimed'''
| The percentage (0-100%) of [[Time Units]] (from the soldier's total) required to fire an Aimed Shot. If 0, the weapon does not have an Aimed Shot.
The base accuracy (0-100%) applied to a soldier's [[Firing Accuracy]] when firing an Aimed Shot.
| 0
0
|-
|-
| '''tuMelee'''
'''accuracyMelee'''
| The percentage (0-100%) of [[Time Units]] (from the soldier's total) required to do a melee attack (Hit). If 0, the weapon does not have a melee attack.
The base accuracy (0-100%) applied to a soldier's [[Melee Accuracy]] when doing a melee attack.
| 0
0
|-
| '''clipSize'''
| The amount of ammo stored in each weapon clip. If -1 is specified, this weapon has infinite ammo.
| 0
|-
| '''battleType'''
| Defines the weapon's behavior in the Battlescape:
* 0 - None (Geoscape-only item)
* 1 - [[Weapons|Firearm]]
* 2 - Ammo
* 3 - Melee
* 4 - [[Grenade]]
* 5 - [[Proximity Grenade]]
* 6 - [[Medi-Kit (EU)|Medi-Kit]]
* 7 - [[Motion Scanner]]
* 8 - [[Mind Probe]]
* 9 - [[Psi-Amp]]
* 10 - [[Electro-flare]]
* 11 - Corpse
| 0
|-
| '''twoHanded'''
| Is this weapon two-handed? If true, incurs an accuracy penalty if used with both hands occupied. Note that the handsprite of a twoHanded item is also drawn at a slightly different position than a one handed item.
| false
|-
| '''waypoint'''
| Does this weapon use waypoints? (eg. [[Blaster Launcher]]). Can also be used to make ammo items use the waypoint system.
| false
|-
| '''fixedWeapon'''
| Is this weapon fixed? (it's part of a unit, eg. tanks and terrorist units)
| false
|-
| '''invWidth'''
| Item width in a soldier's inventory (in grid units).
| 1
|-
| '''invHeight'''
| Item height in a soldier's inventory (in grid units).
| 1
|-
| '''painKiller'''
| Amount of painkillers contained in a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''heal'''
| Amount of heal's contained in a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''stimulant'''
| Amount of stimulants contained in a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''woundRecovery'''
| Amount of [[Fatal Wounds]] treated by each heal of a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''healthRecovery'''
| Amount of [[Health]] recovered by each heal of a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''stunRecovery'''
| Amount of [[Stun]] removed by each stimulant of a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''energyRecovery'''
| Amount of [[Energy]] recovered by each stimulant of a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''tuUse'''
| Amount of [[Time Units]] required to use this item (for non-offensive items). It's a flat rate if '''flatRate''' is true, otherwise it's a percentage (0-100%).
| 0
|-
| '''recoveryPoints'''
| [[Score]] gained for recovering this alien artifact.
| 0
|-
| '''armor'''
| How much damage is needed to destroy this item on the ground.
| 20
|-
| '''recover'''
| Is this item recoverable? (gets transported to the X-COM base on mission success)
| true
|-
| '''turretType'''
| Sprite ID from [[TANKS.PCK]] of the turret to assign to this tank:
* 0 - [[Tank/Cannon]]
* 1 - [[Tank/Rocket Launcher]]
* 2 - [[Tank/Laser Cannon]]
* 3 - [[Hovertank/Plasma]]
* 4 - [[Hovertank/Launcher]]
| -1
|-
| '''liveAlien'''
| Does this item represent a live alien? (counts towards [[Alien Containment]])
| false
|-
| '''blastRadius'''
| Size of the projectile explosions. 0 for no explosion. -1 to automatically calculate based on weapon power and damage type (actual '''blastRadius''' currently is capped due [[Explosions#Playing_With_Fire|Explosion calculations]]).
| -1
|-
| '''flatRate'''
| If true, then TU costs for this weapon are a flat rate (instead of a percentage of unit TUs).
| false
|-
| '''arcingShot'''
| Does this weapon fire in an arc?
| false
|-
| '''attraction'''
| Represents how likely an alien is to pick up this item. Values below 5 will be ignored (by design).
| 0
|-
| '''maxRange'''
| Maximum range at which this weapon can operate.
| 200
|-
| '''aimRange'''
| Maximum effective range with this weapon before which range-based dropoff occurs.
| 200
|-
| '''snapRange'''
| Maximum effective range with snap shot before which range-based dropoff occurs. (ufoextender accuracy only)
| 15
|-
| '''autoRange'''
| Maximum effective range with auto shot before which range-based dropoff occurs. (ufoextender accuracy only)
| 7
|-
| '''minRange'''
| Range-based dropoff will work in reverse for ranges below this.
| 0
|-
| '''dropoff'''
| The value by which the accuracy lowers for each tile after (or before) the thresholds above.
| 2
|-
| '''bulletSpeed'''
| How much faster (or slower, if you use a negative number) is a projectile fired from this weapon compared to the average.
| 0
|-
| '''autoShots'''
| How many auto shots does this weapon fire.
| 3
|-
| '''shotgunPellets'''
| Number of projectiles fired per unit of ammunition. (note: due to engine limitations it is currently impossible to draw multiple projectiles in flight.)
| 0
|-
| '''zombieUnit'''
| String ID of the unit used for zombification (eg. [[Chrysallid]]s turn units into [[Zombie]]s).
| none
|-
| '''meleeSound'''
| Sound ID from [[#Extra_Sounds|BATTLE.CAT]] played when this weapon attacks a target with melee.
| 39
|-
| '''meleeHitSound'''
| Sound ID from [[#Extra_Sounds|BATTLE.CAT]] played when this weapon HITS a target with melee.
| -1
|-
| '''meleeAnimation'''
| Sprite ID from HIT.PCK played when this weapon attacks a target with melee.
| 0
|-
| '''meleePower'''
| Damage this weapon will do when using melee. This only applies to Firearms, and is only available as stun damage. For normal melee weapons, use regular power and damage types.
| 0
|-
| '''LOSRequired'''
| Does this item require line of sight? (only applies to mind probes and psi-amps)
| false
|-
| '''skillApplied'''
| Is melee skill applied to the accuracy of an attack made with this object?
| true
|-
|}

=== UFOs ===

Defines one of the [[UFOs]] that invade Earth, listed in ''"ufos:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the UFO name.
| ''required''
|-
| '''size'''
| String ID of the UFO size.
| STR_VERY_SMALL
|-
| '''sprite'''
| Sprite ID from [[INTERWIN.DAT]] used to draw this UFO in the dogfight view and UFOpaedia.
don't try to add more images if you don't want to punch yourself in the face - use modsprite
| -1
|-
| '''modSprite'''
| Filename used to draw this UFO in the dogfight view and UFOpaedia.
| -
|-
| '''damageMax'''
| Maximum amount of damage this UFO can take. If the UFO takes 50% damage, it crash lands. If it takes 100% damage, it is destroyed.
| 0
|-
| '''speedMax'''
| Maximum speed in nautical miles.
| 0
|-
| '''accel'''
| Aceeleration value shown in the UFOpaedia.
| 0
|-
| '''power'''
| Damage power of this UFO's weapon in dogfights.
| 0
|-
| '''range'''
| Maximum range of this UFO's weapon in dogfights (in meters).
| 0
|-
| '''score'''
| [[Score]] gained when this UFO is destroyed, or half this score if it crash lands.
| 0
|-
| '''reload'''
| Time the UFO's weapon takes to fire between each shot.
| 0
|-
| '''breakOffTime'''
| Minimum amount of time for the UFO to be able to break off of a dogfight.
| 0
|-
| '''battlescapeTerrainData'''
| [[#Terrains|Terrain]] associated to this UFO in Battlescape missions.
| ''required''
|-
|}

=== Inventory Sections ===

Defines one of the sections of the [[Inventory TU Table|Battlescape inventory]] (eg. Backpack), listed in ''"invs:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the inventory name.
| ''required''
|-
| '''x'''
'''y'''
| Pixel coordinates of this section on the inventory screen.
| 0
0
|-
| '''type'''
| Type of this section:
* 0 = Slot section, can contain as many items as will fit on the slots.
* 1 = Hand section, can only contain one item regardless of size.
* 2 = Ground section, can contain infinite items.
| 0
|-
| '''slots'''
| List of the grid slots (''[x, y]'') that this section is composed of. For example, to make a 2x2 section, you would have ''[0, 0] [0, 1] [1, 0] [1, 1]''.
| -
|-
| '''costs'''
| List of [[Time Units]] costs to move an item from this section to another one (eg. ''STR_BACKPACK: 16'' means it will cost 16 TUs to move an item from this section to the Backpack).
| -
|-
|}

=== Terrains ===

Defines one of the [[TERRAIN|terrains]] used to generate a Battlescape map, listed in "terrains:".

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''name'''
| String ID of the terrain name.
| ''required''
|-
| '''largeBlockLimit'''
| Maximum amount of large blocks that can be used on map generation.
| 0
|-
| '''textures'''
| List of [[TEXTURE.DAT|Geoscape textures]] that correspond to this terrain.
| -
|-
| '''hemisphere'''
| Geoscape hemisphere associated with this terrain:
* -1 - Northern hemisphere.
* 0 - Both hemispheres.
* 1 - Southern hemisphere.
| 0
|-
| '''mapDataSets'''
| List of filenames (each with matching [[MCD]]/[[Image Formats#PCK|PCK/TAB]] files) that contain the tiles of this terrain.
| -
|-
| '''mapBlocks'''
| List of map blocks (see below) that are used for generating a map.
| -
|-
| '''roadTypeOdds'''
| Odds as a % of generating each type of road (E-W Road, N-S Road, Crossing) odds for crossing are: 100 - EW - NS.
| [0 0]
|-|-
| '''civilianTypes'''
| List of units to use as civilians for this mission.
| [MALE_CIVILIAN, FEMALE_CIVILIAN]
|-
|}

==== Map Blocks ====

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''name'''
| Filename of the [[MAPS|map]].
| ''required''
|-
| '''width'''
| Width of this map block in Battlescape grid units.
| 0
|-
| '''length'''
| Length of this map block in Battlescape grid units.
| 0
|-
| '''height'''
| Height of this map block in Battlescape grid units.
| 1
|-
| '''type'''
| Type of this map block:
* -1 - Undefined
* 0 - Default
* 1 - Landing Zone (for placing X-COM / alien craft)
* 2 - E-W Road (for city maps)
* 3 - N-S Road (for city maps)
* 4 - Road Crossing (for city maps)
* 5 - Dirt (for filling empty base blocks)
* 6 - X-COM spawn point (for [[Alien Base]] / [[Cydonia]] missions)
* 7 - [[Alien Base]] Target
* 8 - [[Cydonia]] Target
| -1
|-
| '''subType'''
| Sub-type of this map block (see '''type''').
| -1
|-
| '''frequency'''
| Frequency of this block in a map.
| 1
|-
| '''maxCount'''
| Maximum amount of times this block can be used in a map. If -1 there is no limit.
| -1
|}

*'''frequency''' defines the odds of the map appearing on the map
** The value assigned (default: 1) is used in ''x/n'', which defines the probability of being chosen.
** ''x'' is the integer defined for the map block's frequency and ''n'' is the combined total of probabilities for all the map types combined.
** This property can only be used in type 0 map blocks.
*'''maxCount''' is the maximum number of times it can be used.
** The value assigned is also used in ''x/n'' to determine the probability of being chosen.
** Each use reduces ''x'' by -1, with the caveat that being used as a Landing Zone type will not reduce the x value since it could result in no available Landing Zones.
** This property can only be used in type 0 map blocks.
* '''hemisphere''' only applies to UFO missions, not Terror ones.
*'''width/length''' defines the size of the map
** be aware that the mapview "width"-label is the openxcom ruleset length parameter
** be aware that the mapview "length"-label is the openxcom ruleset width parameter

==== Guidelines/Tips ====
* All maps with an XCOM/Alien craft require at least one type 1 map block. This map block can only contain ground tiles (no walls or objects), otherwise the game will crash or the walls/objects will be removed.
* All Terror terrains (listed under STR_TERROR_MISSION) require at least 1 map block of '''Types''' 2, 3 and 4 (for a total of 3 maps, which are required to place roads) and the corresponding '''roadTypeOdds''' added to the ruleset.
* If there isn't any map blocks designed as roads since you want to keep your terrain 'random', this can be circumvented by designating all 10x10 map blocks, excluding the one(s) used for the XCOM craft, as either '''Type''' 2, 3 and 4 and by defining their '''subType''' to 0. The game will then randomly choose between the map blocks for each type used in the roads, making them map more random.

=== Armor ===

Defines a Battlescape unit's [[armor]] as well as visual representation (so every unit has an armor), listed in ''"armors:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the armor name.
| ''required''
|-
| '''spriteSheet'''
| Sprite sheet from [[UNITS]] used to draw a unit wearing this armor.
| -
|-
| '''spriteInv'''
| Sprite used for the [[Inventory Backgrounds]] of a unit wearing this armor.
| -
|-
| '''corpseBattle'''
| List of string IDs of the corpse [[#Items|items]] generated when a unit wearing this armor is killed (one per unit tile) on the Battlescape.
| -
|-
| '''corpseGeo'''
| String ID of the corpse [[#Items|item]] associated with this unit on the Geoscape.
| -
|-
| '''storeItem'''
| String ID of the [[#Items|item]] that represents this armor in [[Base Stores]] for equipping.
| -
|-
| '''weight'''
| Physical weight of the armor when worn
| 6
|-
| '''stats'''
| like soldier stats (see below) but these are treated as stat bonuses for wearing the specific armor.
| -
|-
| '''frontArmor'''
| Protection provided on the front of the unit.
| 0
|-
| '''sideArmor'''
| Protection provided on the sides of the unit.
| 0
|-
| '''rearArmor'''
| Protection provided on the rear of the unit.
| 0
|-
| '''underArmor'''
| Protection provided under the unit (eg. from explosions).
| 0
|-
| '''drawingRoutine'''
| Drawing routine used to put together the body parts in the unit's '''spriteSheet''':
* 0 = [[Soldier]], [[Sectoid]]
* 1 = [[Floater]]
* 2 = [[HWP]]
* 3 = [[Cyberdisk]]
* 4 = [[Civilian]], [[Ethereal]]
* 5 = [[Sectopod]], [[Reaper]]
* 6 = [[Snakeman]]
* 7 = [[Chryssalid]]
* 8 = [[Silacoid]]
* 9 = [[Celatid]]
* 10 = [[Muton]]
| 0
|-
| '''movementType'''
| Type of movement provided by this armor:
* 0 = Walking
* 1 = Flying
* 2 = Sliding (no walking animation)
it also defines the body of an tank (32-images) in your spriteSheet or the change in sprites while flying using a flying armour see: [[TANKS.PCK]], [[XCOM_2.PCK]]
| 0
|-
| '''damageModifier'''
| List of decimal damage modifiers (1.0 = 100%) this armor applies to each damage type (see [[#Items|Items section]]) received. Modifiers must be specified for all damage types, in this order:
* None
* Armor Piercing
* Incendiary
* High Explosive
* Laser
* Plasma
* Stun
* Melee
* Acid
* Smoke
|
- 1.0 
- 1.0 
- 1.0 
- 1.0 
- 1.0 
- 1.0 
- 1.0 
- 1.0 
- 1.0 
- 1.0
|-
| '''size'''
| Size of the unit wearing this armor, in Battlescape grid units. Every unit is square, so a size of 2 means 2x2.
| 1
|-
| '''loftempsSet'''
| List of [[LOFTEMPS]] IDs (one per unit tile, so a 1x1 unit has 1, a 2x2 unit has 4, etc.) used to represent a unit wearing this armor in 3D space.
| -
|-
| '''loftemps'''
| loftemps is a deprecated option that only works for 1x1 sized units.
| -
|}

=== Player Units (Soldiers) ===

Defines a [[soldier]] recruited by X-COM, listed in ''"soldiers:"''. Currently only one soldier unit type (''XCOM'') is supported.

Unit stats are represented as follows:
* [[Time Units|tu]]
* [[Energy|stamina]]
* [[Health|health]]
* [[Bravery|bravery]] (always a multiple of 10)
* [[Reactions|reactions]]
* [[Firing Accuracy|firing]]
* [[Throwing Accuracy|throwing]]
* [[Strength|strength]]
* [[Psi Strength|psiStrength]]
* [[Psi Skill|psiSkill]]
* [[Melee Accuracy|melee]] (not visible)

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the soldier name.
| ''required''
|-
| '''minStats'''
| Minimum values used to generate the soldier's [[Starting Stats]]. In this case, ''psiSkill'' is treated as the initial stat (not generated).
| -
|-
| '''maxStats'''
| Maximum values used to generate the soldier's [[Starting Stats]]. In this case, ''psiSkill'' is treated as the minimum value for the first month of psi training (actual value is 100%-150%).
| -
|-
| '''statCaps'''
| Maximum stats this soldier can gain through [[Experience]]. '''NOTE:''' A stat will still go over the limit once, and then will no longer increase (see [[Experience#Regarding Caps|Regarding Caps]]).
| -
|-
| '''armor'''
| String ID of the [[#Armor|armor]] this soldier uses by default.
| -
|-
| '''standHeight'''
| Height of this soldier when standing.
| 0
|-
| '''kneelHeight'''
| Height of this soldier when kneeling.
| 0
|-
| '''floatHeight'''
| Distance between the bottom of this unit and the ground.
| 0
|}

=== AI Units (Aliens/Civilians) ===

Defines an [[Alien Life Forms|alien]] (enemy) or [[civilian]] (neutral) unit, listed in ''"units:"''. Every different alien rank is a different unit, since they have completely different stats. Unit stats are represented as follows:
* [[Time Units|tu]]
* [[Energy|stamina]]
* [[Health|health]]
* [[Bravery|bravery]] (always a multiple of 10)
* [[Reactions|reactions]]
* [[Firing Accuracy|firing]]
* [[Throwing Accuracy|throwing]]
* [[Strength|strength]]
* [[Psi Strength|psiStrength]]
* [[Psi Skill|psiSkill]]
* [[Melee Accuracy|melee]] (not visible)

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the unit name.
| ''required''
|-
| '''race'''
| String ID of the unit race (for alien units).
| -
|-
| '''rank'''
| String ID of the unit rank (for alien units).
| -
|-
| '''stats'''
| Battlescape stats of this unit.
| -
|-
| '''armor'''
| String ID of the [[#Armor|armor]] this unit uses by default.
| -
|-
| '''standHeight'''
| Height of this unit when standing.
| 0
|-
| '''floatHeight'''
| Distance between the bottom of this unit and the ground.
| 0
|-
| '''value'''
| [[Score]] this unit is worth.
| 0
|-
| '''deathSound'''
| Sound ID from [[#Extra_Sounds|BATTLE.CAT]] played when this unit dies.
| -1
|-
| '''aggroSound'''
| Sound ID from [[#Extra_Sounds|BATTLE.CAT]] played when this unit aggros.
| -1
|-
| '''moveSound'''
| Sound ID from [[#Extra_Sounds|BATTLE.CAT]] played when this unit moves.
| -1
|-
| '''intelligence'''
| Intelligence of this unit's AI. The higher the value, the longer this unit remembers player troops between turns.
| 0
|-
| '''aggression'''
| Aggression of this unit's AI. The higher the value, the more ruthless the unit, the more likely to make a frontal assault. Less aggressive units tend to set up ambushes.
Vanilla values are:
* 0 = mostly passive
* 1 = balanced
* 2 = mostly aggresive
| 0
|-
| '''energyRecovery'''
| Energy recovered by the unit each turn (needs verification)
| 40 (?)
|-
| '''specab'''
| Special ability of this unit:
* 0 = None
* 1 = [[Cyberdisc|Explodes on Death]]
* 2 = [[Bio-Drone|Burns Floor]]
* 3 = [[Zombie|Respawns on Death]]
| 0
|-
| '''spawnUnit'''
| String ID of the unit used to respawn on death (eg. [[Zombie]]s respawn as [[Chrysallid]]s).
| -
|-
| '''livingWeapon'''
| Is this unit a living weapon? (only attacks with a '''fixedWeapon''')
| false
|-
|}

=== Alien Races ===

Defines a [[Alien Life Forms|race]] used in [[Alien Missions]], listed in ''"alienRaces:"''. Heavily tied with deployment data.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''id'''
| String ID of the alien race name.
| ''required''
|-
| '''members'''
| Alien crew associated with this alien race (eg. race units + terrorist units), defined by a list of unit string IDs. Order here will define rank in terms of deployment. generally speaking the order is:
* 0 - Commander
* 1 - Leader
* 2 - Engineer
* 3 - Medic
* 4 - Navigator
* 5 - Soldier
* 6 - Terrorist 1
* 7 - Terrorist 2
but of course, not all races have all ranks, so the "fill in" rank would be listed multiple times (see ethereals).
| -
|-
| '''retaliation'''
| retaliation enables/disables the race for retaliation missions.
| ''True''
|-
|}

=== Alien Deployments ===

Defines a Battlescape deployment data used in [[Alien Missions]] (such as alien and map configurations), listed in ''"alienDeployments:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the deployment name.
| ''required''
|-
| '''width'''
| Width of the Battlescape map in grid units.
| 0
|-
| '''length'''
| Length of the Battlescape map in grid units.
| 0
|-
| '''height'''
| Vertical height of the Battlescape map in grid units.
| 0
|-
| '''terrains'''
| list of string IDs of the [[#Terrains|terrain]] to choose from to generate this map. This is not used for UFO sites where the terrain comes from the Geoscape.
| -
|-
| '''shade'''
| Shade of the map (0-15, where 0 is full daytime and 15 is full nighttime). This is not used for UFO sites where the shade comes from the Geoscape.
| 0
|-
| '''nextStage'''
| String ID of the next deployment stage to use after this one, for multi-stage missions.
| -
|-
| '''data'''
| List of deployment data for each alien rank on this mission (see below).
| -
|}

Notes:
* '''terrains''' can also be used with UFOs, with the game using instead the listed terrain rather than the location of the UFO on Geoscape.
==== Deployment Data ====

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''alienRank'''
| [[Alien Rank|Rank]] associated with this deployment data, as defined by the order of the race in question (see above)
| ''required''
|-
| '''lowQty'''
| Maximum quantity of aliens to spawn (beginner).
| 0
|-
| '''highQty'''
| Maximum quantity of aliens to spawn (superhuman).
| 0
|-
| '''dQty'''
| Minimum Desired Quantity of aliens to spawn.
| 0
|-
| '''percentageOutsideUfo'''
| Percentage (0-100%) of aliens to spawn outside in UFO sites.
| 0
|-
| '''itemSets'''
| Three lists (one for each alien technology level) of [[#Items|items]] (string IDs) for the aliens to equip.
| ''required''
|-
|}

=== Research ===

Defines a [[Research|research topic]] that X-COM scientists can investigate, listed in ''"research:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''name'''
| String ID of the research project's name (or item, if a '''lookup''' is defined).
| ''required''
|-
| '''lookup'''
| String ID of the research project's display name and UFOPaedia article reference.
| -
|-
| '''cost'''
| Number of man hours (on average) required to complete this project.
| 0
|-
| '''points'''
| [[Score]] earned for completing this project.
| 0
|-
| '''needItem'''
| Does this project require an [[#Items|item]] of the same name?
| false
|-
| '''dependencies'''
| List of research projects that can unlock access to this one. If the full list is researched, or if one of the projects on the list "unlocks" this one, it becomes available.
| -
|-
| '''unlocks'''
| List of research projects unlocked, regardless of other dependencies, but not requirements, by completing this project (for example, any live alien unlocks "alien origins").
| -
|-
| '''requires'''
| List of research projects unilaterally required before this project can be unlocked (for example, "the martian solution" will not even be considered for unlocking until AFTER "alien origins" is completed).
| -
|-
| '''getOneFree'''
| List of "bonus" research projects that may be granted when completing this project (for example, alien medics will give you information on other alien races). Only applies to living aliens.
| -
|-
|}

=== Manufacture ===

Defines a [[Manufacture|manufacture project]] that X-COM engineers can produce, listed in ''"manufacture:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''name'''
| String ID of the manufacturing project's name (and the item it produces).
| ''required''
|-
| '''category'''
| String ID of the manufacturing project's category.
| -
|-
| '''requires'''
| List of [[#Research|topics]] (string IDs) that must be researched to unlock this project. If none are specified, this project is unlocked from the start.
| -
|-
| '''space'''
| Amount of [[Workshop]] space required to begin this project.
| 0
|-
| '''time'''
| Number of man hours (on average) required per item.
| 0
|-
| '''cost'''
| Monetary deduction per item manufactured.
| 0
|-
| '''requiredItems'''
| List of [[#Items|items]] required and consumed per item manufactured.
| -
|-
| '''producedItems'''
| List of [[#Items|items]] produced per each item consumed. If not specified, defaults to 1 item with the same string ID as the manufacture.
| 1
|-
|}

=== UFOpaedia Article ===

Defines an article in the in-game [[UFOpaedia]], listed in ''"ufopaedia:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''id'''
| String ID of the article name. This must match the ID of the object associated with this article, if applicable.
| ''required''
|-
| '''title'''
| String ID of the article title. If omitted, the '''id''' is used.
| -
|-
| '''type_id'''
| Type of this article:
* 0 = Unknown
* 1 = [[Craft]]
* 2 = [[Craft Armaments]]
* 3 = [[HWP]]
* 4 = [[Equipment (EU)|Equipment]]
* 5 = [[Armour]]
* 6 = [[Base Facilities]]
* 7 = Text & Image (eg. [[Alien Life Forms]], [[UFO Components]])
* 8 = Text (eg. [[Alien Research]])
* 9 = [[UFO]]
| 0
|-
| '''section'''
| String ID of the UFOpaedia section this article belongs in.
| -
|-
| '''requires'''
| List of [[#Research|topics]] (string IDs) that must be researched to unlock this article. If none are specified, this article is unlocked from the start.
| -
|-
| '''image_id'''
| Filename of the [[UP001.SPK-UP042.SPK|background image]] displayed on this article, if applicable.
| -
|-
| '''text'''
| String ID of the description displayed on this article.
| -
|-
| '''text_width'''
| Maximum width of the text displayed, only applicable to ''Text & Image'' articles.
| 0
|-
| '''rect_stats'''
| Rectangle ('''x''', '''y''', '''width''', '''height''') of the stats text on the screen, only applicable to ''Craft'' articles.
| 0
|-
| '''rect_text'''
| Rectangle ('''x''', '''y''', '''width''', '''height''') of the description text on the screen, only applicable to ''Craft'' articles.
| 0
|-
| '''weapon'''
| String ID of the weapon, only applicable to ''HWP'' articles.
| -
|}

=== UFO Trajectories ===

Defines a trajectory carried out by an UFO during an [[#Alien Missions|alien mission]], listed in ''"ufoTrajectories:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''id'''
| String ID of the trajectory name.
| ''required''
|-
| '''groundTimer'''
| Amount of seconds for the UFO to spend on Ground waypoints.
| 0
|-
| '''waypoints'''
| List of waypoints for the UFO to traverse, defined as ''[zone, altitude, speed]''. 
'''zone''': Globe zone where the waypoint is located. 
'''altitude''': UFO altitude after reaching this waypoint:
* 0 - Ground
* 1 - Very Low
* 2 - Low
* 3 - High
* 4 - Very High
'''speed''': UFO speed after reaching this waypoint, as a percentage (0-100%) of its maximum speed.
| -
|}

=== Alien Missions ===

Defines an [[Alien Missions|alien mission]] carried out by UFOs on the Geoscape, listed in ''"alienMissions:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the mission type.
| ''required''
|-
| '''points'''
| [[Score]] allocated to aliens for successfully completing this mission.
| 0
|-
| '''raceWeights'''
| List of alien races likely to carry out this mission, and the % chance of them being allocated to this mission, listed by "number of months after game beginning".
| ''required''
|-
| '''waves'''
| List of UFO waves to spawn as this mission progresses, as described below.
| ''required''
|}

==== Waves ====

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''ufo'''
| String ID of the [[#UFOs|UFO]] to spawn.
| ''required''
|-
| '''count'''
| Number of UFOs to spawn.
| 0
|-
| '''trajectory'''
| String ID of the [[#UFO Trajectories|trajectory]] for this UFO to use when entering Earth's atmosphere.
| ''required''
|-
| '''timer'''
| How long after the previous wave should this wave arrive? (in seconds)
| 0
|-
|}

=== Alien Item Levels ===

This is a list of item level probabilities, with a number between 0 and 2 representing an item level from plasma pistols to heavy plasmas, as defined in the deployments, expressing a 10% probability for that item level being used.

0 = first set (plasma pistol/clip)
1 = second set (plasma rifle/clip)
2 = third set (heavy plasma/clip)

For example:
[ 2, 0, 0, 0, 0, 0, 0, 1, 1, 1 ]
would represent a 60% chance for pistols, 30% rifles, and 10% heavy weapons. 
Note that the order does not matter, but the length DOES. each line MUST have 10 digits.

The above can be confusing. There are 10 fields; each number represents 10%. 
There are six instances of '0'. 6x10% = 60% chance of plasma pistol 
There are three instances of '1'. 3x10% = 30% chance of plasma rifle 
There is only one instance of '2'. 1x10% = 10% chance of heavy plasma 

Each line represents a month after the beginning of the game, and there is no limit to the number defined. 
OpenXCom will use the most recently available item level in the event the game goes on forever.

=== Extra Sprites ===

Adds or replaces sprites in an existing [[Image Formats|X-COM image file]], listed in ''"extraSprites:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| Filename of the original/new image to modify.
| ''required''
|-
| '''width'''
'''height'''
| Size of the sprite(s) in pixels.
| 0
0
|-
| '''singleImage'''
| Is the image file just a single sprite (true) or a spritesheet (false)?
| false
|-
| '''subX'''
'''subY'''
| Size of the subdivision in pixels. If a subdivision is specified, then the image file is divided into chunks to form the sprites (eg. spritesheets).
| 0
0
|-
| '''files'''
| List of the new sprites to add/replace, listed as ''spriteID: filename''.
| -
|}

Example:
- type: GIANTBUNNY.PCK
width: 32
height: 40
files:
0: Resources/Bunny/Bunny00.png
1: Resources/Bunny/Bunny01.bmp
2: Resources/Bunny/Bunny02.gif

=== Extra Sounds ===

Adds or replaces sounds in an existing [[SOUND|X-COM sound file]], listed in ''"extraSounds:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| ID of the original sound file to modify:
* BATTLE.CAT - Battlescape sounds, corresponds to ''SOUND1.CAT'' or ''SAMPLE2.CAT'' (55 sounds).
* INTRO.CAT - Intro sounds, corresponds to ''INTRO.CAT'' or ''SAMPLE3.CAT'', probably best not to mess with these.
* GEO.CAT - Geoscape sounds, corresponds to ''SOUND2.CAT'' or ''SAMPLE.CAT'' (14 sounds).
| ''required''
|-
| '''files'''
| List of the new sounds to add/replace, listed as ''soundID: filename''.
| -
|}

Example:
- type: BATTLE.CAT
files:
55: Resources/Sounds/sample.wav

=== Extra Strings ===

Adds or replaces text strings in an existing [[Translations (OpenXcom)|OpenXcom language file]], listed in ''"extraStrings:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| Filename of the original language file to modify, sans extension.
| ''required''
|-
| '''strings'''
| List of the new strings to add/replace, listed as ''stringID: text''.
| -
|}

Example:
- type: en-US
strings:
STR_SNIPER_RIFLE: Sniper Rifle
STR_SNIPER_RIFLE_CLIP: Sniper Rifle Clip
- type: en-GB
strings:
STR_SNIPER_RIFLE: Sniper Rifle
STR_SNIPER_RIFLE_CLIP: Sniper Rifle Clip
- type: de
strings:
STR_SNIPER_RIFLE: Scharfschützengewehr
STR_SNIPER_RIFLE_CLIP: Scharfschützengewehrmunition
- type: ru
strings:
STR_SNIPER_RIFLE: Снайперская винтовка
STR_SNIPER_RIFLE_CLIP: Магазин к снайп. винтовке

=== StatStrings ===

[[Statstrings]] are used for automatically renaming soldiers. They are case sensitive and they are processed in the order in which they are specified.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''string'''
| String to add to name.
| ''required''
|-
| '''psiStrength''' 
'''psiSkill''' 
'''bravery''' 
'''strength''' 
'''firing''' 
'''reactions''' 
'''stamina''' 
'''tu''' 
'''health''' 
'''throwing'''
| One or more stat ranges are ANDed together for success. Each range has a minVal and maxVal. Use YAML standard tilde (~) to indicate null. ((~) = 0 as minvalue; (~) =255 as maxvalue)
| -
|}

Example:
statStrings:
- string: "x"
psiStrength: [~, 30]
- string: "P"
psiStrength: [80, ~]
- string: "p"
psiStrength: [60, 79]
- string: "K"
psiSkill: [60, ~]
- string: "k"
psiSkill: [30, 59]
- string: "b"
bravery: [60, ~]
- string: "c"
bravery: [~, 10]
- string: "w"
strength: [~, 25]
- string: "Snpr"
firing: [60, ~]
reactions: [60, ~]
- string: "M"
firing: [70, ~]
- string: "m"
firing: [60, 69]
- string: "Sct"
reactions: [50, ~]
tu: [60, ~]
- string: "R"
reactions: [60, ~]
- string: "r"
reactions: [50, 59]

==References==
<references />

[[Category:OpenXcom]]

Ruleset Reference (OpenXcom)

2014-12-06T16:31:01Z

Falko: /* Player Units (Soldiers) */

A reference of all the customizable values of everything in a [[Rulesets (OpenXcom)|ruleset]] for the current stable version (1.0) of OpenXcom. For the current nightly versions (with the advanced features currently in development) check [[Ruleset Reference Nightly (OpenXcom)|Ruleset Reference Nightly]].

Some guidelines:
* If a value is omitted from the ruleset, the default is used. You cannot omit ''required'' values.
* Text strings (eg. names) are represented by string IDs from the [[Translations (OpenXcom)|language files]]
* Numerical IDs (used for sprites, sounds, etc.) start at 0, not 1.
* Boolean (yes/no) values are represented by true/false.
* World coordinates are represented in degrees (see [[WORLD.DAT]]).
* Money amounts (prices, costs, etc.) are represented in dollars.
* All paths are '''case sensitive'''! If your ruleset uses external files, make sure that they named properly as described in ruleset.

Items are ordered as they come in the ruleset. To override this, you can specify a ''listOrder''. You can find the default listOrders in [[Ruleset List Order (OpenXcom)|Ruleset List Order]].

=== Countries ===

Defines one of the [[Country Funding (EU)|funding nations]], listed in ''"countries:"''. They're used for activity graphs and player scoring.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the country name.
| ''required''
|-
| '''fundingBase'''
| Country's base funding, in thousands. The starting funding can be anywhere between 1x and 2x the base funding.
| 0
|-
| '''fundingCap'''
| Country's funding cap, in thousands. Once a country reaches this maximum, it will no longer increase its funding.
| 0
|-
| '''labelLon'''
'''labelLat'''
| Longitude and latitude coordinates of the country's label on the globe. This label is only shown when the globe is zoomed in and "detail" is turned on.
| 0.0
0.0
|-
| '''areas'''
| List of "rectangles" on the globe defined as [''lon1'' ''lat1'' ''lon2'' ''lat2'']. Any activity within these areas counts towards the country's graph activity and affects their opinion of the player.
| -
|}

=== Regions ===

Defines one of the [[Geoscape (EU)#World Regions/Countries|world regions]], listed in ''"regions:"''. They're used for base placement, activity graphs and mission spawning.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the region name.
| ''required''
|-
| '''cost'''
| Amount of money spent building an X-COM base in this region (first base is free).
| 0
|-
| '''areas'''
| List of "rectangles" on the globe defined as ''[lon1, lat1, lon2, lat2]''. Any activity within these areas counts towards the region's graph activity.
| -
|-
| '''cities'''
| List of cities belonging to this region. They will be displayed on the globe and used for terror site missions. Each city is defined by their '''lon''' and '''lat''' coordinates and a '''name''' string ID.
| -
|-
| '''regionWeight'''
| Weight of this region when selecting regions for alien missions.
| 0
|-
| '''missionWeights'''
| Weighted list of the different mission types for this region (eg. ''STR_ALIEN_RESEARCH: 14'').
| -
|-
| '''missionZones'''
| List of "rectangles" (''[lon1, lat1, lon2, lat2]'') defining the mission zones for this region. Mission zones are waypoints for UFO trajectories.
| -
|-
| '''missionRegion'''
| Spawn mission in this region instead (used for regions without land).
| -
|}

=== Base Facilities ===

Defines one of the [[Base Facilities (EU)|facilities]] that can be built in an X-COM base, listed in ''"facilities:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the facility name.
| ''required''
|-
| '''requires'''
| List of [[#Research|topics]] (string IDs) that must be researched to unlock this facility. If none are specified, this facility is unlocked from the start.
| -
|-
| '''spriteShape'''
| Sprite ID from [[BASEBITS.PCK]] used to draw the facility's outer shape in the Basescape and UFOpaedia.
| -1
|-
| '''spriteFacility'''
| Sprite ID from [[BASEBITS.PCK]] used to draw the facility's contents in the Basescape and UFOpaedia. Drawn on top of '''spriteShape'''.
| -1
|-
| '''lift'''
| Is this facility an [[Access Lift]]? All base facilities must be connected to the lift.
| false
|-
| '''hyper'''
| Is this facility a [[Hyperwave Decoder]]? Displays extra information for detected UFOs. Only valid for radar facilities.
| false
|-
| '''mind'''
| Is this facility a [[Mind Shield]]? Reduces the chance of UFOs finding your base. Does not stack.
| false
|-
| '''grav'''
| Is this facility a [[Grav Shield]]? Doubles the power of your base defenses. Does not stack.
| false
|-
| '''size'''
| Size of the facility, in grid units. Every facility is square, so a size of 1 means 1x1, 2 means 2x2, etc. Bigger facilities are made up of multiple sprites, for example a 2x2 facility will use 4 sprites for '''spriteShape''' and 4 sprites for '''spriteFacility''' (top-left, top-right, bottom-left, bottom-right).
| 1
|-
| '''buildCost'''
| Amount of money spent to build this facility in the base.
| 0
|-
| '''buildTime'''
| Amount of days it takes for this facility to be built.
| 0
|-
| '''monthlyCost'''
| Amount of money spent monthly for the maintenance of this facility.
| 0
|-
| '''storage'''
| Amount of storage space (for items) this facility provides. See [[Base Stores]].
| 0
|-
| '''personnel'''
| Amount of personnel (soldiers, scientsts, engineers) these quarters can contain.
| 0
|-
| '''aliens'''
| Amount of live aliens this facility can contain. Only checked if the ''alienContainmentLimitEnforced'' option is enabled.
| 0
|-
| '''crafts'''
| Amount of X-COM craft this facility can contain.
| 0
|-
| '''labs'''
| Amount of lab space this facility provides for research projects.
| 0
|-
| '''workshops'''
| Amount of workshop space this facility provides for manufacture projects.
| 0
|-
| '''psiLabs'''
| Amount of soldier space this facility provides for psionic training.
| 0
|-
| '''radarRange'''
| Maximum radar detection range of this facility, in nautical miles.
| 0
|-
| '''radarChance'''
| Chance (0-100%) of this radar detecting a UFO that enters its range.
| 0
|-
| '''defense'''
| Offensive power provided by this base defense against attacking UFOs.
| 0
|-
| '''hitRatio'''
| Chance (0-100) of the base defense hitting an attacking UFO.
| 0
|-
| '''fireSound'''
| Sound ID from [[#Extra_Sounds|GEO.CAT]] played when the base defense fires.
| -1
|-
| '''hitSound'''
| Sound ID from [[#Extra_Sounds|GEO.CAT]] played when the base defense hits a target.
| -1
|-
| '''mapName'''
| [[MAPS|Map]] associated to this facility in Battlescape base defenses.
| -
|-
|}

=== Crafts ===

Defines one of the [[Craft|X-COM crafts]] that go on interception missions, listed in ''"crafts:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the craft name.
| ''required''
|-
| '''requires'''
| List of [[#Research|topics]] (string IDs) that must be researched to unlock this craft. If none are specified, this craft is unlocked from the start.
| -
|-
| '''sprite'''
| Sprite ID from [[BASEBITS.PCK]] used to draw this craft in the Basescape and from [[INTICON.PCK]] used to draw the damage indicator in dogfights.
modders: the corresponding extrasprite file id for BASEBITS.PCK is sprite+33 INTICON.PCK contains a minimized icon id=sprite the file id for the dogfight image is sprite+11
| -1
|-
| '''fuelMax'''
| Maximum amount of fuel this craft can carry. Crafts use up fuel based on their speed while travelling.
| 0
|-
| '''damageMax'''
| Maximum amount of damage this craft can take. If this amount is exceeded, the craft is destroyed.
| 0
|-
| '''speedMax'''
| Maximum speed in nautical miles. Crafts travel at max speed when flying and half speed when patrolling.
| 0
|-
| '''accel'''
| Aceeleration value shown in the UFOpaedia.
| 0
|-
| '''weapons'''
| Amount of craft weapons this craft can equip. The UI can only display a max of 2 weapons.
| 0
|-
| '''soldiers'''
| Amount of soldiers this craft can carry.
| 0
|-
| '''maxItems'''
| Amount of items this craft can carry.
| 80
|-
| '''vehicles'''
| Amount of vehicles this craft can carry.
| 0
|-
| '''costBuy'''
| Amount of money spent for purchasing this craft. If set to 0, the craft will not be available in the Purchase/Recruit screen.
| 0
|-
| '''costRent'''
| Amount of money spent monthly for renting this craft. If set to 0, the craft is not on rental and won't count towards base maintenance.
| 0
|-
| '''costSell'''
| Amount of money gained for selling this craft.
| 0
|-
| '''refuelItem'''
| Item required for refuelling this craft. If no item is specified, the craft uses human fuel.
| 0
|-
| '''repairRate'''
| Amount of damage restored every hour while [[Repairs|Repairing]] in base.
| 1
|-
| '''refuelRate'''
| Amount of fuel restored every 30 mins while [[Refueling]] in base. If specified, a '''refuelItem''' is spent each time.
| 1
|-
| '''radarRange'''
| Detection range of the craft's radar in nautical miles. Every craft radar has a 100% detection chance.
| 600
|-
| '''transferTime'''
| Number of hours it takes to purchase/transfer this craft to a base.
| 0
|-
| '''score'''
| [[Score]] lost when this craft is destroyed.
| 0
|-
| '''spacecraft'''
| Can this craft go to [[Cydonia]]?
| false
|-
| '''battlescapeTerrainData'''
| [[#Terrains|Terrain]] associated to this craft in Battlescape missions.
| -
|}

=== Craft Weapons ===

Defines one of the [[Craft Armaments|weapons]] equipped by X-COM craft for shooting down UFOs, listed in ''"craftWeapons:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the weapon name.
| ''required''
|-
| '''sprite'''
| Sprite ID from [[BASEBITS.PCK]] used to draw the weapon in the Basescape and from [[INTICON.PCK]] used to draw the weapon in dogfights.
modders: the corresponding extrasprites file id for INTICON.PCK is sprite+5 and sprite+48 for BASEBITS.PCK
| -1
|-
| '''sound'''
| Sound ID from [[#Extra_Sounds|GEO.CAT]] played when this weapon fires.
| -1
|-
| '''damage'''
| Amount of damage this weapon does to enemy UFOs.
| 0
|-
| '''range'''
| Maximum range of this weapon in dogfights (in meters).
| 0
|-
| '''accuracy'''
| Chance (0-100%) of each shot hitting the enemy UFO.
| 0
|-
| '''reloadCautious'''
| Time this weapon takes to fire between each shot in ''Cautious Mode''.
| 0
|-
| '''reloadStandard'''
| Time this weapon takes to fire between each shot in ''Standard Mode''.
| 0
|-
| '''reloadAggressive'''
| Time this weapon takes to fire between each shot in ''Aggressive Mode''.
| 0
|-
| '''ammoMax'''
| Maximum amount of ammo this weapon can carry.
| 0
|-
| '''rearmRate'''
| Amount of ammo restored every 30 mins while the craft is [[Rearming]] in base. If specified, '''clip'''s are spent depending on their '''clipSize'''. If the '''clipSize''' of the specified ammo is 0, no '''clip'''s are spent.
| 1
|-
| '''projectileType'''
| Type of the weapon projectile, used for the projectile sprite in dogfights:
* 0 - [[Stingray]]
* 1 - [[Avalanche]]
* 2 - [[Cannon]]
* 3 - [[Fusion Ball]]
* 4 - [[Laser Cannon]]
* 5 - [[Plasma Beam]]
| 2
|-
| '''projectileSpeed'''
| Speed of the weapon projectile in dogfights.
| 0
|-
| '''launcher'''
| String ID of the [[#Items|item]] required to equip this weapon.
| -
|-
| '''clip'''
| String ID of the [[#Items|item]] required to rearm this weapon.
| -
|}

=== Items ===

Defines the Geoscape and Battlescape properties of an [[Equipment (EU)|item]] that can be stored in X-COM bases, listed in ''"items:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the internal item name.
| ''required''
|-
| '''name'''
| String ID of the displayed item name, for cases where it's different from the internal name. If omitted, '''type''' is used.
| -
|-
| '''requires'''
| List of [[#Research|topics]] (string IDs) that must be researched to unlock this item. If none are specified, this item is unlocked from the start. Soldiers can only use unlocked items in the Battlescape.
| -
|-
| '''size'''
| Space occupied by this item in [[Base Stores]]. Can be a decimal value.
| 0.0
|-
| '''costBuy'''
| Amount of money spent for purchasing this item. If set to 0, this item will not be available in the Purchase/Recruit screen.
| 0
|-
| '''costSell'''
| Amount of money gained for selling this item.
| 0
|-
| '''transferTime'''
| Number of hours it takes to purchase/transfer this item to a base.
| 24
|-
| '''weight'''
| [[Item_Weight|Weight]] occupied by this item in a soldier's inventory.
| 999
|-
| '''bigSprite'''
| Sprite ID from [[BIGOBS.PCK]] used to draw this item in a soldier's inventory and UFOpaedia.
| -1
|-
| '''floorSprite'''
| Sprite ID from [[FLOOROB.PCK]] used to draw this item on the floor of a Battlescape tile.
| -1
|-
| '''handSprite'''
| Sprite ID from [[HANDOB.PCK]] used to draw this item on a soldier's hand in the Battlescape.
modders: each handobject needs 8 images (8 directions) define the extrasprites accordingly
| 120
|-
| '''bulletSprite'''
| Sprite ID from ''BulletSprites.png'' used to draw this weapon's projectile on the Battlescape:
* 0 - [[Rocket Launcher]]
* 1 - [[Pistol]]
* 2 - [[Rifle]]
* 3 - [[Auto Cannon]]
* 4 - [[Heavy Cannon]]
* 5 - [[Laser Pistol]]
* 6 - [[Laser Rifle]]
* 7 - [[Heavy Laser]]
* 8 - [[Plasma Rifle|Plasma]]
* 9 - [[Small Launcher]]
* 10 - [[Blaster Launcher]]
for modders: the bulletsprite needs to be put into the extraSprites type "Projectiles" the bulletsprite can contain up to 35 3x3 images. The corresponding file id is 35*[bulletSprite]
| -1
|-
| '''fireSound'''
| Sound ID from [[#Extra_Sounds|BATTLE.CAT]] played when this weapon fires.
| -1
|-
| '''hitSound'''
| Sound ID from [[#Extra_Sounds|BATTLE.CAT]] played when this weapon hits a target.
| -1
|-
| '''hitAnimation'''
| Sprite ID from [[SMOKE.PCK]] used to draw the weapon's "hit explosion".
'''NOTE''': Do not define this value for melee/psi weapons, they use [[HIT.PCK]] and therefore meleeAnimation instead.
| 0
|-
| '''power'''
| Average damage of the weapon, in most cases it will be +-50% this value.
| 0
|-
| '''strengthApplied'''
| Add the attacking unit's strength to this weapon's damage.
| false
|-
| '''compatibleAmmo'''
| List of string IDs of the ammo items that can be loaded on this weapon. If none are specified, the weapon doesn't need ammo.
| -
|-
| '''damageType'''
| What type of [[damage]] does this weapon do:
* 0 - None
* 1 - Armor Piercing
* 2 - Incendiary
* 3 - High Explosive
* 4 - Laser
* 5 - Plasma
* 6 - Stun
* 7 - Melee
* 8 - Acid
* 9 - Smoke
'''NOTE:''' A damage type other than 0-9 will do nothing.
| 0
|-
| '''tuAuto'''
'''accuracyAuto'''
| The percentage (0-100%) of [[Time Units]] (from the soldier's total) required to fire an Auto Shot. If 0, the weapon does not have an Auto Shot.
The base accuracy (0-100%) applied to a soldier's [[Firing Accuracy]] when firing an Auto Shot.
| 0
0
|-
| '''tuSnap'''
'''accuracySnap'''
| The percentage (0-100%) of [[Time Units]] (from the soldier's total) required to fire a Snap Shot. If 0, the weapon does not have a Snap Shot.
The base accuracy (0-100%) applied to a soldier's [[Firing Accuracy]] when firing a Snap Shot.
| 0
0
|-
| '''tuAimed'''
'''accuracyAimed'''
| The percentage (0-100%) of [[Time Units]] (from the soldier's total) required to fire an Aimed Shot. If 0, the weapon does not have an Aimed Shot.
The base accuracy (0-100%) applied to a soldier's [[Firing Accuracy]] when firing an Aimed Shot.
| 0
0
|-
|-
| '''tuMelee'''
'''accuracyMelee'''
| The percentage (0-100%) of [[Time Units]] (from the soldier's total) required to do a melee attack (Hit). If 0, the weapon does not have a melee attack.
The base accuracy (0-100%) applied to a soldier's [[Melee Accuracy]] when doing a melee attack.
| 0
0
|-
| '''clipSize'''
| The amount of ammo stored in each weapon clip. If -1 is specified, this weapon has infinite ammo.
| 0
|-
| '''battleType'''
| Defines the weapon's behavior in the Battlescape:
* 0 - None (Geoscape-only item)
* 1 - [[Weapons|Firearm]]
* 2 - Ammo
* 3 - Melee
* 4 - [[Grenade]]
* 5 - [[Proximity Grenade]]
* 6 - [[Medi-Kit (EU)|Medi-Kit]]
* 7 - [[Motion Scanner]]
* 8 - [[Mind Probe]]
* 9 - [[Psi-Amp]]
* 10 - [[Electro-flare]]
* 11 - Corpse
| 0
|-
| '''twoHanded'''
| Is this weapon two-handed? If true, incurs an accuracy penalty if used with both hands occupied. Note that the handsprite of a twoHanded item is also drawn at a slightly different position than a one handed item.
| false
|-
| '''waypoint'''
| Does this weapon use waypoints? (eg. [[Blaster Launcher]]). Can also be used to make ammo items use the waypoint system.
| false
|-
| '''fixedWeapon'''
| Is this weapon fixed? (it's part of a unit, eg. tanks and terrorist units)
| false
|-
| '''invWidth'''
| Item width in a soldier's inventory (in grid units).
| 1
|-
| '''invHeight'''
| Item height in a soldier's inventory (in grid units).
| 1
|-
| '''painKiller'''
| Amount of painkillers contained in a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''heal'''
| Amount of heal's contained in a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''stimulant'''
| Amount of stimulants contained in a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''woundRecovery'''
| Amount of [[Fatal Wounds]] treated by each heal of a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''healthRecovery'''
| Amount of [[Health]] recovered by each heal of a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''stunRecovery'''
| Amount of [[Stun]] removed by each stimulant of a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''energyRecovery'''
| Amount of [[Energy]] recovered by each stimulant of a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''tuUse'''
| Amount of [[Time Units]] required to use this item (for non-offensive items). It's a flat rate if '''flatRate''' is true, otherwise it's a percentage (0-100%).
| 0
|-
| '''recoveryPoints'''
| [[Score]] gained for recovering this alien artifact.
| 0
|-
| '''armor'''
| How much damage is needed to destroy this item on the ground.
| 20
|-
| '''recover'''
| Is this item recoverable? (gets transported to the X-COM base on mission success)
| true
|-
| '''turretType'''
| Sprite ID from [[TANKS.PCK]] of the turret to assign to this tank:
* 0 - [[Tank/Cannon]]
* 1 - [[Tank/Rocket Launcher]]
* 2 - [[Tank/Laser Cannon]]
* 3 - [[Hovertank/Plasma]]
* 4 - [[Hovertank/Launcher]]
| -1
|-
| '''liveAlien'''
| Does this item represent a live alien? (counts towards [[Alien Containment]])
| false
|-
| '''blastRadius'''
| Size of the projectile explosions. 0 for no explosion. -1 to automatically calculate based on weapon power and damage type (actual '''blastRadius''' currently is capped due [[Explosions#Playing_With_Fire|Explosion calculations]]).
| -1
|-
| '''flatRate'''
| If true, then TU costs for this weapon are a flat rate (instead of a percentage of unit TUs).
| false
|-
| '''arcingShot'''
| Does this weapon fire in an arc?
| false
|-
| '''attraction'''
| Represents how likely an alien is to pick up this item. Values below 5 will be ignored (by design).
| 0
|-
| '''maxRange'''
| Maximum range at which this weapon can operate.
| 200
|-
| '''aimRange'''
| Maximum effective range with this weapon before which range-based dropoff occurs.
| 200
|-
| '''snapRange'''
| Maximum effective range with snap shot before which range-based dropoff occurs. (ufoextender accuracy only)
| 15
|-
| '''autoRange'''
| Maximum effective range with auto shot before which range-based dropoff occurs. (ufoextender accuracy only)
| 7
|-
| '''minRange'''
| Range-based dropoff will work in reverse for ranges below this.
| 0
|-
| '''dropoff'''
| The value by which the accuracy lowers for each tile after (or before) the thresholds above.
| 2
|-
| '''bulletSpeed'''
| How much faster (or slower, if you use a negative number) is a projectile fired from this weapon compared to the average.
| 0
|-
| '''autoShots'''
| How many auto shots does this weapon fire.
| 3
|-
| '''shotgunPellets'''
| Number of projectiles fired per unit of ammunition. (note: due to engine limitations it is currently impossible to draw multiple projectiles in flight.)
| 0
|-
| '''zombieUnit'''
| String ID of the unit used for zombification (eg. [[Chrysallid]]s turn units into [[Zombie]]s).
| none
|-
| '''meleeSound'''
| Sound ID from [[#Extra_Sounds|BATTLE.CAT]] played when this weapon attacks a target with melee.
| 39
|-
| '''meleeHitSound'''
| Sound ID from [[#Extra_Sounds|BATTLE.CAT]] played when this weapon HITS a target with melee.
| -1
|-
| '''meleeAnimation'''
| Sprite ID from HIT.PCK played when this weapon attacks a target with melee.
| 0
|-
| '''meleePower'''
| Damage this weapon will do when using melee. This only applies to Firearms, and is only available as stun damage. For normal melee weapons, use regular power and damage types.
| 0
|-
| '''LOSRequired'''
| Does this item require line of sight? (only applies to mind probes and psi-amps)
| false
|-
| '''skillApplied'''
| Is melee skill applied to the accuracy of an attack made with this object?
| true
|-
|}

=== UFOs ===

Defines one of the [[UFOs]] that invade Earth, listed in ''"ufos:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the UFO name.
| ''required''
|-
| '''size'''
| String ID of the UFO size.
| STR_VERY_SMALL
|-
| '''sprite'''
| Sprite ID from [[INTERWIN.DAT]] used to draw this UFO in the dogfight view and UFOpaedia.
don't try to add more images if you don't want to punch yourself in the face - use modsprite
| -1
|-
| '''modSprite'''
| Filename used to draw this UFO in the dogfight view and UFOpaedia.
| -
|-
| '''damageMax'''
| Maximum amount of damage this UFO can take. If the UFO takes 50% damage, it crash lands. If it takes 100% damage, it is destroyed.
| 0
|-
| '''speedMax'''
| Maximum speed in nautical miles.
| 0
|-
| '''accel'''
| Aceeleration value shown in the UFOpaedia.
| 0
|-
| '''power'''
| Damage power of this UFO's weapon in dogfights.
| 0
|-
| '''range'''
| Maximum range of this UFO's weapon in dogfights (in meters).
| 0
|-
| '''score'''
| [[Score]] gained when this UFO is destroyed, or half this score if it crash lands.
| 0
|-
| '''reload'''
| Time the UFO's weapon takes to fire between each shot.
| 0
|-
| '''breakOffTime'''
| Minimum amount of time for the UFO to be able to break off of a dogfight.
| 0
|-
| '''battlescapeTerrainData'''
| [[#Terrains|Terrain]] associated to this UFO in Battlescape missions.
| ''required''
|-
|}

=== Inventory Sections ===

Defines one of the sections of the [[Inventory TU Table|Battlescape inventory]] (eg. Backpack), listed in ''"invs:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the inventory name.
| ''required''
|-
| '''x'''
'''y'''
| Pixel coordinates of this section on the inventory screen.
| 0
0
|-
| '''type'''
| Type of this section:
* 0 = Slot section, can contain as many items as will fit on the slots.
* 1 = Hand section, can only contain one item regardless of size.
* 2 = Ground section, can contain infinite items.
| 0
|-
| '''slots'''
| List of the grid slots (''[x, y]'') that this section is composed of. For example, to make a 2x2 section, you would have ''[0, 0] [0, 1] [1, 0] [1, 1]''.
| -
|-
| '''costs'''
| List of [[Time Units]] costs to move an item from this section to another one (eg. ''STR_BACKPACK: 16'' means it will cost 16 TUs to move an item from this section to the Backpack).
| -
|-
|}

=== Terrains ===

Defines one of the [[TERRAIN|terrains]] used to generate a Battlescape map, listed in "terrains:".

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''name'''
| String ID of the terrain name.
| ''required''
|-
| '''largeBlockLimit'''
| Maximum amount of large blocks that can be used on map generation.
| 0
|-
| '''textures'''
| List of [[TEXTURE.DAT|Geoscape textures]] that correspond to this terrain.
| -
|-
| '''hemisphere'''
| Geoscape hemisphere associated with this terrain:
* -1 - Northern hemisphere.
* 0 - Both hemispheres.
* 1 - Southern hemisphere.
| 0
|-
| '''mapDataSets'''
| List of filenames (each with matching [[MCD]]/[[Image Formats#PCK|PCK/TAB]] files) that contain the tiles of this terrain.
| -
|-
| '''mapBlocks'''
| List of map blocks (see below) that are used for generating a map.
| -
|-
| '''roadTypeOdds'''
| Odds as a % of generating each type of road (E-W Road, N-S Road, Crossing) odds for crossing are: 100 - EW - NS.
| [0 0]
|-|-
| '''civilianTypes'''
| List of units to use as civilians for this mission.
| [MALE_CIVILIAN, FEMALE_CIVILIAN]
|-
|}

==== Map Blocks ====

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''name'''
| Filename of the [[MAPS|map]].
| ''required''
|-
| '''width'''
| Width of this map block in Battlescape grid units.
| 0
|-
| '''length'''
| Length of this map block in Battlescape grid units.
| 0
|-
| '''height'''
| Height of this map block in Battlescape grid units.
| 1
|-
| '''type'''
| Type of this map block:
* -1 - Undefined
* 0 - Default
* 1 - Landing Zone (for placing X-COM / alien craft)
* 2 - E-W Road (for city maps)
* 3 - N-S Road (for city maps)
* 4 - Road Crossing (for city maps)
* 5 - Dirt (for filling empty base blocks)
* 6 - X-COM spawn point (for [[Alien Base]] / [[Cydonia]] missions)
* 7 - [[Alien Base]] Target
* 8 - [[Cydonia]] Target
| -1
|-
| '''subType'''
| Sub-type of this map block (see '''type''').
| -1
|-
| '''frequency'''
| Frequency of this block in a map.
| 1
|-
| '''maxCount'''
| Maximum amount of times this block can be used in a map. If -1 there is no limit.
| -1
|}

*'''frequency''' defines the odds of the map appearing on the map
** The value assigned (default: 1) is used in ''x/n'', which defines the probability of being chosen.
** ''x'' is the integer defined for the map block's frequency and ''n'' is the combined total of probabilities for all the map types combined.
** This property can only be used in type 0 map blocks.
*'''maxCount''' is the maximum number of times it can be used.
** The value assigned is also used in ''x/n'' to determine the probability of being chosen.
** Each use reduces ''x'' by -1, with the caveat that being used as a Landing Zone type will not reduce the x value since it could result in no available Landing Zones.
** This property can only be used in type 0 map blocks.
* '''hemisphere''' only applies to UFO missions, not Terror ones.
*'''width/length''' defines the size of the map
** be aware that the mapview "width"-label is the openxcom ruleset length parameter
** be aware that the mapview "length"-label is the openxcom ruleset width parameter

==== Guidelines/Tips ====
* All maps with an XCOM/Alien craft require at least one type 1 map block. This map block can only contain ground tiles (no walls or objects), otherwise the game will crash or the walls/objects will be removed.
* All Terror terrains (listed under STR_TERROR_MISSION) require at least 1 map block of '''Types''' 2, 3 and 4 (for a total of 3 maps, which are required to place roads) and the corresponding '''roadTypeOdds''' added to the ruleset.
* If there isn't any map blocks designed as roads since you want to keep your terrain 'random', this can be circumvented by designating all 10x10 map blocks, excluding the one(s) used for the XCOM craft, as either '''Type''' 2, 3 and 4 and by defining their '''subType''' to 0. The game will then randomly choose between the map blocks for each type used in the roads, making them map more random.

=== Armor ===

Defines a Battlescape unit's [[armor]] as well as visual representation (so every unit has an armor), listed in ''"armors:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the armor name.
| ''required''
|-
| '''spriteSheet'''
| Sprite sheet from [[UNITS]] used to draw a unit wearing this armor.
| -
|-
| '''spriteInv'''
| Sprite used for the [[Inventory Backgrounds]] of a unit wearing this armor.
| -
|-
| '''corpseBattle'''
| List of string IDs of the corpse [[#Items|items]] generated when a unit wearing this armor is killed (one per unit tile) on the Battlescape.
| -
|-
| '''corpseGeo'''
| String ID of the corpse [[#Items|item]] associated with this unit on the Geoscape.
| -
|-
| '''storeItem'''
| String ID of the [[#Items|item]] that represents this armor in [[Base Stores]] for equipping.
| -
|-
| '''weight'''
| Physical weight of the armor when worn
| 6
|-
| '''stats'''
| like soldier stats (see below) but these are treated as stat bonuses for wearing the specific armor.
| -
|-
| '''frontArmor'''
| Protection provided on the front of the unit.
| 0
|-
| '''sideArmor'''
| Protection provided on the sides of the unit.
| 0
|-
| '''rearArmor'''
| Protection provided on the rear of the unit.
| 0
|-
| '''underArmor'''
| Protection provided under the unit (eg. from explosions).
| 0
|-
| '''drawingRoutine'''
| Drawing routine used to put together the body parts in the unit's '''spriteSheet''':
* 0 = [[Soldier]], [[Sectoid]]
* 1 = [[Floater]]
* 2 = [[HWP]]
* 3 = [[Cyberdisk]]
* 4 = [[Civilian]], [[Ethereal]]
* 5 = [[Sectopod]], [[Reaper]]
* 6 = [[Snakeman]]
* 7 = [[Chryssalid]]
* 8 = [[Silacoid]]
* 9 = [[Celatid]]
* 10 = [[Muton]]
| 0
|-
| '''movementType'''
| Type of movement provided by this armor:
* 0 = Walking
* 1 = Flying
* 2 = Sliding (no walking animation)
it also defines the body of an tank (32-images) in your spriteSheet or the change in sprites while flying using a flying armour see: [[TANKS.PCK]], [[XCOM_2.PCK]]
| 0
|-
| '''damageModifier'''
| List of decimal damage modifiers (1.0 = 100%) this armor applies to each damage type (see [[#Items|Items section]]) received. Modifiers must be specified for all damage types, in this order:
* None
* Armor Piercing
* Incendiary
* High Explosive
* Laser
* Plasma
* Stun
* Melee
* Acid
* Smoke
|
- 1.0 
- 1.0 
- 1.0 
- 1.0 
- 1.0 
- 1.0 
- 1.0 
- 1.0 
- 1.0 
- 1.0
|-
| '''size'''
| Size of the unit wearing this armor, in Battlescape grid units. Every unit is square, so a size of 2 means 2x2.
| 1
|-
| '''loftempsSet'''
| List of [[LOFTEMPS]] IDs (one per unit tile, so a 1x1 unit has 1, a 2x2 unit has 4, etc.) used to represent a unit wearing this armor in 3D space.
| -
|-
| '''loftemps'''
| loftemps is a deprecated option that only works for 1x1 sized units.
| -
|}

=== Player Units (Soldiers) ===

Defines a [[soldier]] recruited by X-COM, listed in ''"soldiers:"''. Currently only one soldier unit type (''XCOM'') is supported.

Unit stats are represented as follows:
* [[Time Units|tu]]
* [[Energy|stamina]]
* [[Health|health]]
* [[Bravery|bravery]] (always a multiple of 10)
* [[Reactions|reactions]]
* [[Firing Accuracy|firing]]
* [[Throwing Accuracy|throwing]]
* [[Strength|strength]]
* [[Psi Strength|psiStrength]]
* [[Psi Skill|psiSkill]]
* [[Melee Accuracy|melee]] (not visible)

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the soldier name.
| ''required''
|-
| '''minStats'''
| Minimum values used to generate the soldier's [[Starting Stats]]. In this case, ''psiSkill'' is treated as the initial stat (not generated).
| -
|-
| '''maxStats'''
| Maximum values used to generate the soldier's [[Starting Stats]]. In this case, ''psiSkill'' is treated as the minimum value for the first month of psi training (actual value is 100%-150%).
| -
|-
| '''statCaps'''
| Maximum stats this soldier can gain through [[Experience]]. '''NOTE:''' A stat will still go over the limit once, and then will no longer increase (see [[Experience#Regarding Caps|Regarding Caps]]).
| -
|-
| '''armor'''
| String ID of the [[#Armor|armor]] this soldier uses by default.
| -
|-
| '''standHeight'''
| Height of this soldier when standing.
| 0
|-
| '''kneelHeight'''
| Height of this soldier when kneeling.
| 0
|-
| '''floatHeight'''
| Distance between the bottom of this unit and the ground.
| 0
|}

=== AI Units (Aliens/Civilians) ===

Defines an [[Alien Life Forms|alien]] (enemy) or [[civilian]] (neutral) unit, listed in ''"units:"''. Every different alien rank is a different unit, since they have completely different stats. Unit stats are represented as follows:
* [[Time Units|tu]]
* [[Energy|stamina]]
* [[Health|health]]
* [[Bravery|bravery]] (always a multiple of 10)
* [[Reactions|reactions]]
* [[Firing Accuracy|firing]]
* [[Throwing Accuracy|throwing]]
* [[Strength|strength]]
* [[Psi Strength|psiStrength]]
* [[Psi Skill|psiSkill]]
* [[Melee Accuracy|melee]] (not visible)

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the unit name.
| ''required''
|-
| '''race'''
| String ID of the unit race (for alien units).
| -
|-
| '''rank'''
| String ID of the unit rank (for alien units).
| -
|-
| '''stats'''
| Battlescape stats of this unit.
| -
|-
| '''armor'''
| String ID of the [[#Armor|armor]] this unit uses by default.
| -
|-
| '''standHeight'''
| Height of this unit when standing.
| 0
|-
| '''floatHeight'''
| Distance between the bottom of this unit and the ground.
| 0
|-
| '''value'''
| [[Score]] this unit is worth.
| 0
|-
| '''deathSound'''
| Sound ID from [[#Extra_Sounds|BATTLE.CAT]] played when this unit dies.
| -1
|-
| '''aggroSound'''
| Sound ID from [[#Extra_Sounds|BATTLE.CAT]] played when this unit aggros.
| -1
|-
| '''moveSound'''
| Sound ID from [[#Extra_Sounds|BATTLE.CAT]] played when this unit moves.
| -1
|-
| '''intelligence'''
| Intelligence of this unit's AI. The higher the value, the longer this unit remembers player troops between turns.
| 0
|-
| '''aggression'''
| Aggression of this unit's AI. The higher the value, the more ruthless the unit, the more likely to make a frontal assault. Less aggressive units tend to set up ambushes.
Vanilla values are:
* 0 = mostly passive
* 1 = balanced
* 2 = mostly aggresive
| 0
|-
| '''energyRecovery'''
| Energy recovered by the unit each turn (needs verification)
| 40 (?)
|-
| '''specab'''
| Special ability of this unit:
* 0 = None
* 1 = [[Cyberdisc|Explodes on Death]]
* 2 = [[Bio-Drone|Burns Floor]]
* 3 = [[Zombie|Respawns on Death]]
| 0
|-
| '''spawnUnit'''
| String ID of the unit used to respawn on death (eg. [[Zombie]]s respawn as [[Chrysallid]]s).
| -
|-
| '''livingWeapon'''
| Is this unit a living weapon? (only attacks with a '''fixedWeapon''')
| false
|-
|}

=== Alien Races ===

Defines a [[Alien Life Forms|race]] used in [[Alien Missions]], listed in ''"alienRaces:"''. Heavily tied with deployment data.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''id'''
| String ID of the alien race name.
| ''required''
|-
| '''members'''
| Alien crew associated with this alien race (eg. race units + terrorist units), defined by a list of unit string IDs. Order here will define rank in terms of deployment. generally speaking the order is:
* 0 - Commander
* 1 - Leader
* 2 - Engineer
* 3 - Medic
* 4 - Navigator
* 5 - Soldier
* 6 - Terrorist 1
* 7 - Terrorist 2
but of course, not all races have all ranks, so the "fill in" rank would be listed multiple times (see ethereals).
| -
|-
| '''retaliation'''
| retaliation enables/disables the race for retaliation missions.
| ''True''
|-
|}

=== Alien Deployments ===

Defines a Battlescape deployment data used in [[Alien Missions]] (such as alien and map configurations), listed in ''"alienDeployments:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the deployment name.
| ''required''
|-
| '''width'''
| Width of the Battlescape map in grid units.
| 0
|-
| '''length'''
| Length of the Battlescape map in grid units.
| 0
|-
| '''height'''
| Vertical height of the Battlescape map in grid units.
| 0
|-
| '''terrains'''
| list of string IDs of the [[#Terrains|terrain]] to choose from to generate this map. This is not used for UFO sites where the terrain comes from the Geoscape.
| -
|-
| '''shade'''
| Shade of the map (0-15, where 0 is full daytime and 15 is full nighttime). This is not used for UFO sites where the shade comes from the Geoscape.
| 0
|-
| '''nextStage'''
| String ID of the next deployment stage to use after this one, for multi-stage missions.
| -
|-
| '''data'''
| List of deployment data for each alien rank on this mission (see below).
| -
|}

Notes:
* '''terrains''' can also be used with UFOs, with the game using instead the listed terrain rather than the location of the UFO on Geoscape.
==== Deployment Data ====

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''alienRank'''
| [[Alien Rank|Rank]] associated with this deployment data, as defined by the order of the race in question (see above)
| ''required''
|-
| '''lowQty'''
| Maximum quantity of aliens to spawn (beginner).
| 0
|-
| '''highQty'''
| Maximum quantity of aliens to spawn (superhuman).
| 0
|-
| '''dQty'''
| Minimum Desired Quantity of aliens to spawn.
| 0
|-
| '''percentageOutsideUfo'''
| Percentage (0-100%) of aliens to spawn outside in UFO sites.
| 0
|-
| '''itemSets'''
| Three lists (one for each alien technology level) of [[#Items|items]] (string IDs) for the aliens to equip.
| ''required''
|-
|}

=== Research ===

Defines a [[Research|research topic]] that X-COM scientists can investigate, listed in ''"research:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''name'''
| String ID of the research project's name (or item, if a '''lookup''' is defined).
| ''required''
|-
| '''lookup'''
| String ID of the research project's display name and UFOPaedia article reference.
| -
|-
| '''cost'''
| Number of man hours (on average) required to complete this project.
| 0
|-
| '''points'''
| [[Score]] earned for completing this project.
| 0
|-
| '''needItem'''
| Does this project require an [[#Items|item]] of the same name?
| false
|-
| '''dependencies'''
| List of research projects that can unlock access to this one. If the full list is researched, or if one of the projects on the list "unlocks" this one, it becomes available.
| -
|-
| '''unlocks'''
| List of research projects unlocked, regardless of other dependencies, but not requirements, by completing this project (for example, any live alien unlocks "alien origins").
| -
|-
| '''requires'''
| List of research projects unilaterally required before this project can be unlocked (for example, "the martian solution" will not even be considered for unlocking until AFTER "alien origins" is completed).
| -
|-
| '''getOneFree'''
| List of "bonus" research projects that may be granted when completing this project (for example, alien medics will give you information on other alien races). Only applies to living aliens.
| -
|-
|}

=== Manufacture ===

Defines a [[Manufacture|manufacture project]] that X-COM engineers can produce, listed in ''"manufacture:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''name'''
| String ID of the manufacturing project's name (and the item it produces).
| ''required''
|-
| '''category'''
| String ID of the manufacturing project's category.
| -
|-
| '''requires'''
| List of [[#Research|topics]] (string IDs) that must be researched to unlock this project. If none are specified, this project is unlocked from the start.
| -
|-
| '''space'''
| Amount of [[Workshop]] space required to begin this project.
| 0
|-
| '''time'''
| Number of man hours (on average) required per item.
| 0
|-
| '''cost'''
| Monetary deduction per item manufactured.
| 0
|-
| '''requiredItems'''
| List of [[#Items|items]] required and consumed per item manufactured.
| -
|-
| '''producedItems'''
| List of [[#Items|items]] produced per each item consumed. If not specified, defaults to 1 item with the same string ID as the manufacture.
| 1
|-
|}

=== UFOpaedia Article ===

Defines an article in the in-game [[UFOpaedia]], listed in ''"ufopaedia:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''id'''
| String ID of the article name. This must match the ID of the object associated with this article, if applicable.
| ''required''
|-
| '''title'''
| String ID of the article title. If omitted, the '''id''' is used.
| -
|-
| '''type_id'''
| Type of this article:
* 0 = Unknown
* 1 = [[Craft]]
* 2 = [[Craft Armaments]]
* 3 = [[HWP]]
* 4 = [[Equipment (EU)|Equipment]]
* 5 = [[Armour]]
* 6 = [[Base Facilities]]
* 7 = Text & Image (eg. [[Alien Life Forms]], [[UFO Components]])
* 8 = Text (eg. [[Alien Research]])
* 9 = [[UFO]]
| 0
|-
| '''section'''
| String ID of the UFOpaedia section this article belongs in.
| -
|-
| '''requires'''
| List of [[#Research|topics]] (string IDs) that must be researched to unlock this article. If none are specified, this article is unlocked from the start.
| -
|-
| '''image_id'''
| Filename of the [[UP001.SPK-UP042.SPK|background image]] displayed on this article, if applicable.
| -
|-
| '''text'''
| String ID of the description displayed on this article.
| -
|-
| '''text_width'''
| Maximum width of the text displayed, only applicable to ''Text & Image'' articles.
| 0
|-
| '''rect_stats'''
| Rectangle ('''x''', '''y''', '''width''', '''height''') of the stats text on the screen, only applicable to ''Craft'' articles.
| 0
|-
| '''rect_text'''
| Rectangle ('''x''', '''y''', '''width''', '''height''') of the description text on the screen, only applicable to ''Craft'' articles.
| 0
|-
| '''weapon'''
| String ID of the weapon, only applicable to ''HWP'' articles.
| -
|}

=== UFO Trajectories ===

Defines a trajectory carried out by an UFO during an [[#Alien Missions|alien mission]], listed in ''"ufoTrajectories:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''id'''
| String ID of the trajectory name.
| ''required''
|-
| '''groundTimer'''
| Amount of seconds for the UFO to spend on Ground waypoints.
| 0
|-
| '''waypoints'''
| List of waypoints for the UFO to traverse, defined as ''[zone, altitude, speed]''. 
'''zone''': Globe zone where the waypoint is located. 
'''altitude''': UFO altitude after reaching this waypoint:
* 0 - Ground
* 1 - Very Low
* 2 - Low
* 3 - High
* 4 - Very High
'''speed''': UFO speed after reaching this waypoint, as a percentage (0-100%) of its maximum speed.
| -
|}

=== Alien Missions ===

Defines an [[Alien Missions|alien mission]] carried out by UFOs on the Geoscape, listed in ''"alienMissions:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the mission type.
| ''required''
|-
| '''points'''
| [[Score]] allocated to aliens for successfully completing this mission.
| 0
|-
| '''raceWeights'''
| List of alien races likely to carry out this mission, and the % chance of them being allocated to this mission, listed by "number of months after game beginning".
| ''required''
|-
| '''waves'''
| List of UFO waves to spawn as this mission progresses, as described below.
| ''required''
|}

==== Waves ====

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''ufo'''
| String ID of the [[#UFOs|UFO]] to spawn.
| ''required''
|-
| '''count'''
| Number of UFOs to spawn.
| 0
|-
| '''trajectory'''
| String ID of the [[#UFO Trajectories|trajectory]] for this UFO to use when entering Earth's atmosphere.
| ''required''
|-
| '''timer'''
| How long after the previous wave should this wave arrive? (in seconds)
| 0
|-
|}

=== Alien Item Levels ===

This is a list of item level probabilities, with a number between 0 and 2 representing an item level from plasma pistols to heavy plasmas, as defined in the deployments, expressing a 10% probability for that item level being used.

0 = first set (plasma pistol/clip)
1 = second set (plasma rifle/clip)
2 = third set (heavy plasma/clip)

For example:
[ 2, 0, 0, 0, 0, 0, 0, 1, 1, 1 ]
would represent a 60% chance for pistols, 30% rifles, and 10% heavy weapons. 
Note that the order does not matter, but the length DOES. each line MUST have 10 digits.

The above can be confusing. There are 10 fields; each number represents 10%. 
There are six instances of '0'. 6x10% = 60% chance of plasma pistol 
There are three instances of '1'. 3x10% = 30% chance of plasma rifle 
There is only one instance of '2'. 1x10% = 10% chance of heavy plasma 

Each line represents a month after the beginning of the game, and there is no limit to the number defined. 
OpenXCom will use the most recently available item level in the event the game goes on forever.

=== Extra Sprites ===

Adds or replaces sprites in an existing [[Image Formats|X-COM image file]], listed in ''"extraSprites:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| Filename of the original/new image to modify.
| ''required''
|-
| '''width'''
'''height'''
| Size of the sprite(s) in pixels.
| 0
0
|-
| '''singleImage'''
| Is the image file just a single sprite (true) or a spritesheet (false)?
| false
|-
| '''subX'''
'''subY'''
| Size of the subdivision in pixels. If a subdivision is specified, then the image file is divided into chunks to form the sprites (eg. spritesheets).
| 0
0
|-
| '''files'''
| List of the new sprites to add/replace, listed as ''spriteID: filename''.
| -
|}

Example:
- type: GIANTBUNNY.PCK
width: 32
height: 40
files:
0: Resources/Bunny/Bunny00.png
1: Resources/Bunny/Bunny01.bmp
2: Resources/Bunny/Bunny02.gif

=== Extra Sounds ===

Adds or replaces sounds in an existing [[SOUND|X-COM sound file]], listed in ''"extraSounds:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| ID of the original sound file to modify:
* BATTLE.CAT - Battlescape sounds, corresponds to ''SOUND1.CAT'' or ''SAMPLE2.CAT'' (55 sounds).
* INTRO.CAT - Intro sounds, corresponds to ''INTRO.CAT'' or ''SAMPLE3.CAT'', probably best not to mess with these.
* GEO.CAT - Geoscape sounds, corresponds to ''SOUND2.CAT'' or ''SAMPLE.CAT'' (14 sounds).
| ''required''
|-
| '''files'''
| List of the new sounds to add/replace, listed as ''soundID: filename''.
| -
|}

Example:
- type: BATTLE.CAT
files:
55: Resources/Sounds/sample.wav

=== Extra Strings ===

Adds or replaces text strings in an existing [[Translations (OpenXcom)|OpenXcom language file]], listed in ''"extraStrings:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| Filename of the original language file to modify, sans extension.
| ''required''
|-
| '''strings'''
| List of the new strings to add/replace, listed as ''stringID: text''.
| -
|}

Example:
- type: en-US
strings:
STR_SNIPER_RIFLE: Sniper Rifle
STR_SNIPER_RIFLE_CLIP: Sniper Rifle Clip
- type: en-GB
strings:
STR_SNIPER_RIFLE: Sniper Rifle
STR_SNIPER_RIFLE_CLIP: Sniper Rifle Clip
- type: de
strings:
STR_SNIPER_RIFLE: Scharfschützengewehr
STR_SNIPER_RIFLE_CLIP: Scharfschützengewehrmunition
- type: ru
strings:
STR_SNIPER_RIFLE: Снайперская винтовка
STR_SNIPER_RIFLE_CLIP: Магазин к снайп. винтовке

=== Interfaces ===

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| ''?''
| -
|-
| '''elements'''
| ''?''
| -
|-
| '''id'''
| ''?''
| -
|-
| '''color'''
| ''?''
| -
|}

=== StatStrings ===

[[Statstrings]] are used for automatically renaming soldiers. They are case sensitive and they are processed in the order in which they are specified.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''string'''
| String to add to name.
| ''required''
|-
| '''psiStrength''' 
'''psiSkill''' 
'''bravery''' 
'''strength''' 
'''firing''' 
'''reactions''' 
'''stamina''' 
'''tu''' 
'''health''' 
'''throwing'''
| One or more stat ranges are ANDed together for success. Each range has a minVal and maxVal. Use YAML standard tilde (~) to indicate null. ((~) = 0 as minvalue; (~) =255 as maxvalue)
| -
|}

Example:
statStrings:
- string: "x"
psiStrength: [~, 30]
- string: "P"
psiStrength: [80, ~]
- string: "p"
psiStrength: [60, 79]
- string: "K"
psiSkill: [60, ~]
- string: "k"
psiSkill: [30, 59]
- string: "b"
bravery: [60, ~]
- string: "c"
bravery: [~, 10]
- string: "w"
strength: [~, 25]
- string: "Snpr"
firing: [60, ~]
reactions: [60, ~]
- string: "M"
firing: [70, ~]
- string: "m"
firing: [60, 69]
- string: "Sct"
reactions: [50, ~]
tu: [60, ~]
- string: "R"
reactions: [60, ~]
- string: "r"
reactions: [50, 59]

==References==
<references />

[[Category:OpenXcom]]

Ruleset Reference (OpenXcom)

2014-12-06T16:29:33Z

Falko:

A reference of all the customizable values of everything in a [[Rulesets (OpenXcom)|ruleset]] for the current stable version (1.0) of OpenXcom. For the current nightly versions (with the advanced features currently in development) check [[Ruleset Reference Nightly (OpenXcom)|Ruleset Reference Nightly]].

Some guidelines:
* If a value is omitted from the ruleset, the default is used. You cannot omit ''required'' values.
* Text strings (eg. names) are represented by string IDs from the [[Translations (OpenXcom)|language files]]
* Numerical IDs (used for sprites, sounds, etc.) start at 0, not 1.
* Boolean (yes/no) values are represented by true/false.
* World coordinates are represented in degrees (see [[WORLD.DAT]]).
* Money amounts (prices, costs, etc.) are represented in dollars.
* All paths are '''case sensitive'''! If your ruleset uses external files, make sure that they named properly as described in ruleset.

Items are ordered as they come in the ruleset. To override this, you can specify a ''listOrder''. You can find the default listOrders in [[Ruleset List Order (OpenXcom)|Ruleset List Order]].

=== Countries ===

Defines one of the [[Country Funding (EU)|funding nations]], listed in ''"countries:"''. They're used for activity graphs and player scoring.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the country name.
| ''required''
|-
| '''fundingBase'''
| Country's base funding, in thousands. The starting funding can be anywhere between 1x and 2x the base funding.
| 0
|-
| '''fundingCap'''
| Country's funding cap, in thousands. Once a country reaches this maximum, it will no longer increase its funding.
| 0
|-
| '''labelLon'''
'''labelLat'''
| Longitude and latitude coordinates of the country's label on the globe. This label is only shown when the globe is zoomed in and "detail" is turned on.
| 0.0
0.0
|-
| '''areas'''
| List of "rectangles" on the globe defined as [''lon1'' ''lat1'' ''lon2'' ''lat2'']. Any activity within these areas counts towards the country's graph activity and affects their opinion of the player.
| -
|}

=== Regions ===

Defines one of the [[Geoscape (EU)#World Regions/Countries|world regions]], listed in ''"regions:"''. They're used for base placement, activity graphs and mission spawning.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the region name.
| ''required''
|-
| '''cost'''
| Amount of money spent building an X-COM base in this region (first base is free).
| 0
|-
| '''areas'''
| List of "rectangles" on the globe defined as ''[lon1, lat1, lon2, lat2]''. Any activity within these areas counts towards the region's graph activity.
| -
|-
| '''cities'''
| List of cities belonging to this region. They will be displayed on the globe and used for terror site missions. Each city is defined by their '''lon''' and '''lat''' coordinates and a '''name''' string ID.
| -
|-
| '''regionWeight'''
| Weight of this region when selecting regions for alien missions.
| 0
|-
| '''missionWeights'''
| Weighted list of the different mission types for this region (eg. ''STR_ALIEN_RESEARCH: 14'').
| -
|-
| '''missionZones'''
| List of "rectangles" (''[lon1, lat1, lon2, lat2]'') defining the mission zones for this region. Mission zones are waypoints for UFO trajectories.
| -
|-
| '''missionRegion'''
| Spawn mission in this region instead (used for regions without land).
| -
|}

=== Base Facilities ===

Defines one of the [[Base Facilities (EU)|facilities]] that can be built in an X-COM base, listed in ''"facilities:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the facility name.
| ''required''
|-
| '''requires'''
| List of [[#Research|topics]] (string IDs) that must be researched to unlock this facility. If none are specified, this facility is unlocked from the start.
| -
|-
| '''spriteShape'''
| Sprite ID from [[BASEBITS.PCK]] used to draw the facility's outer shape in the Basescape and UFOpaedia.
| -1
|-
| '''spriteFacility'''
| Sprite ID from [[BASEBITS.PCK]] used to draw the facility's contents in the Basescape and UFOpaedia. Drawn on top of '''spriteShape'''.
| -1
|-
| '''lift'''
| Is this facility an [[Access Lift]]? All base facilities must be connected to the lift.
| false
|-
| '''hyper'''
| Is this facility a [[Hyperwave Decoder]]? Displays extra information for detected UFOs. Only valid for radar facilities.
| false
|-
| '''mind'''
| Is this facility a [[Mind Shield]]? Reduces the chance of UFOs finding your base. Does not stack.
| false
|-
| '''grav'''
| Is this facility a [[Grav Shield]]? Doubles the power of your base defenses. Does not stack.
| false
|-
| '''size'''
| Size of the facility, in grid units. Every facility is square, so a size of 1 means 1x1, 2 means 2x2, etc. Bigger facilities are made up of multiple sprites, for example a 2x2 facility will use 4 sprites for '''spriteShape''' and 4 sprites for '''spriteFacility''' (top-left, top-right, bottom-left, bottom-right).
| 1
|-
| '''buildCost'''
| Amount of money spent to build this facility in the base.
| 0
|-
| '''buildTime'''
| Amount of days it takes for this facility to be built.
| 0
|-
| '''monthlyCost'''
| Amount of money spent monthly for the maintenance of this facility.
| 0
|-
| '''storage'''
| Amount of storage space (for items) this facility provides. See [[Base Stores]].
| 0
|-
| '''personnel'''
| Amount of personnel (soldiers, scientsts, engineers) these quarters can contain.
| 0
|-
| '''aliens'''
| Amount of live aliens this facility can contain. Only checked if the ''alienContainmentLimitEnforced'' option is enabled.
| 0
|-
| '''crafts'''
| Amount of X-COM craft this facility can contain.
| 0
|-
| '''labs'''
| Amount of lab space this facility provides for research projects.
| 0
|-
| '''workshops'''
| Amount of workshop space this facility provides for manufacture projects.
| 0
|-
| '''psiLabs'''
| Amount of soldier space this facility provides for psionic training.
| 0
|-
| '''radarRange'''
| Maximum radar detection range of this facility, in nautical miles.
| 0
|-
| '''radarChance'''
| Chance (0-100%) of this radar detecting a UFO that enters its range.
| 0
|-
| '''defense'''
| Offensive power provided by this base defense against attacking UFOs.
| 0
|-
| '''hitRatio'''
| Chance (0-100) of the base defense hitting an attacking UFO.
| 0
|-
| '''fireSound'''
| Sound ID from [[#Extra_Sounds|GEO.CAT]] played when the base defense fires.
| -1
|-
| '''hitSound'''
| Sound ID from [[#Extra_Sounds|GEO.CAT]] played when the base defense hits a target.
| -1
|-
| '''mapName'''
| [[MAPS|Map]] associated to this facility in Battlescape base defenses.
| -
|-
|}

=== Crafts ===

Defines one of the [[Craft|X-COM crafts]] that go on interception missions, listed in ''"crafts:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the craft name.
| ''required''
|-
| '''requires'''
| List of [[#Research|topics]] (string IDs) that must be researched to unlock this craft. If none are specified, this craft is unlocked from the start.
| -
|-
| '''sprite'''
| Sprite ID from [[BASEBITS.PCK]] used to draw this craft in the Basescape and from [[INTICON.PCK]] used to draw the damage indicator in dogfights.
modders: the corresponding extrasprite file id for BASEBITS.PCK is sprite+33 INTICON.PCK contains a minimized icon id=sprite the file id for the dogfight image is sprite+11
| -1
|-
| '''fuelMax'''
| Maximum amount of fuel this craft can carry. Crafts use up fuel based on their speed while travelling.
| 0
|-
| '''damageMax'''
| Maximum amount of damage this craft can take. If this amount is exceeded, the craft is destroyed.
| 0
|-
| '''speedMax'''
| Maximum speed in nautical miles. Crafts travel at max speed when flying and half speed when patrolling.
| 0
|-
| '''accel'''
| Aceeleration value shown in the UFOpaedia.
| 0
|-
| '''weapons'''
| Amount of craft weapons this craft can equip. The UI can only display a max of 2 weapons.
| 0
|-
| '''soldiers'''
| Amount of soldiers this craft can carry.
| 0
|-
| '''maxItems'''
| Amount of items this craft can carry.
| 80
|-
| '''vehicles'''
| Amount of vehicles this craft can carry.
| 0
|-
| '''costBuy'''
| Amount of money spent for purchasing this craft. If set to 0, the craft will not be available in the Purchase/Recruit screen.
| 0
|-
| '''costRent'''
| Amount of money spent monthly for renting this craft. If set to 0, the craft is not on rental and won't count towards base maintenance.
| 0
|-
| '''costSell'''
| Amount of money gained for selling this craft.
| 0
|-
| '''refuelItem'''
| Item required for refuelling this craft. If no item is specified, the craft uses human fuel.
| 0
|-
| '''repairRate'''
| Amount of damage restored every hour while [[Repairs|Repairing]] in base.
| 1
|-
| '''refuelRate'''
| Amount of fuel restored every 30 mins while [[Refueling]] in base. If specified, a '''refuelItem''' is spent each time.
| 1
|-
| '''radarRange'''
| Detection range of the craft's radar in nautical miles. Every craft radar has a 100% detection chance.
| 600
|-
| '''transferTime'''
| Number of hours it takes to purchase/transfer this craft to a base.
| 0
|-
| '''score'''
| [[Score]] lost when this craft is destroyed.
| 0
|-
| '''spacecraft'''
| Can this craft go to [[Cydonia]]?
| false
|-
| '''battlescapeTerrainData'''
| [[#Terrains|Terrain]] associated to this craft in Battlescape missions.
| -
|}

=== Craft Weapons ===

Defines one of the [[Craft Armaments|weapons]] equipped by X-COM craft for shooting down UFOs, listed in ''"craftWeapons:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the weapon name.
| ''required''
|-
| '''sprite'''
| Sprite ID from [[BASEBITS.PCK]] used to draw the weapon in the Basescape and from [[INTICON.PCK]] used to draw the weapon in dogfights.
modders: the corresponding extrasprites file id for INTICON.PCK is sprite+5 and sprite+48 for BASEBITS.PCK
| -1
|-
| '''sound'''
| Sound ID from [[#Extra_Sounds|GEO.CAT]] played when this weapon fires.
| -1
|-
| '''damage'''
| Amount of damage this weapon does to enemy UFOs.
| 0
|-
| '''range'''
| Maximum range of this weapon in dogfights (in meters).
| 0
|-
| '''accuracy'''
| Chance (0-100%) of each shot hitting the enemy UFO.
| 0
|-
| '''reloadCautious'''
| Time this weapon takes to fire between each shot in ''Cautious Mode''.
| 0
|-
| '''reloadStandard'''
| Time this weapon takes to fire between each shot in ''Standard Mode''.
| 0
|-
| '''reloadAggressive'''
| Time this weapon takes to fire between each shot in ''Aggressive Mode''.
| 0
|-
| '''ammoMax'''
| Maximum amount of ammo this weapon can carry.
| 0
|-
| '''rearmRate'''
| Amount of ammo restored every 30 mins while the craft is [[Rearming]] in base. If specified, '''clip'''s are spent depending on their '''clipSize'''. If the '''clipSize''' of the specified ammo is 0, no '''clip'''s are spent.
| 1
|-
| '''projectileType'''
| Type of the weapon projectile, used for the projectile sprite in dogfights:
* 0 - [[Stingray]]
* 1 - [[Avalanche]]
* 2 - [[Cannon]]
* 3 - [[Fusion Ball]]
* 4 - [[Laser Cannon]]
* 5 - [[Plasma Beam]]
| 2
|-
| '''projectileSpeed'''
| Speed of the weapon projectile in dogfights.
| 0
|-
| '''launcher'''
| String ID of the [[#Items|item]] required to equip this weapon.
| -
|-
| '''clip'''
| String ID of the [[#Items|item]] required to rearm this weapon.
| -
|}

=== Items ===

Defines the Geoscape and Battlescape properties of an [[Equipment (EU)|item]] that can be stored in X-COM bases, listed in ''"items:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the internal item name.
| ''required''
|-
| '''name'''
| String ID of the displayed item name, for cases where it's different from the internal name. If omitted, '''type''' is used.
| -
|-
| '''requires'''
| List of [[#Research|topics]] (string IDs) that must be researched to unlock this item. If none are specified, this item is unlocked from the start. Soldiers can only use unlocked items in the Battlescape.
| -
|-
| '''size'''
| Space occupied by this item in [[Base Stores]]. Can be a decimal value.
| 0.0
|-
| '''costBuy'''
| Amount of money spent for purchasing this item. If set to 0, this item will not be available in the Purchase/Recruit screen.
| 0
|-
| '''costSell'''
| Amount of money gained for selling this item.
| 0
|-
| '''transferTime'''
| Number of hours it takes to purchase/transfer this item to a base.
| 24
|-
| '''weight'''
| [[Item_Weight|Weight]] occupied by this item in a soldier's inventory.
| 999
|-
| '''bigSprite'''
| Sprite ID from [[BIGOBS.PCK]] used to draw this item in a soldier's inventory and UFOpaedia.
| -1
|-
| '''floorSprite'''
| Sprite ID from [[FLOOROB.PCK]] used to draw this item on the floor of a Battlescape tile.
| -1
|-
| '''handSprite'''
| Sprite ID from [[HANDOB.PCK]] used to draw this item on a soldier's hand in the Battlescape.
modders: each handobject needs 8 images (8 directions) define the extrasprites accordingly
| 120
|-
| '''bulletSprite'''
| Sprite ID from ''BulletSprites.png'' used to draw this weapon's projectile on the Battlescape:
* 0 - [[Rocket Launcher]]
* 1 - [[Pistol]]
* 2 - [[Rifle]]
* 3 - [[Auto Cannon]]
* 4 - [[Heavy Cannon]]
* 5 - [[Laser Pistol]]
* 6 - [[Laser Rifle]]
* 7 - [[Heavy Laser]]
* 8 - [[Plasma Rifle|Plasma]]
* 9 - [[Small Launcher]]
* 10 - [[Blaster Launcher]]
for modders: the bulletsprite needs to be put into the extraSprites type "Projectiles" the bulletsprite can contain up to 35 3x3 images. The corresponding file id is 35*[bulletSprite]
| -1
|-
| '''fireSound'''
| Sound ID from [[#Extra_Sounds|BATTLE.CAT]] played when this weapon fires.
| -1
|-
| '''hitSound'''
| Sound ID from [[#Extra_Sounds|BATTLE.CAT]] played when this weapon hits a target.
| -1
|-
| '''hitAnimation'''
| Sprite ID from [[SMOKE.PCK]] used to draw the weapon's "hit explosion".
'''NOTE''': Do not define this value for melee/psi weapons, they use [[HIT.PCK]] and therefore meleeAnimation instead.
| 0
|-
| '''power'''
| Average damage of the weapon, in most cases it will be +-50% this value.
| 0
|-
| '''strengthApplied'''
| Add the attacking unit's strength to this weapon's damage.
| false
|-
| '''compatibleAmmo'''
| List of string IDs of the ammo items that can be loaded on this weapon. If none are specified, the weapon doesn't need ammo.
| -
|-
| '''damageType'''
| What type of [[damage]] does this weapon do:
* 0 - None
* 1 - Armor Piercing
* 2 - Incendiary
* 3 - High Explosive
* 4 - Laser
* 5 - Plasma
* 6 - Stun
* 7 - Melee
* 8 - Acid
* 9 - Smoke
'''NOTE:''' A damage type other than 0-9 will do nothing.
| 0
|-
| '''tuAuto'''
'''accuracyAuto'''
| The percentage (0-100%) of [[Time Units]] (from the soldier's total) required to fire an Auto Shot. If 0, the weapon does not have an Auto Shot.
The base accuracy (0-100%) applied to a soldier's [[Firing Accuracy]] when firing an Auto Shot.
| 0
0
|-
| '''tuSnap'''
'''accuracySnap'''
| The percentage (0-100%) of [[Time Units]] (from the soldier's total) required to fire a Snap Shot. If 0, the weapon does not have a Snap Shot.
The base accuracy (0-100%) applied to a soldier's [[Firing Accuracy]] when firing a Snap Shot.
| 0
0
|-
| '''tuAimed'''
'''accuracyAimed'''
| The percentage (0-100%) of [[Time Units]] (from the soldier's total) required to fire an Aimed Shot. If 0, the weapon does not have an Aimed Shot.
The base accuracy (0-100%) applied to a soldier's [[Firing Accuracy]] when firing an Aimed Shot.
| 0
0
|-
|-
| '''tuMelee'''
'''accuracyMelee'''
| The percentage (0-100%) of [[Time Units]] (from the soldier's total) required to do a melee attack (Hit). If 0, the weapon does not have a melee attack.
The base accuracy (0-100%) applied to a soldier's [[Melee Accuracy]] when doing a melee attack.
| 0
0
|-
| '''clipSize'''
| The amount of ammo stored in each weapon clip. If -1 is specified, this weapon has infinite ammo.
| 0
|-
| '''battleType'''
| Defines the weapon's behavior in the Battlescape:
* 0 - None (Geoscape-only item)
* 1 - [[Weapons|Firearm]]
* 2 - Ammo
* 3 - Melee
* 4 - [[Grenade]]
* 5 - [[Proximity Grenade]]
* 6 - [[Medi-Kit (EU)|Medi-Kit]]
* 7 - [[Motion Scanner]]
* 8 - [[Mind Probe]]
* 9 - [[Psi-Amp]]
* 10 - [[Electro-flare]]
* 11 - Corpse
| 0
|-
| '''twoHanded'''
| Is this weapon two-handed? If true, incurs an accuracy penalty if used with both hands occupied. Note that the handsprite of a twoHanded item is also drawn at a slightly different position than a one handed item.
| false
|-
| '''waypoint'''
| Does this weapon use waypoints? (eg. [[Blaster Launcher]]). Can also be used to make ammo items use the waypoint system.
| false
|-
| '''fixedWeapon'''
| Is this weapon fixed? (it's part of a unit, eg. tanks and terrorist units)
| false
|-
| '''invWidth'''
| Item width in a soldier's inventory (in grid units).
| 1
|-
| '''invHeight'''
| Item height in a soldier's inventory (in grid units).
| 1
|-
| '''painKiller'''
| Amount of painkillers contained in a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''heal'''
| Amount of heal's contained in a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''stimulant'''
| Amount of stimulants contained in a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''woundRecovery'''
| Amount of [[Fatal Wounds]] treated by each heal of a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''healthRecovery'''
| Amount of [[Health]] recovered by each heal of a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''stunRecovery'''
| Amount of [[Stun]] removed by each stimulant of a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''energyRecovery'''
| Amount of [[Energy]] recovered by each stimulant of a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''tuUse'''
| Amount of [[Time Units]] required to use this item (for non-offensive items). It's a flat rate if '''flatRate''' is true, otherwise it's a percentage (0-100%).
| 0
|-
| '''recoveryPoints'''
| [[Score]] gained for recovering this alien artifact.
| 0
|-
| '''armor'''
| How much damage is needed to destroy this item on the ground.
| 20
|-
| '''recover'''
| Is this item recoverable? (gets transported to the X-COM base on mission success)
| true
|-
| '''turretType'''
| Sprite ID from [[TANKS.PCK]] of the turret to assign to this tank:
* 0 - [[Tank/Cannon]]
* 1 - [[Tank/Rocket Launcher]]
* 2 - [[Tank/Laser Cannon]]
* 3 - [[Hovertank/Plasma]]
* 4 - [[Hovertank/Launcher]]
| -1
|-
| '''liveAlien'''
| Does this item represent a live alien? (counts towards [[Alien Containment]])
| false
|-
| '''blastRadius'''
| Size of the projectile explosions. 0 for no explosion. -1 to automatically calculate based on weapon power and damage type (actual '''blastRadius''' currently is capped due [[Explosions#Playing_With_Fire|Explosion calculations]]).
| -1
|-
| '''flatRate'''
| If true, then TU costs for this weapon are a flat rate (instead of a percentage of unit TUs).
| false
|-
| '''arcingShot'''
| Does this weapon fire in an arc?
| false
|-
| '''attraction'''
| Represents how likely an alien is to pick up this item. Values below 5 will be ignored (by design).
| 0
|-
| '''maxRange'''
| Maximum range at which this weapon can operate.
| 200
|-
| '''aimRange'''
| Maximum effective range with this weapon before which range-based dropoff occurs.
| 200
|-
| '''snapRange'''
| Maximum effective range with snap shot before which range-based dropoff occurs. (ufoextender accuracy only)
| 15
|-
| '''autoRange'''
| Maximum effective range with auto shot before which range-based dropoff occurs. (ufoextender accuracy only)
| 7
|-
| '''minRange'''
| Range-based dropoff will work in reverse for ranges below this.
| 0
|-
| '''dropoff'''
| The value by which the accuracy lowers for each tile after (or before) the thresholds above.
| 2
|-
| '''bulletSpeed'''
| How much faster (or slower, if you use a negative number) is a projectile fired from this weapon compared to the average.
| 0
|-
| '''autoShots'''
| How many auto shots does this weapon fire.
| 3
|-
| '''shotgunPellets'''
| Number of projectiles fired per unit of ammunition. (note: due to engine limitations it is currently impossible to draw multiple projectiles in flight.)
| 0
|-
| '''zombieUnit'''
| String ID of the unit used for zombification (eg. [[Chrysallid]]s turn units into [[Zombie]]s).
| none
|-
| '''meleeSound'''
| Sound ID from [[#Extra_Sounds|BATTLE.CAT]] played when this weapon attacks a target with melee.
| 39
|-
| '''meleeHitSound'''
| Sound ID from [[#Extra_Sounds|BATTLE.CAT]] played when this weapon HITS a target with melee.
| -1
|-
| '''meleeAnimation'''
| Sprite ID from HIT.PCK played when this weapon attacks a target with melee.
| 0
|-
| '''meleePower'''
| Damage this weapon will do when using melee. This only applies to Firearms, and is only available as stun damage. For normal melee weapons, use regular power and damage types.
| 0
|-
| '''LOSRequired'''
| Does this item require line of sight? (only applies to mind probes and psi-amps)
| false
|-
| '''skillApplied'''
| Is melee skill applied to the accuracy of an attack made with this object?
| true
|-
|}

=== UFOs ===

Defines one of the [[UFOs]] that invade Earth, listed in ''"ufos:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the UFO name.
| ''required''
|-
| '''size'''
| String ID of the UFO size.
| STR_VERY_SMALL
|-
| '''sprite'''
| Sprite ID from [[INTERWIN.DAT]] used to draw this UFO in the dogfight view and UFOpaedia.
don't try to add more images if you don't want to punch yourself in the face - use modsprite
| -1
|-
| '''modSprite'''
| Filename used to draw this UFO in the dogfight view and UFOpaedia.
| -
|-
| '''damageMax'''
| Maximum amount of damage this UFO can take. If the UFO takes 50% damage, it crash lands. If it takes 100% damage, it is destroyed.
| 0
|-
| '''speedMax'''
| Maximum speed in nautical miles.
| 0
|-
| '''accel'''
| Aceeleration value shown in the UFOpaedia.
| 0
|-
| '''power'''
| Damage power of this UFO's weapon in dogfights.
| 0
|-
| '''range'''
| Maximum range of this UFO's weapon in dogfights (in meters).
| 0
|-
| '''score'''
| [[Score]] gained when this UFO is destroyed, or half this score if it crash lands.
| 0
|-
| '''reload'''
| Time the UFO's weapon takes to fire between each shot.
| 0
|-
| '''breakOffTime'''
| Minimum amount of time for the UFO to be able to break off of a dogfight.
| 0
|-
| '''battlescapeTerrainData'''
| [[#Terrains|Terrain]] associated to this UFO in Battlescape missions.
| ''required''
|-
|}

=== Inventory Sections ===

Defines one of the sections of the [[Inventory TU Table|Battlescape inventory]] (eg. Backpack), listed in ''"invs:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the inventory name.
| ''required''
|-
| '''x'''
'''y'''
| Pixel coordinates of this section on the inventory screen.
| 0
0
|-
| '''type'''
| Type of this section:
* 0 = Slot section, can contain as many items as will fit on the slots.
* 1 = Hand section, can only contain one item regardless of size.
* 2 = Ground section, can contain infinite items.
| 0
|-
| '''slots'''
| List of the grid slots (''[x, y]'') that this section is composed of. For example, to make a 2x2 section, you would have ''[0, 0] [0, 1] [1, 0] [1, 1]''.
| -
|-
| '''costs'''
| List of [[Time Units]] costs to move an item from this section to another one (eg. ''STR_BACKPACK: 16'' means it will cost 16 TUs to move an item from this section to the Backpack).
| -
|-
|}

=== Terrains ===

Defines one of the [[TERRAIN|terrains]] used to generate a Battlescape map, listed in "terrains:".

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''name'''
| String ID of the terrain name.
| ''required''
|-
| '''largeBlockLimit'''
| Maximum amount of large blocks that can be used on map generation.
| 0
|-
| '''textures'''
| List of [[TEXTURE.DAT|Geoscape textures]] that correspond to this terrain.
| -
|-
| '''hemisphere'''
| Geoscape hemisphere associated with this terrain:
* -1 - Northern hemisphere.
* 0 - Both hemispheres.
* 1 - Southern hemisphere.
| 0
|-
| '''mapDataSets'''
| List of filenames (each with matching [[MCD]]/[[Image Formats#PCK|PCK/TAB]] files) that contain the tiles of this terrain.
| -
|-
| '''mapBlocks'''
| List of map blocks (see below) that are used for generating a map.
| -
|-
| '''roadTypeOdds'''
| Odds as a % of generating each type of road (E-W Road, N-S Road, Crossing) odds for crossing are: 100 - EW - NS.
| [0 0]
|-|-
| '''civilianTypes'''
| List of units to use as civilians for this mission.
| [MALE_CIVILIAN, FEMALE_CIVILIAN]
|-
|}

==== Map Blocks ====

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''name'''
| Filename of the [[MAPS|map]].
| ''required''
|-
| '''width'''
| Width of this map block in Battlescape grid units.
| 0
|-
| '''length'''
| Length of this map block in Battlescape grid units.
| 0
|-
| '''height'''
| Height of this map block in Battlescape grid units.
| 1
|-
| '''type'''
| Type of this map block:
* -1 - Undefined
* 0 - Default
* 1 - Landing Zone (for placing X-COM / alien craft)
* 2 - E-W Road (for city maps)
* 3 - N-S Road (for city maps)
* 4 - Road Crossing (for city maps)
* 5 - Dirt (for filling empty base blocks)
* 6 - X-COM spawn point (for [[Alien Base]] / [[Cydonia]] missions)
* 7 - [[Alien Base]] Target
* 8 - [[Cydonia]] Target
| -1
|-
| '''subType'''
| Sub-type of this map block (see '''type''').
| -1
|-
| '''frequency'''
| Frequency of this block in a map.
| 1
|-
| '''maxCount'''
| Maximum amount of times this block can be used in a map. If -1 there is no limit.
| -1
|}

*'''frequency''' defines the odds of the map appearing on the map
** The value assigned (default: 1) is used in ''x/n'', which defines the probability of being chosen.
** ''x'' is the integer defined for the map block's frequency and ''n'' is the combined total of probabilities for all the map types combined.
** This property can only be used in type 0 map blocks.
*'''maxCount''' is the maximum number of times it can be used.
** The value assigned is also used in ''x/n'' to determine the probability of being chosen.
** Each use reduces ''x'' by -1, with the caveat that being used as a Landing Zone type will not reduce the x value since it could result in no available Landing Zones.
** This property can only be used in type 0 map blocks.
* '''hemisphere''' only applies to UFO missions, not Terror ones.
*'''width/length''' defines the size of the map
** be aware that the mapview "width"-label is the openxcom ruleset length parameter
** be aware that the mapview "length"-label is the openxcom ruleset width parameter

==== Guidelines/Tips ====
* All maps with an XCOM/Alien craft require at least one type 1 map block. This map block can only contain ground tiles (no walls or objects), otherwise the game will crash or the walls/objects will be removed.
* All Terror terrains (listed under STR_TERROR_MISSION) require at least 1 map block of '''Types''' 2, 3 and 4 (for a total of 3 maps, which are required to place roads) and the corresponding '''roadTypeOdds''' added to the ruleset.
* If there isn't any map blocks designed as roads since you want to keep your terrain 'random', this can be circumvented by designating all 10x10 map blocks, excluding the one(s) used for the XCOM craft, as either '''Type''' 2, 3 and 4 and by defining their '''subType''' to 0. The game will then randomly choose between the map blocks for each type used in the roads, making them map more random.

=== Armor ===

Defines a Battlescape unit's [[armor]] as well as visual representation (so every unit has an armor), listed in ''"armors:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the armor name.
| ''required''
|-
| '''spriteSheet'''
| Sprite sheet from [[UNITS]] used to draw a unit wearing this armor.
| -
|-
| '''spriteInv'''
| Sprite used for the [[Inventory Backgrounds]] of a unit wearing this armor.
| -
|-
| '''corpseBattle'''
| List of string IDs of the corpse [[#Items|items]] generated when a unit wearing this armor is killed (one per unit tile) on the Battlescape.
| -
|-
| '''corpseGeo'''
| String ID of the corpse [[#Items|item]] associated with this unit on the Geoscape.
| -
|-
| '''storeItem'''
| String ID of the [[#Items|item]] that represents this armor in [[Base Stores]] for equipping.
| -
|-
| '''weight'''
| Physical weight of the armor when worn
| 6
|-
| '''stats'''
| like soldier stats (see below) but these are treated as stat bonuses for wearing the specific armor.
| -
|-
| '''frontArmor'''
| Protection provided on the front of the unit.
| 0
|-
| '''sideArmor'''
| Protection provided on the sides of the unit.
| 0
|-
| '''rearArmor'''
| Protection provided on the rear of the unit.
| 0
|-
| '''underArmor'''
| Protection provided under the unit (eg. from explosions).
| 0
|-
| '''drawingRoutine'''
| Drawing routine used to put together the body parts in the unit's '''spriteSheet''':
* 0 = [[Soldier]], [[Sectoid]]
* 1 = [[Floater]]
* 2 = [[HWP]]
* 3 = [[Cyberdisk]]
* 4 = [[Civilian]], [[Ethereal]]
* 5 = [[Sectopod]], [[Reaper]]
* 6 = [[Snakeman]]
* 7 = [[Chryssalid]]
* 8 = [[Silacoid]]
* 9 = [[Celatid]]
* 10 = [[Muton]]
| 0
|-
| '''movementType'''
| Type of movement provided by this armor:
* 0 = Walking
* 1 = Flying
* 2 = Sliding (no walking animation)
it also defines the body of an tank (32-images) in your spriteSheet or the change in sprites while flying using a flying armour see: [[TANKS.PCK]], [[XCOM_2.PCK]]
| 0
|-
| '''damageModifier'''
| List of decimal damage modifiers (1.0 = 100%) this armor applies to each damage type (see [[#Items|Items section]]) received. Modifiers must be specified for all damage types, in this order:
* None
* Armor Piercing
* Incendiary
* High Explosive
* Laser
* Plasma
* Stun
* Melee
* Acid
* Smoke
|
- 1.0 
- 1.0 
- 1.0 
- 1.0 
- 1.0 
- 1.0 
- 1.0 
- 1.0 
- 1.0 
- 1.0
|-
| '''size'''
| Size of the unit wearing this armor, in Battlescape grid units. Every unit is square, so a size of 2 means 2x2.
| 1
|-
| '''loftempsSet'''
| List of [[LOFTEMPS]] IDs (one per unit tile, so a 1x1 unit has 1, a 2x2 unit has 4, etc.) used to represent a unit wearing this armor in 3D space.
| -
|-
| '''loftemps'''
| loftemps is a deprecated option that only works for 1x1 sized units.
| -
|}

=== Player Units (Soldiers) ===

Defines a [[soldier]] recruited by X-COM, listed in ''"soldiers:"''. Currently only one soldier unit type (''XCOM'') is supported.

Unit stats are represented as follows:
* [[Time Units|tu]]
* [[Energy|stamina]]
* [[Health|health]]
* [[Bravery|bravery]] (always a multiple of 10)
* [[Reactions|reactions]]
* [[Firing Accuracy|firing]]
* [[Throwing Accuracy|throwing]]
* [[Strength|strength]]
* [[Psi Strength|psiStrength]]
* [[Psi Skill|psiSkill]]
* [[Melee Accuracy|melee]] (not visible)

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the soldier name.
| ''required''
|-
| '''minStats'''
| Minimum values used to generate the soldier's [[Starting Stats]]. In this case, ''psiSkill'' is treated as the initial stat (not generated).
| -
|-
| '''maxStats'''
| Maximum values used to generate the soldier's [[Starting Stats]]. In this case, ''psiSkill'' is treated as the minimum value for the first month of psi training (actual value is 100%-150%).
| -
|-
| '''statCaps'''
| Maximum stats this soldier can gain through [[Experience]]. '''NOTE:''' A stat will still go over the limit once, and then will no longer increase (see [[Experience#Regarding Caps|Regarding Caps]]).
| -
|-
| '''armor'''
| String ID of the [[#Armor|armor]] this soldier uses by default.
| -
|-
| '''standHeight'''
| Height of this soldier when standing.
| 0
|-
| '''kneelHeight'''
| Height of this soldier when kneeling.
| 0
|-
| '''floatHeight'''
| Distance between the bottom of this unit and the ground.
| 0
|-
| '''femaleFrequency'''
| The probability that a female soldier is hired.
| 50
|}

=== AI Units (Aliens/Civilians) ===

Defines an [[Alien Life Forms|alien]] (enemy) or [[civilian]] (neutral) unit, listed in ''"units:"''. Every different alien rank is a different unit, since they have completely different stats. Unit stats are represented as follows:
* [[Time Units|tu]]
* [[Energy|stamina]]
* [[Health|health]]
* [[Bravery|bravery]] (always a multiple of 10)
* [[Reactions|reactions]]
* [[Firing Accuracy|firing]]
* [[Throwing Accuracy|throwing]]
* [[Strength|strength]]
* [[Psi Strength|psiStrength]]
* [[Psi Skill|psiSkill]]
* [[Melee Accuracy|melee]] (not visible)

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the unit name.
| ''required''
|-
| '''race'''
| String ID of the unit race (for alien units).
| -
|-
| '''rank'''
| String ID of the unit rank (for alien units).
| -
|-
| '''stats'''
| Battlescape stats of this unit.
| -
|-
| '''armor'''
| String ID of the [[#Armor|armor]] this unit uses by default.
| -
|-
| '''standHeight'''
| Height of this unit when standing.
| 0
|-
| '''floatHeight'''
| Distance between the bottom of this unit and the ground.
| 0
|-
| '''value'''
| [[Score]] this unit is worth.
| 0
|-
| '''deathSound'''
| Sound ID from [[#Extra_Sounds|BATTLE.CAT]] played when this unit dies.
| -1
|-
| '''aggroSound'''
| Sound ID from [[#Extra_Sounds|BATTLE.CAT]] played when this unit aggros.
| -1
|-
| '''moveSound'''
| Sound ID from [[#Extra_Sounds|BATTLE.CAT]] played when this unit moves.
| -1
|-
| '''intelligence'''
| Intelligence of this unit's AI. The higher the value, the longer this unit remembers player troops between turns.
| 0
|-
| '''aggression'''
| Aggression of this unit's AI. The higher the value, the more ruthless the unit, the more likely to make a frontal assault. Less aggressive units tend to set up ambushes.
Vanilla values are:
* 0 = mostly passive
* 1 = balanced
* 2 = mostly aggresive
| 0
|-
| '''energyRecovery'''
| Energy recovered by the unit each turn (needs verification)
| 40 (?)
|-
| '''specab'''
| Special ability of this unit:
* 0 = None
* 1 = [[Cyberdisc|Explodes on Death]]
* 2 = [[Bio-Drone|Burns Floor]]
* 3 = [[Zombie|Respawns on Death]]
| 0
|-
| '''spawnUnit'''
| String ID of the unit used to respawn on death (eg. [[Zombie]]s respawn as [[Chrysallid]]s).
| -
|-
| '''livingWeapon'''
| Is this unit a living weapon? (only attacks with a '''fixedWeapon''')
| false
|-
|}

=== Alien Races ===

Defines a [[Alien Life Forms|race]] used in [[Alien Missions]], listed in ''"alienRaces:"''. Heavily tied with deployment data.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''id'''
| String ID of the alien race name.
| ''required''
|-
| '''members'''
| Alien crew associated with this alien race (eg. race units + terrorist units), defined by a list of unit string IDs. Order here will define rank in terms of deployment. generally speaking the order is:
* 0 - Commander
* 1 - Leader
* 2 - Engineer
* 3 - Medic
* 4 - Navigator
* 5 - Soldier
* 6 - Terrorist 1
* 7 - Terrorist 2
but of course, not all races have all ranks, so the "fill in" rank would be listed multiple times (see ethereals).
| -
|-
| '''retaliation'''
| retaliation enables/disables the race for retaliation missions.
| ''True''
|-
|}

=== Alien Deployments ===

Defines a Battlescape deployment data used in [[Alien Missions]] (such as alien and map configurations), listed in ''"alienDeployments:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the deployment name.
| ''required''
|-
| '''width'''
| Width of the Battlescape map in grid units.
| 0
|-
| '''length'''
| Length of the Battlescape map in grid units.
| 0
|-
| '''height'''
| Vertical height of the Battlescape map in grid units.
| 0
|-
| '''terrains'''
| list of string IDs of the [[#Terrains|terrain]] to choose from to generate this map. This is not used for UFO sites where the terrain comes from the Geoscape.
| -
|-
| '''shade'''
| Shade of the map (0-15, where 0 is full daytime and 15 is full nighttime). This is not used for UFO sites where the shade comes from the Geoscape.
| 0
|-
| '''nextStage'''
| String ID of the next deployment stage to use after this one, for multi-stage missions.
| -
|-
| '''data'''
| List of deployment data for each alien rank on this mission (see below).
| -
|}

Notes:
* '''terrains''' can also be used with UFOs, with the game using instead the listed terrain rather than the location of the UFO on Geoscape.
==== Deployment Data ====

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''alienRank'''
| [[Alien Rank|Rank]] associated with this deployment data, as defined by the order of the race in question (see above)
| ''required''
|-
| '''lowQty'''
| Maximum quantity of aliens to spawn (beginner).
| 0
|-
| '''highQty'''
| Maximum quantity of aliens to spawn (superhuman).
| 0
|-
| '''dQty'''
| Minimum Desired Quantity of aliens to spawn.
| 0
|-
| '''percentageOutsideUfo'''
| Percentage (0-100%) of aliens to spawn outside in UFO sites.
| 0
|-
| '''itemSets'''
| Three lists (one for each alien technology level) of [[#Items|items]] (string IDs) for the aliens to equip.
| ''required''
|-
|}

=== Research ===

Defines a [[Research|research topic]] that X-COM scientists can investigate, listed in ''"research:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''name'''
| String ID of the research project's name (or item, if a '''lookup''' is defined).
| ''required''
|-
| '''lookup'''
| String ID of the research project's display name and UFOPaedia article reference.
| -
|-
| '''cost'''
| Number of man hours (on average) required to complete this project.
| 0
|-
| '''points'''
| [[Score]] earned for completing this project.
| 0
|-
| '''needItem'''
| Does this project require an [[#Items|item]] of the same name?
| false
|-
| '''dependencies'''
| List of research projects that can unlock access to this one. If the full list is researched, or if one of the projects on the list "unlocks" this one, it becomes available.
| -
|-
| '''unlocks'''
| List of research projects unlocked, regardless of other dependencies, but not requirements, by completing this project (for example, any live alien unlocks "alien origins").
| -
|-
| '''requires'''
| List of research projects unilaterally required before this project can be unlocked (for example, "the martian solution" will not even be considered for unlocking until AFTER "alien origins" is completed).
| -
|-
| '''getOneFree'''
| List of "bonus" research projects that may be granted when completing this project (for example, alien medics will give you information on other alien races). Only applies to living aliens.
| -
|-
|}

=== Manufacture ===

Defines a [[Manufacture|manufacture project]] that X-COM engineers can produce, listed in ''"manufacture:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''name'''
| String ID of the manufacturing project's name (and the item it produces).
| ''required''
|-
| '''category'''
| String ID of the manufacturing project's category.
| -
|-
| '''requires'''
| List of [[#Research|topics]] (string IDs) that must be researched to unlock this project. If none are specified, this project is unlocked from the start.
| -
|-
| '''space'''
| Amount of [[Workshop]] space required to begin this project.
| 0
|-
| '''time'''
| Number of man hours (on average) required per item.
| 0
|-
| '''cost'''
| Monetary deduction per item manufactured.
| 0
|-
| '''requiredItems'''
| List of [[#Items|items]] required and consumed per item manufactured.
| -
|-
| '''producedItems'''
| List of [[#Items|items]] produced per each item consumed. If not specified, defaults to 1 item with the same string ID as the manufacture.
| 1
|-
|}

=== UFOpaedia Article ===

Defines an article in the in-game [[UFOpaedia]], listed in ''"ufopaedia:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''id'''
| String ID of the article name. This must match the ID of the object associated with this article, if applicable.
| ''required''
|-
| '''title'''
| String ID of the article title. If omitted, the '''id''' is used.
| -
|-
| '''type_id'''
| Type of this article:
* 0 = Unknown
* 1 = [[Craft]]
* 2 = [[Craft Armaments]]
* 3 = [[HWP]]
* 4 = [[Equipment (EU)|Equipment]]
* 5 = [[Armour]]
* 6 = [[Base Facilities]]
* 7 = Text & Image (eg. [[Alien Life Forms]], [[UFO Components]])
* 8 = Text (eg. [[Alien Research]])
* 9 = [[UFO]]
| 0
|-
| '''section'''
| String ID of the UFOpaedia section this article belongs in.
| -
|-
| '''requires'''
| List of [[#Research|topics]] (string IDs) that must be researched to unlock this article. If none are specified, this article is unlocked from the start.
| -
|-
| '''image_id'''
| Filename of the [[UP001.SPK-UP042.SPK|background image]] displayed on this article, if applicable.
| -
|-
| '''text'''
| String ID of the description displayed on this article.
| -
|-
| '''text_width'''
| Maximum width of the text displayed, only applicable to ''Text & Image'' articles.
| 0
|-
| '''rect_stats'''
| Rectangle ('''x''', '''y''', '''width''', '''height''') of the stats text on the screen, only applicable to ''Craft'' articles.
| 0
|-
| '''rect_text'''
| Rectangle ('''x''', '''y''', '''width''', '''height''') of the description text on the screen, only applicable to ''Craft'' articles.
| 0
|-
| '''weapon'''
| String ID of the weapon, only applicable to ''HWP'' articles.
| -
|}

=== UFO Trajectories ===

Defines a trajectory carried out by an UFO during an [[#Alien Missions|alien mission]], listed in ''"ufoTrajectories:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''id'''
| String ID of the trajectory name.
| ''required''
|-
| '''groundTimer'''
| Amount of seconds for the UFO to spend on Ground waypoints.
| 0
|-
| '''waypoints'''
| List of waypoints for the UFO to traverse, defined as ''[zone, altitude, speed]''. 
'''zone''': Globe zone where the waypoint is located. 
'''altitude''': UFO altitude after reaching this waypoint:
* 0 - Ground
* 1 - Very Low
* 2 - Low
* 3 - High
* 4 - Very High
'''speed''': UFO speed after reaching this waypoint, as a percentage (0-100%) of its maximum speed.
| -
|}

=== Alien Missions ===

Defines an [[Alien Missions|alien mission]] carried out by UFOs on the Geoscape, listed in ''"alienMissions:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the mission type.
| ''required''
|-
| '''points'''
| [[Score]] allocated to aliens for successfully completing this mission.
| 0
|-
| '''raceWeights'''
| List of alien races likely to carry out this mission, and the % chance of them being allocated to this mission, listed by "number of months after game beginning".
| ''required''
|-
| '''waves'''
| List of UFO waves to spawn as this mission progresses, as described below.
| ''required''
|}

==== Waves ====

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''ufo'''
| String ID of the [[#UFOs|UFO]] to spawn.
| ''required''
|-
| '''count'''
| Number of UFOs to spawn.
| 0
|-
| '''trajectory'''
| String ID of the [[#UFO Trajectories|trajectory]] for this UFO to use when entering Earth's atmosphere.
| ''required''
|-
| '''timer'''
| How long after the previous wave should this wave arrive? (in seconds)
| 0
|-
|}

=== Alien Item Levels ===

This is a list of item level probabilities, with a number between 0 and 2 representing an item level from plasma pistols to heavy plasmas, as defined in the deployments, expressing a 10% probability for that item level being used.

0 = first set (plasma pistol/clip)
1 = second set (plasma rifle/clip)
2 = third set (heavy plasma/clip)

For example:
[ 2, 0, 0, 0, 0, 0, 0, 1, 1, 1 ]
would represent a 60% chance for pistols, 30% rifles, and 10% heavy weapons. 
Note that the order does not matter, but the length DOES. each line MUST have 10 digits.

The above can be confusing. There are 10 fields; each number represents 10%. 
There are six instances of '0'. 6x10% = 60% chance of plasma pistol 
There are three instances of '1'. 3x10% = 30% chance of plasma rifle 
There is only one instance of '2'. 1x10% = 10% chance of heavy plasma 

Each line represents a month after the beginning of the game, and there is no limit to the number defined. 
OpenXCom will use the most recently available item level in the event the game goes on forever.

=== Extra Sprites ===

Adds or replaces sprites in an existing [[Image Formats|X-COM image file]], listed in ''"extraSprites:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| Filename of the original/new image to modify.
| ''required''
|-
| '''width'''
'''height'''
| Size of the sprite(s) in pixels.
| 0
0
|-
| '''singleImage'''
| Is the image file just a single sprite (true) or a spritesheet (false)?
| false
|-
| '''subX'''
'''subY'''
| Size of the subdivision in pixels. If a subdivision is specified, then the image file is divided into chunks to form the sprites (eg. spritesheets).
| 0
0
|-
| '''files'''
| List of the new sprites to add/replace, listed as ''spriteID: filename''.
| -
|}

Example:
- type: GIANTBUNNY.PCK
width: 32
height: 40
files:
0: Resources/Bunny/Bunny00.png
1: Resources/Bunny/Bunny01.bmp
2: Resources/Bunny/Bunny02.gif

=== Extra Sounds ===

Adds or replaces sounds in an existing [[SOUND|X-COM sound file]], listed in ''"extraSounds:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| ID of the original sound file to modify:
* BATTLE.CAT - Battlescape sounds, corresponds to ''SOUND1.CAT'' or ''SAMPLE2.CAT'' (55 sounds).
* INTRO.CAT - Intro sounds, corresponds to ''INTRO.CAT'' or ''SAMPLE3.CAT'', probably best not to mess with these.
* GEO.CAT - Geoscape sounds, corresponds to ''SOUND2.CAT'' or ''SAMPLE.CAT'' (14 sounds).
| ''required''
|-
| '''files'''
| List of the new sounds to add/replace, listed as ''soundID: filename''.
| -
|}

Example:
- type: BATTLE.CAT
files:
55: Resources/Sounds/sample.wav

=== Extra Strings ===

Adds or replaces text strings in an existing [[Translations (OpenXcom)|OpenXcom language file]], listed in ''"extraStrings:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| Filename of the original language file to modify, sans extension.
| ''required''
|-
| '''strings'''
| List of the new strings to add/replace, listed as ''stringID: text''.
| -
|}

Example:
- type: en-US
strings:
STR_SNIPER_RIFLE: Sniper Rifle
STR_SNIPER_RIFLE_CLIP: Sniper Rifle Clip
- type: en-GB
strings:
STR_SNIPER_RIFLE: Sniper Rifle
STR_SNIPER_RIFLE_CLIP: Sniper Rifle Clip
- type: de
strings:
STR_SNIPER_RIFLE: Scharfschützengewehr
STR_SNIPER_RIFLE_CLIP: Scharfschützengewehrmunition
- type: ru
strings:
STR_SNIPER_RIFLE: Снайперская винтовка
STR_SNIPER_RIFLE_CLIP: Магазин к снайп. винтовке

=== Interfaces ===

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| ''?''
| -
|-
| '''elements'''
| ''?''
| -
|-
| '''id'''
| ''?''
| -
|-
| '''color'''
| ''?''
| -
|}

=== StatStrings ===

[[Statstrings]] are used for automatically renaming soldiers. They are case sensitive and they are processed in the order in which they are specified.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''string'''
| String to add to name.
| ''required''
|-
| '''psiStrength''' 
'''psiSkill''' 
'''bravery''' 
'''strength''' 
'''firing''' 
'''reactions''' 
'''stamina''' 
'''tu''' 
'''health''' 
'''throwing'''
| One or more stat ranges are ANDed together for success. Each range has a minVal and maxVal. Use YAML standard tilde (~) to indicate null. ((~) = 0 as minvalue; (~) =255 as maxvalue)
| -
|}

Example:
statStrings:
- string: "x"
psiStrength: [~, 30]
- string: "P"
psiStrength: [80, ~]
- string: "p"
psiStrength: [60, 79]
- string: "K"
psiSkill: [60, ~]
- string: "k"
psiSkill: [30, 59]
- string: "b"
bravery: [60, ~]
- string: "c"
bravery: [~, 10]
- string: "w"
strength: [~, 25]
- string: "Snpr"
firing: [60, ~]
reactions: [60, ~]
- string: "M"
firing: [70, ~]
- string: "m"
firing: [60, 69]
- string: "Sct"
reactions: [50, ~]
tu: [60, ~]
- string: "R"
reactions: [60, ~]
- string: "r"
reactions: [50, 59]

==References==
<references />

[[Category:OpenXcom]]

Ruleset Reference Nightly (OpenXcom)

2014-12-06T16:00:52Z

Falko: /* Terrains */

A reference of all the customizable values of everything in a [[Rulesets (OpenXcom)|ruleset]], according to the latest nightly. This page should be updated as new versions become available in order to explain the changes from version 1.0.

Some guidelines:
* If a value is omitted from the ruleset, the default is used. You cannot omit ''required'' values.
* Text strings (eg. names) are represented by string IDs from the [[Translations (OpenXcom)|language files]]
* Numerical IDs (used for sprites, sounds, etc.) start at 0, not 1.
* Boolean (yes/no) values are represented by true/false.
* World coordinates are represented in degrees (see [[WORLD.DAT]]).
* Money amounts (prices, costs, etc.) are represented in dollars.
* All paths are '''case sensitive'''! If your ruleset uses external files, make sure that they named properly as described in ruleset.

Items are ordered as they come in the ruleset. To override this, you can specify a ''listOrder''. You can find the default listOrders in [[Ruleset List Order (OpenXcom)|Ruleset List Order]].

=== Globe ===

Defines the drawing of landmasses and borders on the globe.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''data'''
| Path name of file which contains polygon and texture information. (For example WORLD.DAT).
| -
|-
| '''polygons'''
| List of polygons drawn on the globe surface. A triangle consist of seven values: the first number defines the texture, followed by three pairs of (x,y) globe coordinates. Only polygons with 3 or 4 vertices are reliable shown on the globe = 7 or 9 values per entry.
| -
|-
| '''polylines'''
| List of border lines. Each list entry consist of a list of (x,y) globe coordinates.
| -
|}

=== Countries ===

Defines one of the [[Country Funding (EU)|funding nations]], listed in ''"countries:"''. They're used for activity graphs and player scoring.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the country name.
| ''required''
|-
| '''fundingBase'''
| Country's base funding, in thousands. The starting funding can be anywhere between 1x and 2x the base funding.
| 0
|-
| '''fundingCap'''
| Country's funding cap, in thousands. Once a country reaches this maximum, it will no longer increase its funding.
| 0
|-
| '''labelLon'''
'''labelLat'''
| Longitude and latitude coordinates of the country's label on the globe. This label is only shown when the globe is zoomed in and "detail" is turned on.
| 0.0
0.0
|-
| '''areas'''
| List of "rectangles" on the globe defined as [''lon1'' ''lat1'' ''lon2'' ''lat2'']. Any activity within these areas counts towards the country's graph activity and affects their opinion of the player.
| -
|}

=== Regions ===

Defines one of the [[Geoscape (EU)#World Regions/Countries|world regions]], listed in ''"regions:"''. They're used for base placement, activity graphs and mission spawning.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the region name.
| ''required''
|-
| '''cost'''
| Amount of money spent building an X-COM base in this region (first base is free).
| 0
|-
| '''areas'''
| List of "rectangles" on the globe defined as ''[lon1, lat1, lon2, lat2]''. Any activity within these areas counts towards the region's graph activity.
| -
|-
| '''cities'''
| List of cities belonging to this region. They will be displayed on the globe and used for terror site missions. Each city is defined by their '''lon''' and '''lat''' coordinates and a '''name''' string ID.
| -
|-
| '''regionWeight'''
| Weight of this region when selecting regions for alien missions.
| 0
|-
| '''missionWeights'''
| Weighted list of the different mission types for this region (eg. ''STR_ALIEN_RESEARCH: 14'').
| -
|-
| '''missionZones'''
| List of "rectangles" (''[lon1, lat1, lon2, lat2]'') defining the mission zones for this region. Mission zones are waypoints for UFO trajectories.
| -
|-
| '''missionRegion'''
| Spawn mission in this region instead (used for regions without land).
| -
|}

=== Base Facilities ===

Defines one of the [[Base Facilities (EU)|facilities]] that can be built in an X-COM base, listed in ''"facilities:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the facility name.
| ''required''
|-
| '''requires'''
| List of [[#Research|topics]] (string IDs) that must be researched to unlock this facility. If none are specified, this facility is unlocked from the start.
| -
|-
| '''spriteShape'''
| Sprite ID from [[BASEBITS.PCK]] used to draw the facility's outer shape in the Basescape and UFOpaedia.
| -1
|-
| '''spriteFacility'''
| Sprite ID from [[BASEBITS.PCK]] used to draw the facility's contents in the Basescape and UFOpaedia. Drawn on top of '''spriteShape'''.
| -1
|-
| '''lift'''
| Is this facility an [[Access Lift]]? All base facilities must be connected to the lift.
| false
|-
| '''hyper'''
| Is this facility a [[Hyperwave Decoder]]? Displays extra information for detected UFOs. Only valid for radar facilities.
| false
|-
| '''mind'''
| Is this facility a [[Mind Shield]]? Reduces the chance of UFOs finding your base. Does not stack.
| false
|-
| '''grav'''
| Is this facility a [[Grav Shield]]? Doubles the power of your base defenses. Does not stack.
| false
|-
| '''size'''
| Size of the facility, in grid units. Every facility is square, so a size of 1 means 1x1, 2 means 2x2, etc. Bigger facilities are made up of multiple sprites, for example a 2x2 facility will use 4 sprites for '''spriteShape''' and 4 sprites for '''spriteFacility''' (top-left, top-right, bottom-left, bottom-right).
| 1
|-
| '''buildCost'''
| Amount of money spent to build this facility in the base.
| 0
|-
| '''buildTime'''
| Amount of days it takes for this facility to be built.
| 0
|-
| '''monthlyCost'''
| Amount of money spent monthly for the maintenance of this facility.
| 0
|-
| '''storage'''
| Amount of storage space (for items) this facility provides. See [[Base Stores]].
| 0
|-
| '''personnel'''
| Amount of personnel (soldiers, scientsts, engineers) these quarters can contain.
| 0
|-
| '''aliens'''
| Amount of live aliens this facility can contain. Only checked if the ''alienContainmentLimitEnforced'' option is enabled.
| 0
|-
| '''crafts'''
| Amount of X-COM craft this facility can contain.
| 0
|-
| '''labs'''
| Amount of lab space this facility provides for research projects.
| 0
|-
| '''workshops'''
| Amount of workshop space this facility provides for manufacture projects.
| 0
|-
| '''psiLabs'''
| Amount of soldier space this facility provides for psionic training.
| 0
|-
| '''radarRange'''
| Maximum radar detection range of this facility, in nautical miles.
| 0
|-
| '''radarChance'''
| Chance (0-100%) of this radar detecting a UFO that enters its range.
| 0
|-
| '''defense'''
| Offensive power provided by this base defense against attacking UFOs.
| 0
|-
| '''hitRatio'''
| Chance (0-100) of the base defense hitting an attacking UFO.
| 0
|-
| '''fireSound'''
| Sound ID from [[#Extra_Sounds|GEO.CAT]] played when the base defense fires.
| -1
|-
| '''hitSound'''
| Sound ID from [[#Extra_Sounds|GEO.CAT]] played when the base defense hits a target.
| -1
|-
| '''mapName'''
| [[MAPS|Map]] associated to this facility in Battlescape base defenses.
| -
|-
|}

=== Crafts ===

Defines one of the [[Craft|X-COM crafts]] that go on interception missions, listed in ''"crafts:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the craft name.
| ''required''
|-
| '''requires'''
| List of [[#Research|topics]] (string IDs) that must be researched to unlock this craft. If none are specified, this craft is unlocked from the start.
| -
|-
| '''sprite'''
| Sprite ID from [[BASEBITS.PCK]] used to draw this craft in the Basescape and from [[INTICON.PCK]] used to draw the damage indicator in dogfights.
modders: the corresponding extrasprite file id for BASEBITS.PCK is sprite+33 INTICON.PCK contains a minimized icon id=sprite the file id for the dogfight image is sprite+11
| -1
|-
| '''fuelMax'''
| Maximum amount of fuel this craft can carry. Crafts use up fuel based on their speed while travelling.
| 0
|-
| '''damageMax'''
| Maximum amount of damage this craft can take. If this amount is exceeded, the craft is destroyed.
| 0
|-
| '''speedMax'''
| Maximum speed in nautical miles. Crafts travel at max speed when flying and half speed when patrolling.
| 0
|-
| '''accel'''
| Aceeleration value shown in the UFOpaedia.
| 0
|-
| '''weapons'''
| Amount of craft weapons this craft can equip. The UI can only display a max of 2 weapons.
| 0
|-
| '''soldiers'''
| Amount of soldiers this craft can carry.
| 0
|-
| '''maxItems'''
| Amount of items this craft can carry.
| 80
|-
| '''vehicles'''
| Amount of vehicles this craft can carry.
| 0
|-
| '''costBuy'''
| Amount of money spent for purchasing this craft. If set to 0, the craft will not be available in the Purchase/Recruit screen.
| 0
|-
| '''costRent'''
| Amount of money spent monthly for renting this craft. If set to 0, the craft is not on rental and won't count towards base maintenance.
| 0
|-
| '''costSell'''
| Amount of money gained for selling this craft.
| 0
|-
| '''refuelItem'''
| Item required for refuelling this craft. If no item is specified, the craft uses human fuel.
| 0
|-
| '''repairRate'''
| Amount of damage restored every hour while [[Repairs|Repairing]] in base.
| 1
|-
| '''refuelRate'''
| Amount of fuel restored every 30 mins while [[Refueling]] in base. If specified, a '''refuelItem''' is spent each time.
| 1
|-
| '''radarRange'''
| Detection range of the craft's radar in nautical miles. Every craft radar has a 100% detection chance.
| 600
|-
| '''transferTime'''
| Number of hours it takes to purchase/transfer this craft to a base.
| 0
|-
| '''score'''
| [[Score]] lost when this craft is destroyed.
| 0
|-
| '''spacecraft'''
| Can this craft go to [[Cydonia]]?
| false
|-
| '''battlescapeTerrainData'''
| [[#Terrains|Terrain]] associated to this craft in Battlescape missions.
| -
|}

=== Craft Weapons ===

Defines one of the [[Craft Armaments|weapons]] equipped by X-COM craft for shooting down UFOs, listed in ''"craftWeapons:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the weapon name.
| ''required''
|-
| '''sprite'''
| Sprite ID from [[BASEBITS.PCK]] used to draw the weapon in the Basescape and from [[INTICON.PCK]] used to draw the weapon in dogfights.
modders: the corresponding extrasprites file id for INTICON.PCK is sprite+5 and sprite+48 for BASEBITS.PCK
| -1
|-
| '''sound'''
| Sound ID from [[#Extra_Sounds|GEO.CAT]] played when this weapon fires.
| -1
|-
| '''damage'''
| Amount of damage this weapon does to enemy UFOs.
| 0
|-
| '''range'''
| Maximum range of this weapon in dogfights (in meters).
| 0
|-
| '''accuracy'''
| Chance (0-100%) of each shot hitting the enemy UFO.
| 0
|-
| '''reloadCautious'''
| Time this weapon takes to fire between each shot in ''Cautious Mode''.
| 0
|-
| '''reloadStandard'''
| Time this weapon takes to fire between each shot in ''Standard Mode''.
| 0
|-
| '''reloadAggressive'''
| Time this weapon takes to fire between each shot in ''Aggressive Mode''.
| 0
|-
| '''ammoMax'''
| Maximum amount of ammo this weapon can carry.
| 0
|-
| '''rearmRate'''
| Amount of ammo restored every 30 mins while the craft is [[Rearming]] in base. If specified, '''clip'''s are spent depending on their '''clipSize'''. If the '''clipSize''' of the specified ammo is 0, no '''clip'''s are spent.
| 1
|-
| '''projectileType'''
| Type of the weapon projectile, used for the projectile sprite in dogfights:
* 0 - [[Stingray]]
* 1 - [[Avalanche]]
* 2 - [[Cannon]]
* 3 - [[Fusion Ball]]
* 4 - [[Laser Cannon]]
* 5 - [[Plasma Beam]]
| 2
|-
| '''projectileSpeed'''
| Speed of the weapon projectile in dogfights.
| 0
|-
| '''launcher'''
| String ID of the [[#Items|item]] required to equip this weapon.
| -
|-
| '''clip'''
| String ID of the [[#Items|item]] required to rearm this weapon.
| -
|}

=== Items ===

Defines the Geoscape and Battlescape properties of an [[Equipment (EU)|item]] that can be stored in X-COM bases, listed in ''"items:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the internal item name.
| ''required''
|-
| '''name'''
| String ID of the displayed item name, for cases where it's different from the internal name. If omitted, '''type''' is used.
| -
|-
| '''requires'''
| List of [[#Research|topics]] (string IDs) that must be researched to unlock this item. If none are specified, this item is unlocked from the start. Soldiers can only use unlocked items in the Battlescape.
| -
|-
| '''size'''
| Space occupied by this item in [[Base Stores]]. Can be a decimal value.
| 0.0
|-
| '''costBuy'''
| Amount of money spent for purchasing this item. If set to 0, this item will not be available in the Purchase/Recruit screen.
| 0
|-
| '''costSell'''
| Amount of money gained for selling this item.
| 0
|-
| '''transferTime'''
| Number of hours it takes to purchase/transfer this item to a base.
| 24
|-
| '''weight'''
| [[Item_Weight|Weight]] occupied by this item in a soldier's inventory.
| 999
|-
| '''bigSprite'''
| Sprite ID from [[BIGOBS.PCK]] used to draw this item in a soldier's inventory and UFOpaedia.
| -1
|-
| '''floorSprite'''
| Sprite ID from [[FLOOROB.PCK]] used to draw this item on the floor of a Battlescape tile.
| -1
|-
| '''handSprite'''
| Sprite ID from [[HANDOB.PCK]] used to draw this item on a soldier's hand in the Battlescape.
modders: each handobject needs 8 images (8 directions) define the extrasprites accordingly
| 120
|-
| '''bulletSprite'''
| Sprite ID from ''BulletSprites.png'' used to draw this weapon's projectile on the Battlescape:
* 0 - [[Rocket Launcher]]
* 1 - [[Pistol]]
* 2 - [[Rifle]]
* 3 - [[Auto Cannon]]
* 4 - [[Heavy Cannon]]
* 5 - [[Laser Pistol]]
* 6 - [[Laser Rifle]]
* 7 - [[Heavy Laser]]
* 8 - [[Plasma Rifle|Plasma]]
* 9 - [[Small Launcher]]
* 10 - [[Blaster Launcher]]
for modders: the bulletsprite needs to be put into the extraSprites type "Projectiles" the bulletsprite can contain up to 35 3x3 images. The corresponding file id is 35*[bulletSprite]
| -1
|-
| '''fireSound'''
| Sound ID from [[#Extra_Sounds|BATTLE.CAT]] played when this weapon fires.
| -1
|-
| '''hitSound'''
| Sound ID from [[#Extra_Sounds|BATTLE.CAT]] played when this weapon hits a target.
| -1
|-
| '''hitAnimation'''
| Sprite ID from [[SMOKE.PCK]] used to draw the weapon's "hit explosion".
'''NOTE''': Do not define this value for melee/psi weapons, they use [[HIT.PCK]] and therefore meleeAnimation instead.
| 0
|-
| '''power'''
| Average damage of the weapon, in most cases it will be +-50% this value.
| 0
|-
| '''strengthApplied'''
| Add the attacking unit's strength to this weapon's damage.
| false
|-
| '''compatibleAmmo'''
| List of string IDs of the ammo items that can be loaded on this weapon. If none are specified, the weapon doesn't need ammo.
| -
|-
| '''damageType'''
| What type of [[damage]] does this weapon do:
* 0 - None
* 1 - Armor Piercing
* 2 - Incendiary
* 3 - High Explosive
* 4 - Laser
* 5 - Plasma
* 6 - Stun
* 7 - Melee
* 8 - Acid
* 9 - Smoke
'''NOTE:''' A damage type other than 0-9 will do nothing.
| 0
|-
| '''tuAuto'''
'''accuracyAuto'''
| The percentage (0-100%) of [[Time Units]] (from the soldier's total) required to fire an Auto Shot. If 0, the weapon does not have an Auto Shot.
The base accuracy (0-100%) applied to a soldier's [[Firing Accuracy]] when firing an Auto Shot.
| 0
0
|-
| '''tuSnap'''
'''accuracySnap'''
| The percentage (0-100%) of [[Time Units]] (from the soldier's total) required to fire a Snap Shot. If 0, the weapon does not have a Snap Shot.
The base accuracy (0-100%) applied to a soldier's [[Firing Accuracy]] when firing a Snap Shot.
| 0
0
|-
| '''tuAimed'''
'''accuracyAimed'''
| The percentage (0-100%) of [[Time Units]] (from the soldier's total) required to fire an Aimed Shot. If 0, the weapon does not have an Aimed Shot.
The base accuracy (0-100%) applied to a soldier's [[Firing Accuracy]] when firing an Aimed Shot.
| 0
0
|-
|-
| '''tuMelee'''
'''accuracyMelee'''
| The percentage (0-100%) of [[Time Units]] (from the soldier's total) required to do a melee attack (Hit). If 0, the weapon does not have a melee attack.
The base accuracy (0-100%) applied to a soldier's [[Melee Accuracy]] when doing a melee attack.
| 0
0
|-
| '''clipSize'''
| The amount of ammo stored in each weapon clip. If -1 is specified, this weapon has infinite ammo.
| 0
|-
| '''battleType'''
| Defines the weapon's behavior in the Battlescape:
* 0 - None (Geoscape-only item)
* 1 - [[Weapons|Firearm]]
* 2 - Ammo
* 3 - Melee
* 4 - [[Grenade]]
* 5 - [[Proximity Grenade]]
* 6 - [[Medi-Kit (EU)|Medi-Kit]]
* 7 - [[Motion Scanner]]
* 8 - [[Mind Probe]]
* 9 - [[Psi-Amp]]
* 10 - [[Electro-flare]]
* 11 - Corpse
| 0
|-
| '''twoHanded'''
| Is this weapon two-handed? If true, incurs an accuracy penalty if used with both hands occupied. Note that the handsprite of a twoHanded item is also drawn at a slightly different position than a one handed item.
| false
|-
| '''waypoint'''
| Does this weapon use waypoints? (eg. [[Blaster Launcher]]). Can also be used to make ammo items use the waypoint system.
| false
|-
| '''fixedWeapon'''
| Is this weapon fixed? (it's part of a unit, eg. tanks and terrorist units)
| false
|-
| '''invWidth'''
| Item width in a soldier's inventory (in grid units).
| 1
|-
| '''invHeight'''
| Item height in a soldier's inventory (in grid units).
| 1
|-
| '''painKiller'''
| Amount of painkillers contained in a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''heal'''
| Amount of heal's contained in a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''stimulant'''
| Amount of stimulants contained in a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''woundRecovery'''
| Amount of [[Fatal Wounds]] treated by each heal of a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''healthRecovery'''
| Amount of [[Health]] recovered by each heal of a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''stunRecovery'''
| Amount of [[Stun]] removed by each stimulant of a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''energyRecovery'''
| Amount of [[Energy]] recovered by each stimulant of a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''tuUse'''
| Amount of [[Time Units]] required to use this item (for non-offensive items). It's a flat rate if '''flatRate''' is true, otherwise it's a percentage (0-100%).
| 0
|-
| '''recoveryPoints'''
| [[Score]] gained for recovering this alien artifact.
| 0
|-
| '''armor'''
| How much damage is needed to destroy this item on the ground.
| 20
|-
| '''recover'''
| Is this item recoverable? (gets transported to the X-COM base on mission success)
| true
|-
| '''turretType'''
| Sprite ID from [[TANKS.PCK]] of the turret to assign to this tank:
* 0 - [[Tank/Cannon]]
* 1 - [[Tank/Rocket Launcher]]
* 2 - [[Tank/Laser Cannon]]
* 3 - [[Hovertank/Plasma]]
* 4 - [[Hovertank/Launcher]]
| -1
|-
| '''liveAlien'''
| Does this item represent a live alien? (counts towards [[Alien Containment]])
| false
|-
| '''blastRadius'''
| Size of the projectile explosions. 0 for no explosion. -1 to automatically calculate based on weapon power and damage type (actual '''blastRadius''' currently is capped due [[Explosions#Playing_With_Fire|Explosion calculations]]).
| -1
|-
| '''flatRate'''
| If true, then TU costs for this weapon are a flat rate (instead of a percentage of unit TUs).
| false
|-
| '''arcingShot'''
| Does this weapon fire in an arc?
| false
|-
| '''attraction'''
| Represents how likely an alien is to pick up this item. Values below 5 will be ignored (by design).
| 0
|-
| '''maxRange'''
| Maximum range at which this weapon can operate.
| 200
|-
| '''aimRange'''
| Maximum effective range with this weapon before which range-based dropoff occurs.
| 200
|-
| '''snapRange'''
| Maximum effective range with snap shot before which range-based dropoff occurs. (ufoextender accuracy only)
| 15
|-
| '''autoRange'''
| Maximum effective range with auto shot before which range-based dropoff occurs. (ufoextender accuracy only)
| 7
|-
| '''minRange'''
| Range-based dropoff will work in reverse for ranges below this.
| 0
|-
| '''dropoff'''
| The value by which the accuracy lowers for each tile after (or before) the thresholds above.
| 2
|-
| '''bulletSpeed'''
| How much faster (or slower, if you use a negative number) is a projectile fired from this weapon compared to the average.
| 0
|-
| '''autoShots'''
| How many auto shots does this weapon fire.
| 3
|-
| '''shotgunPellets'''
| Number of projectiles fired per unit of ammunition. (note: due to engine limitations it is currently impossible to draw multiple projectiles in flight.)
| 0
|-
| '''zombieUnit'''
| String ID of the unit used for zombification (eg. [[Chrysallid]]s turn units into [[Zombie]]s).
| none
|-
| '''meleeSound'''
| Sound ID from [[#Extra_Sounds|BATTLE.CAT]] played when this weapon attacks a target with melee.
| 39
|-
| '''meleeHitSound'''
| Sound ID from [[#Extra_Sounds|BATTLE.CAT]] played when this weapon HITS a target with melee.
| -1
|-
| '''meleeAnimation'''
| Sprite ID from HIT.PCK played when this weapon attacks a target with melee.
| 0
|-
| '''meleePower'''
| Damage this weapon will do when using melee. This only applies to Firearms, and is only available as stun damage. For normal melee weapons, use regular power and damage types.
| 0
|-
| '''LOSRequired'''
| Does this item require line of sight? (only applies to mind probes and psi-amps)
| false
|-
| '''skillApplied'''
| Is melee skill applied to the accuracy of an attack made with this object?
| true
|-
|}

=== UFOs ===

Defines one of the [[UFOs]] that invade Earth, listed in ''"ufos:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the UFO name.
| ''required''
|-
| '''size'''
| String ID of the UFO size.
| STR_VERY_SMALL
|-
| '''sprite'''
| Sprite ID from [[INTERWIN.DAT]] used to draw this UFO in the dogfight view and UFOpaedia.
don't try to add more images if you don't want to punch yourself in the face - use modsprite
| -1
|-
| '''modSprite'''
| Filename used to draw this UFO in the dogfight view and UFOpaedia.
| -
|-
| '''damageMax'''
| Maximum amount of damage this UFO can take. If the UFO takes 50% damage, it crash lands. If it takes 100% damage, it is destroyed.
| 0
|-
| '''speedMax'''
| Maximum speed in nautical miles.
| 0
|-
| '''accel'''
| Aceeleration value shown in the UFOpaedia.
| 0
|-
| '''power'''
| Damage power of this UFO's weapon in dogfights.
| 0
|-
| '''range'''
| Maximum range of this UFO's weapon in dogfights (in meters).
| 0
|-
| '''score'''
| [[Score]] gained when this UFO is destroyed, or half this score if it crash lands.
| 0
|-
| '''reload'''
| Time the UFO's weapon takes to fire between each shot.
| 0
|-
| '''breakOffTime'''
| Minimum amount of time for the UFO to be able to break off of a dogfight.
| 0
|-
| '''battlescapeTerrainData'''
| [[#Terrains|Terrain]] associated to this UFO in Battlescape missions.
| ''required''
|-
|}

=== Inventory Sections ===

Defines one of the sections of the [[Inventory TU Table|Battlescape inventory]] (eg. Backpack), listed in ''"invs:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the inventory name.
| ''required''
|-
| '''x'''
'''y'''
| Pixel coordinates of this section on the inventory screen.
| 0
0
|-
| '''type'''
| Type of this section:
* 0 = Slot section, can contain as many items as will fit on the slots.
* 1 = Hand section, can only contain one item regardless of size.
* 2 = Ground section, can contain infinite items.
| 0
|-
| '''slots'''
| List of the grid slots (''[x, y]'') that this section is composed of. For example, to make a 2x2 section, you would have ''[0, 0] [0, 1] [1, 0] [1, 1]''.
| -
|-
| '''costs'''
| List of [[Time Units]] costs to move an item from this section to another one (eg. ''STR_BACKPACK: 16'' means it will cost 16 TUs to move an item from this section to the Backpack).
| -
|-
|}

=== Terrains ===

Defines one of the [[TERRAIN|terrains]] used to generate a Battlescape map, listed in "terrains:".

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''name'''
| String ID of the terrain name.
| ''required''
|-
| '''textures'''
| List of [[TEXTURE.DAT|Geoscape textures]] that correspond to this terrain.
| -
|-
| '''hemisphere'''
| Geoscape hemisphere associated with this terrain:
* -1 - Northern hemisphere.
* 0 - Both hemispheres.
* 1 - Southern hemisphere.
| 0
|-
| '''mapDataSets'''
| List of filenames (each with matching [[MCD]]/[[Image Formats#PCK|PCK/TAB]] files) that contain the tiles of this terrain.
| -
|-
| '''mapBlocks'''
| List of map blocks (see below) that are used for generating a map.
| -
|-
| '''civilianTypes'''
| List of units to use as civilians for this mission.
| [MALE_CIVILIAN, FEMALE_CIVILIAN]
|-
|}

==== Map Blocks ====

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''name'''
| Filename of the [[MAPS|map]].
| ''required''
|-
| '''width'''
| Width of this map block in Battlescape grid units.
| 0
|-
| '''length'''
| Length of this map block in Battlescape grid units.
| 0
|-
| '''height'''
| Height of this map block in Battlescape grid units.
| 1
|-
| '''groups'''
| List (or single number) of groups this mapblock belongs to (used in mapscripts)
default usage:
* 0 - Default
* 1 - Landing Zone (for placing X-COM / alien craft) (used in addcraft/ufo command)
* 2 - E-W Road (for city maps) (used in addline command)
* 3 - N-S Road (for city maps) (used in addline command)
* 4 - Road Crossing (for city maps) (used in addline command)
| 0
|-
| '''items'''
| An array of items to add to this mapblock, an the positions to place them at.
| -1
|}

* '''hemisphere''' only applies to UFO missions, not Terror ones.
*'''width/length''' defines the size of the map
** be aware that the mapview "width"-label is the openxcom ruleset length parameter
** be aware that the mapview "length"-label is the openxcom ruleset width parameter

==== Guidelines/Tips ====
* All maps with an XCOM/Alien craft require at least one map block assigned to Group 1. This map block can only contain ground tiles (no walls or objects), otherwise the game will crash or the walls/objects will be removed.
* All Terror terrains (listed under STR_TERROR_MISSION) require the Groups of '''Types''' 2, 3 and 4 (for a total of 3 maps, which are required to place roads).

=== Map Scripts ===

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| name of the script
| ''required''
|-
| '''commands'''
| List of MapCommands
| -
|}

==== Map Command ====

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| Currently these commands are implemented:
* addBlock
* addLine
* addCraft
* addUFO
* digTunnel
* fillArea
* checkBlock
* removeBlock
* resize
depending on the command type some of the following parameters are needed
| ''required''
|-
| '''label'''
| A numeric label that can be used for conditional execution of commands.
Each label should be unique within the terrain list (0=default no need for uniqueness).
| 0
|-
| '''conditionals'''
| Defines the conditions that allows the execution of this command.
eg. [1, -4] means it will be executed if command with label 1 was a success and command with label 4 failed.
commands that are not yet executed are always in failed state.
| 0
|-
| '''executionChances'''
| the chance that this command will be executed (or fails)
| 100
|-
| '''executions'''
| this command will be executed multiple times with a value > 1
| 1
|-
| '''groups'''
| Defines the what mapblock are used within this command. Can be list of goups or a single number.
| 0
|-
| '''blocks'''
| Alternative to groups. Here we define a list of mapblocks that are used within this command.
| 0
|-
| '''rects'''
| A list of possible ranges where (random) placement/checks/removal can happen in a map.
Is a list of a list of four integers.
| ?
|-
| '''size'''
| size of mapblocks that can be placed/checked/removed within rects. Also used for resize command type.
| ?
|-
| '''freqs'''
| For a list of mapblocks (defined by blocks?) we can define distribution frequency here.
| 1
|-
| '''maxUses'''
| For a list of mapblocks (defined by blocks?) we can define the maximal amount a mapblock can be used here.
| -1
|-
| '''direction'''
| used for addLine command type. Values are both, horizontal or vertical. Typically defines the road type distribution.
| -1
|-
| '''tunnelData'''
| Parameter for digTunnel command type. Contains level (default: 0) and a list of MCD replacement rules (MCDReplacements)
| 0
|}

==== Guidelines/Tips ====
* The Mapscript is still somewhat in development

=== Armor ===

Defines a Battlescape unit's [[armor]] as well as visual representation (so every unit has an armor), listed in ''"armors:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the armor name.
| ''required''
|-
| '''spriteSheet'''
| Sprite sheet from [[UNITS]] used to draw a unit wearing this armor.
| -
|-
| '''spriteInv'''
| Sprite used for the [[Inventory Backgrounds]] of a unit wearing this armor.
| -
|-
| '''corpseBattle'''
| List of string IDs of the corpse [[#Items|items]] generated when a unit wearing this armor is killed (one per unit tile) on the Battlescape.
| -
|-
| '''corpseGeo'''
| String ID of the corpse [[#Items|item]] associated with this unit on the Geoscape.
| -
|-
| '''storeItem'''
| String ID of the [[#Items|item]] that represents this armor in [[Base Stores]] for equipping.
| -
|-
| '''weight'''
| Physical weight of the armor when worn
| 6
|-
| '''stats'''
| like soldier stats (see below) but these are treated as stat bonuses for wearing the specific armor.
| -
|-
| '''frontArmor'''
| Protection provided on the front of the unit.
| 0
|-
| '''sideArmor'''
| Protection provided on the sides of the unit.
| 0
|-
| '''rearArmor'''
| Protection provided on the rear of the unit.
| 0
|-
| '''underArmor'''
| Protection provided under the unit (eg. from explosions).
| 0
|-
| '''drawingRoutine'''
| Drawing routine used to put together the body parts in the unit's '''spriteSheet''':
* 0 = [[Soldier]], [[Sectoid]]
* 1 = [[Floater]]
* 2 = [[HWP]]
* 3 = [[Cyberdisk]]
* 4 = [[Civilian]], [[Ethereal]]
* 5 = [[Sectopod]], [[Reaper]]
* 6 = [[Snakeman]]
* 7 = [[Chryssalid]]
* 8 = [[Silacoid]]
* 9 = [[Celatid]]
* 10 = [[Muton]]
* 11 = [[Submersible Weapons Systems]]
* 12 = [[Hallucinoid]]
* 13 = [[Aquanauts]]
* 14 = [[Calcinite]], [[Deep One]], [[Gillman]], [[Lobster Man]], [[Tasoth]]
* 15 = [[Aquatoid]]
* 16 = [[Bio-Drone]]
| 0
|-
| '''movementType'''
| Type of movement provided by this armor:
* 0 = Walking
* 1 = Flying
* 2 = Sliding (no walking animation)
it also defines the body of an tank (32-images) in your spriteSheet or the change in sprites while flying using a flying armour see: [[TANKS.PCK]], [[XCOM_2.PCK]]
| 0
|-
| '''damageModifier'''
| List of decimal damage modifiers (1.0 = 100%) this armor applies to each damage type (see [[#Items|Items section]]) received. Modifiers must be specified for all damage types, in this order:
* None
* Armor Piercing
* Incendiary
* High Explosive
* Laser
* Plasma
* Stun
* Melee
* Acid
* Smoke
|
- 1.0 
- 1.0 
- 1.0 
- 1.0 
- 1.0 
- 1.0 
- 1.0 
- 1.0 
- 1.0 
- 1.0
|-
| '''size'''
| Size of the unit wearing this armor, in Battlescape grid units. Every unit is square, so a size of 2 means 2x2.
| 1
|-
| '''loftempsSet'''
| List of [[LOFTEMPS]] IDs (one per unit tile, so a 1x1 unit has 1, a 2x2 unit has 4, etc.) used to represent a unit wearing this armor in 3D space.
| -
|-
| '''loftemps'''
| loftemps is a deprecated option that only works for 1x1 sized units.
| -
|-
| '''forcedTorso'''
| soldier sprites have female and male torsos. some armours reuse these sprites for flying/non flying torso without difference between genders. This can be controlled by the parameter: 0 = use genderrelated torso, 1 = use male torso, 2 = use female torso
| 0

|}

=== Player Units (Soldiers) ===

Defines a [[soldier]] recruited by X-COM, listed in ''"soldiers:"''. Currently only one soldier unit type (''XCOM'') is supported.

Unit stats are represented as follows:
* [[Time Units|tu]]
* [[Energy|stamina]]
* [[Health|health]]
* [[Bravery|bravery]] (always a multiple of 10)
* [[Reactions|reactions]]
* [[Firing Accuracy|firing]]
* [[Throwing Accuracy|throwing]]
* [[Strength|strength]]
* [[Psi Strength|psiStrength]]
* [[Psi Skill|psiSkill]]
* [[Melee Accuracy|melee]] (not visible)

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the soldier name.
| ''required''
|-
| '''minStats'''
| Minimum values used to generate the soldier's [[Starting Stats]]. In this case, ''psiSkill'' is treated as the initial stat (not generated).
| -
|-
| '''maxStats'''
| Maximum values used to generate the soldier's [[Starting Stats]]. In this case, ''psiSkill'' is treated as the minimum value for the first month of psi training (actual value is 100%-150%).
| -
|-
| '''statCaps'''
| Maximum stats this soldier can gain through [[Experience]]. '''NOTE:''' A stat will still go over the limit once, and then will no longer increase (see [[Experience#Regarding Caps|Regarding Caps]]).
| -
|-
| '''armor'''
| String ID of the [[#Armor|armor]] this soldier uses by default.
| -
|-
| '''standHeight'''
| Height of this soldier when standing.
| 0
|-
| '''kneelHeight'''
| Height of this soldier when kneeling.
| 0
|-
| '''floatHeight'''
| Distance between the bottom of this unit and the ground.
| 0
|-
| '''femaleFrequency'''
| The probability that a female soldier is hired.
| 50
|}

=== AI Units (Aliens/Civilians) ===

Defines an [[Alien Life Forms|alien]] (enemy) or [[civilian]] (neutral) unit, listed in ''"units:"''. Every different alien rank is a different unit, since they have completely different stats. Unit stats are represented as follows:
* [[Time Units|tu]]
* [[Energy|stamina]]
* [[Health|health]]
* [[Bravery|bravery]] (always a multiple of 10)
* [[Reactions|reactions]]
* [[Firing Accuracy|firing]]
* [[Throwing Accuracy|throwing]]
* [[Strength|strength]]
* [[Psi Strength|psiStrength]]
* [[Psi Skill|psiSkill]]
* [[Melee Accuracy|melee]] (not visible)

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the unit name.
| ''required''
|-
| '''race'''
| String ID of the unit race (for alien units).
| -
|-
| '''rank'''
| String ID of the unit rank (for alien units).
| -
|-
| '''stats'''
| Battlescape stats of this unit.
| -
|-
| '''armor'''
| String ID of the [[#Armor|armor]] this unit uses by default.
| -
|-
| '''standHeight'''
| Height of this unit when standing.
| 0
|-
| '''floatHeight'''
| Distance between the bottom of this unit and the ground.
| 0
|-
| '''value'''
| [[Score]] this unit is worth.
| 0
|-
| '''deathSound'''
| Sound ID from [[#Extra_Sounds|BATTLE.CAT]] played when this unit dies.
| -1
|-
| '''aggroSound'''
| Sound ID from [[#Extra_Sounds|BATTLE.CAT]] played when this unit aggros.
| -1
|-
| '''moveSound'''
| Sound ID from [[#Extra_Sounds|BATTLE.CAT]] played when this unit moves.
| -1
|-
| '''intelligence'''
| Intelligence of this unit's AI. The higher the value, the longer this unit remembers player troops between turns.
| 0
|-
| '''aggression'''
| Aggression of this unit's AI. The higher the value, the more ruthless the unit, the more likely to make a frontal assault. Less aggressive units tend to set up ambushes.
Vanilla values are:
* 0 = mostly passive
* 1 = balanced
* 2 = mostly aggresive
| 0
|-
| '''energyRecovery'''
| Energy recovered by the unit each turn (needs verification)
| 40 (?)
|-
| '''specab'''
| Special ability of this unit:
* 0 = None
* 1 = [[Cyberdisc|Explodes on Death]]
* 2 = [[Silacoid|Burns Floor]]
* 3 = [[Bio-Drone|Burns Floor and explodes on Death]]
| 0
|-
| '''spawnUnit'''
| String ID of the unit used to respawn on death (eg. [[Zombie]]s respawn as [[Chrysallid]]s).
| -
|-
| '''livingWeapon'''
| Is this unit a living weapon? (only attacks with a '''fixedWeapon''')
| false
|-
| '''female'''
| Is this unit a female? (used for TFTD civilian types)
| false
|-
|}

=== Alien Races ===

Defines a [[Alien Life Forms|race]] used in [[Alien Missions]], listed in ''"alienRaces:"''. Heavily tied with deployment data.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''id'''
| String ID of the alien race name.
| ''required''
|-
| '''members'''
| Alien crew associated with this alien race (eg. race units + terrorist units), defined by a list of unit string IDs. Order here will define rank in terms of deployment. generally speaking the order is:
* 0 - Commander
* 1 - Leader
* 2 - Engineer
* 3 - Medic
* 4 - Navigator
* 5 - Soldier
* 6 - Terrorist 1
* 7 - Terrorist 2
but of course, not all races have all ranks, so the "fill in" rank would be listed multiple times (see ethereals).
| -
|-
| '''retaliation'''
| retaliation enables/disables the race for retaliation missions.
| ''True''
|-
|}

=== Alien Deployments ===

Defines a Battlescape deployment data used in [[Alien Missions]] (such as alien and map configurations), listed in ''"alienDeployments:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the deployment name.
| ''required''
|-
| '''width'''
| Width of the Battlescape map in grid units.
| 0
|-
| '''length'''
| Length of the Battlescape map in grid units.
| 0
|-
| '''height'''
| Vertical height of the Battlescape map in grid units.
| 0
|-
| '''terrains'''
| list of string IDs of the [[#Terrains|terrain]] to choose from to generate this map. This is not used for UFO sites where the terrain comes from the Geoscape.
| -
|-
| '''shade'''
| Shade of the map (0-15, where 0 is full daytime and 15 is full nighttime). This is not used for UFO sites where the shade comes from the Geoscape.
| 0
|-
| '''nextStage'''
| String ID of the next deployment stage to use after this one, for multi-stage missions.
| -
|-
| '''race'''
| Sets the race to use in the next stage.
| ""
|-
| '''script'''
| Reference to a mapScript.
| ""
|-
| '''data'''
| List of deployment data for each alien rank on this mission (see below).
| -
|}

Notes:
* '''terrains''' can also be used with UFOs, with the game using instead the listed terrain rather than the location of the UFO on Geoscape.
==== Deployment Data ====

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''alienRank'''
| [[Alien Rank|Rank]] associated with this deployment data, as defined by the order of the race in question (see above)
| ''required''
|-
| '''lowQty'''
| Maximum quantity of aliens to spawn (beginner).
| 0
|-
| '''highQty'''
| Maximum quantity of aliens to spawn (superhuman).
| 0
|-
| '''dQty'''
| Minimum Desired Quantity of aliens to spawn.
| 0
|-
| '''extraQty'''
| spawns a random number of additional aliens.
| 0
|-
| '''percentageOutsideUfo'''
| Percentage (0-100%) of aliens to spawn outside in UFO sites.
| 0
|-
| '''itemSets'''
| Three lists (one for each alien technology level) of [[#Items|items]] (string IDs) for the aliens to equip.
| ''required''
|-
|}

=== Research ===

Defines a [[Research|research topic]] that X-COM scientists can investigate, listed in ''"research:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''name'''
| String ID of the research project's name (or item, if a '''lookup''' is defined).
| ''required''
|-
| '''lookup'''
| String ID of the research project's display name and UFOPaedia article reference.
| -
|-
| '''cost'''
| Number of man hours (on average) required to complete this project.
| 0
|-
| '''points'''
| [[Score]] earned for completing this project.
| 0
|-
| '''needItem'''
| Does this project require an [[#Items|item]] of the same name?
| false
|-
| '''dependencies'''
| List of research projects that can unlock access to this one. If the full list is researched, or if one of the projects on the list "unlocks" this one, it becomes available.
| -
|-
| '''unlocks'''
| List of research projects unlocked, regardless of other dependencies, but not requirements, by completing this project (for example, any live alien unlocks "alien origins").
| -
|-
| '''requires'''
| List of research projects unilaterally required before this project can be unlocked (for example, "the martian solution" will not even be considered for unlocking until AFTER "alien origins" is completed).
| -
|-
| '''getOneFree'''
| List of "bonus" research projects that may be granted when completing this project (for example, alien medics will give you information on other alien races). Only applies to living aliens.
| -
|-
|}

=== Manufacture ===

Defines a [[Manufacture|manufacture project]] that X-COM engineers can produce, listed in ''"manufacture:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''name'''
| String ID of the manufacturing project's name (and the item it produces).
| ''required''
|-
| '''category'''
| String ID of the manufacturing project's category.
| -
|-
| '''requires'''
| List of [[#Research|topics]] (string IDs) that must be researched to unlock this project. If none are specified, this project is unlocked from the start.
| -
|-
| '''space'''
| Amount of [[Workshop]] space required to begin this project.
| 0
|-
| '''time'''
| Number of man hours (on average) required per item.
| 0
|-
| '''cost'''
| Monetary deduction per item manufactured.
| 0
|-
| '''requiredItems'''
| List of [[#Items|items]] required and consumed per item manufactured.
| -
|-
| '''producedItems'''
| List of [[#Items|items]] produced per each item consumed. If not specified, defaults to 1 item with the same string ID as the manufacture.
| 1
|-
|}

=== UFOpaedia Article ===

Defines an article in the in-game [[UFOpaedia]], listed in ''"ufopaedia:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''id'''
| String ID of the article name. This must match the ID of the object associated with this article, if applicable.
| ''required''
|-
| '''title'''
| String ID of the article title. If omitted, the '''id''' is used.
| -
|-
| '''type_id'''
| Type of this article:
* 0 = Unknown
* 1 = [[Craft]]
* 2 = [[Craft Armaments]]
* 3 = [[HWP]]
* 4 = [[Equipment (EU)|Equipment]]
* 5 = [[Armour]]
* 6 = [[Base Facilities]]
* 7 = Text & Image (eg. [[Alien Life Forms]], [[UFO Components]])
* 8 = Text (eg. [[Alien Research]])
* 9 = [[UFO]]
* 10 = [[TFTD]]
* 11 = TFTD [[Subs]]
* 12 = TFTD [[Sub_Armaments]]
* 13 = TFTD [[Submersible_Weapons_Systems]]
* 14 = TFTD [[Equipment_(TFTD)]]
* 15 = TFTD Armour
* 16 = TFTD [[Base_Facilities_(TFTD)]]
* 17 = TFTD [[Alien_Subs]]
| 0
|-
| '''section'''
| String ID of the UFOpaedia section this article belongs in.
| -
|-
| '''requires'''
| List of [[#Research|topics]] (string IDs) that must be researched to unlock this article. If none are specified, this article is unlocked from the start.
| -
|-
| '''image_id'''
| Filename of the [[UP001.SPK-UP042.SPK|background image]] displayed on this article, if applicable.
| -
|-
| '''text'''
| String ID of the description displayed on this article.
| -
|-
| '''text_width'''
| Maximum width of the text displayed, only applicable to ''Text & Image'' articles.
| 150
|-
| '''rect_stats'''
| Rectangle ('''x''', '''y''', '''width''', '''height''') of the stats text on the screen, only applicable to ''Craft'' articles.
| 0
|-
| '''rect_text'''
| Rectangle ('''x''', '''y''', '''width''', '''height''') of the description text on the screen, only applicable to ''Craft'' articles.
| 0
|-
| '''weapon'''
| String ID of the weapon, only applicable to ''HWP'' articles.
| -
|}

=== UFO Trajectories ===

Defines a trajectory carried out by an UFO during an [[#Alien Missions|alien mission]], listed in ''"ufoTrajectories:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''id'''
| String ID of the trajectory name.
| ''required''
|-
| '''groundTimer'''
| Amount of seconds for the UFO to spend on Ground waypoints.
| 0
|-
| '''waypoints'''
| List of waypoints for the UFO to traverse, defined as ''[zone, altitude, speed]''. 
'''zone''': Globe zone where the waypoint is located. 
'''altitude''': UFO altitude after reaching this waypoint:
* 0 - Ground
* 1 - Very Low
* 2 - Low
* 3 - High
* 4 - Very High
'''speed''': UFO speed after reaching this waypoint, as a percentage (0-100%) of its maximum speed.
| -
|}

=== Alien Missions ===

Defines an [[Alien Missions|alien mission]] carried out by UFOs on the Geoscape, listed in ''"alienMissions:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the mission type.
| ''required''
|-
| '''points'''
| [[Score]] allocated to aliens for successfully completing this mission.
| 0
|-
| '''raceWeights'''
| List of alien races likely to carry out this mission, and the % chance of them being allocated to this mission, listed by "number of months after game beginning".
| ''required''
|-
| '''waves'''
| List of UFO waves to spawn as this mission progresses, as described below.
| ''required''
|}

==== Waves ====

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''ufo'''
| String ID of the [[#UFOs|UFO]] to spawn.
| ''required''
|-
| '''count'''
| Number of UFOs to spawn.
| 0
|-
| '''trajectory'''
| String ID of the [[#UFO Trajectories|trajectory]] for this UFO to use when entering Earth's atmosphere.
| ''required''
|-
| '''timer'''
| How long after the previous wave should this wave arrive? (in seconds)
| 0
|-
|}

=== Alien Item Levels ===

This is a list of item level probabilities, with a number between 0 and 2 representing an item level from plasma pistols to heavy plasmas, as defined in the deployments, expressing a 10% probability for that item level being used.

0 = first set (plasma pistol/clip)
1 = second set (plasma rifle/clip)
2 = third set (heavy plasma/clip)

For example:
[ 2, 0, 0, 0, 0, 0, 0, 1, 1, 1 ]
would represent a 60% chance for pistols, 30% rifles, and 10% heavy weapons. 
Note that the order does not matter, but the length DOES. each line MUST have 10 digits.

The above can be confusing. There are 10 fields; each number represents 10%. 
There are six instances of '0'. 6x10% = 60% chance of plasma pistol 
There are three instances of '1'. 3x10% = 30% chance of plasma rifle 
There is only one instance of '2'. 1x10% = 10% chance of heavy plasma 

Each line represents a month after the beginning of the game, and there is no limit to the number defined. 
OpenXCom will use the most recently available item level in the event the game goes on forever.

=== Extra Sprites ===

Adds or replaces sprites in an existing [[Image Formats|X-COM image file]], listed in ''"extraSprites:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| Filename of the original/new image to modify.
| ''required''
|-
| '''width'''
'''height'''
| Size of the sprite(s) in pixels.
| 0
0
|-
| '''singleImage'''
| Is the image file just a single sprite (true) or a spritesheet (false)?
| false
|-
| '''subX'''
'''subY'''
| Size of the subdivision in pixels. If a subdivision is specified, then the image file is divided into chunks to form the sprites (eg. spritesheets).
| 0
0
|-
| '''files'''
| List of the new sprites to add/replace, listed as ''spriteID: filename''.
| -
|}

Example:
- type: GIANTBUNNY.PCK
width: 32
height: 40
files:
0: Resources/Bunny/Bunny00.png
1: Resources/Bunny/Bunny01.bmp
2: Resources/Bunny/Bunny02.gif

=== Extra Sounds ===

Adds or replaces sounds in an existing [[SOUND|X-COM sound file]], listed in ''"extraSounds:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| ID of the original sound file to modify:
* BATTLE.CAT - Battlescape sounds, corresponds to ''SOUND1.CAT'' or ''SAMPLE2.CAT'' (55 sounds).
* INTRO.CAT - Intro sounds, corresponds to ''INTRO.CAT'' or ''SAMPLE3.CAT'', probably best not to mess with these.
* GEO.CAT - Geoscape sounds, corresponds to ''SOUND2.CAT'' or ''SAMPLE.CAT'' (14 sounds).
| ''required''
|-
| '''files'''
| List of the new sounds to add/replace, listed as ''soundID: filename''.
| -
|}

Example:
- type: BATTLE.CAT
files:
55: Resources/Sounds/sample.wav

=== Extra Strings ===

Adds or replaces text strings in an existing [[Translations (OpenXcom)|OpenXcom language file]], listed in ''"extraStrings:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| Filename of the original language file to modify, sans extension.
| ''required''
|-
| '''strings'''
| List of the new strings to add/replace, listed as ''stringID: text''.
| -
|}

Example:
- type: en-US
strings:
STR_SNIPER_RIFLE: Sniper Rifle
STR_SNIPER_RIFLE_CLIP: Sniper Rifle Clip
- type: en-GB
strings:
STR_SNIPER_RIFLE: Sniper Rifle
STR_SNIPER_RIFLE_CLIP: Sniper Rifle Clip
- type: de
strings:
STR_SNIPER_RIFLE: Scharfschützengewehr
STR_SNIPER_RIFLE_CLIP: Scharfschützengewehrmunition
- type: ru
strings:
STR_SNIPER_RIFLE: Снайперская винтовка
STR_SNIPER_RIFLE_CLIP: Магазин к снайп. винтовке

=== Interfaces ===

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| ''?''
| -
|-
| '''elements'''
| ''?''
| -
|-
| '''id'''
| ''?''
| -
|-
| '''color'''
| ''?''
| -
|}

=== StatStrings ===

[[Statstrings]] are used for automatically renaming soldiers. They are case sensitive and they are processed in the order in which they are specified.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''string'''
| String to add to name.
| ''required''
|-
| '''psiStrength''' 
'''psiSkill''' 
'''bravery''' 
'''strength''' 
'''firing''' 
'''reactions''' 
'''stamina''' 
'''tu''' 
'''health''' 
'''throwing'''
| One or more stat ranges are ANDed together for success. Each range has a minVal and maxVal. Use YAML standard tilde (~) to indicate null. ((~) = 0 as minvalue; (~) =255 as maxvalue)
| -
|}

Example:
statStrings:
- string: "x"
psiStrength: [~, 30]
- string: "P"
psiStrength: [80, ~]
- string: "p"
psiStrength: [60, 79]
- string: "K"
psiSkill: [60, ~]
- string: "k"
psiSkill: [30, 59]
- string: "b"
bravery: [60, ~]
- string: "c"
bravery: [~, 10]
- string: "w"
strength: [~, 25]
- string: "Snpr"
firing: [60, ~]
reactions: [60, ~]
- string: "M"
firing: [70, ~]
- string: "m"
firing: [60, 69]
- string: "Sct"
reactions: [50, ~]
tu: [60, ~]
- string: "R"
reactions: [60, ~]
- string: "r"
reactions: [50, 59]

==References==
<references />

[[Category:OpenXcom]]

Ruleset Reference Nightly (OpenXcom)

2014-12-06T16:00:10Z

Falko: /* Terrains */

A reference of all the customizable values of everything in a [[Rulesets (OpenXcom)|ruleset]], according to the latest nightly. This page should be updated as new versions become available in order to explain the changes from version 1.0.

Some guidelines:
* If a value is omitted from the ruleset, the default is used. You cannot omit ''required'' values.
* Text strings (eg. names) are represented by string IDs from the [[Translations (OpenXcom)|language files]]
* Numerical IDs (used for sprites, sounds, etc.) start at 0, not 1.
* Boolean (yes/no) values are represented by true/false.
* World coordinates are represented in degrees (see [[WORLD.DAT]]).
* Money amounts (prices, costs, etc.) are represented in dollars.
* All paths are '''case sensitive'''! If your ruleset uses external files, make sure that they named properly as described in ruleset.

Items are ordered as they come in the ruleset. To override this, you can specify a ''listOrder''. You can find the default listOrders in [[Ruleset List Order (OpenXcom)|Ruleset List Order]].

=== Globe ===

Defines the drawing of landmasses and borders on the globe.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''data'''
| Path name of file which contains polygon and texture information. (For example WORLD.DAT).
| -
|-
| '''polygons'''
| List of polygons drawn on the globe surface. A triangle consist of seven values: the first number defines the texture, followed by three pairs of (x,y) globe coordinates. Only polygons with 3 or 4 vertices are reliable shown on the globe = 7 or 9 values per entry.
| -
|-
| '''polylines'''
| List of border lines. Each list entry consist of a list of (x,y) globe coordinates.
| -
|}

=== Countries ===

Defines one of the [[Country Funding (EU)|funding nations]], listed in ''"countries:"''. They're used for activity graphs and player scoring.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the country name.
| ''required''
|-
| '''fundingBase'''
| Country's base funding, in thousands. The starting funding can be anywhere between 1x and 2x the base funding.
| 0
|-
| '''fundingCap'''
| Country's funding cap, in thousands. Once a country reaches this maximum, it will no longer increase its funding.
| 0
|-
| '''labelLon'''
'''labelLat'''
| Longitude and latitude coordinates of the country's label on the globe. This label is only shown when the globe is zoomed in and "detail" is turned on.
| 0.0
0.0
|-
| '''areas'''
| List of "rectangles" on the globe defined as [''lon1'' ''lat1'' ''lon2'' ''lat2'']. Any activity within these areas counts towards the country's graph activity and affects their opinion of the player.
| -
|}

=== Regions ===

Defines one of the [[Geoscape (EU)#World Regions/Countries|world regions]], listed in ''"regions:"''. They're used for base placement, activity graphs and mission spawning.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the region name.
| ''required''
|-
| '''cost'''
| Amount of money spent building an X-COM base in this region (first base is free).
| 0
|-
| '''areas'''
| List of "rectangles" on the globe defined as ''[lon1, lat1, lon2, lat2]''. Any activity within these areas counts towards the region's graph activity.
| -
|-
| '''cities'''
| List of cities belonging to this region. They will be displayed on the globe and used for terror site missions. Each city is defined by their '''lon''' and '''lat''' coordinates and a '''name''' string ID.
| -
|-
| '''regionWeight'''
| Weight of this region when selecting regions for alien missions.
| 0
|-
| '''missionWeights'''
| Weighted list of the different mission types for this region (eg. ''STR_ALIEN_RESEARCH: 14'').
| -
|-
| '''missionZones'''
| List of "rectangles" (''[lon1, lat1, lon2, lat2]'') defining the mission zones for this region. Mission zones are waypoints for UFO trajectories.
| -
|-
| '''missionRegion'''
| Spawn mission in this region instead (used for regions without land).
| -
|}

=== Base Facilities ===

Defines one of the [[Base Facilities (EU)|facilities]] that can be built in an X-COM base, listed in ''"facilities:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the facility name.
| ''required''
|-
| '''requires'''
| List of [[#Research|topics]] (string IDs) that must be researched to unlock this facility. If none are specified, this facility is unlocked from the start.
| -
|-
| '''spriteShape'''
| Sprite ID from [[BASEBITS.PCK]] used to draw the facility's outer shape in the Basescape and UFOpaedia.
| -1
|-
| '''spriteFacility'''
| Sprite ID from [[BASEBITS.PCK]] used to draw the facility's contents in the Basescape and UFOpaedia. Drawn on top of '''spriteShape'''.
| -1
|-
| '''lift'''
| Is this facility an [[Access Lift]]? All base facilities must be connected to the lift.
| false
|-
| '''hyper'''
| Is this facility a [[Hyperwave Decoder]]? Displays extra information for detected UFOs. Only valid for radar facilities.
| false
|-
| '''mind'''
| Is this facility a [[Mind Shield]]? Reduces the chance of UFOs finding your base. Does not stack.
| false
|-
| '''grav'''
| Is this facility a [[Grav Shield]]? Doubles the power of your base defenses. Does not stack.
| false
|-
| '''size'''
| Size of the facility, in grid units. Every facility is square, so a size of 1 means 1x1, 2 means 2x2, etc. Bigger facilities are made up of multiple sprites, for example a 2x2 facility will use 4 sprites for '''spriteShape''' and 4 sprites for '''spriteFacility''' (top-left, top-right, bottom-left, bottom-right).
| 1
|-
| '''buildCost'''
| Amount of money spent to build this facility in the base.
| 0
|-
| '''buildTime'''
| Amount of days it takes for this facility to be built.
| 0
|-
| '''monthlyCost'''
| Amount of money spent monthly for the maintenance of this facility.
| 0
|-
| '''storage'''
| Amount of storage space (for items) this facility provides. See [[Base Stores]].
| 0
|-
| '''personnel'''
| Amount of personnel (soldiers, scientsts, engineers) these quarters can contain.
| 0
|-
| '''aliens'''
| Amount of live aliens this facility can contain. Only checked if the ''alienContainmentLimitEnforced'' option is enabled.
| 0
|-
| '''crafts'''
| Amount of X-COM craft this facility can contain.
| 0
|-
| '''labs'''
| Amount of lab space this facility provides for research projects.
| 0
|-
| '''workshops'''
| Amount of workshop space this facility provides for manufacture projects.
| 0
|-
| '''psiLabs'''
| Amount of soldier space this facility provides for psionic training.
| 0
|-
| '''radarRange'''
| Maximum radar detection range of this facility, in nautical miles.
| 0
|-
| '''radarChance'''
| Chance (0-100%) of this radar detecting a UFO that enters its range.
| 0
|-
| '''defense'''
| Offensive power provided by this base defense against attacking UFOs.
| 0
|-
| '''hitRatio'''
| Chance (0-100) of the base defense hitting an attacking UFO.
| 0
|-
| '''fireSound'''
| Sound ID from [[#Extra_Sounds|GEO.CAT]] played when the base defense fires.
| -1
|-
| '''hitSound'''
| Sound ID from [[#Extra_Sounds|GEO.CAT]] played when the base defense hits a target.
| -1
|-
| '''mapName'''
| [[MAPS|Map]] associated to this facility in Battlescape base defenses.
| -
|-
|}

=== Crafts ===

Defines one of the [[Craft|X-COM crafts]] that go on interception missions, listed in ''"crafts:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the craft name.
| ''required''
|-
| '''requires'''
| List of [[#Research|topics]] (string IDs) that must be researched to unlock this craft. If none are specified, this craft is unlocked from the start.
| -
|-
| '''sprite'''
| Sprite ID from [[BASEBITS.PCK]] used to draw this craft in the Basescape and from [[INTICON.PCK]] used to draw the damage indicator in dogfights.
modders: the corresponding extrasprite file id for BASEBITS.PCK is sprite+33 INTICON.PCK contains a minimized icon id=sprite the file id for the dogfight image is sprite+11
| -1
|-
| '''fuelMax'''
| Maximum amount of fuel this craft can carry. Crafts use up fuel based on their speed while travelling.
| 0
|-
| '''damageMax'''
| Maximum amount of damage this craft can take. If this amount is exceeded, the craft is destroyed.
| 0
|-
| '''speedMax'''
| Maximum speed in nautical miles. Crafts travel at max speed when flying and half speed when patrolling.
| 0
|-
| '''accel'''
| Aceeleration value shown in the UFOpaedia.
| 0
|-
| '''weapons'''
| Amount of craft weapons this craft can equip. The UI can only display a max of 2 weapons.
| 0
|-
| '''soldiers'''
| Amount of soldiers this craft can carry.
| 0
|-
| '''maxItems'''
| Amount of items this craft can carry.
| 80
|-
| '''vehicles'''
| Amount of vehicles this craft can carry.
| 0
|-
| '''costBuy'''
| Amount of money spent for purchasing this craft. If set to 0, the craft will not be available in the Purchase/Recruit screen.
| 0
|-
| '''costRent'''
| Amount of money spent monthly for renting this craft. If set to 0, the craft is not on rental and won't count towards base maintenance.
| 0
|-
| '''costSell'''
| Amount of money gained for selling this craft.
| 0
|-
| '''refuelItem'''
| Item required for refuelling this craft. If no item is specified, the craft uses human fuel.
| 0
|-
| '''repairRate'''
| Amount of damage restored every hour while [[Repairs|Repairing]] in base.
| 1
|-
| '''refuelRate'''
| Amount of fuel restored every 30 mins while [[Refueling]] in base. If specified, a '''refuelItem''' is spent each time.
| 1
|-
| '''radarRange'''
| Detection range of the craft's radar in nautical miles. Every craft radar has a 100% detection chance.
| 600
|-
| '''transferTime'''
| Number of hours it takes to purchase/transfer this craft to a base.
| 0
|-
| '''score'''
| [[Score]] lost when this craft is destroyed.
| 0
|-
| '''spacecraft'''
| Can this craft go to [[Cydonia]]?
| false
|-
| '''battlescapeTerrainData'''
| [[#Terrains|Terrain]] associated to this craft in Battlescape missions.
| -
|}

=== Craft Weapons ===

Defines one of the [[Craft Armaments|weapons]] equipped by X-COM craft for shooting down UFOs, listed in ''"craftWeapons:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the weapon name.
| ''required''
|-
| '''sprite'''
| Sprite ID from [[BASEBITS.PCK]] used to draw the weapon in the Basescape and from [[INTICON.PCK]] used to draw the weapon in dogfights.
modders: the corresponding extrasprites file id for INTICON.PCK is sprite+5 and sprite+48 for BASEBITS.PCK
| -1
|-
| '''sound'''
| Sound ID from [[#Extra_Sounds|GEO.CAT]] played when this weapon fires.
| -1
|-
| '''damage'''
| Amount of damage this weapon does to enemy UFOs.
| 0
|-
| '''range'''
| Maximum range of this weapon in dogfights (in meters).
| 0
|-
| '''accuracy'''
| Chance (0-100%) of each shot hitting the enemy UFO.
| 0
|-
| '''reloadCautious'''
| Time this weapon takes to fire between each shot in ''Cautious Mode''.
| 0
|-
| '''reloadStandard'''
| Time this weapon takes to fire between each shot in ''Standard Mode''.
| 0
|-
| '''reloadAggressive'''
| Time this weapon takes to fire between each shot in ''Aggressive Mode''.
| 0
|-
| '''ammoMax'''
| Maximum amount of ammo this weapon can carry.
| 0
|-
| '''rearmRate'''
| Amount of ammo restored every 30 mins while the craft is [[Rearming]] in base. If specified, '''clip'''s are spent depending on their '''clipSize'''. If the '''clipSize''' of the specified ammo is 0, no '''clip'''s are spent.
| 1
|-
| '''projectileType'''
| Type of the weapon projectile, used for the projectile sprite in dogfights:
* 0 - [[Stingray]]
* 1 - [[Avalanche]]
* 2 - [[Cannon]]
* 3 - [[Fusion Ball]]
* 4 - [[Laser Cannon]]
* 5 - [[Plasma Beam]]
| 2
|-
| '''projectileSpeed'''
| Speed of the weapon projectile in dogfights.
| 0
|-
| '''launcher'''
| String ID of the [[#Items|item]] required to equip this weapon.
| -
|-
| '''clip'''
| String ID of the [[#Items|item]] required to rearm this weapon.
| -
|}

=== Items ===

Defines the Geoscape and Battlescape properties of an [[Equipment (EU)|item]] that can be stored in X-COM bases, listed in ''"items:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the internal item name.
| ''required''
|-
| '''name'''
| String ID of the displayed item name, for cases where it's different from the internal name. If omitted, '''type''' is used.
| -
|-
| '''requires'''
| List of [[#Research|topics]] (string IDs) that must be researched to unlock this item. If none are specified, this item is unlocked from the start. Soldiers can only use unlocked items in the Battlescape.
| -
|-
| '''size'''
| Space occupied by this item in [[Base Stores]]. Can be a decimal value.
| 0.0
|-
| '''costBuy'''
| Amount of money spent for purchasing this item. If set to 0, this item will not be available in the Purchase/Recruit screen.
| 0
|-
| '''costSell'''
| Amount of money gained for selling this item.
| 0
|-
| '''transferTime'''
| Number of hours it takes to purchase/transfer this item to a base.
| 24
|-
| '''weight'''
| [[Item_Weight|Weight]] occupied by this item in a soldier's inventory.
| 999
|-
| '''bigSprite'''
| Sprite ID from [[BIGOBS.PCK]] used to draw this item in a soldier's inventory and UFOpaedia.
| -1
|-
| '''floorSprite'''
| Sprite ID from [[FLOOROB.PCK]] used to draw this item on the floor of a Battlescape tile.
| -1
|-
| '''handSprite'''
| Sprite ID from [[HANDOB.PCK]] used to draw this item on a soldier's hand in the Battlescape.
modders: each handobject needs 8 images (8 directions) define the extrasprites accordingly
| 120
|-
| '''bulletSprite'''
| Sprite ID from ''BulletSprites.png'' used to draw this weapon's projectile on the Battlescape:
* 0 - [[Rocket Launcher]]
* 1 - [[Pistol]]
* 2 - [[Rifle]]
* 3 - [[Auto Cannon]]
* 4 - [[Heavy Cannon]]
* 5 - [[Laser Pistol]]
* 6 - [[Laser Rifle]]
* 7 - [[Heavy Laser]]
* 8 - [[Plasma Rifle|Plasma]]
* 9 - [[Small Launcher]]
* 10 - [[Blaster Launcher]]
for modders: the bulletsprite needs to be put into the extraSprites type "Projectiles" the bulletsprite can contain up to 35 3x3 images. The corresponding file id is 35*[bulletSprite]
| -1
|-
| '''fireSound'''
| Sound ID from [[#Extra_Sounds|BATTLE.CAT]] played when this weapon fires.
| -1
|-
| '''hitSound'''
| Sound ID from [[#Extra_Sounds|BATTLE.CAT]] played when this weapon hits a target.
| -1
|-
| '''hitAnimation'''
| Sprite ID from [[SMOKE.PCK]] used to draw the weapon's "hit explosion".
'''NOTE''': Do not define this value for melee/psi weapons, they use [[HIT.PCK]] and therefore meleeAnimation instead.
| 0
|-
| '''power'''
| Average damage of the weapon, in most cases it will be +-50% this value.
| 0
|-
| '''strengthApplied'''
| Add the attacking unit's strength to this weapon's damage.
| false
|-
| '''compatibleAmmo'''
| List of string IDs of the ammo items that can be loaded on this weapon. If none are specified, the weapon doesn't need ammo.
| -
|-
| '''damageType'''
| What type of [[damage]] does this weapon do:
* 0 - None
* 1 - Armor Piercing
* 2 - Incendiary
* 3 - High Explosive
* 4 - Laser
* 5 - Plasma
* 6 - Stun
* 7 - Melee
* 8 - Acid
* 9 - Smoke
'''NOTE:''' A damage type other than 0-9 will do nothing.
| 0
|-
| '''tuAuto'''
'''accuracyAuto'''
| The percentage (0-100%) of [[Time Units]] (from the soldier's total) required to fire an Auto Shot. If 0, the weapon does not have an Auto Shot.
The base accuracy (0-100%) applied to a soldier's [[Firing Accuracy]] when firing an Auto Shot.
| 0
0
|-
| '''tuSnap'''
'''accuracySnap'''
| The percentage (0-100%) of [[Time Units]] (from the soldier's total) required to fire a Snap Shot. If 0, the weapon does not have a Snap Shot.
The base accuracy (0-100%) applied to a soldier's [[Firing Accuracy]] when firing a Snap Shot.
| 0
0
|-
| '''tuAimed'''
'''accuracyAimed'''
| The percentage (0-100%) of [[Time Units]] (from the soldier's total) required to fire an Aimed Shot. If 0, the weapon does not have an Aimed Shot.
The base accuracy (0-100%) applied to a soldier's [[Firing Accuracy]] when firing an Aimed Shot.
| 0
0
|-
|-
| '''tuMelee'''
'''accuracyMelee'''
| The percentage (0-100%) of [[Time Units]] (from the soldier's total) required to do a melee attack (Hit). If 0, the weapon does not have a melee attack.
The base accuracy (0-100%) applied to a soldier's [[Melee Accuracy]] when doing a melee attack.
| 0
0
|-
| '''clipSize'''
| The amount of ammo stored in each weapon clip. If -1 is specified, this weapon has infinite ammo.
| 0
|-
| '''battleType'''
| Defines the weapon's behavior in the Battlescape:
* 0 - None (Geoscape-only item)
* 1 - [[Weapons|Firearm]]
* 2 - Ammo
* 3 - Melee
* 4 - [[Grenade]]
* 5 - [[Proximity Grenade]]
* 6 - [[Medi-Kit (EU)|Medi-Kit]]
* 7 - [[Motion Scanner]]
* 8 - [[Mind Probe]]
* 9 - [[Psi-Amp]]
* 10 - [[Electro-flare]]
* 11 - Corpse
| 0
|-
| '''twoHanded'''
| Is this weapon two-handed? If true, incurs an accuracy penalty if used with both hands occupied. Note that the handsprite of a twoHanded item is also drawn at a slightly different position than a one handed item.
| false
|-
| '''waypoint'''
| Does this weapon use waypoints? (eg. [[Blaster Launcher]]). Can also be used to make ammo items use the waypoint system.
| false
|-
| '''fixedWeapon'''
| Is this weapon fixed? (it's part of a unit, eg. tanks and terrorist units)
| false
|-
| '''invWidth'''
| Item width in a soldier's inventory (in grid units).
| 1
|-
| '''invHeight'''
| Item height in a soldier's inventory (in grid units).
| 1
|-
| '''painKiller'''
| Amount of painkillers contained in a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''heal'''
| Amount of heal's contained in a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''stimulant'''
| Amount of stimulants contained in a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''woundRecovery'''
| Amount of [[Fatal Wounds]] treated by each heal of a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''healthRecovery'''
| Amount of [[Health]] recovered by each heal of a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''stunRecovery'''
| Amount of [[Stun]] removed by each stimulant of a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''energyRecovery'''
| Amount of [[Energy]] recovered by each stimulant of a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''tuUse'''
| Amount of [[Time Units]] required to use this item (for non-offensive items). It's a flat rate if '''flatRate''' is true, otherwise it's a percentage (0-100%).
| 0
|-
| '''recoveryPoints'''
| [[Score]] gained for recovering this alien artifact.
| 0
|-
| '''armor'''
| How much damage is needed to destroy this item on the ground.
| 20
|-
| '''recover'''
| Is this item recoverable? (gets transported to the X-COM base on mission success)
| true
|-
| '''turretType'''
| Sprite ID from [[TANKS.PCK]] of the turret to assign to this tank:
* 0 - [[Tank/Cannon]]
* 1 - [[Tank/Rocket Launcher]]
* 2 - [[Tank/Laser Cannon]]
* 3 - [[Hovertank/Plasma]]
* 4 - [[Hovertank/Launcher]]
| -1
|-
| '''liveAlien'''
| Does this item represent a live alien? (counts towards [[Alien Containment]])
| false
|-
| '''blastRadius'''
| Size of the projectile explosions. 0 for no explosion. -1 to automatically calculate based on weapon power and damage type (actual '''blastRadius''' currently is capped due [[Explosions#Playing_With_Fire|Explosion calculations]]).
| -1
|-
| '''flatRate'''
| If true, then TU costs for this weapon are a flat rate (instead of a percentage of unit TUs).
| false
|-
| '''arcingShot'''
| Does this weapon fire in an arc?
| false
|-
| '''attraction'''
| Represents how likely an alien is to pick up this item. Values below 5 will be ignored (by design).
| 0
|-
| '''maxRange'''
| Maximum range at which this weapon can operate.
| 200
|-
| '''aimRange'''
| Maximum effective range with this weapon before which range-based dropoff occurs.
| 200
|-
| '''snapRange'''
| Maximum effective range with snap shot before which range-based dropoff occurs. (ufoextender accuracy only)
| 15
|-
| '''autoRange'''
| Maximum effective range with auto shot before which range-based dropoff occurs. (ufoextender accuracy only)
| 7
|-
| '''minRange'''
| Range-based dropoff will work in reverse for ranges below this.
| 0
|-
| '''dropoff'''
| The value by which the accuracy lowers for each tile after (or before) the thresholds above.
| 2
|-
| '''bulletSpeed'''
| How much faster (or slower, if you use a negative number) is a projectile fired from this weapon compared to the average.
| 0
|-
| '''autoShots'''
| How many auto shots does this weapon fire.
| 3
|-
| '''shotgunPellets'''
| Number of projectiles fired per unit of ammunition. (note: due to engine limitations it is currently impossible to draw multiple projectiles in flight.)
| 0
|-
| '''zombieUnit'''
| String ID of the unit used for zombification (eg. [[Chrysallid]]s turn units into [[Zombie]]s).
| none
|-
| '''meleeSound'''
| Sound ID from [[#Extra_Sounds|BATTLE.CAT]] played when this weapon attacks a target with melee.
| 39
|-
| '''meleeHitSound'''
| Sound ID from [[#Extra_Sounds|BATTLE.CAT]] played when this weapon HITS a target with melee.
| -1
|-
| '''meleeAnimation'''
| Sprite ID from HIT.PCK played when this weapon attacks a target with melee.
| 0
|-
| '''meleePower'''
| Damage this weapon will do when using melee. This only applies to Firearms, and is only available as stun damage. For normal melee weapons, use regular power and damage types.
| 0
|-
| '''LOSRequired'''
| Does this item require line of sight? (only applies to mind probes and psi-amps)
| false
|-
| '''skillApplied'''
| Is melee skill applied to the accuracy of an attack made with this object?
| true
|-
|}

=== UFOs ===

Defines one of the [[UFOs]] that invade Earth, listed in ''"ufos:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the UFO name.
| ''required''
|-
| '''size'''
| String ID of the UFO size.
| STR_VERY_SMALL
|-
| '''sprite'''
| Sprite ID from [[INTERWIN.DAT]] used to draw this UFO in the dogfight view and UFOpaedia.
don't try to add more images if you don't want to punch yourself in the face - use modsprite
| -1
|-
| '''modSprite'''
| Filename used to draw this UFO in the dogfight view and UFOpaedia.
| -
|-
| '''damageMax'''
| Maximum amount of damage this UFO can take. If the UFO takes 50% damage, it crash lands. If it takes 100% damage, it is destroyed.
| 0
|-
| '''speedMax'''
| Maximum speed in nautical miles.
| 0
|-
| '''accel'''
| Aceeleration value shown in the UFOpaedia.
| 0
|-
| '''power'''
| Damage power of this UFO's weapon in dogfights.
| 0
|-
| '''range'''
| Maximum range of this UFO's weapon in dogfights (in meters).
| 0
|-
| '''score'''
| [[Score]] gained when this UFO is destroyed, or half this score if it crash lands.
| 0
|-
| '''reload'''
| Time the UFO's weapon takes to fire between each shot.
| 0
|-
| '''breakOffTime'''
| Minimum amount of time for the UFO to be able to break off of a dogfight.
| 0
|-
| '''battlescapeTerrainData'''
| [[#Terrains|Terrain]] associated to this UFO in Battlescape missions.
| ''required''
|-
|}

=== Inventory Sections ===

Defines one of the sections of the [[Inventory TU Table|Battlescape inventory]] (eg. Backpack), listed in ''"invs:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the inventory name.
| ''required''
|-
| '''x'''
'''y'''
| Pixel coordinates of this section on the inventory screen.
| 0
0
|-
| '''type'''
| Type of this section:
* 0 = Slot section, can contain as many items as will fit on the slots.
* 1 = Hand section, can only contain one item regardless of size.
* 2 = Ground section, can contain infinite items.
| 0
|-
| '''slots'''
| List of the grid slots (''[x, y]'') that this section is composed of. For example, to make a 2x2 section, you would have ''[0, 0] [0, 1] [1, 0] [1, 1]''.
| -
|-
| '''costs'''
| List of [[Time Units]] costs to move an item from this section to another one (eg. ''STR_BACKPACK: 16'' means it will cost 16 TUs to move an item from this section to the Backpack).
| -
|-
|}

=== Terrains ===

Defines one of the [[TERRAIN|terrains]] used to generate a Battlescape map, listed in "terrains:".

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''name'''
| String ID of the terrain name.
| ''required''
|-
| '''textures'''
| List of [[TEXTURE.DAT|Geoscape textures]] that correspond to this terrain.
| -
|-
| '''hemisphere'''
| Geoscape hemisphere associated with this terrain:
* -1 - Northern hemisphere.
* 0 - Both hemispheres.
* 1 - Southern hemisphere.
| 0
|-
| '''mapDataSets'''
| List of filenames (each with matching [[MCD]]/[[Image Formats#PCK|PCK/TAB]] files) that contain the tiles of this terrain.
| -
|-
| '''mapBlocks'''
| List of map blocks (see below) that are used for generating a map.
| -
|-
| '''roadTypeOdds'''
| Odds as a % of generating each type of road (E-W Road, N-S Road, Crossing) odds for crossing are: 100 - EW - NS. (obsolete with nightly > 2014-11-19)
| [0 0]
|-|-
| '''civilianTypes'''
| List of units to use as civilians for this mission.
| [MALE_CIVILIAN, FEMALE_CIVILIAN]
|-
|}

==== Map Blocks ====

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''name'''
| Filename of the [[MAPS|map]].
| ''required''
|-
| '''width'''
| Width of this map block in Battlescape grid units.
| 0
|-
| '''length'''
| Length of this map block in Battlescape grid units.
| 0
|-
| '''height'''
| Height of this map block in Battlescape grid units.
| 1
|-
| '''groups'''
| List (or single number) of groups this mapblock belongs to (used in mapscripts)
default usage:
* 0 - Default
* 1 - Landing Zone (for placing X-COM / alien craft) (used in addcraft/ufo command)
* 2 - E-W Road (for city maps) (used in addline command)
* 3 - N-S Road (for city maps) (used in addline command)
* 4 - Road Crossing (for city maps) (used in addline command)
| 0
|-
| '''items'''
| An array of items to add to this mapblock, an the positions to place them at.
| -1
|}

* '''hemisphere''' only applies to UFO missions, not Terror ones.
*'''width/length''' defines the size of the map
** be aware that the mapview "width"-label is the openxcom ruleset length parameter
** be aware that the mapview "length"-label is the openxcom ruleset width parameter

==== Guidelines/Tips ====
* All maps with an XCOM/Alien craft require at least one map block assigned to Group 1. This map block can only contain ground tiles (no walls or objects), otherwise the game will crash or the walls/objects will be removed.
* All Terror terrains (listed under STR_TERROR_MISSION) require the Groups of '''Types''' 2, 3 and 4 (for a total of 3 maps, which are required to place roads).

=== Map Scripts ===

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| name of the script
| ''required''
|-
| '''commands'''
| List of MapCommands
| -
|}

==== Map Command ====

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| Currently these commands are implemented:
* addBlock
* addLine
* addCraft
* addUFO
* digTunnel
* fillArea
* checkBlock
* removeBlock
* resize
depending on the command type some of the following parameters are needed
| ''required''
|-
| '''label'''
| A numeric label that can be used for conditional execution of commands.
Each label should be unique within the terrain list (0=default no need for uniqueness).
| 0
|-
| '''conditionals'''
| Defines the conditions that allows the execution of this command.
eg. [1, -4] means it will be executed if command with label 1 was a success and command with label 4 failed.
commands that are not yet executed are always in failed state.
| 0
|-
| '''executionChances'''
| the chance that this command will be executed (or fails)
| 100
|-
| '''executions'''
| this command will be executed multiple times with a value > 1
| 1
|-
| '''groups'''
| Defines the what mapblock are used within this command. Can be list of goups or a single number.
| 0
|-
| '''blocks'''
| Alternative to groups. Here we define a list of mapblocks that are used within this command.
| 0
|-
| '''rects'''
| A list of possible ranges where (random) placement/checks/removal can happen in a map.
Is a list of a list of four integers.
| ?
|-
| '''size'''
| size of mapblocks that can be placed/checked/removed within rects. Also used for resize command type.
| ?
|-
| '''freqs'''
| For a list of mapblocks (defined by blocks?) we can define distribution frequency here.
| 1
|-
| '''maxUses'''
| For a list of mapblocks (defined by blocks?) we can define the maximal amount a mapblock can be used here.
| -1
|-
| '''direction'''
| used for addLine command type. Values are both, horizontal or vertical. Typically defines the road type distribution.
| -1
|-
| '''tunnelData'''
| Parameter for digTunnel command type. Contains level (default: 0) and a list of MCD replacement rules (MCDReplacements)
| 0
|}

==== Guidelines/Tips ====
* The Mapscript is still somewhat in development

=== Armor ===

Defines a Battlescape unit's [[armor]] as well as visual representation (so every unit has an armor), listed in ''"armors:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the armor name.
| ''required''
|-
| '''spriteSheet'''
| Sprite sheet from [[UNITS]] used to draw a unit wearing this armor.
| -
|-
| '''spriteInv'''
| Sprite used for the [[Inventory Backgrounds]] of a unit wearing this armor.
| -
|-
| '''corpseBattle'''
| List of string IDs of the corpse [[#Items|items]] generated when a unit wearing this armor is killed (one per unit tile) on the Battlescape.
| -
|-
| '''corpseGeo'''
| String ID of the corpse [[#Items|item]] associated with this unit on the Geoscape.
| -
|-
| '''storeItem'''
| String ID of the [[#Items|item]] that represents this armor in [[Base Stores]] for equipping.
| -
|-
| '''weight'''
| Physical weight of the armor when worn
| 6
|-
| '''stats'''
| like soldier stats (see below) but these are treated as stat bonuses for wearing the specific armor.
| -
|-
| '''frontArmor'''
| Protection provided on the front of the unit.
| 0
|-
| '''sideArmor'''
| Protection provided on the sides of the unit.
| 0
|-
| '''rearArmor'''
| Protection provided on the rear of the unit.
| 0
|-
| '''underArmor'''
| Protection provided under the unit (eg. from explosions).
| 0
|-
| '''drawingRoutine'''
| Drawing routine used to put together the body parts in the unit's '''spriteSheet''':
* 0 = [[Soldier]], [[Sectoid]]
* 1 = [[Floater]]
* 2 = [[HWP]]
* 3 = [[Cyberdisk]]
* 4 = [[Civilian]], [[Ethereal]]
* 5 = [[Sectopod]], [[Reaper]]
* 6 = [[Snakeman]]
* 7 = [[Chryssalid]]
* 8 = [[Silacoid]]
* 9 = [[Celatid]]
* 10 = [[Muton]]
* 11 = [[Submersible Weapons Systems]]
* 12 = [[Hallucinoid]]
* 13 = [[Aquanauts]]
* 14 = [[Calcinite]], [[Deep One]], [[Gillman]], [[Lobster Man]], [[Tasoth]]
* 15 = [[Aquatoid]]
* 16 = [[Bio-Drone]]
| 0
|-
| '''movementType'''
| Type of movement provided by this armor:
* 0 = Walking
* 1 = Flying
* 2 = Sliding (no walking animation)
it also defines the body of an tank (32-images) in your spriteSheet or the change in sprites while flying using a flying armour see: [[TANKS.PCK]], [[XCOM_2.PCK]]
| 0
|-
| '''damageModifier'''
| List of decimal damage modifiers (1.0 = 100%) this armor applies to each damage type (see [[#Items|Items section]]) received. Modifiers must be specified for all damage types, in this order:
* None
* Armor Piercing
* Incendiary
* High Explosive
* Laser
* Plasma
* Stun
* Melee
* Acid
* Smoke
|
- 1.0 
- 1.0 
- 1.0 
- 1.0 
- 1.0 
- 1.0 
- 1.0 
- 1.0 
- 1.0 
- 1.0
|-
| '''size'''
| Size of the unit wearing this armor, in Battlescape grid units. Every unit is square, so a size of 2 means 2x2.
| 1
|-
| '''loftempsSet'''
| List of [[LOFTEMPS]] IDs (one per unit tile, so a 1x1 unit has 1, a 2x2 unit has 4, etc.) used to represent a unit wearing this armor in 3D space.
| -
|-
| '''loftemps'''
| loftemps is a deprecated option that only works for 1x1 sized units.
| -
|-
| '''forcedTorso'''
| soldier sprites have female and male torsos. some armours reuse these sprites for flying/non flying torso without difference between genders. This can be controlled by the parameter: 0 = use genderrelated torso, 1 = use male torso, 2 = use female torso
| 0

|}

=== Player Units (Soldiers) ===

Defines a [[soldier]] recruited by X-COM, listed in ''"soldiers:"''. Currently only one soldier unit type (''XCOM'') is supported.

Unit stats are represented as follows:
* [[Time Units|tu]]
* [[Energy|stamina]]
* [[Health|health]]
* [[Bravery|bravery]] (always a multiple of 10)
* [[Reactions|reactions]]
* [[Firing Accuracy|firing]]
* [[Throwing Accuracy|throwing]]
* [[Strength|strength]]
* [[Psi Strength|psiStrength]]
* [[Psi Skill|psiSkill]]
* [[Melee Accuracy|melee]] (not visible)

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the soldier name.
| ''required''
|-
| '''minStats'''
| Minimum values used to generate the soldier's [[Starting Stats]]. In this case, ''psiSkill'' is treated as the initial stat (not generated).
| -
|-
| '''maxStats'''
| Maximum values used to generate the soldier's [[Starting Stats]]. In this case, ''psiSkill'' is treated as the minimum value for the first month of psi training (actual value is 100%-150%).
| -
|-
| '''statCaps'''
| Maximum stats this soldier can gain through [[Experience]]. '''NOTE:''' A stat will still go over the limit once, and then will no longer increase (see [[Experience#Regarding Caps|Regarding Caps]]).
| -
|-
| '''armor'''
| String ID of the [[#Armor|armor]] this soldier uses by default.
| -
|-
| '''standHeight'''
| Height of this soldier when standing.
| 0
|-
| '''kneelHeight'''
| Height of this soldier when kneeling.
| 0
|-
| '''floatHeight'''
| Distance between the bottom of this unit and the ground.
| 0
|-
| '''femaleFrequency'''
| The probability that a female soldier is hired.
| 50
|}

=== AI Units (Aliens/Civilians) ===

Defines an [[Alien Life Forms|alien]] (enemy) or [[civilian]] (neutral) unit, listed in ''"units:"''. Every different alien rank is a different unit, since they have completely different stats. Unit stats are represented as follows:
* [[Time Units|tu]]
* [[Energy|stamina]]
* [[Health|health]]
* [[Bravery|bravery]] (always a multiple of 10)
* [[Reactions|reactions]]
* [[Firing Accuracy|firing]]
* [[Throwing Accuracy|throwing]]
* [[Strength|strength]]
* [[Psi Strength|psiStrength]]
* [[Psi Skill|psiSkill]]
* [[Melee Accuracy|melee]] (not visible)

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the unit name.
| ''required''
|-
| '''race'''
| String ID of the unit race (for alien units).
| -
|-
| '''rank'''
| String ID of the unit rank (for alien units).
| -
|-
| '''stats'''
| Battlescape stats of this unit.
| -
|-
| '''armor'''
| String ID of the [[#Armor|armor]] this unit uses by default.
| -
|-
| '''standHeight'''
| Height of this unit when standing.
| 0
|-
| '''floatHeight'''
| Distance between the bottom of this unit and the ground.
| 0
|-
| '''value'''
| [[Score]] this unit is worth.
| 0
|-
| '''deathSound'''
| Sound ID from [[#Extra_Sounds|BATTLE.CAT]] played when this unit dies.
| -1
|-
| '''aggroSound'''
| Sound ID from [[#Extra_Sounds|BATTLE.CAT]] played when this unit aggros.
| -1
|-
| '''moveSound'''
| Sound ID from [[#Extra_Sounds|BATTLE.CAT]] played when this unit moves.
| -1
|-
| '''intelligence'''
| Intelligence of this unit's AI. The higher the value, the longer this unit remembers player troops between turns.
| 0
|-
| '''aggression'''
| Aggression of this unit's AI. The higher the value, the more ruthless the unit, the more likely to make a frontal assault. Less aggressive units tend to set up ambushes.
Vanilla values are:
* 0 = mostly passive
* 1 = balanced
* 2 = mostly aggresive
| 0
|-
| '''energyRecovery'''
| Energy recovered by the unit each turn (needs verification)
| 40 (?)
|-
| '''specab'''
| Special ability of this unit:
* 0 = None
* 1 = [[Cyberdisc|Explodes on Death]]
* 2 = [[Silacoid|Burns Floor]]
* 3 = [[Bio-Drone|Burns Floor and explodes on Death]]
| 0
|-
| '''spawnUnit'''
| String ID of the unit used to respawn on death (eg. [[Zombie]]s respawn as [[Chrysallid]]s).
| -
|-
| '''livingWeapon'''
| Is this unit a living weapon? (only attacks with a '''fixedWeapon''')
| false
|-
| '''female'''
| Is this unit a female? (used for TFTD civilian types)
| false
|-
|}

=== Alien Races ===

Defines a [[Alien Life Forms|race]] used in [[Alien Missions]], listed in ''"alienRaces:"''. Heavily tied with deployment data.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''id'''
| String ID of the alien race name.
| ''required''
|-
| '''members'''
| Alien crew associated with this alien race (eg. race units + terrorist units), defined by a list of unit string IDs. Order here will define rank in terms of deployment. generally speaking the order is:
* 0 - Commander
* 1 - Leader
* 2 - Engineer
* 3 - Medic
* 4 - Navigator
* 5 - Soldier
* 6 - Terrorist 1
* 7 - Terrorist 2
but of course, not all races have all ranks, so the "fill in" rank would be listed multiple times (see ethereals).
| -
|-
| '''retaliation'''
| retaliation enables/disables the race for retaliation missions.
| ''True''
|-
|}

=== Alien Deployments ===

Defines a Battlescape deployment data used in [[Alien Missions]] (such as alien and map configurations), listed in ''"alienDeployments:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the deployment name.
| ''required''
|-
| '''width'''
| Width of the Battlescape map in grid units.
| 0
|-
| '''length'''
| Length of the Battlescape map in grid units.
| 0
|-
| '''height'''
| Vertical height of the Battlescape map in grid units.
| 0
|-
| '''terrains'''
| list of string IDs of the [[#Terrains|terrain]] to choose from to generate this map. This is not used for UFO sites where the terrain comes from the Geoscape.
| -
|-
| '''shade'''
| Shade of the map (0-15, where 0 is full daytime and 15 is full nighttime). This is not used for UFO sites where the shade comes from the Geoscape.
| 0
|-
| '''nextStage'''
| String ID of the next deployment stage to use after this one, for multi-stage missions.
| -
|-
| '''race'''
| Sets the race to use in the next stage.
| ""
|-
| '''script'''
| Reference to a mapScript.
| ""
|-
| '''data'''
| List of deployment data for each alien rank on this mission (see below).
| -
|}

Notes:
* '''terrains''' can also be used with UFOs, with the game using instead the listed terrain rather than the location of the UFO on Geoscape.
==== Deployment Data ====

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''alienRank'''
| [[Alien Rank|Rank]] associated with this deployment data, as defined by the order of the race in question (see above)
| ''required''
|-
| '''lowQty'''
| Maximum quantity of aliens to spawn (beginner).
| 0
|-
| '''highQty'''
| Maximum quantity of aliens to spawn (superhuman).
| 0
|-
| '''dQty'''
| Minimum Desired Quantity of aliens to spawn.
| 0
|-
| '''extraQty'''
| spawns a random number of additional aliens.
| 0
|-
| '''percentageOutsideUfo'''
| Percentage (0-100%) of aliens to spawn outside in UFO sites.
| 0
|-
| '''itemSets'''
| Three lists (one for each alien technology level) of [[#Items|items]] (string IDs) for the aliens to equip.
| ''required''
|-
|}

=== Research ===

Defines a [[Research|research topic]] that X-COM scientists can investigate, listed in ''"research:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''name'''
| String ID of the research project's name (or item, if a '''lookup''' is defined).
| ''required''
|-
| '''lookup'''
| String ID of the research project's display name and UFOPaedia article reference.
| -
|-
| '''cost'''
| Number of man hours (on average) required to complete this project.
| 0
|-
| '''points'''
| [[Score]] earned for completing this project.
| 0
|-
| '''needItem'''
| Does this project require an [[#Items|item]] of the same name?
| false
|-
| '''dependencies'''
| List of research projects that can unlock access to this one. If the full list is researched, or if one of the projects on the list "unlocks" this one, it becomes available.
| -
|-
| '''unlocks'''
| List of research projects unlocked, regardless of other dependencies, but not requirements, by completing this project (for example, any live alien unlocks "alien origins").
| -
|-
| '''requires'''
| List of research projects unilaterally required before this project can be unlocked (for example, "the martian solution" will not even be considered for unlocking until AFTER "alien origins" is completed).
| -
|-
| '''getOneFree'''
| List of "bonus" research projects that may be granted when completing this project (for example, alien medics will give you information on other alien races). Only applies to living aliens.
| -
|-
|}

=== Manufacture ===

Defines a [[Manufacture|manufacture project]] that X-COM engineers can produce, listed in ''"manufacture:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''name'''
| String ID of the manufacturing project's name (and the item it produces).
| ''required''
|-
| '''category'''
| String ID of the manufacturing project's category.
| -
|-
| '''requires'''
| List of [[#Research|topics]] (string IDs) that must be researched to unlock this project. If none are specified, this project is unlocked from the start.
| -
|-
| '''space'''
| Amount of [[Workshop]] space required to begin this project.
| 0
|-
| '''time'''
| Number of man hours (on average) required per item.
| 0
|-
| '''cost'''
| Monetary deduction per item manufactured.
| 0
|-
| '''requiredItems'''
| List of [[#Items|items]] required and consumed per item manufactured.
| -
|-
| '''producedItems'''
| List of [[#Items|items]] produced per each item consumed. If not specified, defaults to 1 item with the same string ID as the manufacture.
| 1
|-
|}

=== UFOpaedia Article ===

Defines an article in the in-game [[UFOpaedia]], listed in ''"ufopaedia:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''id'''
| String ID of the article name. This must match the ID of the object associated with this article, if applicable.
| ''required''
|-
| '''title'''
| String ID of the article title. If omitted, the '''id''' is used.
| -
|-
| '''type_id'''
| Type of this article:
* 0 = Unknown
* 1 = [[Craft]]
* 2 = [[Craft Armaments]]
* 3 = [[HWP]]
* 4 = [[Equipment (EU)|Equipment]]
* 5 = [[Armour]]
* 6 = [[Base Facilities]]
* 7 = Text & Image (eg. [[Alien Life Forms]], [[UFO Components]])
* 8 = Text (eg. [[Alien Research]])
* 9 = [[UFO]]
* 10 = [[TFTD]]
* 11 = TFTD [[Subs]]
* 12 = TFTD [[Sub_Armaments]]
* 13 = TFTD [[Submersible_Weapons_Systems]]
* 14 = TFTD [[Equipment_(TFTD)]]
* 15 = TFTD Armour
* 16 = TFTD [[Base_Facilities_(TFTD)]]
* 17 = TFTD [[Alien_Subs]]
| 0
|-
| '''section'''
| String ID of the UFOpaedia section this article belongs in.
| -
|-
| '''requires'''
| List of [[#Research|topics]] (string IDs) that must be researched to unlock this article. If none are specified, this article is unlocked from the start.
| -
|-
| '''image_id'''
| Filename of the [[UP001.SPK-UP042.SPK|background image]] displayed on this article, if applicable.
| -
|-
| '''text'''
| String ID of the description displayed on this article.
| -
|-
| '''text_width'''
| Maximum width of the text displayed, only applicable to ''Text & Image'' articles.
| 150
|-
| '''rect_stats'''
| Rectangle ('''x''', '''y''', '''width''', '''height''') of the stats text on the screen, only applicable to ''Craft'' articles.
| 0
|-
| '''rect_text'''
| Rectangle ('''x''', '''y''', '''width''', '''height''') of the description text on the screen, only applicable to ''Craft'' articles.
| 0
|-
| '''weapon'''
| String ID of the weapon, only applicable to ''HWP'' articles.
| -
|}

=== UFO Trajectories ===

Defines a trajectory carried out by an UFO during an [[#Alien Missions|alien mission]], listed in ''"ufoTrajectories:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''id'''
| String ID of the trajectory name.
| ''required''
|-
| '''groundTimer'''
| Amount of seconds for the UFO to spend on Ground waypoints.
| 0
|-
| '''waypoints'''
| List of waypoints for the UFO to traverse, defined as ''[zone, altitude, speed]''. 
'''zone''': Globe zone where the waypoint is located. 
'''altitude''': UFO altitude after reaching this waypoint:
* 0 - Ground
* 1 - Very Low
* 2 - Low
* 3 - High
* 4 - Very High
'''speed''': UFO speed after reaching this waypoint, as a percentage (0-100%) of its maximum speed.
| -
|}

=== Alien Missions ===

Defines an [[Alien Missions|alien mission]] carried out by UFOs on the Geoscape, listed in ''"alienMissions:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the mission type.
| ''required''
|-
| '''points'''
| [[Score]] allocated to aliens for successfully completing this mission.
| 0
|-
| '''raceWeights'''
| List of alien races likely to carry out this mission, and the % chance of them being allocated to this mission, listed by "number of months after game beginning".
| ''required''
|-
| '''waves'''
| List of UFO waves to spawn as this mission progresses, as described below.
| ''required''
|}

==== Waves ====

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''ufo'''
| String ID of the [[#UFOs|UFO]] to spawn.
| ''required''
|-
| '''count'''
| Number of UFOs to spawn.
| 0
|-
| '''trajectory'''
| String ID of the [[#UFO Trajectories|trajectory]] for this UFO to use when entering Earth's atmosphere.
| ''required''
|-
| '''timer'''
| How long after the previous wave should this wave arrive? (in seconds)
| 0
|-
|}

=== Alien Item Levels ===

This is a list of item level probabilities, with a number between 0 and 2 representing an item level from plasma pistols to heavy plasmas, as defined in the deployments, expressing a 10% probability for that item level being used.

0 = first set (plasma pistol/clip)
1 = second set (plasma rifle/clip)
2 = third set (heavy plasma/clip)

For example:
[ 2, 0, 0, 0, 0, 0, 0, 1, 1, 1 ]
would represent a 60% chance for pistols, 30% rifles, and 10% heavy weapons. 
Note that the order does not matter, but the length DOES. each line MUST have 10 digits.

The above can be confusing. There are 10 fields; each number represents 10%. 
There are six instances of '0'. 6x10% = 60% chance of plasma pistol 
There are three instances of '1'. 3x10% = 30% chance of plasma rifle 
There is only one instance of '2'. 1x10% = 10% chance of heavy plasma 

Each line represents a month after the beginning of the game, and there is no limit to the number defined. 
OpenXCom will use the most recently available item level in the event the game goes on forever.

=== Extra Sprites ===

Adds or replaces sprites in an existing [[Image Formats|X-COM image file]], listed in ''"extraSprites:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| Filename of the original/new image to modify.
| ''required''
|-
| '''width'''
'''height'''
| Size of the sprite(s) in pixels.
| 0
0
|-
| '''singleImage'''
| Is the image file just a single sprite (true) or a spritesheet (false)?
| false
|-
| '''subX'''
'''subY'''
| Size of the subdivision in pixels. If a subdivision is specified, then the image file is divided into chunks to form the sprites (eg. spritesheets).
| 0
0
|-
| '''files'''
| List of the new sprites to add/replace, listed as ''spriteID: filename''.
| -
|}

Example:
- type: GIANTBUNNY.PCK
width: 32
height: 40
files:
0: Resources/Bunny/Bunny00.png
1: Resources/Bunny/Bunny01.bmp
2: Resources/Bunny/Bunny02.gif

=== Extra Sounds ===

Adds or replaces sounds in an existing [[SOUND|X-COM sound file]], listed in ''"extraSounds:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| ID of the original sound file to modify:
* BATTLE.CAT - Battlescape sounds, corresponds to ''SOUND1.CAT'' or ''SAMPLE2.CAT'' (55 sounds).
* INTRO.CAT - Intro sounds, corresponds to ''INTRO.CAT'' or ''SAMPLE3.CAT'', probably best not to mess with these.
* GEO.CAT - Geoscape sounds, corresponds to ''SOUND2.CAT'' or ''SAMPLE.CAT'' (14 sounds).
| ''required''
|-
| '''files'''
| List of the new sounds to add/replace, listed as ''soundID: filename''.
| -
|}

Example:
- type: BATTLE.CAT
files:
55: Resources/Sounds/sample.wav

=== Extra Strings ===

Adds or replaces text strings in an existing [[Translations (OpenXcom)|OpenXcom language file]], listed in ''"extraStrings:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| Filename of the original language file to modify, sans extension.
| ''required''
|-
| '''strings'''
| List of the new strings to add/replace, listed as ''stringID: text''.
| -
|}

Example:
- type: en-US
strings:
STR_SNIPER_RIFLE: Sniper Rifle
STR_SNIPER_RIFLE_CLIP: Sniper Rifle Clip
- type: en-GB
strings:
STR_SNIPER_RIFLE: Sniper Rifle
STR_SNIPER_RIFLE_CLIP: Sniper Rifle Clip
- type: de
strings:
STR_SNIPER_RIFLE: Scharfschützengewehr
STR_SNIPER_RIFLE_CLIP: Scharfschützengewehrmunition
- type: ru
strings:
STR_SNIPER_RIFLE: Снайперская винтовка
STR_SNIPER_RIFLE_CLIP: Магазин к снайп. винтовке

=== Interfaces ===

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| ''?''
| -
|-
| '''elements'''
| ''?''
| -
|-
| '''id'''
| ''?''
| -
|-
| '''color'''
| ''?''
| -
|}

=== StatStrings ===

[[Statstrings]] are used for automatically renaming soldiers. They are case sensitive and they are processed in the order in which they are specified.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''string'''
| String to add to name.
| ''required''
|-
| '''psiStrength''' 
'''psiSkill''' 
'''bravery''' 
'''strength''' 
'''firing''' 
'''reactions''' 
'''stamina''' 
'''tu''' 
'''health''' 
'''throwing'''
| One or more stat ranges are ANDed together for success. Each range has a minVal and maxVal. Use YAML standard tilde (~) to indicate null. ((~) = 0 as minvalue; (~) =255 as maxvalue)
| -
|}

Example:
statStrings:
- string: "x"
psiStrength: [~, 30]
- string: "P"
psiStrength: [80, ~]
- string: "p"
psiStrength: [60, 79]
- string: "K"
psiSkill: [60, ~]
- string: "k"
psiSkill: [30, 59]
- string: "b"
bravery: [60, ~]
- string: "c"
bravery: [~, 10]
- string: "w"
strength: [~, 25]
- string: "Snpr"
firing: [60, ~]
reactions: [60, ~]
- string: "M"
firing: [70, ~]
- string: "m"
firing: [60, 69]
- string: "Sct"
reactions: [50, ~]
tu: [60, ~]
- string: "R"
reactions: [60, ~]
- string: "r"
reactions: [50, 59]

==References==
<references />

[[Category:OpenXcom]]

Talk:Ruleset Reference (OpenXcom)

2014-12-05T10:15:41Z

Falko: /* OpenXCom versions and ruleset changes */

I just noticed on the Xcom1Ruleset that the UBASE_07 map block has a type value of 4, which according to the table below is defined as a "Road Crossing (for city maps)". If this value is correct, shouldn't the table also include this possible use?[[User:Hobbes|Hobbes]] ([[User talk:Hobbes|talk]]) 00:37, 18 June 2014 (EDT)
:No. That was simply there to differentiate it from the rest of the map blocks.

== New terrain flags ==

Can someone please update the Terrain section? As of November 2014, old flags are no longer functional, but the new ones are unclear.--[[User:Solarius Scorch|Solarius Scorch]] ([[User talk:Solarius Scorch|talk]]) 09:11, 29 November 2014 (EST)
:Warboy should be the one updating this since I haven't been able yet to go over the new terrain generation rules but at the same time the new rules only apply to the nightly, so the info here is still useful for 1.0. [[User:Hobbes|Hobbes]] ([[User talk:Hobbes|talk]]) 10:06, 29 November 2014 (EST)
::Warboy is too busy coding. - Warboy 32nd Octembuary 12 BC
:::Just found a document he send me a while ago with comments about each rule. I'll try to update this page later on. [[User:Hobbes|Hobbes]] ([[User talk:Hobbes|talk]]) 10:16, 29 November 2014 (EST)
::::Excellent news. Please let me know if I can help.--[[User:Solarius Scorch|Solarius Scorch]] ([[User talk:Solarius Scorch|talk]]) 13:34, 1 December 2014 (EST)

==OpenXCom versions and ruleset changes==
I think we need to figure out a better way to document the changes between 1.0 and the nightlies. I've been wanting to update the terrain generation rules but I haven't come up with a solution. Adding: Obsolete with the xxx nightly, well it works, but it the function isn't obsolete completely since it still works with 1.0. Any ideas? [[User:Hobbes|Hobbes]] ([[User talk:Hobbes|talk]]) 17:49, 4 December 2014 (EST)
: Lets make a copy of the 1.0 stable version somewhere (should be in the history section) and keep this page for development--[[User:Falko|Falko]] ([[User talk:Falko|talk]]) 18:49, 4 December 2014 (EST)
::How about we keep both then and create a new [[Ruleset Reference Nightly (OpenXcom)]] page, both with links on the OpenXcom table? I only work with 1.0 at the moment (until I started working on the new Geoscape) and not being able to quickly access that info will be a pain. [[User:Hobbes|Hobbes]] ([[User talk:Hobbes|talk]]) 19:03, 4 December 2014 (EST)
:::"OpenXcom table"? sure we can make 2 pages that can be maintained independently and only referenced by this page. i also would be ok with keeping this page 1.0 and only reference the nightly on top of the page .. (even if i prefer it the other way) but the work to get it back to 1.0 is alot i even found 1.0 properties like "terrain->ufo/craftPositions" that were deleted recently but never occured here AFAIK. --[[User:Falko|Falko]] ([[User talk:Falko|talk]]) 05:15, 5 December 2014 (EST)
::::OpenXcom Table is the one displayed on the initial [[OpenXcom]] page, listing all the relevant OXC pages. [[User:Hobbes|Hobbes]] ([[User talk:Hobbes|talk]]) 19:48, 4 December 2014 (EST)

Talk:Ruleset Reference (OpenXcom)

2014-12-05T00:09:38Z

Falko: /* OpenXCom versions and ruleset changes */

I just noticed on the Xcom1Ruleset that the UBASE_07 map block has a type value of 4, which according to the table below is defined as a "Road Crossing (for city maps)". If this value is correct, shouldn't the table also include this possible use?[[User:Hobbes|Hobbes]] ([[User talk:Hobbes|talk]]) 00:37, 18 June 2014 (EDT)

== New terrain flags ==

Can someone please update the Terrain section? As of November 2014, old flags are no longer functional, but the new ones are unclear.--[[User:Solarius Scorch|Solarius Scorch]] ([[User talk:Solarius Scorch|talk]]) 09:11, 29 November 2014 (EST)
:Warboy should be the one updating this since I haven't been able yet to go over the new terrain generation rules but at the same time the new rules only apply to the nightly, so the info here is still useful for 1.0. [[User:Hobbes|Hobbes]] ([[User talk:Hobbes|talk]]) 10:06, 29 November 2014 (EST)
::Just found a document he send me a while ago with comments about each rule. I'll try to update this page later on. [[User:Hobbes|Hobbes]] ([[User talk:Hobbes|talk]]) 10:16, 29 November 2014 (EST)
:::Excellent news. Please let me know if I can help.--[[User:Solarius Scorch|Solarius Scorch]] ([[User talk:Solarius Scorch|talk]]) 13:34, 1 December 2014 (EST)

==OpenXCom versions and ruleset changes==
I think we need to figure out a better way to document the changes between 1.0 and the nightlies. I've been wanting to update the terrain generation rules but I haven't come up with a solution. Adding: Obsolete with the xxx nightly, well it works, but it the function isn't obsolete completely since it still works with 1.0. Any ideas? [[User:Hobbes|Hobbes]] ([[User talk:Hobbes|talk]]) 17:49, 4 December 2014 (EST)
: Lets make a copy of the 1.0 stable version somewhere (should be in the history section) and keep this page for development--[[User:Falko|Falko]] ([[User talk:Falko|talk]]) 18:49, 4 December 2014 (EST)
::How about we keep both then and create a new [[Ruleset Reference Nightly (OpenXcom)]] page, both with links on the OpenXcom table? I only work with 1.0 at the moment (until I started working on the new Geoscape) and not being able to quickly access that info will be a pain. [[User:Hobbes|Hobbes]] ([[User talk:Hobbes|talk]]) 19:03, 4 December 2014 (EST)
:::"OpenXcom table"? sure we can make 2 pages that can be maintained independently and only referenced by this page. i also would be ok with keeping this page 1.0 and only reference the nightly on top of the page .. (even if i prefer it the other way) but the work to get it back to 1.0 is alot i even found 1.0 properties like "terrain->ufo/craftPositions" that were deleted recently but never occured here AFAIK. ----

Talk:Ruleset Reference (OpenXcom)

2014-12-04T23:49:04Z

Falko: /* OpenXCom versions and ruleset changes */

Ruleset Reference (OpenXcom)

2014-12-04T23:40:31Z

Falko: /* AI Units (Aliens/Civilians) */

A reference of all the customizable values of everything in a [[Rulesets (OpenXcom)|ruleset]]. Some guidelines:
* If a value is omitted from the ruleset, the default is used. You cannot omit ''required'' values.
* Text strings (eg. names) are represented by string IDs from the [[Translations (OpenXcom)|language files]]
* Numerical IDs (used for sprites, sounds, etc.) start at 0, not 1.
* Boolean (yes/no) values are represented by true/false.
* World coordinates are represented in degrees (see [[WORLD.DAT]]).
* Money amounts (prices, costs, etc.) are represented in dollars.
* All paths are '''case sensitive'''! If your ruleset uses external files, make sure that they named properly as described in ruleset.

Items are ordered as they come in the ruleset. To override this, you can specify a ''listOrder''. You can find the default listOrders in [[Ruleset List Order (OpenXcom)|Ruleset List Order]].

=== Globe ===

Defines the drawing of landmasses and borders on the globe.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''data'''
| Path name of file which contains polygon and texture information. (For example WORLD.DAT).
| -
|-
| '''polygons'''
| List of polygons drawn on the globe surface. A triangle consist of seven values: the first number defines the texture, followed by three pairs of (x,y) globe coordinates. Only polygons with 3 or 4 vertices are reliable shown on the globe = 7 or 9 values per entry.
| -
|-
| '''polylines'''
| List of border lines. Each list entry consist of a list of (x,y) globe coordinates.
| -
|}

=== Countries ===

Defines one of the [[Country Funding (EU)|funding nations]], listed in ''"countries:"''. They're used for activity graphs and player scoring.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the country name.
| ''required''
|-
| '''fundingBase'''
| Country's base funding, in thousands. The starting funding can be anywhere between 1x and 2x the base funding.
| 0
|-
| '''fundingCap'''
| Country's funding cap, in thousands. Once a country reaches this maximum, it will no longer increase its funding.
| 0
|-
| '''labelLon'''
'''labelLat'''
| Longitude and latitude coordinates of the country's label on the globe. This label is only shown when the globe is zoomed in and "detail" is turned on.
| 0.0
0.0
|-
| '''areas'''
| List of "rectangles" on the globe defined as [''lon1'' ''lat1'' ''lon2'' ''lat2'']. Any activity within these areas counts towards the country's graph activity and affects their opinion of the player.
| -
|}

=== Regions ===

Defines one of the [[Geoscape (EU)#World Regions/Countries|world regions]], listed in ''"regions:"''. They're used for base placement, activity graphs and mission spawning.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the region name.
| ''required''
|-
| '''cost'''
| Amount of money spent building an X-COM base in this region (first base is free).
| 0
|-
| '''areas'''
| List of "rectangles" on the globe defined as ''[lon1, lat1, lon2, lat2]''. Any activity within these areas counts towards the region's graph activity.
| -
|-
| '''cities'''
| List of cities belonging to this region. They will be displayed on the globe and used for terror site missions. Each city is defined by their '''lon''' and '''lat''' coordinates and a '''name''' string ID.
| -
|-
| '''regionWeight'''
| Weight of this region when selecting regions for alien missions.
| 0
|-
| '''missionWeights'''
| Weighted list of the different mission types for this region (eg. ''STR_ALIEN_RESEARCH: 14'').
| -
|-
| '''missionZones'''
| List of "rectangles" (''[lon1, lat1, lon2, lat2]'') defining the mission zones for this region. Mission zones are waypoints for UFO trajectories.
| -
|-
| '''missionRegion'''
| Spawn mission in this region instead (used for regions without land).
| -
|}

=== Base Facilities ===

Defines one of the [[Base Facilities (EU)|facilities]] that can be built in an X-COM base, listed in ''"facilities:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the facility name.
| ''required''
|-
| '''requires'''
| List of [[#Research|topics]] (string IDs) that must be researched to unlock this facility. If none are specified, this facility is unlocked from the start.
| -
|-
| '''spriteShape'''
| Sprite ID from [[BASEBITS.PCK]] used to draw the facility's outer shape in the Basescape and UFOpaedia.
| -1
|-
| '''spriteFacility'''
| Sprite ID from [[BASEBITS.PCK]] used to draw the facility's contents in the Basescape and UFOpaedia. Drawn on top of '''spriteShape'''.
| -1
|-
| '''lift'''
| Is this facility an [[Access Lift]]? All base facilities must be connected to the lift.
| false
|-
| '''hyper'''
| Is this facility a [[Hyperwave Decoder]]? Displays extra information for detected UFOs. Only valid for radar facilities.
| false
|-
| '''mind'''
| Is this facility a [[Mind Shield]]? Reduces the chance of UFOs finding your base. Does not stack.
| false
|-
| '''grav'''
| Is this facility a [[Grav Shield]]? Doubles the power of your base defenses. Does not stack.
| false
|-
| '''size'''
| Size of the facility, in grid units. Every facility is square, so a size of 1 means 1x1, 2 means 2x2, etc. Bigger facilities are made up of multiple sprites, for example a 2x2 facility will use 4 sprites for '''spriteShape''' and 4 sprites for '''spriteFacility''' (top-left, top-right, bottom-left, bottom-right).
| 1
|-
| '''buildCost'''
| Amount of money spent to build this facility in the base.
| 0
|-
| '''buildTime'''
| Amount of days it takes for this facility to be built.
| 0
|-
| '''monthlyCost'''
| Amount of money spent monthly for the maintenance of this facility.
| 0
|-
| '''storage'''
| Amount of storage space (for items) this facility provides. See [[Base Stores]].
| 0
|-
| '''personnel'''
| Amount of personnel (soldiers, scientsts, engineers) these quarters can contain.
| 0
|-
| '''aliens'''
| Amount of live aliens this facility can contain. Only checked if the ''alienContainmentLimitEnforced'' option is enabled.
| 0
|-
| '''crafts'''
| Amount of X-COM craft this facility can contain.
| 0
|-
| '''labs'''
| Amount of lab space this facility provides for research projects.
| 0
|-
| '''workshops'''
| Amount of workshop space this facility provides for manufacture projects.
| 0
|-
| '''psiLabs'''
| Amount of soldier space this facility provides for psionic training.
| 0
|-
| '''radarRange'''
| Maximum radar detection range of this facility, in nautical miles.
| 0
|-
| '''radarChance'''
| Chance (0-100%) of this radar detecting a UFO that enters its range.
| 0
|-
| '''defense'''
| Offensive power provided by this base defense against attacking UFOs.
| 0
|-
| '''hitRatio'''
| Chance (0-100) of the base defense hitting an attacking UFO.
| 0
|-
| '''fireSound'''
| Sound ID from [[#Extra_Sounds|GEO.CAT]] played when the base defense fires.
| -1
|-
| '''hitSound'''
| Sound ID from [[#Extra_Sounds|GEO.CAT]] played when the base defense hits a target.
| -1
|-
| '''mapName'''
| [[MAPS|Map]] associated to this facility in Battlescape base defenses.
| -
|-
|}

=== Crafts ===

Defines one of the [[Craft|X-COM crafts]] that go on interception missions, listed in ''"crafts:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the craft name.
| ''required''
|-
| '''requires'''
| List of [[#Research|topics]] (string IDs) that must be researched to unlock this craft. If none are specified, this craft is unlocked from the start.
| -
|-
| '''sprite'''
| Sprite ID from [[BASEBITS.PCK]] used to draw this craft in the Basescape and from [[INTICON.PCK]] used to draw the damage indicator in dogfights.
modders: the corresponding extrasprite file id for BASEBITS.PCK is sprite+33 INTICON.PCK contains a minimized icon id=sprite the file id for the dogfight image is sprite+11
| -1
|-
| '''fuelMax'''
| Maximum amount of fuel this craft can carry. Crafts use up fuel based on their speed while travelling.
| 0
|-
| '''damageMax'''
| Maximum amount of damage this craft can take. If this amount is exceeded, the craft is destroyed.
| 0
|-
| '''speedMax'''
| Maximum speed in nautical miles. Crafts travel at max speed when flying and half speed when patrolling.
| 0
|-
| '''accel'''
| Aceeleration value shown in the UFOpaedia.
| 0
|-
| '''weapons'''
| Amount of craft weapons this craft can equip. The UI can only display a max of 2 weapons.
| 0
|-
| '''soldiers'''
| Amount of soldiers this craft can carry.
| 0
|-
| '''maxItems'''
| Amount of items this craft can carry.
| 80
|-
| '''vehicles'''
| Amount of vehicles this craft can carry.
| 0
|-
| '''costBuy'''
| Amount of money spent for purchasing this craft. If set to 0, the craft will not be available in the Purchase/Recruit screen.
| 0
|-
| '''costRent'''
| Amount of money spent monthly for renting this craft. If set to 0, the craft is not on rental and won't count towards base maintenance.
| 0
|-
| '''costSell'''
| Amount of money gained for selling this craft.
| 0
|-
| '''refuelItem'''
| Item required for refuelling this craft. If no item is specified, the craft uses human fuel.
| 0
|-
| '''repairRate'''
| Amount of damage restored every hour while [[Repairs|Repairing]] in base.
| 1
|-
| '''refuelRate'''
| Amount of fuel restored every 30 mins while [[Refueling]] in base. If specified, a '''refuelItem''' is spent each time.
| 1
|-
| '''radarRange'''
| Detection range of the craft's radar in nautical miles. Every craft radar has a 100% detection chance.
| 600
|-
| '''transferTime'''
| Number of hours it takes to purchase/transfer this craft to a base.
| 0
|-
| '''score'''
| [[Score]] lost when this craft is destroyed.
| 0
|-
| '''spacecraft'''
| Can this craft go to [[Cydonia]]?
| false
|-
| '''battlescapeTerrainData'''
| [[#Terrains|Terrain]] associated to this craft in Battlescape missions.
| -
|}

=== Craft Weapons ===

Defines one of the [[Craft Armaments|weapons]] equipped by X-COM craft for shooting down UFOs, listed in ''"craftWeapons:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the weapon name.
| ''required''
|-
| '''sprite'''
| Sprite ID from [[BASEBITS.PCK]] used to draw the weapon in the Basescape and from [[INTICON.PCK]] used to draw the weapon in dogfights.
modders: the corresponding extrasprites file id for INTICON.PCK is sprite+5 and sprite+48 for BASEBITS.PCK
| -1
|-
| '''sound'''
| Sound ID from [[#Extra_Sounds|GEO.CAT]] played when this weapon fires.
| -1
|-
| '''damage'''
| Amount of damage this weapon does to enemy UFOs.
| 0
|-
| '''range'''
| Maximum range of this weapon in dogfights (in meters).
| 0
|-
| '''accuracy'''
| Chance (0-100%) of each shot hitting the enemy UFO.
| 0
|-
| '''reloadCautious'''
| Time this weapon takes to fire between each shot in ''Cautious Mode''.
| 0
|-
| '''reloadStandard'''
| Time this weapon takes to fire between each shot in ''Standard Mode''.
| 0
|-
| '''reloadAggressive'''
| Time this weapon takes to fire between each shot in ''Aggressive Mode''.
| 0
|-
| '''ammoMax'''
| Maximum amount of ammo this weapon can carry.
| 0
|-
| '''rearmRate'''
| Amount of ammo restored every 30 mins while the craft is [[Rearming]] in base. If specified, '''clip'''s are spent depending on their '''clipSize'''. If the '''clipSize''' of the specified ammo is 0, no '''clip'''s are spent.
| 1
|-
| '''projectileType'''
| Type of the weapon projectile, used for the projectile sprite in dogfights:
* 0 - [[Stingray]]
* 1 - [[Avalanche]]
* 2 - [[Cannon]]
* 3 - [[Fusion Ball]]
* 4 - [[Laser Cannon]]
* 5 - [[Plasma Beam]]
| 2
|-
| '''projectileSpeed'''
| Speed of the weapon projectile in dogfights.
| 0
|-
| '''launcher'''
| String ID of the [[#Items|item]] required to equip this weapon.
| -
|-
| '''clip'''
| String ID of the [[#Items|item]] required to rearm this weapon.
| -
|}

=== Items ===

Defines the Geoscape and Battlescape properties of an [[Equipment (EU)|item]] that can be stored in X-COM bases, listed in ''"items:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the internal item name.
| ''required''
|-
| '''name'''
| String ID of the displayed item name, for cases where it's different from the internal name. If omitted, '''type''' is used.
| -
|-
| '''requires'''
| List of [[#Research|topics]] (string IDs) that must be researched to unlock this item. If none are specified, this item is unlocked from the start. Soldiers can only use unlocked items in the Battlescape.
| -
|-
| '''size'''
| Space occupied by this item in [[Base Stores]]. Can be a decimal value.
| 0.0
|-
| '''costBuy'''
| Amount of money spent for purchasing this item. If set to 0, this item will not be available in the Purchase/Recruit screen.
| 0
|-
| '''costSell'''
| Amount of money gained for selling this item.
| 0
|-
| '''transferTime'''
| Number of hours it takes to purchase/transfer this item to a base.
| 24
|-
| '''weight'''
| [[Item_Weight|Weight]] occupied by this item in a soldier's inventory.
| 999
|-
| '''bigSprite'''
| Sprite ID from [[BIGOBS.PCK]] used to draw this item in a soldier's inventory and UFOpaedia.
| -1
|-
| '''floorSprite'''
| Sprite ID from [[FLOOROB.PCK]] used to draw this item on the floor of a Battlescape tile.
| -1
|-
| '''handSprite'''
| Sprite ID from [[HANDOB.PCK]] used to draw this item on a soldier's hand in the Battlescape.
modders: each handobject needs 8 images (8 directions) define the extrasprites accordingly
| 120
|-
| '''bulletSprite'''
| Sprite ID from ''BulletSprites.png'' used to draw this weapon's projectile on the Battlescape:
* 0 - [[Rocket Launcher]]
* 1 - [[Pistol]]
* 2 - [[Rifle]]
* 3 - [[Auto Cannon]]
* 4 - [[Heavy Cannon]]
* 5 - [[Laser Pistol]]
* 6 - [[Laser Rifle]]
* 7 - [[Heavy Laser]]
* 8 - [[Plasma Rifle|Plasma]]
* 9 - [[Small Launcher]]
* 10 - [[Blaster Launcher]]
for modders: the bulletsprite needs to be put into the extraSprites type "Projectiles" the bulletsprite can contain up to 35 3x3 images. The corresponding file id is 35*[bulletSprite]
| -1
|-
| '''fireSound'''
| Sound ID from [[#Extra_Sounds|BATTLE.CAT]] played when this weapon fires.
| -1
|-
| '''hitSound'''
| Sound ID from [[#Extra_Sounds|BATTLE.CAT]] played when this weapon hits a target.
| -1
|-
| '''hitAnimation'''
| Sprite ID from [[SMOKE.PCK]] used to draw the weapon's "hit explosion".
'''NOTE''': Do not define this value for melee/psi weapons, they use [[HIT.PCK]] and therefore meleeAnimation instead.
| 0
|-
| '''power'''
| Average damage of the weapon, in most cases it will be +-50% this value.
| 0
|-
| '''strengthApplied'''
| Add the attacking unit's strength to this weapon's damage.
| false
|-
| '''compatibleAmmo'''
| List of string IDs of the ammo items that can be loaded on this weapon. If none are specified, the weapon doesn't need ammo.
| -
|-
| '''damageType'''
| What type of [[damage]] does this weapon do:
* 0 - None
* 1 - Armor Piercing
* 2 - Incendiary
* 3 - High Explosive
* 4 - Laser
* 5 - Plasma
* 6 - Stun
* 7 - Melee
* 8 - Acid
* 9 - Smoke
'''NOTE:''' A damage type other than 0-9 will do nothing.
| 0
|-
| '''tuAuto'''
'''accuracyAuto'''
| The percentage (0-100%) of [[Time Units]] (from the soldier's total) required to fire an Auto Shot. If 0, the weapon does not have an Auto Shot.
The base accuracy (0-100%) applied to a soldier's [[Firing Accuracy]] when firing an Auto Shot.
| 0
0
|-
| '''tuSnap'''
'''accuracySnap'''
| The percentage (0-100%) of [[Time Units]] (from the soldier's total) required to fire a Snap Shot. If 0, the weapon does not have a Snap Shot.
The base accuracy (0-100%) applied to a soldier's [[Firing Accuracy]] when firing a Snap Shot.
| 0
0
|-
| '''tuAimed'''
'''accuracyAimed'''
| The percentage (0-100%) of [[Time Units]] (from the soldier's total) required to fire an Aimed Shot. If 0, the weapon does not have an Aimed Shot.
The base accuracy (0-100%) applied to a soldier's [[Firing Accuracy]] when firing an Aimed Shot.
| 0
0
|-
|-
| '''tuMelee'''
'''accuracyMelee'''
| The percentage (0-100%) of [[Time Units]] (from the soldier's total) required to do a melee attack (Hit). If 0, the weapon does not have a melee attack.
The base accuracy (0-100%) applied to a soldier's [[Melee Accuracy]] when doing a melee attack.
| 0
0
|-
| '''clipSize'''
| The amount of ammo stored in each weapon clip. If -1 is specified, this weapon has infinite ammo.
| 0
|-
| '''battleType'''
| Defines the weapon's behavior in the Battlescape:
* 0 - None (Geoscape-only item)
* 1 - [[Weapons|Firearm]]
* 2 - Ammo
* 3 - Melee
* 4 - [[Grenade]]
* 5 - [[Proximity Grenade]]
* 6 - [[Medi-Kit (EU)|Medi-Kit]]
* 7 - [[Motion Scanner]]
* 8 - [[Mind Probe]]
* 9 - [[Psi-Amp]]
* 10 - [[Electro-flare]]
* 11 - Corpse
| 0
|-
| '''twoHanded'''
| Is this weapon two-handed? If true, incurs an accuracy penalty if used with both hands occupied. Note that the handsprite of a twoHanded item is also drawn at a slightly different position than a one handed item.
| false
|-
| '''waypoint'''
| Does this weapon use waypoints? (eg. [[Blaster Launcher]]). Can also be used to make ammo items use the waypoint system.
| false
|-
| '''fixedWeapon'''
| Is this weapon fixed? (it's part of a unit, eg. tanks and terrorist units)
| false
|-
| '''invWidth'''
| Item width in a soldier's inventory (in grid units).
| 1
|-
| '''invHeight'''
| Item height in a soldier's inventory (in grid units).
| 1
|-
| '''painKiller'''
| Amount of painkillers contained in a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''heal'''
| Amount of heal's contained in a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''stimulant'''
| Amount of stimulants contained in a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''woundRecovery'''
| Amount of [[Fatal Wounds]] treated by each heal of a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''healthRecovery'''
| Amount of [[Health]] recovered by each heal of a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''stunRecovery'''
| Amount of [[Stun]] removed by each stimulant of a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''energyRecovery'''
| Amount of [[Energy]] recovered by each stimulant of a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''tuUse'''
| Amount of [[Time Units]] required to use this item (for non-offensive items). It's a flat rate if '''flatRate''' is true, otherwise it's a percentage (0-100%).
| 0
|-
| '''recoveryPoints'''
| [[Score]] gained for recovering this alien artifact.
| 0
|-
| '''armor'''
| How much damage is needed to destroy this item on the ground.
| 20
|-
| '''recover'''
| Is this item recoverable? (gets transported to the X-COM base on mission success)
| true
|-
| '''turretType'''
| Sprite ID from [[TANKS.PCK]] of the turret to assign to this tank:
* 0 - [[Tank/Cannon]]
* 1 - [[Tank/Rocket Launcher]]
* 2 - [[Tank/Laser Cannon]]
* 3 - [[Hovertank/Plasma]]
* 4 - [[Hovertank/Launcher]]
| -1
|-
| '''liveAlien'''
| Does this item represent a live alien? (counts towards [[Alien Containment]])
| false
|-
| '''blastRadius'''
| Size of the projectile explosions. 0 for no explosion. -1 to automatically calculate based on weapon power and damage type (actual '''blastRadius''' currently is capped due [[Explosions#Playing_With_Fire|Explosion calculations]]).
| -1
|-
| '''flatRate'''
| If true, then TU costs for this weapon are a flat rate (instead of a percentage of unit TUs).
| false
|-
| '''arcingShot'''
| Does this weapon fire in an arc?
| false
|-
| '''attraction'''
| Represents how likely an alien is to pick up this item. Values below 5 will be ignored (by design).
| 0
|-
| '''maxRange'''
| Maximum range at which this weapon can operate.
| 200
|-
| '''aimRange'''
| Maximum effective range with this weapon before which range-based dropoff occurs.
| 200
|-
| '''snapRange'''
| Maximum effective range with snap shot before which range-based dropoff occurs. (ufoextender accuracy only)
| 15
|-
| '''autoRange'''
| Maximum effective range with auto shot before which range-based dropoff occurs. (ufoextender accuracy only)
| 7
|-
| '''minRange'''
| Range-based dropoff will work in reverse for ranges below this.
| 0
|-
| '''dropoff'''
| The value by which the accuracy lowers for each tile after (or before) the thresholds above.
| 2
|-
| '''bulletSpeed'''
| How much faster (or slower, if you use a negative number) is a projectile fired from this weapon compared to the average.
| 0
|-
| '''autoShots'''
| How many auto shots does this weapon fire.
| 3
|-
| '''shotgunPellets'''
| Number of projectiles fired per unit of ammunition. (note: due to engine limitations it is currently impossible to draw multiple projectiles in flight.)
| 0
|-
| '''zombieUnit'''
| String ID of the unit used for zombification (eg. [[Chrysallid]]s turn units into [[Zombie]]s).
| none
|-
| '''meleeSound'''
| Sound ID from [[#Extra_Sounds|BATTLE.CAT]] played when this weapon attacks a target with melee.
| 39
|-
| '''meleeHitSound'''
| Sound ID from [[#Extra_Sounds|BATTLE.CAT]] played when this weapon HITS a target with melee.
| -1
|-
| '''meleeAnimation'''
| Sprite ID from HIT.PCK played when this weapon attacks a target with melee.
| 0
|-
| '''meleePower'''
| Damage this weapon will do when using melee. This only applies to Firearms, and is only available as stun damage. For normal melee weapons, use regular power and damage types.
| 0
|-
| '''LOSRequired'''
| Does this item require line of sight? (only applies to mind probes and psi-amps)
| false
|-
| '''skillApplied'''
| Is melee skill applied to the accuracy of an attack made with this object?
| true
|-
|}

=== UFOs ===

Defines one of the [[UFOs]] that invade Earth, listed in ''"ufos:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the UFO name.
| ''required''
|-
| '''size'''
| String ID of the UFO size.
| STR_VERY_SMALL
|-
| '''sprite'''
| Sprite ID from [[INTERWIN.DAT]] used to draw this UFO in the dogfight view and UFOpaedia.
don't try to add more images if you don't want to punch yourself in the face - use modsprite
| -1
|-
| '''modSprite'''
| Filename used to draw this UFO in the dogfight view and UFOpaedia.
| -
|-
| '''damageMax'''
| Maximum amount of damage this UFO can take. If the UFO takes 50% damage, it crash lands. If it takes 100% damage, it is destroyed.
| 0
|-
| '''speedMax'''
| Maximum speed in nautical miles.
| 0
|-
| '''accel'''
| Aceeleration value shown in the UFOpaedia.
| 0
|-
| '''power'''
| Damage power of this UFO's weapon in dogfights.
| 0
|-
| '''range'''
| Maximum range of this UFO's weapon in dogfights (in meters).
| 0
|-
| '''score'''
| [[Score]] gained when this UFO is destroyed, or half this score if it crash lands.
| 0
|-
| '''reload'''
| Time the UFO's weapon takes to fire between each shot.
| 0
|-
| '''breakOffTime'''
| Minimum amount of time for the UFO to be able to break off of a dogfight.
| 0
|-
| '''battlescapeTerrainData'''
| [[#Terrains|Terrain]] associated to this UFO in Battlescape missions.
| ''required''
|-
|}

=== Inventory Sections ===

Defines one of the sections of the [[Inventory TU Table|Battlescape inventory]] (eg. Backpack), listed in ''"invs:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the inventory name.
| ''required''
|-
| '''x'''
'''y'''
| Pixel coordinates of this section on the inventory screen.
| 0
0
|-
| '''type'''
| Type of this section:
* 0 = Slot section, can contain as many items as will fit on the slots.
* 1 = Hand section, can only contain one item regardless of size.
* 2 = Ground section, can contain infinite items.
| 0
|-
| '''slots'''
| List of the grid slots (''[x, y]'') that this section is composed of. For example, to make a 2x2 section, you would have ''[0, 0] [0, 1] [1, 0] [1, 1]''.
| -
|-
| '''costs'''
| List of [[Time Units]] costs to move an item from this section to another one (eg. ''STR_BACKPACK: 16'' means it will cost 16 TUs to move an item from this section to the Backpack).
| -
|-
|}

=== Terrains ===

Defines one of the [[TERRAIN|terrains]] used to generate a Battlescape map, listed in "terrains:".

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''name'''
| String ID of the terrain name.
| ''required''
|-
| '''largeBlockLimit'''
| Maximum amount of large blocks that can be used on map generation. (obsolete with nightly > 2014-11-19)
| 0
|-
| '''textures'''
| List of [[TEXTURE.DAT|Geoscape textures]] that correspond to this terrain.
| -
|-
| '''hemisphere'''
| Geoscape hemisphere associated with this terrain:
* -1 - Northern hemisphere.
* 0 - Both hemispheres.
* 1 - Southern hemisphere.
| 0
|-
| '''mapDataSets'''
| List of filenames (each with matching [[MCD]]/[[Image Formats#PCK|PCK/TAB]] files) that contain the tiles of this terrain.
| -
|-
| '''mapBlocks'''
| List of map blocks (see below) that are used for generating a map.
| -
|-
| '''roadTypeOdds'''
| Odds as a % of generating each type of road (E-W Road, N-S Road, Crossing) odds for crossing are: 100 - EW - NS. (obsolete with nightly > 2014-11-19)
| [0 0]
|-|-
| '''civilianTypes'''
| List of units to use as civilians for this mission.
| [MALE_CIVILIAN, FEMALE_CIVILIAN]
|-
|}

==== Map Blocks ====

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''name'''
| Filename of the [[MAPS|map]].
| ''required''
|-
| '''width'''
| Width of this map block in Battlescape grid units.
| 0
|-
| '''length'''
| Length of this map block in Battlescape grid units.
| 0
|-
| '''height'''
| Height of this map block in Battlescape grid units.
| 1
|-
| '''type'''
| Type of this map block:
(obsolete with nightly > 2014-11-19)
* -1 - Undefined
* 0 - Default
* 1 - Landing Zone (for placing X-COM / alien craft)
* 2 - E-W Road (for city maps)
* 3 - N-S Road (for city maps)
* 4 - Road Crossing (for city maps)
* 5 - Dirt (for filling empty base blocks)
* 6 - X-COM spawn point (for [[Alien Base]] / [[Cydonia]] missions)
* 7 - [[Alien Base]] Target
* 8 - [[Cydonia]] Target
| -1
|-
| '''subType'''
| Sub-type of this map block (see '''type'''). (obsolete with nightly > 2014-11-19)
| -1
|-
| '''frequency'''
| Frequency of this block in a map. (obsolete with nightly > 2014-11-19)
| 1
|-
| '''maxCount'''
| Maximum amount of times this block can be used in a map. If -1 there is no limit. (obsolete with nightly > 2014-11-19)
| -1
|-
| '''groups'''
| List (or single number) of groups this mapblock belongs to (used in mapscripts)
default usage:
* 0 - Default
* 1 - Landing Zone (for placing X-COM / alien craft) (used in addcraft/ufo command)
* 2 - E-W Road (for city maps) (used in addline command)
* 3 - N-S Road (for city maps) (used in addline command)
* 4 - Road Crossing (for city maps) (used in addline command)
| 0
|-
| '''items'''
| An array of items to add to this mapblock, an the positions to place them at.
| -1
|}

*'''frequency''' defines the odds of the map appearing on the map
** The value assigned (default: 1) is used in ''x/n'', which defines the probability of being chosen.
** ''x'' is the integer defined for the map block's frequency and ''n'' is the combined total of probabilities for all the map types combined.
** This property can only be used in type 0 map blocks.
*'''maxCount''' is the maximum number of times it can be used.
** The value assigned is also used in ''x/n'' to determine the probability of being chosen.
** Each use reduces ''x'' by -1, with the caveat that being used as a Landing Zone type will not reduce the x value since it could result in no available Landing Zones.
** This property can only be used in type 0 map blocks.
* '''hemisphere''' only applies to UFO missions, not Terror ones.
*'''width/length''' defines the size of the map
** be aware that the mapview "width"-label is the openxcom ruleset length parameter
** be aware that the mapview "length"-label is the openxcom ruleset width parameter

==== Guidelines/Tips ====
* All maps with an XCOM/Alien craft require at least one type 1 map block. This map block can only contain ground tiles (no walls or objects), otherwise the game will crash or the walls/objects will be removed.
* All Terror terrains (listed under STR_TERROR_MISSION) require at least 1 map block of '''Types''' 2, 3 and 4 (for a total of 3 maps, which are required to place roads) and the corresponding '''roadTypeOdds''' added to the ruleset.
* If there isn't any map blocks designed as roads since you want to keep your terrain 'random', this can be circumvented by designating all 10x10 map blocks, excluding the one(s) used for the XCOM craft, as either '''Type''' 2, 3 and 4 and by defining their '''subType''' to 0. The game will then randomly choose between the map blocks for each type used in the roads, making them map more random.

=== Map Scripts ===

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| name of the script
| ''required''
|-
| '''commands'''
| List of MapCommands
| -
|}

==== Map Command ====

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| Currently these commands are implemented:
* addBlock
* addLine
* addCraft
* addUFO
* digTunnel
* fillArea
* checkBlock
* removeBlock
* resize
depending on the command type some of the following parameters are needed
| ''required''
|-
| '''label'''
| A numeric label that can be used for conditional execution of commands.
Each label should be unique within the terrain list (0=default no need for uniqueness).
| 0
|-
| '''conditionals'''
| Defines the conditions that allows the execution of this command.
eg. [1, -4] means it will be executed if command with label 1 was a success and command with label 4 failed.
commands that are not yet executed are always in failed state.
| 0
|-
| '''executionChances'''
| the chance that this command will be executed (or fails)
| 100
|-
| '''executions'''
| this command will be executed multiple times with a value > 1
| 1
|-
| '''groups'''
| Defines the what mapblock are used within this command. Can be list of goups or a single number.
| 0
|-
| '''blocks'''
| Alternative to groups. Here we define a list of mapblocks that are used within this command.
| 0
|-
| '''rects'''
| A list of possible ranges where (random) placement/checks/removal can happen in a map.
Is a list of a list of four integers.
| ?
|-
| '''size'''
| size of mapblocks that can be placed/checked/removed within rects. Also used for resize command type.
| ?
|-
| '''freqs'''
| For a list of mapblocks (defined by blocks?) we can define distribution frequency here.
| 1
|-
| '''maxUses'''
| For a list of mapblocks (defined by blocks?) we can define the maximal amount a mapblock can be used here.
| -1
|-
| '''direction'''
| used for addLine command type. Values are both, horizontal or vertical. Typically defines the road type distribution.
| -1
|-
| '''tunnelData'''
| Parameter for digTunnel command type. Contains level (default: 0) and a list of MCD replacement rules (MCDReplacements)
| 0
|}

==== Guidelines/Tips ====
* The Mapscript is still somewhat in development

=== Armor ===

Defines a Battlescape unit's [[armor]] as well as visual representation (so every unit has an armor), listed in ''"armors:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the armor name.
| ''required''
|-
| '''spriteSheet'''
| Sprite sheet from [[UNITS]] used to draw a unit wearing this armor.
| -
|-
| '''spriteInv'''
| Sprite used for the [[Inventory Backgrounds]] of a unit wearing this armor.
| -
|-
| '''corpseBattle'''
| List of string IDs of the corpse [[#Items|items]] generated when a unit wearing this armor is killed (one per unit tile) on the Battlescape.
| -
|-
| '''corpseGeo'''
| String ID of the corpse [[#Items|item]] associated with this unit on the Geoscape.
| -
|-
| '''storeItem'''
| String ID of the [[#Items|item]] that represents this armor in [[Base Stores]] for equipping.
| -
|-
| '''weight'''
| Physical weight of the armor when worn
| 6
|-
| '''stats'''
| like soldier stats (see below) but these are treated as stat bonuses for wearing the specific armor.
| -
|-
| '''frontArmor'''
| Protection provided on the front of the unit.
| 0
|-
| '''sideArmor'''
| Protection provided on the sides of the unit.
| 0
|-
| '''rearArmor'''
| Protection provided on the rear of the unit.
| 0
|-
| '''underArmor'''
| Protection provided under the unit (eg. from explosions).
| 0
|-
| '''drawingRoutine'''
| Drawing routine used to put together the body parts in the unit's '''spriteSheet''':
* 0 = [[Soldier]], [[Sectoid]]
* 1 = [[Floater]]
* 2 = [[HWP]]
* 3 = [[Cyberdisk]]
* 4 = [[Civilian]], [[Ethereal]]
* 5 = [[Sectopod]], [[Reaper]]
* 6 = [[Snakeman]]
* 7 = [[Chryssalid]]
* 8 = [[Silacoid]]
* 9 = [[Celatid]]
* 10 = [[Muton]]
* 11 = [[Submersible Weapons Systems]]
* 12 = [[Hallucinoid]]
* 13 = [[Aquanauts]]
* 14 = [[Calcinite]], [[Deep One]], [[Gillman]], [[Lobster Man]], [[Tasoth]]
* 15 = [[Aquatoid]]
* 16 = [[Bio-Drone]]
| 0
|-
| '''movementType'''
| Type of movement provided by this armor:
* 0 = Walking
* 1 = Flying
* 2 = Sliding (no walking animation)
it also defines the body of an tank (32-images) in your spriteSheet or the change in sprites while flying using a flying armour see: [[TANKS.PCK]], [[XCOM_2.PCK]]
| 0
|-
| '''damageModifier'''
| List of decimal damage modifiers (1.0 = 100%) this armor applies to each damage type (see [[#Items|Items section]]) received. Modifiers must be specified for all damage types, in this order:
* None
* Armor Piercing
* Incendiary
* High Explosive
* Laser
* Plasma
* Stun
* Melee
* Acid
* Smoke
|
- 1.0 
- 1.0 
- 1.0 
- 1.0 
- 1.0 
- 1.0 
- 1.0 
- 1.0 
- 1.0 
- 1.0
|-
| '''size'''
| Size of the unit wearing this armor, in Battlescape grid units. Every unit is square, so a size of 2 means 2x2.
| 1
|-
| '''loftempsSet'''
| List of [[LOFTEMPS]] IDs (one per unit tile, so a 1x1 unit has 1, a 2x2 unit has 4, etc.) used to represent a unit wearing this armor in 3D space.
| -
|-
| '''loftemps'''
| loftemps is a deprecated option that only works for 1x1 sized units.
| -
|-
| '''forcedTorso'''
| soldier sprites have female and male torsos. some armours reuse these sprites for flying/non flying torso without difference between genders. This can be controlled by the parameter: 0 = use genderrelated torso, 1 = use male torso, 2 = use female torso
| 0

|}

=== Player Units (Soldiers) ===

Defines a [[soldier]] recruited by X-COM, listed in ''"soldiers:"''. Currently only one soldier unit type (''XCOM'') is supported.

Unit stats are represented as follows:
* [[Time Units|tu]]
* [[Energy|stamina]]
* [[Health|health]]
* [[Bravery|bravery]] (always a multiple of 10)
* [[Reactions|reactions]]
* [[Firing Accuracy|firing]]
* [[Throwing Accuracy|throwing]]
* [[Strength|strength]]
* [[Psi Strength|psiStrength]]
* [[Psi Skill|psiSkill]]
* [[Melee Accuracy|melee]] (not visible)

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the soldier name.
| ''required''
|-
| '''minStats'''
| Minimum values used to generate the soldier's [[Starting Stats]]. In this case, ''psiSkill'' is treated as the initial stat (not generated).
| -
|-
| '''maxStats'''
| Maximum values used to generate the soldier's [[Starting Stats]]. In this case, ''psiSkill'' is treated as the minimum value for the first month of psi training (actual value is 100%-150%).
| -
|-
| '''statCaps'''
| Maximum stats this soldier can gain through [[Experience]]. '''NOTE:''' A stat will still go over the limit once, and then will no longer increase (see [[Experience#Regarding Caps|Regarding Caps]]).
| -
|-
| '''armor'''
| String ID of the [[#Armor|armor]] this soldier uses by default.
| -
|-
| '''standHeight'''
| Height of this soldier when standing.
| 0
|-
| '''kneelHeight'''
| Height of this soldier when kneeling.
| 0
|-
| '''floatHeight'''
| Distance between the bottom of this unit and the ground.
| 0
|-
| '''femaleFrequency'''
| The probability that a female soldier is hired.
| 50
|}

=== AI Units (Aliens/Civilians) ===

Defines an [[Alien Life Forms|alien]] (enemy) or [[civilian]] (neutral) unit, listed in ''"units:"''. Every different alien rank is a different unit, since they have completely different stats. Unit stats are represented as follows:
* [[Time Units|tu]]
* [[Energy|stamina]]
* [[Health|health]]
* [[Bravery|bravery]] (always a multiple of 10)
* [[Reactions|reactions]]
* [[Firing Accuracy|firing]]
* [[Throwing Accuracy|throwing]]
* [[Strength|strength]]
* [[Psi Strength|psiStrength]]
* [[Psi Skill|psiSkill]]
* [[Melee Accuracy|melee]] (not visible)

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the unit name.
| ''required''
|-
| '''race'''
| String ID of the unit race (for alien units).
| -
|-
| '''rank'''
| String ID of the unit rank (for alien units).
| -
|-
| '''stats'''
| Battlescape stats of this unit.
| -
|-
| '''armor'''
| String ID of the [[#Armor|armor]] this unit uses by default.
| -
|-
| '''standHeight'''
| Height of this unit when standing.
| 0
|-
| '''floatHeight'''
| Distance between the bottom of this unit and the ground.
| 0
|-
| '''value'''
| [[Score]] this unit is worth.
| 0
|-
| '''deathSound'''
| Sound ID from [[#Extra_Sounds|BATTLE.CAT]] played when this unit dies.
| -1
|-
| '''aggroSound'''
| Sound ID from [[#Extra_Sounds|BATTLE.CAT]] played when this unit aggros.
| -1
|-
| '''moveSound'''
| Sound ID from [[#Extra_Sounds|BATTLE.CAT]] played when this unit moves.
| -1
|-
| '''intelligence'''
| Intelligence of this unit's AI. The higher the value, the longer this unit remembers player troops between turns.
| 0
|-
| '''aggression'''
| Aggression of this unit's AI. The higher the value, the more ruthless the unit, the more likely to make a frontal assault. Less aggressive units tend to set up ambushes.
Vanilla values are:
* 0 = mostly passive
* 1 = balanced
* 2 = mostly aggresive
| 0
|-
| '''energyRecovery'''
| Energy recovered by the unit each turn (needs verification)
| 40 (?)
|-
| '''specab'''
| Special ability of this unit:
* 0 = None
* 1 = [[Cyberdisc|Explodes on Death]]
* 2 = [[Silacoid|Burns Floor]]
* 3 = [[Bio-Drone|Burns Floor and explodes on Death]]
| 0
|-
| '''spawnUnit'''
| String ID of the unit used to respawn on death (eg. [[Zombie]]s respawn as [[Chrysallid]]s).
| -
|-
| '''livingWeapon'''
| Is this unit a living weapon? (only attacks with a '''fixedWeapon''')
| false
|-
| '''female'''
| Is this unit a female? (used for TFTD civilian types)
| false
|-
|}

=== Alien Races ===

Defines a [[Alien Life Forms|race]] used in [[Alien Missions]], listed in ''"alienRaces:"''. Heavily tied with deployment data.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''id'''
| String ID of the alien race name.
| ''required''
|-
| '''members'''
| Alien crew associated with this alien race (eg. race units + terrorist units), defined by a list of unit string IDs. Order here will define rank in terms of deployment. generally speaking the order is:
* 0 - Commander
* 1 - Leader
* 2 - Engineer
* 3 - Medic
* 4 - Navigator
* 5 - Soldier
* 6 - Terrorist 1
* 7 - Terrorist 2
but of course, not all races have all ranks, so the "fill in" rank would be listed multiple times (see ethereals).
| -
|-
| '''retaliation'''
| retaliation enables/disables the race for retaliation missions.
| ''True''
|-
|}

=== Alien Deployments ===

Defines a Battlescape deployment data used in [[Alien Missions]] (such as alien and map configurations), listed in ''"alienDeployments:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the deployment name.
| ''required''
|-
| '''width'''
| Width of the Battlescape map in grid units.
| 0
|-
| '''length'''
| Length of the Battlescape map in grid units.
| 0
|-
| '''height'''
| Vertical height of the Battlescape map in grid units.
| 0
|-
| '''terrains'''
| list of string IDs of the [[#Terrains|terrain]] to choose from to generate this map. This is not used for UFO sites where the terrain comes from the Geoscape.
| -
|-
| '''shade'''
| Shade of the map (0-15, where 0 is full daytime and 15 is full nighttime). This is not used for UFO sites where the shade comes from the Geoscape.
| 0
|-
| '''nextStage'''
| String ID of the next deployment stage to use after this one, for multi-stage missions.
| -
|-
| '''race'''
| Sets the race to use in the next stage.
| ""
|-
| '''script'''
| Reference to a mapScript.
| ""
|-
| '''data'''
| List of deployment data for each alien rank on this mission (see below).
| -
|}

Notes:
* '''terrains''' can also be used with UFOs, with the game using instead the listed terrain rather than the location of the UFO on Geoscape.
==== Deployment Data ====

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''alienRank'''
| [[Alien Rank|Rank]] associated with this deployment data, as defined by the order of the race in question (see above)
| ''required''
|-
| '''lowQty'''
| Maximum quantity of aliens to spawn (beginner).
| 0
|-
| '''highQty'''
| Maximum quantity of aliens to spawn (superhuman).
| 0
|-
| '''dQty'''
| Minimum Desired Quantity of aliens to spawn.
| 0
|-
| '''extraQty'''
| spawns a random number of additional aliens.
| 0
|-
| '''percentageOutsideUfo'''
| Percentage (0-100%) of aliens to spawn outside in UFO sites.
| 0
|-
| '''itemSets'''
| Three lists (one for each alien technology level) of [[#Items|items]] (string IDs) for the aliens to equip.
| ''required''
|-
|}

=== Research ===

Defines a [[Research|research topic]] that X-COM scientists can investigate, listed in ''"research:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''name'''
| String ID of the research project's name (or item, if a '''lookup''' is defined).
| ''required''
|-
| '''lookup'''
| String ID of the research project's display name and UFOPaedia article reference.
| -
|-
| '''cost'''
| Number of man hours (on average) required to complete this project.
| 0
|-
| '''points'''
| [[Score]] earned for completing this project.
| 0
|-
| '''needItem'''
| Does this project require an [[#Items|item]] of the same name?
| false
|-
| '''dependencies'''
| List of research projects that can unlock access to this one. If the full list is researched, or if one of the projects on the list "unlocks" this one, it becomes available.
| -
|-
| '''unlocks'''
| List of research projects unlocked, regardless of other dependencies, but not requirements, by completing this project (for example, any live alien unlocks "alien origins").
| -
|-
| '''requires'''
| List of research projects unilaterally required before this project can be unlocked (for example, "the martian solution" will not even be considered for unlocking until AFTER "alien origins" is completed).
| -
|-
| '''getOneFree'''
| List of "bonus" research projects that may be granted when completing this project (for example, alien medics will give you information on other alien races). Only applies to living aliens.
| -
|-
|}

=== Manufacture ===

Defines a [[Manufacture|manufacture project]] that X-COM engineers can produce, listed in ''"manufacture:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''name'''
| String ID of the manufacturing project's name (and the item it produces).
| ''required''
|-
| '''category'''
| String ID of the manufacturing project's category.
| -
|-
| '''requires'''
| List of [[#Research|topics]] (string IDs) that must be researched to unlock this project. If none are specified, this project is unlocked from the start.
| -
|-
| '''space'''
| Amount of [[Workshop]] space required to begin this project.
| 0
|-
| '''time'''
| Number of man hours (on average) required per item.
| 0
|-
| '''cost'''
| Monetary deduction per item manufactured.
| 0
|-
| '''requiredItems'''
| List of [[#Items|items]] required and consumed per item manufactured.
| -
|-
| '''producedItems'''
| List of [[#Items|items]] produced per each item consumed. If not specified, defaults to 1 item with the same string ID as the manufacture.
| 1
|-
|}

=== UFOpaedia Article ===

Defines an article in the in-game [[UFOpaedia]], listed in ''"ufopaedia:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''id'''
| String ID of the article name. This must match the ID of the object associated with this article, if applicable.
| ''required''
|-
| '''title'''
| String ID of the article title. If omitted, the '''id''' is used.
| -
|-
| '''type_id'''
| Type of this article:
* 0 = Unknown
* 1 = [[Craft]]
* 2 = [[Craft Armaments]]
* 3 = [[HWP]]
* 4 = [[Equipment (EU)|Equipment]]
* 5 = [[Armour]]
* 6 = [[Base Facilities]]
* 7 = Text & Image (eg. [[Alien Life Forms]], [[UFO Components]])
* 8 = Text (eg. [[Alien Research]])
* 9 = [[UFO]]
* 10 = [[TFTD]]
* 11 = TFTD [[Subs]]
* 12 = TFTD [[Sub_Armaments]]
* 13 = TFTD [[Submersible_Weapons_Systems]]
* 14 = TFTD [[Equipment_(TFTD)]]
* 15 = TFTD Armour
* 16 = TFTD [[Base_Facilities_(TFTD)]]
* 17 = TFTD [[Alien_Subs]]
| 0
|-
| '''section'''
| String ID of the UFOpaedia section this article belongs in.
| -
|-
| '''requires'''
| List of [[#Research|topics]] (string IDs) that must be researched to unlock this article. If none are specified, this article is unlocked from the start.
| -
|-
| '''image_id'''
| Filename of the [[UP001.SPK-UP042.SPK|background image]] displayed on this article, if applicable.
| -
|-
| '''text'''
| String ID of the description displayed on this article.
| -
|-
| '''text_width'''
| Maximum width of the text displayed, only applicable to ''Text & Image'' articles.
| 150
|-
| '''rect_stats'''
| Rectangle ('''x''', '''y''', '''width''', '''height''') of the stats text on the screen, only applicable to ''Craft'' articles.
| 0
|-
| '''rect_text'''
| Rectangle ('''x''', '''y''', '''width''', '''height''') of the description text on the screen, only applicable to ''Craft'' articles.
| 0
|-
| '''weapon'''
| String ID of the weapon, only applicable to ''HWP'' articles.
| -
|}

=== UFO Trajectories ===

Defines a trajectory carried out by an UFO during an [[#Alien Missions|alien mission]], listed in ''"ufoTrajectories:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''id'''
| String ID of the trajectory name.
| ''required''
|-
| '''groundTimer'''
| Amount of seconds for the UFO to spend on Ground waypoints.
| 0
|-
| '''waypoints'''
| List of waypoints for the UFO to traverse, defined as ''[zone, altitude, speed]''. 
'''zone''': Globe zone where the waypoint is located. 
'''altitude''': UFO altitude after reaching this waypoint:
* 0 - Ground
* 1 - Very Low
* 2 - Low
* 3 - High
* 4 - Very High
'''speed''': UFO speed after reaching this waypoint, as a percentage (0-100%) of its maximum speed.
| -
|}

=== Alien Missions ===

Defines an [[Alien Missions|alien mission]] carried out by UFOs on the Geoscape, listed in ''"alienMissions:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the mission type.
| ''required''
|-
| '''points'''
| [[Score]] allocated to aliens for successfully completing this mission.
| 0
|-
| '''raceWeights'''
| List of alien races likely to carry out this mission, and the % chance of them being allocated to this mission, listed by "number of months after game beginning".
| ''required''
|-
| '''waves'''
| List of UFO waves to spawn as this mission progresses, as described below.
| ''required''
|}

==== Waves ====

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''ufo'''
| String ID of the [[#UFOs|UFO]] to spawn.
| ''required''
|-
| '''count'''
| Number of UFOs to spawn.
| 0
|-
| '''trajectory'''
| String ID of the [[#UFO Trajectories|trajectory]] for this UFO to use when entering Earth's atmosphere.
| ''required''
|-
| '''timer'''
| How long after the previous wave should this wave arrive? (in seconds)
| 0
|-
|}

=== Alien Item Levels ===

This is a list of item level probabilities, with a number between 0 and 2 representing an item level from plasma pistols to heavy plasmas, as defined in the deployments, expressing a 10% probability for that item level being used.

0 = first set (plasma pistol/clip)
1 = second set (plasma rifle/clip)
2 = third set (heavy plasma/clip)

For example:
[ 2, 0, 0, 0, 0, 0, 0, 1, 1, 1 ]
would represent a 60% chance for pistols, 30% rifles, and 10% heavy weapons. 
Note that the order does not matter, but the length DOES. each line MUST have 10 digits.

The above can be confusing. There are 10 fields; each number represents 10%. 
There are six instances of '0'. 6x10% = 60% chance of plasma pistol 
There are three instances of '1'. 3x10% = 30% chance of plasma rifle 
There is only one instance of '2'. 1x10% = 10% chance of heavy plasma 

Each line represents a month after the beginning of the game, and there is no limit to the number defined. 
OpenXCom will use the most recently available item level in the event the game goes on forever.

=== Extra Sprites ===

Adds or replaces sprites in an existing [[Image Formats|X-COM image file]], listed in ''"extraSprites:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| Filename of the original/new image to modify.
| ''required''
|-
| '''width'''
'''height'''
| Size of the sprite(s) in pixels.
| 0
0
|-
| '''singleImage'''
| Is the image file just a single sprite (true) or a spritesheet (false)?
| false
|-
| '''subX'''
'''subY'''
| Size of the subdivision in pixels. If a subdivision is specified, then the image file is divided into chunks to form the sprites (eg. spritesheets).
| 0
0
|-
| '''files'''
| List of the new sprites to add/replace, listed as ''spriteID: filename''.
| -
|}

Example:
- type: GIANTBUNNY.PCK
width: 32
height: 40
files:
0: Resources/Bunny/Bunny00.png
1: Resources/Bunny/Bunny01.bmp
2: Resources/Bunny/Bunny02.gif

=== Extra Sounds ===

Adds or replaces sounds in an existing [[SOUND|X-COM sound file]], listed in ''"extraSounds:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| ID of the original sound file to modify:
* BATTLE.CAT - Battlescape sounds, corresponds to ''SOUND1.CAT'' or ''SAMPLE2.CAT'' (55 sounds).
* INTRO.CAT - Intro sounds, corresponds to ''INTRO.CAT'' or ''SAMPLE3.CAT'', probably best not to mess with these.
* GEO.CAT - Geoscape sounds, corresponds to ''SOUND2.CAT'' or ''SAMPLE.CAT'' (14 sounds).
| ''required''
|-
| '''files'''
| List of the new sounds to add/replace, listed as ''soundID: filename''.
| -
|}

Example:
- type: BATTLE.CAT
files:
55: Resources/Sounds/sample.wav

=== Extra Strings ===

Adds or replaces text strings in an existing [[Translations (OpenXcom)|OpenXcom language file]], listed in ''"extraStrings:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| Filename of the original language file to modify, sans extension.
| ''required''
|-
| '''strings'''
| List of the new strings to add/replace, listed as ''stringID: text''.
| -
|}

Example:
- type: en-US
strings:
STR_SNIPER_RIFLE: Sniper Rifle
STR_SNIPER_RIFLE_CLIP: Sniper Rifle Clip
- type: en-GB
strings:
STR_SNIPER_RIFLE: Sniper Rifle
STR_SNIPER_RIFLE_CLIP: Sniper Rifle Clip
- type: de
strings:
STR_SNIPER_RIFLE: Scharfschützengewehr
STR_SNIPER_RIFLE_CLIP: Scharfschützengewehrmunition
- type: ru
strings:
STR_SNIPER_RIFLE: Снайперская винтовка
STR_SNIPER_RIFLE_CLIP: Магазин к снайп. винтовке

=== Interfaces ===

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| ''?''
| -
|-
| '''elements'''
| ''?''
| -
|-
| '''id'''
| ''?''
| -
|-
| '''color'''
| ''?''
| -
|}

=== StatStrings ===

[[Statstrings]] are used for automatically renaming soldiers. They are case sensitive and they are processed in the order in which they are specified.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''string'''
| String to add to name.
| ''required''
|-
| '''psiStrength''' 
'''psiSkill''' 
'''bravery''' 
'''strength''' 
'''firing''' 
'''reactions''' 
'''stamina''' 
'''tu''' 
'''health''' 
'''throwing'''
| One or more stat ranges are ANDed together for success. Each range has a minVal and maxVal. Use YAML standard tilde (~) to indicate null. ((~) = 0 as minvalue; (~) =255 as maxvalue)
| -
|}

Example:
statStrings:
- string: "x"
psiStrength: [~, 30]
- string: "P"
psiStrength: [80, ~]
- string: "p"
psiStrength: [60, 79]
- string: "K"
psiSkill: [60, ~]
- string: "k"
psiSkill: [30, 59]
- string: "b"
bravery: [60, ~]
- string: "c"
bravery: [~, 10]
- string: "w"
strength: [~, 25]
- string: "Snpr"
firing: [60, ~]
reactions: [60, ~]
- string: "M"
firing: [70, ~]
- string: "m"
firing: [60, 69]
- string: "Sct"
reactions: [50, ~]
tu: [60, ~]
- string: "R"
reactions: [60, ~]
- string: "r"
reactions: [50, 59]

==References==
<references />

[[Category:OpenXcom]]

Ruleset Reference (OpenXcom)

2014-12-04T23:26:16Z

Falko:

A reference of all the customizable values of everything in a [[Rulesets (OpenXcom)|ruleset]]. Some guidelines:
* If a value is omitted from the ruleset, the default is used. You cannot omit ''required'' values.
* Text strings (eg. names) are represented by string IDs from the [[Translations (OpenXcom)|language files]]
* Numerical IDs (used for sprites, sounds, etc.) start at 0, not 1.
* Boolean (yes/no) values are represented by true/false.
* World coordinates are represented in degrees (see [[WORLD.DAT]]).
* Money amounts (prices, costs, etc.) are represented in dollars.
* All paths are '''case sensitive'''! If your ruleset uses external files, make sure that they named properly as described in ruleset.

Items are ordered as they come in the ruleset. To override this, you can specify a ''listOrder''. You can find the default listOrders in [[Ruleset List Order (OpenXcom)|Ruleset List Order]].

=== Globe ===

Defines the drawing of landmasses and borders on the globe.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''data'''
| Path name of file which contains polygon and texture information. (For example WORLD.DAT).
| -
|-
| '''polygons'''
| List of polygons drawn on the globe surface. A triangle consist of seven values: the first number defines the texture, followed by three pairs of (x,y) globe coordinates. Only polygons with 3 or 4 vertices are reliable shown on the globe = 7 or 9 values per entry.
| -
|-
| '''polylines'''
| List of border lines. Each list entry consist of a list of (x,y) globe coordinates.
| -
|}

=== Countries ===

Defines one of the [[Country Funding (EU)|funding nations]], listed in ''"countries:"''. They're used for activity graphs and player scoring.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the country name.
| ''required''
|-
| '''fundingBase'''
| Country's base funding, in thousands. The starting funding can be anywhere between 1x and 2x the base funding.
| 0
|-
| '''fundingCap'''
| Country's funding cap, in thousands. Once a country reaches this maximum, it will no longer increase its funding.
| 0
|-
| '''labelLon'''
'''labelLat'''
| Longitude and latitude coordinates of the country's label on the globe. This label is only shown when the globe is zoomed in and "detail" is turned on.
| 0.0
0.0
|-
| '''areas'''
| List of "rectangles" on the globe defined as [''lon1'' ''lat1'' ''lon2'' ''lat2'']. Any activity within these areas counts towards the country's graph activity and affects their opinion of the player.
| -
|}

=== Regions ===

Defines one of the [[Geoscape (EU)#World Regions/Countries|world regions]], listed in ''"regions:"''. They're used for base placement, activity graphs and mission spawning.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the region name.
| ''required''
|-
| '''cost'''
| Amount of money spent building an X-COM base in this region (first base is free).
| 0
|-
| '''areas'''
| List of "rectangles" on the globe defined as ''[lon1, lat1, lon2, lat2]''. Any activity within these areas counts towards the region's graph activity.
| -
|-
| '''cities'''
| List of cities belonging to this region. They will be displayed on the globe and used for terror site missions. Each city is defined by their '''lon''' and '''lat''' coordinates and a '''name''' string ID.
| -
|-
| '''regionWeight'''
| Weight of this region when selecting regions for alien missions.
| 0
|-
| '''missionWeights'''
| Weighted list of the different mission types for this region (eg. ''STR_ALIEN_RESEARCH: 14'').
| -
|-
| '''missionZones'''
| List of "rectangles" (''[lon1, lat1, lon2, lat2]'') defining the mission zones for this region. Mission zones are waypoints for UFO trajectories.
| -
|-
| '''missionRegion'''
| Spawn mission in this region instead (used for regions without land).
| -
|}

=== Base Facilities ===

Defines one of the [[Base Facilities (EU)|facilities]] that can be built in an X-COM base, listed in ''"facilities:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the facility name.
| ''required''
|-
| '''requires'''
| List of [[#Research|topics]] (string IDs) that must be researched to unlock this facility. If none are specified, this facility is unlocked from the start.
| -
|-
| '''spriteShape'''
| Sprite ID from [[BASEBITS.PCK]] used to draw the facility's outer shape in the Basescape and UFOpaedia.
| -1
|-
| '''spriteFacility'''
| Sprite ID from [[BASEBITS.PCK]] used to draw the facility's contents in the Basescape and UFOpaedia. Drawn on top of '''spriteShape'''.
| -1
|-
| '''lift'''
| Is this facility an [[Access Lift]]? All base facilities must be connected to the lift.
| false
|-
| '''hyper'''
| Is this facility a [[Hyperwave Decoder]]? Displays extra information for detected UFOs. Only valid for radar facilities.
| false
|-
| '''mind'''
| Is this facility a [[Mind Shield]]? Reduces the chance of UFOs finding your base. Does not stack.
| false
|-
| '''grav'''
| Is this facility a [[Grav Shield]]? Doubles the power of your base defenses. Does not stack.
| false
|-
| '''size'''
| Size of the facility, in grid units. Every facility is square, so a size of 1 means 1x1, 2 means 2x2, etc. Bigger facilities are made up of multiple sprites, for example a 2x2 facility will use 4 sprites for '''spriteShape''' and 4 sprites for '''spriteFacility''' (top-left, top-right, bottom-left, bottom-right).
| 1
|-
| '''buildCost'''
| Amount of money spent to build this facility in the base.
| 0
|-
| '''buildTime'''
| Amount of days it takes for this facility to be built.
| 0
|-
| '''monthlyCost'''
| Amount of money spent monthly for the maintenance of this facility.
| 0
|-
| '''storage'''
| Amount of storage space (for items) this facility provides. See [[Base Stores]].
| 0
|-
| '''personnel'''
| Amount of personnel (soldiers, scientsts, engineers) these quarters can contain.
| 0
|-
| '''aliens'''
| Amount of live aliens this facility can contain. Only checked if the ''alienContainmentLimitEnforced'' option is enabled.
| 0
|-
| '''crafts'''
| Amount of X-COM craft this facility can contain.
| 0
|-
| '''labs'''
| Amount of lab space this facility provides for research projects.
| 0
|-
| '''workshops'''
| Amount of workshop space this facility provides for manufacture projects.
| 0
|-
| '''psiLabs'''
| Amount of soldier space this facility provides for psionic training.
| 0
|-
| '''radarRange'''
| Maximum radar detection range of this facility, in nautical miles.
| 0
|-
| '''radarChance'''
| Chance (0-100%) of this radar detecting a UFO that enters its range.
| 0
|-
| '''defense'''
| Offensive power provided by this base defense against attacking UFOs.
| 0
|-
| '''hitRatio'''
| Chance (0-100) of the base defense hitting an attacking UFO.
| 0
|-
| '''fireSound'''
| Sound ID from [[#Extra_Sounds|GEO.CAT]] played when the base defense fires.
| -1
|-
| '''hitSound'''
| Sound ID from [[#Extra_Sounds|GEO.CAT]] played when the base defense hits a target.
| -1
|-
| '''mapName'''
| [[MAPS|Map]] associated to this facility in Battlescape base defenses.
| -
|-
|}

=== Crafts ===

Defines one of the [[Craft|X-COM crafts]] that go on interception missions, listed in ''"crafts:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the craft name.
| ''required''
|-
| '''requires'''
| List of [[#Research|topics]] (string IDs) that must be researched to unlock this craft. If none are specified, this craft is unlocked from the start.
| -
|-
| '''sprite'''
| Sprite ID from [[BASEBITS.PCK]] used to draw this craft in the Basescape and from [[INTICON.PCK]] used to draw the damage indicator in dogfights.
modders: the corresponding extrasprite file id for BASEBITS.PCK is sprite+33 INTICON.PCK contains a minimized icon id=sprite the file id for the dogfight image is sprite+11
| -1
|-
| '''fuelMax'''
| Maximum amount of fuel this craft can carry. Crafts use up fuel based on their speed while travelling.
| 0
|-
| '''damageMax'''
| Maximum amount of damage this craft can take. If this amount is exceeded, the craft is destroyed.
| 0
|-
| '''speedMax'''
| Maximum speed in nautical miles. Crafts travel at max speed when flying and half speed when patrolling.
| 0
|-
| '''accel'''
| Aceeleration value shown in the UFOpaedia.
| 0
|-
| '''weapons'''
| Amount of craft weapons this craft can equip. The UI can only display a max of 2 weapons.
| 0
|-
| '''soldiers'''
| Amount of soldiers this craft can carry.
| 0
|-
| '''maxItems'''
| Amount of items this craft can carry.
| 80
|-
| '''vehicles'''
| Amount of vehicles this craft can carry.
| 0
|-
| '''costBuy'''
| Amount of money spent for purchasing this craft. If set to 0, the craft will not be available in the Purchase/Recruit screen.
| 0
|-
| '''costRent'''
| Amount of money spent monthly for renting this craft. If set to 0, the craft is not on rental and won't count towards base maintenance.
| 0
|-
| '''costSell'''
| Amount of money gained for selling this craft.
| 0
|-
| '''refuelItem'''
| Item required for refuelling this craft. If no item is specified, the craft uses human fuel.
| 0
|-
| '''repairRate'''
| Amount of damage restored every hour while [[Repairs|Repairing]] in base.
| 1
|-
| '''refuelRate'''
| Amount of fuel restored every 30 mins while [[Refueling]] in base. If specified, a '''refuelItem''' is spent each time.
| 1
|-
| '''radarRange'''
| Detection range of the craft's radar in nautical miles. Every craft radar has a 100% detection chance.
| 600
|-
| '''transferTime'''
| Number of hours it takes to purchase/transfer this craft to a base.
| 0
|-
| '''score'''
| [[Score]] lost when this craft is destroyed.
| 0
|-
| '''spacecraft'''
| Can this craft go to [[Cydonia]]?
| false
|-
| '''battlescapeTerrainData'''
| [[#Terrains|Terrain]] associated to this craft in Battlescape missions.
| -
|}

=== Craft Weapons ===

Defines one of the [[Craft Armaments|weapons]] equipped by X-COM craft for shooting down UFOs, listed in ''"craftWeapons:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the weapon name.
| ''required''
|-
| '''sprite'''
| Sprite ID from [[BASEBITS.PCK]] used to draw the weapon in the Basescape and from [[INTICON.PCK]] used to draw the weapon in dogfights.
modders: the corresponding extrasprites file id for INTICON.PCK is sprite+5 and sprite+48 for BASEBITS.PCK
| -1
|-
| '''sound'''
| Sound ID from [[#Extra_Sounds|GEO.CAT]] played when this weapon fires.
| -1
|-
| '''damage'''
| Amount of damage this weapon does to enemy UFOs.
| 0
|-
| '''range'''
| Maximum range of this weapon in dogfights (in meters).
| 0
|-
| '''accuracy'''
| Chance (0-100%) of each shot hitting the enemy UFO.
| 0
|-
| '''reloadCautious'''
| Time this weapon takes to fire between each shot in ''Cautious Mode''.
| 0
|-
| '''reloadStandard'''
| Time this weapon takes to fire between each shot in ''Standard Mode''.
| 0
|-
| '''reloadAggressive'''
| Time this weapon takes to fire between each shot in ''Aggressive Mode''.
| 0
|-
| '''ammoMax'''
| Maximum amount of ammo this weapon can carry.
| 0
|-
| '''rearmRate'''
| Amount of ammo restored every 30 mins while the craft is [[Rearming]] in base. If specified, '''clip'''s are spent depending on their '''clipSize'''. If the '''clipSize''' of the specified ammo is 0, no '''clip'''s are spent.
| 1
|-
| '''projectileType'''
| Type of the weapon projectile, used for the projectile sprite in dogfights:
* 0 - [[Stingray]]
* 1 - [[Avalanche]]
* 2 - [[Cannon]]
* 3 - [[Fusion Ball]]
* 4 - [[Laser Cannon]]
* 5 - [[Plasma Beam]]
| 2
|-
| '''projectileSpeed'''
| Speed of the weapon projectile in dogfights.
| 0
|-
| '''launcher'''
| String ID of the [[#Items|item]] required to equip this weapon.
| -
|-
| '''clip'''
| String ID of the [[#Items|item]] required to rearm this weapon.
| -
|}

=== Items ===

Defines the Geoscape and Battlescape properties of an [[Equipment (EU)|item]] that can be stored in X-COM bases, listed in ''"items:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the internal item name.
| ''required''
|-
| '''name'''
| String ID of the displayed item name, for cases where it's different from the internal name. If omitted, '''type''' is used.
| -
|-
| '''requires'''
| List of [[#Research|topics]] (string IDs) that must be researched to unlock this item. If none are specified, this item is unlocked from the start. Soldiers can only use unlocked items in the Battlescape.
| -
|-
| '''size'''
| Space occupied by this item in [[Base Stores]]. Can be a decimal value.
| 0.0
|-
| '''costBuy'''
| Amount of money spent for purchasing this item. If set to 0, this item will not be available in the Purchase/Recruit screen.
| 0
|-
| '''costSell'''
| Amount of money gained for selling this item.
| 0
|-
| '''transferTime'''
| Number of hours it takes to purchase/transfer this item to a base.
| 24
|-
| '''weight'''
| [[Item_Weight|Weight]] occupied by this item in a soldier's inventory.
| 999
|-
| '''bigSprite'''
| Sprite ID from [[BIGOBS.PCK]] used to draw this item in a soldier's inventory and UFOpaedia.
| -1
|-
| '''floorSprite'''
| Sprite ID from [[FLOOROB.PCK]] used to draw this item on the floor of a Battlescape tile.
| -1
|-
| '''handSprite'''
| Sprite ID from [[HANDOB.PCK]] used to draw this item on a soldier's hand in the Battlescape.
modders: each handobject needs 8 images (8 directions) define the extrasprites accordingly
| 120
|-
| '''bulletSprite'''
| Sprite ID from ''BulletSprites.png'' used to draw this weapon's projectile on the Battlescape:
* 0 - [[Rocket Launcher]]
* 1 - [[Pistol]]
* 2 - [[Rifle]]
* 3 - [[Auto Cannon]]
* 4 - [[Heavy Cannon]]
* 5 - [[Laser Pistol]]
* 6 - [[Laser Rifle]]
* 7 - [[Heavy Laser]]
* 8 - [[Plasma Rifle|Plasma]]
* 9 - [[Small Launcher]]
* 10 - [[Blaster Launcher]]
for modders: the bulletsprite needs to be put into the extraSprites type "Projectiles" the bulletsprite can contain up to 35 3x3 images. The corresponding file id is 35*[bulletSprite]
| -1
|-
| '''fireSound'''
| Sound ID from [[#Extra_Sounds|BATTLE.CAT]] played when this weapon fires.
| -1
|-
| '''hitSound'''
| Sound ID from [[#Extra_Sounds|BATTLE.CAT]] played when this weapon hits a target.
| -1
|-
| '''hitAnimation'''
| Sprite ID from [[SMOKE.PCK]] used to draw the weapon's "hit explosion".
'''NOTE''': Do not define this value for melee/psi weapons, they use [[HIT.PCK]] and therefore meleeAnimation instead.
| 0
|-
| '''power'''
| Average damage of the weapon, in most cases it will be +-50% this value.
| 0
|-
| '''strengthApplied'''
| Add the attacking unit's strength to this weapon's damage.
| false
|-
| '''compatibleAmmo'''
| List of string IDs of the ammo items that can be loaded on this weapon. If none are specified, the weapon doesn't need ammo.
| -
|-
| '''damageType'''
| What type of [[damage]] does this weapon do:
* 0 - None
* 1 - Armor Piercing
* 2 - Incendiary
* 3 - High Explosive
* 4 - Laser
* 5 - Plasma
* 6 - Stun
* 7 - Melee
* 8 - Acid
* 9 - Smoke
'''NOTE:''' A damage type other than 0-9 will do nothing.
| 0
|-
| '''tuAuto'''
'''accuracyAuto'''
| The percentage (0-100%) of [[Time Units]] (from the soldier's total) required to fire an Auto Shot. If 0, the weapon does not have an Auto Shot.
The base accuracy (0-100%) applied to a soldier's [[Firing Accuracy]] when firing an Auto Shot.
| 0
0
|-
| '''tuSnap'''
'''accuracySnap'''
| The percentage (0-100%) of [[Time Units]] (from the soldier's total) required to fire a Snap Shot. If 0, the weapon does not have a Snap Shot.
The base accuracy (0-100%) applied to a soldier's [[Firing Accuracy]] when firing a Snap Shot.
| 0
0
|-
| '''tuAimed'''
'''accuracyAimed'''
| The percentage (0-100%) of [[Time Units]] (from the soldier's total) required to fire an Aimed Shot. If 0, the weapon does not have an Aimed Shot.
The base accuracy (0-100%) applied to a soldier's [[Firing Accuracy]] when firing an Aimed Shot.
| 0
0
|-
|-
| '''tuMelee'''
'''accuracyMelee'''
| The percentage (0-100%) of [[Time Units]] (from the soldier's total) required to do a melee attack (Hit). If 0, the weapon does not have a melee attack.
The base accuracy (0-100%) applied to a soldier's [[Melee Accuracy]] when doing a melee attack.
| 0
0
|-
| '''clipSize'''
| The amount of ammo stored in each weapon clip. If -1 is specified, this weapon has infinite ammo.
| 0
|-
| '''battleType'''
| Defines the weapon's behavior in the Battlescape:
* 0 - None (Geoscape-only item)
* 1 - [[Weapons|Firearm]]
* 2 - Ammo
* 3 - Melee
* 4 - [[Grenade]]
* 5 - [[Proximity Grenade]]
* 6 - [[Medi-Kit (EU)|Medi-Kit]]
* 7 - [[Motion Scanner]]
* 8 - [[Mind Probe]]
* 9 - [[Psi-Amp]]
* 10 - [[Electro-flare]]
* 11 - Corpse
| 0
|-
| '''twoHanded'''
| Is this weapon two-handed? If true, incurs an accuracy penalty if used with both hands occupied. Note that the handsprite of a twoHanded item is also drawn at a slightly different position than a one handed item.
| false
|-
| '''waypoint'''
| Does this weapon use waypoints? (eg. [[Blaster Launcher]]). Can also be used to make ammo items use the waypoint system.
| false
|-
| '''fixedWeapon'''
| Is this weapon fixed? (it's part of a unit, eg. tanks and terrorist units)
| false
|-
| '''invWidth'''
| Item width in a soldier's inventory (in grid units).
| 1
|-
| '''invHeight'''
| Item height in a soldier's inventory (in grid units).
| 1
|-
| '''painKiller'''
| Amount of painkillers contained in a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''heal'''
| Amount of heal's contained in a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''stimulant'''
| Amount of stimulants contained in a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''woundRecovery'''
| Amount of [[Fatal Wounds]] treated by each heal of a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''healthRecovery'''
| Amount of [[Health]] recovered by each heal of a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''stunRecovery'''
| Amount of [[Stun]] removed by each stimulant of a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''energyRecovery'''
| Amount of [[Energy]] recovered by each stimulant of a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''tuUse'''
| Amount of [[Time Units]] required to use this item (for non-offensive items). It's a flat rate if '''flatRate''' is true, otherwise it's a percentage (0-100%).
| 0
|-
| '''recoveryPoints'''
| [[Score]] gained for recovering this alien artifact.
| 0
|-
| '''armor'''
| How much damage is needed to destroy this item on the ground.
| 20
|-
| '''recover'''
| Is this item recoverable? (gets transported to the X-COM base on mission success)
| true
|-
| '''turretType'''
| Sprite ID from [[TANKS.PCK]] of the turret to assign to this tank:
* 0 - [[Tank/Cannon]]
* 1 - [[Tank/Rocket Launcher]]
* 2 - [[Tank/Laser Cannon]]
* 3 - [[Hovertank/Plasma]]
* 4 - [[Hovertank/Launcher]]
| -1
|-
| '''liveAlien'''
| Does this item represent a live alien? (counts towards [[Alien Containment]])
| false
|-
| '''blastRadius'''
| Size of the projectile explosions. 0 for no explosion. -1 to automatically calculate based on weapon power and damage type (actual '''blastRadius''' currently is capped due [[Explosions#Playing_With_Fire|Explosion calculations]]).
| -1
|-
| '''flatRate'''
| If true, then TU costs for this weapon are a flat rate (instead of a percentage of unit TUs).
| false
|-
| '''arcingShot'''
| Does this weapon fire in an arc?
| false
|-
| '''attraction'''
| Represents how likely an alien is to pick up this item. Values below 5 will be ignored (by design).
| 0
|-
| '''maxRange'''
| Maximum range at which this weapon can operate.
| 200
|-
| '''aimRange'''
| Maximum effective range with this weapon before which range-based dropoff occurs.
| 200
|-
| '''snapRange'''
| Maximum effective range with snap shot before which range-based dropoff occurs. (ufoextender accuracy only)
| 15
|-
| '''autoRange'''
| Maximum effective range with auto shot before which range-based dropoff occurs. (ufoextender accuracy only)
| 7
|-
| '''minRange'''
| Range-based dropoff will work in reverse for ranges below this.
| 0
|-
| '''dropoff'''
| The value by which the accuracy lowers for each tile after (or before) the thresholds above.
| 2
|-
| '''bulletSpeed'''
| How much faster (or slower, if you use a negative number) is a projectile fired from this weapon compared to the average.
| 0
|-
| '''autoShots'''
| How many auto shots does this weapon fire.
| 3
|-
| '''shotgunPellets'''
| Number of projectiles fired per unit of ammunition. (note: due to engine limitations it is currently impossible to draw multiple projectiles in flight.)
| 0
|-
| '''zombieUnit'''
| String ID of the unit used for zombification (eg. [[Chrysallid]]s turn units into [[Zombie]]s).
| none
|-
| '''meleeSound'''
| Sound ID from [[#Extra_Sounds|BATTLE.CAT]] played when this weapon attacks a target with melee.
| 39
|-
| '''meleeHitSound'''
| Sound ID from [[#Extra_Sounds|BATTLE.CAT]] played when this weapon HITS a target with melee.
| -1
|-
| '''meleeAnimation'''
| Sprite ID from HIT.PCK played when this weapon attacks a target with melee.
| 0
|-
| '''meleePower'''
| Damage this weapon will do when using melee. This only applies to Firearms, and is only available as stun damage. For normal melee weapons, use regular power and damage types.
| 0
|-
| '''LOSRequired'''
| Does this item require line of sight? (only applies to mind probes and psi-amps)
| false
|-
| '''skillApplied'''
| Is melee skill applied to the accuracy of an attack made with this object?
| true
|-
|}

=== UFOs ===

Defines one of the [[UFOs]] that invade Earth, listed in ''"ufos:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the UFO name.
| ''required''
|-
| '''size'''
| String ID of the UFO size.
| STR_VERY_SMALL
|-
| '''sprite'''
| Sprite ID from [[INTERWIN.DAT]] used to draw this UFO in the dogfight view and UFOpaedia.
don't try to add more images if you don't want to punch yourself in the face - use modsprite
| -1
|-
| '''modSprite'''
| Filename used to draw this UFO in the dogfight view and UFOpaedia.
| -
|-
| '''damageMax'''
| Maximum amount of damage this UFO can take. If the UFO takes 50% damage, it crash lands. If it takes 100% damage, it is destroyed.
| 0
|-
| '''speedMax'''
| Maximum speed in nautical miles.
| 0
|-
| '''accel'''
| Aceeleration value shown in the UFOpaedia.
| 0
|-
| '''power'''
| Damage power of this UFO's weapon in dogfights.
| 0
|-
| '''range'''
| Maximum range of this UFO's weapon in dogfights (in meters).
| 0
|-
| '''score'''
| [[Score]] gained when this UFO is destroyed, or half this score if it crash lands.
| 0
|-
| '''reload'''
| Time the UFO's weapon takes to fire between each shot.
| 0
|-
| '''breakOffTime'''
| Minimum amount of time for the UFO to be able to break off of a dogfight.
| 0
|-
| '''battlescapeTerrainData'''
| [[#Terrains|Terrain]] associated to this UFO in Battlescape missions.
| ''required''
|-
|}

=== Inventory Sections ===

Defines one of the sections of the [[Inventory TU Table|Battlescape inventory]] (eg. Backpack), listed in ''"invs:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the inventory name.
| ''required''
|-
| '''x'''
'''y'''
| Pixel coordinates of this section on the inventory screen.
| 0
0
|-
| '''type'''
| Type of this section:
* 0 = Slot section, can contain as many items as will fit on the slots.
* 1 = Hand section, can only contain one item regardless of size.
* 2 = Ground section, can contain infinite items.
| 0
|-
| '''slots'''
| List of the grid slots (''[x, y]'') that this section is composed of. For example, to make a 2x2 section, you would have ''[0, 0] [0, 1] [1, 0] [1, 1]''.
| -
|-
| '''costs'''
| List of [[Time Units]] costs to move an item from this section to another one (eg. ''STR_BACKPACK: 16'' means it will cost 16 TUs to move an item from this section to the Backpack).
| -
|-
|}

=== Terrains ===

Defines one of the [[TERRAIN|terrains]] used to generate a Battlescape map, listed in "terrains:".

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''name'''
| String ID of the terrain name.
| ''required''
|-
| '''largeBlockLimit'''
| Maximum amount of large blocks that can be used on map generation. (obsolete with nightly > 2014-11-19)
| 0
|-
| '''textures'''
| List of [[TEXTURE.DAT|Geoscape textures]] that correspond to this terrain.
| -
|-
| '''hemisphere'''
| Geoscape hemisphere associated with this terrain:
* -1 - Northern hemisphere.
* 0 - Both hemispheres.
* 1 - Southern hemisphere.
| 0
|-
| '''mapDataSets'''
| List of filenames (each with matching [[MCD]]/[[Image Formats#PCK|PCK/TAB]] files) that contain the tiles of this terrain.
| -
|-
| '''mapBlocks'''
| List of map blocks (see below) that are used for generating a map.
| -
|-
| '''roadTypeOdds'''
| Odds as a % of generating each type of road (E-W Road, N-S Road, Crossing) odds for crossing are: 100 - EW - NS. (obsolete with nightly > 2014-11-19)
| [0 0]
|-|-
| '''civilianTypes'''
| List of units to use as civilians for this mission.
| [MALE_CIVILIAN, FEMALE_CIVILIAN]
|-
|}

==== Map Blocks ====

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''name'''
| Filename of the [[MAPS|map]].
| ''required''
|-
| '''width'''
| Width of this map block in Battlescape grid units.
| 0
|-
| '''length'''
| Length of this map block in Battlescape grid units.
| 0
|-
| '''height'''
| Height of this map block in Battlescape grid units.
| 1
|-
| '''type'''
| Type of this map block:
(obsolete with nightly > 2014-11-19)
* -1 - Undefined
* 0 - Default
* 1 - Landing Zone (for placing X-COM / alien craft)
* 2 - E-W Road (for city maps)
* 3 - N-S Road (for city maps)
* 4 - Road Crossing (for city maps)
* 5 - Dirt (for filling empty base blocks)
* 6 - X-COM spawn point (for [[Alien Base]] / [[Cydonia]] missions)
* 7 - [[Alien Base]] Target
* 8 - [[Cydonia]] Target
| -1
|-
| '''subType'''
| Sub-type of this map block (see '''type'''). (obsolete with nightly > 2014-11-19)
| -1
|-
| '''frequency'''
| Frequency of this block in a map. (obsolete with nightly > 2014-11-19)
| 1
|-
| '''maxCount'''
| Maximum amount of times this block can be used in a map. If -1 there is no limit. (obsolete with nightly > 2014-11-19)
| -1
|-
| '''groups'''
| List (or single number) of groups this mapblock belongs to (used in mapscripts)
default usage:
* 0 - Default
* 1 - Landing Zone (for placing X-COM / alien craft) (used in addcraft/ufo command)
* 2 - E-W Road (for city maps) (used in addline command)
* 3 - N-S Road (for city maps) (used in addline command)
* 4 - Road Crossing (for city maps) (used in addline command)
| 0
|-
| '''items'''
| An array of items to add to this mapblock, an the positions to place them at.
| -1
|}

*'''frequency''' defines the odds of the map appearing on the map
** The value assigned (default: 1) is used in ''x/n'', which defines the probability of being chosen.
** ''x'' is the integer defined for the map block's frequency and ''n'' is the combined total of probabilities for all the map types combined.
** This property can only be used in type 0 map blocks.
*'''maxCount''' is the maximum number of times it can be used.
** The value assigned is also used in ''x/n'' to determine the probability of being chosen.
** Each use reduces ''x'' by -1, with the caveat that being used as a Landing Zone type will not reduce the x value since it could result in no available Landing Zones.
** This property can only be used in type 0 map blocks.
* '''hemisphere''' only applies to UFO missions, not Terror ones.
*'''width/length''' defines the size of the map
** be aware that the mapview "width"-label is the openxcom ruleset length parameter
** be aware that the mapview "length"-label is the openxcom ruleset width parameter

==== Guidelines/Tips ====
* All maps with an XCOM/Alien craft require at least one type 1 map block. This map block can only contain ground tiles (no walls or objects), otherwise the game will crash or the walls/objects will be removed.
* All Terror terrains (listed under STR_TERROR_MISSION) require at least 1 map block of '''Types''' 2, 3 and 4 (for a total of 3 maps, which are required to place roads) and the corresponding '''roadTypeOdds''' added to the ruleset.
* If there isn't any map blocks designed as roads since you want to keep your terrain 'random', this can be circumvented by designating all 10x10 map blocks, excluding the one(s) used for the XCOM craft, as either '''Type''' 2, 3 and 4 and by defining their '''subType''' to 0. The game will then randomly choose between the map blocks for each type used in the roads, making them map more random.

=== Map Scripts ===

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| name of the script
| ''required''
|-
| '''commands'''
| List of MapCommands
| -
|}

==== Map Command ====

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| Currently these commands are implemented:
* addBlock
* addLine
* addCraft
* addUFO
* digTunnel
* fillArea
* checkBlock
* removeBlock
* resize
depending on the command type some of the following parameters are needed
| ''required''
|-
| '''label'''
| A numeric label that can be used for conditional execution of commands.
Each label should be unique within the terrain list (0=default no need for uniqueness).
| 0
|-
| '''conditionals'''
| Defines the conditions that allows the execution of this command.
eg. [1, -4] means it will be executed if command with label 1 was a success and command with label 4 failed.
commands that are not yet executed are always in failed state.
| 0
|-
| '''executionChances'''
| the chance that this command will be executed (or fails)
| 100
|-
| '''executions'''
| this command will be executed multiple times with a value > 1
| 1
|-
| '''groups'''
| Defines the what mapblock are used within this command. Can be list of goups or a single number.
| 0
|-
| '''blocks'''
| Alternative to groups. Here we define a list of mapblocks that are used within this command.
| 0
|-
| '''rects'''
| A list of possible ranges where (random) placement/checks/removal can happen in a map.
Is a list of a list of four integers.
| ?
|-
| '''size'''
| size of mapblocks that can be placed/checked/removed within rects. Also used for resize command type.
| ?
|-
| '''freqs'''
| For a list of mapblocks (defined by blocks?) we can define distribution frequency here.
| 1
|-
| '''maxUses'''
| For a list of mapblocks (defined by blocks?) we can define the maximal amount a mapblock can be used here.
| -1
|-
| '''direction'''
| used for addLine command type. Values are both, horizontal or vertical. Typically defines the road type distribution.
| -1
|-
| '''tunnelData'''
| Parameter for digTunnel command type. Contains level (default: 0) and a list of MCD replacement rules (MCDReplacements)
| 0
|}

==== Guidelines/Tips ====
* The Mapscript is still somewhat in development

=== Armor ===

Defines a Battlescape unit's [[armor]] as well as visual representation (so every unit has an armor), listed in ''"armors:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the armor name.
| ''required''
|-
| '''spriteSheet'''
| Sprite sheet from [[UNITS]] used to draw a unit wearing this armor.
| -
|-
| '''spriteInv'''
| Sprite used for the [[Inventory Backgrounds]] of a unit wearing this armor.
| -
|-
| '''corpseBattle'''
| List of string IDs of the corpse [[#Items|items]] generated when a unit wearing this armor is killed (one per unit tile) on the Battlescape.
| -
|-
| '''corpseGeo'''
| String ID of the corpse [[#Items|item]] associated with this unit on the Geoscape.
| -
|-
| '''storeItem'''
| String ID of the [[#Items|item]] that represents this armor in [[Base Stores]] for equipping.
| -
|-
| '''weight'''
| Physical weight of the armor when worn
| 6
|-
| '''stats'''
| like soldier stats (see below) but these are treated as stat bonuses for wearing the specific armor.
| -
|-
| '''frontArmor'''
| Protection provided on the front of the unit.
| 0
|-
| '''sideArmor'''
| Protection provided on the sides of the unit.
| 0
|-
| '''rearArmor'''
| Protection provided on the rear of the unit.
| 0
|-
| '''underArmor'''
| Protection provided under the unit (eg. from explosions).
| 0
|-
| '''drawingRoutine'''
| Drawing routine used to put together the body parts in the unit's '''spriteSheet''':
* 0 = [[Soldier]], [[Sectoid]]
* 1 = [[Floater]]
* 2 = [[HWP]]
* 3 = [[Cyberdisk]]
* 4 = [[Civilian]], [[Ethereal]]
* 5 = [[Sectopod]], [[Reaper]]
* 6 = [[Snakeman]]
* 7 = [[Chryssalid]]
* 8 = [[Silacoid]]
* 9 = [[Celatid]]
* 10 = [[Muton]]
* 11 = [[Submersible Weapons Systems]]
* 12 = [[Hallucinoid]]
* 13 = [[Aquanauts]]
* 14 = [[Calcinite]], [[Deep One]], [[Gillman]], [[Lobster Man]], [[Tasoth]]
* 15 = [[Aquatoid]]
* 16 = [[Bio-Drone]]
| 0
|-
| '''movementType'''
| Type of movement provided by this armor:
* 0 = Walking
* 1 = Flying
* 2 = Sliding (no walking animation)
it also defines the body of an tank (32-images) in your spriteSheet or the change in sprites while flying using a flying armour see: [[TANKS.PCK]], [[XCOM_2.PCK]]
| 0
|-
| '''damageModifier'''
| List of decimal damage modifiers (1.0 = 100%) this armor applies to each damage type (see [[#Items|Items section]]) received. Modifiers must be specified for all damage types, in this order:
* None
* Armor Piercing
* Incendiary
* High Explosive
* Laser
* Plasma
* Stun
* Melee
* Acid
* Smoke
|
- 1.0 
- 1.0 
- 1.0 
- 1.0 
- 1.0 
- 1.0 
- 1.0 
- 1.0 
- 1.0 
- 1.0
|-
| '''size'''
| Size of the unit wearing this armor, in Battlescape grid units. Every unit is square, so a size of 2 means 2x2.
| 1
|-
| '''loftempsSet'''
| List of [[LOFTEMPS]] IDs (one per unit tile, so a 1x1 unit has 1, a 2x2 unit has 4, etc.) used to represent a unit wearing this armor in 3D space.
| -
|-
| '''loftemps'''
| loftemps is a deprecated option that only works for 1x1 sized units.
| -
|-
| '''forcedTorso'''
| soldier sprites have female and male torsos. some armours reuse these sprites for flying/non flying torso without difference between genders. This can be controlled by the parameter: 0 = use genderrelated torso, 1 = use male torso, 2 = use female torso
| 0

|}

=== Player Units (Soldiers) ===

Defines a [[soldier]] recruited by X-COM, listed in ''"soldiers:"''. Currently only one soldier unit type (''XCOM'') is supported.

Unit stats are represented as follows:
* [[Time Units|tu]]
* [[Energy|stamina]]
* [[Health|health]]
* [[Bravery|bravery]] (always a multiple of 10)
* [[Reactions|reactions]]
* [[Firing Accuracy|firing]]
* [[Throwing Accuracy|throwing]]
* [[Strength|strength]]
* [[Psi Strength|psiStrength]]
* [[Psi Skill|psiSkill]]
* [[Melee Accuracy|melee]] (not visible)

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the soldier name.
| ''required''
|-
| '''minStats'''
| Minimum values used to generate the soldier's [[Starting Stats]]. In this case, ''psiSkill'' is treated as the initial stat (not generated).
| -
|-
| '''maxStats'''
| Maximum values used to generate the soldier's [[Starting Stats]]. In this case, ''psiSkill'' is treated as the minimum value for the first month of psi training (actual value is 100%-150%).
| -
|-
| '''statCaps'''
| Maximum stats this soldier can gain through [[Experience]]. '''NOTE:''' A stat will still go over the limit once, and then will no longer increase (see [[Experience#Regarding Caps|Regarding Caps]]).
| -
|-
| '''armor'''
| String ID of the [[#Armor|armor]] this soldier uses by default.
| -
|-
| '''standHeight'''
| Height of this soldier when standing.
| 0
|-
| '''kneelHeight'''
| Height of this soldier when kneeling.
| 0
|-
| '''floatHeight'''
| Distance between the bottom of this unit and the ground.
| 0
|-
| '''femaleFrequency'''
| The probability that a female soldier is hired.
| 50
|}

=== AI Units (Aliens/Civilians) ===

Defines an [[Alien Life Forms|alien]] (enemy) or [[civilian]] (neutral) unit, listed in ''"units:"''. Every different alien rank is a different unit, since they have completely different stats. Unit stats are represented as follows:
* [[Time Units|tu]]
* [[Energy|stamina]]
* [[Health|health]]
* [[Bravery|bravery]] (always a multiple of 10)
* [[Reactions|reactions]]
* [[Firing Accuracy|firing]]
* [[Throwing Accuracy|throwing]]
* [[Strength|strength]]
* [[Psi Strength|psiStrength]]
* [[Psi Skill|psiSkill]]
* [[Melee Accuracy|melee]] (not visible)

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the unit name.
| ''required''
|-
| '''race'''
| String ID of the unit race (for alien units).
| -
|-
| '''rank'''
| String ID of the unit rank (for alien units).
| -
|-
| '''stats'''
| Battlescape stats of this unit.
| -
|-
| '''armor'''
| String ID of the [[#Armor|armor]] this unit uses by default.
| -
|-
| '''standHeight'''
| Height of this unit when standing.
| 0
|-
| '''floatHeight'''
| Distance between the bottom of this unit and the ground.
| 0
|-
| '''value'''
| [[Score]] this unit is worth.
| 0
|-
| '''deathSound'''
| Sound ID from [[#Extra_Sounds|BATTLE.CAT]] played when this unit dies.
| -1
|-
| '''aggroSound'''
| Sound ID from [[#Extra_Sounds|BATTLE.CAT]] played when this unit aggros.
| -1
|-
| '''moveSound'''
| Sound ID from [[#Extra_Sounds|BATTLE.CAT]] played when this unit moves.
| -1
|-
| '''intelligence'''
| Intelligence of this unit's AI. The higher the value, the longer this unit remembers player troops between turns.
| 0
|-
| '''aggression'''
| Aggression of this unit's AI. The higher the value, the more ruthless the unit, the more likely to make a frontal assault. Less aggressive units tend to set up ambushes.
Vanilla values are:
* 0 = mostly passive
* 1 = balanced
* 2 = mostly aggresive
| 0
|-
| '''energyRecovery'''
| Energy recovered by the unit each turn (needs verification)
| 40 (?)
|-
| '''specab'''
| Special ability of this unit:
* 0 = None
* 1 = [[Cyberdisc|Explodes on Death]]
* 2 = [[Bio-Drone|Burns Floor]]
* 3 = Burns Floor and explodes on Death
| 0
|-
| '''spawnUnit'''
| String ID of the unit used to respawn on death (eg. [[Zombie]]s respawn as [[Chrysallid]]s).
| -
|-
| '''livingWeapon'''
| Is this unit a living weapon? (only attacks with a '''fixedWeapon''')
| false
|-
| '''female'''
| Is this unit a female? (used for TFTD civilian types)
| false
|-
|}

=== Alien Races ===

Defines a [[Alien Life Forms|race]] used in [[Alien Missions]], listed in ''"alienRaces:"''. Heavily tied with deployment data.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''id'''
| String ID of the alien race name.
| ''required''
|-
| '''members'''
| Alien crew associated with this alien race (eg. race units + terrorist units), defined by a list of unit string IDs. Order here will define rank in terms of deployment. generally speaking the order is:
* 0 - Commander
* 1 - Leader
* 2 - Engineer
* 3 - Medic
* 4 - Navigator
* 5 - Soldier
* 6 - Terrorist 1
* 7 - Terrorist 2
but of course, not all races have all ranks, so the "fill in" rank would be listed multiple times (see ethereals).
| -
|-
| '''retaliation'''
| retaliation enables/disables the race for retaliation missions.
| ''True''
|-
|}

=== Alien Deployments ===

Defines a Battlescape deployment data used in [[Alien Missions]] (such as alien and map configurations), listed in ''"alienDeployments:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the deployment name.
| ''required''
|-
| '''width'''
| Width of the Battlescape map in grid units.
| 0
|-
| '''length'''
| Length of the Battlescape map in grid units.
| 0
|-
| '''height'''
| Vertical height of the Battlescape map in grid units.
| 0
|-
| '''terrains'''
| list of string IDs of the [[#Terrains|terrain]] to choose from to generate this map. This is not used for UFO sites where the terrain comes from the Geoscape.
| -
|-
| '''shade'''
| Shade of the map (0-15, where 0 is full daytime and 15 is full nighttime). This is not used for UFO sites where the shade comes from the Geoscape.
| 0
|-
| '''nextStage'''
| String ID of the next deployment stage to use after this one, for multi-stage missions.
| -
|-
| '''race'''
| Sets the race to use in the next stage.
| ""
|-
| '''script'''
| Reference to a mapScript.
| ""
|-
| '''data'''
| List of deployment data for each alien rank on this mission (see below).
| -
|}

Notes:
* '''terrains''' can also be used with UFOs, with the game using instead the listed terrain rather than the location of the UFO on Geoscape.
==== Deployment Data ====

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''alienRank'''
| [[Alien Rank|Rank]] associated with this deployment data, as defined by the order of the race in question (see above)
| ''required''
|-
| '''lowQty'''
| Maximum quantity of aliens to spawn (beginner).
| 0
|-
| '''highQty'''
| Maximum quantity of aliens to spawn (superhuman).
| 0
|-
| '''dQty'''
| Minimum Desired Quantity of aliens to spawn.
| 0
|-
| '''extraQty'''
| spawns a random number of additional aliens.
| 0
|-
| '''percentageOutsideUfo'''
| Percentage (0-100%) of aliens to spawn outside in UFO sites.
| 0
|-
| '''itemSets'''
| Three lists (one for each alien technology level) of [[#Items|items]] (string IDs) for the aliens to equip.
| ''required''
|-
|}

=== Research ===

Defines a [[Research|research topic]] that X-COM scientists can investigate, listed in ''"research:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''name'''
| String ID of the research project's name (or item, if a '''lookup''' is defined).
| ''required''
|-
| '''lookup'''
| String ID of the research project's display name and UFOPaedia article reference.
| -
|-
| '''cost'''
| Number of man hours (on average) required to complete this project.
| 0
|-
| '''points'''
| [[Score]] earned for completing this project.
| 0
|-
| '''needItem'''
| Does this project require an [[#Items|item]] of the same name?
| false
|-
| '''dependencies'''
| List of research projects that can unlock access to this one. If the full list is researched, or if one of the projects on the list "unlocks" this one, it becomes available.
| -
|-
| '''unlocks'''
| List of research projects unlocked, regardless of other dependencies, but not requirements, by completing this project (for example, any live alien unlocks "alien origins").
| -
|-
| '''requires'''
| List of research projects unilaterally required before this project can be unlocked (for example, "the martian solution" will not even be considered for unlocking until AFTER "alien origins" is completed).
| -
|-
| '''getOneFree'''
| List of "bonus" research projects that may be granted when completing this project (for example, alien medics will give you information on other alien races). Only applies to living aliens.
| -
|-
|}

=== Manufacture ===

Defines a [[Manufacture|manufacture project]] that X-COM engineers can produce, listed in ''"manufacture:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''name'''
| String ID of the manufacturing project's name (and the item it produces).
| ''required''
|-
| '''category'''
| String ID of the manufacturing project's category.
| -
|-
| '''requires'''
| List of [[#Research|topics]] (string IDs) that must be researched to unlock this project. If none are specified, this project is unlocked from the start.
| -
|-
| '''space'''
| Amount of [[Workshop]] space required to begin this project.
| 0
|-
| '''time'''
| Number of man hours (on average) required per item.
| 0
|-
| '''cost'''
| Monetary deduction per item manufactured.
| 0
|-
| '''requiredItems'''
| List of [[#Items|items]] required and consumed per item manufactured.
| -
|-
| '''producedItems'''
| List of [[#Items|items]] produced per each item consumed. If not specified, defaults to 1 item with the same string ID as the manufacture.
| 1
|-
|}

=== UFOpaedia Article ===

Defines an article in the in-game [[UFOpaedia]], listed in ''"ufopaedia:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''id'''
| String ID of the article name. This must match the ID of the object associated with this article, if applicable.
| ''required''
|-
| '''title'''
| String ID of the article title. If omitted, the '''id''' is used.
| -
|-
| '''type_id'''
| Type of this article:
* 0 = Unknown
* 1 = [[Craft]]
* 2 = [[Craft Armaments]]
* 3 = [[HWP]]
* 4 = [[Equipment (EU)|Equipment]]
* 5 = [[Armour]]
* 6 = [[Base Facilities]]
* 7 = Text & Image (eg. [[Alien Life Forms]], [[UFO Components]])
* 8 = Text (eg. [[Alien Research]])
* 9 = [[UFO]]
* 10 = [[TFTD]]
* 11 = TFTD [[Subs]]
* 12 = TFTD [[Sub_Armaments]]
* 13 = TFTD [[Submersible_Weapons_Systems]]
* 14 = TFTD [[Equipment_(TFTD)]]
* 15 = TFTD Armour
* 16 = TFTD [[Base_Facilities_(TFTD)]]
* 17 = TFTD [[Alien_Subs]]
| 0
|-
| '''section'''
| String ID of the UFOpaedia section this article belongs in.
| -
|-
| '''requires'''
| List of [[#Research|topics]] (string IDs) that must be researched to unlock this article. If none are specified, this article is unlocked from the start.
| -
|-
| '''image_id'''
| Filename of the [[UP001.SPK-UP042.SPK|background image]] displayed on this article, if applicable.
| -
|-
| '''text'''
| String ID of the description displayed on this article.
| -
|-
| '''text_width'''
| Maximum width of the text displayed, only applicable to ''Text & Image'' articles.
| 150
|-
| '''rect_stats'''
| Rectangle ('''x''', '''y''', '''width''', '''height''') of the stats text on the screen, only applicable to ''Craft'' articles.
| 0
|-
| '''rect_text'''
| Rectangle ('''x''', '''y''', '''width''', '''height''') of the description text on the screen, only applicable to ''Craft'' articles.
| 0
|-
| '''weapon'''
| String ID of the weapon, only applicable to ''HWP'' articles.
| -
|}

=== UFO Trajectories ===

Defines a trajectory carried out by an UFO during an [[#Alien Missions|alien mission]], listed in ''"ufoTrajectories:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''id'''
| String ID of the trajectory name.
| ''required''
|-
| '''groundTimer'''
| Amount of seconds for the UFO to spend on Ground waypoints.
| 0
|-
| '''waypoints'''
| List of waypoints for the UFO to traverse, defined as ''[zone, altitude, speed]''. 
'''zone''': Globe zone where the waypoint is located. 
'''altitude''': UFO altitude after reaching this waypoint:
* 0 - Ground
* 1 - Very Low
* 2 - Low
* 3 - High
* 4 - Very High
'''speed''': UFO speed after reaching this waypoint, as a percentage (0-100%) of its maximum speed.
| -
|}

=== Alien Missions ===

Defines an [[Alien Missions|alien mission]] carried out by UFOs on the Geoscape, listed in ''"alienMissions:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the mission type.
| ''required''
|-
| '''points'''
| [[Score]] allocated to aliens for successfully completing this mission.
| 0
|-
| '''raceWeights'''
| List of alien races likely to carry out this mission, and the % chance of them being allocated to this mission, listed by "number of months after game beginning".
| ''required''
|-
| '''waves'''
| List of UFO waves to spawn as this mission progresses, as described below.
| ''required''
|}

==== Waves ====

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''ufo'''
| String ID of the [[#UFOs|UFO]] to spawn.
| ''required''
|-
| '''count'''
| Number of UFOs to spawn.
| 0
|-
| '''trajectory'''
| String ID of the [[#UFO Trajectories|trajectory]] for this UFO to use when entering Earth's atmosphere.
| ''required''
|-
| '''timer'''
| How long after the previous wave should this wave arrive? (in seconds)
| 0
|-
|}

=== Alien Item Levels ===

This is a list of item level probabilities, with a number between 0 and 2 representing an item level from plasma pistols to heavy plasmas, as defined in the deployments, expressing a 10% probability for that item level being used.

0 = first set (plasma pistol/clip)
1 = second set (plasma rifle/clip)
2 = third set (heavy plasma/clip)

For example:
[ 2, 0, 0, 0, 0, 0, 0, 1, 1, 1 ]
would represent a 60% chance for pistols, 30% rifles, and 10% heavy weapons. 
Note that the order does not matter, but the length DOES. each line MUST have 10 digits.

The above can be confusing. There are 10 fields; each number represents 10%. 
There are six instances of '0'. 6x10% = 60% chance of plasma pistol 
There are three instances of '1'. 3x10% = 30% chance of plasma rifle 
There is only one instance of '2'. 1x10% = 10% chance of heavy plasma 

Each line represents a month after the beginning of the game, and there is no limit to the number defined. 
OpenXCom will use the most recently available item level in the event the game goes on forever.

=== Extra Sprites ===

Adds or replaces sprites in an existing [[Image Formats|X-COM image file]], listed in ''"extraSprites:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| Filename of the original/new image to modify.
| ''required''
|-
| '''width'''
'''height'''
| Size of the sprite(s) in pixels.
| 0
0
|-
| '''singleImage'''
| Is the image file just a single sprite (true) or a spritesheet (false)?
| false
|-
| '''subX'''
'''subY'''
| Size of the subdivision in pixels. If a subdivision is specified, then the image file is divided into chunks to form the sprites (eg. spritesheets).
| 0
0
|-
| '''files'''
| List of the new sprites to add/replace, listed as ''spriteID: filename''.
| -
|}

Example:
- type: GIANTBUNNY.PCK
width: 32
height: 40
files:
0: Resources/Bunny/Bunny00.png
1: Resources/Bunny/Bunny01.bmp
2: Resources/Bunny/Bunny02.gif

=== Extra Sounds ===

Adds or replaces sounds in an existing [[SOUND|X-COM sound file]], listed in ''"extraSounds:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| ID of the original sound file to modify:
* BATTLE.CAT - Battlescape sounds, corresponds to ''SOUND1.CAT'' or ''SAMPLE2.CAT'' (55 sounds).
* INTRO.CAT - Intro sounds, corresponds to ''INTRO.CAT'' or ''SAMPLE3.CAT'', probably best not to mess with these.
* GEO.CAT - Geoscape sounds, corresponds to ''SOUND2.CAT'' or ''SAMPLE.CAT'' (14 sounds).
| ''required''
|-
| '''files'''
| List of the new sounds to add/replace, listed as ''soundID: filename''.
| -
|}

Example:
- type: BATTLE.CAT
files:
55: Resources/Sounds/sample.wav

=== Extra Strings ===

Adds or replaces text strings in an existing [[Translations (OpenXcom)|OpenXcom language file]], listed in ''"extraStrings:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| Filename of the original language file to modify, sans extension.
| ''required''
|-
| '''strings'''
| List of the new strings to add/replace, listed as ''stringID: text''.
| -
|}

Example:
- type: en-US
strings:
STR_SNIPER_RIFLE: Sniper Rifle
STR_SNIPER_RIFLE_CLIP: Sniper Rifle Clip
- type: en-GB
strings:
STR_SNIPER_RIFLE: Sniper Rifle
STR_SNIPER_RIFLE_CLIP: Sniper Rifle Clip
- type: de
strings:
STR_SNIPER_RIFLE: Scharfschützengewehr
STR_SNIPER_RIFLE_CLIP: Scharfschützengewehrmunition
- type: ru
strings:
STR_SNIPER_RIFLE: Снайперская винтовка
STR_SNIPER_RIFLE_CLIP: Магазин к снайп. винтовке

=== Interfaces ===

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| ''?''
| -
|-
| '''elements'''
| ''?''
| -
|-
| '''id'''
| ''?''
| -
|-
| '''color'''
| ''?''
| -
|}

=== StatStrings ===

[[Statstrings]] are used for automatically renaming soldiers. They are case sensitive and they are processed in the order in which they are specified.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''string'''
| String to add to name.
| ''required''
|-
| '''psiStrength''' 
'''psiSkill''' 
'''bravery''' 
'''strength''' 
'''firing''' 
'''reactions''' 
'''stamina''' 
'''tu''' 
'''health''' 
'''throwing'''
| One or more stat ranges are ANDed together for success. Each range has a minVal and maxVal. Use YAML standard tilde (~) to indicate null. ((~) = 0 as minvalue; (~) =255 as maxvalue)
| -
|}

Example:
statStrings:
- string: "x"
psiStrength: [~, 30]
- string: "P"
psiStrength: [80, ~]
- string: "p"
psiStrength: [60, 79]
- string: "K"
psiSkill: [60, ~]
- string: "k"
psiSkill: [30, 59]
- string: "b"
bravery: [60, ~]
- string: "c"
bravery: [~, 10]
- string: "w"
strength: [~, 25]
- string: "Snpr"
firing: [60, ~]
reactions: [60, ~]
- string: "M"
firing: [70, ~]
- string: "m"
firing: [60, 69]
- string: "Sct"
reactions: [50, ~]
tu: [60, ~]
- string: "R"
reactions: [60, ~]
- string: "r"
reactions: [50, 59]

==References==
<references />

[[Category:OpenXcom]]

Ruleset Reference (OpenXcom)

2014-12-04T22:49:49Z

Falko: /* Map Blocks */

A reference of all the customizable values of everything in a [[Rulesets (OpenXcom)|ruleset]]. Some guidelines:
* If a value is omitted from the ruleset, the default is used. You cannot omit ''required'' values.
* Text strings (eg. names) are represented by string IDs from the [[Translations (OpenXcom)|language files]]
* Numerical IDs (used for sprites, sounds, etc.) start at 0, not 1.
* Boolean (yes/no) values are represented by true/false.
* World coordinates are represented in degrees (see [[WORLD.DAT]]).
* Money amounts (prices, costs, etc.) are represented in dollars.
* All paths are '''case sensitive'''! If your ruleset uses external files, make sure that they named properly as described in ruleset.

Items are ordered as they come in the ruleset. To override this, you can specify a ''listOrder''. You can find the default listOrders in [[Ruleset List Order (OpenXcom)|Ruleset List Order]].

=== Globe ===

Defines the drawing of landmasses and borders on the globe.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''data'''
| Path name of file which contains polygon and texture information. (For example WORLD.DAT).
| -
|-
| '''polygons'''
| List of polygons drawn on the globe surface. A triangle consist of seven values: the first number defines the texture, followed by three pairs of (x,y) globe coordinates. Only polygons with 3 or 4 vertices are reliable shown on the globe = 7 or 9 values per entry.
| -
|-
| '''polylines'''
| List of border lines. Each list entry consist of a list of (x,y) globe coordinates.
| -
|}

=== Countries ===

Defines one of the [[Country Funding (EU)|funding nations]], listed in ''"countries:"''. They're used for activity graphs and player scoring.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the country name.
| ''required''
|-
| '''fundingBase'''
| Country's base funding, in thousands. The starting funding can be anywhere between 1x and 2x the base funding.
| 0
|-
| '''fundingCap'''
| Country's funding cap, in thousands. Once a country reaches this maximum, it will no longer increase its funding.
| 0
|-
| '''labelLon'''
'''labelLat'''
| Longitude and latitude coordinates of the country's label on the globe. This label is only shown when the globe is zoomed in and "detail" is turned on.
| 0.0
0.0
|-
| '''areas'''
| List of "rectangles" on the globe defined as [''lon1'' ''lat1'' ''lon2'' ''lat2'']. Any activity within these areas counts towards the country's graph activity and affects their opinion of the player.
| -
|}

=== Regions ===

Defines one of the [[Geoscape (EU)#World Regions/Countries|world regions]], listed in ''"regions:"''. They're used for base placement, activity graphs and mission spawning.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the region name.
| ''required''
|-
| '''cost'''
| Amount of money spent building an X-COM base in this region (first base is free).
| 0
|-
| '''areas'''
| List of "rectangles" on the globe defined as ''[lon1, lat1, lon2, lat2]''. Any activity within these areas counts towards the region's graph activity.
| -
|-
| '''cities'''
| List of cities belonging to this region. They will be displayed on the globe and used for terror site missions. Each city is defined by their '''lon''' and '''lat''' coordinates and a '''name''' string ID.
| -
|-
| '''regionWeight'''
| Weight of this region when selecting regions for alien missions.
| 0
|-
| '''missionWeights'''
| Weighted list of the different mission types for this region (eg. ''STR_ALIEN_RESEARCH: 14'').
| -
|-
| '''missionZones'''
| List of "rectangles" (''[lon1, lat1, lon2, lat2]'') defining the mission zones for this region. Mission zones are waypoints for UFO trajectories.
| -
|-
| '''missionRegion'''
| Spawn mission in this region instead (used for regions without land).
| -
|}

=== Base Facilities ===

Defines one of the [[Base Facilities (EU)|facilities]] that can be built in an X-COM base, listed in ''"facilities:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the facility name.
| ''required''
|-
| '''requires'''
| List of [[#Research|topics]] (string IDs) that must be researched to unlock this facility. If none are specified, this facility is unlocked from the start.
| -
|-
| '''spriteShape'''
| Sprite ID from [[BASEBITS.PCK]] used to draw the facility's outer shape in the Basescape and UFOpaedia.
| -1
|-
| '''spriteFacility'''
| Sprite ID from [[BASEBITS.PCK]] used to draw the facility's contents in the Basescape and UFOpaedia. Drawn on top of '''spriteShape'''.
| -1
|-
| '''lift'''
| Is this facility an [[Access Lift]]? All base facilities must be connected to the lift.
| false
|-
| '''hyper'''
| Is this facility a [[Hyperwave Decoder]]? Displays extra information for detected UFOs. Only valid for radar facilities.
| false
|-
| '''mind'''
| Is this facility a [[Mind Shield]]? Reduces the chance of UFOs finding your base. Does not stack.
| false
|-
| '''grav'''
| Is this facility a [[Grav Shield]]? Doubles the power of your base defenses. Does not stack.
| false
|-
| '''size'''
| Size of the facility, in grid units. Every facility is square, so a size of 1 means 1x1, 2 means 2x2, etc. Bigger facilities are made up of multiple sprites, for example a 2x2 facility will use 4 sprites for '''spriteShape''' and 4 sprites for '''spriteFacility''' (top-left, top-right, bottom-left, bottom-right).
| 1
|-
| '''buildCost'''
| Amount of money spent to build this facility in the base.
| 0
|-
| '''buildTime'''
| Amount of days it takes for this facility to be built.
| 0
|-
| '''monthlyCost'''
| Amount of money spent monthly for the maintenance of this facility.
| 0
|-
| '''storage'''
| Amount of storage space (for items) this facility provides. See [[Base Stores]].
| 0
|-
| '''personnel'''
| Amount of personnel (soldiers, scientsts, engineers) these quarters can contain.
| 0
|-
| '''aliens'''
| Amount of live aliens this facility can contain. Only checked if the ''alienContainmentLimitEnforced'' option is enabled.
| 0
|-
| '''crafts'''
| Amount of X-COM craft this facility can contain.
| 0
|-
| '''labs'''
| Amount of lab space this facility provides for research projects.
| 0
|-
| '''workshops'''
| Amount of workshop space this facility provides for manufacture projects.
| 0
|-
| '''psiLabs'''
| Amount of soldier space this facility provides for psionic training.
| 0
|-
| '''radarRange'''
| Maximum radar detection range of this facility, in nautical miles.
| 0
|-
| '''radarChance'''
| Chance (0-100%) of this radar detecting a UFO that enters its range.
| 0
|-
| '''defense'''
| Offensive power provided by this base defense against attacking UFOs.
| 0
|-
| '''hitRatio'''
| Chance (0-100) of the base defense hitting an attacking UFO.
| 0
|-
| '''fireSound'''
| Sound ID from [[#Extra_Sounds|GEO.CAT]] played when the base defense fires.
| -1
|-
| '''hitSound'''
| Sound ID from [[#Extra_Sounds|GEO.CAT]] played when the base defense hits a target.
| -1
|-
| '''mapName'''
| [[MAPS|Map]] associated to this facility in Battlescape base defenses.
| -
|-
|}

=== Crafts ===

Defines one of the [[Craft|X-COM crafts]] that go on interception missions, listed in ''"crafts:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the craft name.
| ''required''
|-
| '''requires'''
| List of [[#Research|topics]] (string IDs) that must be researched to unlock this craft. If none are specified, this craft is unlocked from the start.
| -
|-
| '''sprite'''
| Sprite ID from [[BASEBITS.PCK]] used to draw this craft in the Basescape and from [[INTICON.PCK]] used to draw the damage indicator in dogfights.
modders: the corresponding extrasprite file id for BASEBITS.PCK is sprite+33 INTICON.PCK contains a minimized icon id=sprite the file id for the dogfight image is sprite+11
| -1
|-
| '''fuelMax'''
| Maximum amount of fuel this craft can carry. Crafts use up fuel based on their speed while travelling.
| 0
|-
| '''damageMax'''
| Maximum amount of damage this craft can take. If this amount is exceeded, the craft is destroyed.
| 0
|-
| '''speedMax'''
| Maximum speed in nautical miles. Crafts travel at max speed when flying and half speed when patrolling.
| 0
|-
| '''accel'''
| Aceeleration value shown in the UFOpaedia.
| 0
|-
| '''weapons'''
| Amount of craft weapons this craft can equip. The UI can only display a max of 2 weapons.
| 0
|-
| '''soldiers'''
| Amount of soldiers this craft can carry.
| 0
|-
| '''maxItems'''
| Amount of items this craft can carry.
| 80
|-
| '''vehicles'''
| Amount of vehicles this craft can carry.
| 0
|-
| '''costBuy'''
| Amount of money spent for purchasing this craft. If set to 0, the craft will not be available in the Purchase/Recruit screen.
| 0
|-
| '''costRent'''
| Amount of money spent monthly for renting this craft. If set to 0, the craft is not on rental and won't count towards base maintenance.
| 0
|-
| '''costSell'''
| Amount of money gained for selling this craft.
| 0
|-
| '''refuelItem'''
| Item required for refuelling this craft. If no item is specified, the craft uses human fuel.
| 0
|-
| '''repairRate'''
| Amount of damage restored every hour while [[Repairs|Repairing]] in base.
| 1
|-
| '''refuelRate'''
| Amount of fuel restored every 30 mins while [[Refueling]] in base. If specified, a '''refuelItem''' is spent each time.
| 1
|-
| '''radarRange'''
| Detection range of the craft's radar in nautical miles. Every craft radar has a 100% detection chance.
| 600
|-
| '''transferTime'''
| Number of hours it takes to purchase/transfer this craft to a base.
| 0
|-
| '''score'''
| [[Score]] lost when this craft is destroyed.
| 0
|-
| '''spacecraft'''
| Can this craft go to [[Cydonia]]?
| false
|-
| '''battlescapeTerrainData'''
| [[#Terrains|Terrain]] associated to this craft in Battlescape missions.
| -
|}

=== Craft Weapons ===

Defines one of the [[Craft Armaments|weapons]] equipped by X-COM craft for shooting down UFOs, listed in ''"craftWeapons:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the weapon name.
| ''required''
|-
| '''sprite'''
| Sprite ID from [[BASEBITS.PCK]] used to draw the weapon in the Basescape and from [[INTICON.PCK]] used to draw the weapon in dogfights.
modders: the corresponding extrasprites file id for INTICON.PCK is sprite+5 and sprite+48 for BASEBITS.PCK
| -1
|-
| '''sound'''
| Sound ID from [[#Extra_Sounds|GEO.CAT]] played when this weapon fires.
| -1
|-
| '''damage'''
| Amount of damage this weapon does to enemy UFOs.
| 0
|-
| '''range'''
| Maximum range of this weapon in dogfights (in meters).
| 0
|-
| '''accuracy'''
| Chance (0-100%) of each shot hitting the enemy UFO.
| 0
|-
| '''reloadCautious'''
| Time this weapon takes to fire between each shot in ''Cautious Mode''.
| 0
|-
| '''reloadStandard'''
| Time this weapon takes to fire between each shot in ''Standard Mode''.
| 0
|-
| '''reloadAggressive'''
| Time this weapon takes to fire between each shot in ''Aggressive Mode''.
| 0
|-
| '''ammoMax'''
| Maximum amount of ammo this weapon can carry.
| 0
|-
| '''rearmRate'''
| Amount of ammo restored every 30 mins while the craft is [[Rearming]] in base. If specified, '''clip'''s are spent depending on their '''clipSize'''. If the '''clipSize''' of the specified ammo is 0, no '''clip'''s are spent.
| 1
|-
| '''projectileType'''
| Type of the weapon projectile, used for the projectile sprite in dogfights:
* 0 - [[Stingray]]
* 1 - [[Avalanche]]
* 2 - [[Cannon]]
* 3 - [[Fusion Ball]]
* 4 - [[Laser Cannon]]
* 5 - [[Plasma Beam]]
| 2
|-
| '''projectileSpeed'''
| Speed of the weapon projectile in dogfights.
| 0
|-
| '''launcher'''
| String ID of the [[#Items|item]] required to equip this weapon.
| -
|-
| '''clip'''
| String ID of the [[#Items|item]] required to rearm this weapon.
| -
|}

=== Items ===

Defines the Geoscape and Battlescape properties of an [[Equipment (EU)|item]] that can be stored in X-COM bases, listed in ''"items:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the internal item name.
| ''required''
|-
| '''name'''
| String ID of the displayed item name, for cases where it's different from the internal name. If omitted, '''type''' is used.
| -
|-
| '''requires'''
| List of [[#Research|topics]] (string IDs) that must be researched to unlock this item. If none are specified, this item is unlocked from the start. Soldiers can only use unlocked items in the Battlescape.
| -
|-
| '''size'''
| Space occupied by this item in [[Base Stores]]. Can be a decimal value.
| 0.0
|-
| '''costBuy'''
| Amount of money spent for purchasing this item. If set to 0, this item will not be available in the Purchase/Recruit screen.
| 0
|-
| '''costSell'''
| Amount of money gained for selling this item.
| 0
|-
| '''transferTime'''
| Number of hours it takes to purchase/transfer this item to a base.
| 24
|-
| '''weight'''
| [[Item_Weight|Weight]] occupied by this item in a soldier's inventory.
| 999
|-
| '''bigSprite'''
| Sprite ID from [[BIGOBS.PCK]] used to draw this item in a soldier's inventory and UFOpaedia.
| -1
|-
| '''floorSprite'''
| Sprite ID from [[FLOOROB.PCK]] used to draw this item on the floor of a Battlescape tile.
| -1
|-
| '''handSprite'''
| Sprite ID from [[HANDOB.PCK]] used to draw this item on a soldier's hand in the Battlescape.
modders: each handobject needs 8 images (8 directions) define the extrasprites accordingly
| 120
|-
| '''bulletSprite'''
| Sprite ID from ''BulletSprites.png'' used to draw this weapon's projectile on the Battlescape:
* 0 - [[Rocket Launcher]]
* 1 - [[Pistol]]
* 2 - [[Rifle]]
* 3 - [[Auto Cannon]]
* 4 - [[Heavy Cannon]]
* 5 - [[Laser Pistol]]
* 6 - [[Laser Rifle]]
* 7 - [[Heavy Laser]]
* 8 - [[Plasma Rifle|Plasma]]
* 9 - [[Small Launcher]]
* 10 - [[Blaster Launcher]]
for modders: the bulletsprite needs to be put into the extraSprites type "Projectiles" the bulletsprite can contain up to 35 3x3 images. The corresponding file id is 35*[bulletSprite]
| -1
|-
| '''fireSound'''
| Sound ID from [[#Extra_Sounds|BATTLE.CAT]] played when this weapon fires.
| -1
|-
| '''hitSound'''
| Sound ID from [[#Extra_Sounds|BATTLE.CAT]] played when this weapon hits a target.
| -1
|-
| '''hitAnimation'''
| Sprite ID from [[SMOKE.PCK]] used to draw the weapon's "hit explosion".
'''NOTE''': Do not define this value for melee/psi weapons, they use [[HIT.PCK]] and therefore meleeAnimation instead.
| 0
|-
| '''power'''
| Average damage of the weapon, in most cases it will be +-50% this value.
| 0
|-
| '''strengthApplied'''
| Add the attacking unit's strength to this weapon's damage.
| false
|-
| '''compatibleAmmo'''
| List of string IDs of the ammo items that can be loaded on this weapon. If none are specified, the weapon doesn't need ammo.
| -
|-
| '''damageType'''
| What type of [[damage]] does this weapon do:
* 0 - None
* 1 - Armor Piercing
* 2 - Incendiary
* 3 - High Explosive
* 4 - Laser
* 5 - Plasma
* 6 - Stun
* 7 - Melee
* 8 - Acid
* 9 - Smoke
'''NOTE:''' A damage type other than 0-9 will do nothing.
| 0
|-
| '''tuAuto'''
'''accuracyAuto'''
| The percentage (0-100%) of [[Time Units]] (from the soldier's total) required to fire an Auto Shot. If 0, the weapon does not have an Auto Shot.
The base accuracy (0-100%) applied to a soldier's [[Firing Accuracy]] when firing an Auto Shot.
| 0
0
|-
| '''tuSnap'''
'''accuracySnap'''
| The percentage (0-100%) of [[Time Units]] (from the soldier's total) required to fire a Snap Shot. If 0, the weapon does not have a Snap Shot.
The base accuracy (0-100%) applied to a soldier's [[Firing Accuracy]] when firing a Snap Shot.
| 0
0
|-
| '''tuAimed'''
'''accuracyAimed'''
| The percentage (0-100%) of [[Time Units]] (from the soldier's total) required to fire an Aimed Shot. If 0, the weapon does not have an Aimed Shot.
The base accuracy (0-100%) applied to a soldier's [[Firing Accuracy]] when firing an Aimed Shot.
| 0
0
|-
|-
| '''tuMelee'''
'''accuracyMelee'''
| The percentage (0-100%) of [[Time Units]] (from the soldier's total) required to do a melee attack (Hit). If 0, the weapon does not have a melee attack.
The base accuracy (0-100%) applied to a soldier's [[Melee Accuracy]] when doing a melee attack.
| 0
0
|-
| '''clipSize'''
| The amount of ammo stored in each weapon clip. If -1 is specified, this weapon has infinite ammo.
| 0
|-
| '''battleType'''
| Defines the weapon's behavior in the Battlescape:
* 0 - None (Geoscape-only item)
* 1 - [[Weapons|Firearm]]
* 2 - Ammo
* 3 - Melee
* 4 - [[Grenade]]
* 5 - [[Proximity Grenade]]
* 6 - [[Medi-Kit (EU)|Medi-Kit]]
* 7 - [[Motion Scanner]]
* 8 - [[Mind Probe]]
* 9 - [[Psi-Amp]]
* 10 - [[Electro-flare]]
* 11 - Corpse
| 0
|-
| '''twoHanded'''
| Is this weapon two-handed? If true, incurs an accuracy penalty if used with both hands occupied. Note that the handsprite of a twoHanded item is also drawn at a slightly different position than a one handed item.
| false
|-
| '''waypoint'''
| Does this weapon use waypoints? (eg. [[Blaster Launcher]]). Can also be used to make ammo items use the waypoint system.
| false
|-
| '''fixedWeapon'''
| Is this weapon fixed? (it's part of a unit, eg. tanks and terrorist units)
| false
|-
| '''invWidth'''
| Item width in a soldier's inventory (in grid units).
| 1
|-
| '''invHeight'''
| Item height in a soldier's inventory (in grid units).
| 1
|-
| '''painKiller'''
| Amount of painkillers contained in a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''heal'''
| Amount of heal's contained in a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''stimulant'''
| Amount of stimulants contained in a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''woundRecovery'''
| Amount of [[Fatal Wounds]] treated by each heal of a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''healthRecovery'''
| Amount of [[Health]] recovered by each heal of a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''stunRecovery'''
| Amount of [[Stun]] removed by each stimulant of a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''energyRecovery'''
| Amount of [[Energy]] recovered by each stimulant of a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''tuUse'''
| Amount of [[Time Units]] required to use this item (for non-offensive items). It's a flat rate if '''flatRate''' is true, otherwise it's a percentage (0-100%).
| 0
|-
| '''recoveryPoints'''
| [[Score]] gained for recovering this alien artifact.
| 0
|-
| '''armor'''
| How much damage is needed to destroy this item on the ground.
| 20
|-
| '''recover'''
| Is this item recoverable? (gets transported to the X-COM base on mission success)
| true
|-
| '''turretType'''
| Sprite ID from [[TANKS.PCK]] of the turret to assign to this tank:
* 0 - [[Tank/Cannon]]
* 1 - [[Tank/Rocket Launcher]]
* 2 - [[Tank/Laser Cannon]]
* 3 - [[Hovertank/Plasma]]
* 4 - [[Hovertank/Launcher]]
| -1
|-
| '''liveAlien'''
| Does this item represent a live alien? (counts towards [[Alien Containment]])
| false
|-
| '''blastRadius'''
| Size of the projectile explosions. 0 for no explosion. -1 to automatically calculate based on weapon power and damage type (actual '''blastRadius''' currently is capped due [[Explosions#Playing_With_Fire|Explosion calculations]]).
| -1
|-
| '''flatRate'''
| If true, then TU costs for this weapon are a flat rate (instead of a percentage of unit TUs).
| false
|-
| '''arcingShot'''
| Does this weapon fire in an arc?
| false
|-
| '''attraction'''
| Represents how likely an alien is to pick up this item. Values below 5 will be ignored (by design).
| 0
|-
| '''maxRange'''
| Maximum range at which this weapon can operate.
| 200
|-
| '''aimRange'''
| Maximum effective range with this weapon before which range-based dropoff occurs.
| 200
|-
| '''snapRange'''
| Maximum effective range with snap shot before which range-based dropoff occurs. (ufoextender accuracy only)
| 15
|-
| '''autoRange'''
| Maximum effective range with auto shot before which range-based dropoff occurs. (ufoextender accuracy only)
| 7
|-
| '''minRange'''
| Range-based dropoff will work in reverse for ranges below this.
| 0
|-
| '''dropoff'''
| The value by which the accuracy lowers for each tile after (or before) the thresholds above.
| 2
|-
| '''bulletSpeed'''
| How much faster (or slower, if you use a negative number) is a projectile fired from this weapon compared to the average.
| 0
|-
| '''autoShots'''
| How many auto shots does this weapon fire.
| 3
|-
| '''shotgunPellets'''
| Number of projectiles fired per unit of ammunition. (note: due to engine limitations it is currently impossible to draw multiple projectiles in flight.)
| 0
|-
| '''zombieUnit'''
| String ID of the unit used for zombification (eg. [[Chrysallid]]s turn units into [[Zombie]]s).
| none
|-
| '''meleeSound'''
| Sound ID from [[#Extra_Sounds|BATTLE.CAT]] played when this weapon attacks a target with melee.
| 39
|-
| '''meleeHitSound'''
| Sound ID from [[#Extra_Sounds|BATTLE.CAT]] played when this weapon HITS a target with melee.
| -1
|-
| '''meleeAnimation'''
| Sprite ID from HIT.PCK played when this weapon attacks a target with melee.
| 0
|-
| '''meleePower'''
| Damage this weapon will do when using melee. This only applies to Firearms, and is only available as stun damage. For normal melee weapons, use regular power and damage types.
| 0
|-
| '''LOSRequired'''
| Does this item require line of sight? (only applies to mind probes and psi-amps)
| false
|-
| '''skillApplied'''
| Is melee skill applied to the accuracy of an attack made with this object?
| true
|-
|}

=== UFOs ===

Defines one of the [[UFOs]] that invade Earth, listed in ''"ufos:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the UFO name.
| ''required''
|-
| '''size'''
| String ID of the UFO size.
| STR_VERY_SMALL
|-
| '''sprite'''
| Sprite ID from [[INTERWIN.DAT]] used to draw this UFO in the dogfight view and UFOpaedia.
don't try to add more images if you don't want to punch yourself in the face - use modsprite
| -1
|-
| '''modSprite'''
| Filename used to draw this UFO in the dogfight view and UFOpaedia.
| -
|-
| '''damageMax'''
| Maximum amount of damage this UFO can take. If the UFO takes 50% damage, it crash lands. If it takes 100% damage, it is destroyed.
| 0
|-
| '''speedMax'''
| Maximum speed in nautical miles.
| 0
|-
| '''accel'''
| Aceeleration value shown in the UFOpaedia.
| 0
|-
| '''power'''
| Damage power of this UFO's weapon in dogfights.
| 0
|-
| '''range'''
| Maximum range of this UFO's weapon in dogfights (in meters).
| 0
|-
| '''score'''
| [[Score]] gained when this UFO is destroyed, or half this score if it crash lands.
| 0
|-
| '''reload'''
| Time the UFO's weapon takes to fire between each shot.
| 0
|-
| '''breakOffTime'''
| Minimum amount of time for the UFO to be able to break off of a dogfight.
| 0
|-
| '''battlescapeTerrainData'''
| [[#Terrains|Terrain]] associated to this UFO in Battlescape missions.
| ''required''
|-
|}

=== Inventory Sections ===

Defines one of the sections of the [[Inventory TU Table|Battlescape inventory]] (eg. Backpack), listed in ''"invs:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the inventory name.
| ''required''
|-
| '''x'''
'''y'''
| Pixel coordinates of this section on the inventory screen.
| 0
0
|-
| '''type'''
| Type of this section:
* 0 = Slot section, can contain as many items as will fit on the slots.
* 1 = Hand section, can only contain one item regardless of size.
* 2 = Ground section, can contain infinite items.
| 0
|-
| '''slots'''
| List of the grid slots (''[x, y]'') that this section is composed of. For example, to make a 2x2 section, you would have ''[0, 0] [0, 1] [1, 0] [1, 1]''.
| -
|-
| '''costs'''
| List of [[Time Units]] costs to move an item from this section to another one (eg. ''STR_BACKPACK: 16'' means it will cost 16 TUs to move an item from this section to the Backpack).
| -
|-
|}

=== Terrains ===

Defines one of the [[TERRAIN|terrains]] used to generate a Battlescape map, listed in "terrains:".

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''name'''
| String ID of the terrain name.
| ''required''
|-
| '''largeBlockLimit'''
| Maximum amount of large blocks that can be used on map generation. (obsolete with nightly > 2014-11-19)
| 0
|-
| '''textures'''
| List of [[TEXTURE.DAT|Geoscape textures]] that correspond to this terrain.
| -
|-
| '''hemisphere'''
| Geoscape hemisphere associated with this terrain:
* -1 - Northern hemisphere.
* 0 - Both hemispheres.
* 1 - Southern hemisphere.
| 0
|-
| '''mapDataSets'''
| List of filenames (each with matching [[MCD]]/[[Image Formats#PCK|PCK/TAB]] files) that contain the tiles of this terrain.
| -
|-
| '''mapBlocks'''
| List of map blocks (see below) that are used for generating a map.
| -
|-
| '''roadTypeOdds'''
| Odds as a % of generating each type of road (E-W Road, N-S Road, Crossing) odds for crossing are: 100 - EW - NS. (obsolete with nightly > 2014-11-19)
| [0 0]
|-|-
| '''civilianTypes'''
| List of units to use as civilians for this mission.
| [MALE_CIVILIAN, FEMALE_CIVILIAN]
|-
|}

==== Map Blocks ====

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''name'''
| Filename of the [[MAPS|map]].
| ''required''
|-
| '''width'''
| Width of this map block in Battlescape grid units.
| 0
|-
| '''length'''
| Length of this map block in Battlescape grid units.
| 0
|-
| '''height'''
| Height of this map block in Battlescape grid units.
| 1
|-
| '''type'''
| Type of this map block:
(obsolete with nightly > 2014-11-19)
* -1 - Undefined
* 0 - Default
* 1 - Landing Zone (for placing X-COM / alien craft)
* 2 - E-W Road (for city maps)
* 3 - N-S Road (for city maps)
* 4 - Road Crossing (for city maps)
* 5 - Dirt (for filling empty base blocks)
* 6 - X-COM spawn point (for [[Alien Base]] / [[Cydonia]] missions)
* 7 - [[Alien Base]] Target
* 8 - [[Cydonia]] Target
| -1
|-
| '''subType'''
| Sub-type of this map block (see '''type'''). (obsolete with nightly > 2014-11-19)
| -1
|-
| '''frequency'''
| Frequency of this block in a map. (obsolete with nightly > 2014-11-19)
| 1
|-
| '''maxCount'''
| Maximum amount of times this block can be used in a map. If -1 there is no limit. (obsolete with nightly > 2014-11-19)
| -1
|-
| '''groups'''
| List (or single number) of groups this mapblock belongs to (used in mapscripts)
default usage:
* 0 - Default
* 1 - Landing Zone (for placing X-COM / alien craft) (used in addcraft/ufo command)
* 2 - E-W Road (for city maps) (used in addline command)
* 3 - N-S Road (for city maps) (used in addline command)
* 4 - Road Crossing (for city maps) (used in addline command)
| 0
|-
| '''items'''
| An array of items to add to this mapblock, an the positions to place them at.
| -1
|}

*'''frequency''' defines the odds of the map appearing on the map
** The value assigned (default: 1) is used in ''x/n'', which defines the probability of being chosen.
** ''x'' is the integer defined for the map block's frequency and ''n'' is the combined total of probabilities for all the map types combined.
** This property can only be used in type 0 map blocks.
*'''maxCount''' is the maximum number of times it can be used.
** The value assigned is also used in ''x/n'' to determine the probability of being chosen.
** Each use reduces ''x'' by -1, with the caveat that being used as a Landing Zone type will not reduce the x value since it could result in no available Landing Zones.
** This property can only be used in type 0 map blocks.
* '''hemisphere''' only applies to UFO missions, not Terror ones.
*'''width/length''' defines the size of the map
** be aware that the mapview "width"-label is the openxcom ruleset length parameter
** be aware that the mapview "length"-label is the openxcom ruleset width parameter

==== Guidelines/Tips ====
* All maps with an XCOM/Alien craft require at least one type 1 map block. This map block can only contain ground tiles (no walls or objects), otherwise the game will crash or the walls/objects will be removed.
* All Terror terrains (listed under STR_TERROR_MISSION) require at least 1 map block of '''Types''' 2, 3 and 4 (for a total of 3 maps, which are required to place roads) and the corresponding '''roadTypeOdds''' added to the ruleset.
* If there isn't any map blocks designed as roads since you want to keep your terrain 'random', this can be circumvented by designating all 10x10 map blocks, excluding the one(s) used for the XCOM craft, as either '''Type''' 2, 3 and 4 and by defining their '''subType''' to 0. The game will then randomly choose between the map blocks for each type used in the roads, making them map more random.

=== Armor ===

Defines a Battlescape unit's [[armor]] as well as visual representation (so every unit has an armor), listed in ''"armors:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the armor name.
| ''required''
|-
| '''spriteSheet'''
| Sprite sheet from [[UNITS]] used to draw a unit wearing this armor.
| -
|-
| '''spriteInv'''
| Sprite used for the [[Inventory Backgrounds]] of a unit wearing this armor.
| -
|-
| '''corpseBattle'''
| List of string IDs of the corpse [[#Items|items]] generated when a unit wearing this armor is killed (one per unit tile) on the Battlescape.
| -
|-
| '''corpseGeo'''
| String ID of the corpse [[#Items|item]] associated with this unit on the Geoscape.
| -
|-
| '''storeItem'''
| String ID of the [[#Items|item]] that represents this armor in [[Base Stores]] for equipping.
| -
|-
| '''weight'''
| Physical weight of the armor when worn
| 6
|-
| '''stats'''
| like soldier stats (see below) but these are treated as stat bonuses for wearing the specific armor.
| -
|-
| '''frontArmor'''
| Protection provided on the front of the unit.
| 0
|-
| '''sideArmor'''
| Protection provided on the sides of the unit.
| 0
|-
| '''rearArmor'''
| Protection provided on the rear of the unit.
| 0
|-
| '''underArmor'''
| Protection provided under the unit (eg. from explosions).
| 0
|-
| '''drawingRoutine'''
| Drawing routine used to put together the body parts in the unit's '''spriteSheet''':
* 0 = [[Soldier]], [[Sectoid]]
* 1 = [[Floater]]
* 2 = [[HWP]]
* 3 = [[Cyberdisk]]
* 4 = [[Civilian]], [[Ethereal]]
* 5 = [[Sectopod]], [[Reaper]]
* 6 = [[Snakeman]]
* 7 = [[Chryssalid]]
* 8 = [[Silacoid]]
* 9 = [[Celatid]]
* 10 = [[Muton]]
* 11 = [[Submersible Weapons Systems]]
* 12 = [[Hallucinoid]]
* 13 = [[Aquanauts]]
* 14 = [[Calcinite]], [[Deep One]], [[Gillman]], [[Lobster Man]], [[Tasoth]]
* 15 = [[Aquatoid]]
* 16 = [[Bio-Drone]]
| 0
|-
| '''movementType'''
| Type of movement provided by this armor:
* 0 = Walking
* 1 = Flying
* 2 = Sliding (no walking animation)
it also defines the body of an tank (32-images) in your spriteSheet or the change in sprites while flying using a flying armour see: [[TANKS.PCK]], [[XCOM_2.PCK]]
| 0
|-
| '''damageModifier'''
| List of decimal damage modifiers (1.0 = 100%) this armor applies to each damage type (see [[#Items|Items section]]) received. Modifiers must be specified for all damage types, in this order:
* None
* Armor Piercing
* Incendiary
* High Explosive
* Laser
* Plasma
* Stun
* Melee
* Acid
* Smoke
|
- 1.0 
- 1.0 
- 1.0 
- 1.0 
- 1.0 
- 1.0 
- 1.0 
- 1.0 
- 1.0 
- 1.0
|-
| '''size'''
| Size of the unit wearing this armor, in Battlescape grid units. Every unit is square, so a size of 2 means 2x2.
| 1
|-
| '''loftempsSet'''
| List of [[LOFTEMPS]] IDs (one per unit tile, so a 1x1 unit has 1, a 2x2 unit has 4, etc.) used to represent a unit wearing this armor in 3D space.
| -
|-
| '''loftemps'''
| loftemps is a deprecated option that only works for 1x1 sized units.
| -
|-
| '''forcedTorso'''
| soldier sprites have female and male torsos. some armours reuse these sprites for flying/non flying torso without difference between genders. This can be controlled by the parameter: 0 = use genderrelated torso, 1 = use male torso, 2 = use female torso
| 0

|}

=== Player Units (Soldiers) ===

Defines a [[soldier]] recruited by X-COM, listed in ''"soldiers:"''. Currently only one soldier unit type (''XCOM'') is supported.

Unit stats are represented as follows:
* [[Time Units|tu]]
* [[Energy|stamina]]
* [[Health|health]]
* [[Bravery|bravery]] (always a multiple of 10)
* [[Reactions|reactions]]
* [[Firing Accuracy|firing]]
* [[Throwing Accuracy|throwing]]
* [[Strength|strength]]
* [[Psi Strength|psiStrength]]
* [[Psi Skill|psiSkill]]
* [[Melee Accuracy|melee]] (not visible)

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the soldier name.
| ''required''
|-
| '''minStats'''
| Minimum values used to generate the soldier's [[Starting Stats]]. In this case, ''psiSkill'' is treated as the initial stat (not generated).
| -
|-
| '''maxStats'''
| Maximum values used to generate the soldier's [[Starting Stats]]. In this case, ''psiSkill'' is treated as the minimum value for the first month of psi training (actual value is 100%-150%).
| -
|-
| '''statCaps'''
| Maximum stats this soldier can gain through [[Experience]]. '''NOTE:''' A stat will still go over the limit once, and then will no longer increase (see [[Experience#Regarding Caps|Regarding Caps]]).
| -
|-
| '''armor'''
| String ID of the [[#Armor|armor]] this soldier uses by default.
| -
|-
| '''standHeight'''
| Height of this soldier when standing.
| 0
|-
| '''kneelHeight'''
| Height of this soldier when kneeling.
| 0
|-
| '''floatHeight'''
| Distance between the bottom of this unit and the ground.
| 0
|-
| '''femaleFrequency'''
| The probability that a female soldier is hired.
| 50
|}

=== AI Units (Aliens/Civilians) ===

Defines an [[Alien Life Forms|alien]] (enemy) or [[civilian]] (neutral) unit, listed in ''"units:"''. Every different alien rank is a different unit, since they have completely different stats. Unit stats are represented as follows:
* [[Time Units|tu]]
* [[Energy|stamina]]
* [[Health|health]]
* [[Bravery|bravery]] (always a multiple of 10)
* [[Reactions|reactions]]
* [[Firing Accuracy|firing]]
* [[Throwing Accuracy|throwing]]
* [[Strength|strength]]
* [[Psi Strength|psiStrength]]
* [[Psi Skill|psiSkill]]
* [[Melee Accuracy|melee]] (not visible)

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the unit name.
| ''required''
|-
| '''race'''
| String ID of the unit race (for alien units).
| -
|-
| '''rank'''
| String ID of the unit rank (for alien units).
| -
|-
| '''stats'''
| Battlescape stats of this unit.
| -
|-
| '''armor'''
| String ID of the [[#Armor|armor]] this unit uses by default.
| -
|-
| '''standHeight'''
| Height of this unit when standing.
| 0
|-
| '''floatHeight'''
| Distance between the bottom of this unit and the ground.
| 0
|-
| '''value'''
| [[Score]] this unit is worth.
| 0
|-
| '''deathSound'''
| Sound ID from [[#Extra_Sounds|BATTLE.CAT]] played when this unit dies.
| -1
|-
| '''aggroSound'''
| Sound ID from [[#Extra_Sounds|BATTLE.CAT]] played when this unit aggros.
| -1
|-
| '''moveSound'''
| Sound ID from [[#Extra_Sounds|BATTLE.CAT]] played when this unit moves.
| -1
|-
| '''intelligence'''
| Intelligence of this unit's AI. The higher the value, the longer this unit remembers player troops between turns.
| 0
|-
| '''aggression'''
| Aggression of this unit's AI. The higher the value, the more ruthless the unit, the more likely to make a frontal assault. Less aggressive units tend to set up ambushes.
Vanilla values are:
* 0 = mostly passive
* 1 = balanced
* 2 = mostly aggresive
| 0
|-
| '''energyRecovery'''
| Energy recovered by the unit each turn (needs verification)
| 40 (?)
|-
| '''specab'''
| Special ability of this unit:
* 0 = None
* 1 = [[Cyberdisc|Explodes on Death]]
* 2 = [[Bio-Drone|Burns Floor]]
* 3 = Burns Floor and explodes on Death
| 0
|-
| '''spawnUnit'''
| String ID of the unit used to respawn on death (eg. [[Zombie]]s respawn as [[Chrysallid]]s).
| -
|-
| '''livingWeapon'''
| Is this unit a living weapon? (only attacks with a '''fixedWeapon''')
| false
|-
| '''female'''
| Is this unit a female? (used for TFTD civilian types)
| false
|-
|}

=== Alien Races ===

Defines a [[Alien Life Forms|race]] used in [[Alien Missions]], listed in ''"alienRaces:"''. Heavily tied with deployment data.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''id'''
| String ID of the alien race name.
| ''required''
|-
| '''members'''
| Alien crew associated with this alien race (eg. race units + terrorist units), defined by a list of unit string IDs. Order here will define rank in terms of deployment. generally speaking the order is:
* 0 - Commander
* 1 - Leader
* 2 - Engineer
* 3 - Medic
* 4 - Navigator
* 5 - Soldier
* 6 - Terrorist 1
* 7 - Terrorist 2
but of course, not all races have all ranks, so the "fill in" rank would be listed multiple times (see ethereals).
| -
|-
| '''retaliation'''
| retaliation enables/disables the race for retaliation missions.
| ''True''
|-
|}

=== Alien Deployments ===

Defines a Battlescape deployment data used in [[Alien Missions]] (such as alien and map configurations), listed in ''"alienDeployments:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the deployment name.
| ''required''
|-
| '''width'''
| Width of the Battlescape map in grid units.
| 0
|-
| '''length'''
| Length of the Battlescape map in grid units.
| 0
|-
| '''height'''
| Vertical height of the Battlescape map in grid units.
| 0
|-
| '''terrains'''
| list of string IDs of the [[#Terrains|terrain]] to choose from to generate this map. This is not used for UFO sites where the terrain comes from the Geoscape.
| -
|-
| '''shade'''
| Shade of the map (0-15, where 0 is full daytime and 15 is full nighttime). This is not used for UFO sites where the shade comes from the Geoscape.
| 0
|-
| '''nextStage'''
| String ID of the next deployment stage to use after this one, for multi-stage missions.
| -
|-
| '''race'''
| Sets the race to use in the next stage.
| ""
|-
| '''script'''
| Reference to a mapScript.
| ""
|-
| '''data'''
| List of deployment data for each alien rank on this mission (see below).
| -
|}

Notes:
* '''terrains''' can also be used with UFOs, with the game using instead the listed terrain rather than the location of the UFO on Geoscape.
==== Deployment Data ====

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''alienRank'''
| [[Alien Rank|Rank]] associated with this deployment data, as defined by the order of the race in question (see above)
| ''required''
|-
| '''lowQty'''
| Maximum quantity of aliens to spawn (beginner).
| 0
|-
| '''highQty'''
| Maximum quantity of aliens to spawn (superhuman).
| 0
|-
| '''dQty'''
| Minimum Desired Quantity of aliens to spawn.
| 0
|-
| '''extraQty'''
| spawns a random number of additional aliens.
| 0
|-
| '''percentageOutsideUfo'''
| Percentage (0-100%) of aliens to spawn outside in UFO sites.
| 0
|-
| '''itemSets'''
| Three lists (one for each alien technology level) of [[#Items|items]] (string IDs) for the aliens to equip.
| ''required''
|-
|}

=== Research ===

Defines a [[Research|research topic]] that X-COM scientists can investigate, listed in ''"research:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''name'''
| String ID of the research project's name (or item, if a '''lookup''' is defined).
| ''required''
|-
| '''lookup'''
| String ID of the research project's display name and UFOPaedia article reference.
| -
|-
| '''cost'''
| Number of man hours (on average) required to complete this project.
| 0
|-
| '''points'''
| [[Score]] earned for completing this project.
| 0
|-
| '''needItem'''
| Does this project require an [[#Items|item]] of the same name?
| false
|-
| '''dependencies'''
| List of research projects that can unlock access to this one. If the full list is researched, or if one of the projects on the list "unlocks" this one, it becomes available.
| -
|-
| '''unlocks'''
| List of research projects unlocked, regardless of other dependencies, but not requirements, by completing this project (for example, any live alien unlocks "alien origins").
| -
|-
| '''requires'''
| List of research projects unilaterally required before this project can be unlocked (for example, "the martian solution" will not even be considered for unlocking until AFTER "alien origins" is completed).
| -
|-
| '''getOneFree'''
| List of "bonus" research projects that may be granted when completing this project (for example, alien medics will give you information on other alien races). Only applies to living aliens.
| -
|-
|}

=== Manufacture ===

Defines a [[Manufacture|manufacture project]] that X-COM engineers can produce, listed in ''"manufacture:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''name'''
| String ID of the manufacturing project's name (and the item it produces).
| ''required''
|-
| '''category'''
| String ID of the manufacturing project's category.
| -
|-
| '''requires'''
| List of [[#Research|topics]] (string IDs) that must be researched to unlock this project. If none are specified, this project is unlocked from the start.
| -
|-
| '''space'''
| Amount of [[Workshop]] space required to begin this project.
| 0
|-
| '''time'''
| Number of man hours (on average) required per item.
| 0
|-
| '''cost'''
| Monetary deduction per item manufactured.
| 0
|-
| '''requiredItems'''
| List of [[#Items|items]] required and consumed per item manufactured.
| -
|-
| '''producedItems'''
| List of [[#Items|items]] produced per each item consumed. If not specified, defaults to 1 item with the same string ID as the manufacture.
| 1
|-
|}

=== UFOpaedia Article ===

Defines an article in the in-game [[UFOpaedia]], listed in ''"ufopaedia:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''id'''
| String ID of the article name. This must match the ID of the object associated with this article, if applicable.
| ''required''
|-
| '''title'''
| String ID of the article title. If omitted, the '''id''' is used.
| -
|-
| '''type_id'''
| Type of this article:
* 0 = Unknown
* 1 = [[Craft]]
* 2 = [[Craft Armaments]]
* 3 = [[HWP]]
* 4 = [[Equipment (EU)|Equipment]]
* 5 = [[Armour]]
* 6 = [[Base Facilities]]
* 7 = Text & Image (eg. [[Alien Life Forms]], [[UFO Components]])
* 8 = Text (eg. [[Alien Research]])
* 9 = [[UFO]]
* 10 = [[TFTD]]
* 11 = TFTD [[Subs]]
* 12 = TFTD [[Sub_Armaments]]
* 13 = TFTD [[Submersible_Weapons_Systems]]
* 14 = TFTD [[Equipment_(TFTD)]]
* 15 = TFTD Armour
* 16 = TFTD [[Base_Facilities_(TFTD)]]
* 17 = TFTD [[Alien_Subs]]
| 0
|-
| '''section'''
| String ID of the UFOpaedia section this article belongs in.
| -
|-
| '''requires'''
| List of [[#Research|topics]] (string IDs) that must be researched to unlock this article. If none are specified, this article is unlocked from the start.
| -
|-
| '''image_id'''
| Filename of the [[UP001.SPK-UP042.SPK|background image]] displayed on this article, if applicable.
| -
|-
| '''text'''
| String ID of the description displayed on this article.
| -
|-
| '''text_width'''
| Maximum width of the text displayed, only applicable to ''Text & Image'' articles.
| 150
|-
| '''rect_stats'''
| Rectangle ('''x''', '''y''', '''width''', '''height''') of the stats text on the screen, only applicable to ''Craft'' articles.
| 0
|-
| '''rect_text'''
| Rectangle ('''x''', '''y''', '''width''', '''height''') of the description text on the screen, only applicable to ''Craft'' articles.
| 0
|-
| '''weapon'''
| String ID of the weapon, only applicable to ''HWP'' articles.
| -
|}

=== UFO Trajectories ===

Defines a trajectory carried out by an UFO during an [[#Alien Missions|alien mission]], listed in ''"ufoTrajectories:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''id'''
| String ID of the trajectory name.
| ''required''
|-
| '''groundTimer'''
| Amount of seconds for the UFO to spend on Ground waypoints.
| 0
|-
| '''waypoints'''
| List of waypoints for the UFO to traverse, defined as ''[zone, altitude, speed]''. 
'''zone''': Globe zone where the waypoint is located. 
'''altitude''': UFO altitude after reaching this waypoint:
* 0 - Ground
* 1 - Very Low
* 2 - Low
* 3 - High
* 4 - Very High
'''speed''': UFO speed after reaching this waypoint, as a percentage (0-100%) of its maximum speed.
| -
|}

=== Alien Missions ===

Defines an [[Alien Missions|alien mission]] carried out by UFOs on the Geoscape, listed in ''"alienMissions:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the mission type.
| ''required''
|-
| '''points'''
| [[Score]] allocated to aliens for successfully completing this mission.
| 0
|-
| '''raceWeights'''
| List of alien races likely to carry out this mission, and the % chance of them being allocated to this mission, listed by "number of months after game beginning".
| ''required''
|-
| '''waves'''
| List of UFO waves to spawn as this mission progresses, as described below.
| ''required''
|}

==== Waves ====

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''ufo'''
| String ID of the [[#UFOs|UFO]] to spawn.
| ''required''
|-
| '''count'''
| Number of UFOs to spawn.
| 0
|-
| '''trajectory'''
| String ID of the [[#UFO Trajectories|trajectory]] for this UFO to use when entering Earth's atmosphere.
| ''required''
|-
| '''timer'''
| How long after the previous wave should this wave arrive? (in seconds)
| 0
|-
|}

=== Alien Item Levels ===

This is a list of item level probabilities, with a number between 0 and 2 representing an item level from plasma pistols to heavy plasmas, as defined in the deployments, expressing a 10% probability for that item level being used.

0 = first set (plasma pistol/clip)
1 = second set (plasma rifle/clip)
2 = third set (heavy plasma/clip)

For example:
[ 2, 0, 0, 0, 0, 0, 0, 1, 1, 1 ]
would represent a 60% chance for pistols, 30% rifles, and 10% heavy weapons. 
Note that the order does not matter, but the length DOES. each line MUST have 10 digits.

The above can be confusing. There are 10 fields; each number represents 10%. 
There are six instances of '0'. 6x10% = 60% chance of plasma pistol 
There are three instances of '1'. 3x10% = 30% chance of plasma rifle 
There is only one instance of '2'. 1x10% = 10% chance of heavy plasma 

Each line represents a month after the beginning of the game, and there is no limit to the number defined. 
OpenXCom will use the most recently available item level in the event the game goes on forever.

=== Extra Sprites ===

Adds or replaces sprites in an existing [[Image Formats|X-COM image file]], listed in ''"extraSprites:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| Filename of the original/new image to modify.
| ''required''
|-
| '''width'''
'''height'''
| Size of the sprite(s) in pixels.
| 0
0
|-
| '''singleImage'''
| Is the image file just a single sprite (true) or a spritesheet (false)?
| false
|-
| '''subX'''
'''subY'''
| Size of the subdivision in pixels. If a subdivision is specified, then the image file is divided into chunks to form the sprites (eg. spritesheets).
| 0
0
|-
| '''files'''
| List of the new sprites to add/replace, listed as ''spriteID: filename''.
| -
|}

Example:
- type: GIANTBUNNY.PCK
width: 32
height: 40
files:
0: Resources/Bunny/Bunny00.png
1: Resources/Bunny/Bunny01.bmp
2: Resources/Bunny/Bunny02.gif

=== Extra Sounds ===

Adds or replaces sounds in an existing [[SOUND|X-COM sound file]], listed in ''"extraSounds:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| ID of the original sound file to modify:
* BATTLE.CAT - Battlescape sounds, corresponds to ''SOUND1.CAT'' or ''SAMPLE2.CAT'' (55 sounds).
* INTRO.CAT - Intro sounds, corresponds to ''INTRO.CAT'' or ''SAMPLE3.CAT'', probably best not to mess with these.
* GEO.CAT - Geoscape sounds, corresponds to ''SOUND2.CAT'' or ''SAMPLE.CAT'' (14 sounds).
| ''required''
|-
| '''files'''
| List of the new sounds to add/replace, listed as ''soundID: filename''.
| -
|}

Example:
- type: BATTLE.CAT
files:
55: Resources/Sounds/sample.wav

=== Extra Strings ===

Adds or replaces text strings in an existing [[Translations (OpenXcom)|OpenXcom language file]], listed in ''"extraStrings:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| Filename of the original language file to modify, sans extension.
| ''required''
|-
| '''strings'''
| List of the new strings to add/replace, listed as ''stringID: text''.
| -
|}

Example:
- type: en-US
strings:
STR_SNIPER_RIFLE: Sniper Rifle
STR_SNIPER_RIFLE_CLIP: Sniper Rifle Clip
- type: en-GB
strings:
STR_SNIPER_RIFLE: Sniper Rifle
STR_SNIPER_RIFLE_CLIP: Sniper Rifle Clip
- type: de
strings:
STR_SNIPER_RIFLE: Scharfschützengewehr
STR_SNIPER_RIFLE_CLIP: Scharfschützengewehrmunition
- type: ru
strings:
STR_SNIPER_RIFLE: Снайперская винтовка
STR_SNIPER_RIFLE_CLIP: Магазин к снайп. винтовке

=== Interfaces ===

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| ''?''
| -
|-
| '''elements'''
| ''?''
| -
|-
| '''id'''
| ''?''
| -
|-
| '''color'''
| ''?''
| -
|}

=== StatStrings ===

[[Statstrings]] are used for automatically renaming soldiers. They are case sensitive and they are processed in the order in which they are specified.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''string'''
| String to add to name.
| ''required''
|-
| '''psiStrength''' 
'''psiSkill''' 
'''bravery''' 
'''strength''' 
'''firing''' 
'''reactions''' 
'''stamina''' 
'''tu''' 
'''health''' 
'''throwing'''
| One or more stat ranges are ANDed together for success. Each range has a minVal and maxVal. Use YAML standard tilde (~) to indicate null. ((~) = 0 as minvalue; (~) =255 as maxvalue)
| -
|}

Example:
statStrings:
- string: "x"
psiStrength: [~, 30]
- string: "P"
psiStrength: [80, ~]
- string: "p"
psiStrength: [60, 79]
- string: "K"
psiSkill: [60, ~]
- string: "k"
psiSkill: [30, 59]
- string: "b"
bravery: [60, ~]
- string: "c"
bravery: [~, 10]
- string: "w"
strength: [~, 25]
- string: "Snpr"
firing: [60, ~]
reactions: [60, ~]
- string: "M"
firing: [70, ~]
- string: "m"
firing: [60, 69]
- string: "Sct"
reactions: [50, ~]
tu: [60, ~]
- string: "R"
reactions: [60, ~]
- string: "r"
reactions: [50, 59]

==References==
<references />

[[Category:OpenXcom]]

Ruleset Reference (OpenXcom)

2014-12-04T22:43:32Z

Falko: /* UFOpaedia Article */

A reference of all the customizable values of everything in a [[Rulesets (OpenXcom)|ruleset]]. Some guidelines:
* If a value is omitted from the ruleset, the default is used. You cannot omit ''required'' values.
* Text strings (eg. names) are represented by string IDs from the [[Translations (OpenXcom)|language files]]
* Numerical IDs (used for sprites, sounds, etc.) start at 0, not 1.
* Boolean (yes/no) values are represented by true/false.
* World coordinates are represented in degrees (see [[WORLD.DAT]]).
* Money amounts (prices, costs, etc.) are represented in dollars.
* All paths are '''case sensitive'''! If your ruleset uses external files, make sure that they named properly as described in ruleset.

Items are ordered as they come in the ruleset. To override this, you can specify a ''listOrder''. You can find the default listOrders in [[Ruleset List Order (OpenXcom)|Ruleset List Order]].

=== Globe ===

Defines the drawing of landmasses and borders on the globe.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''data'''
| Path name of file which contains polygon and texture information. (For example WORLD.DAT).
| -
|-
| '''polygons'''
| List of polygons drawn on the globe surface. A triangle consist of seven values: the first number defines the texture, followed by three pairs of (x,y) globe coordinates. Only polygons with 3 or 4 vertices are reliable shown on the globe = 7 or 9 values per entry.
| -
|-
| '''polylines'''
| List of border lines. Each list entry consist of a list of (x,y) globe coordinates.
| -
|}

=== Countries ===

Defines one of the [[Country Funding (EU)|funding nations]], listed in ''"countries:"''. They're used for activity graphs and player scoring.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the country name.
| ''required''
|-
| '''fundingBase'''
| Country's base funding, in thousands. The starting funding can be anywhere between 1x and 2x the base funding.
| 0
|-
| '''fundingCap'''
| Country's funding cap, in thousands. Once a country reaches this maximum, it will no longer increase its funding.
| 0
|-
| '''labelLon'''
'''labelLat'''
| Longitude and latitude coordinates of the country's label on the globe. This label is only shown when the globe is zoomed in and "detail" is turned on.
| 0.0
0.0
|-
| '''areas'''
| List of "rectangles" on the globe defined as [''lon1'' ''lat1'' ''lon2'' ''lat2'']. Any activity within these areas counts towards the country's graph activity and affects their opinion of the player.
| -
|}

=== Regions ===

Defines one of the [[Geoscape (EU)#World Regions/Countries|world regions]], listed in ''"regions:"''. They're used for base placement, activity graphs and mission spawning.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the region name.
| ''required''
|-
| '''cost'''
| Amount of money spent building an X-COM base in this region (first base is free).
| 0
|-
| '''areas'''
| List of "rectangles" on the globe defined as ''[lon1, lat1, lon2, lat2]''. Any activity within these areas counts towards the region's graph activity.
| -
|-
| '''cities'''
| List of cities belonging to this region. They will be displayed on the globe and used for terror site missions. Each city is defined by their '''lon''' and '''lat''' coordinates and a '''name''' string ID.
| -
|-
| '''regionWeight'''
| Weight of this region when selecting regions for alien missions.
| 0
|-
| '''missionWeights'''
| Weighted list of the different mission types for this region (eg. ''STR_ALIEN_RESEARCH: 14'').
| -
|-
| '''missionZones'''
| List of "rectangles" (''[lon1, lat1, lon2, lat2]'') defining the mission zones for this region. Mission zones are waypoints for UFO trajectories.
| -
|-
| '''missionRegion'''
| Spawn mission in this region instead (used for regions without land).
| -
|}

=== Base Facilities ===

Defines one of the [[Base Facilities (EU)|facilities]] that can be built in an X-COM base, listed in ''"facilities:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the facility name.
| ''required''
|-
| '''requires'''
| List of [[#Research|topics]] (string IDs) that must be researched to unlock this facility. If none are specified, this facility is unlocked from the start.
| -
|-
| '''spriteShape'''
| Sprite ID from [[BASEBITS.PCK]] used to draw the facility's outer shape in the Basescape and UFOpaedia.
| -1
|-
| '''spriteFacility'''
| Sprite ID from [[BASEBITS.PCK]] used to draw the facility's contents in the Basescape and UFOpaedia. Drawn on top of '''spriteShape'''.
| -1
|-
| '''lift'''
| Is this facility an [[Access Lift]]? All base facilities must be connected to the lift.
| false
|-
| '''hyper'''
| Is this facility a [[Hyperwave Decoder]]? Displays extra information for detected UFOs. Only valid for radar facilities.
| false
|-
| '''mind'''
| Is this facility a [[Mind Shield]]? Reduces the chance of UFOs finding your base. Does not stack.
| false
|-
| '''grav'''
| Is this facility a [[Grav Shield]]? Doubles the power of your base defenses. Does not stack.
| false
|-
| '''size'''
| Size of the facility, in grid units. Every facility is square, so a size of 1 means 1x1, 2 means 2x2, etc. Bigger facilities are made up of multiple sprites, for example a 2x2 facility will use 4 sprites for '''spriteShape''' and 4 sprites for '''spriteFacility''' (top-left, top-right, bottom-left, bottom-right).
| 1
|-
| '''buildCost'''
| Amount of money spent to build this facility in the base.
| 0
|-
| '''buildTime'''
| Amount of days it takes for this facility to be built.
| 0
|-
| '''monthlyCost'''
| Amount of money spent monthly for the maintenance of this facility.
| 0
|-
| '''storage'''
| Amount of storage space (for items) this facility provides. See [[Base Stores]].
| 0
|-
| '''personnel'''
| Amount of personnel (soldiers, scientsts, engineers) these quarters can contain.
| 0
|-
| '''aliens'''
| Amount of live aliens this facility can contain. Only checked if the ''alienContainmentLimitEnforced'' option is enabled.
| 0
|-
| '''crafts'''
| Amount of X-COM craft this facility can contain.
| 0
|-
| '''labs'''
| Amount of lab space this facility provides for research projects.
| 0
|-
| '''workshops'''
| Amount of workshop space this facility provides for manufacture projects.
| 0
|-
| '''psiLabs'''
| Amount of soldier space this facility provides for psionic training.
| 0
|-
| '''radarRange'''
| Maximum radar detection range of this facility, in nautical miles.
| 0
|-
| '''radarChance'''
| Chance (0-100%) of this radar detecting a UFO that enters its range.
| 0
|-
| '''defense'''
| Offensive power provided by this base defense against attacking UFOs.
| 0
|-
| '''hitRatio'''
| Chance (0-100) of the base defense hitting an attacking UFO.
| 0
|-
| '''fireSound'''
| Sound ID from [[#Extra_Sounds|GEO.CAT]] played when the base defense fires.
| -1
|-
| '''hitSound'''
| Sound ID from [[#Extra_Sounds|GEO.CAT]] played when the base defense hits a target.
| -1
|-
| '''mapName'''
| [[MAPS|Map]] associated to this facility in Battlescape base defenses.
| -
|-
|}

=== Crafts ===

Defines one of the [[Craft|X-COM crafts]] that go on interception missions, listed in ''"crafts:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the craft name.
| ''required''
|-
| '''requires'''
| List of [[#Research|topics]] (string IDs) that must be researched to unlock this craft. If none are specified, this craft is unlocked from the start.
| -
|-
| '''sprite'''
| Sprite ID from [[BASEBITS.PCK]] used to draw this craft in the Basescape and from [[INTICON.PCK]] used to draw the damage indicator in dogfights.
modders: the corresponding extrasprite file id for BASEBITS.PCK is sprite+33 INTICON.PCK contains a minimized icon id=sprite the file id for the dogfight image is sprite+11
| -1
|-
| '''fuelMax'''
| Maximum amount of fuel this craft can carry. Crafts use up fuel based on their speed while travelling.
| 0
|-
| '''damageMax'''
| Maximum amount of damage this craft can take. If this amount is exceeded, the craft is destroyed.
| 0
|-
| '''speedMax'''
| Maximum speed in nautical miles. Crafts travel at max speed when flying and half speed when patrolling.
| 0
|-
| '''accel'''
| Aceeleration value shown in the UFOpaedia.
| 0
|-
| '''weapons'''
| Amount of craft weapons this craft can equip. The UI can only display a max of 2 weapons.
| 0
|-
| '''soldiers'''
| Amount of soldiers this craft can carry.
| 0
|-
| '''maxItems'''
| Amount of items this craft can carry.
| 80
|-
| '''vehicles'''
| Amount of vehicles this craft can carry.
| 0
|-
| '''costBuy'''
| Amount of money spent for purchasing this craft. If set to 0, the craft will not be available in the Purchase/Recruit screen.
| 0
|-
| '''costRent'''
| Amount of money spent monthly for renting this craft. If set to 0, the craft is not on rental and won't count towards base maintenance.
| 0
|-
| '''costSell'''
| Amount of money gained for selling this craft.
| 0
|-
| '''refuelItem'''
| Item required for refuelling this craft. If no item is specified, the craft uses human fuel.
| 0
|-
| '''repairRate'''
| Amount of damage restored every hour while [[Repairs|Repairing]] in base.
| 1
|-
| '''refuelRate'''
| Amount of fuel restored every 30 mins while [[Refueling]] in base. If specified, a '''refuelItem''' is spent each time.
| 1
|-
| '''radarRange'''
| Detection range of the craft's radar in nautical miles. Every craft radar has a 100% detection chance.
| 600
|-
| '''transferTime'''
| Number of hours it takes to purchase/transfer this craft to a base.
| 0
|-
| '''score'''
| [[Score]] lost when this craft is destroyed.
| 0
|-
| '''spacecraft'''
| Can this craft go to [[Cydonia]]?
| false
|-
| '''battlescapeTerrainData'''
| [[#Terrains|Terrain]] associated to this craft in Battlescape missions.
| -
|}

=== Craft Weapons ===

Defines one of the [[Craft Armaments|weapons]] equipped by X-COM craft for shooting down UFOs, listed in ''"craftWeapons:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the weapon name.
| ''required''
|-
| '''sprite'''
| Sprite ID from [[BASEBITS.PCK]] used to draw the weapon in the Basescape and from [[INTICON.PCK]] used to draw the weapon in dogfights.
modders: the corresponding extrasprites file id for INTICON.PCK is sprite+5 and sprite+48 for BASEBITS.PCK
| -1
|-
| '''sound'''
| Sound ID from [[#Extra_Sounds|GEO.CAT]] played when this weapon fires.
| -1
|-
| '''damage'''
| Amount of damage this weapon does to enemy UFOs.
| 0
|-
| '''range'''
| Maximum range of this weapon in dogfights (in meters).
| 0
|-
| '''accuracy'''
| Chance (0-100%) of each shot hitting the enemy UFO.
| 0
|-
| '''reloadCautious'''
| Time this weapon takes to fire between each shot in ''Cautious Mode''.
| 0
|-
| '''reloadStandard'''
| Time this weapon takes to fire between each shot in ''Standard Mode''.
| 0
|-
| '''reloadAggressive'''
| Time this weapon takes to fire between each shot in ''Aggressive Mode''.
| 0
|-
| '''ammoMax'''
| Maximum amount of ammo this weapon can carry.
| 0
|-
| '''rearmRate'''
| Amount of ammo restored every 30 mins while the craft is [[Rearming]] in base. If specified, '''clip'''s are spent depending on their '''clipSize'''. If the '''clipSize''' of the specified ammo is 0, no '''clip'''s are spent.
| 1
|-
| '''projectileType'''
| Type of the weapon projectile, used for the projectile sprite in dogfights:
* 0 - [[Stingray]]
* 1 - [[Avalanche]]
* 2 - [[Cannon]]
* 3 - [[Fusion Ball]]
* 4 - [[Laser Cannon]]
* 5 - [[Plasma Beam]]
| 2
|-
| '''projectileSpeed'''
| Speed of the weapon projectile in dogfights.
| 0
|-
| '''launcher'''
| String ID of the [[#Items|item]] required to equip this weapon.
| -
|-
| '''clip'''
| String ID of the [[#Items|item]] required to rearm this weapon.
| -
|}

=== Items ===

Defines the Geoscape and Battlescape properties of an [[Equipment (EU)|item]] that can be stored in X-COM bases, listed in ''"items:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the internal item name.
| ''required''
|-
| '''name'''
| String ID of the displayed item name, for cases where it's different from the internal name. If omitted, '''type''' is used.
| -
|-
| '''requires'''
| List of [[#Research|topics]] (string IDs) that must be researched to unlock this item. If none are specified, this item is unlocked from the start. Soldiers can only use unlocked items in the Battlescape.
| -
|-
| '''size'''
| Space occupied by this item in [[Base Stores]]. Can be a decimal value.
| 0.0
|-
| '''costBuy'''
| Amount of money spent for purchasing this item. If set to 0, this item will not be available in the Purchase/Recruit screen.
| 0
|-
| '''costSell'''
| Amount of money gained for selling this item.
| 0
|-
| '''transferTime'''
| Number of hours it takes to purchase/transfer this item to a base.
| 24
|-
| '''weight'''
| [[Item_Weight|Weight]] occupied by this item in a soldier's inventory.
| 999
|-
| '''bigSprite'''
| Sprite ID from [[BIGOBS.PCK]] used to draw this item in a soldier's inventory and UFOpaedia.
| -1
|-
| '''floorSprite'''
| Sprite ID from [[FLOOROB.PCK]] used to draw this item on the floor of a Battlescape tile.
| -1
|-
| '''handSprite'''
| Sprite ID from [[HANDOB.PCK]] used to draw this item on a soldier's hand in the Battlescape.
modders: each handobject needs 8 images (8 directions) define the extrasprites accordingly
| 120
|-
| '''bulletSprite'''
| Sprite ID from ''BulletSprites.png'' used to draw this weapon's projectile on the Battlescape:
* 0 - [[Rocket Launcher]]
* 1 - [[Pistol]]
* 2 - [[Rifle]]
* 3 - [[Auto Cannon]]
* 4 - [[Heavy Cannon]]
* 5 - [[Laser Pistol]]
* 6 - [[Laser Rifle]]
* 7 - [[Heavy Laser]]
* 8 - [[Plasma Rifle|Plasma]]
* 9 - [[Small Launcher]]
* 10 - [[Blaster Launcher]]
for modders: the bulletsprite needs to be put into the extraSprites type "Projectiles" the bulletsprite can contain up to 35 3x3 images. The corresponding file id is 35*[bulletSprite]
| -1
|-
| '''fireSound'''
| Sound ID from [[#Extra_Sounds|BATTLE.CAT]] played when this weapon fires.
| -1
|-
| '''hitSound'''
| Sound ID from [[#Extra_Sounds|BATTLE.CAT]] played when this weapon hits a target.
| -1
|-
| '''hitAnimation'''
| Sprite ID from [[SMOKE.PCK]] used to draw the weapon's "hit explosion".
'''NOTE''': Do not define this value for melee/psi weapons, they use [[HIT.PCK]] and therefore meleeAnimation instead.
| 0
|-
| '''power'''
| Average damage of the weapon, in most cases it will be +-50% this value.
| 0
|-
| '''strengthApplied'''
| Add the attacking unit's strength to this weapon's damage.
| false
|-
| '''compatibleAmmo'''
| List of string IDs of the ammo items that can be loaded on this weapon. If none are specified, the weapon doesn't need ammo.
| -
|-
| '''damageType'''
| What type of [[damage]] does this weapon do:
* 0 - None
* 1 - Armor Piercing
* 2 - Incendiary
* 3 - High Explosive
* 4 - Laser
* 5 - Plasma
* 6 - Stun
* 7 - Melee
* 8 - Acid
* 9 - Smoke
'''NOTE:''' A damage type other than 0-9 will do nothing.
| 0
|-
| '''tuAuto'''
'''accuracyAuto'''
| The percentage (0-100%) of [[Time Units]] (from the soldier's total) required to fire an Auto Shot. If 0, the weapon does not have an Auto Shot.
The base accuracy (0-100%) applied to a soldier's [[Firing Accuracy]] when firing an Auto Shot.
| 0
0
|-
| '''tuSnap'''
'''accuracySnap'''
| The percentage (0-100%) of [[Time Units]] (from the soldier's total) required to fire a Snap Shot. If 0, the weapon does not have a Snap Shot.
The base accuracy (0-100%) applied to a soldier's [[Firing Accuracy]] when firing a Snap Shot.
| 0
0
|-
| '''tuAimed'''
'''accuracyAimed'''
| The percentage (0-100%) of [[Time Units]] (from the soldier's total) required to fire an Aimed Shot. If 0, the weapon does not have an Aimed Shot.
The base accuracy (0-100%) applied to a soldier's [[Firing Accuracy]] when firing an Aimed Shot.
| 0
0
|-
|-
| '''tuMelee'''
'''accuracyMelee'''
| The percentage (0-100%) of [[Time Units]] (from the soldier's total) required to do a melee attack (Hit). If 0, the weapon does not have a melee attack.
The base accuracy (0-100%) applied to a soldier's [[Melee Accuracy]] when doing a melee attack.
| 0
0
|-
| '''clipSize'''
| The amount of ammo stored in each weapon clip. If -1 is specified, this weapon has infinite ammo.
| 0
|-
| '''battleType'''
| Defines the weapon's behavior in the Battlescape:
* 0 - None (Geoscape-only item)
* 1 - [[Weapons|Firearm]]
* 2 - Ammo
* 3 - Melee
* 4 - [[Grenade]]
* 5 - [[Proximity Grenade]]
* 6 - [[Medi-Kit (EU)|Medi-Kit]]
* 7 - [[Motion Scanner]]
* 8 - [[Mind Probe]]
* 9 - [[Psi-Amp]]
* 10 - [[Electro-flare]]
* 11 - Corpse
| 0
|-
| '''twoHanded'''
| Is this weapon two-handed? If true, incurs an accuracy penalty if used with both hands occupied. Note that the handsprite of a twoHanded item is also drawn at a slightly different position than a one handed item.
| false
|-
| '''waypoint'''
| Does this weapon use waypoints? (eg. [[Blaster Launcher]]). Can also be used to make ammo items use the waypoint system.
| false
|-
| '''fixedWeapon'''
| Is this weapon fixed? (it's part of a unit, eg. tanks and terrorist units)
| false
|-
| '''invWidth'''
| Item width in a soldier's inventory (in grid units).
| 1
|-
| '''invHeight'''
| Item height in a soldier's inventory (in grid units).
| 1
|-
| '''painKiller'''
| Amount of painkillers contained in a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''heal'''
| Amount of heal's contained in a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''stimulant'''
| Amount of stimulants contained in a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''woundRecovery'''
| Amount of [[Fatal Wounds]] treated by each heal of a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''healthRecovery'''
| Amount of [[Health]] recovered by each heal of a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''stunRecovery'''
| Amount of [[Stun]] removed by each stimulant of a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''energyRecovery'''
| Amount of [[Energy]] recovered by each stimulant of a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''tuUse'''
| Amount of [[Time Units]] required to use this item (for non-offensive items). It's a flat rate if '''flatRate''' is true, otherwise it's a percentage (0-100%).
| 0
|-
| '''recoveryPoints'''
| [[Score]] gained for recovering this alien artifact.
| 0
|-
| '''armor'''
| How much damage is needed to destroy this item on the ground.
| 20
|-
| '''recover'''
| Is this item recoverable? (gets transported to the X-COM base on mission success)
| true
|-
| '''turretType'''
| Sprite ID from [[TANKS.PCK]] of the turret to assign to this tank:
* 0 - [[Tank/Cannon]]
* 1 - [[Tank/Rocket Launcher]]
* 2 - [[Tank/Laser Cannon]]
* 3 - [[Hovertank/Plasma]]
* 4 - [[Hovertank/Launcher]]
| -1
|-
| '''liveAlien'''
| Does this item represent a live alien? (counts towards [[Alien Containment]])
| false
|-
| '''blastRadius'''
| Size of the projectile explosions. 0 for no explosion. -1 to automatically calculate based on weapon power and damage type (actual '''blastRadius''' currently is capped due [[Explosions#Playing_With_Fire|Explosion calculations]]).
| -1
|-
| '''flatRate'''
| If true, then TU costs for this weapon are a flat rate (instead of a percentage of unit TUs).
| false
|-
| '''arcingShot'''
| Does this weapon fire in an arc?
| false
|-
| '''attraction'''
| Represents how likely an alien is to pick up this item. Values below 5 will be ignored (by design).
| 0
|-
| '''maxRange'''
| Maximum range at which this weapon can operate.
| 200
|-
| '''aimRange'''
| Maximum effective range with this weapon before which range-based dropoff occurs.
| 200
|-
| '''snapRange'''
| Maximum effective range with snap shot before which range-based dropoff occurs. (ufoextender accuracy only)
| 15
|-
| '''autoRange'''
| Maximum effective range with auto shot before which range-based dropoff occurs. (ufoextender accuracy only)
| 7
|-
| '''minRange'''
| Range-based dropoff will work in reverse for ranges below this.
| 0
|-
| '''dropoff'''
| The value by which the accuracy lowers for each tile after (or before) the thresholds above.
| 2
|-
| '''bulletSpeed'''
| How much faster (or slower, if you use a negative number) is a projectile fired from this weapon compared to the average.
| 0
|-
| '''autoShots'''
| How many auto shots does this weapon fire.
| 3
|-
| '''shotgunPellets'''
| Number of projectiles fired per unit of ammunition. (note: due to engine limitations it is currently impossible to draw multiple projectiles in flight.)
| 0
|-
| '''zombieUnit'''
| String ID of the unit used for zombification (eg. [[Chrysallid]]s turn units into [[Zombie]]s).
| none
|-
| '''meleeSound'''
| Sound ID from [[#Extra_Sounds|BATTLE.CAT]] played when this weapon attacks a target with melee.
| 39
|-
| '''meleeHitSound'''
| Sound ID from [[#Extra_Sounds|BATTLE.CAT]] played when this weapon HITS a target with melee.
| -1
|-
| '''meleeAnimation'''
| Sprite ID from HIT.PCK played when this weapon attacks a target with melee.
| 0
|-
| '''meleePower'''
| Damage this weapon will do when using melee. This only applies to Firearms, and is only available as stun damage. For normal melee weapons, use regular power and damage types.
| 0
|-
| '''LOSRequired'''
| Does this item require line of sight? (only applies to mind probes and psi-amps)
| false
|-
| '''skillApplied'''
| Is melee skill applied to the accuracy of an attack made with this object?
| true
|-
|}

=== UFOs ===

Defines one of the [[UFOs]] that invade Earth, listed in ''"ufos:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the UFO name.
| ''required''
|-
| '''size'''
| String ID of the UFO size.
| STR_VERY_SMALL
|-
| '''sprite'''
| Sprite ID from [[INTERWIN.DAT]] used to draw this UFO in the dogfight view and UFOpaedia.
don't try to add more images if you don't want to punch yourself in the face - use modsprite
| -1
|-
| '''modSprite'''
| Filename used to draw this UFO in the dogfight view and UFOpaedia.
| -
|-
| '''damageMax'''
| Maximum amount of damage this UFO can take. If the UFO takes 50% damage, it crash lands. If it takes 100% damage, it is destroyed.
| 0
|-
| '''speedMax'''
| Maximum speed in nautical miles.
| 0
|-
| '''accel'''
| Aceeleration value shown in the UFOpaedia.
| 0
|-
| '''power'''
| Damage power of this UFO's weapon in dogfights.
| 0
|-
| '''range'''
| Maximum range of this UFO's weapon in dogfights (in meters).
| 0
|-
| '''score'''
| [[Score]] gained when this UFO is destroyed, or half this score if it crash lands.
| 0
|-
| '''reload'''
| Time the UFO's weapon takes to fire between each shot.
| 0
|-
| '''breakOffTime'''
| Minimum amount of time for the UFO to be able to break off of a dogfight.
| 0
|-
| '''battlescapeTerrainData'''
| [[#Terrains|Terrain]] associated to this UFO in Battlescape missions.
| ''required''
|-
|}

=== Inventory Sections ===

Defines one of the sections of the [[Inventory TU Table|Battlescape inventory]] (eg. Backpack), listed in ''"invs:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the inventory name.
| ''required''
|-
| '''x'''
'''y'''
| Pixel coordinates of this section on the inventory screen.
| 0
0
|-
| '''type'''
| Type of this section:
* 0 = Slot section, can contain as many items as will fit on the slots.
* 1 = Hand section, can only contain one item regardless of size.
* 2 = Ground section, can contain infinite items.
| 0
|-
| '''slots'''
| List of the grid slots (''[x, y]'') that this section is composed of. For example, to make a 2x2 section, you would have ''[0, 0] [0, 1] [1, 0] [1, 1]''.
| -
|-
| '''costs'''
| List of [[Time Units]] costs to move an item from this section to another one (eg. ''STR_BACKPACK: 16'' means it will cost 16 TUs to move an item from this section to the Backpack).
| -
|-
|}

=== Terrains ===

Defines one of the [[TERRAIN|terrains]] used to generate a Battlescape map, listed in "terrains:".

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''name'''
| String ID of the terrain name.
| ''required''
|-
| '''largeBlockLimit'''
| Maximum amount of large blocks that can be used on map generation. (obsolete with nightly > 2014-11-19)
| 0
|-
| '''textures'''
| List of [[TEXTURE.DAT|Geoscape textures]] that correspond to this terrain.
| -
|-
| '''hemisphere'''
| Geoscape hemisphere associated with this terrain:
* -1 - Northern hemisphere.
* 0 - Both hemispheres.
* 1 - Southern hemisphere.
| 0
|-
| '''mapDataSets'''
| List of filenames (each with matching [[MCD]]/[[Image Formats#PCK|PCK/TAB]] files) that contain the tiles of this terrain.
| -
|-
| '''mapBlocks'''
| List of map blocks (see below) that are used for generating a map.
| -
|-
| '''roadTypeOdds'''
| Odds as a % of generating each type of road (E-W Road, N-S Road, Crossing) odds for crossing are: 100 - EW - NS. (obsolete with nightly > 2014-11-19)
| [0 0]
|-|-
| '''civilianTypes'''
| List of units to use as civilians for this mission.
| [MALE_CIVILIAN, FEMALE_CIVILIAN]
|-
|}

==== Map Blocks ====

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''name'''
| Filename of the [[MAPS|map]].
| ''required''
|-
| '''width'''
| Width of this map block in Battlescape grid units.
| 0
|-
| '''length'''
| Length of this map block in Battlescape grid units.
| 0
|-
| '''height'''
| Height of this map block in Battlescape grid units.
| 1
|-
| '''type'''
| Type of this map block:
(obsolete with nightly > 2014-11-19)
* -1 - Undefined
* 0 - Default
* 1 - Landing Zone (for placing X-COM / alien craft)
* 2 - E-W Road (for city maps)
* 3 - N-S Road (for city maps)
* 4 - Road Crossing (for city maps)
* 5 - Dirt (for filling empty base blocks)
* 6 - X-COM spawn point (for [[Alien Base]] / [[Cydonia]] missions)
* 7 - [[Alien Base]] Target
* 8 - [[Cydonia]] Target
| -1
|-
| '''subType'''
| Sub-type of this map block (see '''type'''). (obsolete with nightly > 2014-11-19)
| -1
|-
| '''frequency'''
| Frequency of this block in a map. (obsolete with nightly > 2014-11-19)
| 1
|-
| '''maxCount'''
| Maximum amount of times this block can be used in a map. If -1 there is no limit. (obsolete with nightly > 2014-11-19)
| -1
|-
| '''items'''
| An array of items to add to this mapblock, an the positions to place them at.
| -1
|}

*'''frequency''' defines the odds of the map appearing on the map
** The value assigned (default: 1) is used in ''x/n'', which defines the probability of being chosen.
** ''x'' is the integer defined for the map block's frequency and ''n'' is the combined total of probabilities for all the map types combined.
** This property can only be used in type 0 map blocks.
*'''maxCount''' is the maximum number of times it can be used.
** The value assigned is also used in ''x/n'' to determine the probability of being chosen.
** Each use reduces ''x'' by -1, with the caveat that being used as a Landing Zone type will not reduce the x value since it could result in no available Landing Zones.
** This property can only be used in type 0 map blocks.
* '''hemisphere''' only applies to UFO missions, not Terror ones.
*'''width/length''' defines the size of the map
** be aware that the mapview "width"-label is the openxcom ruleset length parameter
** be aware that the mapview "length"-label is the openxcom ruleset width parameter

==== Guidelines/Tips ====
* All maps with an XCOM/Alien craft require at least one type 1 map block. This map block can only contain ground tiles (no walls or objects), otherwise the game will crash or the walls/objects will be removed.
* All Terror terrains (listed under STR_TERROR_MISSION) require at least 1 map block of '''Types''' 2, 3 and 4 (for a total of 3 maps, which are required to place roads) and the corresponding '''roadTypeOdds''' added to the ruleset.
* If there isn't any map blocks designed as roads since you want to keep your terrain 'random', this can be circumvented by designating all 10x10 map blocks, excluding the one(s) used for the XCOM craft, as either '''Type''' 2, 3 and 4 and by defining their '''subType''' to 0. The game will then randomly choose between the map blocks for each type used in the roads, making them map more random.

=== Armor ===

Defines a Battlescape unit's [[armor]] as well as visual representation (so every unit has an armor), listed in ''"armors:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the armor name.
| ''required''
|-
| '''spriteSheet'''
| Sprite sheet from [[UNITS]] used to draw a unit wearing this armor.
| -
|-
| '''spriteInv'''
| Sprite used for the [[Inventory Backgrounds]] of a unit wearing this armor.
| -
|-
| '''corpseBattle'''
| List of string IDs of the corpse [[#Items|items]] generated when a unit wearing this armor is killed (one per unit tile) on the Battlescape.
| -
|-
| '''corpseGeo'''
| String ID of the corpse [[#Items|item]] associated with this unit on the Geoscape.
| -
|-
| '''storeItem'''
| String ID of the [[#Items|item]] that represents this armor in [[Base Stores]] for equipping.
| -
|-
| '''weight'''
| Physical weight of the armor when worn
| 6
|-
| '''stats'''
| like soldier stats (see below) but these are treated as stat bonuses for wearing the specific armor.
| -
|-
| '''frontArmor'''
| Protection provided on the front of the unit.
| 0
|-
| '''sideArmor'''
| Protection provided on the sides of the unit.
| 0
|-
| '''rearArmor'''
| Protection provided on the rear of the unit.
| 0
|-
| '''underArmor'''
| Protection provided under the unit (eg. from explosions).
| 0
|-
| '''drawingRoutine'''
| Drawing routine used to put together the body parts in the unit's '''spriteSheet''':
* 0 = [[Soldier]], [[Sectoid]]
* 1 = [[Floater]]
* 2 = [[HWP]]
* 3 = [[Cyberdisk]]
* 4 = [[Civilian]], [[Ethereal]]
* 5 = [[Sectopod]], [[Reaper]]
* 6 = [[Snakeman]]
* 7 = [[Chryssalid]]
* 8 = [[Silacoid]]
* 9 = [[Celatid]]
* 10 = [[Muton]]
* 11 = [[Submersible Weapons Systems]]
* 12 = [[Hallucinoid]]
* 13 = [[Aquanauts]]
* 14 = [[Calcinite]], [[Deep One]], [[Gillman]], [[Lobster Man]], [[Tasoth]]
* 15 = [[Aquatoid]]
* 16 = [[Bio-Drone]]
| 0
|-
| '''movementType'''
| Type of movement provided by this armor:
* 0 = Walking
* 1 = Flying
* 2 = Sliding (no walking animation)
it also defines the body of an tank (32-images) in your spriteSheet or the change in sprites while flying using a flying armour see: [[TANKS.PCK]], [[XCOM_2.PCK]]
| 0
|-
| '''damageModifier'''
| List of decimal damage modifiers (1.0 = 100%) this armor applies to each damage type (see [[#Items|Items section]]) received. Modifiers must be specified for all damage types, in this order:
* None
* Armor Piercing
* Incendiary
* High Explosive
* Laser
* Plasma
* Stun
* Melee
* Acid
* Smoke
|
- 1.0 
- 1.0 
- 1.0 
- 1.0 
- 1.0 
- 1.0 
- 1.0 
- 1.0 
- 1.0 
- 1.0
|-
| '''size'''
| Size of the unit wearing this armor, in Battlescape grid units. Every unit is square, so a size of 2 means 2x2.
| 1
|-
| '''loftempsSet'''
| List of [[LOFTEMPS]] IDs (one per unit tile, so a 1x1 unit has 1, a 2x2 unit has 4, etc.) used to represent a unit wearing this armor in 3D space.
| -
|-
| '''loftemps'''
| loftemps is a deprecated option that only works for 1x1 sized units.
| -
|-
| '''forcedTorso'''
| soldier sprites have female and male torsos. some armours reuse these sprites for flying/non flying torso without difference between genders. This can be controlled by the parameter: 0 = use genderrelated torso, 1 = use male torso, 2 = use female torso
| 0

|}

=== Player Units (Soldiers) ===

Defines a [[soldier]] recruited by X-COM, listed in ''"soldiers:"''. Currently only one soldier unit type (''XCOM'') is supported.

Unit stats are represented as follows:
* [[Time Units|tu]]
* [[Energy|stamina]]
* [[Health|health]]
* [[Bravery|bravery]] (always a multiple of 10)
* [[Reactions|reactions]]
* [[Firing Accuracy|firing]]
* [[Throwing Accuracy|throwing]]
* [[Strength|strength]]
* [[Psi Strength|psiStrength]]
* [[Psi Skill|psiSkill]]
* [[Melee Accuracy|melee]] (not visible)

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the soldier name.
| ''required''
|-
| '''minStats'''
| Minimum values used to generate the soldier's [[Starting Stats]]. In this case, ''psiSkill'' is treated as the initial stat (not generated).
| -
|-
| '''maxStats'''
| Maximum values used to generate the soldier's [[Starting Stats]]. In this case, ''psiSkill'' is treated as the minimum value for the first month of psi training (actual value is 100%-150%).
| -
|-
| '''statCaps'''
| Maximum stats this soldier can gain through [[Experience]]. '''NOTE:''' A stat will still go over the limit once, and then will no longer increase (see [[Experience#Regarding Caps|Regarding Caps]]).
| -
|-
| '''armor'''
| String ID of the [[#Armor|armor]] this soldier uses by default.
| -
|-
| '''standHeight'''
| Height of this soldier when standing.
| 0
|-
| '''kneelHeight'''
| Height of this soldier when kneeling.
| 0
|-
| '''floatHeight'''
| Distance between the bottom of this unit and the ground.
| 0
|-
| '''femaleFrequency'''
| The probability that a female soldier is hired.
| 50
|}

=== AI Units (Aliens/Civilians) ===

Defines an [[Alien Life Forms|alien]] (enemy) or [[civilian]] (neutral) unit, listed in ''"units:"''. Every different alien rank is a different unit, since they have completely different stats. Unit stats are represented as follows:
* [[Time Units|tu]]
* [[Energy|stamina]]
* [[Health|health]]
* [[Bravery|bravery]] (always a multiple of 10)
* [[Reactions|reactions]]
* [[Firing Accuracy|firing]]
* [[Throwing Accuracy|throwing]]
* [[Strength|strength]]
* [[Psi Strength|psiStrength]]
* [[Psi Skill|psiSkill]]
* [[Melee Accuracy|melee]] (not visible)

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the unit name.
| ''required''
|-
| '''race'''
| String ID of the unit race (for alien units).
| -
|-
| '''rank'''
| String ID of the unit rank (for alien units).
| -
|-
| '''stats'''
| Battlescape stats of this unit.
| -
|-
| '''armor'''
| String ID of the [[#Armor|armor]] this unit uses by default.
| -
|-
| '''standHeight'''
| Height of this unit when standing.
| 0
|-
| '''floatHeight'''
| Distance between the bottom of this unit and the ground.
| 0
|-
| '''value'''
| [[Score]] this unit is worth.
| 0
|-
| '''deathSound'''
| Sound ID from [[#Extra_Sounds|BATTLE.CAT]] played when this unit dies.
| -1
|-
| '''aggroSound'''
| Sound ID from [[#Extra_Sounds|BATTLE.CAT]] played when this unit aggros.
| -1
|-
| '''moveSound'''
| Sound ID from [[#Extra_Sounds|BATTLE.CAT]] played when this unit moves.
| -1
|-
| '''intelligence'''
| Intelligence of this unit's AI. The higher the value, the longer this unit remembers player troops between turns.
| 0
|-
| '''aggression'''
| Aggression of this unit's AI. The higher the value, the more ruthless the unit, the more likely to make a frontal assault. Less aggressive units tend to set up ambushes.
Vanilla values are:
* 0 = mostly passive
* 1 = balanced
* 2 = mostly aggresive
| 0
|-
| '''energyRecovery'''
| Energy recovered by the unit each turn (needs verification)
| 40 (?)
|-
| '''specab'''
| Special ability of this unit:
* 0 = None
* 1 = [[Cyberdisc|Explodes on Death]]
* 2 = [[Bio-Drone|Burns Floor]]
* 3 = Burns Floor and explodes on Death
| 0
|-
| '''spawnUnit'''
| String ID of the unit used to respawn on death (eg. [[Zombie]]s respawn as [[Chrysallid]]s).
| -
|-
| '''livingWeapon'''
| Is this unit a living weapon? (only attacks with a '''fixedWeapon''')
| false
|-
| '''female'''
| Is this unit a female? (used for TFTD civilian types)
| false
|-
|}

=== Alien Races ===

Defines a [[Alien Life Forms|race]] used in [[Alien Missions]], listed in ''"alienRaces:"''. Heavily tied with deployment data.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''id'''
| String ID of the alien race name.
| ''required''
|-
| '''members'''
| Alien crew associated with this alien race (eg. race units + terrorist units), defined by a list of unit string IDs. Order here will define rank in terms of deployment. generally speaking the order is:
* 0 - Commander
* 1 - Leader
* 2 - Engineer
* 3 - Medic
* 4 - Navigator
* 5 - Soldier
* 6 - Terrorist 1
* 7 - Terrorist 2
but of course, not all races have all ranks, so the "fill in" rank would be listed multiple times (see ethereals).
| -
|-
| '''retaliation'''
| retaliation enables/disables the race for retaliation missions.
| ''True''
|-
|}

=== Alien Deployments ===

Defines a Battlescape deployment data used in [[Alien Missions]] (such as alien and map configurations), listed in ''"alienDeployments:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the deployment name.
| ''required''
|-
| '''width'''
| Width of the Battlescape map in grid units.
| 0
|-
| '''length'''
| Length of the Battlescape map in grid units.
| 0
|-
| '''height'''
| Vertical height of the Battlescape map in grid units.
| 0
|-
| '''terrains'''
| list of string IDs of the [[#Terrains|terrain]] to choose from to generate this map. This is not used for UFO sites where the terrain comes from the Geoscape.
| -
|-
| '''shade'''
| Shade of the map (0-15, where 0 is full daytime and 15 is full nighttime). This is not used for UFO sites where the shade comes from the Geoscape.
| 0
|-
| '''nextStage'''
| String ID of the next deployment stage to use after this one, for multi-stage missions.
| -
|-
| '''race'''
| Sets the race to use in the next stage.
| ""
|-
| '''script'''
| Reference to a mapScript.
| ""
|-
| '''data'''
| List of deployment data for each alien rank on this mission (see below).
| -
|}

Notes:
* '''terrains''' can also be used with UFOs, with the game using instead the listed terrain rather than the location of the UFO on Geoscape.
==== Deployment Data ====

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''alienRank'''
| [[Alien Rank|Rank]] associated with this deployment data, as defined by the order of the race in question (see above)
| ''required''
|-
| '''lowQty'''
| Maximum quantity of aliens to spawn (beginner).
| 0
|-
| '''highQty'''
| Maximum quantity of aliens to spawn (superhuman).
| 0
|-
| '''dQty'''
| Minimum Desired Quantity of aliens to spawn.
| 0
|-
| '''extraQty'''
| spawns a random number of additional aliens.
| 0
|-
| '''percentageOutsideUfo'''
| Percentage (0-100%) of aliens to spawn outside in UFO sites.
| 0
|-
| '''itemSets'''
| Three lists (one for each alien technology level) of [[#Items|items]] (string IDs) for the aliens to equip.
| ''required''
|-
|}

=== Research ===

Defines a [[Research|research topic]] that X-COM scientists can investigate, listed in ''"research:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''name'''
| String ID of the research project's name (or item, if a '''lookup''' is defined).
| ''required''
|-
| '''lookup'''
| String ID of the research project's display name and UFOPaedia article reference.
| -
|-
| '''cost'''
| Number of man hours (on average) required to complete this project.
| 0
|-
| '''points'''
| [[Score]] earned for completing this project.
| 0
|-
| '''needItem'''
| Does this project require an [[#Items|item]] of the same name?
| false
|-
| '''dependencies'''
| List of research projects that can unlock access to this one. If the full list is researched, or if one of the projects on the list "unlocks" this one, it becomes available.
| -
|-
| '''unlocks'''
| List of research projects unlocked, regardless of other dependencies, but not requirements, by completing this project (for example, any live alien unlocks "alien origins").
| -
|-
| '''requires'''
| List of research projects unilaterally required before this project can be unlocked (for example, "the martian solution" will not even be considered for unlocking until AFTER "alien origins" is completed).
| -
|-
| '''getOneFree'''
| List of "bonus" research projects that may be granted when completing this project (for example, alien medics will give you information on other alien races). Only applies to living aliens.
| -
|-
|}

=== Manufacture ===

Defines a [[Manufacture|manufacture project]] that X-COM engineers can produce, listed in ''"manufacture:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''name'''
| String ID of the manufacturing project's name (and the item it produces).
| ''required''
|-
| '''category'''
| String ID of the manufacturing project's category.
| -
|-
| '''requires'''
| List of [[#Research|topics]] (string IDs) that must be researched to unlock this project. If none are specified, this project is unlocked from the start.
| -
|-
| '''space'''
| Amount of [[Workshop]] space required to begin this project.
| 0
|-
| '''time'''
| Number of man hours (on average) required per item.
| 0
|-
| '''cost'''
| Monetary deduction per item manufactured.
| 0
|-
| '''requiredItems'''
| List of [[#Items|items]] required and consumed per item manufactured.
| -
|-
| '''producedItems'''
| List of [[#Items|items]] produced per each item consumed. If not specified, defaults to 1 item with the same string ID as the manufacture.
| 1
|-
|}

=== UFOpaedia Article ===

Defines an article in the in-game [[UFOpaedia]], listed in ''"ufopaedia:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''id'''
| String ID of the article name. This must match the ID of the object associated with this article, if applicable.
| ''required''
|-
| '''title'''
| String ID of the article title. If omitted, the '''id''' is used.
| -
|-
| '''type_id'''
| Type of this article:
* 0 = Unknown
* 1 = [[Craft]]
* 2 = [[Craft Armaments]]
* 3 = [[HWP]]
* 4 = [[Equipment (EU)|Equipment]]
* 5 = [[Armour]]
* 6 = [[Base Facilities]]
* 7 = Text & Image (eg. [[Alien Life Forms]], [[UFO Components]])
* 8 = Text (eg. [[Alien Research]])
* 9 = [[UFO]]
* 10 = [[TFTD]]
* 11 = TFTD [[Subs]]
* 12 = TFTD [[Sub_Armaments]]
* 13 = TFTD [[Submersible_Weapons_Systems]]
* 14 = TFTD [[Equipment_(TFTD)]]
* 15 = TFTD Armour
* 16 = TFTD [[Base_Facilities_(TFTD)]]
* 17 = TFTD [[Alien_Subs]]
| 0
|-
| '''section'''
| String ID of the UFOpaedia section this article belongs in.
| -
|-
| '''requires'''
| List of [[#Research|topics]] (string IDs) that must be researched to unlock this article. If none are specified, this article is unlocked from the start.
| -
|-
| '''image_id'''
| Filename of the [[UP001.SPK-UP042.SPK|background image]] displayed on this article, if applicable.
| -
|-
| '''text'''
| String ID of the description displayed on this article.
| -
|-
| '''text_width'''
| Maximum width of the text displayed, only applicable to ''Text & Image'' articles.
| 150
|-
| '''rect_stats'''
| Rectangle ('''x''', '''y''', '''width''', '''height''') of the stats text on the screen, only applicable to ''Craft'' articles.
| 0
|-
| '''rect_text'''
| Rectangle ('''x''', '''y''', '''width''', '''height''') of the description text on the screen, only applicable to ''Craft'' articles.
| 0
|-
| '''weapon'''
| String ID of the weapon, only applicable to ''HWP'' articles.
| -
|}

=== UFO Trajectories ===

Defines a trajectory carried out by an UFO during an [[#Alien Missions|alien mission]], listed in ''"ufoTrajectories:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''id'''
| String ID of the trajectory name.
| ''required''
|-
| '''groundTimer'''
| Amount of seconds for the UFO to spend on Ground waypoints.
| 0
|-
| '''waypoints'''
| List of waypoints for the UFO to traverse, defined as ''[zone, altitude, speed]''. 
'''zone''': Globe zone where the waypoint is located. 
'''altitude''': UFO altitude after reaching this waypoint:
* 0 - Ground
* 1 - Very Low
* 2 - Low
* 3 - High
* 4 - Very High
'''speed''': UFO speed after reaching this waypoint, as a percentage (0-100%) of its maximum speed.
| -
|}

=== Alien Missions ===

Defines an [[Alien Missions|alien mission]] carried out by UFOs on the Geoscape, listed in ''"alienMissions:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the mission type.
| ''required''
|-
| '''points'''
| [[Score]] allocated to aliens for successfully completing this mission.
| 0
|-
| '''raceWeights'''
| List of alien races likely to carry out this mission, and the % chance of them being allocated to this mission, listed by "number of months after game beginning".
| ''required''
|-
| '''waves'''
| List of UFO waves to spawn as this mission progresses, as described below.
| ''required''
|}

==== Waves ====

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''ufo'''
| String ID of the [[#UFOs|UFO]] to spawn.
| ''required''
|-
| '''count'''
| Number of UFOs to spawn.
| 0
|-
| '''trajectory'''
| String ID of the [[#UFO Trajectories|trajectory]] for this UFO to use when entering Earth's atmosphere.
| ''required''
|-
| '''timer'''
| How long after the previous wave should this wave arrive? (in seconds)
| 0
|-
|}

=== Alien Item Levels ===

This is a list of item level probabilities, with a number between 0 and 2 representing an item level from plasma pistols to heavy plasmas, as defined in the deployments, expressing a 10% probability for that item level being used.

0 = first set (plasma pistol/clip)
1 = second set (plasma rifle/clip)
2 = third set (heavy plasma/clip)

For example:
[ 2, 0, 0, 0, 0, 0, 0, 1, 1, 1 ]
would represent a 60% chance for pistols, 30% rifles, and 10% heavy weapons. 
Note that the order does not matter, but the length DOES. each line MUST have 10 digits.

The above can be confusing. There are 10 fields; each number represents 10%. 
There are six instances of '0'. 6x10% = 60% chance of plasma pistol 
There are three instances of '1'. 3x10% = 30% chance of plasma rifle 
There is only one instance of '2'. 1x10% = 10% chance of heavy plasma 

Each line represents a month after the beginning of the game, and there is no limit to the number defined. 
OpenXCom will use the most recently available item level in the event the game goes on forever.

=== Extra Sprites ===

Adds or replaces sprites in an existing [[Image Formats|X-COM image file]], listed in ''"extraSprites:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| Filename of the original/new image to modify.
| ''required''
|-
| '''width'''
'''height'''
| Size of the sprite(s) in pixels.
| 0
0
|-
| '''singleImage'''
| Is the image file just a single sprite (true) or a spritesheet (false)?
| false
|-
| '''subX'''
'''subY'''
| Size of the subdivision in pixels. If a subdivision is specified, then the image file is divided into chunks to form the sprites (eg. spritesheets).
| 0
0
|-
| '''files'''
| List of the new sprites to add/replace, listed as ''spriteID: filename''.
| -
|}

Example:
- type: GIANTBUNNY.PCK
width: 32
height: 40
files:
0: Resources/Bunny/Bunny00.png
1: Resources/Bunny/Bunny01.bmp
2: Resources/Bunny/Bunny02.gif

=== Extra Sounds ===

Adds or replaces sounds in an existing [[SOUND|X-COM sound file]], listed in ''"extraSounds:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| ID of the original sound file to modify:
* BATTLE.CAT - Battlescape sounds, corresponds to ''SOUND1.CAT'' or ''SAMPLE2.CAT'' (55 sounds).
* INTRO.CAT - Intro sounds, corresponds to ''INTRO.CAT'' or ''SAMPLE3.CAT'', probably best not to mess with these.
* GEO.CAT - Geoscape sounds, corresponds to ''SOUND2.CAT'' or ''SAMPLE.CAT'' (14 sounds).
| ''required''
|-
| '''files'''
| List of the new sounds to add/replace, listed as ''soundID: filename''.
| -
|}

Example:
- type: BATTLE.CAT
files:
55: Resources/Sounds/sample.wav

=== Extra Strings ===

Adds or replaces text strings in an existing [[Translations (OpenXcom)|OpenXcom language file]], listed in ''"extraStrings:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| Filename of the original language file to modify, sans extension.
| ''required''
|-
| '''strings'''
| List of the new strings to add/replace, listed as ''stringID: text''.
| -
|}

Example:
- type: en-US
strings:
STR_SNIPER_RIFLE: Sniper Rifle
STR_SNIPER_RIFLE_CLIP: Sniper Rifle Clip
- type: en-GB
strings:
STR_SNIPER_RIFLE: Sniper Rifle
STR_SNIPER_RIFLE_CLIP: Sniper Rifle Clip
- type: de
strings:
STR_SNIPER_RIFLE: Scharfschützengewehr
STR_SNIPER_RIFLE_CLIP: Scharfschützengewehrmunition
- type: ru
strings:
STR_SNIPER_RIFLE: Снайперская винтовка
STR_SNIPER_RIFLE_CLIP: Магазин к снайп. винтовке

=== Interfaces ===

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| ''?''
| -
|-
| '''elements'''
| ''?''
| -
|-
| '''id'''
| ''?''
| -
|-
| '''color'''
| ''?''
| -
|}

=== StatStrings ===

[[Statstrings]] are used for automatically renaming soldiers. They are case sensitive and they are processed in the order in which they are specified.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''string'''
| String to add to name.
| ''required''
|-
| '''psiStrength''' 
'''psiSkill''' 
'''bravery''' 
'''strength''' 
'''firing''' 
'''reactions''' 
'''stamina''' 
'''tu''' 
'''health''' 
'''throwing'''
| One or more stat ranges are ANDed together for success. Each range has a minVal and maxVal. Use YAML standard tilde (~) to indicate null. ((~) = 0 as minvalue; (~) =255 as maxvalue)
| -
|}

Example:
statStrings:
- string: "x"
psiStrength: [~, 30]
- string: "P"
psiStrength: [80, ~]
- string: "p"
psiStrength: [60, 79]
- string: "K"
psiSkill: [60, ~]
- string: "k"
psiSkill: [30, 59]
- string: "b"
bravery: [60, ~]
- string: "c"
bravery: [~, 10]
- string: "w"
strength: [~, 25]
- string: "Snpr"
firing: [60, ~]
reactions: [60, ~]
- string: "M"
firing: [70, ~]
- string: "m"
firing: [60, 69]
- string: "Sct"
reactions: [50, ~]
tu: [60, ~]
- string: "R"
reactions: [60, ~]
- string: "r"
reactions: [50, 59]

==References==
<references />

[[Category:OpenXcom]]

Ruleset Reference (OpenXcom)

2014-12-04T22:42:58Z

Falko: /* UFOpaedia Article */

A reference of all the customizable values of everything in a [[Rulesets (OpenXcom)|ruleset]]. Some guidelines:
* If a value is omitted from the ruleset, the default is used. You cannot omit ''required'' values.
* Text strings (eg. names) are represented by string IDs from the [[Translations (OpenXcom)|language files]]
* Numerical IDs (used for sprites, sounds, etc.) start at 0, not 1.
* Boolean (yes/no) values are represented by true/false.
* World coordinates are represented in degrees (see [[WORLD.DAT]]).
* Money amounts (prices, costs, etc.) are represented in dollars.
* All paths are '''case sensitive'''! If your ruleset uses external files, make sure that they named properly as described in ruleset.

Items are ordered as they come in the ruleset. To override this, you can specify a ''listOrder''. You can find the default listOrders in [[Ruleset List Order (OpenXcom)|Ruleset List Order]].

=== Globe ===

Defines the drawing of landmasses and borders on the globe.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''data'''
| Path name of file which contains polygon and texture information. (For example WORLD.DAT).
| -
|-
| '''polygons'''
| List of polygons drawn on the globe surface. A triangle consist of seven values: the first number defines the texture, followed by three pairs of (x,y) globe coordinates. Only polygons with 3 or 4 vertices are reliable shown on the globe = 7 or 9 values per entry.
| -
|-
| '''polylines'''
| List of border lines. Each list entry consist of a list of (x,y) globe coordinates.
| -
|}

=== Countries ===

Defines one of the [[Country Funding (EU)|funding nations]], listed in ''"countries:"''. They're used for activity graphs and player scoring.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the country name.
| ''required''
|-
| '''fundingBase'''
| Country's base funding, in thousands. The starting funding can be anywhere between 1x and 2x the base funding.
| 0
|-
| '''fundingCap'''
| Country's funding cap, in thousands. Once a country reaches this maximum, it will no longer increase its funding.
| 0
|-
| '''labelLon'''
'''labelLat'''
| Longitude and latitude coordinates of the country's label on the globe. This label is only shown when the globe is zoomed in and "detail" is turned on.
| 0.0
0.0
|-
| '''areas'''
| List of "rectangles" on the globe defined as [''lon1'' ''lat1'' ''lon2'' ''lat2'']. Any activity within these areas counts towards the country's graph activity and affects their opinion of the player.
| -
|}

=== Regions ===

Defines one of the [[Geoscape (EU)#World Regions/Countries|world regions]], listed in ''"regions:"''. They're used for base placement, activity graphs and mission spawning.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the region name.
| ''required''
|-
| '''cost'''
| Amount of money spent building an X-COM base in this region (first base is free).
| 0
|-
| '''areas'''
| List of "rectangles" on the globe defined as ''[lon1, lat1, lon2, lat2]''. Any activity within these areas counts towards the region's graph activity.
| -
|-
| '''cities'''
| List of cities belonging to this region. They will be displayed on the globe and used for terror site missions. Each city is defined by their '''lon''' and '''lat''' coordinates and a '''name''' string ID.
| -
|-
| '''regionWeight'''
| Weight of this region when selecting regions for alien missions.
| 0
|-
| '''missionWeights'''
| Weighted list of the different mission types for this region (eg. ''STR_ALIEN_RESEARCH: 14'').
| -
|-
| '''missionZones'''
| List of "rectangles" (''[lon1, lat1, lon2, lat2]'') defining the mission zones for this region. Mission zones are waypoints for UFO trajectories.
| -
|-
| '''missionRegion'''
| Spawn mission in this region instead (used for regions without land).
| -
|}

=== Base Facilities ===

Defines one of the [[Base Facilities (EU)|facilities]] that can be built in an X-COM base, listed in ''"facilities:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the facility name.
| ''required''
|-
| '''requires'''
| List of [[#Research|topics]] (string IDs) that must be researched to unlock this facility. If none are specified, this facility is unlocked from the start.
| -
|-
| '''spriteShape'''
| Sprite ID from [[BASEBITS.PCK]] used to draw the facility's outer shape in the Basescape and UFOpaedia.
| -1
|-
| '''spriteFacility'''
| Sprite ID from [[BASEBITS.PCK]] used to draw the facility's contents in the Basescape and UFOpaedia. Drawn on top of '''spriteShape'''.
| -1
|-
| '''lift'''
| Is this facility an [[Access Lift]]? All base facilities must be connected to the lift.
| false
|-
| '''hyper'''
| Is this facility a [[Hyperwave Decoder]]? Displays extra information for detected UFOs. Only valid for radar facilities.
| false
|-
| '''mind'''
| Is this facility a [[Mind Shield]]? Reduces the chance of UFOs finding your base. Does not stack.
| false
|-
| '''grav'''
| Is this facility a [[Grav Shield]]? Doubles the power of your base defenses. Does not stack.
| false
|-
| '''size'''
| Size of the facility, in grid units. Every facility is square, so a size of 1 means 1x1, 2 means 2x2, etc. Bigger facilities are made up of multiple sprites, for example a 2x2 facility will use 4 sprites for '''spriteShape''' and 4 sprites for '''spriteFacility''' (top-left, top-right, bottom-left, bottom-right).
| 1
|-
| '''buildCost'''
| Amount of money spent to build this facility in the base.
| 0
|-
| '''buildTime'''
| Amount of days it takes for this facility to be built.
| 0
|-
| '''monthlyCost'''
| Amount of money spent monthly for the maintenance of this facility.
| 0
|-
| '''storage'''
| Amount of storage space (for items) this facility provides. See [[Base Stores]].
| 0
|-
| '''personnel'''
| Amount of personnel (soldiers, scientsts, engineers) these quarters can contain.
| 0
|-
| '''aliens'''
| Amount of live aliens this facility can contain. Only checked if the ''alienContainmentLimitEnforced'' option is enabled.
| 0
|-
| '''crafts'''
| Amount of X-COM craft this facility can contain.
| 0
|-
| '''labs'''
| Amount of lab space this facility provides for research projects.
| 0
|-
| '''workshops'''
| Amount of workshop space this facility provides for manufacture projects.
| 0
|-
| '''psiLabs'''
| Amount of soldier space this facility provides for psionic training.
| 0
|-
| '''radarRange'''
| Maximum radar detection range of this facility, in nautical miles.
| 0
|-
| '''radarChance'''
| Chance (0-100%) of this radar detecting a UFO that enters its range.
| 0
|-
| '''defense'''
| Offensive power provided by this base defense against attacking UFOs.
| 0
|-
| '''hitRatio'''
| Chance (0-100) of the base defense hitting an attacking UFO.
| 0
|-
| '''fireSound'''
| Sound ID from [[#Extra_Sounds|GEO.CAT]] played when the base defense fires.
| -1
|-
| '''hitSound'''
| Sound ID from [[#Extra_Sounds|GEO.CAT]] played when the base defense hits a target.
| -1
|-
| '''mapName'''
| [[MAPS|Map]] associated to this facility in Battlescape base defenses.
| -
|-
|}

=== Crafts ===

Defines one of the [[Craft|X-COM crafts]] that go on interception missions, listed in ''"crafts:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the craft name.
| ''required''
|-
| '''requires'''
| List of [[#Research|topics]] (string IDs) that must be researched to unlock this craft. If none are specified, this craft is unlocked from the start.
| -
|-
| '''sprite'''
| Sprite ID from [[BASEBITS.PCK]] used to draw this craft in the Basescape and from [[INTICON.PCK]] used to draw the damage indicator in dogfights.
modders: the corresponding extrasprite file id for BASEBITS.PCK is sprite+33 INTICON.PCK contains a minimized icon id=sprite the file id for the dogfight image is sprite+11
| -1
|-
| '''fuelMax'''
| Maximum amount of fuel this craft can carry. Crafts use up fuel based on their speed while travelling.
| 0
|-
| '''damageMax'''
| Maximum amount of damage this craft can take. If this amount is exceeded, the craft is destroyed.
| 0
|-
| '''speedMax'''
| Maximum speed in nautical miles. Crafts travel at max speed when flying and half speed when patrolling.
| 0
|-
| '''accel'''
| Aceeleration value shown in the UFOpaedia.
| 0
|-
| '''weapons'''
| Amount of craft weapons this craft can equip. The UI can only display a max of 2 weapons.
| 0
|-
| '''soldiers'''
| Amount of soldiers this craft can carry.
| 0
|-
| '''maxItems'''
| Amount of items this craft can carry.
| 80
|-
| '''vehicles'''
| Amount of vehicles this craft can carry.
| 0
|-
| '''costBuy'''
| Amount of money spent for purchasing this craft. If set to 0, the craft will not be available in the Purchase/Recruit screen.
| 0
|-
| '''costRent'''
| Amount of money spent monthly for renting this craft. If set to 0, the craft is not on rental and won't count towards base maintenance.
| 0
|-
| '''costSell'''
| Amount of money gained for selling this craft.
| 0
|-
| '''refuelItem'''
| Item required for refuelling this craft. If no item is specified, the craft uses human fuel.
| 0
|-
| '''repairRate'''
| Amount of damage restored every hour while [[Repairs|Repairing]] in base.
| 1
|-
| '''refuelRate'''
| Amount of fuel restored every 30 mins while [[Refueling]] in base. If specified, a '''refuelItem''' is spent each time.
| 1
|-
| '''radarRange'''
| Detection range of the craft's radar in nautical miles. Every craft radar has a 100% detection chance.
| 600
|-
| '''transferTime'''
| Number of hours it takes to purchase/transfer this craft to a base.
| 0
|-
| '''score'''
| [[Score]] lost when this craft is destroyed.
| 0
|-
| '''spacecraft'''
| Can this craft go to [[Cydonia]]?
| false
|-
| '''battlescapeTerrainData'''
| [[#Terrains|Terrain]] associated to this craft in Battlescape missions.
| -
|}

=== Craft Weapons ===

Defines one of the [[Craft Armaments|weapons]] equipped by X-COM craft for shooting down UFOs, listed in ''"craftWeapons:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the weapon name.
| ''required''
|-
| '''sprite'''
| Sprite ID from [[BASEBITS.PCK]] used to draw the weapon in the Basescape and from [[INTICON.PCK]] used to draw the weapon in dogfights.
modders: the corresponding extrasprites file id for INTICON.PCK is sprite+5 and sprite+48 for BASEBITS.PCK
| -1
|-
| '''sound'''
| Sound ID from [[#Extra_Sounds|GEO.CAT]] played when this weapon fires.
| -1
|-
| '''damage'''
| Amount of damage this weapon does to enemy UFOs.
| 0
|-
| '''range'''
| Maximum range of this weapon in dogfights (in meters).
| 0
|-
| '''accuracy'''
| Chance (0-100%) of each shot hitting the enemy UFO.
| 0
|-
| '''reloadCautious'''
| Time this weapon takes to fire between each shot in ''Cautious Mode''.
| 0
|-
| '''reloadStandard'''
| Time this weapon takes to fire between each shot in ''Standard Mode''.
| 0
|-
| '''reloadAggressive'''
| Time this weapon takes to fire between each shot in ''Aggressive Mode''.
| 0
|-
| '''ammoMax'''
| Maximum amount of ammo this weapon can carry.
| 0
|-
| '''rearmRate'''
| Amount of ammo restored every 30 mins while the craft is [[Rearming]] in base. If specified, '''clip'''s are spent depending on their '''clipSize'''. If the '''clipSize''' of the specified ammo is 0, no '''clip'''s are spent.
| 1
|-
| '''projectileType'''
| Type of the weapon projectile, used for the projectile sprite in dogfights:
* 0 - [[Stingray]]
* 1 - [[Avalanche]]
* 2 - [[Cannon]]
* 3 - [[Fusion Ball]]
* 4 - [[Laser Cannon]]
* 5 - [[Plasma Beam]]
| 2
|-
| '''projectileSpeed'''
| Speed of the weapon projectile in dogfights.
| 0
|-
| '''launcher'''
| String ID of the [[#Items|item]] required to equip this weapon.
| -
|-
| '''clip'''
| String ID of the [[#Items|item]] required to rearm this weapon.
| -
|}

=== Items ===

Defines the Geoscape and Battlescape properties of an [[Equipment (EU)|item]] that can be stored in X-COM bases, listed in ''"items:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the internal item name.
| ''required''
|-
| '''name'''
| String ID of the displayed item name, for cases where it's different from the internal name. If omitted, '''type''' is used.
| -
|-
| '''requires'''
| List of [[#Research|topics]] (string IDs) that must be researched to unlock this item. If none are specified, this item is unlocked from the start. Soldiers can only use unlocked items in the Battlescape.
| -
|-
| '''size'''
| Space occupied by this item in [[Base Stores]]. Can be a decimal value.
| 0.0
|-
| '''costBuy'''
| Amount of money spent for purchasing this item. If set to 0, this item will not be available in the Purchase/Recruit screen.
| 0
|-
| '''costSell'''
| Amount of money gained for selling this item.
| 0
|-
| '''transferTime'''
| Number of hours it takes to purchase/transfer this item to a base.
| 24
|-
| '''weight'''
| [[Item_Weight|Weight]] occupied by this item in a soldier's inventory.
| 999
|-
| '''bigSprite'''
| Sprite ID from [[BIGOBS.PCK]] used to draw this item in a soldier's inventory and UFOpaedia.
| -1
|-
| '''floorSprite'''
| Sprite ID from [[FLOOROB.PCK]] used to draw this item on the floor of a Battlescape tile.
| -1
|-
| '''handSprite'''
| Sprite ID from [[HANDOB.PCK]] used to draw this item on a soldier's hand in the Battlescape.
modders: each handobject needs 8 images (8 directions) define the extrasprites accordingly
| 120
|-
| '''bulletSprite'''
| Sprite ID from ''BulletSprites.png'' used to draw this weapon's projectile on the Battlescape:
* 0 - [[Rocket Launcher]]
* 1 - [[Pistol]]
* 2 - [[Rifle]]
* 3 - [[Auto Cannon]]
* 4 - [[Heavy Cannon]]
* 5 - [[Laser Pistol]]
* 6 - [[Laser Rifle]]
* 7 - [[Heavy Laser]]
* 8 - [[Plasma Rifle|Plasma]]
* 9 - [[Small Launcher]]
* 10 - [[Blaster Launcher]]
for modders: the bulletsprite needs to be put into the extraSprites type "Projectiles" the bulletsprite can contain up to 35 3x3 images. The corresponding file id is 35*[bulletSprite]
| -1
|-
| '''fireSound'''
| Sound ID from [[#Extra_Sounds|BATTLE.CAT]] played when this weapon fires.
| -1
|-
| '''hitSound'''
| Sound ID from [[#Extra_Sounds|BATTLE.CAT]] played when this weapon hits a target.
| -1
|-
| '''hitAnimation'''
| Sprite ID from [[SMOKE.PCK]] used to draw the weapon's "hit explosion".
'''NOTE''': Do not define this value for melee/psi weapons, they use [[HIT.PCK]] and therefore meleeAnimation instead.
| 0
|-
| '''power'''
| Average damage of the weapon, in most cases it will be +-50% this value.
| 0
|-
| '''strengthApplied'''
| Add the attacking unit's strength to this weapon's damage.
| false
|-
| '''compatibleAmmo'''
| List of string IDs of the ammo items that can be loaded on this weapon. If none are specified, the weapon doesn't need ammo.
| -
|-
| '''damageType'''
| What type of [[damage]] does this weapon do:
* 0 - None
* 1 - Armor Piercing
* 2 - Incendiary
* 3 - High Explosive
* 4 - Laser
* 5 - Plasma
* 6 - Stun
* 7 - Melee
* 8 - Acid
* 9 - Smoke
'''NOTE:''' A damage type other than 0-9 will do nothing.
| 0
|-
| '''tuAuto'''
'''accuracyAuto'''
| The percentage (0-100%) of [[Time Units]] (from the soldier's total) required to fire an Auto Shot. If 0, the weapon does not have an Auto Shot.
The base accuracy (0-100%) applied to a soldier's [[Firing Accuracy]] when firing an Auto Shot.
| 0
0
|-
| '''tuSnap'''
'''accuracySnap'''
| The percentage (0-100%) of [[Time Units]] (from the soldier's total) required to fire a Snap Shot. If 0, the weapon does not have a Snap Shot.
The base accuracy (0-100%) applied to a soldier's [[Firing Accuracy]] when firing a Snap Shot.
| 0
0
|-
| '''tuAimed'''
'''accuracyAimed'''
| The percentage (0-100%) of [[Time Units]] (from the soldier's total) required to fire an Aimed Shot. If 0, the weapon does not have an Aimed Shot.
The base accuracy (0-100%) applied to a soldier's [[Firing Accuracy]] when firing an Aimed Shot.
| 0
0
|-
|-
| '''tuMelee'''
'''accuracyMelee'''
| The percentage (0-100%) of [[Time Units]] (from the soldier's total) required to do a melee attack (Hit). If 0, the weapon does not have a melee attack.
The base accuracy (0-100%) applied to a soldier's [[Melee Accuracy]] when doing a melee attack.
| 0
0
|-
| '''clipSize'''
| The amount of ammo stored in each weapon clip. If -1 is specified, this weapon has infinite ammo.
| 0
|-
| '''battleType'''
| Defines the weapon's behavior in the Battlescape:
* 0 - None (Geoscape-only item)
* 1 - [[Weapons|Firearm]]
* 2 - Ammo
* 3 - Melee
* 4 - [[Grenade]]
* 5 - [[Proximity Grenade]]
* 6 - [[Medi-Kit (EU)|Medi-Kit]]
* 7 - [[Motion Scanner]]
* 8 - [[Mind Probe]]
* 9 - [[Psi-Amp]]
* 10 - [[Electro-flare]]
* 11 - Corpse
| 0
|-
| '''twoHanded'''
| Is this weapon two-handed? If true, incurs an accuracy penalty if used with both hands occupied. Note that the handsprite of a twoHanded item is also drawn at a slightly different position than a one handed item.
| false
|-
| '''waypoint'''
| Does this weapon use waypoints? (eg. [[Blaster Launcher]]). Can also be used to make ammo items use the waypoint system.
| false
|-
| '''fixedWeapon'''
| Is this weapon fixed? (it's part of a unit, eg. tanks and terrorist units)
| false
|-
| '''invWidth'''
| Item width in a soldier's inventory (in grid units).
| 1
|-
| '''invHeight'''
| Item height in a soldier's inventory (in grid units).
| 1
|-
| '''painKiller'''
| Amount of painkillers contained in a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''heal'''
| Amount of heal's contained in a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''stimulant'''
| Amount of stimulants contained in a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''woundRecovery'''
| Amount of [[Fatal Wounds]] treated by each heal of a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''healthRecovery'''
| Amount of [[Health]] recovered by each heal of a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''stunRecovery'''
| Amount of [[Stun]] removed by each stimulant of a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''energyRecovery'''
| Amount of [[Energy]] recovered by each stimulant of a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''tuUse'''
| Amount of [[Time Units]] required to use this item (for non-offensive items). It's a flat rate if '''flatRate''' is true, otherwise it's a percentage (0-100%).
| 0
|-
| '''recoveryPoints'''
| [[Score]] gained for recovering this alien artifact.
| 0
|-
| '''armor'''
| How much damage is needed to destroy this item on the ground.
| 20
|-
| '''recover'''
| Is this item recoverable? (gets transported to the X-COM base on mission success)
| true
|-
| '''turretType'''
| Sprite ID from [[TANKS.PCK]] of the turret to assign to this tank:
* 0 - [[Tank/Cannon]]
* 1 - [[Tank/Rocket Launcher]]
* 2 - [[Tank/Laser Cannon]]
* 3 - [[Hovertank/Plasma]]
* 4 - [[Hovertank/Launcher]]
| -1
|-
| '''liveAlien'''
| Does this item represent a live alien? (counts towards [[Alien Containment]])
| false
|-
| '''blastRadius'''
| Size of the projectile explosions. 0 for no explosion. -1 to automatically calculate based on weapon power and damage type (actual '''blastRadius''' currently is capped due [[Explosions#Playing_With_Fire|Explosion calculations]]).
| -1
|-
| '''flatRate'''
| If true, then TU costs for this weapon are a flat rate (instead of a percentage of unit TUs).
| false
|-
| '''arcingShot'''
| Does this weapon fire in an arc?
| false
|-
| '''attraction'''
| Represents how likely an alien is to pick up this item. Values below 5 will be ignored (by design).
| 0
|-
| '''maxRange'''
| Maximum range at which this weapon can operate.
| 200
|-
| '''aimRange'''
| Maximum effective range with this weapon before which range-based dropoff occurs.
| 200
|-
| '''snapRange'''
| Maximum effective range with snap shot before which range-based dropoff occurs. (ufoextender accuracy only)
| 15
|-
| '''autoRange'''
| Maximum effective range with auto shot before which range-based dropoff occurs. (ufoextender accuracy only)
| 7
|-
| '''minRange'''
| Range-based dropoff will work in reverse for ranges below this.
| 0
|-
| '''dropoff'''
| The value by which the accuracy lowers for each tile after (or before) the thresholds above.
| 2
|-
| '''bulletSpeed'''
| How much faster (or slower, if you use a negative number) is a projectile fired from this weapon compared to the average.
| 0
|-
| '''autoShots'''
| How many auto shots does this weapon fire.
| 3
|-
| '''shotgunPellets'''
| Number of projectiles fired per unit of ammunition. (note: due to engine limitations it is currently impossible to draw multiple projectiles in flight.)
| 0
|-
| '''zombieUnit'''
| String ID of the unit used for zombification (eg. [[Chrysallid]]s turn units into [[Zombie]]s).
| none
|-
| '''meleeSound'''
| Sound ID from [[#Extra_Sounds|BATTLE.CAT]] played when this weapon attacks a target with melee.
| 39
|-
| '''meleeHitSound'''
| Sound ID from [[#Extra_Sounds|BATTLE.CAT]] played when this weapon HITS a target with melee.
| -1
|-
| '''meleeAnimation'''
| Sprite ID from HIT.PCK played when this weapon attacks a target with melee.
| 0
|-
| '''meleePower'''
| Damage this weapon will do when using melee. This only applies to Firearms, and is only available as stun damage. For normal melee weapons, use regular power and damage types.
| 0
|-
| '''LOSRequired'''
| Does this item require line of sight? (only applies to mind probes and psi-amps)
| false
|-
| '''skillApplied'''
| Is melee skill applied to the accuracy of an attack made with this object?
| true
|-
|}

=== UFOs ===

Defines one of the [[UFOs]] that invade Earth, listed in ''"ufos:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the UFO name.
| ''required''
|-
| '''size'''
| String ID of the UFO size.
| STR_VERY_SMALL
|-
| '''sprite'''
| Sprite ID from [[INTERWIN.DAT]] used to draw this UFO in the dogfight view and UFOpaedia.
don't try to add more images if you don't want to punch yourself in the face - use modsprite
| -1
|-
| '''modSprite'''
| Filename used to draw this UFO in the dogfight view and UFOpaedia.
| -
|-
| '''damageMax'''
| Maximum amount of damage this UFO can take. If the UFO takes 50% damage, it crash lands. If it takes 100% damage, it is destroyed.
| 0
|-
| '''speedMax'''
| Maximum speed in nautical miles.
| 0
|-
| '''accel'''
| Aceeleration value shown in the UFOpaedia.
| 0
|-
| '''power'''
| Damage power of this UFO's weapon in dogfights.
| 0
|-
| '''range'''
| Maximum range of this UFO's weapon in dogfights (in meters).
| 0
|-
| '''score'''
| [[Score]] gained when this UFO is destroyed, or half this score if it crash lands.
| 0
|-
| '''reload'''
| Time the UFO's weapon takes to fire between each shot.
| 0
|-
| '''breakOffTime'''
| Minimum amount of time for the UFO to be able to break off of a dogfight.
| 0
|-
| '''battlescapeTerrainData'''
| [[#Terrains|Terrain]] associated to this UFO in Battlescape missions.
| ''required''
|-
|}

=== Inventory Sections ===

Defines one of the sections of the [[Inventory TU Table|Battlescape inventory]] (eg. Backpack), listed in ''"invs:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the inventory name.
| ''required''
|-
| '''x'''
'''y'''
| Pixel coordinates of this section on the inventory screen.
| 0
0
|-
| '''type'''
| Type of this section:
* 0 = Slot section, can contain as many items as will fit on the slots.
* 1 = Hand section, can only contain one item regardless of size.
* 2 = Ground section, can contain infinite items.
| 0
|-
| '''slots'''
| List of the grid slots (''[x, y]'') that this section is composed of. For example, to make a 2x2 section, you would have ''[0, 0] [0, 1] [1, 0] [1, 1]''.
| -
|-
| '''costs'''
| List of [[Time Units]] costs to move an item from this section to another one (eg. ''STR_BACKPACK: 16'' means it will cost 16 TUs to move an item from this section to the Backpack).
| -
|-
|}

=== Terrains ===

Defines one of the [[TERRAIN|terrains]] used to generate a Battlescape map, listed in "terrains:".

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''name'''
| String ID of the terrain name.
| ''required''
|-
| '''largeBlockLimit'''
| Maximum amount of large blocks that can be used on map generation. (obsolete with nightly > 2014-11-19)
| 0
|-
| '''textures'''
| List of [[TEXTURE.DAT|Geoscape textures]] that correspond to this terrain.
| -
|-
| '''hemisphere'''
| Geoscape hemisphere associated with this terrain:
* -1 - Northern hemisphere.
* 0 - Both hemispheres.
* 1 - Southern hemisphere.
| 0
|-
| '''mapDataSets'''
| List of filenames (each with matching [[MCD]]/[[Image Formats#PCK|PCK/TAB]] files) that contain the tiles of this terrain.
| -
|-
| '''mapBlocks'''
| List of map blocks (see below) that are used for generating a map.
| -
|-
| '''roadTypeOdds'''
| Odds as a % of generating each type of road (E-W Road, N-S Road, Crossing) odds for crossing are: 100 - EW - NS. (obsolete with nightly > 2014-11-19)
| [0 0]
|-|-
| '''civilianTypes'''
| List of units to use as civilians for this mission.
| [MALE_CIVILIAN, FEMALE_CIVILIAN]
|-
|}

==== Map Blocks ====

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''name'''
| Filename of the [[MAPS|map]].
| ''required''
|-
| '''width'''
| Width of this map block in Battlescape grid units.
| 0
|-
| '''length'''
| Length of this map block in Battlescape grid units.
| 0
|-
| '''height'''
| Height of this map block in Battlescape grid units.
| 1
|-
| '''type'''
| Type of this map block:
(obsolete with nightly > 2014-11-19)
* -1 - Undefined
* 0 - Default
* 1 - Landing Zone (for placing X-COM / alien craft)
* 2 - E-W Road (for city maps)
* 3 - N-S Road (for city maps)
* 4 - Road Crossing (for city maps)
* 5 - Dirt (for filling empty base blocks)
* 6 - X-COM spawn point (for [[Alien Base]] / [[Cydonia]] missions)
* 7 - [[Alien Base]] Target
* 8 - [[Cydonia]] Target
| -1
|-
| '''subType'''
| Sub-type of this map block (see '''type'''). (obsolete with nightly > 2014-11-19)
| -1
|-
| '''frequency'''
| Frequency of this block in a map. (obsolete with nightly > 2014-11-19)
| 1
|-
| '''maxCount'''
| Maximum amount of times this block can be used in a map. If -1 there is no limit. (obsolete with nightly > 2014-11-19)
| -1
|-
| '''items'''
| An array of items to add to this mapblock, an the positions to place them at.
| -1
|}

*'''frequency''' defines the odds of the map appearing on the map
** The value assigned (default: 1) is used in ''x/n'', which defines the probability of being chosen.
** ''x'' is the integer defined for the map block's frequency and ''n'' is the combined total of probabilities for all the map types combined.
** This property can only be used in type 0 map blocks.
*'''maxCount''' is the maximum number of times it can be used.
** The value assigned is also used in ''x/n'' to determine the probability of being chosen.
** Each use reduces ''x'' by -1, with the caveat that being used as a Landing Zone type will not reduce the x value since it could result in no available Landing Zones.
** This property can only be used in type 0 map blocks.
* '''hemisphere''' only applies to UFO missions, not Terror ones.
*'''width/length''' defines the size of the map
** be aware that the mapview "width"-label is the openxcom ruleset length parameter
** be aware that the mapview "length"-label is the openxcom ruleset width parameter

==== Guidelines/Tips ====
* All maps with an XCOM/Alien craft require at least one type 1 map block. This map block can only contain ground tiles (no walls or objects), otherwise the game will crash or the walls/objects will be removed.
* All Terror terrains (listed under STR_TERROR_MISSION) require at least 1 map block of '''Types''' 2, 3 and 4 (for a total of 3 maps, which are required to place roads) and the corresponding '''roadTypeOdds''' added to the ruleset.
* If there isn't any map blocks designed as roads since you want to keep your terrain 'random', this can be circumvented by designating all 10x10 map blocks, excluding the one(s) used for the XCOM craft, as either '''Type''' 2, 3 and 4 and by defining their '''subType''' to 0. The game will then randomly choose between the map blocks for each type used in the roads, making them map more random.

=== Armor ===

Defines a Battlescape unit's [[armor]] as well as visual representation (so every unit has an armor), listed in ''"armors:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the armor name.
| ''required''
|-
| '''spriteSheet'''
| Sprite sheet from [[UNITS]] used to draw a unit wearing this armor.
| -
|-
| '''spriteInv'''
| Sprite used for the [[Inventory Backgrounds]] of a unit wearing this armor.
| -
|-
| '''corpseBattle'''
| List of string IDs of the corpse [[#Items|items]] generated when a unit wearing this armor is killed (one per unit tile) on the Battlescape.
| -
|-
| '''corpseGeo'''
| String ID of the corpse [[#Items|item]] associated with this unit on the Geoscape.
| -
|-
| '''storeItem'''
| String ID of the [[#Items|item]] that represents this armor in [[Base Stores]] for equipping.
| -
|-
| '''weight'''
| Physical weight of the armor when worn
| 6
|-
| '''stats'''
| like soldier stats (see below) but these are treated as stat bonuses for wearing the specific armor.
| -
|-
| '''frontArmor'''
| Protection provided on the front of the unit.
| 0
|-
| '''sideArmor'''
| Protection provided on the sides of the unit.
| 0
|-
| '''rearArmor'''
| Protection provided on the rear of the unit.
| 0
|-
| '''underArmor'''
| Protection provided under the unit (eg. from explosions).
| 0
|-
| '''drawingRoutine'''
| Drawing routine used to put together the body parts in the unit's '''spriteSheet''':
* 0 = [[Soldier]], [[Sectoid]]
* 1 = [[Floater]]
* 2 = [[HWP]]
* 3 = [[Cyberdisk]]
* 4 = [[Civilian]], [[Ethereal]]
* 5 = [[Sectopod]], [[Reaper]]
* 6 = [[Snakeman]]
* 7 = [[Chryssalid]]
* 8 = [[Silacoid]]
* 9 = [[Celatid]]
* 10 = [[Muton]]
* 11 = [[Submersible Weapons Systems]]
* 12 = [[Hallucinoid]]
* 13 = [[Aquanauts]]
* 14 = [[Calcinite]], [[Deep One]], [[Gillman]], [[Lobster Man]], [[Tasoth]]
* 15 = [[Aquatoid]]
* 16 = [[Bio-Drone]]
| 0
|-
| '''movementType'''
| Type of movement provided by this armor:
* 0 = Walking
* 1 = Flying
* 2 = Sliding (no walking animation)
it also defines the body of an tank (32-images) in your spriteSheet or the change in sprites while flying using a flying armour see: [[TANKS.PCK]], [[XCOM_2.PCK]]
| 0
|-
| '''damageModifier'''
| List of decimal damage modifiers (1.0 = 100%) this armor applies to each damage type (see [[#Items|Items section]]) received. Modifiers must be specified for all damage types, in this order:
* None
* Armor Piercing
* Incendiary
* High Explosive
* Laser
* Plasma
* Stun
* Melee
* Acid
* Smoke
|
- 1.0 
- 1.0 
- 1.0 
- 1.0 
- 1.0 
- 1.0 
- 1.0 
- 1.0 
- 1.0 
- 1.0
|-
| '''size'''
| Size of the unit wearing this armor, in Battlescape grid units. Every unit is square, so a size of 2 means 2x2.
| 1
|-
| '''loftempsSet'''
| List of [[LOFTEMPS]] IDs (one per unit tile, so a 1x1 unit has 1, a 2x2 unit has 4, etc.) used to represent a unit wearing this armor in 3D space.
| -
|-
| '''loftemps'''
| loftemps is a deprecated option that only works for 1x1 sized units.
| -
|-
| '''forcedTorso'''
| soldier sprites have female and male torsos. some armours reuse these sprites for flying/non flying torso without difference between genders. This can be controlled by the parameter: 0 = use genderrelated torso, 1 = use male torso, 2 = use female torso
| 0

|}

=== Player Units (Soldiers) ===

Defines a [[soldier]] recruited by X-COM, listed in ''"soldiers:"''. Currently only one soldier unit type (''XCOM'') is supported.

Unit stats are represented as follows:
* [[Time Units|tu]]
* [[Energy|stamina]]
* [[Health|health]]
* [[Bravery|bravery]] (always a multiple of 10)
* [[Reactions|reactions]]
* [[Firing Accuracy|firing]]
* [[Throwing Accuracy|throwing]]
* [[Strength|strength]]
* [[Psi Strength|psiStrength]]
* [[Psi Skill|psiSkill]]
* [[Melee Accuracy|melee]] (not visible)

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the soldier name.
| ''required''
|-
| '''minStats'''
| Minimum values used to generate the soldier's [[Starting Stats]]. In this case, ''psiSkill'' is treated as the initial stat (not generated).
| -
|-
| '''maxStats'''
| Maximum values used to generate the soldier's [[Starting Stats]]. In this case, ''psiSkill'' is treated as the minimum value for the first month of psi training (actual value is 100%-150%).
| -
|-
| '''statCaps'''
| Maximum stats this soldier can gain through [[Experience]]. '''NOTE:''' A stat will still go over the limit once, and then will no longer increase (see [[Experience#Regarding Caps|Regarding Caps]]).
| -
|-
| '''armor'''
| String ID of the [[#Armor|armor]] this soldier uses by default.
| -
|-
| '''standHeight'''
| Height of this soldier when standing.
| 0
|-
| '''kneelHeight'''
| Height of this soldier when kneeling.
| 0
|-
| '''floatHeight'''
| Distance between the bottom of this unit and the ground.
| 0
|-
| '''femaleFrequency'''
| The probability that a female soldier is hired.
| 50
|}

=== AI Units (Aliens/Civilians) ===

Defines an [[Alien Life Forms|alien]] (enemy) or [[civilian]] (neutral) unit, listed in ''"units:"''. Every different alien rank is a different unit, since they have completely different stats. Unit stats are represented as follows:
* [[Time Units|tu]]
* [[Energy|stamina]]
* [[Health|health]]
* [[Bravery|bravery]] (always a multiple of 10)
* [[Reactions|reactions]]
* [[Firing Accuracy|firing]]
* [[Throwing Accuracy|throwing]]
* [[Strength|strength]]
* [[Psi Strength|psiStrength]]
* [[Psi Skill|psiSkill]]
* [[Melee Accuracy|melee]] (not visible)

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the unit name.
| ''required''
|-
| '''race'''
| String ID of the unit race (for alien units).
| -
|-
| '''rank'''
| String ID of the unit rank (for alien units).
| -
|-
| '''stats'''
| Battlescape stats of this unit.
| -
|-
| '''armor'''
| String ID of the [[#Armor|armor]] this unit uses by default.
| -
|-
| '''standHeight'''
| Height of this unit when standing.
| 0
|-
| '''floatHeight'''
| Distance between the bottom of this unit and the ground.
| 0
|-
| '''value'''
| [[Score]] this unit is worth.
| 0
|-
| '''deathSound'''
| Sound ID from [[#Extra_Sounds|BATTLE.CAT]] played when this unit dies.
| -1
|-
| '''aggroSound'''
| Sound ID from [[#Extra_Sounds|BATTLE.CAT]] played when this unit aggros.
| -1
|-
| '''moveSound'''
| Sound ID from [[#Extra_Sounds|BATTLE.CAT]] played when this unit moves.
| -1
|-
| '''intelligence'''
| Intelligence of this unit's AI. The higher the value, the longer this unit remembers player troops between turns.
| 0
|-
| '''aggression'''
| Aggression of this unit's AI. The higher the value, the more ruthless the unit, the more likely to make a frontal assault. Less aggressive units tend to set up ambushes.
Vanilla values are:
* 0 = mostly passive
* 1 = balanced
* 2 = mostly aggresive
| 0
|-
| '''energyRecovery'''
| Energy recovered by the unit each turn (needs verification)
| 40 (?)
|-
| '''specab'''
| Special ability of this unit:
* 0 = None
* 1 = [[Cyberdisc|Explodes on Death]]
* 2 = [[Bio-Drone|Burns Floor]]
* 3 = Burns Floor and explodes on Death
| 0
|-
| '''spawnUnit'''
| String ID of the unit used to respawn on death (eg. [[Zombie]]s respawn as [[Chrysallid]]s).
| -
|-
| '''livingWeapon'''
| Is this unit a living weapon? (only attacks with a '''fixedWeapon''')
| false
|-
| '''female'''
| Is this unit a female? (used for TFTD civilian types)
| false
|-
|}

=== Alien Races ===

Defines a [[Alien Life Forms|race]] used in [[Alien Missions]], listed in ''"alienRaces:"''. Heavily tied with deployment data.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''id'''
| String ID of the alien race name.
| ''required''
|-
| '''members'''
| Alien crew associated with this alien race (eg. race units + terrorist units), defined by a list of unit string IDs. Order here will define rank in terms of deployment. generally speaking the order is:
* 0 - Commander
* 1 - Leader
* 2 - Engineer
* 3 - Medic
* 4 - Navigator
* 5 - Soldier
* 6 - Terrorist 1
* 7 - Terrorist 2
but of course, not all races have all ranks, so the "fill in" rank would be listed multiple times (see ethereals).
| -
|-
| '''retaliation'''
| retaliation enables/disables the race for retaliation missions.
| ''True''
|-
|}

=== Alien Deployments ===

Defines a Battlescape deployment data used in [[Alien Missions]] (such as alien and map configurations), listed in ''"alienDeployments:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the deployment name.
| ''required''
|-
| '''width'''
| Width of the Battlescape map in grid units.
| 0
|-
| '''length'''
| Length of the Battlescape map in grid units.
| 0
|-
| '''height'''
| Vertical height of the Battlescape map in grid units.
| 0
|-
| '''terrains'''
| list of string IDs of the [[#Terrains|terrain]] to choose from to generate this map. This is not used for UFO sites where the terrain comes from the Geoscape.
| -
|-
| '''shade'''
| Shade of the map (0-15, where 0 is full daytime and 15 is full nighttime). This is not used for UFO sites where the shade comes from the Geoscape.
| 0
|-
| '''nextStage'''
| String ID of the next deployment stage to use after this one, for multi-stage missions.
| -
|-
| '''race'''
| Sets the race to use in the next stage.
| ""
|-
| '''script'''
| Reference to a mapScript.
| ""
|-
| '''data'''
| List of deployment data for each alien rank on this mission (see below).
| -
|}

Notes:
* '''terrains''' can also be used with UFOs, with the game using instead the listed terrain rather than the location of the UFO on Geoscape.
==== Deployment Data ====

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''alienRank'''
| [[Alien Rank|Rank]] associated with this deployment data, as defined by the order of the race in question (see above)
| ''required''
|-
| '''lowQty'''
| Maximum quantity of aliens to spawn (beginner).
| 0
|-
| '''highQty'''
| Maximum quantity of aliens to spawn (superhuman).
| 0
|-
| '''dQty'''
| Minimum Desired Quantity of aliens to spawn.
| 0
|-
| '''extraQty'''
| spawns a random number of additional aliens.
| 0
|-
| '''percentageOutsideUfo'''
| Percentage (0-100%) of aliens to spawn outside in UFO sites.
| 0
|-
| '''itemSets'''
| Three lists (one for each alien technology level) of [[#Items|items]] (string IDs) for the aliens to equip.
| ''required''
|-
|}

=== Research ===

Defines a [[Research|research topic]] that X-COM scientists can investigate, listed in ''"research:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''name'''
| String ID of the research project's name (or item, if a '''lookup''' is defined).
| ''required''
|-
| '''lookup'''
| String ID of the research project's display name and UFOPaedia article reference.
| -
|-
| '''cost'''
| Number of man hours (on average) required to complete this project.
| 0
|-
| '''points'''
| [[Score]] earned for completing this project.
| 0
|-
| '''needItem'''
| Does this project require an [[#Items|item]] of the same name?
| false
|-
| '''dependencies'''
| List of research projects that can unlock access to this one. If the full list is researched, or if one of the projects on the list "unlocks" this one, it becomes available.
| -
|-
| '''unlocks'''
| List of research projects unlocked, regardless of other dependencies, but not requirements, by completing this project (for example, any live alien unlocks "alien origins").
| -
|-
| '''requires'''
| List of research projects unilaterally required before this project can be unlocked (for example, "the martian solution" will not even be considered for unlocking until AFTER "alien origins" is completed).
| -
|-
| '''getOneFree'''
| List of "bonus" research projects that may be granted when completing this project (for example, alien medics will give you information on other alien races). Only applies to living aliens.
| -
|-
|}

=== Manufacture ===

Defines a [[Manufacture|manufacture project]] that X-COM engineers can produce, listed in ''"manufacture:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''name'''
| String ID of the manufacturing project's name (and the item it produces).
| ''required''
|-
| '''category'''
| String ID of the manufacturing project's category.
| -
|-
| '''requires'''
| List of [[#Research|topics]] (string IDs) that must be researched to unlock this project. If none are specified, this project is unlocked from the start.
| -
|-
| '''space'''
| Amount of [[Workshop]] space required to begin this project.
| 0
|-
| '''time'''
| Number of man hours (on average) required per item.
| 0
|-
| '''cost'''
| Monetary deduction per item manufactured.
| 0
|-
| '''requiredItems'''
| List of [[#Items|items]] required and consumed per item manufactured.
| -
|-
| '''producedItems'''
| List of [[#Items|items]] produced per each item consumed. If not specified, defaults to 1 item with the same string ID as the manufacture.
| 1
|-
|}

=== UFOpaedia Article ===

Defines an article in the in-game [[UFOpaedia]], listed in ''"ufopaedia:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''id'''
| String ID of the article name. This must match the ID of the object associated with this article, if applicable.
| ''required''
|-
| '''title'''
| String ID of the article title. If omitted, the '''id''' is used.
| -
|-
| '''type_id'''
| Type of this article:
* 0 = Unknown
* 1 = [[Craft]]
* 2 = [[Craft Armaments]]
* 3 = [[HWP]]
* 4 = [[Equipment (EU)|Equipment]]
* 5 = [[Armour]]
* 6 = [[Base Facilities]]
* 7 = Text & Image (eg. [[Alien Life Forms]], [[UFO Components]])
* 8 = Text (eg. [[Alien Research]])
* 9 = [[UFO]]
* 10 = [[TFTD]]
* 11 = TFTD [[Subs]]
* 12 = TFTD [[Sub_Armaments]]
* 13 = TFTD [[Submersible_Weapons_Systems]]
* 14 = TFTD [[Equipment_(TFTD)]]
* 15 = TFTD Armour
* 16 = TFTD [[Base_Facilities_(TFTD)]]
* 17 = TFTD [[Alien_Subs]]
| 0
|-
| '''section'''
| String ID of the UFOpaedia section this article belongs in.
| -
|-
| '''requires'''
| List of [[#Research|topics]] (string IDs) that must be researched to unlock this article. If none are specified, this article is unlocked from the start.
| -
|-
| '''image_id'''
| Filename of the [[UP001.SPK-UP042.SPK|background image]] displayed on this article, if applicable.
| -
|-
| '''text'''
| String ID of the description displayed on this article.
| -
|-
| '''text_width'''
| Maximum width of the text displayed, only applicable to ''Text & Image'' articles.
| 0
|-
| '''rect_stats'''
| Rectangle ('''x''', '''y''', '''width''', '''height''') of the stats text on the screen, only applicable to ''Craft'' articles.
| 0
|-
| '''rect_text'''
| Rectangle ('''x''', '''y''', '''width''', '''height''') of the description text on the screen, only applicable to ''Craft'' articles.
| 0
|-
| '''weapon'''
| String ID of the weapon, only applicable to ''HWP'' articles.
| -
|}

=== UFO Trajectories ===

Defines a trajectory carried out by an UFO during an [[#Alien Missions|alien mission]], listed in ''"ufoTrajectories:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''id'''
| String ID of the trajectory name.
| ''required''
|-
| '''groundTimer'''
| Amount of seconds for the UFO to spend on Ground waypoints.
| 0
|-
| '''waypoints'''
| List of waypoints for the UFO to traverse, defined as ''[zone, altitude, speed]''. 
'''zone''': Globe zone where the waypoint is located. 
'''altitude''': UFO altitude after reaching this waypoint:
* 0 - Ground
* 1 - Very Low
* 2 - Low
* 3 - High
* 4 - Very High
'''speed''': UFO speed after reaching this waypoint, as a percentage (0-100%) of its maximum speed.
| -
|}

=== Alien Missions ===

Defines an [[Alien Missions|alien mission]] carried out by UFOs on the Geoscape, listed in ''"alienMissions:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the mission type.
| ''required''
|-
| '''points'''
| [[Score]] allocated to aliens for successfully completing this mission.
| 0
|-
| '''raceWeights'''
| List of alien races likely to carry out this mission, and the % chance of them being allocated to this mission, listed by "number of months after game beginning".
| ''required''
|-
| '''waves'''
| List of UFO waves to spawn as this mission progresses, as described below.
| ''required''
|}

==== Waves ====

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''ufo'''
| String ID of the [[#UFOs|UFO]] to spawn.
| ''required''
|-
| '''count'''
| Number of UFOs to spawn.
| 0
|-
| '''trajectory'''
| String ID of the [[#UFO Trajectories|trajectory]] for this UFO to use when entering Earth's atmosphere.
| ''required''
|-
| '''timer'''
| How long after the previous wave should this wave arrive? (in seconds)
| 0
|-
|}

=== Alien Item Levels ===

This is a list of item level probabilities, with a number between 0 and 2 representing an item level from plasma pistols to heavy plasmas, as defined in the deployments, expressing a 10% probability for that item level being used.

0 = first set (plasma pistol/clip)
1 = second set (plasma rifle/clip)
2 = third set (heavy plasma/clip)

For example:
[ 2, 0, 0, 0, 0, 0, 0, 1, 1, 1 ]
would represent a 60% chance for pistols, 30% rifles, and 10% heavy weapons. 
Note that the order does not matter, but the length DOES. each line MUST have 10 digits.

The above can be confusing. There are 10 fields; each number represents 10%. 
There are six instances of '0'. 6x10% = 60% chance of plasma pistol 
There are three instances of '1'. 3x10% = 30% chance of plasma rifle 
There is only one instance of '2'. 1x10% = 10% chance of heavy plasma 

Each line represents a month after the beginning of the game, and there is no limit to the number defined. 
OpenXCom will use the most recently available item level in the event the game goes on forever.

=== Extra Sprites ===

Adds or replaces sprites in an existing [[Image Formats|X-COM image file]], listed in ''"extraSprites:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| Filename of the original/new image to modify.
| ''required''
|-
| '''width'''
'''height'''
| Size of the sprite(s) in pixels.
| 0
0
|-
| '''singleImage'''
| Is the image file just a single sprite (true) or a spritesheet (false)?
| false
|-
| '''subX'''
'''subY'''
| Size of the subdivision in pixels. If a subdivision is specified, then the image file is divided into chunks to form the sprites (eg. spritesheets).
| 0
0
|-
| '''files'''
| List of the new sprites to add/replace, listed as ''spriteID: filename''.
| -
|}

Example:
- type: GIANTBUNNY.PCK
width: 32
height: 40
files:
0: Resources/Bunny/Bunny00.png
1: Resources/Bunny/Bunny01.bmp
2: Resources/Bunny/Bunny02.gif

=== Extra Sounds ===

Adds or replaces sounds in an existing [[SOUND|X-COM sound file]], listed in ''"extraSounds:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| ID of the original sound file to modify:
* BATTLE.CAT - Battlescape sounds, corresponds to ''SOUND1.CAT'' or ''SAMPLE2.CAT'' (55 sounds).
* INTRO.CAT - Intro sounds, corresponds to ''INTRO.CAT'' or ''SAMPLE3.CAT'', probably best not to mess with these.
* GEO.CAT - Geoscape sounds, corresponds to ''SOUND2.CAT'' or ''SAMPLE.CAT'' (14 sounds).
| ''required''
|-
| '''files'''
| List of the new sounds to add/replace, listed as ''soundID: filename''.
| -
|}

Example:
- type: BATTLE.CAT
files:
55: Resources/Sounds/sample.wav

=== Extra Strings ===

Adds or replaces text strings in an existing [[Translations (OpenXcom)|OpenXcom language file]], listed in ''"extraStrings:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| Filename of the original language file to modify, sans extension.
| ''required''
|-
| '''strings'''
| List of the new strings to add/replace, listed as ''stringID: text''.
| -
|}

Example:
- type: en-US
strings:
STR_SNIPER_RIFLE: Sniper Rifle
STR_SNIPER_RIFLE_CLIP: Sniper Rifle Clip
- type: en-GB
strings:
STR_SNIPER_RIFLE: Sniper Rifle
STR_SNIPER_RIFLE_CLIP: Sniper Rifle Clip
- type: de
strings:
STR_SNIPER_RIFLE: Scharfschützengewehr
STR_SNIPER_RIFLE_CLIP: Scharfschützengewehrmunition
- type: ru
strings:
STR_SNIPER_RIFLE: Снайперская винтовка
STR_SNIPER_RIFLE_CLIP: Магазин к снайп. винтовке

=== Interfaces ===

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| ''?''
| -
|-
| '''elements'''
| ''?''
| -
|-
| '''id'''
| ''?''
| -
|-
| '''color'''
| ''?''
| -
|}

=== StatStrings ===

[[Statstrings]] are used for automatically renaming soldiers. They are case sensitive and they are processed in the order in which they are specified.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''string'''
| String to add to name.
| ''required''
|-
| '''psiStrength''' 
'''psiSkill''' 
'''bravery''' 
'''strength''' 
'''firing''' 
'''reactions''' 
'''stamina''' 
'''tu''' 
'''health''' 
'''throwing'''
| One or more stat ranges are ANDed together for success. Each range has a minVal and maxVal. Use YAML standard tilde (~) to indicate null. ((~) = 0 as minvalue; (~) =255 as maxvalue)
| -
|}

Example:
statStrings:
- string: "x"
psiStrength: [~, 30]
- string: "P"
psiStrength: [80, ~]
- string: "p"
psiStrength: [60, 79]
- string: "K"
psiSkill: [60, ~]
- string: "k"
psiSkill: [30, 59]
- string: "b"
bravery: [60, ~]
- string: "c"
bravery: [~, 10]
- string: "w"
strength: [~, 25]
- string: "Snpr"
firing: [60, ~]
reactions: [60, ~]
- string: "M"
firing: [70, ~]
- string: "m"
firing: [60, 69]
- string: "Sct"
reactions: [50, ~]
tu: [60, ~]
- string: "R"
reactions: [60, ~]
- string: "r"
reactions: [50, 59]

==References==
<references />

[[Category:OpenXcom]]

Ruleset Reference (OpenXcom)

2014-12-04T22:37:00Z

Falko: /* Alien Deployments */

A reference of all the customizable values of everything in a [[Rulesets (OpenXcom)|ruleset]]. Some guidelines:
* If a value is omitted from the ruleset, the default is used. You cannot omit ''required'' values.
* Text strings (eg. names) are represented by string IDs from the [[Translations (OpenXcom)|language files]]
* Numerical IDs (used for sprites, sounds, etc.) start at 0, not 1.
* Boolean (yes/no) values are represented by true/false.
* World coordinates are represented in degrees (see [[WORLD.DAT]]).
* Money amounts (prices, costs, etc.) are represented in dollars.
* All paths are '''case sensitive'''! If your ruleset uses external files, make sure that they named properly as described in ruleset.

Items are ordered as they come in the ruleset. To override this, you can specify a ''listOrder''. You can find the default listOrders in [[Ruleset List Order (OpenXcom)|Ruleset List Order]].

=== Globe ===

Defines the drawing of landmasses and borders on the globe.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''data'''
| Path name of file which contains polygon and texture information. (For example WORLD.DAT).
| -
|-
| '''polygons'''
| List of polygons drawn on the globe surface. A triangle consist of seven values: the first number defines the texture, followed by three pairs of (x,y) globe coordinates. Only polygons with 3 or 4 vertices are reliable shown on the globe = 7 or 9 values per entry.
| -
|-
| '''polylines'''
| List of border lines. Each list entry consist of a list of (x,y) globe coordinates.
| -
|}

=== Countries ===

Defines one of the [[Country Funding (EU)|funding nations]], listed in ''"countries:"''. They're used for activity graphs and player scoring.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the country name.
| ''required''
|-
| '''fundingBase'''
| Country's base funding, in thousands. The starting funding can be anywhere between 1x and 2x the base funding.
| 0
|-
| '''fundingCap'''
| Country's funding cap, in thousands. Once a country reaches this maximum, it will no longer increase its funding.
| 0
|-
| '''labelLon'''
'''labelLat'''
| Longitude and latitude coordinates of the country's label on the globe. This label is only shown when the globe is zoomed in and "detail" is turned on.
| 0.0
0.0
|-
| '''areas'''
| List of "rectangles" on the globe defined as [''lon1'' ''lat1'' ''lon2'' ''lat2'']. Any activity within these areas counts towards the country's graph activity and affects their opinion of the player.
| -
|}

=== Regions ===

Defines one of the [[Geoscape (EU)#World Regions/Countries|world regions]], listed in ''"regions:"''. They're used for base placement, activity graphs and mission spawning.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the region name.
| ''required''
|-
| '''cost'''
| Amount of money spent building an X-COM base in this region (first base is free).
| 0
|-
| '''areas'''
| List of "rectangles" on the globe defined as ''[lon1, lat1, lon2, lat2]''. Any activity within these areas counts towards the region's graph activity.
| -
|-
| '''cities'''
| List of cities belonging to this region. They will be displayed on the globe and used for terror site missions. Each city is defined by their '''lon''' and '''lat''' coordinates and a '''name''' string ID.
| -
|-
| '''regionWeight'''
| Weight of this region when selecting regions for alien missions.
| 0
|-
| '''missionWeights'''
| Weighted list of the different mission types for this region (eg. ''STR_ALIEN_RESEARCH: 14'').
| -
|-
| '''missionZones'''
| List of "rectangles" (''[lon1, lat1, lon2, lat2]'') defining the mission zones for this region. Mission zones are waypoints for UFO trajectories.
| -
|-
| '''missionRegion'''
| Spawn mission in this region instead (used for regions without land).
| -
|}

=== Base Facilities ===

Defines one of the [[Base Facilities (EU)|facilities]] that can be built in an X-COM base, listed in ''"facilities:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the facility name.
| ''required''
|-
| '''requires'''
| List of [[#Research|topics]] (string IDs) that must be researched to unlock this facility. If none are specified, this facility is unlocked from the start.
| -
|-
| '''spriteShape'''
| Sprite ID from [[BASEBITS.PCK]] used to draw the facility's outer shape in the Basescape and UFOpaedia.
| -1
|-
| '''spriteFacility'''
| Sprite ID from [[BASEBITS.PCK]] used to draw the facility's contents in the Basescape and UFOpaedia. Drawn on top of '''spriteShape'''.
| -1
|-
| '''lift'''
| Is this facility an [[Access Lift]]? All base facilities must be connected to the lift.
| false
|-
| '''hyper'''
| Is this facility a [[Hyperwave Decoder]]? Displays extra information for detected UFOs. Only valid for radar facilities.
| false
|-
| '''mind'''
| Is this facility a [[Mind Shield]]? Reduces the chance of UFOs finding your base. Does not stack.
| false
|-
| '''grav'''
| Is this facility a [[Grav Shield]]? Doubles the power of your base defenses. Does not stack.
| false
|-
| '''size'''
| Size of the facility, in grid units. Every facility is square, so a size of 1 means 1x1, 2 means 2x2, etc. Bigger facilities are made up of multiple sprites, for example a 2x2 facility will use 4 sprites for '''spriteShape''' and 4 sprites for '''spriteFacility''' (top-left, top-right, bottom-left, bottom-right).
| 1
|-
| '''buildCost'''
| Amount of money spent to build this facility in the base.
| 0
|-
| '''buildTime'''
| Amount of days it takes for this facility to be built.
| 0
|-
| '''monthlyCost'''
| Amount of money spent monthly for the maintenance of this facility.
| 0
|-
| '''storage'''
| Amount of storage space (for items) this facility provides. See [[Base Stores]].
| 0
|-
| '''personnel'''
| Amount of personnel (soldiers, scientsts, engineers) these quarters can contain.
| 0
|-
| '''aliens'''
| Amount of live aliens this facility can contain. Only checked if the ''alienContainmentLimitEnforced'' option is enabled.
| 0
|-
| '''crafts'''
| Amount of X-COM craft this facility can contain.
| 0
|-
| '''labs'''
| Amount of lab space this facility provides for research projects.
| 0
|-
| '''workshops'''
| Amount of workshop space this facility provides for manufacture projects.
| 0
|-
| '''psiLabs'''
| Amount of soldier space this facility provides for psionic training.
| 0
|-
| '''radarRange'''
| Maximum radar detection range of this facility, in nautical miles.
| 0
|-
| '''radarChance'''
| Chance (0-100%) of this radar detecting a UFO that enters its range.
| 0
|-
| '''defense'''
| Offensive power provided by this base defense against attacking UFOs.
| 0
|-
| '''hitRatio'''
| Chance (0-100) of the base defense hitting an attacking UFO.
| 0
|-
| '''fireSound'''
| Sound ID from [[#Extra_Sounds|GEO.CAT]] played when the base defense fires.
| -1
|-
| '''hitSound'''
| Sound ID from [[#Extra_Sounds|GEO.CAT]] played when the base defense hits a target.
| -1
|-
| '''mapName'''
| [[MAPS|Map]] associated to this facility in Battlescape base defenses.
| -
|-
|}

=== Crafts ===

Defines one of the [[Craft|X-COM crafts]] that go on interception missions, listed in ''"crafts:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the craft name.
| ''required''
|-
| '''requires'''
| List of [[#Research|topics]] (string IDs) that must be researched to unlock this craft. If none are specified, this craft is unlocked from the start.
| -
|-
| '''sprite'''
| Sprite ID from [[BASEBITS.PCK]] used to draw this craft in the Basescape and from [[INTICON.PCK]] used to draw the damage indicator in dogfights.
modders: the corresponding extrasprite file id for BASEBITS.PCK is sprite+33 INTICON.PCK contains a minimized icon id=sprite the file id for the dogfight image is sprite+11
| -1
|-
| '''fuelMax'''
| Maximum amount of fuel this craft can carry. Crafts use up fuel based on their speed while travelling.
| 0
|-
| '''damageMax'''
| Maximum amount of damage this craft can take. If this amount is exceeded, the craft is destroyed.
| 0
|-
| '''speedMax'''
| Maximum speed in nautical miles. Crafts travel at max speed when flying and half speed when patrolling.
| 0
|-
| '''accel'''
| Aceeleration value shown in the UFOpaedia.
| 0
|-
| '''weapons'''
| Amount of craft weapons this craft can equip. The UI can only display a max of 2 weapons.
| 0
|-
| '''soldiers'''
| Amount of soldiers this craft can carry.
| 0
|-
| '''maxItems'''
| Amount of items this craft can carry.
| 80
|-
| '''vehicles'''
| Amount of vehicles this craft can carry.
| 0
|-
| '''costBuy'''
| Amount of money spent for purchasing this craft. If set to 0, the craft will not be available in the Purchase/Recruit screen.
| 0
|-
| '''costRent'''
| Amount of money spent monthly for renting this craft. If set to 0, the craft is not on rental and won't count towards base maintenance.
| 0
|-
| '''costSell'''
| Amount of money gained for selling this craft.
| 0
|-
| '''refuelItem'''
| Item required for refuelling this craft. If no item is specified, the craft uses human fuel.
| 0
|-
| '''repairRate'''
| Amount of damage restored every hour while [[Repairs|Repairing]] in base.
| 1
|-
| '''refuelRate'''
| Amount of fuel restored every 30 mins while [[Refueling]] in base. If specified, a '''refuelItem''' is spent each time.
| 1
|-
| '''radarRange'''
| Detection range of the craft's radar in nautical miles. Every craft radar has a 100% detection chance.
| 600
|-
| '''transferTime'''
| Number of hours it takes to purchase/transfer this craft to a base.
| 0
|-
| '''score'''
| [[Score]] lost when this craft is destroyed.
| 0
|-
| '''spacecraft'''
| Can this craft go to [[Cydonia]]?
| false
|-
| '''battlescapeTerrainData'''
| [[#Terrains|Terrain]] associated to this craft in Battlescape missions.
| -
|}

=== Craft Weapons ===

Defines one of the [[Craft Armaments|weapons]] equipped by X-COM craft for shooting down UFOs, listed in ''"craftWeapons:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the weapon name.
| ''required''
|-
| '''sprite'''
| Sprite ID from [[BASEBITS.PCK]] used to draw the weapon in the Basescape and from [[INTICON.PCK]] used to draw the weapon in dogfights.
modders: the corresponding extrasprites file id for INTICON.PCK is sprite+5 and sprite+48 for BASEBITS.PCK
| -1
|-
| '''sound'''
| Sound ID from [[#Extra_Sounds|GEO.CAT]] played when this weapon fires.
| -1
|-
| '''damage'''
| Amount of damage this weapon does to enemy UFOs.
| 0
|-
| '''range'''
| Maximum range of this weapon in dogfights (in meters).
| 0
|-
| '''accuracy'''
| Chance (0-100%) of each shot hitting the enemy UFO.
| 0
|-
| '''reloadCautious'''
| Time this weapon takes to fire between each shot in ''Cautious Mode''.
| 0
|-
| '''reloadStandard'''
| Time this weapon takes to fire between each shot in ''Standard Mode''.
| 0
|-
| '''reloadAggressive'''
| Time this weapon takes to fire between each shot in ''Aggressive Mode''.
| 0
|-
| '''ammoMax'''
| Maximum amount of ammo this weapon can carry.
| 0
|-
| '''rearmRate'''
| Amount of ammo restored every 30 mins while the craft is [[Rearming]] in base. If specified, '''clip'''s are spent depending on their '''clipSize'''. If the '''clipSize''' of the specified ammo is 0, no '''clip'''s are spent.
| 1
|-
| '''projectileType'''
| Type of the weapon projectile, used for the projectile sprite in dogfights:
* 0 - [[Stingray]]
* 1 - [[Avalanche]]
* 2 - [[Cannon]]
* 3 - [[Fusion Ball]]
* 4 - [[Laser Cannon]]
* 5 - [[Plasma Beam]]
| 2
|-
| '''projectileSpeed'''
| Speed of the weapon projectile in dogfights.
| 0
|-
| '''launcher'''
| String ID of the [[#Items|item]] required to equip this weapon.
| -
|-
| '''clip'''
| String ID of the [[#Items|item]] required to rearm this weapon.
| -
|}

=== Items ===

Defines the Geoscape and Battlescape properties of an [[Equipment (EU)|item]] that can be stored in X-COM bases, listed in ''"items:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the internal item name.
| ''required''
|-
| '''name'''
| String ID of the displayed item name, for cases where it's different from the internal name. If omitted, '''type''' is used.
| -
|-
| '''requires'''
| List of [[#Research|topics]] (string IDs) that must be researched to unlock this item. If none are specified, this item is unlocked from the start. Soldiers can only use unlocked items in the Battlescape.
| -
|-
| '''size'''
| Space occupied by this item in [[Base Stores]]. Can be a decimal value.
| 0.0
|-
| '''costBuy'''
| Amount of money spent for purchasing this item. If set to 0, this item will not be available in the Purchase/Recruit screen.
| 0
|-
| '''costSell'''
| Amount of money gained for selling this item.
| 0
|-
| '''transferTime'''
| Number of hours it takes to purchase/transfer this item to a base.
| 24
|-
| '''weight'''
| [[Item_Weight|Weight]] occupied by this item in a soldier's inventory.
| 999
|-
| '''bigSprite'''
| Sprite ID from [[BIGOBS.PCK]] used to draw this item in a soldier's inventory and UFOpaedia.
| -1
|-
| '''floorSprite'''
| Sprite ID from [[FLOOROB.PCK]] used to draw this item on the floor of a Battlescape tile.
| -1
|-
| '''handSprite'''
| Sprite ID from [[HANDOB.PCK]] used to draw this item on a soldier's hand in the Battlescape.
modders: each handobject needs 8 images (8 directions) define the extrasprites accordingly
| 120
|-
| '''bulletSprite'''
| Sprite ID from ''BulletSprites.png'' used to draw this weapon's projectile on the Battlescape:
* 0 - [[Rocket Launcher]]
* 1 - [[Pistol]]
* 2 - [[Rifle]]
* 3 - [[Auto Cannon]]
* 4 - [[Heavy Cannon]]
* 5 - [[Laser Pistol]]
* 6 - [[Laser Rifle]]
* 7 - [[Heavy Laser]]
* 8 - [[Plasma Rifle|Plasma]]
* 9 - [[Small Launcher]]
* 10 - [[Blaster Launcher]]
for modders: the bulletsprite needs to be put into the extraSprites type "Projectiles" the bulletsprite can contain up to 35 3x3 images. The corresponding file id is 35*[bulletSprite]
| -1
|-
| '''fireSound'''
| Sound ID from [[#Extra_Sounds|BATTLE.CAT]] played when this weapon fires.
| -1
|-
| '''hitSound'''
| Sound ID from [[#Extra_Sounds|BATTLE.CAT]] played when this weapon hits a target.
| -1
|-
| '''hitAnimation'''
| Sprite ID from [[SMOKE.PCK]] used to draw the weapon's "hit explosion".
'''NOTE''': Do not define this value for melee/psi weapons, they use [[HIT.PCK]] and therefore meleeAnimation instead.
| 0
|-
| '''power'''
| Average damage of the weapon, in most cases it will be +-50% this value.
| 0
|-
| '''strengthApplied'''
| Add the attacking unit's strength to this weapon's damage.
| false
|-
| '''compatibleAmmo'''
| List of string IDs of the ammo items that can be loaded on this weapon. If none are specified, the weapon doesn't need ammo.
| -
|-
| '''damageType'''
| What type of [[damage]] does this weapon do:
* 0 - None
* 1 - Armor Piercing
* 2 - Incendiary
* 3 - High Explosive
* 4 - Laser
* 5 - Plasma
* 6 - Stun
* 7 - Melee
* 8 - Acid
* 9 - Smoke
'''NOTE:''' A damage type other than 0-9 will do nothing.
| 0
|-
| '''tuAuto'''
'''accuracyAuto'''
| The percentage (0-100%) of [[Time Units]] (from the soldier's total) required to fire an Auto Shot. If 0, the weapon does not have an Auto Shot.
The base accuracy (0-100%) applied to a soldier's [[Firing Accuracy]] when firing an Auto Shot.
| 0
0
|-
| '''tuSnap'''
'''accuracySnap'''
| The percentage (0-100%) of [[Time Units]] (from the soldier's total) required to fire a Snap Shot. If 0, the weapon does not have a Snap Shot.
The base accuracy (0-100%) applied to a soldier's [[Firing Accuracy]] when firing a Snap Shot.
| 0
0
|-
| '''tuAimed'''
'''accuracyAimed'''
| The percentage (0-100%) of [[Time Units]] (from the soldier's total) required to fire an Aimed Shot. If 0, the weapon does not have an Aimed Shot.
The base accuracy (0-100%) applied to a soldier's [[Firing Accuracy]] when firing an Aimed Shot.
| 0
0
|-
|-
| '''tuMelee'''
'''accuracyMelee'''
| The percentage (0-100%) of [[Time Units]] (from the soldier's total) required to do a melee attack (Hit). If 0, the weapon does not have a melee attack.
The base accuracy (0-100%) applied to a soldier's [[Melee Accuracy]] when doing a melee attack.
| 0
0
|-
| '''clipSize'''
| The amount of ammo stored in each weapon clip. If -1 is specified, this weapon has infinite ammo.
| 0
|-
| '''battleType'''
| Defines the weapon's behavior in the Battlescape:
* 0 - None (Geoscape-only item)
* 1 - [[Weapons|Firearm]]
* 2 - Ammo
* 3 - Melee
* 4 - [[Grenade]]
* 5 - [[Proximity Grenade]]
* 6 - [[Medi-Kit (EU)|Medi-Kit]]
* 7 - [[Motion Scanner]]
* 8 - [[Mind Probe]]
* 9 - [[Psi-Amp]]
* 10 - [[Electro-flare]]
* 11 - Corpse
| 0
|-
| '''twoHanded'''
| Is this weapon two-handed? If true, incurs an accuracy penalty if used with both hands occupied. Note that the handsprite of a twoHanded item is also drawn at a slightly different position than a one handed item.
| false
|-
| '''waypoint'''
| Does this weapon use waypoints? (eg. [[Blaster Launcher]]). Can also be used to make ammo items use the waypoint system.
| false
|-
| '''fixedWeapon'''
| Is this weapon fixed? (it's part of a unit, eg. tanks and terrorist units)
| false
|-
| '''invWidth'''
| Item width in a soldier's inventory (in grid units).
| 1
|-
| '''invHeight'''
| Item height in a soldier's inventory (in grid units).
| 1
|-
| '''painKiller'''
| Amount of painkillers contained in a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''heal'''
| Amount of heal's contained in a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''stimulant'''
| Amount of stimulants contained in a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''woundRecovery'''
| Amount of [[Fatal Wounds]] treated by each heal of a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''healthRecovery'''
| Amount of [[Health]] recovered by each heal of a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''stunRecovery'''
| Amount of [[Stun]] removed by each stimulant of a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''energyRecovery'''
| Amount of [[Energy]] recovered by each stimulant of a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''tuUse'''
| Amount of [[Time Units]] required to use this item (for non-offensive items). It's a flat rate if '''flatRate''' is true, otherwise it's a percentage (0-100%).
| 0
|-
| '''recoveryPoints'''
| [[Score]] gained for recovering this alien artifact.
| 0
|-
| '''armor'''
| How much damage is needed to destroy this item on the ground.
| 20
|-
| '''recover'''
| Is this item recoverable? (gets transported to the X-COM base on mission success)
| true
|-
| '''turretType'''
| Sprite ID from [[TANKS.PCK]] of the turret to assign to this tank:
* 0 - [[Tank/Cannon]]
* 1 - [[Tank/Rocket Launcher]]
* 2 - [[Tank/Laser Cannon]]
* 3 - [[Hovertank/Plasma]]
* 4 - [[Hovertank/Launcher]]
| -1
|-
| '''liveAlien'''
| Does this item represent a live alien? (counts towards [[Alien Containment]])
| false
|-
| '''blastRadius'''
| Size of the projectile explosions. 0 for no explosion. -1 to automatically calculate based on weapon power and damage type (actual '''blastRadius''' currently is capped due [[Explosions#Playing_With_Fire|Explosion calculations]]).
| -1
|-
| '''flatRate'''
| If true, then TU costs for this weapon are a flat rate (instead of a percentage of unit TUs).
| false
|-
| '''arcingShot'''
| Does this weapon fire in an arc?
| false
|-
| '''attraction'''
| Represents how likely an alien is to pick up this item. Values below 5 will be ignored (by design).
| 0
|-
| '''maxRange'''
| Maximum range at which this weapon can operate.
| 200
|-
| '''aimRange'''
| Maximum effective range with this weapon before which range-based dropoff occurs.
| 200
|-
| '''snapRange'''
| Maximum effective range with snap shot before which range-based dropoff occurs. (ufoextender accuracy only)
| 15
|-
| '''autoRange'''
| Maximum effective range with auto shot before which range-based dropoff occurs. (ufoextender accuracy only)
| 7
|-
| '''minRange'''
| Range-based dropoff will work in reverse for ranges below this.
| 0
|-
| '''dropoff'''
| The value by which the accuracy lowers for each tile after (or before) the thresholds above.
| 2
|-
| '''bulletSpeed'''
| How much faster (or slower, if you use a negative number) is a projectile fired from this weapon compared to the average.
| 0
|-
| '''autoShots'''
| How many auto shots does this weapon fire.
| 3
|-
| '''shotgunPellets'''
| Number of projectiles fired per unit of ammunition. (note: due to engine limitations it is currently impossible to draw multiple projectiles in flight.)
| 0
|-
| '''zombieUnit'''
| String ID of the unit used for zombification (eg. [[Chrysallid]]s turn units into [[Zombie]]s).
| none
|-
| '''meleeSound'''
| Sound ID from [[#Extra_Sounds|BATTLE.CAT]] played when this weapon attacks a target with melee.
| 39
|-
| '''meleeHitSound'''
| Sound ID from [[#Extra_Sounds|BATTLE.CAT]] played when this weapon HITS a target with melee.
| -1
|-
| '''meleeAnimation'''
| Sprite ID from HIT.PCK played when this weapon attacks a target with melee.
| 0
|-
| '''meleePower'''
| Damage this weapon will do when using melee. This only applies to Firearms, and is only available as stun damage. For normal melee weapons, use regular power and damage types.
| 0
|-
| '''LOSRequired'''
| Does this item require line of sight? (only applies to mind probes and psi-amps)
| false
|-
| '''skillApplied'''
| Is melee skill applied to the accuracy of an attack made with this object?
| true
|-
|}

=== UFOs ===

Defines one of the [[UFOs]] that invade Earth, listed in ''"ufos:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the UFO name.
| ''required''
|-
| '''size'''
| String ID of the UFO size.
| STR_VERY_SMALL
|-
| '''sprite'''
| Sprite ID from [[INTERWIN.DAT]] used to draw this UFO in the dogfight view and UFOpaedia.
don't try to add more images if you don't want to punch yourself in the face - use modsprite
| -1
|-
| '''modSprite'''
| Filename used to draw this UFO in the dogfight view and UFOpaedia.
| -
|-
| '''damageMax'''
| Maximum amount of damage this UFO can take. If the UFO takes 50% damage, it crash lands. If it takes 100% damage, it is destroyed.
| 0
|-
| '''speedMax'''
| Maximum speed in nautical miles.
| 0
|-
| '''accel'''
| Aceeleration value shown in the UFOpaedia.
| 0
|-
| '''power'''
| Damage power of this UFO's weapon in dogfights.
| 0
|-
| '''range'''
| Maximum range of this UFO's weapon in dogfights (in meters).
| 0
|-
| '''score'''
| [[Score]] gained when this UFO is destroyed, or half this score if it crash lands.
| 0
|-
| '''reload'''
| Time the UFO's weapon takes to fire between each shot.
| 0
|-
| '''breakOffTime'''
| Minimum amount of time for the UFO to be able to break off of a dogfight.
| 0
|-
| '''battlescapeTerrainData'''
| [[#Terrains|Terrain]] associated to this UFO in Battlescape missions.
| ''required''
|-
|}

=== Inventory Sections ===

Defines one of the sections of the [[Inventory TU Table|Battlescape inventory]] (eg. Backpack), listed in ''"invs:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the inventory name.
| ''required''
|-
| '''x'''
'''y'''
| Pixel coordinates of this section on the inventory screen.
| 0
0
|-
| '''type'''
| Type of this section:
* 0 = Slot section, can contain as many items as will fit on the slots.
* 1 = Hand section, can only contain one item regardless of size.
* 2 = Ground section, can contain infinite items.
| 0
|-
| '''slots'''
| List of the grid slots (''[x, y]'') that this section is composed of. For example, to make a 2x2 section, you would have ''[0, 0] [0, 1] [1, 0] [1, 1]''.
| -
|-
| '''costs'''
| List of [[Time Units]] costs to move an item from this section to another one (eg. ''STR_BACKPACK: 16'' means it will cost 16 TUs to move an item from this section to the Backpack).
| -
|-
|}

=== Terrains ===

Defines one of the [[TERRAIN|terrains]] used to generate a Battlescape map, listed in "terrains:".

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''name'''
| String ID of the terrain name.
| ''required''
|-
| '''largeBlockLimit'''
| Maximum amount of large blocks that can be used on map generation. (obsolete with nightly > 2014-11-19)
| 0
|-
| '''textures'''
| List of [[TEXTURE.DAT|Geoscape textures]] that correspond to this terrain.
| -
|-
| '''hemisphere'''
| Geoscape hemisphere associated with this terrain:
* -1 - Northern hemisphere.
* 0 - Both hemispheres.
* 1 - Southern hemisphere.
| 0
|-
| '''mapDataSets'''
| List of filenames (each with matching [[MCD]]/[[Image Formats#PCK|PCK/TAB]] files) that contain the tiles of this terrain.
| -
|-
| '''mapBlocks'''
| List of map blocks (see below) that are used for generating a map.
| -
|-
| '''roadTypeOdds'''
| Odds as a % of generating each type of road (E-W Road, N-S Road, Crossing) odds for crossing are: 100 - EW - NS. (obsolete with nightly > 2014-11-19)
| [0 0]
|-|-
| '''civilianTypes'''
| List of units to use as civilians for this mission.
| [MALE_CIVILIAN, FEMALE_CIVILIAN]
|-
|}

==== Map Blocks ====

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''name'''
| Filename of the [[MAPS|map]].
| ''required''
|-
| '''width'''
| Width of this map block in Battlescape grid units.
| 0
|-
| '''length'''
| Length of this map block in Battlescape grid units.
| 0
|-
| '''height'''
| Height of this map block in Battlescape grid units.
| 1
|-
| '''type'''
| Type of this map block:
(obsolete with nightly > 2014-11-19)
* -1 - Undefined
* 0 - Default
* 1 - Landing Zone (for placing X-COM / alien craft)
* 2 - E-W Road (for city maps)
* 3 - N-S Road (for city maps)
* 4 - Road Crossing (for city maps)
* 5 - Dirt (for filling empty base blocks)
* 6 - X-COM spawn point (for [[Alien Base]] / [[Cydonia]] missions)
* 7 - [[Alien Base]] Target
* 8 - [[Cydonia]] Target
| -1
|-
| '''subType'''
| Sub-type of this map block (see '''type'''). (obsolete with nightly > 2014-11-19)
| -1
|-
| '''frequency'''
| Frequency of this block in a map. (obsolete with nightly > 2014-11-19)
| 1
|-
| '''maxCount'''
| Maximum amount of times this block can be used in a map. If -1 there is no limit. (obsolete with nightly > 2014-11-19)
| -1
|-
| '''items'''
| An array of items to add to this mapblock, an the positions to place them at.
| -1
|}

*'''frequency''' defines the odds of the map appearing on the map
** The value assigned (default: 1) is used in ''x/n'', which defines the probability of being chosen.
** ''x'' is the integer defined for the map block's frequency and ''n'' is the combined total of probabilities for all the map types combined.
** This property can only be used in type 0 map blocks.
*'''maxCount''' is the maximum number of times it can be used.
** The value assigned is also used in ''x/n'' to determine the probability of being chosen.
** Each use reduces ''x'' by -1, with the caveat that being used as a Landing Zone type will not reduce the x value since it could result in no available Landing Zones.
** This property can only be used in type 0 map blocks.
* '''hemisphere''' only applies to UFO missions, not Terror ones.
*'''width/length''' defines the size of the map
** be aware that the mapview "width"-label is the openxcom ruleset length parameter
** be aware that the mapview "length"-label is the openxcom ruleset width parameter

==== Guidelines/Tips ====
* All maps with an XCOM/Alien craft require at least one type 1 map block. This map block can only contain ground tiles (no walls or objects), otherwise the game will crash or the walls/objects will be removed.
* All Terror terrains (listed under STR_TERROR_MISSION) require at least 1 map block of '''Types''' 2, 3 and 4 (for a total of 3 maps, which are required to place roads) and the corresponding '''roadTypeOdds''' added to the ruleset.
* If there isn't any map blocks designed as roads since you want to keep your terrain 'random', this can be circumvented by designating all 10x10 map blocks, excluding the one(s) used for the XCOM craft, as either '''Type''' 2, 3 and 4 and by defining their '''subType''' to 0. The game will then randomly choose between the map blocks for each type used in the roads, making them map more random.

=== Armor ===

Defines a Battlescape unit's [[armor]] as well as visual representation (so every unit has an armor), listed in ''"armors:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the armor name.
| ''required''
|-
| '''spriteSheet'''
| Sprite sheet from [[UNITS]] used to draw a unit wearing this armor.
| -
|-
| '''spriteInv'''
| Sprite used for the [[Inventory Backgrounds]] of a unit wearing this armor.
| -
|-
| '''corpseBattle'''
| List of string IDs of the corpse [[#Items|items]] generated when a unit wearing this armor is killed (one per unit tile) on the Battlescape.
| -
|-
| '''corpseGeo'''
| String ID of the corpse [[#Items|item]] associated with this unit on the Geoscape.
| -
|-
| '''storeItem'''
| String ID of the [[#Items|item]] that represents this armor in [[Base Stores]] for equipping.
| -
|-
| '''weight'''
| Physical weight of the armor when worn
| 6
|-
| '''stats'''
| like soldier stats (see below) but these are treated as stat bonuses for wearing the specific armor.
| -
|-
| '''frontArmor'''
| Protection provided on the front of the unit.
| 0
|-
| '''sideArmor'''
| Protection provided on the sides of the unit.
| 0
|-
| '''rearArmor'''
| Protection provided on the rear of the unit.
| 0
|-
| '''underArmor'''
| Protection provided under the unit (eg. from explosions).
| 0
|-
| '''drawingRoutine'''
| Drawing routine used to put together the body parts in the unit's '''spriteSheet''':
* 0 = [[Soldier]], [[Sectoid]]
* 1 = [[Floater]]
* 2 = [[HWP]]
* 3 = [[Cyberdisk]]
* 4 = [[Civilian]], [[Ethereal]]
* 5 = [[Sectopod]], [[Reaper]]
* 6 = [[Snakeman]]
* 7 = [[Chryssalid]]
* 8 = [[Silacoid]]
* 9 = [[Celatid]]
* 10 = [[Muton]]
* 11 = [[Submersible Weapons Systems]]
* 12 = [[Hallucinoid]]
* 13 = [[Aquanauts]]
* 14 = [[Calcinite]], [[Deep One]], [[Gillman]], [[Lobster Man]], [[Tasoth]]
* 15 = [[Aquatoid]]
* 16 = [[Bio-Drone]]
| 0
|-
| '''movementType'''
| Type of movement provided by this armor:
* 0 = Walking
* 1 = Flying
* 2 = Sliding (no walking animation)
it also defines the body of an tank (32-images) in your spriteSheet or the change in sprites while flying using a flying armour see: [[TANKS.PCK]], [[XCOM_2.PCK]]
| 0
|-
| '''damageModifier'''
| List of decimal damage modifiers (1.0 = 100%) this armor applies to each damage type (see [[#Items|Items section]]) received. Modifiers must be specified for all damage types, in this order:
* None
* Armor Piercing
* Incendiary
* High Explosive
* Laser
* Plasma
* Stun
* Melee
* Acid
* Smoke
|
- 1.0 
- 1.0 
- 1.0 
- 1.0 
- 1.0 
- 1.0 
- 1.0 
- 1.0 
- 1.0 
- 1.0
|-
| '''size'''
| Size of the unit wearing this armor, in Battlescape grid units. Every unit is square, so a size of 2 means 2x2.
| 1
|-
| '''loftempsSet'''
| List of [[LOFTEMPS]] IDs (one per unit tile, so a 1x1 unit has 1, a 2x2 unit has 4, etc.) used to represent a unit wearing this armor in 3D space.
| -
|-
| '''loftemps'''
| loftemps is a deprecated option that only works for 1x1 sized units.
| -
|-
| '''forcedTorso'''
| soldier sprites have female and male torsos. some armours reuse these sprites for flying/non flying torso without difference between genders. This can be controlled by the parameter: 0 = use genderrelated torso, 1 = use male torso, 2 = use female torso
| 0

|}

=== Player Units (Soldiers) ===

Defines a [[soldier]] recruited by X-COM, listed in ''"soldiers:"''. Currently only one soldier unit type (''XCOM'') is supported.

Unit stats are represented as follows:
* [[Time Units|tu]]
* [[Energy|stamina]]
* [[Health|health]]
* [[Bravery|bravery]] (always a multiple of 10)
* [[Reactions|reactions]]
* [[Firing Accuracy|firing]]
* [[Throwing Accuracy|throwing]]
* [[Strength|strength]]
* [[Psi Strength|psiStrength]]
* [[Psi Skill|psiSkill]]
* [[Melee Accuracy|melee]] (not visible)

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the soldier name.
| ''required''
|-
| '''minStats'''
| Minimum values used to generate the soldier's [[Starting Stats]]. In this case, ''psiSkill'' is treated as the initial stat (not generated).
| -
|-
| '''maxStats'''
| Maximum values used to generate the soldier's [[Starting Stats]]. In this case, ''psiSkill'' is treated as the minimum value for the first month of psi training (actual value is 100%-150%).
| -
|-
| '''statCaps'''
| Maximum stats this soldier can gain through [[Experience]]. '''NOTE:''' A stat will still go over the limit once, and then will no longer increase (see [[Experience#Regarding Caps|Regarding Caps]]).
| -
|-
| '''armor'''
| String ID of the [[#Armor|armor]] this soldier uses by default.
| -
|-
| '''standHeight'''
| Height of this soldier when standing.
| 0
|-
| '''kneelHeight'''
| Height of this soldier when kneeling.
| 0
|-
| '''floatHeight'''
| Distance between the bottom of this unit and the ground.
| 0
|-
| '''femaleFrequency'''
| The probability that a female soldier is hired.
| 50
|}

=== AI Units (Aliens/Civilians) ===

Defines an [[Alien Life Forms|alien]] (enemy) or [[civilian]] (neutral) unit, listed in ''"units:"''. Every different alien rank is a different unit, since they have completely different stats. Unit stats are represented as follows:
* [[Time Units|tu]]
* [[Energy|stamina]]
* [[Health|health]]
* [[Bravery|bravery]] (always a multiple of 10)
* [[Reactions|reactions]]
* [[Firing Accuracy|firing]]
* [[Throwing Accuracy|throwing]]
* [[Strength|strength]]
* [[Psi Strength|psiStrength]]
* [[Psi Skill|psiSkill]]
* [[Melee Accuracy|melee]] (not visible)

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the unit name.
| ''required''
|-
| '''race'''
| String ID of the unit race (for alien units).
| -
|-
| '''rank'''
| String ID of the unit rank (for alien units).
| -
|-
| '''stats'''
| Battlescape stats of this unit.
| -
|-
| '''armor'''
| String ID of the [[#Armor|armor]] this unit uses by default.
| -
|-
| '''standHeight'''
| Height of this unit when standing.
| 0
|-
| '''floatHeight'''
| Distance between the bottom of this unit and the ground.
| 0
|-
| '''value'''
| [[Score]] this unit is worth.
| 0
|-
| '''deathSound'''
| Sound ID from [[#Extra_Sounds|BATTLE.CAT]] played when this unit dies.
| -1
|-
| '''aggroSound'''
| Sound ID from [[#Extra_Sounds|BATTLE.CAT]] played when this unit aggros.
| -1
|-
| '''moveSound'''
| Sound ID from [[#Extra_Sounds|BATTLE.CAT]] played when this unit moves.
| -1
|-
| '''intelligence'''
| Intelligence of this unit's AI. The higher the value, the longer this unit remembers player troops between turns.
| 0
|-
| '''aggression'''
| Aggression of this unit's AI. The higher the value, the more ruthless the unit, the more likely to make a frontal assault. Less aggressive units tend to set up ambushes.
Vanilla values are:
* 0 = mostly passive
* 1 = balanced
* 2 = mostly aggresive
| 0
|-
| '''energyRecovery'''
| Energy recovered by the unit each turn (needs verification)
| 40 (?)
|-
| '''specab'''
| Special ability of this unit:
* 0 = None
* 1 = [[Cyberdisc|Explodes on Death]]
* 2 = [[Bio-Drone|Burns Floor]]
* 3 = Burns Floor and explodes on Death
| 0
|-
| '''spawnUnit'''
| String ID of the unit used to respawn on death (eg. [[Zombie]]s respawn as [[Chrysallid]]s).
| -
|-
| '''livingWeapon'''
| Is this unit a living weapon? (only attacks with a '''fixedWeapon''')
| false
|-
| '''female'''
| Is this unit a female? (used for TFTD civilian types)
| false
|-
|}

=== Alien Races ===

Defines a [[Alien Life Forms|race]] used in [[Alien Missions]], listed in ''"alienRaces:"''. Heavily tied with deployment data.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''id'''
| String ID of the alien race name.
| ''required''
|-
| '''members'''
| Alien crew associated with this alien race (eg. race units + terrorist units), defined by a list of unit string IDs. Order here will define rank in terms of deployment. generally speaking the order is:
* 0 - Commander
* 1 - Leader
* 2 - Engineer
* 3 - Medic
* 4 - Navigator
* 5 - Soldier
* 6 - Terrorist 1
* 7 - Terrorist 2
but of course, not all races have all ranks, so the "fill in" rank would be listed multiple times (see ethereals).
| -
|-
| '''retaliation'''
| retaliation enables/disables the race for retaliation missions.
| ''True''
|-
|}

=== Alien Deployments ===

Defines a Battlescape deployment data used in [[Alien Missions]] (such as alien and map configurations), listed in ''"alienDeployments:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the deployment name.
| ''required''
|-
| '''width'''
| Width of the Battlescape map in grid units.
| 0
|-
| '''length'''
| Length of the Battlescape map in grid units.
| 0
|-
| '''height'''
| Vertical height of the Battlescape map in grid units.
| 0
|-
| '''terrains'''
| list of string IDs of the [[#Terrains|terrain]] to choose from to generate this map. This is not used for UFO sites where the terrain comes from the Geoscape.
| -
|-
| '''shade'''
| Shade of the map (0-15, where 0 is full daytime and 15 is full nighttime). This is not used for UFO sites where the shade comes from the Geoscape.
| 0
|-
| '''nextStage'''
| String ID of the next deployment stage to use after this one, for multi-stage missions.
| -
|-
| '''race'''
| Sets the race to use in the next stage.
| ""
|-
| '''script'''
| Reference to a mapScript.
| ""
|-
| '''data'''
| List of deployment data for each alien rank on this mission (see below).
| -
|}

Notes:
* '''terrains''' can also be used with UFOs, with the game using instead the listed terrain rather than the location of the UFO on Geoscape.
==== Deployment Data ====

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''alienRank'''
| [[Alien Rank|Rank]] associated with this deployment data, as defined by the order of the race in question (see above)
| ''required''
|-
| '''lowQty'''
| Maximum quantity of aliens to spawn (beginner).
| 0
|-
| '''highQty'''
| Maximum quantity of aliens to spawn (superhuman).
| 0
|-
| '''dQty'''
| Minimum Desired Quantity of aliens to spawn.
| 0
|-
| '''extraQty'''
| spawns a random number of additional aliens.
| 0
|-
| '''percentageOutsideUfo'''
| Percentage (0-100%) of aliens to spawn outside in UFO sites.
| 0
|-
| '''itemSets'''
| Three lists (one for each alien technology level) of [[#Items|items]] (string IDs) for the aliens to equip.
| ''required''
|-
|}

=== Research ===

Defines a [[Research|research topic]] that X-COM scientists can investigate, listed in ''"research:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''name'''
| String ID of the research project's name (or item, if a '''lookup''' is defined).
| ''required''
|-
| '''lookup'''
| String ID of the research project's display name and UFOPaedia article reference.
| -
|-
| '''cost'''
| Number of man hours (on average) required to complete this project.
| 0
|-
| '''points'''
| [[Score]] earned for completing this project.
| 0
|-
| '''needItem'''
| Does this project require an [[#Items|item]] of the same name?
| false
|-
| '''dependencies'''
| List of research projects that can unlock access to this one. If the full list is researched, or if one of the projects on the list "unlocks" this one, it becomes available.
| -
|-
| '''unlocks'''
| List of research projects unlocked, regardless of other dependencies, but not requirements, by completing this project (for example, any live alien unlocks "alien origins").
| -
|-
| '''requires'''
| List of research projects unilaterally required before this project can be unlocked (for example, "the martian solution" will not even be considered for unlocking until AFTER "alien origins" is completed).
| -
|-
| '''getOneFree'''
| List of "bonus" research projects that may be granted when completing this project (for example, alien medics will give you information on other alien races). Only applies to living aliens.
| -
|-
|}

=== Manufacture ===

Defines a [[Manufacture|manufacture project]] that X-COM engineers can produce, listed in ''"manufacture:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''name'''
| String ID of the manufacturing project's name (and the item it produces).
| ''required''
|-
| '''category'''
| String ID of the manufacturing project's category.
| -
|-
| '''requires'''
| List of [[#Research|topics]] (string IDs) that must be researched to unlock this project. If none are specified, this project is unlocked from the start.
| -
|-
| '''space'''
| Amount of [[Workshop]] space required to begin this project.
| 0
|-
| '''time'''
| Number of man hours (on average) required per item.
| 0
|-
| '''cost'''
| Monetary deduction per item manufactured.
| 0
|-
| '''requiredItems'''
| List of [[#Items|items]] required and consumed per item manufactured.
| -
|-
| '''producedItems'''
| List of [[#Items|items]] produced per each item consumed. If not specified, defaults to 1 item with the same string ID as the manufacture.
| 1
|-
|}

=== UFOpaedia Article ===

Defines an article in the in-game [[UFOpaedia]], listed in ''"ufopaedia:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''id'''
| String ID of the article name. This must match the ID of the object associated with this article, if applicable.
| ''required''
|-
| '''title'''
| String ID of the article title. If omitted, the '''id''' is used.
| -
|-
| '''type_id'''
| Type of this article:
* 0 = Unknown
* 1 = [[Craft]]
* 2 = [[Craft Armaments]]
* 3 = [[HWP]]
* 4 = [[Equipment (EU)|Equipment]]
* 5 = [[Armour]]
* 6 = [[Base Facilities]]
* 7 = Text & Image (eg. [[Alien Life Forms]], [[UFO Components]])
* 8 = Text (eg. [[Alien Research]])
* 9 = [[UFO]]
| 0
|-
| '''section'''
| String ID of the UFOpaedia section this article belongs in.
| -
|-
| '''requires'''
| List of [[#Research|topics]] (string IDs) that must be researched to unlock this article. If none are specified, this article is unlocked from the start.
| -
|-
| '''image_id'''
| Filename of the [[UP001.SPK-UP042.SPK|background image]] displayed on this article, if applicable.
| -
|-
| '''text'''
| String ID of the description displayed on this article.
| -
|-
| '''text_width'''
| Maximum width of the text displayed, only applicable to ''Text & Image'' articles.
| 0
|-
| '''rect_stats'''
| Rectangle ('''x''', '''y''', '''width''', '''height''') of the stats text on the screen, only applicable to ''Craft'' articles.
| 0
|-
| '''rect_text'''
| Rectangle ('''x''', '''y''', '''width''', '''height''') of the description text on the screen, only applicable to ''Craft'' articles.
| 0
|-
| '''weapon'''
| String ID of the weapon, only applicable to ''HWP'' articles.
| -
|}

=== UFO Trajectories ===

Defines a trajectory carried out by an UFO during an [[#Alien Missions|alien mission]], listed in ''"ufoTrajectories:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''id'''
| String ID of the trajectory name.
| ''required''
|-
| '''groundTimer'''
| Amount of seconds for the UFO to spend on Ground waypoints.
| 0
|-
| '''waypoints'''
| List of waypoints for the UFO to traverse, defined as ''[zone, altitude, speed]''. 
'''zone''': Globe zone where the waypoint is located. 
'''altitude''': UFO altitude after reaching this waypoint:
* 0 - Ground
* 1 - Very Low
* 2 - Low
* 3 - High
* 4 - Very High
'''speed''': UFO speed after reaching this waypoint, as a percentage (0-100%) of its maximum speed.
| -
|}

=== Alien Missions ===

Defines an [[Alien Missions|alien mission]] carried out by UFOs on the Geoscape, listed in ''"alienMissions:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the mission type.
| ''required''
|-
| '''points'''
| [[Score]] allocated to aliens for successfully completing this mission.
| 0
|-
| '''raceWeights'''
| List of alien races likely to carry out this mission, and the % chance of them being allocated to this mission, listed by "number of months after game beginning".
| ''required''
|-
| '''waves'''
| List of UFO waves to spawn as this mission progresses, as described below.
| ''required''
|}

==== Waves ====

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''ufo'''
| String ID of the [[#UFOs|UFO]] to spawn.
| ''required''
|-
| '''count'''
| Number of UFOs to spawn.
| 0
|-
| '''trajectory'''
| String ID of the [[#UFO Trajectories|trajectory]] for this UFO to use when entering Earth's atmosphere.
| ''required''
|-
| '''timer'''
| How long after the previous wave should this wave arrive? (in seconds)
| 0
|-
|}

=== Alien Item Levels ===

This is a list of item level probabilities, with a number between 0 and 2 representing an item level from plasma pistols to heavy plasmas, as defined in the deployments, expressing a 10% probability for that item level being used.

0 = first set (plasma pistol/clip)
1 = second set (plasma rifle/clip)
2 = third set (heavy plasma/clip)

For example:
[ 2, 0, 0, 0, 0, 0, 0, 1, 1, 1 ]
would represent a 60% chance for pistols, 30% rifles, and 10% heavy weapons. 
Note that the order does not matter, but the length DOES. each line MUST have 10 digits.

The above can be confusing. There are 10 fields; each number represents 10%. 
There are six instances of '0'. 6x10% = 60% chance of plasma pistol 
There are three instances of '1'. 3x10% = 30% chance of plasma rifle 
There is only one instance of '2'. 1x10% = 10% chance of heavy plasma 

Each line represents a month after the beginning of the game, and there is no limit to the number defined. 
OpenXCom will use the most recently available item level in the event the game goes on forever.

=== Extra Sprites ===

Adds or replaces sprites in an existing [[Image Formats|X-COM image file]], listed in ''"extraSprites:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| Filename of the original/new image to modify.
| ''required''
|-
| '''width'''
'''height'''
| Size of the sprite(s) in pixels.
| 0
0
|-
| '''singleImage'''
| Is the image file just a single sprite (true) or a spritesheet (false)?
| false
|-
| '''subX'''
'''subY'''
| Size of the subdivision in pixels. If a subdivision is specified, then the image file is divided into chunks to form the sprites (eg. spritesheets).
| 0
0
|-
| '''files'''
| List of the new sprites to add/replace, listed as ''spriteID: filename''.
| -
|}

Example:
- type: GIANTBUNNY.PCK
width: 32
height: 40
files:
0: Resources/Bunny/Bunny00.png
1: Resources/Bunny/Bunny01.bmp
2: Resources/Bunny/Bunny02.gif

=== Extra Sounds ===

Adds or replaces sounds in an existing [[SOUND|X-COM sound file]], listed in ''"extraSounds:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| ID of the original sound file to modify:
* BATTLE.CAT - Battlescape sounds, corresponds to ''SOUND1.CAT'' or ''SAMPLE2.CAT'' (55 sounds).
* INTRO.CAT - Intro sounds, corresponds to ''INTRO.CAT'' or ''SAMPLE3.CAT'', probably best not to mess with these.
* GEO.CAT - Geoscape sounds, corresponds to ''SOUND2.CAT'' or ''SAMPLE.CAT'' (14 sounds).
| ''required''
|-
| '''files'''
| List of the new sounds to add/replace, listed as ''soundID: filename''.
| -
|}

Example:
- type: BATTLE.CAT
files:
55: Resources/Sounds/sample.wav

=== Extra Strings ===

Adds or replaces text strings in an existing [[Translations (OpenXcom)|OpenXcom language file]], listed in ''"extraStrings:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| Filename of the original language file to modify, sans extension.
| ''required''
|-
| '''strings'''
| List of the new strings to add/replace, listed as ''stringID: text''.
| -
|}

Example:
- type: en-US
strings:
STR_SNIPER_RIFLE: Sniper Rifle
STR_SNIPER_RIFLE_CLIP: Sniper Rifle Clip
- type: en-GB
strings:
STR_SNIPER_RIFLE: Sniper Rifle
STR_SNIPER_RIFLE_CLIP: Sniper Rifle Clip
- type: de
strings:
STR_SNIPER_RIFLE: Scharfschützengewehr
STR_SNIPER_RIFLE_CLIP: Scharfschützengewehrmunition
- type: ru
strings:
STR_SNIPER_RIFLE: Снайперская винтовка
STR_SNIPER_RIFLE_CLIP: Магазин к снайп. винтовке

=== Interfaces ===

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| ''?''
| -
|-
| '''elements'''
| ''?''
| -
|-
| '''id'''
| ''?''
| -
|-
| '''color'''
| ''?''
| -
|}

=== StatStrings ===

[[Statstrings]] are used for automatically renaming soldiers. They are case sensitive and they are processed in the order in which they are specified.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''string'''
| String to add to name.
| ''required''
|-
| '''psiStrength''' 
'''psiSkill''' 
'''bravery''' 
'''strength''' 
'''firing''' 
'''reactions''' 
'''stamina''' 
'''tu''' 
'''health''' 
'''throwing'''
| One or more stat ranges are ANDed together for success. Each range has a minVal and maxVal. Use YAML standard tilde (~) to indicate null. ((~) = 0 as minvalue; (~) =255 as maxvalue)
| -
|}

Example:
statStrings:
- string: "x"
psiStrength: [~, 30]
- string: "P"
psiStrength: [80, ~]
- string: "p"
psiStrength: [60, 79]
- string: "K"
psiSkill: [60, ~]
- string: "k"
psiSkill: [30, 59]
- string: "b"
bravery: [60, ~]
- string: "c"
bravery: [~, 10]
- string: "w"
strength: [~, 25]
- string: "Snpr"
firing: [60, ~]
reactions: [60, ~]
- string: "M"
firing: [70, ~]
- string: "m"
firing: [60, 69]
- string: "Sct"
reactions: [50, ~]
tu: [60, ~]
- string: "R"
reactions: [60, ~]
- string: "r"
reactions: [50, 59]

==References==
<references />

[[Category:OpenXcom]]

Ruleset Reference (OpenXcom)

2014-12-04T22:35:24Z

Falko: /* Terrains */

A reference of all the customizable values of everything in a [[Rulesets (OpenXcom)|ruleset]]. Some guidelines:
* If a value is omitted from the ruleset, the default is used. You cannot omit ''required'' values.
* Text strings (eg. names) are represented by string IDs from the [[Translations (OpenXcom)|language files]]
* Numerical IDs (used for sprites, sounds, etc.) start at 0, not 1.
* Boolean (yes/no) values are represented by true/false.
* World coordinates are represented in degrees (see [[WORLD.DAT]]).
* Money amounts (prices, costs, etc.) are represented in dollars.
* All paths are '''case sensitive'''! If your ruleset uses external files, make sure that they named properly as described in ruleset.

Items are ordered as they come in the ruleset. To override this, you can specify a ''listOrder''. You can find the default listOrders in [[Ruleset List Order (OpenXcom)|Ruleset List Order]].

=== Globe ===

Defines the drawing of landmasses and borders on the globe.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''data'''
| Path name of file which contains polygon and texture information. (For example WORLD.DAT).
| -
|-
| '''polygons'''
| List of polygons drawn on the globe surface. A triangle consist of seven values: the first number defines the texture, followed by three pairs of (x,y) globe coordinates. Only polygons with 3 or 4 vertices are reliable shown on the globe = 7 or 9 values per entry.
| -
|-
| '''polylines'''
| List of border lines. Each list entry consist of a list of (x,y) globe coordinates.
| -
|}

=== Countries ===

Defines one of the [[Country Funding (EU)|funding nations]], listed in ''"countries:"''. They're used for activity graphs and player scoring.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the country name.
| ''required''
|-
| '''fundingBase'''
| Country's base funding, in thousands. The starting funding can be anywhere between 1x and 2x the base funding.
| 0
|-
| '''fundingCap'''
| Country's funding cap, in thousands. Once a country reaches this maximum, it will no longer increase its funding.
| 0
|-
| '''labelLon'''
'''labelLat'''
| Longitude and latitude coordinates of the country's label on the globe. This label is only shown when the globe is zoomed in and "detail" is turned on.
| 0.0
0.0
|-
| '''areas'''
| List of "rectangles" on the globe defined as [''lon1'' ''lat1'' ''lon2'' ''lat2'']. Any activity within these areas counts towards the country's graph activity and affects their opinion of the player.
| -
|}

=== Regions ===

Defines one of the [[Geoscape (EU)#World Regions/Countries|world regions]], listed in ''"regions:"''. They're used for base placement, activity graphs and mission spawning.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the region name.
| ''required''
|-
| '''cost'''
| Amount of money spent building an X-COM base in this region (first base is free).
| 0
|-
| '''areas'''
| List of "rectangles" on the globe defined as ''[lon1, lat1, lon2, lat2]''. Any activity within these areas counts towards the region's graph activity.
| -
|-
| '''cities'''
| List of cities belonging to this region. They will be displayed on the globe and used for terror site missions. Each city is defined by their '''lon''' and '''lat''' coordinates and a '''name''' string ID.
| -
|-
| '''regionWeight'''
| Weight of this region when selecting regions for alien missions.
| 0
|-
| '''missionWeights'''
| Weighted list of the different mission types for this region (eg. ''STR_ALIEN_RESEARCH: 14'').
| -
|-
| '''missionZones'''
| List of "rectangles" (''[lon1, lat1, lon2, lat2]'') defining the mission zones for this region. Mission zones are waypoints for UFO trajectories.
| -
|-
| '''missionRegion'''
| Spawn mission in this region instead (used for regions without land).
| -
|}

=== Base Facilities ===

Defines one of the [[Base Facilities (EU)|facilities]] that can be built in an X-COM base, listed in ''"facilities:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the facility name.
| ''required''
|-
| '''requires'''
| List of [[#Research|topics]] (string IDs) that must be researched to unlock this facility. If none are specified, this facility is unlocked from the start.
| -
|-
| '''spriteShape'''
| Sprite ID from [[BASEBITS.PCK]] used to draw the facility's outer shape in the Basescape and UFOpaedia.
| -1
|-
| '''spriteFacility'''
| Sprite ID from [[BASEBITS.PCK]] used to draw the facility's contents in the Basescape and UFOpaedia. Drawn on top of '''spriteShape'''.
| -1
|-
| '''lift'''
| Is this facility an [[Access Lift]]? All base facilities must be connected to the lift.
| false
|-
| '''hyper'''
| Is this facility a [[Hyperwave Decoder]]? Displays extra information for detected UFOs. Only valid for radar facilities.
| false
|-
| '''mind'''
| Is this facility a [[Mind Shield]]? Reduces the chance of UFOs finding your base. Does not stack.
| false
|-
| '''grav'''
| Is this facility a [[Grav Shield]]? Doubles the power of your base defenses. Does not stack.
| false
|-
| '''size'''
| Size of the facility, in grid units. Every facility is square, so a size of 1 means 1x1, 2 means 2x2, etc. Bigger facilities are made up of multiple sprites, for example a 2x2 facility will use 4 sprites for '''spriteShape''' and 4 sprites for '''spriteFacility''' (top-left, top-right, bottom-left, bottom-right).
| 1
|-
| '''buildCost'''
| Amount of money spent to build this facility in the base.
| 0
|-
| '''buildTime'''
| Amount of days it takes for this facility to be built.
| 0
|-
| '''monthlyCost'''
| Amount of money spent monthly for the maintenance of this facility.
| 0
|-
| '''storage'''
| Amount of storage space (for items) this facility provides. See [[Base Stores]].
| 0
|-
| '''personnel'''
| Amount of personnel (soldiers, scientsts, engineers) these quarters can contain.
| 0
|-
| '''aliens'''
| Amount of live aliens this facility can contain. Only checked if the ''alienContainmentLimitEnforced'' option is enabled.
| 0
|-
| '''crafts'''
| Amount of X-COM craft this facility can contain.
| 0
|-
| '''labs'''
| Amount of lab space this facility provides for research projects.
| 0
|-
| '''workshops'''
| Amount of workshop space this facility provides for manufacture projects.
| 0
|-
| '''psiLabs'''
| Amount of soldier space this facility provides for psionic training.
| 0
|-
| '''radarRange'''
| Maximum radar detection range of this facility, in nautical miles.
| 0
|-
| '''radarChance'''
| Chance (0-100%) of this radar detecting a UFO that enters its range.
| 0
|-
| '''defense'''
| Offensive power provided by this base defense against attacking UFOs.
| 0
|-
| '''hitRatio'''
| Chance (0-100) of the base defense hitting an attacking UFO.
| 0
|-
| '''fireSound'''
| Sound ID from [[#Extra_Sounds|GEO.CAT]] played when the base defense fires.
| -1
|-
| '''hitSound'''
| Sound ID from [[#Extra_Sounds|GEO.CAT]] played when the base defense hits a target.
| -1
|-
| '''mapName'''
| [[MAPS|Map]] associated to this facility in Battlescape base defenses.
| -
|-
|}

=== Crafts ===

Defines one of the [[Craft|X-COM crafts]] that go on interception missions, listed in ''"crafts:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the craft name.
| ''required''
|-
| '''requires'''
| List of [[#Research|topics]] (string IDs) that must be researched to unlock this craft. If none are specified, this craft is unlocked from the start.
| -
|-
| '''sprite'''
| Sprite ID from [[BASEBITS.PCK]] used to draw this craft in the Basescape and from [[INTICON.PCK]] used to draw the damage indicator in dogfights.
modders: the corresponding extrasprite file id for BASEBITS.PCK is sprite+33 INTICON.PCK contains a minimized icon id=sprite the file id for the dogfight image is sprite+11
| -1
|-
| '''fuelMax'''
| Maximum amount of fuel this craft can carry. Crafts use up fuel based on their speed while travelling.
| 0
|-
| '''damageMax'''
| Maximum amount of damage this craft can take. If this amount is exceeded, the craft is destroyed.
| 0
|-
| '''speedMax'''
| Maximum speed in nautical miles. Crafts travel at max speed when flying and half speed when patrolling.
| 0
|-
| '''accel'''
| Aceeleration value shown in the UFOpaedia.
| 0
|-
| '''weapons'''
| Amount of craft weapons this craft can equip. The UI can only display a max of 2 weapons.
| 0
|-
| '''soldiers'''
| Amount of soldiers this craft can carry.
| 0
|-
| '''maxItems'''
| Amount of items this craft can carry.
| 80
|-
| '''vehicles'''
| Amount of vehicles this craft can carry.
| 0
|-
| '''costBuy'''
| Amount of money spent for purchasing this craft. If set to 0, the craft will not be available in the Purchase/Recruit screen.
| 0
|-
| '''costRent'''
| Amount of money spent monthly for renting this craft. If set to 0, the craft is not on rental and won't count towards base maintenance.
| 0
|-
| '''costSell'''
| Amount of money gained for selling this craft.
| 0
|-
| '''refuelItem'''
| Item required for refuelling this craft. If no item is specified, the craft uses human fuel.
| 0
|-
| '''repairRate'''
| Amount of damage restored every hour while [[Repairs|Repairing]] in base.
| 1
|-
| '''refuelRate'''
| Amount of fuel restored every 30 mins while [[Refueling]] in base. If specified, a '''refuelItem''' is spent each time.
| 1
|-
| '''radarRange'''
| Detection range of the craft's radar in nautical miles. Every craft radar has a 100% detection chance.
| 600
|-
| '''transferTime'''
| Number of hours it takes to purchase/transfer this craft to a base.
| 0
|-
| '''score'''
| [[Score]] lost when this craft is destroyed.
| 0
|-
| '''spacecraft'''
| Can this craft go to [[Cydonia]]?
| false
|-
| '''battlescapeTerrainData'''
| [[#Terrains|Terrain]] associated to this craft in Battlescape missions.
| -
|}

=== Craft Weapons ===

Defines one of the [[Craft Armaments|weapons]] equipped by X-COM craft for shooting down UFOs, listed in ''"craftWeapons:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the weapon name.
| ''required''
|-
| '''sprite'''
| Sprite ID from [[BASEBITS.PCK]] used to draw the weapon in the Basescape and from [[INTICON.PCK]] used to draw the weapon in dogfights.
modders: the corresponding extrasprites file id for INTICON.PCK is sprite+5 and sprite+48 for BASEBITS.PCK
| -1
|-
| '''sound'''
| Sound ID from [[#Extra_Sounds|GEO.CAT]] played when this weapon fires.
| -1
|-
| '''damage'''
| Amount of damage this weapon does to enemy UFOs.
| 0
|-
| '''range'''
| Maximum range of this weapon in dogfights (in meters).
| 0
|-
| '''accuracy'''
| Chance (0-100%) of each shot hitting the enemy UFO.
| 0
|-
| '''reloadCautious'''
| Time this weapon takes to fire between each shot in ''Cautious Mode''.
| 0
|-
| '''reloadStandard'''
| Time this weapon takes to fire between each shot in ''Standard Mode''.
| 0
|-
| '''reloadAggressive'''
| Time this weapon takes to fire between each shot in ''Aggressive Mode''.
| 0
|-
| '''ammoMax'''
| Maximum amount of ammo this weapon can carry.
| 0
|-
| '''rearmRate'''
| Amount of ammo restored every 30 mins while the craft is [[Rearming]] in base. If specified, '''clip'''s are spent depending on their '''clipSize'''. If the '''clipSize''' of the specified ammo is 0, no '''clip'''s are spent.
| 1
|-
| '''projectileType'''
| Type of the weapon projectile, used for the projectile sprite in dogfights:
* 0 - [[Stingray]]
* 1 - [[Avalanche]]
* 2 - [[Cannon]]
* 3 - [[Fusion Ball]]
* 4 - [[Laser Cannon]]
* 5 - [[Plasma Beam]]
| 2
|-
| '''projectileSpeed'''
| Speed of the weapon projectile in dogfights.
| 0
|-
| '''launcher'''
| String ID of the [[#Items|item]] required to equip this weapon.
| -
|-
| '''clip'''
| String ID of the [[#Items|item]] required to rearm this weapon.
| -
|}

=== Items ===

Defines the Geoscape and Battlescape properties of an [[Equipment (EU)|item]] that can be stored in X-COM bases, listed in ''"items:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the internal item name.
| ''required''
|-
| '''name'''
| String ID of the displayed item name, for cases where it's different from the internal name. If omitted, '''type''' is used.
| -
|-
| '''requires'''
| List of [[#Research|topics]] (string IDs) that must be researched to unlock this item. If none are specified, this item is unlocked from the start. Soldiers can only use unlocked items in the Battlescape.
| -
|-
| '''size'''
| Space occupied by this item in [[Base Stores]]. Can be a decimal value.
| 0.0
|-
| '''costBuy'''
| Amount of money spent for purchasing this item. If set to 0, this item will not be available in the Purchase/Recruit screen.
| 0
|-
| '''costSell'''
| Amount of money gained for selling this item.
| 0
|-
| '''transferTime'''
| Number of hours it takes to purchase/transfer this item to a base.
| 24
|-
| '''weight'''
| [[Item_Weight|Weight]] occupied by this item in a soldier's inventory.
| 999
|-
| '''bigSprite'''
| Sprite ID from [[BIGOBS.PCK]] used to draw this item in a soldier's inventory and UFOpaedia.
| -1
|-
| '''floorSprite'''
| Sprite ID from [[FLOOROB.PCK]] used to draw this item on the floor of a Battlescape tile.
| -1
|-
| '''handSprite'''
| Sprite ID from [[HANDOB.PCK]] used to draw this item on a soldier's hand in the Battlescape.
modders: each handobject needs 8 images (8 directions) define the extrasprites accordingly
| 120
|-
| '''bulletSprite'''
| Sprite ID from ''BulletSprites.png'' used to draw this weapon's projectile on the Battlescape:
* 0 - [[Rocket Launcher]]
* 1 - [[Pistol]]
* 2 - [[Rifle]]
* 3 - [[Auto Cannon]]
* 4 - [[Heavy Cannon]]
* 5 - [[Laser Pistol]]
* 6 - [[Laser Rifle]]
* 7 - [[Heavy Laser]]
* 8 - [[Plasma Rifle|Plasma]]
* 9 - [[Small Launcher]]
* 10 - [[Blaster Launcher]]
for modders: the bulletsprite needs to be put into the extraSprites type "Projectiles" the bulletsprite can contain up to 35 3x3 images. The corresponding file id is 35*[bulletSprite]
| -1
|-
| '''fireSound'''
| Sound ID from [[#Extra_Sounds|BATTLE.CAT]] played when this weapon fires.
| -1
|-
| '''hitSound'''
| Sound ID from [[#Extra_Sounds|BATTLE.CAT]] played when this weapon hits a target.
| -1
|-
| '''hitAnimation'''
| Sprite ID from [[SMOKE.PCK]] used to draw the weapon's "hit explosion".
'''NOTE''': Do not define this value for melee/psi weapons, they use [[HIT.PCK]] and therefore meleeAnimation instead.
| 0
|-
| '''power'''
| Average damage of the weapon, in most cases it will be +-50% this value.
| 0
|-
| '''strengthApplied'''
| Add the attacking unit's strength to this weapon's damage.
| false
|-
| '''compatibleAmmo'''
| List of string IDs of the ammo items that can be loaded on this weapon. If none are specified, the weapon doesn't need ammo.
| -
|-
| '''damageType'''
| What type of [[damage]] does this weapon do:
* 0 - None
* 1 - Armor Piercing
* 2 - Incendiary
* 3 - High Explosive
* 4 - Laser
* 5 - Plasma
* 6 - Stun
* 7 - Melee
* 8 - Acid
* 9 - Smoke
'''NOTE:''' A damage type other than 0-9 will do nothing.
| 0
|-
| '''tuAuto'''
'''accuracyAuto'''
| The percentage (0-100%) of [[Time Units]] (from the soldier's total) required to fire an Auto Shot. If 0, the weapon does not have an Auto Shot.
The base accuracy (0-100%) applied to a soldier's [[Firing Accuracy]] when firing an Auto Shot.
| 0
0
|-
| '''tuSnap'''
'''accuracySnap'''
| The percentage (0-100%) of [[Time Units]] (from the soldier's total) required to fire a Snap Shot. If 0, the weapon does not have a Snap Shot.
The base accuracy (0-100%) applied to a soldier's [[Firing Accuracy]] when firing a Snap Shot.
| 0
0
|-
| '''tuAimed'''
'''accuracyAimed'''
| The percentage (0-100%) of [[Time Units]] (from the soldier's total) required to fire an Aimed Shot. If 0, the weapon does not have an Aimed Shot.
The base accuracy (0-100%) applied to a soldier's [[Firing Accuracy]] when firing an Aimed Shot.
| 0
0
|-
|-
| '''tuMelee'''
'''accuracyMelee'''
| The percentage (0-100%) of [[Time Units]] (from the soldier's total) required to do a melee attack (Hit). If 0, the weapon does not have a melee attack.
The base accuracy (0-100%) applied to a soldier's [[Melee Accuracy]] when doing a melee attack.
| 0
0
|-
| '''clipSize'''
| The amount of ammo stored in each weapon clip. If -1 is specified, this weapon has infinite ammo.
| 0
|-
| '''battleType'''
| Defines the weapon's behavior in the Battlescape:
* 0 - None (Geoscape-only item)
* 1 - [[Weapons|Firearm]]
* 2 - Ammo
* 3 - Melee
* 4 - [[Grenade]]
* 5 - [[Proximity Grenade]]
* 6 - [[Medi-Kit (EU)|Medi-Kit]]
* 7 - [[Motion Scanner]]
* 8 - [[Mind Probe]]
* 9 - [[Psi-Amp]]
* 10 - [[Electro-flare]]
* 11 - Corpse
| 0
|-
| '''twoHanded'''
| Is this weapon two-handed? If true, incurs an accuracy penalty if used with both hands occupied. Note that the handsprite of a twoHanded item is also drawn at a slightly different position than a one handed item.
| false
|-
| '''waypoint'''
| Does this weapon use waypoints? (eg. [[Blaster Launcher]]). Can also be used to make ammo items use the waypoint system.
| false
|-
| '''fixedWeapon'''
| Is this weapon fixed? (it's part of a unit, eg. tanks and terrorist units)
| false
|-
| '''invWidth'''
| Item width in a soldier's inventory (in grid units).
| 1
|-
| '''invHeight'''
| Item height in a soldier's inventory (in grid units).
| 1
|-
| '''painKiller'''
| Amount of painkillers contained in a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''heal'''
| Amount of heal's contained in a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''stimulant'''
| Amount of stimulants contained in a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''woundRecovery'''
| Amount of [[Fatal Wounds]] treated by each heal of a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''healthRecovery'''
| Amount of [[Health]] recovered by each heal of a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''stunRecovery'''
| Amount of [[Stun]] removed by each stimulant of a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''energyRecovery'''
| Amount of [[Energy]] recovered by each stimulant of a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''tuUse'''
| Amount of [[Time Units]] required to use this item (for non-offensive items). It's a flat rate if '''flatRate''' is true, otherwise it's a percentage (0-100%).
| 0
|-
| '''recoveryPoints'''
| [[Score]] gained for recovering this alien artifact.
| 0
|-
| '''armor'''
| How much damage is needed to destroy this item on the ground.
| 20
|-
| '''recover'''
| Is this item recoverable? (gets transported to the X-COM base on mission success)
| true
|-
| '''turretType'''
| Sprite ID from [[TANKS.PCK]] of the turret to assign to this tank:
* 0 - [[Tank/Cannon]]
* 1 - [[Tank/Rocket Launcher]]
* 2 - [[Tank/Laser Cannon]]
* 3 - [[Hovertank/Plasma]]
* 4 - [[Hovertank/Launcher]]
| -1
|-
| '''liveAlien'''
| Does this item represent a live alien? (counts towards [[Alien Containment]])
| false
|-
| '''blastRadius'''
| Size of the projectile explosions. 0 for no explosion. -1 to automatically calculate based on weapon power and damage type (actual '''blastRadius''' currently is capped due [[Explosions#Playing_With_Fire|Explosion calculations]]).
| -1
|-
| '''flatRate'''
| If true, then TU costs for this weapon are a flat rate (instead of a percentage of unit TUs).
| false
|-
| '''arcingShot'''
| Does this weapon fire in an arc?
| false
|-
| '''attraction'''
| Represents how likely an alien is to pick up this item. Values below 5 will be ignored (by design).
| 0
|-
| '''maxRange'''
| Maximum range at which this weapon can operate.
| 200
|-
| '''aimRange'''
| Maximum effective range with this weapon before which range-based dropoff occurs.
| 200
|-
| '''snapRange'''
| Maximum effective range with snap shot before which range-based dropoff occurs. (ufoextender accuracy only)
| 15
|-
| '''autoRange'''
| Maximum effective range with auto shot before which range-based dropoff occurs. (ufoextender accuracy only)
| 7
|-
| '''minRange'''
| Range-based dropoff will work in reverse for ranges below this.
| 0
|-
| '''dropoff'''
| The value by which the accuracy lowers for each tile after (or before) the thresholds above.
| 2
|-
| '''bulletSpeed'''
| How much faster (or slower, if you use a negative number) is a projectile fired from this weapon compared to the average.
| 0
|-
| '''autoShots'''
| How many auto shots does this weapon fire.
| 3
|-
| '''shotgunPellets'''
| Number of projectiles fired per unit of ammunition. (note: due to engine limitations it is currently impossible to draw multiple projectiles in flight.)
| 0
|-
| '''zombieUnit'''
| String ID of the unit used for zombification (eg. [[Chrysallid]]s turn units into [[Zombie]]s).
| none
|-
| '''meleeSound'''
| Sound ID from [[#Extra_Sounds|BATTLE.CAT]] played when this weapon attacks a target with melee.
| 39
|-
| '''meleeHitSound'''
| Sound ID from [[#Extra_Sounds|BATTLE.CAT]] played when this weapon HITS a target with melee.
| -1
|-
| '''meleeAnimation'''
| Sprite ID from HIT.PCK played when this weapon attacks a target with melee.
| 0
|-
| '''meleePower'''
| Damage this weapon will do when using melee. This only applies to Firearms, and is only available as stun damage. For normal melee weapons, use regular power and damage types.
| 0
|-
| '''LOSRequired'''
| Does this item require line of sight? (only applies to mind probes and psi-amps)
| false
|-
| '''skillApplied'''
| Is melee skill applied to the accuracy of an attack made with this object?
| true
|-
|}

=== UFOs ===

Defines one of the [[UFOs]] that invade Earth, listed in ''"ufos:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the UFO name.
| ''required''
|-
| '''size'''
| String ID of the UFO size.
| STR_VERY_SMALL
|-
| '''sprite'''
| Sprite ID from [[INTERWIN.DAT]] used to draw this UFO in the dogfight view and UFOpaedia.
don't try to add more images if you don't want to punch yourself in the face - use modsprite
| -1
|-
| '''modSprite'''
| Filename used to draw this UFO in the dogfight view and UFOpaedia.
| -
|-
| '''damageMax'''
| Maximum amount of damage this UFO can take. If the UFO takes 50% damage, it crash lands. If it takes 100% damage, it is destroyed.
| 0
|-
| '''speedMax'''
| Maximum speed in nautical miles.
| 0
|-
| '''accel'''
| Aceeleration value shown in the UFOpaedia.
| 0
|-
| '''power'''
| Damage power of this UFO's weapon in dogfights.
| 0
|-
| '''range'''
| Maximum range of this UFO's weapon in dogfights (in meters).
| 0
|-
| '''score'''
| [[Score]] gained when this UFO is destroyed, or half this score if it crash lands.
| 0
|-
| '''reload'''
| Time the UFO's weapon takes to fire between each shot.
| 0
|-
| '''breakOffTime'''
| Minimum amount of time for the UFO to be able to break off of a dogfight.
| 0
|-
| '''battlescapeTerrainData'''
| [[#Terrains|Terrain]] associated to this UFO in Battlescape missions.
| ''required''
|-
|}

=== Inventory Sections ===

Defines one of the sections of the [[Inventory TU Table|Battlescape inventory]] (eg. Backpack), listed in ''"invs:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the inventory name.
| ''required''
|-
| '''x'''
'''y'''
| Pixel coordinates of this section on the inventory screen.
| 0
0
|-
| '''type'''
| Type of this section:
* 0 = Slot section, can contain as many items as will fit on the slots.
* 1 = Hand section, can only contain one item regardless of size.
* 2 = Ground section, can contain infinite items.
| 0
|-
| '''slots'''
| List of the grid slots (''[x, y]'') that this section is composed of. For example, to make a 2x2 section, you would have ''[0, 0] [0, 1] [1, 0] [1, 1]''.
| -
|-
| '''costs'''
| List of [[Time Units]] costs to move an item from this section to another one (eg. ''STR_BACKPACK: 16'' means it will cost 16 TUs to move an item from this section to the Backpack).
| -
|-
|}

=== Terrains ===

Defines one of the [[TERRAIN|terrains]] used to generate a Battlescape map, listed in "terrains:".

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''name'''
| String ID of the terrain name.
| ''required''
|-
| '''largeBlockLimit'''
| Maximum amount of large blocks that can be used on map generation. (obsolete with nightly > 2014-11-19)
| 0
|-
| '''textures'''
| List of [[TEXTURE.DAT|Geoscape textures]] that correspond to this terrain.
| -
|-
| '''hemisphere'''
| Geoscape hemisphere associated with this terrain:
* -1 - Northern hemisphere.
* 0 - Both hemispheres.
* 1 - Southern hemisphere.
| 0
|-
| '''mapDataSets'''
| List of filenames (each with matching [[MCD]]/[[Image Formats#PCK|PCK/TAB]] files) that contain the tiles of this terrain.
| -
|-
| '''mapBlocks'''
| List of map blocks (see below) that are used for generating a map.
| -
|-
| '''roadTypeOdds'''
| Odds as a % of generating each type of road (E-W Road, N-S Road, Crossing) odds for crossing are: 100 - EW - NS. (obsolete with nightly > 2014-11-19)
| [0 0]
|-|-
| '''civilianTypes'''
| List of units to use as civilians for this mission.
| [MALE_CIVILIAN, FEMALE_CIVILIAN]
|-
|}

==== Map Blocks ====

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''name'''
| Filename of the [[MAPS|map]].
| ''required''
|-
| '''width'''
| Width of this map block in Battlescape grid units.
| 0
|-
| '''length'''
| Length of this map block in Battlescape grid units.
| 0
|-
| '''height'''
| Height of this map block in Battlescape grid units.
| 1
|-
| '''type'''
| Type of this map block:
(obsolete with nightly > 2014-11-19)
* -1 - Undefined
* 0 - Default
* 1 - Landing Zone (for placing X-COM / alien craft)
* 2 - E-W Road (for city maps)
* 3 - N-S Road (for city maps)
* 4 - Road Crossing (for city maps)
* 5 - Dirt (for filling empty base blocks)
* 6 - X-COM spawn point (for [[Alien Base]] / [[Cydonia]] missions)
* 7 - [[Alien Base]] Target
* 8 - [[Cydonia]] Target
| -1
|-
| '''subType'''
| Sub-type of this map block (see '''type'''). (obsolete with nightly > 2014-11-19)
| -1
|-
| '''frequency'''
| Frequency of this block in a map. (obsolete with nightly > 2014-11-19)
| 1
|-
| '''maxCount'''
| Maximum amount of times this block can be used in a map. If -1 there is no limit. (obsolete with nightly > 2014-11-19)
| -1
|-
| '''items'''
| An array of items to add to this mapblock, an the positions to place them at.
| -1
|}

*'''frequency''' defines the odds of the map appearing on the map
** The value assigned (default: 1) is used in ''x/n'', which defines the probability of being chosen.
** ''x'' is the integer defined for the map block's frequency and ''n'' is the combined total of probabilities for all the map types combined.
** This property can only be used in type 0 map blocks.
*'''maxCount''' is the maximum number of times it can be used.
** The value assigned is also used in ''x/n'' to determine the probability of being chosen.
** Each use reduces ''x'' by -1, with the caveat that being used as a Landing Zone type will not reduce the x value since it could result in no available Landing Zones.
** This property can only be used in type 0 map blocks.
* '''hemisphere''' only applies to UFO missions, not Terror ones.
*'''width/length''' defines the size of the map
** be aware that the mapview "width"-label is the openxcom ruleset length parameter
** be aware that the mapview "length"-label is the openxcom ruleset width parameter

==== Guidelines/Tips ====
* All maps with an XCOM/Alien craft require at least one type 1 map block. This map block can only contain ground tiles (no walls or objects), otherwise the game will crash or the walls/objects will be removed.
* All Terror terrains (listed under STR_TERROR_MISSION) require at least 1 map block of '''Types''' 2, 3 and 4 (for a total of 3 maps, which are required to place roads) and the corresponding '''roadTypeOdds''' added to the ruleset.
* If there isn't any map blocks designed as roads since you want to keep your terrain 'random', this can be circumvented by designating all 10x10 map blocks, excluding the one(s) used for the XCOM craft, as either '''Type''' 2, 3 and 4 and by defining their '''subType''' to 0. The game will then randomly choose between the map blocks for each type used in the roads, making them map more random.

=== Armor ===

Defines a Battlescape unit's [[armor]] as well as visual representation (so every unit has an armor), listed in ''"armors:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the armor name.
| ''required''
|-
| '''spriteSheet'''
| Sprite sheet from [[UNITS]] used to draw a unit wearing this armor.
| -
|-
| '''spriteInv'''
| Sprite used for the [[Inventory Backgrounds]] of a unit wearing this armor.
| -
|-
| '''corpseBattle'''
| List of string IDs of the corpse [[#Items|items]] generated when a unit wearing this armor is killed (one per unit tile) on the Battlescape.
| -
|-
| '''corpseGeo'''
| String ID of the corpse [[#Items|item]] associated with this unit on the Geoscape.
| -
|-
| '''storeItem'''
| String ID of the [[#Items|item]] that represents this armor in [[Base Stores]] for equipping.
| -
|-
| '''weight'''
| Physical weight of the armor when worn
| 6
|-
| '''stats'''
| like soldier stats (see below) but these are treated as stat bonuses for wearing the specific armor.
| -
|-
| '''frontArmor'''
| Protection provided on the front of the unit.
| 0
|-
| '''sideArmor'''
| Protection provided on the sides of the unit.
| 0
|-
| '''rearArmor'''
| Protection provided on the rear of the unit.
| 0
|-
| '''underArmor'''
| Protection provided under the unit (eg. from explosions).
| 0
|-
| '''drawingRoutine'''
| Drawing routine used to put together the body parts in the unit's '''spriteSheet''':
* 0 = [[Soldier]], [[Sectoid]]
* 1 = [[Floater]]
* 2 = [[HWP]]
* 3 = [[Cyberdisk]]
* 4 = [[Civilian]], [[Ethereal]]
* 5 = [[Sectopod]], [[Reaper]]
* 6 = [[Snakeman]]
* 7 = [[Chryssalid]]
* 8 = [[Silacoid]]
* 9 = [[Celatid]]
* 10 = [[Muton]]
* 11 = [[Submersible Weapons Systems]]
* 12 = [[Hallucinoid]]
* 13 = [[Aquanauts]]
* 14 = [[Calcinite]], [[Deep One]], [[Gillman]], [[Lobster Man]], [[Tasoth]]
* 15 = [[Aquatoid]]
* 16 = [[Bio-Drone]]
| 0
|-
| '''movementType'''
| Type of movement provided by this armor:
* 0 = Walking
* 1 = Flying
* 2 = Sliding (no walking animation)
it also defines the body of an tank (32-images) in your spriteSheet or the change in sprites while flying using a flying armour see: [[TANKS.PCK]], [[XCOM_2.PCK]]
| 0
|-
| '''damageModifier'''
| List of decimal damage modifiers (1.0 = 100%) this armor applies to each damage type (see [[#Items|Items section]]) received. Modifiers must be specified for all damage types, in this order:
* None
* Armor Piercing
* Incendiary
* High Explosive
* Laser
* Plasma
* Stun
* Melee
* Acid
* Smoke
|
- 1.0 
- 1.0 
- 1.0 
- 1.0 
- 1.0 
- 1.0 
- 1.0 
- 1.0 
- 1.0 
- 1.0
|-
| '''size'''
| Size of the unit wearing this armor, in Battlescape grid units. Every unit is square, so a size of 2 means 2x2.
| 1
|-
| '''loftempsSet'''
| List of [[LOFTEMPS]] IDs (one per unit tile, so a 1x1 unit has 1, a 2x2 unit has 4, etc.) used to represent a unit wearing this armor in 3D space.
| -
|-
| '''loftemps'''
| loftemps is a deprecated option that only works for 1x1 sized units.
| -
|-
| '''forcedTorso'''
| soldier sprites have female and male torsos. some armours reuse these sprites for flying/non flying torso without difference between genders. This can be controlled by the parameter: 0 = use genderrelated torso, 1 = use male torso, 2 = use female torso
| 0

|}

=== Player Units (Soldiers) ===

Defines a [[soldier]] recruited by X-COM, listed in ''"soldiers:"''. Currently only one soldier unit type (''XCOM'') is supported.

Unit stats are represented as follows:
* [[Time Units|tu]]
* [[Energy|stamina]]
* [[Health|health]]
* [[Bravery|bravery]] (always a multiple of 10)
* [[Reactions|reactions]]
* [[Firing Accuracy|firing]]
* [[Throwing Accuracy|throwing]]
* [[Strength|strength]]
* [[Psi Strength|psiStrength]]
* [[Psi Skill|psiSkill]]
* [[Melee Accuracy|melee]] (not visible)

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the soldier name.
| ''required''
|-
| '''minStats'''
| Minimum values used to generate the soldier's [[Starting Stats]]. In this case, ''psiSkill'' is treated as the initial stat (not generated).
| -
|-
| '''maxStats'''
| Maximum values used to generate the soldier's [[Starting Stats]]. In this case, ''psiSkill'' is treated as the minimum value for the first month of psi training (actual value is 100%-150%).
| -
|-
| '''statCaps'''
| Maximum stats this soldier can gain through [[Experience]]. '''NOTE:''' A stat will still go over the limit once, and then will no longer increase (see [[Experience#Regarding Caps|Regarding Caps]]).
| -
|-
| '''armor'''
| String ID of the [[#Armor|armor]] this soldier uses by default.
| -
|-
| '''standHeight'''
| Height of this soldier when standing.
| 0
|-
| '''kneelHeight'''
| Height of this soldier when kneeling.
| 0
|-
| '''floatHeight'''
| Distance between the bottom of this unit and the ground.
| 0
|-
| '''femaleFrequency'''
| The probability that a female soldier is hired.
| 50
|}

=== AI Units (Aliens/Civilians) ===

Defines an [[Alien Life Forms|alien]] (enemy) or [[civilian]] (neutral) unit, listed in ''"units:"''. Every different alien rank is a different unit, since they have completely different stats. Unit stats are represented as follows:
* [[Time Units|tu]]
* [[Energy|stamina]]
* [[Health|health]]
* [[Bravery|bravery]] (always a multiple of 10)
* [[Reactions|reactions]]
* [[Firing Accuracy|firing]]
* [[Throwing Accuracy|throwing]]
* [[Strength|strength]]
* [[Psi Strength|psiStrength]]
* [[Psi Skill|psiSkill]]
* [[Melee Accuracy|melee]] (not visible)

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the unit name.
| ''required''
|-
| '''race'''
| String ID of the unit race (for alien units).
| -
|-
| '''rank'''
| String ID of the unit rank (for alien units).
| -
|-
| '''stats'''
| Battlescape stats of this unit.
| -
|-
| '''armor'''
| String ID of the [[#Armor|armor]] this unit uses by default.
| -
|-
| '''standHeight'''
| Height of this unit when standing.
| 0
|-
| '''floatHeight'''
| Distance between the bottom of this unit and the ground.
| 0
|-
| '''value'''
| [[Score]] this unit is worth.
| 0
|-
| '''deathSound'''
| Sound ID from [[#Extra_Sounds|BATTLE.CAT]] played when this unit dies.
| -1
|-
| '''aggroSound'''
| Sound ID from [[#Extra_Sounds|BATTLE.CAT]] played when this unit aggros.
| -1
|-
| '''moveSound'''
| Sound ID from [[#Extra_Sounds|BATTLE.CAT]] played when this unit moves.
| -1
|-
| '''intelligence'''
| Intelligence of this unit's AI. The higher the value, the longer this unit remembers player troops between turns.
| 0
|-
| '''aggression'''
| Aggression of this unit's AI. The higher the value, the more ruthless the unit, the more likely to make a frontal assault. Less aggressive units tend to set up ambushes.
Vanilla values are:
* 0 = mostly passive
* 1 = balanced
* 2 = mostly aggresive
| 0
|-
| '''energyRecovery'''
| Energy recovered by the unit each turn (needs verification)
| 40 (?)
|-
| '''specab'''
| Special ability of this unit:
* 0 = None
* 1 = [[Cyberdisc|Explodes on Death]]
* 2 = [[Bio-Drone|Burns Floor]]
* 3 = Burns Floor and explodes on Death
| 0
|-
| '''spawnUnit'''
| String ID of the unit used to respawn on death (eg. [[Zombie]]s respawn as [[Chrysallid]]s).
| -
|-
| '''livingWeapon'''
| Is this unit a living weapon? (only attacks with a '''fixedWeapon''')
| false
|-
| '''female'''
| Is this unit a female? (used for TFTD civilian types)
| false
|-
|}

=== Alien Races ===

Defines a [[Alien Life Forms|race]] used in [[Alien Missions]], listed in ''"alienRaces:"''. Heavily tied with deployment data.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''id'''
| String ID of the alien race name.
| ''required''
|-
| '''members'''
| Alien crew associated with this alien race (eg. race units + terrorist units), defined by a list of unit string IDs. Order here will define rank in terms of deployment. generally speaking the order is:
* 0 - Commander
* 1 - Leader
* 2 - Engineer
* 3 - Medic
* 4 - Navigator
* 5 - Soldier
* 6 - Terrorist 1
* 7 - Terrorist 2
but of course, not all races have all ranks, so the "fill in" rank would be listed multiple times (see ethereals).
| -
|-
| '''retaliation'''
| retaliation enables/disables the race for retaliation missions.
| ''True''
|-
|}

=== Alien Deployments ===

Defines a Battlescape deployment data used in [[Alien Missions]] (such as alien and map configurations), listed in ''"alienDeployments:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the deployment name.
| ''required''
|-
| '''width'''
| Width of the Battlescape map in grid units.
| 0
|-
| '''length'''
| Length of the Battlescape map in grid units.
| 0
|-
| '''height'''
| Vertical height of the Battlescape map in grid units.
| 0
|-
| '''terrains'''
| list of string IDs of the [[#Terrains|terrain]] to choose from to generate this map. This is not used for UFO sites where the terrain comes from the Geoscape.
| -
|-
| '''shade'''
| Shade of the map (0-15, where 0 is full daytime and 15 is full nighttime). This is not used for UFO sites where the shade comes from the Geoscape.
| 0
|-
| '''nextStage'''
| String ID of the next deployment stage to use after this one, for multi-stage missions.
| -
|-
| '''race'''
| Sets the race to use in the next stage.
| ""
|-
| '''data'''
| List of deployment data for each alien rank on this mission (see below).
| -
|}

Notes:
* '''terrains''' can also be used with UFOs, with the game using instead the listed terrain rather than the location of the UFO on Geoscape.
==== Deployment Data ====

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''alienRank'''
| [[Alien Rank|Rank]] associated with this deployment data, as defined by the order of the race in question (see above)
| ''required''
|-
| '''lowQty'''
| Maximum quantity of aliens to spawn (beginner).
| 0
|-
| '''highQty'''
| Maximum quantity of aliens to spawn (superhuman).
| 0
|-
| '''dQty'''
| Minimum Desired Quantity of aliens to spawn.
| 0
|-
| '''extraQty'''
| spawns a random number of additional aliens.
| 0
|-
| '''percentageOutsideUfo'''
| Percentage (0-100%) of aliens to spawn outside in UFO sites.
| 0
|-
| '''itemSets'''
| Three lists (one for each alien technology level) of [[#Items|items]] (string IDs) for the aliens to equip.
| ''required''
|-
|}

=== Research ===

Defines a [[Research|research topic]] that X-COM scientists can investigate, listed in ''"research:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''name'''
| String ID of the research project's name (or item, if a '''lookup''' is defined).
| ''required''
|-
| '''lookup'''
| String ID of the research project's display name and UFOPaedia article reference.
| -
|-
| '''cost'''
| Number of man hours (on average) required to complete this project.
| 0
|-
| '''points'''
| [[Score]] earned for completing this project.
| 0
|-
| '''needItem'''
| Does this project require an [[#Items|item]] of the same name?
| false
|-
| '''dependencies'''
| List of research projects that can unlock access to this one. If the full list is researched, or if one of the projects on the list "unlocks" this one, it becomes available.
| -
|-
| '''unlocks'''
| List of research projects unlocked, regardless of other dependencies, but not requirements, by completing this project (for example, any live alien unlocks "alien origins").
| -
|-
| '''requires'''
| List of research projects unilaterally required before this project can be unlocked (for example, "the martian solution" will not even be considered for unlocking until AFTER "alien origins" is completed).
| -
|-
| '''getOneFree'''
| List of "bonus" research projects that may be granted when completing this project (for example, alien medics will give you information on other alien races). Only applies to living aliens.
| -
|-
|}

=== Manufacture ===

Defines a [[Manufacture|manufacture project]] that X-COM engineers can produce, listed in ''"manufacture:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''name'''
| String ID of the manufacturing project's name (and the item it produces).
| ''required''
|-
| '''category'''
| String ID of the manufacturing project's category.
| -
|-
| '''requires'''
| List of [[#Research|topics]] (string IDs) that must be researched to unlock this project. If none are specified, this project is unlocked from the start.
| -
|-
| '''space'''
| Amount of [[Workshop]] space required to begin this project.
| 0
|-
| '''time'''
| Number of man hours (on average) required per item.
| 0
|-
| '''cost'''
| Monetary deduction per item manufactured.
| 0
|-
| '''requiredItems'''
| List of [[#Items|items]] required and consumed per item manufactured.
| -
|-
| '''producedItems'''
| List of [[#Items|items]] produced per each item consumed. If not specified, defaults to 1 item with the same string ID as the manufacture.
| 1
|-
|}

=== UFOpaedia Article ===

Defines an article in the in-game [[UFOpaedia]], listed in ''"ufopaedia:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''id'''
| String ID of the article name. This must match the ID of the object associated with this article, if applicable.
| ''required''
|-
| '''title'''
| String ID of the article title. If omitted, the '''id''' is used.
| -
|-
| '''type_id'''
| Type of this article:
* 0 = Unknown
* 1 = [[Craft]]
* 2 = [[Craft Armaments]]
* 3 = [[HWP]]
* 4 = [[Equipment (EU)|Equipment]]
* 5 = [[Armour]]
* 6 = [[Base Facilities]]
* 7 = Text & Image (eg. [[Alien Life Forms]], [[UFO Components]])
* 8 = Text (eg. [[Alien Research]])
* 9 = [[UFO]]
| 0
|-
| '''section'''
| String ID of the UFOpaedia section this article belongs in.
| -
|-
| '''requires'''
| List of [[#Research|topics]] (string IDs) that must be researched to unlock this article. If none are specified, this article is unlocked from the start.
| -
|-
| '''image_id'''
| Filename of the [[UP001.SPK-UP042.SPK|background image]] displayed on this article, if applicable.
| -
|-
| '''text'''
| String ID of the description displayed on this article.
| -
|-
| '''text_width'''
| Maximum width of the text displayed, only applicable to ''Text & Image'' articles.
| 0
|-
| '''rect_stats'''
| Rectangle ('''x''', '''y''', '''width''', '''height''') of the stats text on the screen, only applicable to ''Craft'' articles.
| 0
|-
| '''rect_text'''
| Rectangle ('''x''', '''y''', '''width''', '''height''') of the description text on the screen, only applicable to ''Craft'' articles.
| 0
|-
| '''weapon'''
| String ID of the weapon, only applicable to ''HWP'' articles.
| -
|}

=== UFO Trajectories ===

Defines a trajectory carried out by an UFO during an [[#Alien Missions|alien mission]], listed in ''"ufoTrajectories:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''id'''
| String ID of the trajectory name.
| ''required''
|-
| '''groundTimer'''
| Amount of seconds for the UFO to spend on Ground waypoints.
| 0
|-
| '''waypoints'''
| List of waypoints for the UFO to traverse, defined as ''[zone, altitude, speed]''. 
'''zone''': Globe zone where the waypoint is located. 
'''altitude''': UFO altitude after reaching this waypoint:
* 0 - Ground
* 1 - Very Low
* 2 - Low
* 3 - High
* 4 - Very High
'''speed''': UFO speed after reaching this waypoint, as a percentage (0-100%) of its maximum speed.
| -
|}

=== Alien Missions ===

Defines an [[Alien Missions|alien mission]] carried out by UFOs on the Geoscape, listed in ''"alienMissions:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the mission type.
| ''required''
|-
| '''points'''
| [[Score]] allocated to aliens for successfully completing this mission.
| 0
|-
| '''raceWeights'''
| List of alien races likely to carry out this mission, and the % chance of them being allocated to this mission, listed by "number of months after game beginning".
| ''required''
|-
| '''waves'''
| List of UFO waves to spawn as this mission progresses, as described below.
| ''required''
|}

==== Waves ====

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''ufo'''
| String ID of the [[#UFOs|UFO]] to spawn.
| ''required''
|-
| '''count'''
| Number of UFOs to spawn.
| 0
|-
| '''trajectory'''
| String ID of the [[#UFO Trajectories|trajectory]] for this UFO to use when entering Earth's atmosphere.
| ''required''
|-
| '''timer'''
| How long after the previous wave should this wave arrive? (in seconds)
| 0
|-
|}

=== Alien Item Levels ===

This is a list of item level probabilities, with a number between 0 and 2 representing an item level from plasma pistols to heavy plasmas, as defined in the deployments, expressing a 10% probability for that item level being used.

0 = first set (plasma pistol/clip)
1 = second set (plasma rifle/clip)
2 = third set (heavy plasma/clip)

For example:
[ 2, 0, 0, 0, 0, 0, 0, 1, 1, 1 ]
would represent a 60% chance for pistols, 30% rifles, and 10% heavy weapons. 
Note that the order does not matter, but the length DOES. each line MUST have 10 digits.

The above can be confusing. There are 10 fields; each number represents 10%. 
There are six instances of '0'. 6x10% = 60% chance of plasma pistol 
There are three instances of '1'. 3x10% = 30% chance of plasma rifle 
There is only one instance of '2'. 1x10% = 10% chance of heavy plasma 

Each line represents a month after the beginning of the game, and there is no limit to the number defined. 
OpenXCom will use the most recently available item level in the event the game goes on forever.

=== Extra Sprites ===

Adds or replaces sprites in an existing [[Image Formats|X-COM image file]], listed in ''"extraSprites:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| Filename of the original/new image to modify.
| ''required''
|-
| '''width'''
'''height'''
| Size of the sprite(s) in pixels.
| 0
0
|-
| '''singleImage'''
| Is the image file just a single sprite (true) or a spritesheet (false)?
| false
|-
| '''subX'''
'''subY'''
| Size of the subdivision in pixels. If a subdivision is specified, then the image file is divided into chunks to form the sprites (eg. spritesheets).
| 0
0
|-
| '''files'''
| List of the new sprites to add/replace, listed as ''spriteID: filename''.
| -
|}

Example:
- type: GIANTBUNNY.PCK
width: 32
height: 40
files:
0: Resources/Bunny/Bunny00.png
1: Resources/Bunny/Bunny01.bmp
2: Resources/Bunny/Bunny02.gif

=== Extra Sounds ===

Adds or replaces sounds in an existing [[SOUND|X-COM sound file]], listed in ''"extraSounds:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| ID of the original sound file to modify:
* BATTLE.CAT - Battlescape sounds, corresponds to ''SOUND1.CAT'' or ''SAMPLE2.CAT'' (55 sounds).
* INTRO.CAT - Intro sounds, corresponds to ''INTRO.CAT'' or ''SAMPLE3.CAT'', probably best not to mess with these.
* GEO.CAT - Geoscape sounds, corresponds to ''SOUND2.CAT'' or ''SAMPLE.CAT'' (14 sounds).
| ''required''
|-
| '''files'''
| List of the new sounds to add/replace, listed as ''soundID: filename''.
| -
|}

Example:
- type: BATTLE.CAT
files:
55: Resources/Sounds/sample.wav

=== Extra Strings ===

Adds or replaces text strings in an existing [[Translations (OpenXcom)|OpenXcom language file]], listed in ''"extraStrings:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| Filename of the original language file to modify, sans extension.
| ''required''
|-
| '''strings'''
| List of the new strings to add/replace, listed as ''stringID: text''.
| -
|}

Example:
- type: en-US
strings:
STR_SNIPER_RIFLE: Sniper Rifle
STR_SNIPER_RIFLE_CLIP: Sniper Rifle Clip
- type: en-GB
strings:
STR_SNIPER_RIFLE: Sniper Rifle
STR_SNIPER_RIFLE_CLIP: Sniper Rifle Clip
- type: de
strings:
STR_SNIPER_RIFLE: Scharfschützengewehr
STR_SNIPER_RIFLE_CLIP: Scharfschützengewehrmunition
- type: ru
strings:
STR_SNIPER_RIFLE: Снайперская винтовка
STR_SNIPER_RIFLE_CLIP: Магазин к снайп. винтовке

=== Interfaces ===

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| ''?''
| -
|-
| '''elements'''
| ''?''
| -
|-
| '''id'''
| ''?''
| -
|-
| '''color'''
| ''?''
| -
|}

=== StatStrings ===

[[Statstrings]] are used for automatically renaming soldiers. They are case sensitive and they are processed in the order in which they are specified.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''string'''
| String to add to name.
| ''required''
|-
| '''psiStrength''' 
'''psiSkill''' 
'''bravery''' 
'''strength''' 
'''firing''' 
'''reactions''' 
'''stamina''' 
'''tu''' 
'''health''' 
'''throwing'''
| One or more stat ranges are ANDed together for success. Each range has a minVal and maxVal. Use YAML standard tilde (~) to indicate null. ((~) = 0 as minvalue; (~) =255 as maxvalue)
| -
|}

Example:
statStrings:
- string: "x"
psiStrength: [~, 30]
- string: "P"
psiStrength: [80, ~]
- string: "p"
psiStrength: [60, 79]
- string: "K"
psiSkill: [60, ~]
- string: "k"
psiSkill: [30, 59]
- string: "b"
bravery: [60, ~]
- string: "c"
bravery: [~, 10]
- string: "w"
strength: [~, 25]
- string: "Snpr"
firing: [60, ~]
reactions: [60, ~]
- string: "M"
firing: [70, ~]
- string: "m"
firing: [60, 69]
- string: "Sct"
reactions: [50, ~]
tu: [60, ~]
- string: "R"
reactions: [60, ~]
- string: "r"
reactions: [50, 59]

==References==
<references />

[[Category:OpenXcom]]

Ruleset Reference (OpenXcom)

2014-12-04T22:34:10Z

Falko: /* Map Blocks */

A reference of all the customizable values of everything in a [[Rulesets (OpenXcom)|ruleset]]. Some guidelines:
* If a value is omitted from the ruleset, the default is used. You cannot omit ''required'' values.
* Text strings (eg. names) are represented by string IDs from the [[Translations (OpenXcom)|language files]]
* Numerical IDs (used for sprites, sounds, etc.) start at 0, not 1.
* Boolean (yes/no) values are represented by true/false.
* World coordinates are represented in degrees (see [[WORLD.DAT]]).
* Money amounts (prices, costs, etc.) are represented in dollars.
* All paths are '''case sensitive'''! If your ruleset uses external files, make sure that they named properly as described in ruleset.

Items are ordered as they come in the ruleset. To override this, you can specify a ''listOrder''. You can find the default listOrders in [[Ruleset List Order (OpenXcom)|Ruleset List Order]].

=== Globe ===

Defines the drawing of landmasses and borders on the globe.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''data'''
| Path name of file which contains polygon and texture information. (For example WORLD.DAT).
| -
|-
| '''polygons'''
| List of polygons drawn on the globe surface. A triangle consist of seven values: the first number defines the texture, followed by three pairs of (x,y) globe coordinates. Only polygons with 3 or 4 vertices are reliable shown on the globe = 7 or 9 values per entry.
| -
|-
| '''polylines'''
| List of border lines. Each list entry consist of a list of (x,y) globe coordinates.
| -
|}

=== Countries ===

Defines one of the [[Country Funding (EU)|funding nations]], listed in ''"countries:"''. They're used for activity graphs and player scoring.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the country name.
| ''required''
|-
| '''fundingBase'''
| Country's base funding, in thousands. The starting funding can be anywhere between 1x and 2x the base funding.
| 0
|-
| '''fundingCap'''
| Country's funding cap, in thousands. Once a country reaches this maximum, it will no longer increase its funding.
| 0
|-
| '''labelLon'''
'''labelLat'''
| Longitude and latitude coordinates of the country's label on the globe. This label is only shown when the globe is zoomed in and "detail" is turned on.
| 0.0
0.0
|-
| '''areas'''
| List of "rectangles" on the globe defined as [''lon1'' ''lat1'' ''lon2'' ''lat2'']. Any activity within these areas counts towards the country's graph activity and affects their opinion of the player.
| -
|}

=== Regions ===

Defines one of the [[Geoscape (EU)#World Regions/Countries|world regions]], listed in ''"regions:"''. They're used for base placement, activity graphs and mission spawning.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the region name.
| ''required''
|-
| '''cost'''
| Amount of money spent building an X-COM base in this region (first base is free).
| 0
|-
| '''areas'''
| List of "rectangles" on the globe defined as ''[lon1, lat1, lon2, lat2]''. Any activity within these areas counts towards the region's graph activity.
| -
|-
| '''cities'''
| List of cities belonging to this region. They will be displayed on the globe and used for terror site missions. Each city is defined by their '''lon''' and '''lat''' coordinates and a '''name''' string ID.
| -
|-
| '''regionWeight'''
| Weight of this region when selecting regions for alien missions.
| 0
|-
| '''missionWeights'''
| Weighted list of the different mission types for this region (eg. ''STR_ALIEN_RESEARCH: 14'').
| -
|-
| '''missionZones'''
| List of "rectangles" (''[lon1, lat1, lon2, lat2]'') defining the mission zones for this region. Mission zones are waypoints for UFO trajectories.
| -
|-
| '''missionRegion'''
| Spawn mission in this region instead (used for regions without land).
| -
|}

=== Base Facilities ===

Defines one of the [[Base Facilities (EU)|facilities]] that can be built in an X-COM base, listed in ''"facilities:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the facility name.
| ''required''
|-
| '''requires'''
| List of [[#Research|topics]] (string IDs) that must be researched to unlock this facility. If none are specified, this facility is unlocked from the start.
| -
|-
| '''spriteShape'''
| Sprite ID from [[BASEBITS.PCK]] used to draw the facility's outer shape in the Basescape and UFOpaedia.
| -1
|-
| '''spriteFacility'''
| Sprite ID from [[BASEBITS.PCK]] used to draw the facility's contents in the Basescape and UFOpaedia. Drawn on top of '''spriteShape'''.
| -1
|-
| '''lift'''
| Is this facility an [[Access Lift]]? All base facilities must be connected to the lift.
| false
|-
| '''hyper'''
| Is this facility a [[Hyperwave Decoder]]? Displays extra information for detected UFOs. Only valid for radar facilities.
| false
|-
| '''mind'''
| Is this facility a [[Mind Shield]]? Reduces the chance of UFOs finding your base. Does not stack.
| false
|-
| '''grav'''
| Is this facility a [[Grav Shield]]? Doubles the power of your base defenses. Does not stack.
| false
|-
| '''size'''
| Size of the facility, in grid units. Every facility is square, so a size of 1 means 1x1, 2 means 2x2, etc. Bigger facilities are made up of multiple sprites, for example a 2x2 facility will use 4 sprites for '''spriteShape''' and 4 sprites for '''spriteFacility''' (top-left, top-right, bottom-left, bottom-right).
| 1
|-
| '''buildCost'''
| Amount of money spent to build this facility in the base.
| 0
|-
| '''buildTime'''
| Amount of days it takes for this facility to be built.
| 0
|-
| '''monthlyCost'''
| Amount of money spent monthly for the maintenance of this facility.
| 0
|-
| '''storage'''
| Amount of storage space (for items) this facility provides. See [[Base Stores]].
| 0
|-
| '''personnel'''
| Amount of personnel (soldiers, scientsts, engineers) these quarters can contain.
| 0
|-
| '''aliens'''
| Amount of live aliens this facility can contain. Only checked if the ''alienContainmentLimitEnforced'' option is enabled.
| 0
|-
| '''crafts'''
| Amount of X-COM craft this facility can contain.
| 0
|-
| '''labs'''
| Amount of lab space this facility provides for research projects.
| 0
|-
| '''workshops'''
| Amount of workshop space this facility provides for manufacture projects.
| 0
|-
| '''psiLabs'''
| Amount of soldier space this facility provides for psionic training.
| 0
|-
| '''radarRange'''
| Maximum radar detection range of this facility, in nautical miles.
| 0
|-
| '''radarChance'''
| Chance (0-100%) of this radar detecting a UFO that enters its range.
| 0
|-
| '''defense'''
| Offensive power provided by this base defense against attacking UFOs.
| 0
|-
| '''hitRatio'''
| Chance (0-100) of the base defense hitting an attacking UFO.
| 0
|-
| '''fireSound'''
| Sound ID from [[#Extra_Sounds|GEO.CAT]] played when the base defense fires.
| -1
|-
| '''hitSound'''
| Sound ID from [[#Extra_Sounds|GEO.CAT]] played when the base defense hits a target.
| -1
|-
| '''mapName'''
| [[MAPS|Map]] associated to this facility in Battlescape base defenses.
| -
|-
|}

=== Crafts ===

Defines one of the [[Craft|X-COM crafts]] that go on interception missions, listed in ''"crafts:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the craft name.
| ''required''
|-
| '''requires'''
| List of [[#Research|topics]] (string IDs) that must be researched to unlock this craft. If none are specified, this craft is unlocked from the start.
| -
|-
| '''sprite'''
| Sprite ID from [[BASEBITS.PCK]] used to draw this craft in the Basescape and from [[INTICON.PCK]] used to draw the damage indicator in dogfights.
modders: the corresponding extrasprite file id for BASEBITS.PCK is sprite+33 INTICON.PCK contains a minimized icon id=sprite the file id for the dogfight image is sprite+11
| -1
|-
| '''fuelMax'''
| Maximum amount of fuel this craft can carry. Crafts use up fuel based on their speed while travelling.
| 0
|-
| '''damageMax'''
| Maximum amount of damage this craft can take. If this amount is exceeded, the craft is destroyed.
| 0
|-
| '''speedMax'''
| Maximum speed in nautical miles. Crafts travel at max speed when flying and half speed when patrolling.
| 0
|-
| '''accel'''
| Aceeleration value shown in the UFOpaedia.
| 0
|-
| '''weapons'''
| Amount of craft weapons this craft can equip. The UI can only display a max of 2 weapons.
| 0
|-
| '''soldiers'''
| Amount of soldiers this craft can carry.
| 0
|-
| '''maxItems'''
| Amount of items this craft can carry.
| 80
|-
| '''vehicles'''
| Amount of vehicles this craft can carry.
| 0
|-
| '''costBuy'''
| Amount of money spent for purchasing this craft. If set to 0, the craft will not be available in the Purchase/Recruit screen.
| 0
|-
| '''costRent'''
| Amount of money spent monthly for renting this craft. If set to 0, the craft is not on rental and won't count towards base maintenance.
| 0
|-
| '''costSell'''
| Amount of money gained for selling this craft.
| 0
|-
| '''refuelItem'''
| Item required for refuelling this craft. If no item is specified, the craft uses human fuel.
| 0
|-
| '''repairRate'''
| Amount of damage restored every hour while [[Repairs|Repairing]] in base.
| 1
|-
| '''refuelRate'''
| Amount of fuel restored every 30 mins while [[Refueling]] in base. If specified, a '''refuelItem''' is spent each time.
| 1
|-
| '''radarRange'''
| Detection range of the craft's radar in nautical miles. Every craft radar has a 100% detection chance.
| 600
|-
| '''transferTime'''
| Number of hours it takes to purchase/transfer this craft to a base.
| 0
|-
| '''score'''
| [[Score]] lost when this craft is destroyed.
| 0
|-
| '''spacecraft'''
| Can this craft go to [[Cydonia]]?
| false
|-
| '''battlescapeTerrainData'''
| [[#Terrains|Terrain]] associated to this craft in Battlescape missions.
| -
|}

=== Craft Weapons ===

Defines one of the [[Craft Armaments|weapons]] equipped by X-COM craft for shooting down UFOs, listed in ''"craftWeapons:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the weapon name.
| ''required''
|-
| '''sprite'''
| Sprite ID from [[BASEBITS.PCK]] used to draw the weapon in the Basescape and from [[INTICON.PCK]] used to draw the weapon in dogfights.
modders: the corresponding extrasprites file id for INTICON.PCK is sprite+5 and sprite+48 for BASEBITS.PCK
| -1
|-
| '''sound'''
| Sound ID from [[#Extra_Sounds|GEO.CAT]] played when this weapon fires.
| -1
|-
| '''damage'''
| Amount of damage this weapon does to enemy UFOs.
| 0
|-
| '''range'''
| Maximum range of this weapon in dogfights (in meters).
| 0
|-
| '''accuracy'''
| Chance (0-100%) of each shot hitting the enemy UFO.
| 0
|-
| '''reloadCautious'''
| Time this weapon takes to fire between each shot in ''Cautious Mode''.
| 0
|-
| '''reloadStandard'''
| Time this weapon takes to fire between each shot in ''Standard Mode''.
| 0
|-
| '''reloadAggressive'''
| Time this weapon takes to fire between each shot in ''Aggressive Mode''.
| 0
|-
| '''ammoMax'''
| Maximum amount of ammo this weapon can carry.
| 0
|-
| '''rearmRate'''
| Amount of ammo restored every 30 mins while the craft is [[Rearming]] in base. If specified, '''clip'''s are spent depending on their '''clipSize'''. If the '''clipSize''' of the specified ammo is 0, no '''clip'''s are spent.
| 1
|-
| '''projectileType'''
| Type of the weapon projectile, used for the projectile sprite in dogfights:
* 0 - [[Stingray]]
* 1 - [[Avalanche]]
* 2 - [[Cannon]]
* 3 - [[Fusion Ball]]
* 4 - [[Laser Cannon]]
* 5 - [[Plasma Beam]]
| 2
|-
| '''projectileSpeed'''
| Speed of the weapon projectile in dogfights.
| 0
|-
| '''launcher'''
| String ID of the [[#Items|item]] required to equip this weapon.
| -
|-
| '''clip'''
| String ID of the [[#Items|item]] required to rearm this weapon.
| -
|}

=== Items ===

Defines the Geoscape and Battlescape properties of an [[Equipment (EU)|item]] that can be stored in X-COM bases, listed in ''"items:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the internal item name.
| ''required''
|-
| '''name'''
| String ID of the displayed item name, for cases where it's different from the internal name. If omitted, '''type''' is used.
| -
|-
| '''requires'''
| List of [[#Research|topics]] (string IDs) that must be researched to unlock this item. If none are specified, this item is unlocked from the start. Soldiers can only use unlocked items in the Battlescape.
| -
|-
| '''size'''
| Space occupied by this item in [[Base Stores]]. Can be a decimal value.
| 0.0
|-
| '''costBuy'''
| Amount of money spent for purchasing this item. If set to 0, this item will not be available in the Purchase/Recruit screen.
| 0
|-
| '''costSell'''
| Amount of money gained for selling this item.
| 0
|-
| '''transferTime'''
| Number of hours it takes to purchase/transfer this item to a base.
| 24
|-
| '''weight'''
| [[Item_Weight|Weight]] occupied by this item in a soldier's inventory.
| 999
|-
| '''bigSprite'''
| Sprite ID from [[BIGOBS.PCK]] used to draw this item in a soldier's inventory and UFOpaedia.
| -1
|-
| '''floorSprite'''
| Sprite ID from [[FLOOROB.PCK]] used to draw this item on the floor of a Battlescape tile.
| -1
|-
| '''handSprite'''
| Sprite ID from [[HANDOB.PCK]] used to draw this item on a soldier's hand in the Battlescape.
modders: each handobject needs 8 images (8 directions) define the extrasprites accordingly
| 120
|-
| '''bulletSprite'''
| Sprite ID from ''BulletSprites.png'' used to draw this weapon's projectile on the Battlescape:
* 0 - [[Rocket Launcher]]
* 1 - [[Pistol]]
* 2 - [[Rifle]]
* 3 - [[Auto Cannon]]
* 4 - [[Heavy Cannon]]
* 5 - [[Laser Pistol]]
* 6 - [[Laser Rifle]]
* 7 - [[Heavy Laser]]
* 8 - [[Plasma Rifle|Plasma]]
* 9 - [[Small Launcher]]
* 10 - [[Blaster Launcher]]
for modders: the bulletsprite needs to be put into the extraSprites type "Projectiles" the bulletsprite can contain up to 35 3x3 images. The corresponding file id is 35*[bulletSprite]
| -1
|-
| '''fireSound'''
| Sound ID from [[#Extra_Sounds|BATTLE.CAT]] played when this weapon fires.
| -1
|-
| '''hitSound'''
| Sound ID from [[#Extra_Sounds|BATTLE.CAT]] played when this weapon hits a target.
| -1
|-
| '''hitAnimation'''
| Sprite ID from [[SMOKE.PCK]] used to draw the weapon's "hit explosion".
'''NOTE''': Do not define this value for melee/psi weapons, they use [[HIT.PCK]] and therefore meleeAnimation instead.
| 0
|-
| '''power'''
| Average damage of the weapon, in most cases it will be +-50% this value.
| 0
|-
| '''strengthApplied'''
| Add the attacking unit's strength to this weapon's damage.
| false
|-
| '''compatibleAmmo'''
| List of string IDs of the ammo items that can be loaded on this weapon. If none are specified, the weapon doesn't need ammo.
| -
|-
| '''damageType'''
| What type of [[damage]] does this weapon do:
* 0 - None
* 1 - Armor Piercing
* 2 - Incendiary
* 3 - High Explosive
* 4 - Laser
* 5 - Plasma
* 6 - Stun
* 7 - Melee
* 8 - Acid
* 9 - Smoke
'''NOTE:''' A damage type other than 0-9 will do nothing.
| 0
|-
| '''tuAuto'''
'''accuracyAuto'''
| The percentage (0-100%) of [[Time Units]] (from the soldier's total) required to fire an Auto Shot. If 0, the weapon does not have an Auto Shot.
The base accuracy (0-100%) applied to a soldier's [[Firing Accuracy]] when firing an Auto Shot.
| 0
0
|-
| '''tuSnap'''
'''accuracySnap'''
| The percentage (0-100%) of [[Time Units]] (from the soldier's total) required to fire a Snap Shot. If 0, the weapon does not have a Snap Shot.
The base accuracy (0-100%) applied to a soldier's [[Firing Accuracy]] when firing a Snap Shot.
| 0
0
|-
| '''tuAimed'''
'''accuracyAimed'''
| The percentage (0-100%) of [[Time Units]] (from the soldier's total) required to fire an Aimed Shot. If 0, the weapon does not have an Aimed Shot.
The base accuracy (0-100%) applied to a soldier's [[Firing Accuracy]] when firing an Aimed Shot.
| 0
0
|-
|-
| '''tuMelee'''
'''accuracyMelee'''
| The percentage (0-100%) of [[Time Units]] (from the soldier's total) required to do a melee attack (Hit). If 0, the weapon does not have a melee attack.
The base accuracy (0-100%) applied to a soldier's [[Melee Accuracy]] when doing a melee attack.
| 0
0
|-
| '''clipSize'''
| The amount of ammo stored in each weapon clip. If -1 is specified, this weapon has infinite ammo.
| 0
|-
| '''battleType'''
| Defines the weapon's behavior in the Battlescape:
* 0 - None (Geoscape-only item)
* 1 - [[Weapons|Firearm]]
* 2 - Ammo
* 3 - Melee
* 4 - [[Grenade]]
* 5 - [[Proximity Grenade]]
* 6 - [[Medi-Kit (EU)|Medi-Kit]]
* 7 - [[Motion Scanner]]
* 8 - [[Mind Probe]]
* 9 - [[Psi-Amp]]
* 10 - [[Electro-flare]]
* 11 - Corpse
| 0
|-
| '''twoHanded'''
| Is this weapon two-handed? If true, incurs an accuracy penalty if used with both hands occupied. Note that the handsprite of a twoHanded item is also drawn at a slightly different position than a one handed item.
| false
|-
| '''waypoint'''
| Does this weapon use waypoints? (eg. [[Blaster Launcher]]). Can also be used to make ammo items use the waypoint system.
| false
|-
| '''fixedWeapon'''
| Is this weapon fixed? (it's part of a unit, eg. tanks and terrorist units)
| false
|-
| '''invWidth'''
| Item width in a soldier's inventory (in grid units).
| 1
|-
| '''invHeight'''
| Item height in a soldier's inventory (in grid units).
| 1
|-
| '''painKiller'''
| Amount of painkillers contained in a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''heal'''
| Amount of heal's contained in a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''stimulant'''
| Amount of stimulants contained in a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''woundRecovery'''
| Amount of [[Fatal Wounds]] treated by each heal of a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''healthRecovery'''
| Amount of [[Health]] recovered by each heal of a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''stunRecovery'''
| Amount of [[Stun]] removed by each stimulant of a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''energyRecovery'''
| Amount of [[Energy]] recovered by each stimulant of a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''tuUse'''
| Amount of [[Time Units]] required to use this item (for non-offensive items). It's a flat rate if '''flatRate''' is true, otherwise it's a percentage (0-100%).
| 0
|-
| '''recoveryPoints'''
| [[Score]] gained for recovering this alien artifact.
| 0
|-
| '''armor'''
| How much damage is needed to destroy this item on the ground.
| 20
|-
| '''recover'''
| Is this item recoverable? (gets transported to the X-COM base on mission success)
| true
|-
| '''turretType'''
| Sprite ID from [[TANKS.PCK]] of the turret to assign to this tank:
* 0 - [[Tank/Cannon]]
* 1 - [[Tank/Rocket Launcher]]
* 2 - [[Tank/Laser Cannon]]
* 3 - [[Hovertank/Plasma]]
* 4 - [[Hovertank/Launcher]]
| -1
|-
| '''liveAlien'''
| Does this item represent a live alien? (counts towards [[Alien Containment]])
| false
|-
| '''blastRadius'''
| Size of the projectile explosions. 0 for no explosion. -1 to automatically calculate based on weapon power and damage type (actual '''blastRadius''' currently is capped due [[Explosions#Playing_With_Fire|Explosion calculations]]).
| -1
|-
| '''flatRate'''
| If true, then TU costs for this weapon are a flat rate (instead of a percentage of unit TUs).
| false
|-
| '''arcingShot'''
| Does this weapon fire in an arc?
| false
|-
| '''attraction'''
| Represents how likely an alien is to pick up this item. Values below 5 will be ignored (by design).
| 0
|-
| '''maxRange'''
| Maximum range at which this weapon can operate.
| 200
|-
| '''aimRange'''
| Maximum effective range with this weapon before which range-based dropoff occurs.
| 200
|-
| '''snapRange'''
| Maximum effective range with snap shot before which range-based dropoff occurs. (ufoextender accuracy only)
| 15
|-
| '''autoRange'''
| Maximum effective range with auto shot before which range-based dropoff occurs. (ufoextender accuracy only)
| 7
|-
| '''minRange'''
| Range-based dropoff will work in reverse for ranges below this.
| 0
|-
| '''dropoff'''
| The value by which the accuracy lowers for each tile after (or before) the thresholds above.
| 2
|-
| '''bulletSpeed'''
| How much faster (or slower, if you use a negative number) is a projectile fired from this weapon compared to the average.
| 0
|-
| '''autoShots'''
| How many auto shots does this weapon fire.
| 3
|-
| '''shotgunPellets'''
| Number of projectiles fired per unit of ammunition. (note: due to engine limitations it is currently impossible to draw multiple projectiles in flight.)
| 0
|-
| '''zombieUnit'''
| String ID of the unit used for zombification (eg. [[Chrysallid]]s turn units into [[Zombie]]s).
| none
|-
| '''meleeSound'''
| Sound ID from [[#Extra_Sounds|BATTLE.CAT]] played when this weapon attacks a target with melee.
| 39
|-
| '''meleeHitSound'''
| Sound ID from [[#Extra_Sounds|BATTLE.CAT]] played when this weapon HITS a target with melee.
| -1
|-
| '''meleeAnimation'''
| Sprite ID from HIT.PCK played when this weapon attacks a target with melee.
| 0
|-
| '''meleePower'''
| Damage this weapon will do when using melee. This only applies to Firearms, and is only available as stun damage. For normal melee weapons, use regular power and damage types.
| 0
|-
| '''LOSRequired'''
| Does this item require line of sight? (only applies to mind probes and psi-amps)
| false
|-
| '''skillApplied'''
| Is melee skill applied to the accuracy of an attack made with this object?
| true
|-
|}

=== UFOs ===

Defines one of the [[UFOs]] that invade Earth, listed in ''"ufos:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the UFO name.
| ''required''
|-
| '''size'''
| String ID of the UFO size.
| STR_VERY_SMALL
|-
| '''sprite'''
| Sprite ID from [[INTERWIN.DAT]] used to draw this UFO in the dogfight view and UFOpaedia.
don't try to add more images if you don't want to punch yourself in the face - use modsprite
| -1
|-
| '''modSprite'''
| Filename used to draw this UFO in the dogfight view and UFOpaedia.
| -
|-
| '''damageMax'''
| Maximum amount of damage this UFO can take. If the UFO takes 50% damage, it crash lands. If it takes 100% damage, it is destroyed.
| 0
|-
| '''speedMax'''
| Maximum speed in nautical miles.
| 0
|-
| '''accel'''
| Aceeleration value shown in the UFOpaedia.
| 0
|-
| '''power'''
| Damage power of this UFO's weapon in dogfights.
| 0
|-
| '''range'''
| Maximum range of this UFO's weapon in dogfights (in meters).
| 0
|-
| '''score'''
| [[Score]] gained when this UFO is destroyed, or half this score if it crash lands.
| 0
|-
| '''reload'''
| Time the UFO's weapon takes to fire between each shot.
| 0
|-
| '''breakOffTime'''
| Minimum amount of time for the UFO to be able to break off of a dogfight.
| 0
|-
| '''battlescapeTerrainData'''
| [[#Terrains|Terrain]] associated to this UFO in Battlescape missions.
| ''required''
|-
|}

=== Inventory Sections ===

Defines one of the sections of the [[Inventory TU Table|Battlescape inventory]] (eg. Backpack), listed in ''"invs:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the inventory name.
| ''required''
|-
| '''x'''
'''y'''
| Pixel coordinates of this section on the inventory screen.
| 0
0
|-
| '''type'''
| Type of this section:
* 0 = Slot section, can contain as many items as will fit on the slots.
* 1 = Hand section, can only contain one item regardless of size.
* 2 = Ground section, can contain infinite items.
| 0
|-
| '''slots'''
| List of the grid slots (''[x, y]'') that this section is composed of. For example, to make a 2x2 section, you would have ''[0, 0] [0, 1] [1, 0] [1, 1]''.
| -
|-
| '''costs'''
| List of [[Time Units]] costs to move an item from this section to another one (eg. ''STR_BACKPACK: 16'' means it will cost 16 TUs to move an item from this section to the Backpack).
| -
|-
|}

=== Terrains ===

Defines one of the [[TERRAIN|terrains]] used to generate a Battlescape map, listed in "terrains:".

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''name'''
| String ID of the terrain name.
| ''required''
|-
| '''largeBlockLimit'''
| Maximum amount of large blocks that can be used on map generation.
| 0
|-
| '''textures'''
| List of [[TEXTURE.DAT|Geoscape textures]] that correspond to this terrain.
| -
|-
| '''hemisphere'''
| Geoscape hemisphere associated with this terrain:
* -1 - Northern hemisphere.
* 0 - Both hemispheres.
* 1 - Southern hemisphere.
| 0
|-
| '''mapDataSets'''
| List of filenames (each with matching [[MCD]]/[[Image Formats#PCK|PCK/TAB]] files) that contain the tiles of this terrain.
| -
|-
| '''mapBlocks'''
| List of map blocks (see below) that are used for generating a map.
| -
|-
| '''roadTypeOdds'''
| Odds as a % of generating each type of road (E-W Road, N-S Road, Crossing) odds for crossing are: 100 - EW - NS.
| [0 0]
|-|-
| '''civilianTypes'''
| List of units to use as civilians for this mission.
| [MALE_CIVILIAN, FEMALE_CIVILIAN]
|-
|}

==== Map Blocks ====

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''name'''
| Filename of the [[MAPS|map]].
| ''required''
|-
| '''width'''
| Width of this map block in Battlescape grid units.
| 0
|-
| '''length'''
| Length of this map block in Battlescape grid units.
| 0
|-
| '''height'''
| Height of this map block in Battlescape grid units.
| 1
|-
| '''type'''
| Type of this map block:
(obsolete with nightly > 2014-11-19)
* -1 - Undefined
* 0 - Default
* 1 - Landing Zone (for placing X-COM / alien craft)
* 2 - E-W Road (for city maps)
* 3 - N-S Road (for city maps)
* 4 - Road Crossing (for city maps)
* 5 - Dirt (for filling empty base blocks)
* 6 - X-COM spawn point (for [[Alien Base]] / [[Cydonia]] missions)
* 7 - [[Alien Base]] Target
* 8 - [[Cydonia]] Target
| -1
|-
| '''subType'''
| Sub-type of this map block (see '''type'''). (obsolete with nightly > 2014-11-19)
| -1
|-
| '''frequency'''
| Frequency of this block in a map. (obsolete with nightly > 2014-11-19)
| 1
|-
| '''maxCount'''
| Maximum amount of times this block can be used in a map. If -1 there is no limit. (obsolete with nightly > 2014-11-19)
| -1
|-
| '''items'''
| An array of items to add to this mapblock, an the positions to place them at.
| -1
|}

*'''frequency''' defines the odds of the map appearing on the map
** The value assigned (default: 1) is used in ''x/n'', which defines the probability of being chosen.
** ''x'' is the integer defined for the map block's frequency and ''n'' is the combined total of probabilities for all the map types combined.
** This property can only be used in type 0 map blocks.
*'''maxCount''' is the maximum number of times it can be used.
** The value assigned is also used in ''x/n'' to determine the probability of being chosen.
** Each use reduces ''x'' by -1, with the caveat that being used as a Landing Zone type will not reduce the x value since it could result in no available Landing Zones.
** This property can only be used in type 0 map blocks.
* '''hemisphere''' only applies to UFO missions, not Terror ones.
*'''width/length''' defines the size of the map
** be aware that the mapview "width"-label is the openxcom ruleset length parameter
** be aware that the mapview "length"-label is the openxcom ruleset width parameter

==== Guidelines/Tips ====
* All maps with an XCOM/Alien craft require at least one type 1 map block. This map block can only contain ground tiles (no walls or objects), otherwise the game will crash or the walls/objects will be removed.
* All Terror terrains (listed under STR_TERROR_MISSION) require at least 1 map block of '''Types''' 2, 3 and 4 (for a total of 3 maps, which are required to place roads) and the corresponding '''roadTypeOdds''' added to the ruleset.
* If there isn't any map blocks designed as roads since you want to keep your terrain 'random', this can be circumvented by designating all 10x10 map blocks, excluding the one(s) used for the XCOM craft, as either '''Type''' 2, 3 and 4 and by defining their '''subType''' to 0. The game will then randomly choose between the map blocks for each type used in the roads, making them map more random.

=== Armor ===

Defines a Battlescape unit's [[armor]] as well as visual representation (so every unit has an armor), listed in ''"armors:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the armor name.
| ''required''
|-
| '''spriteSheet'''
| Sprite sheet from [[UNITS]] used to draw a unit wearing this armor.
| -
|-
| '''spriteInv'''
| Sprite used for the [[Inventory Backgrounds]] of a unit wearing this armor.
| -
|-
| '''corpseBattle'''
| List of string IDs of the corpse [[#Items|items]] generated when a unit wearing this armor is killed (one per unit tile) on the Battlescape.
| -
|-
| '''corpseGeo'''
| String ID of the corpse [[#Items|item]] associated with this unit on the Geoscape.
| -
|-
| '''storeItem'''
| String ID of the [[#Items|item]] that represents this armor in [[Base Stores]] for equipping.
| -
|-
| '''weight'''
| Physical weight of the armor when worn
| 6
|-
| '''stats'''
| like soldier stats (see below) but these are treated as stat bonuses for wearing the specific armor.
| -
|-
| '''frontArmor'''
| Protection provided on the front of the unit.
| 0
|-
| '''sideArmor'''
| Protection provided on the sides of the unit.
| 0
|-
| '''rearArmor'''
| Protection provided on the rear of the unit.
| 0
|-
| '''underArmor'''
| Protection provided under the unit (eg. from explosions).
| 0
|-
| '''drawingRoutine'''
| Drawing routine used to put together the body parts in the unit's '''spriteSheet''':
* 0 = [[Soldier]], [[Sectoid]]
* 1 = [[Floater]]
* 2 = [[HWP]]
* 3 = [[Cyberdisk]]
* 4 = [[Civilian]], [[Ethereal]]
* 5 = [[Sectopod]], [[Reaper]]
* 6 = [[Snakeman]]
* 7 = [[Chryssalid]]
* 8 = [[Silacoid]]
* 9 = [[Celatid]]
* 10 = [[Muton]]
* 11 = [[Submersible Weapons Systems]]
* 12 = [[Hallucinoid]]
* 13 = [[Aquanauts]]
* 14 = [[Calcinite]], [[Deep One]], [[Gillman]], [[Lobster Man]], [[Tasoth]]
* 15 = [[Aquatoid]]
* 16 = [[Bio-Drone]]
| 0
|-
| '''movementType'''
| Type of movement provided by this armor:
* 0 = Walking
* 1 = Flying
* 2 = Sliding (no walking animation)
it also defines the body of an tank (32-images) in your spriteSheet or the change in sprites while flying using a flying armour see: [[TANKS.PCK]], [[XCOM_2.PCK]]
| 0
|-
| '''damageModifier'''
| List of decimal damage modifiers (1.0 = 100%) this armor applies to each damage type (see [[#Items|Items section]]) received. Modifiers must be specified for all damage types, in this order:
* None
* Armor Piercing
* Incendiary
* High Explosive
* Laser
* Plasma
* Stun
* Melee
* Acid
* Smoke
|
- 1.0 
- 1.0 
- 1.0 
- 1.0 
- 1.0 
- 1.0 
- 1.0 
- 1.0 
- 1.0 
- 1.0
|-
| '''size'''
| Size of the unit wearing this armor, in Battlescape grid units. Every unit is square, so a size of 2 means 2x2.
| 1
|-
| '''loftempsSet'''
| List of [[LOFTEMPS]] IDs (one per unit tile, so a 1x1 unit has 1, a 2x2 unit has 4, etc.) used to represent a unit wearing this armor in 3D space.
| -
|-
| '''loftemps'''
| loftemps is a deprecated option that only works for 1x1 sized units.
| -
|-
| '''forcedTorso'''
| soldier sprites have female and male torsos. some armours reuse these sprites for flying/non flying torso without difference between genders. This can be controlled by the parameter: 0 = use genderrelated torso, 1 = use male torso, 2 = use female torso
| 0

|}

=== Player Units (Soldiers) ===

Defines a [[soldier]] recruited by X-COM, listed in ''"soldiers:"''. Currently only one soldier unit type (''XCOM'') is supported.

Unit stats are represented as follows:
* [[Time Units|tu]]
* [[Energy|stamina]]
* [[Health|health]]
* [[Bravery|bravery]] (always a multiple of 10)
* [[Reactions|reactions]]
* [[Firing Accuracy|firing]]
* [[Throwing Accuracy|throwing]]
* [[Strength|strength]]
* [[Psi Strength|psiStrength]]
* [[Psi Skill|psiSkill]]
* [[Melee Accuracy|melee]] (not visible)

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the soldier name.
| ''required''
|-
| '''minStats'''
| Minimum values used to generate the soldier's [[Starting Stats]]. In this case, ''psiSkill'' is treated as the initial stat (not generated).
| -
|-
| '''maxStats'''
| Maximum values used to generate the soldier's [[Starting Stats]]. In this case, ''psiSkill'' is treated as the minimum value for the first month of psi training (actual value is 100%-150%).
| -
|-
| '''statCaps'''
| Maximum stats this soldier can gain through [[Experience]]. '''NOTE:''' A stat will still go over the limit once, and then will no longer increase (see [[Experience#Regarding Caps|Regarding Caps]]).
| -
|-
| '''armor'''
| String ID of the [[#Armor|armor]] this soldier uses by default.
| -
|-
| '''standHeight'''
| Height of this soldier when standing.
| 0
|-
| '''kneelHeight'''
| Height of this soldier when kneeling.
| 0
|-
| '''floatHeight'''
| Distance between the bottom of this unit and the ground.
| 0
|-
| '''femaleFrequency'''
| The probability that a female soldier is hired.
| 50
|}

=== AI Units (Aliens/Civilians) ===

Defines an [[Alien Life Forms|alien]] (enemy) or [[civilian]] (neutral) unit, listed in ''"units:"''. Every different alien rank is a different unit, since they have completely different stats. Unit stats are represented as follows:
* [[Time Units|tu]]
* [[Energy|stamina]]
* [[Health|health]]
* [[Bravery|bravery]] (always a multiple of 10)
* [[Reactions|reactions]]
* [[Firing Accuracy|firing]]
* [[Throwing Accuracy|throwing]]
* [[Strength|strength]]
* [[Psi Strength|psiStrength]]
* [[Psi Skill|psiSkill]]
* [[Melee Accuracy|melee]] (not visible)

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the unit name.
| ''required''
|-
| '''race'''
| String ID of the unit race (for alien units).
| -
|-
| '''rank'''
| String ID of the unit rank (for alien units).
| -
|-
| '''stats'''
| Battlescape stats of this unit.
| -
|-
| '''armor'''
| String ID of the [[#Armor|armor]] this unit uses by default.
| -
|-
| '''standHeight'''
| Height of this unit when standing.
| 0
|-
| '''floatHeight'''
| Distance between the bottom of this unit and the ground.
| 0
|-
| '''value'''
| [[Score]] this unit is worth.
| 0
|-
| '''deathSound'''
| Sound ID from [[#Extra_Sounds|BATTLE.CAT]] played when this unit dies.
| -1
|-
| '''aggroSound'''
| Sound ID from [[#Extra_Sounds|BATTLE.CAT]] played when this unit aggros.
| -1
|-
| '''moveSound'''
| Sound ID from [[#Extra_Sounds|BATTLE.CAT]] played when this unit moves.
| -1
|-
| '''intelligence'''
| Intelligence of this unit's AI. The higher the value, the longer this unit remembers player troops between turns.
| 0
|-
| '''aggression'''
| Aggression of this unit's AI. The higher the value, the more ruthless the unit, the more likely to make a frontal assault. Less aggressive units tend to set up ambushes.
Vanilla values are:
* 0 = mostly passive
* 1 = balanced
* 2 = mostly aggresive
| 0
|-
| '''energyRecovery'''
| Energy recovered by the unit each turn (needs verification)
| 40 (?)
|-
| '''specab'''
| Special ability of this unit:
* 0 = None
* 1 = [[Cyberdisc|Explodes on Death]]
* 2 = [[Bio-Drone|Burns Floor]]
* 3 = Burns Floor and explodes on Death
| 0
|-
| '''spawnUnit'''
| String ID of the unit used to respawn on death (eg. [[Zombie]]s respawn as [[Chrysallid]]s).
| -
|-
| '''livingWeapon'''
| Is this unit a living weapon? (only attacks with a '''fixedWeapon''')
| false
|-
| '''female'''
| Is this unit a female? (used for TFTD civilian types)
| false
|-
|}

=== Alien Races ===

Defines a [[Alien Life Forms|race]] used in [[Alien Missions]], listed in ''"alienRaces:"''. Heavily tied with deployment data.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''id'''
| String ID of the alien race name.
| ''required''
|-
| '''members'''
| Alien crew associated with this alien race (eg. race units + terrorist units), defined by a list of unit string IDs. Order here will define rank in terms of deployment. generally speaking the order is:
* 0 - Commander
* 1 - Leader
* 2 - Engineer
* 3 - Medic
* 4 - Navigator
* 5 - Soldier
* 6 - Terrorist 1
* 7 - Terrorist 2
but of course, not all races have all ranks, so the "fill in" rank would be listed multiple times (see ethereals).
| -
|-
| '''retaliation'''
| retaliation enables/disables the race for retaliation missions.
| ''True''
|-
|}

=== Alien Deployments ===

Defines a Battlescape deployment data used in [[Alien Missions]] (such as alien and map configurations), listed in ''"alienDeployments:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the deployment name.
| ''required''
|-
| '''width'''
| Width of the Battlescape map in grid units.
| 0
|-
| '''length'''
| Length of the Battlescape map in grid units.
| 0
|-
| '''height'''
| Vertical height of the Battlescape map in grid units.
| 0
|-
| '''terrains'''
| list of string IDs of the [[#Terrains|terrain]] to choose from to generate this map. This is not used for UFO sites where the terrain comes from the Geoscape.
| -
|-
| '''shade'''
| Shade of the map (0-15, where 0 is full daytime and 15 is full nighttime). This is not used for UFO sites where the shade comes from the Geoscape.
| 0
|-
| '''nextStage'''
| String ID of the next deployment stage to use after this one, for multi-stage missions.
| -
|-
| '''race'''
| Sets the race to use in the next stage.
| ""
|-
| '''data'''
| List of deployment data for each alien rank on this mission (see below).
| -
|}

Notes:
* '''terrains''' can also be used with UFOs, with the game using instead the listed terrain rather than the location of the UFO on Geoscape.
==== Deployment Data ====

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''alienRank'''
| [[Alien Rank|Rank]] associated with this deployment data, as defined by the order of the race in question (see above)
| ''required''
|-
| '''lowQty'''
| Maximum quantity of aliens to spawn (beginner).
| 0
|-
| '''highQty'''
| Maximum quantity of aliens to spawn (superhuman).
| 0
|-
| '''dQty'''
| Minimum Desired Quantity of aliens to spawn.
| 0
|-
| '''extraQty'''
| spawns a random number of additional aliens.
| 0
|-
| '''percentageOutsideUfo'''
| Percentage (0-100%) of aliens to spawn outside in UFO sites.
| 0
|-
| '''itemSets'''
| Three lists (one for each alien technology level) of [[#Items|items]] (string IDs) for the aliens to equip.
| ''required''
|-
|}

=== Research ===

Defines a [[Research|research topic]] that X-COM scientists can investigate, listed in ''"research:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''name'''
| String ID of the research project's name (or item, if a '''lookup''' is defined).
| ''required''
|-
| '''lookup'''
| String ID of the research project's display name and UFOPaedia article reference.
| -
|-
| '''cost'''
| Number of man hours (on average) required to complete this project.
| 0
|-
| '''points'''
| [[Score]] earned for completing this project.
| 0
|-
| '''needItem'''
| Does this project require an [[#Items|item]] of the same name?
| false
|-
| '''dependencies'''
| List of research projects that can unlock access to this one. If the full list is researched, or if one of the projects on the list "unlocks" this one, it becomes available.
| -
|-
| '''unlocks'''
| List of research projects unlocked, regardless of other dependencies, but not requirements, by completing this project (for example, any live alien unlocks "alien origins").
| -
|-
| '''requires'''
| List of research projects unilaterally required before this project can be unlocked (for example, "the martian solution" will not even be considered for unlocking until AFTER "alien origins" is completed).
| -
|-
| '''getOneFree'''
| List of "bonus" research projects that may be granted when completing this project (for example, alien medics will give you information on other alien races). Only applies to living aliens.
| -
|-
|}

=== Manufacture ===

Defines a [[Manufacture|manufacture project]] that X-COM engineers can produce, listed in ''"manufacture:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''name'''
| String ID of the manufacturing project's name (and the item it produces).
| ''required''
|-
| '''category'''
| String ID of the manufacturing project's category.
| -
|-
| '''requires'''
| List of [[#Research|topics]] (string IDs) that must be researched to unlock this project. If none are specified, this project is unlocked from the start.
| -
|-
| '''space'''
| Amount of [[Workshop]] space required to begin this project.
| 0
|-
| '''time'''
| Number of man hours (on average) required per item.
| 0
|-
| '''cost'''
| Monetary deduction per item manufactured.
| 0
|-
| '''requiredItems'''
| List of [[#Items|items]] required and consumed per item manufactured.
| -
|-
| '''producedItems'''
| List of [[#Items|items]] produced per each item consumed. If not specified, defaults to 1 item with the same string ID as the manufacture.
| 1
|-
|}

=== UFOpaedia Article ===

Defines an article in the in-game [[UFOpaedia]], listed in ''"ufopaedia:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''id'''
| String ID of the article name. This must match the ID of the object associated with this article, if applicable.
| ''required''
|-
| '''title'''
| String ID of the article title. If omitted, the '''id''' is used.
| -
|-
| '''type_id'''
| Type of this article:
* 0 = Unknown
* 1 = [[Craft]]
* 2 = [[Craft Armaments]]
* 3 = [[HWP]]
* 4 = [[Equipment (EU)|Equipment]]
* 5 = [[Armour]]
* 6 = [[Base Facilities]]
* 7 = Text & Image (eg. [[Alien Life Forms]], [[UFO Components]])
* 8 = Text (eg. [[Alien Research]])
* 9 = [[UFO]]
| 0
|-
| '''section'''
| String ID of the UFOpaedia section this article belongs in.
| -
|-
| '''requires'''
| List of [[#Research|topics]] (string IDs) that must be researched to unlock this article. If none are specified, this article is unlocked from the start.
| -
|-
| '''image_id'''
| Filename of the [[UP001.SPK-UP042.SPK|background image]] displayed on this article, if applicable.
| -
|-
| '''text'''
| String ID of the description displayed on this article.
| -
|-
| '''text_width'''
| Maximum width of the text displayed, only applicable to ''Text & Image'' articles.
| 0
|-
| '''rect_stats'''
| Rectangle ('''x''', '''y''', '''width''', '''height''') of the stats text on the screen, only applicable to ''Craft'' articles.
| 0
|-
| '''rect_text'''
| Rectangle ('''x''', '''y''', '''width''', '''height''') of the description text on the screen, only applicable to ''Craft'' articles.
| 0
|-
| '''weapon'''
| String ID of the weapon, only applicable to ''HWP'' articles.
| -
|}

=== UFO Trajectories ===

Defines a trajectory carried out by an UFO during an [[#Alien Missions|alien mission]], listed in ''"ufoTrajectories:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''id'''
| String ID of the trajectory name.
| ''required''
|-
| '''groundTimer'''
| Amount of seconds for the UFO to spend on Ground waypoints.
| 0
|-
| '''waypoints'''
| List of waypoints for the UFO to traverse, defined as ''[zone, altitude, speed]''. 
'''zone''': Globe zone where the waypoint is located. 
'''altitude''': UFO altitude after reaching this waypoint:
* 0 - Ground
* 1 - Very Low
* 2 - Low
* 3 - High
* 4 - Very High
'''speed''': UFO speed after reaching this waypoint, as a percentage (0-100%) of its maximum speed.
| -
|}

=== Alien Missions ===

Defines an [[Alien Missions|alien mission]] carried out by UFOs on the Geoscape, listed in ''"alienMissions:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the mission type.
| ''required''
|-
| '''points'''
| [[Score]] allocated to aliens for successfully completing this mission.
| 0
|-
| '''raceWeights'''
| List of alien races likely to carry out this mission, and the % chance of them being allocated to this mission, listed by "number of months after game beginning".
| ''required''
|-
| '''waves'''
| List of UFO waves to spawn as this mission progresses, as described below.
| ''required''
|}

==== Waves ====

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''ufo'''
| String ID of the [[#UFOs|UFO]] to spawn.
| ''required''
|-
| '''count'''
| Number of UFOs to spawn.
| 0
|-
| '''trajectory'''
| String ID of the [[#UFO Trajectories|trajectory]] for this UFO to use when entering Earth's atmosphere.
| ''required''
|-
| '''timer'''
| How long after the previous wave should this wave arrive? (in seconds)
| 0
|-
|}

=== Alien Item Levels ===

This is a list of item level probabilities, with a number between 0 and 2 representing an item level from plasma pistols to heavy plasmas, as defined in the deployments, expressing a 10% probability for that item level being used.

0 = first set (plasma pistol/clip)
1 = second set (plasma rifle/clip)
2 = third set (heavy plasma/clip)

For example:
[ 2, 0, 0, 0, 0, 0, 0, 1, 1, 1 ]
would represent a 60% chance for pistols, 30% rifles, and 10% heavy weapons. 
Note that the order does not matter, but the length DOES. each line MUST have 10 digits.

The above can be confusing. There are 10 fields; each number represents 10%. 
There are six instances of '0'. 6x10% = 60% chance of plasma pistol 
There are three instances of '1'. 3x10% = 30% chance of plasma rifle 
There is only one instance of '2'. 1x10% = 10% chance of heavy plasma 

Each line represents a month after the beginning of the game, and there is no limit to the number defined. 
OpenXCom will use the most recently available item level in the event the game goes on forever.

=== Extra Sprites ===

Adds or replaces sprites in an existing [[Image Formats|X-COM image file]], listed in ''"extraSprites:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| Filename of the original/new image to modify.
| ''required''
|-
| '''width'''
'''height'''
| Size of the sprite(s) in pixels.
| 0
0
|-
| '''singleImage'''
| Is the image file just a single sprite (true) or a spritesheet (false)?
| false
|-
| '''subX'''
'''subY'''
| Size of the subdivision in pixels. If a subdivision is specified, then the image file is divided into chunks to form the sprites (eg. spritesheets).
| 0
0
|-
| '''files'''
| List of the new sprites to add/replace, listed as ''spriteID: filename''.
| -
|}

Example:
- type: GIANTBUNNY.PCK
width: 32
height: 40
files:
0: Resources/Bunny/Bunny00.png
1: Resources/Bunny/Bunny01.bmp
2: Resources/Bunny/Bunny02.gif

=== Extra Sounds ===

Adds or replaces sounds in an existing [[SOUND|X-COM sound file]], listed in ''"extraSounds:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| ID of the original sound file to modify:
* BATTLE.CAT - Battlescape sounds, corresponds to ''SOUND1.CAT'' or ''SAMPLE2.CAT'' (55 sounds).
* INTRO.CAT - Intro sounds, corresponds to ''INTRO.CAT'' or ''SAMPLE3.CAT'', probably best not to mess with these.
* GEO.CAT - Geoscape sounds, corresponds to ''SOUND2.CAT'' or ''SAMPLE.CAT'' (14 sounds).
| ''required''
|-
| '''files'''
| List of the new sounds to add/replace, listed as ''soundID: filename''.
| -
|}

Example:
- type: BATTLE.CAT
files:
55: Resources/Sounds/sample.wav

=== Extra Strings ===

Adds or replaces text strings in an existing [[Translations (OpenXcom)|OpenXcom language file]], listed in ''"extraStrings:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| Filename of the original language file to modify, sans extension.
| ''required''
|-
| '''strings'''
| List of the new strings to add/replace, listed as ''stringID: text''.
| -
|}

Example:
- type: en-US
strings:
STR_SNIPER_RIFLE: Sniper Rifle
STR_SNIPER_RIFLE_CLIP: Sniper Rifle Clip
- type: en-GB
strings:
STR_SNIPER_RIFLE: Sniper Rifle
STR_SNIPER_RIFLE_CLIP: Sniper Rifle Clip
- type: de
strings:
STR_SNIPER_RIFLE: Scharfschützengewehr
STR_SNIPER_RIFLE_CLIP: Scharfschützengewehrmunition
- type: ru
strings:
STR_SNIPER_RIFLE: Снайперская винтовка
STR_SNIPER_RIFLE_CLIP: Магазин к снайп. винтовке

=== Interfaces ===

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| ''?''
| -
|-
| '''elements'''
| ''?''
| -
|-
| '''id'''
| ''?''
| -
|-
| '''color'''
| ''?''
| -
|}

=== StatStrings ===

[[Statstrings]] are used for automatically renaming soldiers. They are case sensitive and they are processed in the order in which they are specified.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''string'''
| String to add to name.
| ''required''
|-
| '''psiStrength''' 
'''psiSkill''' 
'''bravery''' 
'''strength''' 
'''firing''' 
'''reactions''' 
'''stamina''' 
'''tu''' 
'''health''' 
'''throwing'''
| One or more stat ranges are ANDed together for success. Each range has a minVal and maxVal. Use YAML standard tilde (~) to indicate null. ((~) = 0 as minvalue; (~) =255 as maxvalue)
| -
|}

Example:
statStrings:
- string: "x"
psiStrength: [~, 30]
- string: "P"
psiStrength: [80, ~]
- string: "p"
psiStrength: [60, 79]
- string: "K"
psiSkill: [60, ~]
- string: "k"
psiSkill: [30, 59]
- string: "b"
bravery: [60, ~]
- string: "c"
bravery: [~, 10]
- string: "w"
strength: [~, 25]
- string: "Snpr"
firing: [60, ~]
reactions: [60, ~]
- string: "M"
firing: [70, ~]
- string: "m"
firing: [60, 69]
- string: "Sct"
reactions: [50, ~]
tu: [60, ~]
- string: "R"
reactions: [60, ~]
- string: "r"
reactions: [50, 59]

==References==
<references />

[[Category:OpenXcom]]

Ruleset Reference (OpenXcom)

2014-12-04T20:57:20Z

Falko: /* Alien Deployments */

A reference of all the customizable values of everything in a [[Rulesets (OpenXcom)|ruleset]]. Some guidelines:
* If a value is omitted from the ruleset, the default is used. You cannot omit ''required'' values.
* Text strings (eg. names) are represented by string IDs from the [[Translations (OpenXcom)|language files]]
* Numerical IDs (used for sprites, sounds, etc.) start at 0, not 1.
* Boolean (yes/no) values are represented by true/false.
* World coordinates are represented in degrees (see [[WORLD.DAT]]).
* Money amounts (prices, costs, etc.) are represented in dollars.
* All paths are '''case sensitive'''! If your ruleset uses external files, make sure that they named properly as described in ruleset.

Items are ordered as they come in the ruleset. To override this, you can specify a ''listOrder''. You can find the default listOrders in [[Ruleset List Order (OpenXcom)|Ruleset List Order]].

=== Globe ===

Defines the drawing of landmasses and borders on the globe.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''data'''
| Path name of file which contains polygon and texture information. (For example WORLD.DAT).
| -
|-
| '''polygons'''
| List of polygons drawn on the globe surface. A triangle consist of seven values: the first number defines the texture, followed by three pairs of (x,y) globe coordinates. Only polygons with 3 or 4 vertices are reliable shown on the globe = 7 or 9 values per entry.
| -
|-
| '''polylines'''
| List of border lines. Each list entry consist of a list of (x,y) globe coordinates.
| -
|}

=== Countries ===

Defines one of the [[Country Funding (EU)|funding nations]], listed in ''"countries:"''. They're used for activity graphs and player scoring.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the country name.
| ''required''
|-
| '''fundingBase'''
| Country's base funding, in thousands. The starting funding can be anywhere between 1x and 2x the base funding.
| 0
|-
| '''fundingCap'''
| Country's funding cap, in thousands. Once a country reaches this maximum, it will no longer increase its funding.
| 0
|-
| '''labelLon'''
'''labelLat'''
| Longitude and latitude coordinates of the country's label on the globe. This label is only shown when the globe is zoomed in and "detail" is turned on.
| 0.0
0.0
|-
| '''areas'''
| List of "rectangles" on the globe defined as [''lon1'' ''lat1'' ''lon2'' ''lat2'']. Any activity within these areas counts towards the country's graph activity and affects their opinion of the player.
| -
|}

=== Regions ===

Defines one of the [[Geoscape (EU)#World Regions/Countries|world regions]], listed in ''"regions:"''. They're used for base placement, activity graphs and mission spawning.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the region name.
| ''required''
|-
| '''cost'''
| Amount of money spent building an X-COM base in this region (first base is free).
| 0
|-
| '''areas'''
| List of "rectangles" on the globe defined as ''[lon1, lat1, lon2, lat2]''. Any activity within these areas counts towards the region's graph activity.
| -
|-
| '''cities'''
| List of cities belonging to this region. They will be displayed on the globe and used for terror site missions. Each city is defined by their '''lon''' and '''lat''' coordinates and a '''name''' string ID.
| -
|-
| '''regionWeight'''
| Weight of this region when selecting regions for alien missions.
| 0
|-
| '''missionWeights'''
| Weighted list of the different mission types for this region (eg. ''STR_ALIEN_RESEARCH: 14'').
| -
|-
| '''missionZones'''
| List of "rectangles" (''[lon1, lat1, lon2, lat2]'') defining the mission zones for this region. Mission zones are waypoints for UFO trajectories.
| -
|-
| '''missionRegion'''
| Spawn mission in this region instead (used for regions without land).
| -
|}

=== Base Facilities ===

Defines one of the [[Base Facilities (EU)|facilities]] that can be built in an X-COM base, listed in ''"facilities:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the facility name.
| ''required''
|-
| '''requires'''
| List of [[#Research|topics]] (string IDs) that must be researched to unlock this facility. If none are specified, this facility is unlocked from the start.
| -
|-
| '''spriteShape'''
| Sprite ID from [[BASEBITS.PCK]] used to draw the facility's outer shape in the Basescape and UFOpaedia.
| -1
|-
| '''spriteFacility'''
| Sprite ID from [[BASEBITS.PCK]] used to draw the facility's contents in the Basescape and UFOpaedia. Drawn on top of '''spriteShape'''.
| -1
|-
| '''lift'''
| Is this facility an [[Access Lift]]? All base facilities must be connected to the lift.
| false
|-
| '''hyper'''
| Is this facility a [[Hyperwave Decoder]]? Displays extra information for detected UFOs. Only valid for radar facilities.
| false
|-
| '''mind'''
| Is this facility a [[Mind Shield]]? Reduces the chance of UFOs finding your base. Does not stack.
| false
|-
| '''grav'''
| Is this facility a [[Grav Shield]]? Doubles the power of your base defenses. Does not stack.
| false
|-
| '''size'''
| Size of the facility, in grid units. Every facility is square, so a size of 1 means 1x1, 2 means 2x2, etc. Bigger facilities are made up of multiple sprites, for example a 2x2 facility will use 4 sprites for '''spriteShape''' and 4 sprites for '''spriteFacility''' (top-left, top-right, bottom-left, bottom-right).
| 1
|-
| '''buildCost'''
| Amount of money spent to build this facility in the base.
| 0
|-
| '''buildTime'''
| Amount of days it takes for this facility to be built.
| 0
|-
| '''monthlyCost'''
| Amount of money spent monthly for the maintenance of this facility.
| 0
|-
| '''storage'''
| Amount of storage space (for items) this facility provides. See [[Base Stores]].
| 0
|-
| '''personnel'''
| Amount of personnel (soldiers, scientsts, engineers) these quarters can contain.
| 0
|-
| '''aliens'''
| Amount of live aliens this facility can contain. Only checked if the ''alienContainmentLimitEnforced'' option is enabled.
| 0
|-
| '''crafts'''
| Amount of X-COM craft this facility can contain.
| 0
|-
| '''labs'''
| Amount of lab space this facility provides for research projects.
| 0
|-
| '''workshops'''
| Amount of workshop space this facility provides for manufacture projects.
| 0
|-
| '''psiLabs'''
| Amount of soldier space this facility provides for psionic training.
| 0
|-
| '''radarRange'''
| Maximum radar detection range of this facility, in nautical miles.
| 0
|-
| '''radarChance'''
| Chance (0-100%) of this radar detecting a UFO that enters its range.
| 0
|-
| '''defense'''
| Offensive power provided by this base defense against attacking UFOs.
| 0
|-
| '''hitRatio'''
| Chance (0-100) of the base defense hitting an attacking UFO.
| 0
|-
| '''fireSound'''
| Sound ID from [[#Extra_Sounds|GEO.CAT]] played when the base defense fires.
| -1
|-
| '''hitSound'''
| Sound ID from [[#Extra_Sounds|GEO.CAT]] played when the base defense hits a target.
| -1
|-
| '''mapName'''
| [[MAPS|Map]] associated to this facility in Battlescape base defenses.
| -
|-
|}

=== Crafts ===

Defines one of the [[Craft|X-COM crafts]] that go on interception missions, listed in ''"crafts:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the craft name.
| ''required''
|-
| '''requires'''
| List of [[#Research|topics]] (string IDs) that must be researched to unlock this craft. If none are specified, this craft is unlocked from the start.
| -
|-
| '''sprite'''
| Sprite ID from [[BASEBITS.PCK]] used to draw this craft in the Basescape and from [[INTICON.PCK]] used to draw the damage indicator in dogfights.
modders: the corresponding extrasprite file id for BASEBITS.PCK is sprite+33 INTICON.PCK contains a minimized icon id=sprite the file id for the dogfight image is sprite+11
| -1
|-
| '''fuelMax'''
| Maximum amount of fuel this craft can carry. Crafts use up fuel based on their speed while travelling.
| 0
|-
| '''damageMax'''
| Maximum amount of damage this craft can take. If this amount is exceeded, the craft is destroyed.
| 0
|-
| '''speedMax'''
| Maximum speed in nautical miles. Crafts travel at max speed when flying and half speed when patrolling.
| 0
|-
| '''accel'''
| Aceeleration value shown in the UFOpaedia.
| 0
|-
| '''weapons'''
| Amount of craft weapons this craft can equip. The UI can only display a max of 2 weapons.
| 0
|-
| '''soldiers'''
| Amount of soldiers this craft can carry.
| 0
|-
| '''maxItems'''
| Amount of items this craft can carry.
| 80
|-
| '''vehicles'''
| Amount of vehicles this craft can carry.
| 0
|-
| '''costBuy'''
| Amount of money spent for purchasing this craft. If set to 0, the craft will not be available in the Purchase/Recruit screen.
| 0
|-
| '''costRent'''
| Amount of money spent monthly for renting this craft. If set to 0, the craft is not on rental and won't count towards base maintenance.
| 0
|-
| '''costSell'''
| Amount of money gained for selling this craft.
| 0
|-
| '''refuelItem'''
| Item required for refuelling this craft. If no item is specified, the craft uses human fuel.
| 0
|-
| '''repairRate'''
| Amount of damage restored every hour while [[Repairs|Repairing]] in base.
| 1
|-
| '''refuelRate'''
| Amount of fuel restored every 30 mins while [[Refueling]] in base. If specified, a '''refuelItem''' is spent each time.
| 1
|-
| '''radarRange'''
| Detection range of the craft's radar in nautical miles. Every craft radar has a 100% detection chance.
| 600
|-
| '''transferTime'''
| Number of hours it takes to purchase/transfer this craft to a base.
| 0
|-
| '''score'''
| [[Score]] lost when this craft is destroyed.
| 0
|-
| '''spacecraft'''
| Can this craft go to [[Cydonia]]?
| false
|-
| '''battlescapeTerrainData'''
| [[#Terrains|Terrain]] associated to this craft in Battlescape missions.
| -
|}

=== Craft Weapons ===

Defines one of the [[Craft Armaments|weapons]] equipped by X-COM craft for shooting down UFOs, listed in ''"craftWeapons:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the weapon name.
| ''required''
|-
| '''sprite'''
| Sprite ID from [[BASEBITS.PCK]] used to draw the weapon in the Basescape and from [[INTICON.PCK]] used to draw the weapon in dogfights.
modders: the corresponding extrasprites file id for INTICON.PCK is sprite+5 and sprite+48 for BASEBITS.PCK
| -1
|-
| '''sound'''
| Sound ID from [[#Extra_Sounds|GEO.CAT]] played when this weapon fires.
| -1
|-
| '''damage'''
| Amount of damage this weapon does to enemy UFOs.
| 0
|-
| '''range'''
| Maximum range of this weapon in dogfights (in meters).
| 0
|-
| '''accuracy'''
| Chance (0-100%) of each shot hitting the enemy UFO.
| 0
|-
| '''reloadCautious'''
| Time this weapon takes to fire between each shot in ''Cautious Mode''.
| 0
|-
| '''reloadStandard'''
| Time this weapon takes to fire between each shot in ''Standard Mode''.
| 0
|-
| '''reloadAggressive'''
| Time this weapon takes to fire between each shot in ''Aggressive Mode''.
| 0
|-
| '''ammoMax'''
| Maximum amount of ammo this weapon can carry.
| 0
|-
| '''rearmRate'''
| Amount of ammo restored every 30 mins while the craft is [[Rearming]] in base. If specified, '''clip'''s are spent depending on their '''clipSize'''. If the '''clipSize''' of the specified ammo is 0, no '''clip'''s are spent.
| 1
|-
| '''projectileType'''
| Type of the weapon projectile, used for the projectile sprite in dogfights:
* 0 - [[Stingray]]
* 1 - [[Avalanche]]
* 2 - [[Cannon]]
* 3 - [[Fusion Ball]]
* 4 - [[Laser Cannon]]
* 5 - [[Plasma Beam]]
| 2
|-
| '''projectileSpeed'''
| Speed of the weapon projectile in dogfights.
| 0
|-
| '''launcher'''
| String ID of the [[#Items|item]] required to equip this weapon.
| -
|-
| '''clip'''
| String ID of the [[#Items|item]] required to rearm this weapon.
| -
|}

=== Items ===

Defines the Geoscape and Battlescape properties of an [[Equipment (EU)|item]] that can be stored in X-COM bases, listed in ''"items:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the internal item name.
| ''required''
|-
| '''name'''
| String ID of the displayed item name, for cases where it's different from the internal name. If omitted, '''type''' is used.
| -
|-
| '''requires'''
| List of [[#Research|topics]] (string IDs) that must be researched to unlock this item. If none are specified, this item is unlocked from the start. Soldiers can only use unlocked items in the Battlescape.
| -
|-
| '''size'''
| Space occupied by this item in [[Base Stores]]. Can be a decimal value.
| 0.0
|-
| '''costBuy'''
| Amount of money spent for purchasing this item. If set to 0, this item will not be available in the Purchase/Recruit screen.
| 0
|-
| '''costSell'''
| Amount of money gained for selling this item.
| 0
|-
| '''transferTime'''
| Number of hours it takes to purchase/transfer this item to a base.
| 24
|-
| '''weight'''
| [[Item_Weight|Weight]] occupied by this item in a soldier's inventory.
| 999
|-
| '''bigSprite'''
| Sprite ID from [[BIGOBS.PCK]] used to draw this item in a soldier's inventory and UFOpaedia.
| -1
|-
| '''floorSprite'''
| Sprite ID from [[FLOOROB.PCK]] used to draw this item on the floor of a Battlescape tile.
| -1
|-
| '''handSprite'''
| Sprite ID from [[HANDOB.PCK]] used to draw this item on a soldier's hand in the Battlescape.
modders: each handobject needs 8 images (8 directions) define the extrasprites accordingly
| 120
|-
| '''bulletSprite'''
| Sprite ID from ''BulletSprites.png'' used to draw this weapon's projectile on the Battlescape:
* 0 - [[Rocket Launcher]]
* 1 - [[Pistol]]
* 2 - [[Rifle]]
* 3 - [[Auto Cannon]]
* 4 - [[Heavy Cannon]]
* 5 - [[Laser Pistol]]
* 6 - [[Laser Rifle]]
* 7 - [[Heavy Laser]]
* 8 - [[Plasma Rifle|Plasma]]
* 9 - [[Small Launcher]]
* 10 - [[Blaster Launcher]]
for modders: the bulletsprite needs to be put into the extraSprites type "Projectiles" the bulletsprite can contain up to 35 3x3 images. The corresponding file id is 35*[bulletSprite]
| -1
|-
| '''fireSound'''
| Sound ID from [[#Extra_Sounds|BATTLE.CAT]] played when this weapon fires.
| -1
|-
| '''hitSound'''
| Sound ID from [[#Extra_Sounds|BATTLE.CAT]] played when this weapon hits a target.
| -1
|-
| '''hitAnimation'''
| Sprite ID from [[SMOKE.PCK]] used to draw the weapon's "hit explosion".
'''NOTE''': Do not define this value for melee/psi weapons, they use [[HIT.PCK]] and therefore meleeAnimation instead.
| 0
|-
| '''power'''
| Average damage of the weapon, in most cases it will be +-50% this value.
| 0
|-
| '''strengthApplied'''
| Add the attacking unit's strength to this weapon's damage.
| false
|-
| '''compatibleAmmo'''
| List of string IDs of the ammo items that can be loaded on this weapon. If none are specified, the weapon doesn't need ammo.
| -
|-
| '''damageType'''
| What type of [[damage]] does this weapon do:
* 0 - None
* 1 - Armor Piercing
* 2 - Incendiary
* 3 - High Explosive
* 4 - Laser
* 5 - Plasma
* 6 - Stun
* 7 - Melee
* 8 - Acid
* 9 - Smoke
'''NOTE:''' A damage type other than 0-9 will do nothing.
| 0
|-
| '''tuAuto'''
'''accuracyAuto'''
| The percentage (0-100%) of [[Time Units]] (from the soldier's total) required to fire an Auto Shot. If 0, the weapon does not have an Auto Shot.
The base accuracy (0-100%) applied to a soldier's [[Firing Accuracy]] when firing an Auto Shot.
| 0
0
|-
| '''tuSnap'''
'''accuracySnap'''
| The percentage (0-100%) of [[Time Units]] (from the soldier's total) required to fire a Snap Shot. If 0, the weapon does not have a Snap Shot.
The base accuracy (0-100%) applied to a soldier's [[Firing Accuracy]] when firing a Snap Shot.
| 0
0
|-
| '''tuAimed'''
'''accuracyAimed'''
| The percentage (0-100%) of [[Time Units]] (from the soldier's total) required to fire an Aimed Shot. If 0, the weapon does not have an Aimed Shot.
The base accuracy (0-100%) applied to a soldier's [[Firing Accuracy]] when firing an Aimed Shot.
| 0
0
|-
|-
| '''tuMelee'''
'''accuracyMelee'''
| The percentage (0-100%) of [[Time Units]] (from the soldier's total) required to do a melee attack (Hit). If 0, the weapon does not have a melee attack.
The base accuracy (0-100%) applied to a soldier's [[Melee Accuracy]] when doing a melee attack.
| 0
0
|-
| '''clipSize'''
| The amount of ammo stored in each weapon clip. If -1 is specified, this weapon has infinite ammo.
| 0
|-
| '''battleType'''
| Defines the weapon's behavior in the Battlescape:
* 0 - None (Geoscape-only item)
* 1 - [[Weapons|Firearm]]
* 2 - Ammo
* 3 - Melee
* 4 - [[Grenade]]
* 5 - [[Proximity Grenade]]
* 6 - [[Medi-Kit (EU)|Medi-Kit]]
* 7 - [[Motion Scanner]]
* 8 - [[Mind Probe]]
* 9 - [[Psi-Amp]]
* 10 - [[Electro-flare]]
* 11 - Corpse
| 0
|-
| '''twoHanded'''
| Is this weapon two-handed? If true, incurs an accuracy penalty if used with both hands occupied. Note that the handsprite of a twoHanded item is also drawn at a slightly different position than a one handed item.
| false
|-
| '''waypoint'''
| Does this weapon use waypoints? (eg. [[Blaster Launcher]]). Can also be used to make ammo items use the waypoint system.
| false
|-
| '''fixedWeapon'''
| Is this weapon fixed? (it's part of a unit, eg. tanks and terrorist units)
| false
|-
| '''invWidth'''
| Item width in a soldier's inventory (in grid units).
| 1
|-
| '''invHeight'''
| Item height in a soldier's inventory (in grid units).
| 1
|-
| '''painKiller'''
| Amount of painkillers contained in a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''heal'''
| Amount of heal's contained in a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''stimulant'''
| Amount of stimulants contained in a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''woundRecovery'''
| Amount of [[Fatal Wounds]] treated by each heal of a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''healthRecovery'''
| Amount of [[Health]] recovered by each heal of a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''stunRecovery'''
| Amount of [[Stun]] removed by each stimulant of a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''energyRecovery'''
| Amount of [[Energy]] recovered by each stimulant of a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''tuUse'''
| Amount of [[Time Units]] required to use this item (for non-offensive items). It's a flat rate if '''flatRate''' is true, otherwise it's a percentage (0-100%).
| 0
|-
| '''recoveryPoints'''
| [[Score]] gained for recovering this alien artifact.
| 0
|-
| '''armor'''
| How much damage is needed to destroy this item on the ground.
| 20
|-
| '''recover'''
| Is this item recoverable? (gets transported to the X-COM base on mission success)
| true
|-
| '''turretType'''
| Sprite ID from [[TANKS.PCK]] of the turret to assign to this tank:
* 0 - [[Tank/Cannon]]
* 1 - [[Tank/Rocket Launcher]]
* 2 - [[Tank/Laser Cannon]]
* 3 - [[Hovertank/Plasma]]
* 4 - [[Hovertank/Launcher]]
| -1
|-
| '''liveAlien'''
| Does this item represent a live alien? (counts towards [[Alien Containment]])
| false
|-
| '''blastRadius'''
| Size of the projectile explosions. 0 for no explosion. -1 to automatically calculate based on weapon power and damage type (actual '''blastRadius''' currently is capped due [[Explosions#Playing_With_Fire|Explosion calculations]]).
| -1
|-
| '''flatRate'''
| If true, then TU costs for this weapon are a flat rate (instead of a percentage of unit TUs).
| false
|-
| '''arcingShot'''
| Does this weapon fire in an arc?
| false
|-
| '''attraction'''
| Represents how likely an alien is to pick up this item. Values below 5 will be ignored (by design).
| 0
|-
| '''maxRange'''
| Maximum range at which this weapon can operate.
| 200
|-
| '''aimRange'''
| Maximum effective range with this weapon before which range-based dropoff occurs.
| 200
|-
| '''snapRange'''
| Maximum effective range with snap shot before which range-based dropoff occurs. (ufoextender accuracy only)
| 15
|-
| '''autoRange'''
| Maximum effective range with auto shot before which range-based dropoff occurs. (ufoextender accuracy only)
| 7
|-
| '''minRange'''
| Range-based dropoff will work in reverse for ranges below this.
| 0
|-
| '''dropoff'''
| The value by which the accuracy lowers for each tile after (or before) the thresholds above.
| 2
|-
| '''bulletSpeed'''
| How much faster (or slower, if you use a negative number) is a projectile fired from this weapon compared to the average.
| 0
|-
| '''autoShots'''
| How many auto shots does this weapon fire.
| 3
|-
| '''shotgunPellets'''
| Number of projectiles fired per unit of ammunition. (note: due to engine limitations it is currently impossible to draw multiple projectiles in flight.)
| 0
|-
| '''zombieUnit'''
| String ID of the unit used for zombification (eg. [[Chrysallid]]s turn units into [[Zombie]]s).
| none
|-
| '''meleeSound'''
| Sound ID from [[#Extra_Sounds|BATTLE.CAT]] played when this weapon attacks a target with melee.
| 39
|-
| '''meleeHitSound'''
| Sound ID from [[#Extra_Sounds|BATTLE.CAT]] played when this weapon HITS a target with melee.
| -1
|-
| '''meleeAnimation'''
| Sprite ID from HIT.PCK played when this weapon attacks a target with melee.
| 0
|-
| '''meleePower'''
| Damage this weapon will do when using melee. This only applies to Firearms, and is only available as stun damage. For normal melee weapons, use regular power and damage types.
| 0
|-
| '''LOSRequired'''
| Does this item require line of sight? (only applies to mind probes and psi-amps)
| false
|-
| '''skillApplied'''
| Is melee skill applied to the accuracy of an attack made with this object?
| true
|-
|}

=== UFOs ===

Defines one of the [[UFOs]] that invade Earth, listed in ''"ufos:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the UFO name.
| ''required''
|-
| '''size'''
| String ID of the UFO size.
| STR_VERY_SMALL
|-
| '''sprite'''
| Sprite ID from [[INTERWIN.DAT]] used to draw this UFO in the dogfight view and UFOpaedia.
don't try to add more images if you don't want to punch yourself in the face - use modsprite
| -1
|-
| '''modSprite'''
| Filename used to draw this UFO in the dogfight view and UFOpaedia.
| -
|-
| '''damageMax'''
| Maximum amount of damage this UFO can take. If the UFO takes 50% damage, it crash lands. If it takes 100% damage, it is destroyed.
| 0
|-
| '''speedMax'''
| Maximum speed in nautical miles.
| 0
|-
| '''accel'''
| Aceeleration value shown in the UFOpaedia.
| 0
|-
| '''power'''
| Damage power of this UFO's weapon in dogfights.
| 0
|-
| '''range'''
| Maximum range of this UFO's weapon in dogfights (in meters).
| 0
|-
| '''score'''
| [[Score]] gained when this UFO is destroyed, or half this score if it crash lands.
| 0
|-
| '''reload'''
| Time the UFO's weapon takes to fire between each shot.
| 0
|-
| '''breakOffTime'''
| Minimum amount of time for the UFO to be able to break off of a dogfight.
| 0
|-
| '''battlescapeTerrainData'''
| [[#Terrains|Terrain]] associated to this UFO in Battlescape missions.
| ''required''
|-
|}

=== Inventory Sections ===

Defines one of the sections of the [[Inventory TU Table|Battlescape inventory]] (eg. Backpack), listed in ''"invs:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the inventory name.
| ''required''
|-
| '''x'''
'''y'''
| Pixel coordinates of this section on the inventory screen.
| 0
0
|-
| '''type'''
| Type of this section:
* 0 = Slot section, can contain as many items as will fit on the slots.
* 1 = Hand section, can only contain one item regardless of size.
* 2 = Ground section, can contain infinite items.
| 0
|-
| '''slots'''
| List of the grid slots (''[x, y]'') that this section is composed of. For example, to make a 2x2 section, you would have ''[0, 0] [0, 1] [1, 0] [1, 1]''.
| -
|-
| '''costs'''
| List of [[Time Units]] costs to move an item from this section to another one (eg. ''STR_BACKPACK: 16'' means it will cost 16 TUs to move an item from this section to the Backpack).
| -
|-
|}

=== Terrains ===

Defines one of the [[TERRAIN|terrains]] used to generate a Battlescape map, listed in "terrains:".

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''name'''
| String ID of the terrain name.
| ''required''
|-
| '''largeBlockLimit'''
| Maximum amount of large blocks that can be used on map generation.
| 0
|-
| '''textures'''
| List of [[TEXTURE.DAT|Geoscape textures]] that correspond to this terrain.
| -
|-
| '''hemisphere'''
| Geoscape hemisphere associated with this terrain:
* -1 - Northern hemisphere.
* 0 - Both hemispheres.
* 1 - Southern hemisphere.
| 0
|-
| '''mapDataSets'''
| List of filenames (each with matching [[MCD]]/[[Image Formats#PCK|PCK/TAB]] files) that contain the tiles of this terrain.
| -
|-
| '''mapBlocks'''
| List of map blocks (see below) that are used for generating a map.
| -
|-
| '''roadTypeOdds'''
| Odds as a % of generating each type of road (E-W Road, N-S Road, Crossing) odds for crossing are: 100 - EW - NS.
| [0 0]
|-|-
| '''civilianTypes'''
| List of units to use as civilians for this mission.
| [MALE_CIVILIAN, FEMALE_CIVILIAN]
|-
|}

==== Map Blocks ====

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''name'''
| Filename of the [[MAPS|map]].
| ''required''
|-
| '''width'''
| Width of this map block in Battlescape grid units.
| 0
|-
| '''length'''
| Length of this map block in Battlescape grid units.
| 0
|-
| '''height'''
| Height of this map block in Battlescape grid units.
| 1
|-
| '''type'''
| Type of this map block:
* -1 - Undefined
* 0 - Default
* 1 - Landing Zone (for placing X-COM / alien craft)
* 2 - E-W Road (for city maps)
* 3 - N-S Road (for city maps)
* 4 - Road Crossing (for city maps)
* 5 - Dirt (for filling empty base blocks)
* 6 - X-COM spawn point (for [[Alien Base]] / [[Cydonia]] missions)
* 7 - [[Alien Base]] Target
* 8 - [[Cydonia]] Target
| -1
|-
| '''subType'''
| Sub-type of this map block (see '''type''').
| -1
|-
| '''frequency'''
| Frequency of this block in a map.
| 1
|-
| '''maxCount'''
| Maximum amount of times this block can be used in a map. If -1 there is no limit.
| -1
|-
| '''items'''
| An array of items to add to this mapblock, an the positions to place them at.
| -1
|}

*'''frequency''' defines the odds of the map appearing on the map
** The value assigned (default: 1) is used in ''x/n'', which defines the probability of being chosen.
** ''x'' is the integer defined for the map block's frequency and ''n'' is the combined total of probabilities for all the map types combined.
** This property can only be used in type 0 map blocks.
*'''maxCount''' is the maximum number of times it can be used.
** The value assigned is also used in ''x/n'' to determine the probability of being chosen.
** Each use reduces ''x'' by -1, with the caveat that being used as a Landing Zone type will not reduce the x value since it could result in no available Landing Zones.
** This property can only be used in type 0 map blocks.
* '''hemisphere''' only applies to UFO missions, not Terror ones.
*'''width/length''' defines the size of the map
** be aware that the mapview "width"-label is the openxcom ruleset length parameter
** be aware that the mapview "length"-label is the openxcom ruleset width parameter

==== Guidelines/Tips ====
* All maps with an XCOM/Alien craft require at least one type 1 map block. This map block can only contain ground tiles (no walls or objects), otherwise the game will crash or the walls/objects will be removed.
* All Terror terrains (listed under STR_TERROR_MISSION) require at least 1 map block of '''Types''' 2, 3 and 4 (for a total of 3 maps, which are required to place roads) and the corresponding '''roadTypeOdds''' added to the ruleset.
* If there isn't any map blocks designed as roads since you want to keep your terrain 'random', this can be circumvented by designating all 10x10 map blocks, excluding the one(s) used for the XCOM craft, as either '''Type''' 2, 3 and 4 and by defining their '''subType''' to 0. The game will then randomly choose between the map blocks for each type used in the roads, making them map more random.

=== Armor ===

Defines a Battlescape unit's [[armor]] as well as visual representation (so every unit has an armor), listed in ''"armors:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the armor name.
| ''required''
|-
| '''spriteSheet'''
| Sprite sheet from [[UNITS]] used to draw a unit wearing this armor.
| -
|-
| '''spriteInv'''
| Sprite used for the [[Inventory Backgrounds]] of a unit wearing this armor.
| -
|-
| '''corpseBattle'''
| List of string IDs of the corpse [[#Items|items]] generated when a unit wearing this armor is killed (one per unit tile) on the Battlescape.
| -
|-
| '''corpseGeo'''
| String ID of the corpse [[#Items|item]] associated with this unit on the Geoscape.
| -
|-
| '''storeItem'''
| String ID of the [[#Items|item]] that represents this armor in [[Base Stores]] for equipping.
| -
|-
| '''weight'''
| Physical weight of the armor when worn
| 6
|-
| '''stats'''
| like soldier stats (see below) but these are treated as stat bonuses for wearing the specific armor.
| -
|-
| '''frontArmor'''
| Protection provided on the front of the unit.
| 0
|-
| '''sideArmor'''
| Protection provided on the sides of the unit.
| 0
|-
| '''rearArmor'''
| Protection provided on the rear of the unit.
| 0
|-
| '''underArmor'''
| Protection provided under the unit (eg. from explosions).
| 0
|-
| '''drawingRoutine'''
| Drawing routine used to put together the body parts in the unit's '''spriteSheet''':
* 0 = [[Soldier]], [[Sectoid]]
* 1 = [[Floater]]
* 2 = [[HWP]]
* 3 = [[Cyberdisk]]
* 4 = [[Civilian]], [[Ethereal]]
* 5 = [[Sectopod]], [[Reaper]]
* 6 = [[Snakeman]]
* 7 = [[Chryssalid]]
* 8 = [[Silacoid]]
* 9 = [[Celatid]]
* 10 = [[Muton]]
* 11 = [[Submersible Weapons Systems]]
* 12 = [[Hallucinoid]]
* 13 = [[Aquanauts]]
* 14 = [[Calcinite]], [[Deep One]], [[Gillman]], [[Lobster Man]], [[Tasoth]]
* 15 = [[Aquatoid]]
* 16 = [[Bio-Drone]]
| 0
|-
| '''movementType'''
| Type of movement provided by this armor:
* 0 = Walking
* 1 = Flying
* 2 = Sliding (no walking animation)
it also defines the body of an tank (32-images) in your spriteSheet or the change in sprites while flying using a flying armour see: [[TANKS.PCK]], [[XCOM_2.PCK]]
| 0
|-
| '''damageModifier'''
| List of decimal damage modifiers (1.0 = 100%) this armor applies to each damage type (see [[#Items|Items section]]) received. Modifiers must be specified for all damage types, in this order:
* None
* Armor Piercing
* Incendiary
* High Explosive
* Laser
* Plasma
* Stun
* Melee
* Acid
* Smoke
|
- 1.0 
- 1.0 
- 1.0 
- 1.0 
- 1.0 
- 1.0 
- 1.0 
- 1.0 
- 1.0 
- 1.0
|-
| '''size'''
| Size of the unit wearing this armor, in Battlescape grid units. Every unit is square, so a size of 2 means 2x2.
| 1
|-
| '''loftempsSet'''
| List of [[LOFTEMPS]] IDs (one per unit tile, so a 1x1 unit has 1, a 2x2 unit has 4, etc.) used to represent a unit wearing this armor in 3D space.
| -
|-
| '''loftemps'''
| loftemps is a deprecated option that only works for 1x1 sized units.
| -
|-
| '''forcedTorso'''
| soldier sprites have female and male torsos. some armours reuse these sprites for flying/non flying torso without difference between genders. This can be controlled by the parameter: 0 = use genderrelated torso, 1 = use male torso, 2 = use female torso
| 0

|}

=== Player Units (Soldiers) ===

Defines a [[soldier]] recruited by X-COM, listed in ''"soldiers:"''. Currently only one soldier unit type (''XCOM'') is supported.

Unit stats are represented as follows:
* [[Time Units|tu]]
* [[Energy|stamina]]
* [[Health|health]]
* [[Bravery|bravery]] (always a multiple of 10)
* [[Reactions|reactions]]
* [[Firing Accuracy|firing]]
* [[Throwing Accuracy|throwing]]
* [[Strength|strength]]
* [[Psi Strength|psiStrength]]
* [[Psi Skill|psiSkill]]
* [[Melee Accuracy|melee]] (not visible)

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the soldier name.
| ''required''
|-
| '''minStats'''
| Minimum values used to generate the soldier's [[Starting Stats]]. In this case, ''psiSkill'' is treated as the initial stat (not generated).
| -
|-
| '''maxStats'''
| Maximum values used to generate the soldier's [[Starting Stats]]. In this case, ''psiSkill'' is treated as the minimum value for the first month of psi training (actual value is 100%-150%).
| -
|-
| '''statCaps'''
| Maximum stats this soldier can gain through [[Experience]]. '''NOTE:''' A stat will still go over the limit once, and then will no longer increase (see [[Experience#Regarding Caps|Regarding Caps]]).
| -
|-
| '''armor'''
| String ID of the [[#Armor|armor]] this soldier uses by default.
| -
|-
| '''standHeight'''
| Height of this soldier when standing.
| 0
|-
| '''kneelHeight'''
| Height of this soldier when kneeling.
| 0
|-
| '''floatHeight'''
| Distance between the bottom of this unit and the ground.
| 0
|-
| '''femaleFrequency'''
| The probability that a female soldier is hired.
| 50
|}

=== AI Units (Aliens/Civilians) ===

Defines an [[Alien Life Forms|alien]] (enemy) or [[civilian]] (neutral) unit, listed in ''"units:"''. Every different alien rank is a different unit, since they have completely different stats. Unit stats are represented as follows:
* [[Time Units|tu]]
* [[Energy|stamina]]
* [[Health|health]]
* [[Bravery|bravery]] (always a multiple of 10)
* [[Reactions|reactions]]
* [[Firing Accuracy|firing]]
* [[Throwing Accuracy|throwing]]
* [[Strength|strength]]
* [[Psi Strength|psiStrength]]
* [[Psi Skill|psiSkill]]
* [[Melee Accuracy|melee]] (not visible)

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the unit name.
| ''required''
|-
| '''race'''
| String ID of the unit race (for alien units).
| -
|-
| '''rank'''
| String ID of the unit rank (for alien units).
| -
|-
| '''stats'''
| Battlescape stats of this unit.
| -
|-
| '''armor'''
| String ID of the [[#Armor|armor]] this unit uses by default.
| -
|-
| '''standHeight'''
| Height of this unit when standing.
| 0
|-
| '''floatHeight'''
| Distance between the bottom of this unit and the ground.
| 0
|-
| '''value'''
| [[Score]] this unit is worth.
| 0
|-
| '''deathSound'''
| Sound ID from [[#Extra_Sounds|BATTLE.CAT]] played when this unit dies.
| -1
|-
| '''aggroSound'''
| Sound ID from [[#Extra_Sounds|BATTLE.CAT]] played when this unit aggros.
| -1
|-
| '''moveSound'''
| Sound ID from [[#Extra_Sounds|BATTLE.CAT]] played when this unit moves.
| -1
|-
| '''intelligence'''
| Intelligence of this unit's AI. The higher the value, the longer this unit remembers player troops between turns.
| 0
|-
| '''aggression'''
| Aggression of this unit's AI. The higher the value, the more ruthless the unit, the more likely to make a frontal assault. Less aggressive units tend to set up ambushes.
Vanilla values are:
* 0 = mostly passive
* 1 = balanced
* 2 = mostly aggresive
| 0
|-
| '''energyRecovery'''
| Energy recovered by the unit each turn (needs verification)
| 40 (?)
|-
| '''specab'''
| Special ability of this unit:
* 0 = None
* 1 = [[Cyberdisc|Explodes on Death]]
* 2 = [[Bio-Drone|Burns Floor]]
* 3 = Burns Floor and explodes on Death
| 0
|-
| '''spawnUnit'''
| String ID of the unit used to respawn on death (eg. [[Zombie]]s respawn as [[Chrysallid]]s).
| -
|-
| '''livingWeapon'''
| Is this unit a living weapon? (only attacks with a '''fixedWeapon''')
| false
|-
| '''female'''
| Is this unit a female? (used for TFTD civilian types)
| false
|-
|}

=== Alien Races ===

Defines a [[Alien Life Forms|race]] used in [[Alien Missions]], listed in ''"alienRaces:"''. Heavily tied with deployment data.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''id'''
| String ID of the alien race name.
| ''required''
|-
| '''members'''
| Alien crew associated with this alien race (eg. race units + terrorist units), defined by a list of unit string IDs. Order here will define rank in terms of deployment. generally speaking the order is:
* 0 - Commander
* 1 - Leader
* 2 - Engineer
* 3 - Medic
* 4 - Navigator
* 5 - Soldier
* 6 - Terrorist 1
* 7 - Terrorist 2
but of course, not all races have all ranks, so the "fill in" rank would be listed multiple times (see ethereals).
| -
|-
| '''retaliation'''
| retaliation enables/disables the race for retaliation missions.
| ''True''
|-
|}

=== Alien Deployments ===

Defines a Battlescape deployment data used in [[Alien Missions]] (such as alien and map configurations), listed in ''"alienDeployments:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the deployment name.
| ''required''
|-
| '''width'''
| Width of the Battlescape map in grid units.
| 0
|-
| '''length'''
| Length of the Battlescape map in grid units.
| 0
|-
| '''height'''
| Vertical height of the Battlescape map in grid units.
| 0
|-
| '''terrains'''
| list of string IDs of the [[#Terrains|terrain]] to choose from to generate this map. This is not used for UFO sites where the terrain comes from the Geoscape.
| -
|-
| '''shade'''
| Shade of the map (0-15, where 0 is full daytime and 15 is full nighttime). This is not used for UFO sites where the shade comes from the Geoscape.
| 0
|-
| '''nextStage'''
| String ID of the next deployment stage to use after this one, for multi-stage missions.
| -
|-
| '''race'''
| Sets the race to use in the next stage.
| ""
|-
| '''data'''
| List of deployment data for each alien rank on this mission (see below).
| -
|}

Notes:
* '''terrains''' can also be used with UFOs, with the game using instead the listed terrain rather than the location of the UFO on Geoscape.
==== Deployment Data ====

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''alienRank'''
| [[Alien Rank|Rank]] associated with this deployment data, as defined by the order of the race in question (see above)
| ''required''
|-
| '''lowQty'''
| Maximum quantity of aliens to spawn (beginner).
| 0
|-
| '''highQty'''
| Maximum quantity of aliens to spawn (superhuman).
| 0
|-
| '''dQty'''
| Minimum Desired Quantity of aliens to spawn.
| 0
|-
| '''extraQty'''
| spawns a random number of additional aliens.
| 0
|-
| '''percentageOutsideUfo'''
| Percentage (0-100%) of aliens to spawn outside in UFO sites.
| 0
|-
| '''itemSets'''
| Three lists (one for each alien technology level) of [[#Items|items]] (string IDs) for the aliens to equip.
| ''required''
|-
|}

=== Research ===

Defines a [[Research|research topic]] that X-COM scientists can investigate, listed in ''"research:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''name'''
| String ID of the research project's name (or item, if a '''lookup''' is defined).
| ''required''
|-
| '''lookup'''
| String ID of the research project's display name and UFOPaedia article reference.
| -
|-
| '''cost'''
| Number of man hours (on average) required to complete this project.
| 0
|-
| '''points'''
| [[Score]] earned for completing this project.
| 0
|-
| '''needItem'''
| Does this project require an [[#Items|item]] of the same name?
| false
|-
| '''dependencies'''
| List of research projects that can unlock access to this one. If the full list is researched, or if one of the projects on the list "unlocks" this one, it becomes available.
| -
|-
| '''unlocks'''
| List of research projects unlocked, regardless of other dependencies, but not requirements, by completing this project (for example, any live alien unlocks "alien origins").
| -
|-
| '''requires'''
| List of research projects unilaterally required before this project can be unlocked (for example, "the martian solution" will not even be considered for unlocking until AFTER "alien origins" is completed).
| -
|-
| '''getOneFree'''
| List of "bonus" research projects that may be granted when completing this project (for example, alien medics will give you information on other alien races). Only applies to living aliens.
| -
|-
|}

=== Manufacture ===

Defines a [[Manufacture|manufacture project]] that X-COM engineers can produce, listed in ''"manufacture:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''name'''
| String ID of the manufacturing project's name (and the item it produces).
| ''required''
|-
| '''category'''
| String ID of the manufacturing project's category.
| -
|-
| '''requires'''
| List of [[#Research|topics]] (string IDs) that must be researched to unlock this project. If none are specified, this project is unlocked from the start.
| -
|-
| '''space'''
| Amount of [[Workshop]] space required to begin this project.
| 0
|-
| '''time'''
| Number of man hours (on average) required per item.
| 0
|-
| '''cost'''
| Monetary deduction per item manufactured.
| 0
|-
| '''requiredItems'''
| List of [[#Items|items]] required and consumed per item manufactured.
| -
|-
| '''producedItems'''
| List of [[#Items|items]] produced per each item consumed. If not specified, defaults to 1 item with the same string ID as the manufacture.
| 1
|-
|}

=== UFOpaedia Article ===

Defines an article in the in-game [[UFOpaedia]], listed in ''"ufopaedia:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''id'''
| String ID of the article name. This must match the ID of the object associated with this article, if applicable.
| ''required''
|-
| '''title'''
| String ID of the article title. If omitted, the '''id''' is used.
| -
|-
| '''type_id'''
| Type of this article:
* 0 = Unknown
* 1 = [[Craft]]
* 2 = [[Craft Armaments]]
* 3 = [[HWP]]
* 4 = [[Equipment (EU)|Equipment]]
* 5 = [[Armour]]
* 6 = [[Base Facilities]]
* 7 = Text & Image (eg. [[Alien Life Forms]], [[UFO Components]])
* 8 = Text (eg. [[Alien Research]])
* 9 = [[UFO]]
| 0
|-
| '''section'''
| String ID of the UFOpaedia section this article belongs in.
| -
|-
| '''requires'''
| List of [[#Research|topics]] (string IDs) that must be researched to unlock this article. If none are specified, this article is unlocked from the start.
| -
|-
| '''image_id'''
| Filename of the [[UP001.SPK-UP042.SPK|background image]] displayed on this article, if applicable.
| -
|-
| '''text'''
| String ID of the description displayed on this article.
| -
|-
| '''text_width'''
| Maximum width of the text displayed, only applicable to ''Text & Image'' articles.
| 0
|-
| '''rect_stats'''
| Rectangle ('''x''', '''y''', '''width''', '''height''') of the stats text on the screen, only applicable to ''Craft'' articles.
| 0
|-
| '''rect_text'''
| Rectangle ('''x''', '''y''', '''width''', '''height''') of the description text on the screen, only applicable to ''Craft'' articles.
| 0
|-
| '''weapon'''
| String ID of the weapon, only applicable to ''HWP'' articles.
| -
|}

=== UFO Trajectories ===

Defines a trajectory carried out by an UFO during an [[#Alien Missions|alien mission]], listed in ''"ufoTrajectories:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''id'''
| String ID of the trajectory name.
| ''required''
|-
| '''groundTimer'''
| Amount of seconds for the UFO to spend on Ground waypoints.
| 0
|-
| '''waypoints'''
| List of waypoints for the UFO to traverse, defined as ''[zone, altitude, speed]''. 
'''zone''': Globe zone where the waypoint is located. 
'''altitude''': UFO altitude after reaching this waypoint:
* 0 - Ground
* 1 - Very Low
* 2 - Low
* 3 - High
* 4 - Very High
'''speed''': UFO speed after reaching this waypoint, as a percentage (0-100%) of its maximum speed.
| -
|}

=== Alien Missions ===

Defines an [[Alien Missions|alien mission]] carried out by UFOs on the Geoscape, listed in ''"alienMissions:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the mission type.
| ''required''
|-
| '''points'''
| [[Score]] allocated to aliens for successfully completing this mission.
| 0
|-
| '''raceWeights'''
| List of alien races likely to carry out this mission, and the % chance of them being allocated to this mission, listed by "number of months after game beginning".
| ''required''
|-
| '''waves'''
| List of UFO waves to spawn as this mission progresses, as described below.
| ''required''
|}

==== Waves ====

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''ufo'''
| String ID of the [[#UFOs|UFO]] to spawn.
| ''required''
|-
| '''count'''
| Number of UFOs to spawn.
| 0
|-
| '''trajectory'''
| String ID of the [[#UFO Trajectories|trajectory]] for this UFO to use when entering Earth's atmosphere.
| ''required''
|-
| '''timer'''
| How long after the previous wave should this wave arrive? (in seconds)
| 0
|-
|}

=== Alien Item Levels ===

This is a list of item level probabilities, with a number between 0 and 2 representing an item level from plasma pistols to heavy plasmas, as defined in the deployments, expressing a 10% probability for that item level being used.

0 = first set (plasma pistol/clip)
1 = second set (plasma rifle/clip)
2 = third set (heavy plasma/clip)

For example:
[ 2, 0, 0, 0, 0, 0, 0, 1, 1, 1 ]
would represent a 60% chance for pistols, 30% rifles, and 10% heavy weapons. 
Note that the order does not matter, but the length DOES. each line MUST have 10 digits.

The above can be confusing. There are 10 fields; each number represents 10%. 
There are six instances of '0'. 6x10% = 60% chance of plasma pistol 
There are three instances of '1'. 3x10% = 30% chance of plasma rifle 
There is only one instance of '2'. 1x10% = 10% chance of heavy plasma 

Each line represents a month after the beginning of the game, and there is no limit to the number defined. 
OpenXCom will use the most recently available item level in the event the game goes on forever.

=== Extra Sprites ===

Adds or replaces sprites in an existing [[Image Formats|X-COM image file]], listed in ''"extraSprites:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| Filename of the original/new image to modify.
| ''required''
|-
| '''width'''
'''height'''
| Size of the sprite(s) in pixels.
| 0
0
|-
| '''singleImage'''
| Is the image file just a single sprite (true) or a spritesheet (false)?
| false
|-
| '''subX'''
'''subY'''
| Size of the subdivision in pixels. If a subdivision is specified, then the image file is divided into chunks to form the sprites (eg. spritesheets).
| 0
0
|-
| '''files'''
| List of the new sprites to add/replace, listed as ''spriteID: filename''.
| -
|}

Example:
- type: GIANTBUNNY.PCK
width: 32
height: 40
files:
0: Resources/Bunny/Bunny00.png
1: Resources/Bunny/Bunny01.bmp
2: Resources/Bunny/Bunny02.gif

=== Extra Sounds ===

Adds or replaces sounds in an existing [[SOUND|X-COM sound file]], listed in ''"extraSounds:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| ID of the original sound file to modify:
* BATTLE.CAT - Battlescape sounds, corresponds to ''SOUND1.CAT'' or ''SAMPLE2.CAT'' (55 sounds).
* INTRO.CAT - Intro sounds, corresponds to ''INTRO.CAT'' or ''SAMPLE3.CAT'', probably best not to mess with these.
* GEO.CAT - Geoscape sounds, corresponds to ''SOUND2.CAT'' or ''SAMPLE.CAT'' (14 sounds).
| ''required''
|-
| '''files'''
| List of the new sounds to add/replace, listed as ''soundID: filename''.
| -
|}

Example:
- type: BATTLE.CAT
files:
55: Resources/Sounds/sample.wav

=== Extra Strings ===

Adds or replaces text strings in an existing [[Translations (OpenXcom)|OpenXcom language file]], listed in ''"extraStrings:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| Filename of the original language file to modify, sans extension.
| ''required''
|-
| '''strings'''
| List of the new strings to add/replace, listed as ''stringID: text''.
| -
|}

Example:
- type: en-US
strings:
STR_SNIPER_RIFLE: Sniper Rifle
STR_SNIPER_RIFLE_CLIP: Sniper Rifle Clip
- type: en-GB
strings:
STR_SNIPER_RIFLE: Sniper Rifle
STR_SNIPER_RIFLE_CLIP: Sniper Rifle Clip
- type: de
strings:
STR_SNIPER_RIFLE: Scharfschützengewehr
STR_SNIPER_RIFLE_CLIP: Scharfschützengewehrmunition
- type: ru
strings:
STR_SNIPER_RIFLE: Снайперская винтовка
STR_SNIPER_RIFLE_CLIP: Магазин к снайп. винтовке

=== Interfaces ===

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| ''?''
| -
|-
| '''elements'''
| ''?''
| -
|-
| '''id'''
| ''?''
| -
|-
| '''color'''
| ''?''
| -
|}

=== StatStrings ===

[[Statstrings]] are used for automatically renaming soldiers. They are case sensitive and they are processed in the order in which they are specified.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''string'''
| String to add to name.
| ''required''
|-
| '''psiStrength''' 
'''psiSkill''' 
'''bravery''' 
'''strength''' 
'''firing''' 
'''reactions''' 
'''stamina''' 
'''tu''' 
'''health''' 
'''throwing'''
| One or more stat ranges are ANDed together for success. Each range has a minVal and maxVal. Use YAML standard tilde (~) to indicate null. ((~) = 0 as minvalue; (~) =255 as maxvalue)
| -
|}

Example:
statStrings:
- string: "x"
psiStrength: [~, 30]
- string: "P"
psiStrength: [80, ~]
- string: "p"
psiStrength: [60, 79]
- string: "K"
psiSkill: [60, ~]
- string: "k"
psiSkill: [30, 59]
- string: "b"
bravery: [60, ~]
- string: "c"
bravery: [~, 10]
- string: "w"
strength: [~, 25]
- string: "Snpr"
firing: [60, ~]
reactions: [60, ~]
- string: "M"
firing: [70, ~]
- string: "m"
firing: [60, 69]
- string: "Sct"
reactions: [50, ~]
tu: [60, ~]
- string: "R"
reactions: [60, ~]
- string: "r"
reactions: [50, 59]

==References==
<references />

[[Category:OpenXcom]]

Ruleset Reference (OpenXcom)

2014-12-04T20:53:12Z

Falko: /* Deployment Data */

A reference of all the customizable values of everything in a [[Rulesets (OpenXcom)|ruleset]]. Some guidelines:
* If a value is omitted from the ruleset, the default is used. You cannot omit ''required'' values.
* Text strings (eg. names) are represented by string IDs from the [[Translations (OpenXcom)|language files]]
* Numerical IDs (used for sprites, sounds, etc.) start at 0, not 1.
* Boolean (yes/no) values are represented by true/false.
* World coordinates are represented in degrees (see [[WORLD.DAT]]).
* Money amounts (prices, costs, etc.) are represented in dollars.
* All paths are '''case sensitive'''! If your ruleset uses external files, make sure that they named properly as described in ruleset.

Items are ordered as they come in the ruleset. To override this, you can specify a ''listOrder''. You can find the default listOrders in [[Ruleset List Order (OpenXcom)|Ruleset List Order]].

=== Globe ===

Defines the drawing of landmasses and borders on the globe.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''data'''
| Path name of file which contains polygon and texture information. (For example WORLD.DAT).
| -
|-
| '''polygons'''
| List of polygons drawn on the globe surface. A triangle consist of seven values: the first number defines the texture, followed by three pairs of (x,y) globe coordinates. Only polygons with 3 or 4 vertices are reliable shown on the globe = 7 or 9 values per entry.
| -
|-
| '''polylines'''
| List of border lines. Each list entry consist of a list of (x,y) globe coordinates.
| -
|}

=== Countries ===

Defines one of the [[Country Funding (EU)|funding nations]], listed in ''"countries:"''. They're used for activity graphs and player scoring.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the country name.
| ''required''
|-
| '''fundingBase'''
| Country's base funding, in thousands. The starting funding can be anywhere between 1x and 2x the base funding.
| 0
|-
| '''fundingCap'''
| Country's funding cap, in thousands. Once a country reaches this maximum, it will no longer increase its funding.
| 0
|-
| '''labelLon'''
'''labelLat'''
| Longitude and latitude coordinates of the country's label on the globe. This label is only shown when the globe is zoomed in and "detail" is turned on.
| 0.0
0.0
|-
| '''areas'''
| List of "rectangles" on the globe defined as [''lon1'' ''lat1'' ''lon2'' ''lat2'']. Any activity within these areas counts towards the country's graph activity and affects their opinion of the player.
| -
|}

=== Regions ===

Defines one of the [[Geoscape (EU)#World Regions/Countries|world regions]], listed in ''"regions:"''. They're used for base placement, activity graphs and mission spawning.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the region name.
| ''required''
|-
| '''cost'''
| Amount of money spent building an X-COM base in this region (first base is free).
| 0
|-
| '''areas'''
| List of "rectangles" on the globe defined as ''[lon1, lat1, lon2, lat2]''. Any activity within these areas counts towards the region's graph activity.
| -
|-
| '''cities'''
| List of cities belonging to this region. They will be displayed on the globe and used for terror site missions. Each city is defined by their '''lon''' and '''lat''' coordinates and a '''name''' string ID.
| -
|-
| '''regionWeight'''
| Weight of this region when selecting regions for alien missions.
| 0
|-
| '''missionWeights'''
| Weighted list of the different mission types for this region (eg. ''STR_ALIEN_RESEARCH: 14'').
| -
|-
| '''missionZones'''
| List of "rectangles" (''[lon1, lat1, lon2, lat2]'') defining the mission zones for this region. Mission zones are waypoints for UFO trajectories.
| -
|-
| '''missionRegion'''
| Spawn mission in this region instead (used for regions without land).
| -
|}

=== Base Facilities ===

Defines one of the [[Base Facilities (EU)|facilities]] that can be built in an X-COM base, listed in ''"facilities:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the facility name.
| ''required''
|-
| '''requires'''
| List of [[#Research|topics]] (string IDs) that must be researched to unlock this facility. If none are specified, this facility is unlocked from the start.
| -
|-
| '''spriteShape'''
| Sprite ID from [[BASEBITS.PCK]] used to draw the facility's outer shape in the Basescape and UFOpaedia.
| -1
|-
| '''spriteFacility'''
| Sprite ID from [[BASEBITS.PCK]] used to draw the facility's contents in the Basescape and UFOpaedia. Drawn on top of '''spriteShape'''.
| -1
|-
| '''lift'''
| Is this facility an [[Access Lift]]? All base facilities must be connected to the lift.
| false
|-
| '''hyper'''
| Is this facility a [[Hyperwave Decoder]]? Displays extra information for detected UFOs. Only valid for radar facilities.
| false
|-
| '''mind'''
| Is this facility a [[Mind Shield]]? Reduces the chance of UFOs finding your base. Does not stack.
| false
|-
| '''grav'''
| Is this facility a [[Grav Shield]]? Doubles the power of your base defenses. Does not stack.
| false
|-
| '''size'''
| Size of the facility, in grid units. Every facility is square, so a size of 1 means 1x1, 2 means 2x2, etc. Bigger facilities are made up of multiple sprites, for example a 2x2 facility will use 4 sprites for '''spriteShape''' and 4 sprites for '''spriteFacility''' (top-left, top-right, bottom-left, bottom-right).
| 1
|-
| '''buildCost'''
| Amount of money spent to build this facility in the base.
| 0
|-
| '''buildTime'''
| Amount of days it takes for this facility to be built.
| 0
|-
| '''monthlyCost'''
| Amount of money spent monthly for the maintenance of this facility.
| 0
|-
| '''storage'''
| Amount of storage space (for items) this facility provides. See [[Base Stores]].
| 0
|-
| '''personnel'''
| Amount of personnel (soldiers, scientsts, engineers) these quarters can contain.
| 0
|-
| '''aliens'''
| Amount of live aliens this facility can contain. Only checked if the ''alienContainmentLimitEnforced'' option is enabled.
| 0
|-
| '''crafts'''
| Amount of X-COM craft this facility can contain.
| 0
|-
| '''labs'''
| Amount of lab space this facility provides for research projects.
| 0
|-
| '''workshops'''
| Amount of workshop space this facility provides for manufacture projects.
| 0
|-
| '''psiLabs'''
| Amount of soldier space this facility provides for psionic training.
| 0
|-
| '''radarRange'''
| Maximum radar detection range of this facility, in nautical miles.
| 0
|-
| '''radarChance'''
| Chance (0-100%) of this radar detecting a UFO that enters its range.
| 0
|-
| '''defense'''
| Offensive power provided by this base defense against attacking UFOs.
| 0
|-
| '''hitRatio'''
| Chance (0-100) of the base defense hitting an attacking UFO.
| 0
|-
| '''fireSound'''
| Sound ID from [[#Extra_Sounds|GEO.CAT]] played when the base defense fires.
| -1
|-
| '''hitSound'''
| Sound ID from [[#Extra_Sounds|GEO.CAT]] played when the base defense hits a target.
| -1
|-
| '''mapName'''
| [[MAPS|Map]] associated to this facility in Battlescape base defenses.
| -
|-
|}

=== Crafts ===

Defines one of the [[Craft|X-COM crafts]] that go on interception missions, listed in ''"crafts:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the craft name.
| ''required''
|-
| '''requires'''
| List of [[#Research|topics]] (string IDs) that must be researched to unlock this craft. If none are specified, this craft is unlocked from the start.
| -
|-
| '''sprite'''
| Sprite ID from [[BASEBITS.PCK]] used to draw this craft in the Basescape and from [[INTICON.PCK]] used to draw the damage indicator in dogfights.
modders: the corresponding extrasprite file id for BASEBITS.PCK is sprite+33 INTICON.PCK contains a minimized icon id=sprite the file id for the dogfight image is sprite+11
| -1
|-
| '''fuelMax'''
| Maximum amount of fuel this craft can carry. Crafts use up fuel based on their speed while travelling.
| 0
|-
| '''damageMax'''
| Maximum amount of damage this craft can take. If this amount is exceeded, the craft is destroyed.
| 0
|-
| '''speedMax'''
| Maximum speed in nautical miles. Crafts travel at max speed when flying and half speed when patrolling.
| 0
|-
| '''accel'''
| Aceeleration value shown in the UFOpaedia.
| 0
|-
| '''weapons'''
| Amount of craft weapons this craft can equip. The UI can only display a max of 2 weapons.
| 0
|-
| '''soldiers'''
| Amount of soldiers this craft can carry.
| 0
|-
| '''maxItems'''
| Amount of items this craft can carry.
| 80
|-
| '''vehicles'''
| Amount of vehicles this craft can carry.
| 0
|-
| '''costBuy'''
| Amount of money spent for purchasing this craft. If set to 0, the craft will not be available in the Purchase/Recruit screen.
| 0
|-
| '''costRent'''
| Amount of money spent monthly for renting this craft. If set to 0, the craft is not on rental and won't count towards base maintenance.
| 0
|-
| '''costSell'''
| Amount of money gained for selling this craft.
| 0
|-
| '''refuelItem'''
| Item required for refuelling this craft. If no item is specified, the craft uses human fuel.
| 0
|-
| '''repairRate'''
| Amount of damage restored every hour while [[Repairs|Repairing]] in base.
| 1
|-
| '''refuelRate'''
| Amount of fuel restored every 30 mins while [[Refueling]] in base. If specified, a '''refuelItem''' is spent each time.
| 1
|-
| '''radarRange'''
| Detection range of the craft's radar in nautical miles. Every craft radar has a 100% detection chance.
| 600
|-
| '''transferTime'''
| Number of hours it takes to purchase/transfer this craft to a base.
| 0
|-
| '''score'''
| [[Score]] lost when this craft is destroyed.
| 0
|-
| '''spacecraft'''
| Can this craft go to [[Cydonia]]?
| false
|-
| '''battlescapeTerrainData'''
| [[#Terrains|Terrain]] associated to this craft in Battlescape missions.
| -
|}

=== Craft Weapons ===

Defines one of the [[Craft Armaments|weapons]] equipped by X-COM craft for shooting down UFOs, listed in ''"craftWeapons:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the weapon name.
| ''required''
|-
| '''sprite'''
| Sprite ID from [[BASEBITS.PCK]] used to draw the weapon in the Basescape and from [[INTICON.PCK]] used to draw the weapon in dogfights.
modders: the corresponding extrasprites file id for INTICON.PCK is sprite+5 and sprite+48 for BASEBITS.PCK
| -1
|-
| '''sound'''
| Sound ID from [[#Extra_Sounds|GEO.CAT]] played when this weapon fires.
| -1
|-
| '''damage'''
| Amount of damage this weapon does to enemy UFOs.
| 0
|-
| '''range'''
| Maximum range of this weapon in dogfights (in meters).
| 0
|-
| '''accuracy'''
| Chance (0-100%) of each shot hitting the enemy UFO.
| 0
|-
| '''reloadCautious'''
| Time this weapon takes to fire between each shot in ''Cautious Mode''.
| 0
|-
| '''reloadStandard'''
| Time this weapon takes to fire between each shot in ''Standard Mode''.
| 0
|-
| '''reloadAggressive'''
| Time this weapon takes to fire between each shot in ''Aggressive Mode''.
| 0
|-
| '''ammoMax'''
| Maximum amount of ammo this weapon can carry.
| 0
|-
| '''rearmRate'''
| Amount of ammo restored every 30 mins while the craft is [[Rearming]] in base. If specified, '''clip'''s are spent depending on their '''clipSize'''. If the '''clipSize''' of the specified ammo is 0, no '''clip'''s are spent.
| 1
|-
| '''projectileType'''
| Type of the weapon projectile, used for the projectile sprite in dogfights:
* 0 - [[Stingray]]
* 1 - [[Avalanche]]
* 2 - [[Cannon]]
* 3 - [[Fusion Ball]]
* 4 - [[Laser Cannon]]
* 5 - [[Plasma Beam]]
| 2
|-
| '''projectileSpeed'''
| Speed of the weapon projectile in dogfights.
| 0
|-
| '''launcher'''
| String ID of the [[#Items|item]] required to equip this weapon.
| -
|-
| '''clip'''
| String ID of the [[#Items|item]] required to rearm this weapon.
| -
|}

=== Items ===

Defines the Geoscape and Battlescape properties of an [[Equipment (EU)|item]] that can be stored in X-COM bases, listed in ''"items:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the internal item name.
| ''required''
|-
| '''name'''
| String ID of the displayed item name, for cases where it's different from the internal name. If omitted, '''type''' is used.
| -
|-
| '''requires'''
| List of [[#Research|topics]] (string IDs) that must be researched to unlock this item. If none are specified, this item is unlocked from the start. Soldiers can only use unlocked items in the Battlescape.
| -
|-
| '''size'''
| Space occupied by this item in [[Base Stores]]. Can be a decimal value.
| 0.0
|-
| '''costBuy'''
| Amount of money spent for purchasing this item. If set to 0, this item will not be available in the Purchase/Recruit screen.
| 0
|-
| '''costSell'''
| Amount of money gained for selling this item.
| 0
|-
| '''transferTime'''
| Number of hours it takes to purchase/transfer this item to a base.
| 24
|-
| '''weight'''
| [[Item_Weight|Weight]] occupied by this item in a soldier's inventory.
| 999
|-
| '''bigSprite'''
| Sprite ID from [[BIGOBS.PCK]] used to draw this item in a soldier's inventory and UFOpaedia.
| -1
|-
| '''floorSprite'''
| Sprite ID from [[FLOOROB.PCK]] used to draw this item on the floor of a Battlescape tile.
| -1
|-
| '''handSprite'''
| Sprite ID from [[HANDOB.PCK]] used to draw this item on a soldier's hand in the Battlescape.
modders: each handobject needs 8 images (8 directions) define the extrasprites accordingly
| 120
|-
| '''bulletSprite'''
| Sprite ID from ''BulletSprites.png'' used to draw this weapon's projectile on the Battlescape:
* 0 - [[Rocket Launcher]]
* 1 - [[Pistol]]
* 2 - [[Rifle]]
* 3 - [[Auto Cannon]]
* 4 - [[Heavy Cannon]]
* 5 - [[Laser Pistol]]
* 6 - [[Laser Rifle]]
* 7 - [[Heavy Laser]]
* 8 - [[Plasma Rifle|Plasma]]
* 9 - [[Small Launcher]]
* 10 - [[Blaster Launcher]]
for modders: the bulletsprite needs to be put into the extraSprites type "Projectiles" the bulletsprite can contain up to 35 3x3 images. The corresponding file id is 35*[bulletSprite]
| -1
|-
| '''fireSound'''
| Sound ID from [[#Extra_Sounds|BATTLE.CAT]] played when this weapon fires.
| -1
|-
| '''hitSound'''
| Sound ID from [[#Extra_Sounds|BATTLE.CAT]] played when this weapon hits a target.
| -1
|-
| '''hitAnimation'''
| Sprite ID from [[SMOKE.PCK]] used to draw the weapon's "hit explosion".
'''NOTE''': Do not define this value for melee/psi weapons, they use [[HIT.PCK]] and therefore meleeAnimation instead.
| 0
|-
| '''power'''
| Average damage of the weapon, in most cases it will be +-50% this value.
| 0
|-
| '''strengthApplied'''
| Add the attacking unit's strength to this weapon's damage.
| false
|-
| '''compatibleAmmo'''
| List of string IDs of the ammo items that can be loaded on this weapon. If none are specified, the weapon doesn't need ammo.
| -
|-
| '''damageType'''
| What type of [[damage]] does this weapon do:
* 0 - None
* 1 - Armor Piercing
* 2 - Incendiary
* 3 - High Explosive
* 4 - Laser
* 5 - Plasma
* 6 - Stun
* 7 - Melee
* 8 - Acid
* 9 - Smoke
'''NOTE:''' A damage type other than 0-9 will do nothing.
| 0
|-
| '''tuAuto'''
'''accuracyAuto'''
| The percentage (0-100%) of [[Time Units]] (from the soldier's total) required to fire an Auto Shot. If 0, the weapon does not have an Auto Shot.
The base accuracy (0-100%) applied to a soldier's [[Firing Accuracy]] when firing an Auto Shot.
| 0
0
|-
| '''tuSnap'''
'''accuracySnap'''
| The percentage (0-100%) of [[Time Units]] (from the soldier's total) required to fire a Snap Shot. If 0, the weapon does not have a Snap Shot.
The base accuracy (0-100%) applied to a soldier's [[Firing Accuracy]] when firing a Snap Shot.
| 0
0
|-
| '''tuAimed'''
'''accuracyAimed'''
| The percentage (0-100%) of [[Time Units]] (from the soldier's total) required to fire an Aimed Shot. If 0, the weapon does not have an Aimed Shot.
The base accuracy (0-100%) applied to a soldier's [[Firing Accuracy]] when firing an Aimed Shot.
| 0
0
|-
|-
| '''tuMelee'''
'''accuracyMelee'''
| The percentage (0-100%) of [[Time Units]] (from the soldier's total) required to do a melee attack (Hit). If 0, the weapon does not have a melee attack.
The base accuracy (0-100%) applied to a soldier's [[Melee Accuracy]] when doing a melee attack.
| 0
0
|-
| '''clipSize'''
| The amount of ammo stored in each weapon clip. If -1 is specified, this weapon has infinite ammo.
| 0
|-
| '''battleType'''
| Defines the weapon's behavior in the Battlescape:
* 0 - None (Geoscape-only item)
* 1 - [[Weapons|Firearm]]
* 2 - Ammo
* 3 - Melee
* 4 - [[Grenade]]
* 5 - [[Proximity Grenade]]
* 6 - [[Medi-Kit (EU)|Medi-Kit]]
* 7 - [[Motion Scanner]]
* 8 - [[Mind Probe]]
* 9 - [[Psi-Amp]]
* 10 - [[Electro-flare]]
* 11 - Corpse
| 0
|-
| '''twoHanded'''
| Is this weapon two-handed? If true, incurs an accuracy penalty if used with both hands occupied. Note that the handsprite of a twoHanded item is also drawn at a slightly different position than a one handed item.
| false
|-
| '''waypoint'''
| Does this weapon use waypoints? (eg. [[Blaster Launcher]]). Can also be used to make ammo items use the waypoint system.
| false
|-
| '''fixedWeapon'''
| Is this weapon fixed? (it's part of a unit, eg. tanks and terrorist units)
| false
|-
| '''invWidth'''
| Item width in a soldier's inventory (in grid units).
| 1
|-
| '''invHeight'''
| Item height in a soldier's inventory (in grid units).
| 1
|-
| '''painKiller'''
| Amount of painkillers contained in a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''heal'''
| Amount of heal's contained in a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''stimulant'''
| Amount of stimulants contained in a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''woundRecovery'''
| Amount of [[Fatal Wounds]] treated by each heal of a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''healthRecovery'''
| Amount of [[Health]] recovered by each heal of a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''stunRecovery'''
| Amount of [[Stun]] removed by each stimulant of a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''energyRecovery'''
| Amount of [[Energy]] recovered by each stimulant of a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''tuUse'''
| Amount of [[Time Units]] required to use this item (for non-offensive items). It's a flat rate if '''flatRate''' is true, otherwise it's a percentage (0-100%).
| 0
|-
| '''recoveryPoints'''
| [[Score]] gained for recovering this alien artifact.
| 0
|-
| '''armor'''
| How much damage is needed to destroy this item on the ground.
| 20
|-
| '''recover'''
| Is this item recoverable? (gets transported to the X-COM base on mission success)
| true
|-
| '''turretType'''
| Sprite ID from [[TANKS.PCK]] of the turret to assign to this tank:
* 0 - [[Tank/Cannon]]
* 1 - [[Tank/Rocket Launcher]]
* 2 - [[Tank/Laser Cannon]]
* 3 - [[Hovertank/Plasma]]
* 4 - [[Hovertank/Launcher]]
| -1
|-
| '''liveAlien'''
| Does this item represent a live alien? (counts towards [[Alien Containment]])
| false
|-
| '''blastRadius'''
| Size of the projectile explosions. 0 for no explosion. -1 to automatically calculate based on weapon power and damage type (actual '''blastRadius''' currently is capped due [[Explosions#Playing_With_Fire|Explosion calculations]]).
| -1
|-
| '''flatRate'''
| If true, then TU costs for this weapon are a flat rate (instead of a percentage of unit TUs).
| false
|-
| '''arcingShot'''
| Does this weapon fire in an arc?
| false
|-
| '''attraction'''
| Represents how likely an alien is to pick up this item. Values below 5 will be ignored (by design).
| 0
|-
| '''maxRange'''
| Maximum range at which this weapon can operate.
| 200
|-
| '''aimRange'''
| Maximum effective range with this weapon before which range-based dropoff occurs.
| 200
|-
| '''snapRange'''
| Maximum effective range with snap shot before which range-based dropoff occurs. (ufoextender accuracy only)
| 15
|-
| '''autoRange'''
| Maximum effective range with auto shot before which range-based dropoff occurs. (ufoextender accuracy only)
| 7
|-
| '''minRange'''
| Range-based dropoff will work in reverse for ranges below this.
| 0
|-
| '''dropoff'''
| The value by which the accuracy lowers for each tile after (or before) the thresholds above.
| 2
|-
| '''bulletSpeed'''
| How much faster (or slower, if you use a negative number) is a projectile fired from this weapon compared to the average.
| 0
|-
| '''autoShots'''
| How many auto shots does this weapon fire.
| 3
|-
| '''shotgunPellets'''
| Number of projectiles fired per unit of ammunition. (note: due to engine limitations it is currently impossible to draw multiple projectiles in flight.)
| 0
|-
| '''zombieUnit'''
| String ID of the unit used for zombification (eg. [[Chrysallid]]s turn units into [[Zombie]]s).
| none
|-
| '''meleeSound'''
| Sound ID from [[#Extra_Sounds|BATTLE.CAT]] played when this weapon attacks a target with melee.
| 39
|-
| '''meleeHitSound'''
| Sound ID from [[#Extra_Sounds|BATTLE.CAT]] played when this weapon HITS a target with melee.
| -1
|-
| '''meleeAnimation'''
| Sprite ID from HIT.PCK played when this weapon attacks a target with melee.
| 0
|-
| '''meleePower'''
| Damage this weapon will do when using melee. This only applies to Firearms, and is only available as stun damage. For normal melee weapons, use regular power and damage types.
| 0
|-
| '''LOSRequired'''
| Does this item require line of sight? (only applies to mind probes and psi-amps)
| false
|-
| '''skillApplied'''
| Is melee skill applied to the accuracy of an attack made with this object?
| true
|-
|}

=== UFOs ===

Defines one of the [[UFOs]] that invade Earth, listed in ''"ufos:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the UFO name.
| ''required''
|-
| '''size'''
| String ID of the UFO size.
| STR_VERY_SMALL
|-
| '''sprite'''
| Sprite ID from [[INTERWIN.DAT]] used to draw this UFO in the dogfight view and UFOpaedia.
don't try to add more images if you don't want to punch yourself in the face - use modsprite
| -1
|-
| '''modSprite'''
| Filename used to draw this UFO in the dogfight view and UFOpaedia.
| -
|-
| '''damageMax'''
| Maximum amount of damage this UFO can take. If the UFO takes 50% damage, it crash lands. If it takes 100% damage, it is destroyed.
| 0
|-
| '''speedMax'''
| Maximum speed in nautical miles.
| 0
|-
| '''accel'''
| Aceeleration value shown in the UFOpaedia.
| 0
|-
| '''power'''
| Damage power of this UFO's weapon in dogfights.
| 0
|-
| '''range'''
| Maximum range of this UFO's weapon in dogfights (in meters).
| 0
|-
| '''score'''
| [[Score]] gained when this UFO is destroyed, or half this score if it crash lands.
| 0
|-
| '''reload'''
| Time the UFO's weapon takes to fire between each shot.
| 0
|-
| '''breakOffTime'''
| Minimum amount of time for the UFO to be able to break off of a dogfight.
| 0
|-
| '''battlescapeTerrainData'''
| [[#Terrains|Terrain]] associated to this UFO in Battlescape missions.
| ''required''
|-
|}

=== Inventory Sections ===

Defines one of the sections of the [[Inventory TU Table|Battlescape inventory]] (eg. Backpack), listed in ''"invs:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the inventory name.
| ''required''
|-
| '''x'''
'''y'''
| Pixel coordinates of this section on the inventory screen.
| 0
0
|-
| '''type'''
| Type of this section:
* 0 = Slot section, can contain as many items as will fit on the slots.
* 1 = Hand section, can only contain one item regardless of size.
* 2 = Ground section, can contain infinite items.
| 0
|-
| '''slots'''
| List of the grid slots (''[x, y]'') that this section is composed of. For example, to make a 2x2 section, you would have ''[0, 0] [0, 1] [1, 0] [1, 1]''.
| -
|-
| '''costs'''
| List of [[Time Units]] costs to move an item from this section to another one (eg. ''STR_BACKPACK: 16'' means it will cost 16 TUs to move an item from this section to the Backpack).
| -
|-
|}

=== Terrains ===

Defines one of the [[TERRAIN|terrains]] used to generate a Battlescape map, listed in "terrains:".

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''name'''
| String ID of the terrain name.
| ''required''
|-
| '''largeBlockLimit'''
| Maximum amount of large blocks that can be used on map generation.
| 0
|-
| '''textures'''
| List of [[TEXTURE.DAT|Geoscape textures]] that correspond to this terrain.
| -
|-
| '''hemisphere'''
| Geoscape hemisphere associated with this terrain:
* -1 - Northern hemisphere.
* 0 - Both hemispheres.
* 1 - Southern hemisphere.
| 0
|-
| '''mapDataSets'''
| List of filenames (each with matching [[MCD]]/[[Image Formats#PCK|PCK/TAB]] files) that contain the tiles of this terrain.
| -
|-
| '''mapBlocks'''
| List of map blocks (see below) that are used for generating a map.
| -
|-
| '''roadTypeOdds'''
| Odds as a % of generating each type of road (E-W Road, N-S Road, Crossing) odds for crossing are: 100 - EW - NS.
| [0 0]
|-|-
| '''civilianTypes'''
| List of units to use as civilians for this mission.
| [MALE_CIVILIAN, FEMALE_CIVILIAN]
|-
|}

==== Map Blocks ====

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''name'''
| Filename of the [[MAPS|map]].
| ''required''
|-
| '''width'''
| Width of this map block in Battlescape grid units.
| 0
|-
| '''length'''
| Length of this map block in Battlescape grid units.
| 0
|-
| '''height'''
| Height of this map block in Battlescape grid units.
| 1
|-
| '''type'''
| Type of this map block:
* -1 - Undefined
* 0 - Default
* 1 - Landing Zone (for placing X-COM / alien craft)
* 2 - E-W Road (for city maps)
* 3 - N-S Road (for city maps)
* 4 - Road Crossing (for city maps)
* 5 - Dirt (for filling empty base blocks)
* 6 - X-COM spawn point (for [[Alien Base]] / [[Cydonia]] missions)
* 7 - [[Alien Base]] Target
* 8 - [[Cydonia]] Target
| -1
|-
| '''subType'''
| Sub-type of this map block (see '''type''').
| -1
|-
| '''frequency'''
| Frequency of this block in a map.
| 1
|-
| '''maxCount'''
| Maximum amount of times this block can be used in a map. If -1 there is no limit.
| -1
|-
| '''items'''
| An array of items to add to this mapblock, an the positions to place them at.
| -1
|}

*'''frequency''' defines the odds of the map appearing on the map
** The value assigned (default: 1) is used in ''x/n'', which defines the probability of being chosen.
** ''x'' is the integer defined for the map block's frequency and ''n'' is the combined total of probabilities for all the map types combined.
** This property can only be used in type 0 map blocks.
*'''maxCount''' is the maximum number of times it can be used.
** The value assigned is also used in ''x/n'' to determine the probability of being chosen.
** Each use reduces ''x'' by -1, with the caveat that being used as a Landing Zone type will not reduce the x value since it could result in no available Landing Zones.
** This property can only be used in type 0 map blocks.
* '''hemisphere''' only applies to UFO missions, not Terror ones.
*'''width/length''' defines the size of the map
** be aware that the mapview "width"-label is the openxcom ruleset length parameter
** be aware that the mapview "length"-label is the openxcom ruleset width parameter

==== Guidelines/Tips ====
* All maps with an XCOM/Alien craft require at least one type 1 map block. This map block can only contain ground tiles (no walls or objects), otherwise the game will crash or the walls/objects will be removed.
* All Terror terrains (listed under STR_TERROR_MISSION) require at least 1 map block of '''Types''' 2, 3 and 4 (for a total of 3 maps, which are required to place roads) and the corresponding '''roadTypeOdds''' added to the ruleset.
* If there isn't any map blocks designed as roads since you want to keep your terrain 'random', this can be circumvented by designating all 10x10 map blocks, excluding the one(s) used for the XCOM craft, as either '''Type''' 2, 3 and 4 and by defining their '''subType''' to 0. The game will then randomly choose between the map blocks for each type used in the roads, making them map more random.

=== Armor ===

Defines a Battlescape unit's [[armor]] as well as visual representation (so every unit has an armor), listed in ''"armors:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the armor name.
| ''required''
|-
| '''spriteSheet'''
| Sprite sheet from [[UNITS]] used to draw a unit wearing this armor.
| -
|-
| '''spriteInv'''
| Sprite used for the [[Inventory Backgrounds]] of a unit wearing this armor.
| -
|-
| '''corpseBattle'''
| List of string IDs of the corpse [[#Items|items]] generated when a unit wearing this armor is killed (one per unit tile) on the Battlescape.
| -
|-
| '''corpseGeo'''
| String ID of the corpse [[#Items|item]] associated with this unit on the Geoscape.
| -
|-
| '''storeItem'''
| String ID of the [[#Items|item]] that represents this armor in [[Base Stores]] for equipping.
| -
|-
| '''weight'''
| Physical weight of the armor when worn
| 6
|-
| '''stats'''
| like soldier stats (see below) but these are treated as stat bonuses for wearing the specific armor.
| -
|-
| '''frontArmor'''
| Protection provided on the front of the unit.
| 0
|-
| '''sideArmor'''
| Protection provided on the sides of the unit.
| 0
|-
| '''rearArmor'''
| Protection provided on the rear of the unit.
| 0
|-
| '''underArmor'''
| Protection provided under the unit (eg. from explosions).
| 0
|-
| '''drawingRoutine'''
| Drawing routine used to put together the body parts in the unit's '''spriteSheet''':
* 0 = [[Soldier]], [[Sectoid]]
* 1 = [[Floater]]
* 2 = [[HWP]]
* 3 = [[Cyberdisk]]
* 4 = [[Civilian]], [[Ethereal]]
* 5 = [[Sectopod]], [[Reaper]]
* 6 = [[Snakeman]]
* 7 = [[Chryssalid]]
* 8 = [[Silacoid]]
* 9 = [[Celatid]]
* 10 = [[Muton]]
* 11 = [[Submersible Weapons Systems]]
* 12 = [[Hallucinoid]]
* 13 = [[Aquanauts]]
* 14 = [[Calcinite]], [[Deep One]], [[Gillman]], [[Lobster Man]], [[Tasoth]]
* 15 = [[Aquatoid]]
* 16 = [[Bio-Drone]]
| 0
|-
| '''movementType'''
| Type of movement provided by this armor:
* 0 = Walking
* 1 = Flying
* 2 = Sliding (no walking animation)
it also defines the body of an tank (32-images) in your spriteSheet or the change in sprites while flying using a flying armour see: [[TANKS.PCK]], [[XCOM_2.PCK]]
| 0
|-
| '''damageModifier'''
| List of decimal damage modifiers (1.0 = 100%) this armor applies to each damage type (see [[#Items|Items section]]) received. Modifiers must be specified for all damage types, in this order:
* None
* Armor Piercing
* Incendiary
* High Explosive
* Laser
* Plasma
* Stun
* Melee
* Acid
* Smoke
|
- 1.0 
- 1.0 
- 1.0 
- 1.0 
- 1.0 
- 1.0 
- 1.0 
- 1.0 
- 1.0 
- 1.0
|-
| '''size'''
| Size of the unit wearing this armor, in Battlescape grid units. Every unit is square, so a size of 2 means 2x2.
| 1
|-
| '''loftempsSet'''
| List of [[LOFTEMPS]] IDs (one per unit tile, so a 1x1 unit has 1, a 2x2 unit has 4, etc.) used to represent a unit wearing this armor in 3D space.
| -
|-
| '''loftemps'''
| loftemps is a deprecated option that only works for 1x1 sized units.
| -
|-
| '''forcedTorso'''
| soldier sprites have female and male torsos. some armours reuse these sprites for flying/non flying torso without difference between genders. This can be controlled by the parameter: 0 = use genderrelated torso, 1 = use male torso, 2 = use female torso
| 0

|}

=== Player Units (Soldiers) ===

Defines a [[soldier]] recruited by X-COM, listed in ''"soldiers:"''. Currently only one soldier unit type (''XCOM'') is supported.

Unit stats are represented as follows:
* [[Time Units|tu]]
* [[Energy|stamina]]
* [[Health|health]]
* [[Bravery|bravery]] (always a multiple of 10)
* [[Reactions|reactions]]
* [[Firing Accuracy|firing]]
* [[Throwing Accuracy|throwing]]
* [[Strength|strength]]
* [[Psi Strength|psiStrength]]
* [[Psi Skill|psiSkill]]
* [[Melee Accuracy|melee]] (not visible)

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the soldier name.
| ''required''
|-
| '''minStats'''
| Minimum values used to generate the soldier's [[Starting Stats]]. In this case, ''psiSkill'' is treated as the initial stat (not generated).
| -
|-
| '''maxStats'''
| Maximum values used to generate the soldier's [[Starting Stats]]. In this case, ''psiSkill'' is treated as the minimum value for the first month of psi training (actual value is 100%-150%).
| -
|-
| '''statCaps'''
| Maximum stats this soldier can gain through [[Experience]]. '''NOTE:''' A stat will still go over the limit once, and then will no longer increase (see [[Experience#Regarding Caps|Regarding Caps]]).
| -
|-
| '''armor'''
| String ID of the [[#Armor|armor]] this soldier uses by default.
| -
|-
| '''standHeight'''
| Height of this soldier when standing.
| 0
|-
| '''kneelHeight'''
| Height of this soldier when kneeling.
| 0
|-
| '''floatHeight'''
| Distance between the bottom of this unit and the ground.
| 0
|-
| '''femaleFrequency'''
| The probability that a female soldier is hired.
| 50
|}

=== AI Units (Aliens/Civilians) ===

Defines an [[Alien Life Forms|alien]] (enemy) or [[civilian]] (neutral) unit, listed in ''"units:"''. Every different alien rank is a different unit, since they have completely different stats. Unit stats are represented as follows:
* [[Time Units|tu]]
* [[Energy|stamina]]
* [[Health|health]]
* [[Bravery|bravery]] (always a multiple of 10)
* [[Reactions|reactions]]
* [[Firing Accuracy|firing]]
* [[Throwing Accuracy|throwing]]
* [[Strength|strength]]
* [[Psi Strength|psiStrength]]
* [[Psi Skill|psiSkill]]
* [[Melee Accuracy|melee]] (not visible)

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the unit name.
| ''required''
|-
| '''race'''
| String ID of the unit race (for alien units).
| -
|-
| '''rank'''
| String ID of the unit rank (for alien units).
| -
|-
| '''stats'''
| Battlescape stats of this unit.
| -
|-
| '''armor'''
| String ID of the [[#Armor|armor]] this unit uses by default.
| -
|-
| '''standHeight'''
| Height of this unit when standing.
| 0
|-
| '''floatHeight'''
| Distance between the bottom of this unit and the ground.
| 0
|-
| '''value'''
| [[Score]] this unit is worth.
| 0
|-
| '''deathSound'''
| Sound ID from [[#Extra_Sounds|BATTLE.CAT]] played when this unit dies.
| -1
|-
| '''aggroSound'''
| Sound ID from [[#Extra_Sounds|BATTLE.CAT]] played when this unit aggros.
| -1
|-
| '''moveSound'''
| Sound ID from [[#Extra_Sounds|BATTLE.CAT]] played when this unit moves.
| -1
|-
| '''intelligence'''
| Intelligence of this unit's AI. The higher the value, the longer this unit remembers player troops between turns.
| 0
|-
| '''aggression'''
| Aggression of this unit's AI. The higher the value, the more ruthless the unit, the more likely to make a frontal assault. Less aggressive units tend to set up ambushes.
Vanilla values are:
* 0 = mostly passive
* 1 = balanced
* 2 = mostly aggresive
| 0
|-
| '''energyRecovery'''
| Energy recovered by the unit each turn (needs verification)
| 40 (?)
|-
| '''specab'''
| Special ability of this unit:
* 0 = None
* 1 = [[Cyberdisc|Explodes on Death]]
* 2 = [[Bio-Drone|Burns Floor]]
* 3 = Burns Floor and explodes on Death
| 0
|-
| '''spawnUnit'''
| String ID of the unit used to respawn on death (eg. [[Zombie]]s respawn as [[Chrysallid]]s).
| -
|-
| '''livingWeapon'''
| Is this unit a living weapon? (only attacks with a '''fixedWeapon''')
| false
|-
| '''female'''
| Is this unit a female? (used for TFTD civilian types)
| false
|-
|}

=== Alien Races ===

Defines a [[Alien Life Forms|race]] used in [[Alien Missions]], listed in ''"alienRaces:"''. Heavily tied with deployment data.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''id'''
| String ID of the alien race name.
| ''required''
|-
| '''members'''
| Alien crew associated with this alien race (eg. race units + terrorist units), defined by a list of unit string IDs. Order here will define rank in terms of deployment. generally speaking the order is:
* 0 - Commander
* 1 - Leader
* 2 - Engineer
* 3 - Medic
* 4 - Navigator
* 5 - Soldier
* 6 - Terrorist 1
* 7 - Terrorist 2
but of course, not all races have all ranks, so the "fill in" rank would be listed multiple times (see ethereals).
| -
|-
| '''retaliation'''
| retaliation enables/disables the race for retaliation missions.
| ''True''
|-
|}

=== Alien Deployments ===

Defines a Battlescape deployment data used in [[Alien Missions]] (such as alien and map configurations), listed in ''"alienDeployments:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the deployment name.
| ''required''
|-
| '''width'''
| Width of the Battlescape map in grid units.
| 0
|-
| '''length'''
| Length of the Battlescape map in grid units.
| 0
|-
| '''height'''
| Vertical height of the Battlescape map in grid units.
| 0
|-
| '''terrains'''
| list of string IDs of the [[#Terrains|terrain]] to choose from to generate this map. This is not used for UFO sites where the terrain comes from the Geoscape.
| -
|-
| '''shade'''
| Shade of the map (0-15, where 0 is full daytime and 15 is full nighttime). This is not used for UFO sites where the shade comes from the Geoscape.
| 0
|-
| '''nextStage'''
| String ID of the next deployment stage to use after this one, for multi-stage missions.
| -
|-
| '''data'''
| List of deployment data for each alien rank on this mission (see below).
| -
|}

Notes:
* '''terrains''' can also be used with UFOs, with the game using instead the listed terrain rather than the location of the UFO on Geoscape.
==== Deployment Data ====

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''alienRank'''
| [[Alien Rank|Rank]] associated with this deployment data, as defined by the order of the race in question (see above)
| ''required''
|-
| '''lowQty'''
| Maximum quantity of aliens to spawn (beginner).
| 0
|-
| '''highQty'''
| Maximum quantity of aliens to spawn (superhuman).
| 0
|-
| '''dQty'''
| Minimum Desired Quantity of aliens to spawn.
| 0
|-
| '''extraQty'''
| spawns a random number of additional aliens.
| 0
|-
| '''percentageOutsideUfo'''
| Percentage (0-100%) of aliens to spawn outside in UFO sites.
| 0
|-
| '''itemSets'''
| Three lists (one for each alien technology level) of [[#Items|items]] (string IDs) for the aliens to equip.
| ''required''
|-
|}

=== Research ===

Defines a [[Research|research topic]] that X-COM scientists can investigate, listed in ''"research:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''name'''
| String ID of the research project's name (or item, if a '''lookup''' is defined).
| ''required''
|-
| '''lookup'''
| String ID of the research project's display name and UFOPaedia article reference.
| -
|-
| '''cost'''
| Number of man hours (on average) required to complete this project.
| 0
|-
| '''points'''
| [[Score]] earned for completing this project.
| 0
|-
| '''needItem'''
| Does this project require an [[#Items|item]] of the same name?
| false
|-
| '''dependencies'''
| List of research projects that can unlock access to this one. If the full list is researched, or if one of the projects on the list "unlocks" this one, it becomes available.
| -
|-
| '''unlocks'''
| List of research projects unlocked, regardless of other dependencies, but not requirements, by completing this project (for example, any live alien unlocks "alien origins").
| -
|-
| '''requires'''
| List of research projects unilaterally required before this project can be unlocked (for example, "the martian solution" will not even be considered for unlocking until AFTER "alien origins" is completed).
| -
|-
| '''getOneFree'''
| List of "bonus" research projects that may be granted when completing this project (for example, alien medics will give you information on other alien races). Only applies to living aliens.
| -
|-
|}

=== Manufacture ===

Defines a [[Manufacture|manufacture project]] that X-COM engineers can produce, listed in ''"manufacture:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''name'''
| String ID of the manufacturing project's name (and the item it produces).
| ''required''
|-
| '''category'''
| String ID of the manufacturing project's category.
| -
|-
| '''requires'''
| List of [[#Research|topics]] (string IDs) that must be researched to unlock this project. If none are specified, this project is unlocked from the start.
| -
|-
| '''space'''
| Amount of [[Workshop]] space required to begin this project.
| 0
|-
| '''time'''
| Number of man hours (on average) required per item.
| 0
|-
| '''cost'''
| Monetary deduction per item manufactured.
| 0
|-
| '''requiredItems'''
| List of [[#Items|items]] required and consumed per item manufactured.
| -
|-
| '''producedItems'''
| List of [[#Items|items]] produced per each item consumed. If not specified, defaults to 1 item with the same string ID as the manufacture.
| 1
|-
|}

=== UFOpaedia Article ===

Defines an article in the in-game [[UFOpaedia]], listed in ''"ufopaedia:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''id'''
| String ID of the article name. This must match the ID of the object associated with this article, if applicable.
| ''required''
|-
| '''title'''
| String ID of the article title. If omitted, the '''id''' is used.
| -
|-
| '''type_id'''
| Type of this article:
* 0 = Unknown
* 1 = [[Craft]]
* 2 = [[Craft Armaments]]
* 3 = [[HWP]]
* 4 = [[Equipment (EU)|Equipment]]
* 5 = [[Armour]]
* 6 = [[Base Facilities]]
* 7 = Text & Image (eg. [[Alien Life Forms]], [[UFO Components]])
* 8 = Text (eg. [[Alien Research]])
* 9 = [[UFO]]
| 0
|-
| '''section'''
| String ID of the UFOpaedia section this article belongs in.
| -
|-
| '''requires'''
| List of [[#Research|topics]] (string IDs) that must be researched to unlock this article. If none are specified, this article is unlocked from the start.
| -
|-
| '''image_id'''
| Filename of the [[UP001.SPK-UP042.SPK|background image]] displayed on this article, if applicable.
| -
|-
| '''text'''
| String ID of the description displayed on this article.
| -
|-
| '''text_width'''
| Maximum width of the text displayed, only applicable to ''Text & Image'' articles.
| 0
|-
| '''rect_stats'''
| Rectangle ('''x''', '''y''', '''width''', '''height''') of the stats text on the screen, only applicable to ''Craft'' articles.
| 0
|-
| '''rect_text'''
| Rectangle ('''x''', '''y''', '''width''', '''height''') of the description text on the screen, only applicable to ''Craft'' articles.
| 0
|-
| '''weapon'''
| String ID of the weapon, only applicable to ''HWP'' articles.
| -
|}

=== UFO Trajectories ===

Defines a trajectory carried out by an UFO during an [[#Alien Missions|alien mission]], listed in ''"ufoTrajectories:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''id'''
| String ID of the trajectory name.
| ''required''
|-
| '''groundTimer'''
| Amount of seconds for the UFO to spend on Ground waypoints.
| 0
|-
| '''waypoints'''
| List of waypoints for the UFO to traverse, defined as ''[zone, altitude, speed]''. 
'''zone''': Globe zone where the waypoint is located. 
'''altitude''': UFO altitude after reaching this waypoint:
* 0 - Ground
* 1 - Very Low
* 2 - Low
* 3 - High
* 4 - Very High
'''speed''': UFO speed after reaching this waypoint, as a percentage (0-100%) of its maximum speed.
| -
|}

=== Alien Missions ===

Defines an [[Alien Missions|alien mission]] carried out by UFOs on the Geoscape, listed in ''"alienMissions:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the mission type.
| ''required''
|-
| '''points'''
| [[Score]] allocated to aliens for successfully completing this mission.
| 0
|-
| '''raceWeights'''
| List of alien races likely to carry out this mission, and the % chance of them being allocated to this mission, listed by "number of months after game beginning".
| ''required''
|-
| '''waves'''
| List of UFO waves to spawn as this mission progresses, as described below.
| ''required''
|}

==== Waves ====

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''ufo'''
| String ID of the [[#UFOs|UFO]] to spawn.
| ''required''
|-
| '''count'''
| Number of UFOs to spawn.
| 0
|-
| '''trajectory'''
| String ID of the [[#UFO Trajectories|trajectory]] for this UFO to use when entering Earth's atmosphere.
| ''required''
|-
| '''timer'''
| How long after the previous wave should this wave arrive? (in seconds)
| 0
|-
|}

=== Alien Item Levels ===

This is a list of item level probabilities, with a number between 0 and 2 representing an item level from plasma pistols to heavy plasmas, as defined in the deployments, expressing a 10% probability for that item level being used.

0 = first set (plasma pistol/clip)
1 = second set (plasma rifle/clip)
2 = third set (heavy plasma/clip)

For example:
[ 2, 0, 0, 0, 0, 0, 0, 1, 1, 1 ]
would represent a 60% chance for pistols, 30% rifles, and 10% heavy weapons. 
Note that the order does not matter, but the length DOES. each line MUST have 10 digits.

The above can be confusing. There are 10 fields; each number represents 10%. 
There are six instances of '0'. 6x10% = 60% chance of plasma pistol 
There are three instances of '1'. 3x10% = 30% chance of plasma rifle 
There is only one instance of '2'. 1x10% = 10% chance of heavy plasma 

Each line represents a month after the beginning of the game, and there is no limit to the number defined. 
OpenXCom will use the most recently available item level in the event the game goes on forever.

=== Extra Sprites ===

Adds or replaces sprites in an existing [[Image Formats|X-COM image file]], listed in ''"extraSprites:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| Filename of the original/new image to modify.
| ''required''
|-
| '''width'''
'''height'''
| Size of the sprite(s) in pixels.
| 0
0
|-
| '''singleImage'''
| Is the image file just a single sprite (true) or a spritesheet (false)?
| false
|-
| '''subX'''
'''subY'''
| Size of the subdivision in pixels. If a subdivision is specified, then the image file is divided into chunks to form the sprites (eg. spritesheets).
| 0
0
|-
| '''files'''
| List of the new sprites to add/replace, listed as ''spriteID: filename''.
| -
|}

Example:
- type: GIANTBUNNY.PCK
width: 32
height: 40
files:
0: Resources/Bunny/Bunny00.png
1: Resources/Bunny/Bunny01.bmp
2: Resources/Bunny/Bunny02.gif

=== Extra Sounds ===

Adds or replaces sounds in an existing [[SOUND|X-COM sound file]], listed in ''"extraSounds:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| ID of the original sound file to modify:
* BATTLE.CAT - Battlescape sounds, corresponds to ''SOUND1.CAT'' or ''SAMPLE2.CAT'' (55 sounds).
* INTRO.CAT - Intro sounds, corresponds to ''INTRO.CAT'' or ''SAMPLE3.CAT'', probably best not to mess with these.
* GEO.CAT - Geoscape sounds, corresponds to ''SOUND2.CAT'' or ''SAMPLE.CAT'' (14 sounds).
| ''required''
|-
| '''files'''
| List of the new sounds to add/replace, listed as ''soundID: filename''.
| -
|}

Example:
- type: BATTLE.CAT
files:
55: Resources/Sounds/sample.wav

=== Extra Strings ===

Adds or replaces text strings in an existing [[Translations (OpenXcom)|OpenXcom language file]], listed in ''"extraStrings:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| Filename of the original language file to modify, sans extension.
| ''required''
|-
| '''strings'''
| List of the new strings to add/replace, listed as ''stringID: text''.
| -
|}

Example:
- type: en-US
strings:
STR_SNIPER_RIFLE: Sniper Rifle
STR_SNIPER_RIFLE_CLIP: Sniper Rifle Clip
- type: en-GB
strings:
STR_SNIPER_RIFLE: Sniper Rifle
STR_SNIPER_RIFLE_CLIP: Sniper Rifle Clip
- type: de
strings:
STR_SNIPER_RIFLE: Scharfschützengewehr
STR_SNIPER_RIFLE_CLIP: Scharfschützengewehrmunition
- type: ru
strings:
STR_SNIPER_RIFLE: Снайперская винтовка
STR_SNIPER_RIFLE_CLIP: Магазин к снайп. винтовке

=== Interfaces ===

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| ''?''
| -
|-
| '''elements'''
| ''?''
| -
|-
| '''id'''
| ''?''
| -
|-
| '''color'''
| ''?''
| -
|}

=== StatStrings ===

[[Statstrings]] are used for automatically renaming soldiers. They are case sensitive and they are processed in the order in which they are specified.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''string'''
| String to add to name.
| ''required''
|-
| '''psiStrength''' 
'''psiSkill''' 
'''bravery''' 
'''strength''' 
'''firing''' 
'''reactions''' 
'''stamina''' 
'''tu''' 
'''health''' 
'''throwing'''
| One or more stat ranges are ANDed together for success. Each range has a minVal and maxVal. Use YAML standard tilde (~) to indicate null. ((~) = 0 as minvalue; (~) =255 as maxvalue)
| -
|}

Example:
statStrings:
- string: "x"
psiStrength: [~, 30]
- string: "P"
psiStrength: [80, ~]
- string: "p"
psiStrength: [60, 79]
- string: "K"
psiSkill: [60, ~]
- string: "k"
psiSkill: [30, 59]
- string: "b"
bravery: [60, ~]
- string: "c"
bravery: [~, 10]
- string: "w"
strength: [~, 25]
- string: "Snpr"
firing: [60, ~]
reactions: [60, ~]
- string: "M"
firing: [70, ~]
- string: "m"
firing: [60, 69]
- string: "Sct"
reactions: [50, ~]
tu: [60, ~]
- string: "R"
reactions: [60, ~]
- string: "r"
reactions: [50, 59]

==References==
<references />

[[Category:OpenXcom]]

Ruleset Reference (OpenXcom)

2014-12-04T19:22:12Z

Falko: /* AI Units (Aliens/Civilians) */

A reference of all the customizable values of everything in a [[Rulesets (OpenXcom)|ruleset]]. Some guidelines:
* If a value is omitted from the ruleset, the default is used. You cannot omit ''required'' values.
* Text strings (eg. names) are represented by string IDs from the [[Translations (OpenXcom)|language files]]
* Numerical IDs (used for sprites, sounds, etc.) start at 0, not 1.
* Boolean (yes/no) values are represented by true/false.
* World coordinates are represented in degrees (see [[WORLD.DAT]]).
* Money amounts (prices, costs, etc.) are represented in dollars.
* All paths are '''case sensitive'''! If your ruleset uses external files, make sure that they named properly as described in ruleset.

Items are ordered as they come in the ruleset. To override this, you can specify a ''listOrder''. You can find the default listOrders in [[Ruleset List Order (OpenXcom)|Ruleset List Order]].

=== Globe ===

Defines the drawing of landmasses and borders on the globe.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''data'''
| Path name of file which contains polygon and texture information. (For example WORLD.DAT).
| -
|-
| '''polygons'''
| List of polygons drawn on the globe surface. A triangle consist of seven values: the first number defines the texture, followed by three pairs of (x,y) globe coordinates. Only polygons with 3 or 4 vertices are reliable shown on the globe = 7 or 9 values per entry.
| -
|-
| '''polylines'''
| List of border lines. Each list entry consist of a list of (x,y) globe coordinates.
| -
|}

=== Countries ===

Defines one of the [[Country Funding (EU)|funding nations]], listed in ''"countries:"''. They're used for activity graphs and player scoring.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the country name.
| ''required''
|-
| '''fundingBase'''
| Country's base funding, in thousands. The starting funding can be anywhere between 1x and 2x the base funding.
| 0
|-
| '''fundingCap'''
| Country's funding cap, in thousands. Once a country reaches this maximum, it will no longer increase its funding.
| 0
|-
| '''labelLon'''
'''labelLat'''
| Longitude and latitude coordinates of the country's label on the globe. This label is only shown when the globe is zoomed in and "detail" is turned on.
| 0.0
0.0
|-
| '''areas'''
| List of "rectangles" on the globe defined as [''lon1'' ''lat1'' ''lon2'' ''lat2'']. Any activity within these areas counts towards the country's graph activity and affects their opinion of the player.
| -
|}

=== Regions ===

Defines one of the [[Geoscape (EU)#World Regions/Countries|world regions]], listed in ''"regions:"''. They're used for base placement, activity graphs and mission spawning.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the region name.
| ''required''
|-
| '''cost'''
| Amount of money spent building an X-COM base in this region (first base is free).
| 0
|-
| '''areas'''
| List of "rectangles" on the globe defined as ''[lon1, lat1, lon2, lat2]''. Any activity within these areas counts towards the region's graph activity.
| -
|-
| '''cities'''
| List of cities belonging to this region. They will be displayed on the globe and used for terror site missions. Each city is defined by their '''lon''' and '''lat''' coordinates and a '''name''' string ID.
| -
|-
| '''regionWeight'''
| Weight of this region when selecting regions for alien missions.
| 0
|-
| '''missionWeights'''
| Weighted list of the different mission types for this region (eg. ''STR_ALIEN_RESEARCH: 14'').
| -
|-
| '''missionZones'''
| List of "rectangles" (''[lon1, lat1, lon2, lat2]'') defining the mission zones for this region. Mission zones are waypoints for UFO trajectories.
| -
|-
| '''missionRegion'''
| Spawn mission in this region instead (used for regions without land).
| -
|}

=== Base Facilities ===

Defines one of the [[Base Facilities (EU)|facilities]] that can be built in an X-COM base, listed in ''"facilities:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the facility name.
| ''required''
|-
| '''requires'''
| List of [[#Research|topics]] (string IDs) that must be researched to unlock this facility. If none are specified, this facility is unlocked from the start.
| -
|-
| '''spriteShape'''
| Sprite ID from [[BASEBITS.PCK]] used to draw the facility's outer shape in the Basescape and UFOpaedia.
| -1
|-
| '''spriteFacility'''
| Sprite ID from [[BASEBITS.PCK]] used to draw the facility's contents in the Basescape and UFOpaedia. Drawn on top of '''spriteShape'''.
| -1
|-
| '''lift'''
| Is this facility an [[Access Lift]]? All base facilities must be connected to the lift.
| false
|-
| '''hyper'''
| Is this facility a [[Hyperwave Decoder]]? Displays extra information for detected UFOs. Only valid for radar facilities.
| false
|-
| '''mind'''
| Is this facility a [[Mind Shield]]? Reduces the chance of UFOs finding your base. Does not stack.
| false
|-
| '''grav'''
| Is this facility a [[Grav Shield]]? Doubles the power of your base defenses. Does not stack.
| false
|-
| '''size'''
| Size of the facility, in grid units. Every facility is square, so a size of 1 means 1x1, 2 means 2x2, etc. Bigger facilities are made up of multiple sprites, for example a 2x2 facility will use 4 sprites for '''spriteShape''' and 4 sprites for '''spriteFacility''' (top-left, top-right, bottom-left, bottom-right).
| 1
|-
| '''buildCost'''
| Amount of money spent to build this facility in the base.
| 0
|-
| '''buildTime'''
| Amount of days it takes for this facility to be built.
| 0
|-
| '''monthlyCost'''
| Amount of money spent monthly for the maintenance of this facility.
| 0
|-
| '''storage'''
| Amount of storage space (for items) this facility provides. See [[Base Stores]].
| 0
|-
| '''personnel'''
| Amount of personnel (soldiers, scientsts, engineers) these quarters can contain.
| 0
|-
| '''aliens'''
| Amount of live aliens this facility can contain. Only checked if the ''alienContainmentLimitEnforced'' option is enabled.
| 0
|-
| '''crafts'''
| Amount of X-COM craft this facility can contain.
| 0
|-
| '''labs'''
| Amount of lab space this facility provides for research projects.
| 0
|-
| '''workshops'''
| Amount of workshop space this facility provides for manufacture projects.
| 0
|-
| '''psiLabs'''
| Amount of soldier space this facility provides for psionic training.
| 0
|-
| '''radarRange'''
| Maximum radar detection range of this facility, in nautical miles.
| 0
|-
| '''radarChance'''
| Chance (0-100%) of this radar detecting a UFO that enters its range.
| 0
|-
| '''defense'''
| Offensive power provided by this base defense against attacking UFOs.
| 0
|-
| '''hitRatio'''
| Chance (0-100) of the base defense hitting an attacking UFO.
| 0
|-
| '''fireSound'''
| Sound ID from [[#Extra_Sounds|GEO.CAT]] played when the base defense fires.
| -1
|-
| '''hitSound'''
| Sound ID from [[#Extra_Sounds|GEO.CAT]] played when the base defense hits a target.
| -1
|-
| '''mapName'''
| [[MAPS|Map]] associated to this facility in Battlescape base defenses.
| -
|-
|}

=== Crafts ===

Defines one of the [[Craft|X-COM crafts]] that go on interception missions, listed in ''"crafts:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the craft name.
| ''required''
|-
| '''requires'''
| List of [[#Research|topics]] (string IDs) that must be researched to unlock this craft. If none are specified, this craft is unlocked from the start.
| -
|-
| '''sprite'''
| Sprite ID from [[BASEBITS.PCK]] used to draw this craft in the Basescape and from [[INTICON.PCK]] used to draw the damage indicator in dogfights.
modders: the corresponding extrasprite file id for BASEBITS.PCK is sprite+33 INTICON.PCK contains a minimized icon id=sprite the file id for the dogfight image is sprite+11
| -1
|-
| '''fuelMax'''
| Maximum amount of fuel this craft can carry. Crafts use up fuel based on their speed while travelling.
| 0
|-
| '''damageMax'''
| Maximum amount of damage this craft can take. If this amount is exceeded, the craft is destroyed.
| 0
|-
| '''speedMax'''
| Maximum speed in nautical miles. Crafts travel at max speed when flying and half speed when patrolling.
| 0
|-
| '''accel'''
| Aceeleration value shown in the UFOpaedia.
| 0
|-
| '''weapons'''
| Amount of craft weapons this craft can equip. The UI can only display a max of 2 weapons.
| 0
|-
| '''soldiers'''
| Amount of soldiers this craft can carry.
| 0
|-
| '''maxItems'''
| Amount of items this craft can carry.
| 80
|-
| '''vehicles'''
| Amount of vehicles this craft can carry.
| 0
|-
| '''costBuy'''
| Amount of money spent for purchasing this craft. If set to 0, the craft will not be available in the Purchase/Recruit screen.
| 0
|-
| '''costRent'''
| Amount of money spent monthly for renting this craft. If set to 0, the craft is not on rental and won't count towards base maintenance.
| 0
|-
| '''costSell'''
| Amount of money gained for selling this craft.
| 0
|-
| '''refuelItem'''
| Item required for refuelling this craft. If no item is specified, the craft uses human fuel.
| 0
|-
| '''repairRate'''
| Amount of damage restored every hour while [[Repairs|Repairing]] in base.
| 1
|-
| '''refuelRate'''
| Amount of fuel restored every 30 mins while [[Refueling]] in base. If specified, a '''refuelItem''' is spent each time.
| 1
|-
| '''radarRange'''
| Detection range of the craft's radar in nautical miles. Every craft radar has a 100% detection chance.
| 600
|-
| '''transferTime'''
| Number of hours it takes to purchase/transfer this craft to a base.
| 0
|-
| '''score'''
| [[Score]] lost when this craft is destroyed.
| 0
|-
| '''spacecraft'''
| Can this craft go to [[Cydonia]]?
| false
|-
| '''battlescapeTerrainData'''
| [[#Terrains|Terrain]] associated to this craft in Battlescape missions.
| -
|}

=== Craft Weapons ===

Defines one of the [[Craft Armaments|weapons]] equipped by X-COM craft for shooting down UFOs, listed in ''"craftWeapons:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the weapon name.
| ''required''
|-
| '''sprite'''
| Sprite ID from [[BASEBITS.PCK]] used to draw the weapon in the Basescape and from [[INTICON.PCK]] used to draw the weapon in dogfights.
modders: the corresponding extrasprites file id for INTICON.PCK is sprite+5 and sprite+48 for BASEBITS.PCK
| -1
|-
| '''sound'''
| Sound ID from [[#Extra_Sounds|GEO.CAT]] played when this weapon fires.
| -1
|-
| '''damage'''
| Amount of damage this weapon does to enemy UFOs.
| 0
|-
| '''range'''
| Maximum range of this weapon in dogfights (in meters).
| 0
|-
| '''accuracy'''
| Chance (0-100%) of each shot hitting the enemy UFO.
| 0
|-
| '''reloadCautious'''
| Time this weapon takes to fire between each shot in ''Cautious Mode''.
| 0
|-
| '''reloadStandard'''
| Time this weapon takes to fire between each shot in ''Standard Mode''.
| 0
|-
| '''reloadAggressive'''
| Time this weapon takes to fire between each shot in ''Aggressive Mode''.
| 0
|-
| '''ammoMax'''
| Maximum amount of ammo this weapon can carry.
| 0
|-
| '''rearmRate'''
| Amount of ammo restored every 30 mins while the craft is [[Rearming]] in base. If specified, '''clip'''s are spent depending on their '''clipSize'''. If the '''clipSize''' of the specified ammo is 0, no '''clip'''s are spent.
| 1
|-
| '''projectileType'''
| Type of the weapon projectile, used for the projectile sprite in dogfights:
* 0 - [[Stingray]]
* 1 - [[Avalanche]]
* 2 - [[Cannon]]
* 3 - [[Fusion Ball]]
* 4 - [[Laser Cannon]]
* 5 - [[Plasma Beam]]
| 2
|-
| '''projectileSpeed'''
| Speed of the weapon projectile in dogfights.
| 0
|-
| '''launcher'''
| String ID of the [[#Items|item]] required to equip this weapon.
| -
|-
| '''clip'''
| String ID of the [[#Items|item]] required to rearm this weapon.
| -
|}

=== Items ===

Defines the Geoscape and Battlescape properties of an [[Equipment (EU)|item]] that can be stored in X-COM bases, listed in ''"items:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the internal item name.
| ''required''
|-
| '''name'''
| String ID of the displayed item name, for cases where it's different from the internal name. If omitted, '''type''' is used.
| -
|-
| '''requires'''
| List of [[#Research|topics]] (string IDs) that must be researched to unlock this item. If none are specified, this item is unlocked from the start. Soldiers can only use unlocked items in the Battlescape.
| -
|-
| '''size'''
| Space occupied by this item in [[Base Stores]]. Can be a decimal value.
| 0.0
|-
| '''costBuy'''
| Amount of money spent for purchasing this item. If set to 0, this item will not be available in the Purchase/Recruit screen.
| 0
|-
| '''costSell'''
| Amount of money gained for selling this item.
| 0
|-
| '''transferTime'''
| Number of hours it takes to purchase/transfer this item to a base.
| 24
|-
| '''weight'''
| [[Item_Weight|Weight]] occupied by this item in a soldier's inventory.
| 999
|-
| '''bigSprite'''
| Sprite ID from [[BIGOBS.PCK]] used to draw this item in a soldier's inventory and UFOpaedia.
| -1
|-
| '''floorSprite'''
| Sprite ID from [[FLOOROB.PCK]] used to draw this item on the floor of a Battlescape tile.
| -1
|-
| '''handSprite'''
| Sprite ID from [[HANDOB.PCK]] used to draw this item on a soldier's hand in the Battlescape.
modders: each handobject needs 8 images (8 directions) define the extrasprites accordingly
| 120
|-
| '''bulletSprite'''
| Sprite ID from ''BulletSprites.png'' used to draw this weapon's projectile on the Battlescape:
* 0 - [[Rocket Launcher]]
* 1 - [[Pistol]]
* 2 - [[Rifle]]
* 3 - [[Auto Cannon]]
* 4 - [[Heavy Cannon]]
* 5 - [[Laser Pistol]]
* 6 - [[Laser Rifle]]
* 7 - [[Heavy Laser]]
* 8 - [[Plasma Rifle|Plasma]]
* 9 - [[Small Launcher]]
* 10 - [[Blaster Launcher]]
for modders: the bulletsprite needs to be put into the extraSprites type "Projectiles" the bulletsprite can contain up to 35 3x3 images. The corresponding file id is 35*[bulletSprite]
| -1
|-
| '''fireSound'''
| Sound ID from [[#Extra_Sounds|BATTLE.CAT]] played when this weapon fires.
| -1
|-
| '''hitSound'''
| Sound ID from [[#Extra_Sounds|BATTLE.CAT]] played when this weapon hits a target.
| -1
|-
| '''hitAnimation'''
| Sprite ID from [[SMOKE.PCK]] used to draw the weapon's "hit explosion".
'''NOTE''': Do not define this value for melee/psi weapons, they use [[HIT.PCK]] and therefore meleeAnimation instead.
| 0
|-
| '''power'''
| Average damage of the weapon, in most cases it will be +-50% this value.
| 0
|-
| '''strengthApplied'''
| Add the attacking unit's strength to this weapon's damage.
| false
|-
| '''compatibleAmmo'''
| List of string IDs of the ammo items that can be loaded on this weapon. If none are specified, the weapon doesn't need ammo.
| -
|-
| '''damageType'''
| What type of [[damage]] does this weapon do:
* 0 - None
* 1 - Armor Piercing
* 2 - Incendiary
* 3 - High Explosive
* 4 - Laser
* 5 - Plasma
* 6 - Stun
* 7 - Melee
* 8 - Acid
* 9 - Smoke
'''NOTE:''' A damage type other than 0-9 will do nothing.
| 0
|-
| '''tuAuto'''
'''accuracyAuto'''
| The percentage (0-100%) of [[Time Units]] (from the soldier's total) required to fire an Auto Shot. If 0, the weapon does not have an Auto Shot.
The base accuracy (0-100%) applied to a soldier's [[Firing Accuracy]] when firing an Auto Shot.
| 0
0
|-
| '''tuSnap'''
'''accuracySnap'''
| The percentage (0-100%) of [[Time Units]] (from the soldier's total) required to fire a Snap Shot. If 0, the weapon does not have a Snap Shot.
The base accuracy (0-100%) applied to a soldier's [[Firing Accuracy]] when firing a Snap Shot.
| 0
0
|-
| '''tuAimed'''
'''accuracyAimed'''
| The percentage (0-100%) of [[Time Units]] (from the soldier's total) required to fire an Aimed Shot. If 0, the weapon does not have an Aimed Shot.
The base accuracy (0-100%) applied to a soldier's [[Firing Accuracy]] when firing an Aimed Shot.
| 0
0
|-
|-
| '''tuMelee'''
'''accuracyMelee'''
| The percentage (0-100%) of [[Time Units]] (from the soldier's total) required to do a melee attack (Hit). If 0, the weapon does not have a melee attack.
The base accuracy (0-100%) applied to a soldier's [[Melee Accuracy]] when doing a melee attack.
| 0
0
|-
| '''clipSize'''
| The amount of ammo stored in each weapon clip. If -1 is specified, this weapon has infinite ammo.
| 0
|-
| '''battleType'''
| Defines the weapon's behavior in the Battlescape:
* 0 - None (Geoscape-only item)
* 1 - [[Weapons|Firearm]]
* 2 - Ammo
* 3 - Melee
* 4 - [[Grenade]]
* 5 - [[Proximity Grenade]]
* 6 - [[Medi-Kit (EU)|Medi-Kit]]
* 7 - [[Motion Scanner]]
* 8 - [[Mind Probe]]
* 9 - [[Psi-Amp]]
* 10 - [[Electro-flare]]
* 11 - Corpse
| 0
|-
| '''twoHanded'''
| Is this weapon two-handed? If true, incurs an accuracy penalty if used with both hands occupied. Note that the handsprite of a twoHanded item is also drawn at a slightly different position than a one handed item.
| false
|-
| '''waypoint'''
| Does this weapon use waypoints? (eg. [[Blaster Launcher]]). Can also be used to make ammo items use the waypoint system.
| false
|-
| '''fixedWeapon'''
| Is this weapon fixed? (it's part of a unit, eg. tanks and terrorist units)
| false
|-
| '''invWidth'''
| Item width in a soldier's inventory (in grid units).
| 1
|-
| '''invHeight'''
| Item height in a soldier's inventory (in grid units).
| 1
|-
| '''painKiller'''
| Amount of painkillers contained in a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''heal'''
| Amount of heal's contained in a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''stimulant'''
| Amount of stimulants contained in a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''woundRecovery'''
| Amount of [[Fatal Wounds]] treated by each heal of a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''healthRecovery'''
| Amount of [[Health]] recovered by each heal of a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''stunRecovery'''
| Amount of [[Stun]] removed by each stimulant of a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''energyRecovery'''
| Amount of [[Energy]] recovered by each stimulant of a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''tuUse'''
| Amount of [[Time Units]] required to use this item (for non-offensive items). It's a flat rate if '''flatRate''' is true, otherwise it's a percentage (0-100%).
| 0
|-
| '''recoveryPoints'''
| [[Score]] gained for recovering this alien artifact.
| 0
|-
| '''armor'''
| How much damage is needed to destroy this item on the ground.
| 20
|-
| '''recover'''
| Is this item recoverable? (gets transported to the X-COM base on mission success)
| true
|-
| '''turretType'''
| Sprite ID from [[TANKS.PCK]] of the turret to assign to this tank:
* 0 - [[Tank/Cannon]]
* 1 - [[Tank/Rocket Launcher]]
* 2 - [[Tank/Laser Cannon]]
* 3 - [[Hovertank/Plasma]]
* 4 - [[Hovertank/Launcher]]
| -1
|-
| '''liveAlien'''
| Does this item represent a live alien? (counts towards [[Alien Containment]])
| false
|-
| '''blastRadius'''
| Size of the projectile explosions. 0 for no explosion. -1 to automatically calculate based on weapon power and damage type (actual '''blastRadius''' currently is capped due [[Explosions#Playing_With_Fire|Explosion calculations]]).
| -1
|-
| '''flatRate'''
| If true, then TU costs for this weapon are a flat rate (instead of a percentage of unit TUs).
| false
|-
| '''arcingShot'''
| Does this weapon fire in an arc?
| false
|-
| '''attraction'''
| Represents how likely an alien is to pick up this item. Values below 5 will be ignored (by design).
| 0
|-
| '''maxRange'''
| Maximum range at which this weapon can operate.
| 200
|-
| '''aimRange'''
| Maximum effective range with this weapon before which range-based dropoff occurs.
| 200
|-
| '''snapRange'''
| Maximum effective range with snap shot before which range-based dropoff occurs. (ufoextender accuracy only)
| 15
|-
| '''autoRange'''
| Maximum effective range with auto shot before which range-based dropoff occurs. (ufoextender accuracy only)
| 7
|-
| '''minRange'''
| Range-based dropoff will work in reverse for ranges below this.
| 0
|-
| '''dropoff'''
| The value by which the accuracy lowers for each tile after (or before) the thresholds above.
| 2
|-
| '''bulletSpeed'''
| How much faster (or slower, if you use a negative number) is a projectile fired from this weapon compared to the average.
| 0
|-
| '''autoShots'''
| How many auto shots does this weapon fire.
| 3
|-
| '''shotgunPellets'''
| Number of projectiles fired per unit of ammunition. (note: due to engine limitations it is currently impossible to draw multiple projectiles in flight.)
| 0
|-
| '''zombieUnit'''
| String ID of the unit used for zombification (eg. [[Chrysallid]]s turn units into [[Zombie]]s).
| none
|-
| '''meleeSound'''
| Sound ID from [[#Extra_Sounds|BATTLE.CAT]] played when this weapon attacks a target with melee.
| 39
|-
| '''meleeHitSound'''
| Sound ID from [[#Extra_Sounds|BATTLE.CAT]] played when this weapon HITS a target with melee.
| -1
|-
| '''meleeAnimation'''
| Sprite ID from HIT.PCK played when this weapon attacks a target with melee.
| 0
|-
| '''meleePower'''
| Damage this weapon will do when using melee. This only applies to Firearms, and is only available as stun damage. For normal melee weapons, use regular power and damage types.
| 0
|-
| '''LOSRequired'''
| Does this item require line of sight? (only applies to mind probes and psi-amps)
| false
|-
| '''skillApplied'''
| Is melee skill applied to the accuracy of an attack made with this object?
| true
|-
|}

=== UFOs ===

Defines one of the [[UFOs]] that invade Earth, listed in ''"ufos:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the UFO name.
| ''required''
|-
| '''size'''
| String ID of the UFO size.
| STR_VERY_SMALL
|-
| '''sprite'''
| Sprite ID from [[INTERWIN.DAT]] used to draw this UFO in the dogfight view and UFOpaedia.
don't try to add more images if you don't want to punch yourself in the face - use modsprite
| -1
|-
| '''modSprite'''
| Filename used to draw this UFO in the dogfight view and UFOpaedia.
| -
|-
| '''damageMax'''
| Maximum amount of damage this UFO can take. If the UFO takes 50% damage, it crash lands. If it takes 100% damage, it is destroyed.
| 0
|-
| '''speedMax'''
| Maximum speed in nautical miles.
| 0
|-
| '''accel'''
| Aceeleration value shown in the UFOpaedia.
| 0
|-
| '''power'''
| Damage power of this UFO's weapon in dogfights.
| 0
|-
| '''range'''
| Maximum range of this UFO's weapon in dogfights (in meters).
| 0
|-
| '''score'''
| [[Score]] gained when this UFO is destroyed, or half this score if it crash lands.
| 0
|-
| '''reload'''
| Time the UFO's weapon takes to fire between each shot.
| 0
|-
| '''breakOffTime'''
| Minimum amount of time for the UFO to be able to break off of a dogfight.
| 0
|-
| '''battlescapeTerrainData'''
| [[#Terrains|Terrain]] associated to this UFO in Battlescape missions.
| ''required''
|-
|}

=== Inventory Sections ===

Defines one of the sections of the [[Inventory TU Table|Battlescape inventory]] (eg. Backpack), listed in ''"invs:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the inventory name.
| ''required''
|-
| '''x'''
'''y'''
| Pixel coordinates of this section on the inventory screen.
| 0
0
|-
| '''type'''
| Type of this section:
* 0 = Slot section, can contain as many items as will fit on the slots.
* 1 = Hand section, can only contain one item regardless of size.
* 2 = Ground section, can contain infinite items.
| 0
|-
| '''slots'''
| List of the grid slots (''[x, y]'') that this section is composed of. For example, to make a 2x2 section, you would have ''[0, 0] [0, 1] [1, 0] [1, 1]''.
| -
|-
| '''costs'''
| List of [[Time Units]] costs to move an item from this section to another one (eg. ''STR_BACKPACK: 16'' means it will cost 16 TUs to move an item from this section to the Backpack).
| -
|-
|}

=== Terrains ===

Defines one of the [[TERRAIN|terrains]] used to generate a Battlescape map, listed in "terrains:".

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''name'''
| String ID of the terrain name.
| ''required''
|-
| '''largeBlockLimit'''
| Maximum amount of large blocks that can be used on map generation.
| 0
|-
| '''textures'''
| List of [[TEXTURE.DAT|Geoscape textures]] that correspond to this terrain.
| -
|-
| '''hemisphere'''
| Geoscape hemisphere associated with this terrain:
* -1 - Northern hemisphere.
* 0 - Both hemispheres.
* 1 - Southern hemisphere.
| 0
|-
| '''mapDataSets'''
| List of filenames (each with matching [[MCD]]/[[Image Formats#PCK|PCK/TAB]] files) that contain the tiles of this terrain.
| -
|-
| '''mapBlocks'''
| List of map blocks (see below) that are used for generating a map.
| -
|-
| '''roadTypeOdds'''
| Odds as a % of generating each type of road (E-W Road, N-S Road, Crossing) odds for crossing are: 100 - EW - NS.
| [0 0]
|-|-
| '''civilianTypes'''
| List of units to use as civilians for this mission.
| [MALE_CIVILIAN, FEMALE_CIVILIAN]
|-
|}

==== Map Blocks ====

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''name'''
| Filename of the [[MAPS|map]].
| ''required''
|-
| '''width'''
| Width of this map block in Battlescape grid units.
| 0
|-
| '''length'''
| Length of this map block in Battlescape grid units.
| 0
|-
| '''height'''
| Height of this map block in Battlescape grid units.
| 1
|-
| '''type'''
| Type of this map block:
* -1 - Undefined
* 0 - Default
* 1 - Landing Zone (for placing X-COM / alien craft)
* 2 - E-W Road (for city maps)
* 3 - N-S Road (for city maps)
* 4 - Road Crossing (for city maps)
* 5 - Dirt (for filling empty base blocks)
* 6 - X-COM spawn point (for [[Alien Base]] / [[Cydonia]] missions)
* 7 - [[Alien Base]] Target
* 8 - [[Cydonia]] Target
| -1
|-
| '''subType'''
| Sub-type of this map block (see '''type''').
| -1
|-
| '''frequency'''
| Frequency of this block in a map.
| 1
|-
| '''maxCount'''
| Maximum amount of times this block can be used in a map. If -1 there is no limit.
| -1
|-
| '''items'''
| An array of items to add to this mapblock, an the positions to place them at.
| -1
|}

*'''frequency''' defines the odds of the map appearing on the map
** The value assigned (default: 1) is used in ''x/n'', which defines the probability of being chosen.
** ''x'' is the integer defined for the map block's frequency and ''n'' is the combined total of probabilities for all the map types combined.
** This property can only be used in type 0 map blocks.
*'''maxCount''' is the maximum number of times it can be used.
** The value assigned is also used in ''x/n'' to determine the probability of being chosen.
** Each use reduces ''x'' by -1, with the caveat that being used as a Landing Zone type will not reduce the x value since it could result in no available Landing Zones.
** This property can only be used in type 0 map blocks.
* '''hemisphere''' only applies to UFO missions, not Terror ones.
*'''width/length''' defines the size of the map
** be aware that the mapview "width"-label is the openxcom ruleset length parameter
** be aware that the mapview "length"-label is the openxcom ruleset width parameter

==== Guidelines/Tips ====
* All maps with an XCOM/Alien craft require at least one type 1 map block. This map block can only contain ground tiles (no walls or objects), otherwise the game will crash or the walls/objects will be removed.
* All Terror terrains (listed under STR_TERROR_MISSION) require at least 1 map block of '''Types''' 2, 3 and 4 (for a total of 3 maps, which are required to place roads) and the corresponding '''roadTypeOdds''' added to the ruleset.
* If there isn't any map blocks designed as roads since you want to keep your terrain 'random', this can be circumvented by designating all 10x10 map blocks, excluding the one(s) used for the XCOM craft, as either '''Type''' 2, 3 and 4 and by defining their '''subType''' to 0. The game will then randomly choose between the map blocks for each type used in the roads, making them map more random.

=== Armor ===

Defines a Battlescape unit's [[armor]] as well as visual representation (so every unit has an armor), listed in ''"armors:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the armor name.
| ''required''
|-
| '''spriteSheet'''
| Sprite sheet from [[UNITS]] used to draw a unit wearing this armor.
| -
|-
| '''spriteInv'''
| Sprite used for the [[Inventory Backgrounds]] of a unit wearing this armor.
| -
|-
| '''corpseBattle'''
| List of string IDs of the corpse [[#Items|items]] generated when a unit wearing this armor is killed (one per unit tile) on the Battlescape.
| -
|-
| '''corpseGeo'''
| String ID of the corpse [[#Items|item]] associated with this unit on the Geoscape.
| -
|-
| '''storeItem'''
| String ID of the [[#Items|item]] that represents this armor in [[Base Stores]] for equipping.
| -
|-
| '''weight'''
| Physical weight of the armor when worn
| 6
|-
| '''stats'''
| like soldier stats (see below) but these are treated as stat bonuses for wearing the specific armor.
| -
|-
| '''frontArmor'''
| Protection provided on the front of the unit.
| 0
|-
| '''sideArmor'''
| Protection provided on the sides of the unit.
| 0
|-
| '''rearArmor'''
| Protection provided on the rear of the unit.
| 0
|-
| '''underArmor'''
| Protection provided under the unit (eg. from explosions).
| 0
|-
| '''drawingRoutine'''
| Drawing routine used to put together the body parts in the unit's '''spriteSheet''':
* 0 = [[Soldier]], [[Sectoid]]
* 1 = [[Floater]]
* 2 = [[HWP]]
* 3 = [[Cyberdisk]]
* 4 = [[Civilian]], [[Ethereal]]
* 5 = [[Sectopod]], [[Reaper]]
* 6 = [[Snakeman]]
* 7 = [[Chryssalid]]
* 8 = [[Silacoid]]
* 9 = [[Celatid]]
* 10 = [[Muton]]
* 11 = [[Submersible Weapons Systems]]
* 12 = [[Hallucinoid]]
* 13 = [[Aquanauts]]
* 14 = [[Calcinite]], [[Deep One]], [[Gillman]], [[Lobster Man]], [[Tasoth]]
* 15 = [[Aquatoid]]
* 16 = [[Bio-Drone]]
| 0
|-
| '''movementType'''
| Type of movement provided by this armor:
* 0 = Walking
* 1 = Flying
* 2 = Sliding (no walking animation)
it also defines the body of an tank (32-images) in your spriteSheet or the change in sprites while flying using a flying armour see: [[TANKS.PCK]], [[XCOM_2.PCK]]
| 0
|-
| '''damageModifier'''
| List of decimal damage modifiers (1.0 = 100%) this armor applies to each damage type (see [[#Items|Items section]]) received. Modifiers must be specified for all damage types, in this order:
* None
* Armor Piercing
* Incendiary
* High Explosive
* Laser
* Plasma
* Stun
* Melee
* Acid
* Smoke
|
- 1.0 
- 1.0 
- 1.0 
- 1.0 
- 1.0 
- 1.0 
- 1.0 
- 1.0 
- 1.0 
- 1.0
|-
| '''size'''
| Size of the unit wearing this armor, in Battlescape grid units. Every unit is square, so a size of 2 means 2x2.
| 1
|-
| '''loftempsSet'''
| List of [[LOFTEMPS]] IDs (one per unit tile, so a 1x1 unit has 1, a 2x2 unit has 4, etc.) used to represent a unit wearing this armor in 3D space.
| -
|-
| '''loftemps'''
| loftemps is a deprecated option that only works for 1x1 sized units.
| -
|-
| '''forcedTorso'''
| soldier sprites have female and male torsos. some armours reuse these sprites for flying/non flying torso without difference between genders. This can be controlled by the parameter: 0 = use genderrelated torso, 1 = use male torso, 2 = use female torso
| 0

|}

=== Player Units (Soldiers) ===

Defines a [[soldier]] recruited by X-COM, listed in ''"soldiers:"''. Currently only one soldier unit type (''XCOM'') is supported.

Unit stats are represented as follows:
* [[Time Units|tu]]
* [[Energy|stamina]]
* [[Health|health]]
* [[Bravery|bravery]] (always a multiple of 10)
* [[Reactions|reactions]]
* [[Firing Accuracy|firing]]
* [[Throwing Accuracy|throwing]]
* [[Strength|strength]]
* [[Psi Strength|psiStrength]]
* [[Psi Skill|psiSkill]]
* [[Melee Accuracy|melee]] (not visible)

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the soldier name.
| ''required''
|-
| '''minStats'''
| Minimum values used to generate the soldier's [[Starting Stats]]. In this case, ''psiSkill'' is treated as the initial stat (not generated).
| -
|-
| '''maxStats'''
| Maximum values used to generate the soldier's [[Starting Stats]]. In this case, ''psiSkill'' is treated as the minimum value for the first month of psi training (actual value is 100%-150%).
| -
|-
| '''statCaps'''
| Maximum stats this soldier can gain through [[Experience]]. '''NOTE:''' A stat will still go over the limit once, and then will no longer increase (see [[Experience#Regarding Caps|Regarding Caps]]).
| -
|-
| '''armor'''
| String ID of the [[#Armor|armor]] this soldier uses by default.
| -
|-
| '''standHeight'''
| Height of this soldier when standing.
| 0
|-
| '''kneelHeight'''
| Height of this soldier when kneeling.
| 0
|-
| '''floatHeight'''
| Distance between the bottom of this unit and the ground.
| 0
|-
| '''femaleFrequency'''
| The probability that a female soldier is hired.
| 50
|}

=== AI Units (Aliens/Civilians) ===

Defines an [[Alien Life Forms|alien]] (enemy) or [[civilian]] (neutral) unit, listed in ''"units:"''. Every different alien rank is a different unit, since they have completely different stats. Unit stats are represented as follows:
* [[Time Units|tu]]
* [[Energy|stamina]]
* [[Health|health]]
* [[Bravery|bravery]] (always a multiple of 10)
* [[Reactions|reactions]]
* [[Firing Accuracy|firing]]
* [[Throwing Accuracy|throwing]]
* [[Strength|strength]]
* [[Psi Strength|psiStrength]]
* [[Psi Skill|psiSkill]]
* [[Melee Accuracy|melee]] (not visible)

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the unit name.
| ''required''
|-
| '''race'''
| String ID of the unit race (for alien units).
| -
|-
| '''rank'''
| String ID of the unit rank (for alien units).
| -
|-
| '''stats'''
| Battlescape stats of this unit.
| -
|-
| '''armor'''
| String ID of the [[#Armor|armor]] this unit uses by default.
| -
|-
| '''standHeight'''
| Height of this unit when standing.
| 0
|-
| '''floatHeight'''
| Distance between the bottom of this unit and the ground.
| 0
|-
| '''value'''
| [[Score]] this unit is worth.
| 0
|-
| '''deathSound'''
| Sound ID from [[#Extra_Sounds|BATTLE.CAT]] played when this unit dies.
| -1
|-
| '''aggroSound'''
| Sound ID from [[#Extra_Sounds|BATTLE.CAT]] played when this unit aggros.
| -1
|-
| '''moveSound'''
| Sound ID from [[#Extra_Sounds|BATTLE.CAT]] played when this unit moves.
| -1
|-
| '''intelligence'''
| Intelligence of this unit's AI. The higher the value, the longer this unit remembers player troops between turns.
| 0
|-
| '''aggression'''
| Aggression of this unit's AI. The higher the value, the more ruthless the unit, the more likely to make a frontal assault. Less aggressive units tend to set up ambushes.
Vanilla values are:
* 0 = mostly passive
* 1 = balanced
* 2 = mostly aggresive
| 0
|-
| '''energyRecovery'''
| Energy recovered by the unit each turn (needs verification)
| 40 (?)
|-
| '''specab'''
| Special ability of this unit:
* 0 = None
* 1 = [[Cyberdisc|Explodes on Death]]
* 2 = [[Bio-Drone|Burns Floor]]
* 3 = Burns Floor and explodes on Death
| 0
|-
| '''spawnUnit'''
| String ID of the unit used to respawn on death (eg. [[Zombie]]s respawn as [[Chrysallid]]s).
| -
|-
| '''livingWeapon'''
| Is this unit a living weapon? (only attacks with a '''fixedWeapon''')
| false
|-
| '''female'''
| Is this unit a female? (used for TFTD civilian types)
| false
|-
|}

=== Alien Races ===

Defines a [[Alien Life Forms|race]] used in [[Alien Missions]], listed in ''"alienRaces:"''. Heavily tied with deployment data.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''id'''
| String ID of the alien race name.
| ''required''
|-
| '''members'''
| Alien crew associated with this alien race (eg. race units + terrorist units), defined by a list of unit string IDs. Order here will define rank in terms of deployment. generally speaking the order is:
* 0 - Commander
* 1 - Leader
* 2 - Engineer
* 3 - Medic
* 4 - Navigator
* 5 - Soldier
* 6 - Terrorist 1
* 7 - Terrorist 2
but of course, not all races have all ranks, so the "fill in" rank would be listed multiple times (see ethereals).
| -
|-
| '''retaliation'''
| retaliation enables/disables the race for retaliation missions.
| ''True''
|-
|}

=== Alien Deployments ===

Defines a Battlescape deployment data used in [[Alien Missions]] (such as alien and map configurations), listed in ''"alienDeployments:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the deployment name.
| ''required''
|-
| '''width'''
| Width of the Battlescape map in grid units.
| 0
|-
| '''length'''
| Length of the Battlescape map in grid units.
| 0
|-
| '''height'''
| Vertical height of the Battlescape map in grid units.
| 0
|-
| '''terrains'''
| list of string IDs of the [[#Terrains|terrain]] to choose from to generate this map. This is not used for UFO sites where the terrain comes from the Geoscape.
| -
|-
| '''shade'''
| Shade of the map (0-15, where 0 is full daytime and 15 is full nighttime). This is not used for UFO sites where the shade comes from the Geoscape.
| 0
|-
| '''nextStage'''
| String ID of the next deployment stage to use after this one, for multi-stage missions.
| -
|-
| '''data'''
| List of deployment data for each alien rank on this mission (see below).
| -
|}

Notes:
* '''terrains''' can also be used with UFOs, with the game using instead the listed terrain rather than the location of the UFO on Geoscape.
==== Deployment Data ====

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''alienRank'''
| [[Alien Rank|Rank]] associated with this deployment data, as defined by the order of the race in question (see above)
| ''required''
|-
| '''lowQty'''
| Maximum quantity of aliens to spawn (beginner).
| 0
|-
| '''highQty'''
| Maximum quantity of aliens to spawn (superhuman).
| 0
|-
| '''dQty'''
| Minimum Desired Quantity of aliens to spawn.
| 0
|-
| '''percentageOutsideUfo'''
| Percentage (0-100%) of aliens to spawn outside in UFO sites.
| 0
|-
| '''itemSets'''
| Three lists (one for each alien technology level) of [[#Items|items]] (string IDs) for the aliens to equip.
| ''required''
|-
|}

=== Research ===

Defines a [[Research|research topic]] that X-COM scientists can investigate, listed in ''"research:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''name'''
| String ID of the research project's name (or item, if a '''lookup''' is defined).
| ''required''
|-
| '''lookup'''
| String ID of the research project's display name and UFOPaedia article reference.
| -
|-
| '''cost'''
| Number of man hours (on average) required to complete this project.
| 0
|-
| '''points'''
| [[Score]] earned for completing this project.
| 0
|-
| '''needItem'''
| Does this project require an [[#Items|item]] of the same name?
| false
|-
| '''dependencies'''
| List of research projects that can unlock access to this one. If the full list is researched, or if one of the projects on the list "unlocks" this one, it becomes available.
| -
|-
| '''unlocks'''
| List of research projects unlocked, regardless of other dependencies, but not requirements, by completing this project (for example, any live alien unlocks "alien origins").
| -
|-
| '''requires'''
| List of research projects unilaterally required before this project can be unlocked (for example, "the martian solution" will not even be considered for unlocking until AFTER "alien origins" is completed).
| -
|-
| '''getOneFree'''
| List of "bonus" research projects that may be granted when completing this project (for example, alien medics will give you information on other alien races). Only applies to living aliens.
| -
|-
|}

=== Manufacture ===

Defines a [[Manufacture|manufacture project]] that X-COM engineers can produce, listed in ''"manufacture:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''name'''
| String ID of the manufacturing project's name (and the item it produces).
| ''required''
|-
| '''category'''
| String ID of the manufacturing project's category.
| -
|-
| '''requires'''
| List of [[#Research|topics]] (string IDs) that must be researched to unlock this project. If none are specified, this project is unlocked from the start.
| -
|-
| '''space'''
| Amount of [[Workshop]] space required to begin this project.
| 0
|-
| '''time'''
| Number of man hours (on average) required per item.
| 0
|-
| '''cost'''
| Monetary deduction per item manufactured.
| 0
|-
| '''requiredItems'''
| List of [[#Items|items]] required and consumed per item manufactured.
| -
|-
| '''producedItems'''
| List of [[#Items|items]] produced per each item consumed. If not specified, defaults to 1 item with the same string ID as the manufacture.
| 1
|-
|}

=== UFOpaedia Article ===

Defines an article in the in-game [[UFOpaedia]], listed in ''"ufopaedia:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''id'''
| String ID of the article name. This must match the ID of the object associated with this article, if applicable.
| ''required''
|-
| '''title'''
| String ID of the article title. If omitted, the '''id''' is used.
| -
|-
| '''type_id'''
| Type of this article:
* 0 = Unknown
* 1 = [[Craft]]
* 2 = [[Craft Armaments]]
* 3 = [[HWP]]
* 4 = [[Equipment (EU)|Equipment]]
* 5 = [[Armour]]
* 6 = [[Base Facilities]]
* 7 = Text & Image (eg. [[Alien Life Forms]], [[UFO Components]])
* 8 = Text (eg. [[Alien Research]])
* 9 = [[UFO]]
| 0
|-
| '''section'''
| String ID of the UFOpaedia section this article belongs in.
| -
|-
| '''requires'''
| List of [[#Research|topics]] (string IDs) that must be researched to unlock this article. If none are specified, this article is unlocked from the start.
| -
|-
| '''image_id'''
| Filename of the [[UP001.SPK-UP042.SPK|background image]] displayed on this article, if applicable.
| -
|-
| '''text'''
| String ID of the description displayed on this article.
| -
|-
| '''text_width'''
| Maximum width of the text displayed, only applicable to ''Text & Image'' articles.
| 0
|-
| '''rect_stats'''
| Rectangle ('''x''', '''y''', '''width''', '''height''') of the stats text on the screen, only applicable to ''Craft'' articles.
| 0
|-
| '''rect_text'''
| Rectangle ('''x''', '''y''', '''width''', '''height''') of the description text on the screen, only applicable to ''Craft'' articles.
| 0
|-
| '''weapon'''
| String ID of the weapon, only applicable to ''HWP'' articles.
| -
|}

=== UFO Trajectories ===

Defines a trajectory carried out by an UFO during an [[#Alien Missions|alien mission]], listed in ''"ufoTrajectories:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''id'''
| String ID of the trajectory name.
| ''required''
|-
| '''groundTimer'''
| Amount of seconds for the UFO to spend on Ground waypoints.
| 0
|-
| '''waypoints'''
| List of waypoints for the UFO to traverse, defined as ''[zone, altitude, speed]''. 
'''zone''': Globe zone where the waypoint is located. 
'''altitude''': UFO altitude after reaching this waypoint:
* 0 - Ground
* 1 - Very Low
* 2 - Low
* 3 - High
* 4 - Very High
'''speed''': UFO speed after reaching this waypoint, as a percentage (0-100%) of its maximum speed.
| -
|}

=== Alien Missions ===

Defines an [[Alien Missions|alien mission]] carried out by UFOs on the Geoscape, listed in ''"alienMissions:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the mission type.
| ''required''
|-
| '''points'''
| [[Score]] allocated to aliens for successfully completing this mission.
| 0
|-
| '''raceWeights'''
| List of alien races likely to carry out this mission, and the % chance of them being allocated to this mission, listed by "number of months after game beginning".
| ''required''
|-
| '''waves'''
| List of UFO waves to spawn as this mission progresses, as described below.
| ''required''
|}

==== Waves ====

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''ufo'''
| String ID of the [[#UFOs|UFO]] to spawn.
| ''required''
|-
| '''count'''
| Number of UFOs to spawn.
| 0
|-
| '''trajectory'''
| String ID of the [[#UFO Trajectories|trajectory]] for this UFO to use when entering Earth's atmosphere.
| ''required''
|-
| '''timer'''
| How long after the previous wave should this wave arrive? (in seconds)
| 0
|-
|}

=== Alien Item Levels ===

This is a list of item level probabilities, with a number between 0 and 2 representing an item level from plasma pistols to heavy plasmas, as defined in the deployments, expressing a 10% probability for that item level being used.

0 = first set (plasma pistol/clip)
1 = second set (plasma rifle/clip)
2 = third set (heavy plasma/clip)

For example:
[ 2, 0, 0, 0, 0, 0, 0, 1, 1, 1 ]
would represent a 60% chance for pistols, 30% rifles, and 10% heavy weapons. 
Note that the order does not matter, but the length DOES. each line MUST have 10 digits.

The above can be confusing. There are 10 fields; each number represents 10%. 
There are six instances of '0'. 6x10% = 60% chance of plasma pistol 
There are three instances of '1'. 3x10% = 30% chance of plasma rifle 
There is only one instance of '2'. 1x10% = 10% chance of heavy plasma 

Each line represents a month after the beginning of the game, and there is no limit to the number defined. 
OpenXCom will use the most recently available item level in the event the game goes on forever.

=== Extra Sprites ===

Adds or replaces sprites in an existing [[Image Formats|X-COM image file]], listed in ''"extraSprites:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| Filename of the original/new image to modify.
| ''required''
|-
| '''width'''
'''height'''
| Size of the sprite(s) in pixels.
| 0
0
|-
| '''singleImage'''
| Is the image file just a single sprite (true) or a spritesheet (false)?
| false
|-
| '''subX'''
'''subY'''
| Size of the subdivision in pixels. If a subdivision is specified, then the image file is divided into chunks to form the sprites (eg. spritesheets).
| 0
0
|-
| '''files'''
| List of the new sprites to add/replace, listed as ''spriteID: filename''.
| -
|}

Example:
- type: GIANTBUNNY.PCK
width: 32
height: 40
files:
0: Resources/Bunny/Bunny00.png
1: Resources/Bunny/Bunny01.bmp
2: Resources/Bunny/Bunny02.gif

=== Extra Sounds ===

Adds or replaces sounds in an existing [[SOUND|X-COM sound file]], listed in ''"extraSounds:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| ID of the original sound file to modify:
* BATTLE.CAT - Battlescape sounds, corresponds to ''SOUND1.CAT'' or ''SAMPLE2.CAT'' (55 sounds).
* INTRO.CAT - Intro sounds, corresponds to ''INTRO.CAT'' or ''SAMPLE3.CAT'', probably best not to mess with these.
* GEO.CAT - Geoscape sounds, corresponds to ''SOUND2.CAT'' or ''SAMPLE.CAT'' (14 sounds).
| ''required''
|-
| '''files'''
| List of the new sounds to add/replace, listed as ''soundID: filename''.
| -
|}

Example:
- type: BATTLE.CAT
files:
55: Resources/Sounds/sample.wav

=== Extra Strings ===

Adds or replaces text strings in an existing [[Translations (OpenXcom)|OpenXcom language file]], listed in ''"extraStrings:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| Filename of the original language file to modify, sans extension.
| ''required''
|-
| '''strings'''
| List of the new strings to add/replace, listed as ''stringID: text''.
| -
|}

Example:
- type: en-US
strings:
STR_SNIPER_RIFLE: Sniper Rifle
STR_SNIPER_RIFLE_CLIP: Sniper Rifle Clip
- type: en-GB
strings:
STR_SNIPER_RIFLE: Sniper Rifle
STR_SNIPER_RIFLE_CLIP: Sniper Rifle Clip
- type: de
strings:
STR_SNIPER_RIFLE: Scharfschützengewehr
STR_SNIPER_RIFLE_CLIP: Scharfschützengewehrmunition
- type: ru
strings:
STR_SNIPER_RIFLE: Снайперская винтовка
STR_SNIPER_RIFLE_CLIP: Магазин к снайп. винтовке

=== Interfaces ===

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| ''?''
| -
|-
| '''elements'''
| ''?''
| -
|-
| '''id'''
| ''?''
| -
|-
| '''color'''
| ''?''
| -
|}

=== StatStrings ===

[[Statstrings]] are used for automatically renaming soldiers. They are case sensitive and they are processed in the order in which they are specified.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''string'''
| String to add to name.
| ''required''
|-
| '''psiStrength''' 
'''psiSkill''' 
'''bravery''' 
'''strength''' 
'''firing''' 
'''reactions''' 
'''stamina''' 
'''tu''' 
'''health''' 
'''throwing'''
| One or more stat ranges are ANDed together for success. Each range has a minVal and maxVal. Use YAML standard tilde (~) to indicate null. ((~) = 0 as minvalue; (~) =255 as maxvalue)
| -
|}

Example:
statStrings:
- string: "x"
psiStrength: [~, 30]
- string: "P"
psiStrength: [80, ~]
- string: "p"
psiStrength: [60, 79]
- string: "K"
psiSkill: [60, ~]
- string: "k"
psiSkill: [30, 59]
- string: "b"
bravery: [60, ~]
- string: "c"
bravery: [~, 10]
- string: "w"
strength: [~, 25]
- string: "Snpr"
firing: [60, ~]
reactions: [60, ~]
- string: "M"
firing: [70, ~]
- string: "m"
firing: [60, 69]
- string: "Sct"
reactions: [50, ~]
tu: [60, ~]
- string: "R"
reactions: [60, ~]
- string: "r"
reactions: [50, 59]

==References==
<references />

[[Category:OpenXcom]]

Ruleset Reference (OpenXcom)

2014-12-04T19:02:25Z

Falko: /* Player Units (Soldiers) */

A reference of all the customizable values of everything in a [[Rulesets (OpenXcom)|ruleset]]. Some guidelines:
* If a value is omitted from the ruleset, the default is used. You cannot omit ''required'' values.
* Text strings (eg. names) are represented by string IDs from the [[Translations (OpenXcom)|language files]]
* Numerical IDs (used for sprites, sounds, etc.) start at 0, not 1.
* Boolean (yes/no) values are represented by true/false.
* World coordinates are represented in degrees (see [[WORLD.DAT]]).
* Money amounts (prices, costs, etc.) are represented in dollars.
* All paths are '''case sensitive'''! If your ruleset uses external files, make sure that they named properly as described in ruleset.

Items are ordered as they come in the ruleset. To override this, you can specify a ''listOrder''. You can find the default listOrders in [[Ruleset List Order (OpenXcom)|Ruleset List Order]].

=== Globe ===

Defines the drawing of landmasses and borders on the globe.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''data'''
| Path name of file which contains polygon and texture information. (For example WORLD.DAT).
| -
|-
| '''polygons'''
| List of polygons drawn on the globe surface. A triangle consist of seven values: the first number defines the texture, followed by three pairs of (x,y) globe coordinates. Only polygons with 3 or 4 vertices are reliable shown on the globe = 7 or 9 values per entry.
| -
|-
| '''polylines'''
| List of border lines. Each list entry consist of a list of (x,y) globe coordinates.
| -
|}

=== Countries ===

Defines one of the [[Country Funding (EU)|funding nations]], listed in ''"countries:"''. They're used for activity graphs and player scoring.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the country name.
| ''required''
|-
| '''fundingBase'''
| Country's base funding, in thousands. The starting funding can be anywhere between 1x and 2x the base funding.
| 0
|-
| '''fundingCap'''
| Country's funding cap, in thousands. Once a country reaches this maximum, it will no longer increase its funding.
| 0
|-
| '''labelLon'''
'''labelLat'''
| Longitude and latitude coordinates of the country's label on the globe. This label is only shown when the globe is zoomed in and "detail" is turned on.
| 0.0
0.0
|-
| '''areas'''
| List of "rectangles" on the globe defined as [''lon1'' ''lat1'' ''lon2'' ''lat2'']. Any activity within these areas counts towards the country's graph activity and affects their opinion of the player.
| -
|}

=== Regions ===

Defines one of the [[Geoscape (EU)#World Regions/Countries|world regions]], listed in ''"regions:"''. They're used for base placement, activity graphs and mission spawning.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the region name.
| ''required''
|-
| '''cost'''
| Amount of money spent building an X-COM base in this region (first base is free).
| 0
|-
| '''areas'''
| List of "rectangles" on the globe defined as ''[lon1, lat1, lon2, lat2]''. Any activity within these areas counts towards the region's graph activity.
| -
|-
| '''cities'''
| List of cities belonging to this region. They will be displayed on the globe and used for terror site missions. Each city is defined by their '''lon''' and '''lat''' coordinates and a '''name''' string ID.
| -
|-
| '''regionWeight'''
| Weight of this region when selecting regions for alien missions.
| 0
|-
| '''missionWeights'''
| Weighted list of the different mission types for this region (eg. ''STR_ALIEN_RESEARCH: 14'').
| -
|-
| '''missionZones'''
| List of "rectangles" (''[lon1, lat1, lon2, lat2]'') defining the mission zones for this region. Mission zones are waypoints for UFO trajectories.
| -
|-
| '''missionRegion'''
| Spawn mission in this region instead (used for regions without land).
| -
|}

=== Base Facilities ===

Defines one of the [[Base Facilities (EU)|facilities]] that can be built in an X-COM base, listed in ''"facilities:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the facility name.
| ''required''
|-
| '''requires'''
| List of [[#Research|topics]] (string IDs) that must be researched to unlock this facility. If none are specified, this facility is unlocked from the start.
| -
|-
| '''spriteShape'''
| Sprite ID from [[BASEBITS.PCK]] used to draw the facility's outer shape in the Basescape and UFOpaedia.
| -1
|-
| '''spriteFacility'''
| Sprite ID from [[BASEBITS.PCK]] used to draw the facility's contents in the Basescape and UFOpaedia. Drawn on top of '''spriteShape'''.
| -1
|-
| '''lift'''
| Is this facility an [[Access Lift]]? All base facilities must be connected to the lift.
| false
|-
| '''hyper'''
| Is this facility a [[Hyperwave Decoder]]? Displays extra information for detected UFOs. Only valid for radar facilities.
| false
|-
| '''mind'''
| Is this facility a [[Mind Shield]]? Reduces the chance of UFOs finding your base. Does not stack.
| false
|-
| '''grav'''
| Is this facility a [[Grav Shield]]? Doubles the power of your base defenses. Does not stack.
| false
|-
| '''size'''
| Size of the facility, in grid units. Every facility is square, so a size of 1 means 1x1, 2 means 2x2, etc. Bigger facilities are made up of multiple sprites, for example a 2x2 facility will use 4 sprites for '''spriteShape''' and 4 sprites for '''spriteFacility''' (top-left, top-right, bottom-left, bottom-right).
| 1
|-
| '''buildCost'''
| Amount of money spent to build this facility in the base.
| 0
|-
| '''buildTime'''
| Amount of days it takes for this facility to be built.
| 0
|-
| '''monthlyCost'''
| Amount of money spent monthly for the maintenance of this facility.
| 0
|-
| '''storage'''
| Amount of storage space (for items) this facility provides. See [[Base Stores]].
| 0
|-
| '''personnel'''
| Amount of personnel (soldiers, scientsts, engineers) these quarters can contain.
| 0
|-
| '''aliens'''
| Amount of live aliens this facility can contain. Only checked if the ''alienContainmentLimitEnforced'' option is enabled.
| 0
|-
| '''crafts'''
| Amount of X-COM craft this facility can contain.
| 0
|-
| '''labs'''
| Amount of lab space this facility provides for research projects.
| 0
|-
| '''workshops'''
| Amount of workshop space this facility provides for manufacture projects.
| 0
|-
| '''psiLabs'''
| Amount of soldier space this facility provides for psionic training.
| 0
|-
| '''radarRange'''
| Maximum radar detection range of this facility, in nautical miles.
| 0
|-
| '''radarChance'''
| Chance (0-100%) of this radar detecting a UFO that enters its range.
| 0
|-
| '''defense'''
| Offensive power provided by this base defense against attacking UFOs.
| 0
|-
| '''hitRatio'''
| Chance (0-100) of the base defense hitting an attacking UFO.
| 0
|-
| '''fireSound'''
| Sound ID from [[#Extra_Sounds|GEO.CAT]] played when the base defense fires.
| -1
|-
| '''hitSound'''
| Sound ID from [[#Extra_Sounds|GEO.CAT]] played when the base defense hits a target.
| -1
|-
| '''mapName'''
| [[MAPS|Map]] associated to this facility in Battlescape base defenses.
| -
|-
|}

=== Crafts ===

Defines one of the [[Craft|X-COM crafts]] that go on interception missions, listed in ''"crafts:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the craft name.
| ''required''
|-
| '''requires'''
| List of [[#Research|topics]] (string IDs) that must be researched to unlock this craft. If none are specified, this craft is unlocked from the start.
| -
|-
| '''sprite'''
| Sprite ID from [[BASEBITS.PCK]] used to draw this craft in the Basescape and from [[INTICON.PCK]] used to draw the damage indicator in dogfights.
modders: the corresponding extrasprite file id for BASEBITS.PCK is sprite+33 INTICON.PCK contains a minimized icon id=sprite the file id for the dogfight image is sprite+11
| -1
|-
| '''fuelMax'''
| Maximum amount of fuel this craft can carry. Crafts use up fuel based on their speed while travelling.
| 0
|-
| '''damageMax'''
| Maximum amount of damage this craft can take. If this amount is exceeded, the craft is destroyed.
| 0
|-
| '''speedMax'''
| Maximum speed in nautical miles. Crafts travel at max speed when flying and half speed when patrolling.
| 0
|-
| '''accel'''
| Aceeleration value shown in the UFOpaedia.
| 0
|-
| '''weapons'''
| Amount of craft weapons this craft can equip. The UI can only display a max of 2 weapons.
| 0
|-
| '''soldiers'''
| Amount of soldiers this craft can carry.
| 0
|-
| '''maxItems'''
| Amount of items this craft can carry.
| 80
|-
| '''vehicles'''
| Amount of vehicles this craft can carry.
| 0
|-
| '''costBuy'''
| Amount of money spent for purchasing this craft. If set to 0, the craft will not be available in the Purchase/Recruit screen.
| 0
|-
| '''costRent'''
| Amount of money spent monthly for renting this craft. If set to 0, the craft is not on rental and won't count towards base maintenance.
| 0
|-
| '''costSell'''
| Amount of money gained for selling this craft.
| 0
|-
| '''refuelItem'''
| Item required for refuelling this craft. If no item is specified, the craft uses human fuel.
| 0
|-
| '''repairRate'''
| Amount of damage restored every hour while [[Repairs|Repairing]] in base.
| 1
|-
| '''refuelRate'''
| Amount of fuel restored every 30 mins while [[Refueling]] in base. If specified, a '''refuelItem''' is spent each time.
| 1
|-
| '''radarRange'''
| Detection range of the craft's radar in nautical miles. Every craft radar has a 100% detection chance.
| 600
|-
| '''transferTime'''
| Number of hours it takes to purchase/transfer this craft to a base.
| 0
|-
| '''score'''
| [[Score]] lost when this craft is destroyed.
| 0
|-
| '''spacecraft'''
| Can this craft go to [[Cydonia]]?
| false
|-
| '''battlescapeTerrainData'''
| [[#Terrains|Terrain]] associated to this craft in Battlescape missions.
| -
|}

=== Craft Weapons ===

Defines one of the [[Craft Armaments|weapons]] equipped by X-COM craft for shooting down UFOs, listed in ''"craftWeapons:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the weapon name.
| ''required''
|-
| '''sprite'''
| Sprite ID from [[BASEBITS.PCK]] used to draw the weapon in the Basescape and from [[INTICON.PCK]] used to draw the weapon in dogfights.
modders: the corresponding extrasprites file id for INTICON.PCK is sprite+5 and sprite+48 for BASEBITS.PCK
| -1
|-
| '''sound'''
| Sound ID from [[#Extra_Sounds|GEO.CAT]] played when this weapon fires.
| -1
|-
| '''damage'''
| Amount of damage this weapon does to enemy UFOs.
| 0
|-
| '''range'''
| Maximum range of this weapon in dogfights (in meters).
| 0
|-
| '''accuracy'''
| Chance (0-100%) of each shot hitting the enemy UFO.
| 0
|-
| '''reloadCautious'''
| Time this weapon takes to fire between each shot in ''Cautious Mode''.
| 0
|-
| '''reloadStandard'''
| Time this weapon takes to fire between each shot in ''Standard Mode''.
| 0
|-
| '''reloadAggressive'''
| Time this weapon takes to fire between each shot in ''Aggressive Mode''.
| 0
|-
| '''ammoMax'''
| Maximum amount of ammo this weapon can carry.
| 0
|-
| '''rearmRate'''
| Amount of ammo restored every 30 mins while the craft is [[Rearming]] in base. If specified, '''clip'''s are spent depending on their '''clipSize'''. If the '''clipSize''' of the specified ammo is 0, no '''clip'''s are spent.
| 1
|-
| '''projectileType'''
| Type of the weapon projectile, used for the projectile sprite in dogfights:
* 0 - [[Stingray]]
* 1 - [[Avalanche]]
* 2 - [[Cannon]]
* 3 - [[Fusion Ball]]
* 4 - [[Laser Cannon]]
* 5 - [[Plasma Beam]]
| 2
|-
| '''projectileSpeed'''
| Speed of the weapon projectile in dogfights.
| 0
|-
| '''launcher'''
| String ID of the [[#Items|item]] required to equip this weapon.
| -
|-
| '''clip'''
| String ID of the [[#Items|item]] required to rearm this weapon.
| -
|}

=== Items ===

Defines the Geoscape and Battlescape properties of an [[Equipment (EU)|item]] that can be stored in X-COM bases, listed in ''"items:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the internal item name.
| ''required''
|-
| '''name'''
| String ID of the displayed item name, for cases where it's different from the internal name. If omitted, '''type''' is used.
| -
|-
| '''requires'''
| List of [[#Research|topics]] (string IDs) that must be researched to unlock this item. If none are specified, this item is unlocked from the start. Soldiers can only use unlocked items in the Battlescape.
| -
|-
| '''size'''
| Space occupied by this item in [[Base Stores]]. Can be a decimal value.
| 0.0
|-
| '''costBuy'''
| Amount of money spent for purchasing this item. If set to 0, this item will not be available in the Purchase/Recruit screen.
| 0
|-
| '''costSell'''
| Amount of money gained for selling this item.
| 0
|-
| '''transferTime'''
| Number of hours it takes to purchase/transfer this item to a base.
| 24
|-
| '''weight'''
| [[Item_Weight|Weight]] occupied by this item in a soldier's inventory.
| 999
|-
| '''bigSprite'''
| Sprite ID from [[BIGOBS.PCK]] used to draw this item in a soldier's inventory and UFOpaedia.
| -1
|-
| '''floorSprite'''
| Sprite ID from [[FLOOROB.PCK]] used to draw this item on the floor of a Battlescape tile.
| -1
|-
| '''handSprite'''
| Sprite ID from [[HANDOB.PCK]] used to draw this item on a soldier's hand in the Battlescape.
modders: each handobject needs 8 images (8 directions) define the extrasprites accordingly
| 120
|-
| '''bulletSprite'''
| Sprite ID from ''BulletSprites.png'' used to draw this weapon's projectile on the Battlescape:
* 0 - [[Rocket Launcher]]
* 1 - [[Pistol]]
* 2 - [[Rifle]]
* 3 - [[Auto Cannon]]
* 4 - [[Heavy Cannon]]
* 5 - [[Laser Pistol]]
* 6 - [[Laser Rifle]]
* 7 - [[Heavy Laser]]
* 8 - [[Plasma Rifle|Plasma]]
* 9 - [[Small Launcher]]
* 10 - [[Blaster Launcher]]
for modders: the bulletsprite needs to be put into the extraSprites type "Projectiles" the bulletsprite can contain up to 35 3x3 images. The corresponding file id is 35*[bulletSprite]
| -1
|-
| '''fireSound'''
| Sound ID from [[#Extra_Sounds|BATTLE.CAT]] played when this weapon fires.
| -1
|-
| '''hitSound'''
| Sound ID from [[#Extra_Sounds|BATTLE.CAT]] played when this weapon hits a target.
| -1
|-
| '''hitAnimation'''
| Sprite ID from [[SMOKE.PCK]] used to draw the weapon's "hit explosion".
'''NOTE''': Do not define this value for melee/psi weapons, they use [[HIT.PCK]] and therefore meleeAnimation instead.
| 0
|-
| '''power'''
| Average damage of the weapon, in most cases it will be +-50% this value.
| 0
|-
| '''strengthApplied'''
| Add the attacking unit's strength to this weapon's damage.
| false
|-
| '''compatibleAmmo'''
| List of string IDs of the ammo items that can be loaded on this weapon. If none are specified, the weapon doesn't need ammo.
| -
|-
| '''damageType'''
| What type of [[damage]] does this weapon do:
* 0 - None
* 1 - Armor Piercing
* 2 - Incendiary
* 3 - High Explosive
* 4 - Laser
* 5 - Plasma
* 6 - Stun
* 7 - Melee
* 8 - Acid
* 9 - Smoke
'''NOTE:''' A damage type other than 0-9 will do nothing.
| 0
|-
| '''tuAuto'''
'''accuracyAuto'''
| The percentage (0-100%) of [[Time Units]] (from the soldier's total) required to fire an Auto Shot. If 0, the weapon does not have an Auto Shot.
The base accuracy (0-100%) applied to a soldier's [[Firing Accuracy]] when firing an Auto Shot.
| 0
0
|-
| '''tuSnap'''
'''accuracySnap'''
| The percentage (0-100%) of [[Time Units]] (from the soldier's total) required to fire a Snap Shot. If 0, the weapon does not have a Snap Shot.
The base accuracy (0-100%) applied to a soldier's [[Firing Accuracy]] when firing a Snap Shot.
| 0
0
|-
| '''tuAimed'''
'''accuracyAimed'''
| The percentage (0-100%) of [[Time Units]] (from the soldier's total) required to fire an Aimed Shot. If 0, the weapon does not have an Aimed Shot.
The base accuracy (0-100%) applied to a soldier's [[Firing Accuracy]] when firing an Aimed Shot.
| 0
0
|-
|-
| '''tuMelee'''
'''accuracyMelee'''
| The percentage (0-100%) of [[Time Units]] (from the soldier's total) required to do a melee attack (Hit). If 0, the weapon does not have a melee attack.
The base accuracy (0-100%) applied to a soldier's [[Melee Accuracy]] when doing a melee attack.
| 0
0
|-
| '''clipSize'''
| The amount of ammo stored in each weapon clip. If -1 is specified, this weapon has infinite ammo.
| 0
|-
| '''battleType'''
| Defines the weapon's behavior in the Battlescape:
* 0 - None (Geoscape-only item)
* 1 - [[Weapons|Firearm]]
* 2 - Ammo
* 3 - Melee
* 4 - [[Grenade]]
* 5 - [[Proximity Grenade]]
* 6 - [[Medi-Kit (EU)|Medi-Kit]]
* 7 - [[Motion Scanner]]
* 8 - [[Mind Probe]]
* 9 - [[Psi-Amp]]
* 10 - [[Electro-flare]]
* 11 - Corpse
| 0
|-
| '''twoHanded'''
| Is this weapon two-handed? If true, incurs an accuracy penalty if used with both hands occupied. Note that the handsprite of a twoHanded item is also drawn at a slightly different position than a one handed item.
| false
|-
| '''waypoint'''
| Does this weapon use waypoints? (eg. [[Blaster Launcher]]). Can also be used to make ammo items use the waypoint system.
| false
|-
| '''fixedWeapon'''
| Is this weapon fixed? (it's part of a unit, eg. tanks and terrorist units)
| false
|-
| '''invWidth'''
| Item width in a soldier's inventory (in grid units).
| 1
|-
| '''invHeight'''
| Item height in a soldier's inventory (in grid units).
| 1
|-
| '''painKiller'''
| Amount of painkillers contained in a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''heal'''
| Amount of heal's contained in a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''stimulant'''
| Amount of stimulants contained in a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''woundRecovery'''
| Amount of [[Fatal Wounds]] treated by each heal of a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''healthRecovery'''
| Amount of [[Health]] recovered by each heal of a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''stunRecovery'''
| Amount of [[Stun]] removed by each stimulant of a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''energyRecovery'''
| Amount of [[Energy]] recovered by each stimulant of a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''tuUse'''
| Amount of [[Time Units]] required to use this item (for non-offensive items). It's a flat rate if '''flatRate''' is true, otherwise it's a percentage (0-100%).
| 0
|-
| '''recoveryPoints'''
| [[Score]] gained for recovering this alien artifact.
| 0
|-
| '''armor'''
| How much damage is needed to destroy this item on the ground.
| 20
|-
| '''recover'''
| Is this item recoverable? (gets transported to the X-COM base on mission success)
| true
|-
| '''turretType'''
| Sprite ID from [[TANKS.PCK]] of the turret to assign to this tank:
* 0 - [[Tank/Cannon]]
* 1 - [[Tank/Rocket Launcher]]
* 2 - [[Tank/Laser Cannon]]
* 3 - [[Hovertank/Plasma]]
* 4 - [[Hovertank/Launcher]]
| -1
|-
| '''liveAlien'''
| Does this item represent a live alien? (counts towards [[Alien Containment]])
| false
|-
| '''blastRadius'''
| Size of the projectile explosions. 0 for no explosion. -1 to automatically calculate based on weapon power and damage type (actual '''blastRadius''' currently is capped due [[Explosions#Playing_With_Fire|Explosion calculations]]).
| -1
|-
| '''flatRate'''
| If true, then TU costs for this weapon are a flat rate (instead of a percentage of unit TUs).
| false
|-
| '''arcingShot'''
| Does this weapon fire in an arc?
| false
|-
| '''attraction'''
| Represents how likely an alien is to pick up this item. Values below 5 will be ignored (by design).
| 0
|-
| '''maxRange'''
| Maximum range at which this weapon can operate.
| 200
|-
| '''aimRange'''
| Maximum effective range with this weapon before which range-based dropoff occurs.
| 200
|-
| '''snapRange'''
| Maximum effective range with snap shot before which range-based dropoff occurs. (ufoextender accuracy only)
| 15
|-
| '''autoRange'''
| Maximum effective range with auto shot before which range-based dropoff occurs. (ufoextender accuracy only)
| 7
|-
| '''minRange'''
| Range-based dropoff will work in reverse for ranges below this.
| 0
|-
| '''dropoff'''
| The value by which the accuracy lowers for each tile after (or before) the thresholds above.
| 2
|-
| '''bulletSpeed'''
| How much faster (or slower, if you use a negative number) is a projectile fired from this weapon compared to the average.
| 0
|-
| '''autoShots'''
| How many auto shots does this weapon fire.
| 3
|-
| '''shotgunPellets'''
| Number of projectiles fired per unit of ammunition. (note: due to engine limitations it is currently impossible to draw multiple projectiles in flight.)
| 0
|-
| '''zombieUnit'''
| String ID of the unit used for zombification (eg. [[Chrysallid]]s turn units into [[Zombie]]s).
| none
|-
| '''meleeSound'''
| Sound ID from [[#Extra_Sounds|BATTLE.CAT]] played when this weapon attacks a target with melee.
| 39
|-
| '''meleeHitSound'''
| Sound ID from [[#Extra_Sounds|BATTLE.CAT]] played when this weapon HITS a target with melee.
| -1
|-
| '''meleeAnimation'''
| Sprite ID from HIT.PCK played when this weapon attacks a target with melee.
| 0
|-
| '''meleePower'''
| Damage this weapon will do when using melee. This only applies to Firearms, and is only available as stun damage. For normal melee weapons, use regular power and damage types.
| 0
|-
| '''LOSRequired'''
| Does this item require line of sight? (only applies to mind probes and psi-amps)
| false
|-
| '''skillApplied'''
| Is melee skill applied to the accuracy of an attack made with this object?
| true
|-
|}

=== UFOs ===

Defines one of the [[UFOs]] that invade Earth, listed in ''"ufos:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the UFO name.
| ''required''
|-
| '''size'''
| String ID of the UFO size.
| STR_VERY_SMALL
|-
| '''sprite'''
| Sprite ID from [[INTERWIN.DAT]] used to draw this UFO in the dogfight view and UFOpaedia.
don't try to add more images if you don't want to punch yourself in the face - use modsprite
| -1
|-
| '''modSprite'''
| Filename used to draw this UFO in the dogfight view and UFOpaedia.
| -
|-
| '''damageMax'''
| Maximum amount of damage this UFO can take. If the UFO takes 50% damage, it crash lands. If it takes 100% damage, it is destroyed.
| 0
|-
| '''speedMax'''
| Maximum speed in nautical miles.
| 0
|-
| '''accel'''
| Aceeleration value shown in the UFOpaedia.
| 0
|-
| '''power'''
| Damage power of this UFO's weapon in dogfights.
| 0
|-
| '''range'''
| Maximum range of this UFO's weapon in dogfights (in meters).
| 0
|-
| '''score'''
| [[Score]] gained when this UFO is destroyed, or half this score if it crash lands.
| 0
|-
| '''reload'''
| Time the UFO's weapon takes to fire between each shot.
| 0
|-
| '''breakOffTime'''
| Minimum amount of time for the UFO to be able to break off of a dogfight.
| 0
|-
| '''battlescapeTerrainData'''
| [[#Terrains|Terrain]] associated to this UFO in Battlescape missions.
| ''required''
|-
|}

=== Inventory Sections ===

Defines one of the sections of the [[Inventory TU Table|Battlescape inventory]] (eg. Backpack), listed in ''"invs:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the inventory name.
| ''required''
|-
| '''x'''
'''y'''
| Pixel coordinates of this section on the inventory screen.
| 0
0
|-
| '''type'''
| Type of this section:
* 0 = Slot section, can contain as many items as will fit on the slots.
* 1 = Hand section, can only contain one item regardless of size.
* 2 = Ground section, can contain infinite items.
| 0
|-
| '''slots'''
| List of the grid slots (''[x, y]'') that this section is composed of. For example, to make a 2x2 section, you would have ''[0, 0] [0, 1] [1, 0] [1, 1]''.
| -
|-
| '''costs'''
| List of [[Time Units]] costs to move an item from this section to another one (eg. ''STR_BACKPACK: 16'' means it will cost 16 TUs to move an item from this section to the Backpack).
| -
|-
|}

=== Terrains ===

Defines one of the [[TERRAIN|terrains]] used to generate a Battlescape map, listed in "terrains:".

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''name'''
| String ID of the terrain name.
| ''required''
|-
| '''largeBlockLimit'''
| Maximum amount of large blocks that can be used on map generation.
| 0
|-
| '''textures'''
| List of [[TEXTURE.DAT|Geoscape textures]] that correspond to this terrain.
| -
|-
| '''hemisphere'''
| Geoscape hemisphere associated with this terrain:
* -1 - Northern hemisphere.
* 0 - Both hemispheres.
* 1 - Southern hemisphere.
| 0
|-
| '''mapDataSets'''
| List of filenames (each with matching [[MCD]]/[[Image Formats#PCK|PCK/TAB]] files) that contain the tiles of this terrain.
| -
|-
| '''mapBlocks'''
| List of map blocks (see below) that are used for generating a map.
| -
|-
| '''roadTypeOdds'''
| Odds as a % of generating each type of road (E-W Road, N-S Road, Crossing) odds for crossing are: 100 - EW - NS.
| [0 0]
|-|-
| '''civilianTypes'''
| List of units to use as civilians for this mission.
| [MALE_CIVILIAN, FEMALE_CIVILIAN]
|-
|}

==== Map Blocks ====

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''name'''
| Filename of the [[MAPS|map]].
| ''required''
|-
| '''width'''
| Width of this map block in Battlescape grid units.
| 0
|-
| '''length'''
| Length of this map block in Battlescape grid units.
| 0
|-
| '''height'''
| Height of this map block in Battlescape grid units.
| 1
|-
| '''type'''
| Type of this map block:
* -1 - Undefined
* 0 - Default
* 1 - Landing Zone (for placing X-COM / alien craft)
* 2 - E-W Road (for city maps)
* 3 - N-S Road (for city maps)
* 4 - Road Crossing (for city maps)
* 5 - Dirt (for filling empty base blocks)
* 6 - X-COM spawn point (for [[Alien Base]] / [[Cydonia]] missions)
* 7 - [[Alien Base]] Target
* 8 - [[Cydonia]] Target
| -1
|-
| '''subType'''
| Sub-type of this map block (see '''type''').
| -1
|-
| '''frequency'''
| Frequency of this block in a map.
| 1
|-
| '''maxCount'''
| Maximum amount of times this block can be used in a map. If -1 there is no limit.
| -1
|-
| '''items'''
| An array of items to add to this mapblock, an the positions to place them at.
| -1
|}

*'''frequency''' defines the odds of the map appearing on the map
** The value assigned (default: 1) is used in ''x/n'', which defines the probability of being chosen.
** ''x'' is the integer defined for the map block's frequency and ''n'' is the combined total of probabilities for all the map types combined.
** This property can only be used in type 0 map blocks.
*'''maxCount''' is the maximum number of times it can be used.
** The value assigned is also used in ''x/n'' to determine the probability of being chosen.
** Each use reduces ''x'' by -1, with the caveat that being used as a Landing Zone type will not reduce the x value since it could result in no available Landing Zones.
** This property can only be used in type 0 map blocks.
* '''hemisphere''' only applies to UFO missions, not Terror ones.
*'''width/length''' defines the size of the map
** be aware that the mapview "width"-label is the openxcom ruleset length parameter
** be aware that the mapview "length"-label is the openxcom ruleset width parameter

==== Guidelines/Tips ====
* All maps with an XCOM/Alien craft require at least one type 1 map block. This map block can only contain ground tiles (no walls or objects), otherwise the game will crash or the walls/objects will be removed.
* All Terror terrains (listed under STR_TERROR_MISSION) require at least 1 map block of '''Types''' 2, 3 and 4 (for a total of 3 maps, which are required to place roads) and the corresponding '''roadTypeOdds''' added to the ruleset.
* If there isn't any map blocks designed as roads since you want to keep your terrain 'random', this can be circumvented by designating all 10x10 map blocks, excluding the one(s) used for the XCOM craft, as either '''Type''' 2, 3 and 4 and by defining their '''subType''' to 0. The game will then randomly choose between the map blocks for each type used in the roads, making them map more random.

=== Armor ===

Defines a Battlescape unit's [[armor]] as well as visual representation (so every unit has an armor), listed in ''"armors:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the armor name.
| ''required''
|-
| '''spriteSheet'''
| Sprite sheet from [[UNITS]] used to draw a unit wearing this armor.
| -
|-
| '''spriteInv'''
| Sprite used for the [[Inventory Backgrounds]] of a unit wearing this armor.
| -
|-
| '''corpseBattle'''
| List of string IDs of the corpse [[#Items|items]] generated when a unit wearing this armor is killed (one per unit tile) on the Battlescape.
| -
|-
| '''corpseGeo'''
| String ID of the corpse [[#Items|item]] associated with this unit on the Geoscape.
| -
|-
| '''storeItem'''
| String ID of the [[#Items|item]] that represents this armor in [[Base Stores]] for equipping.
| -
|-
| '''weight'''
| Physical weight of the armor when worn
| 6
|-
| '''stats'''
| like soldier stats (see below) but these are treated as stat bonuses for wearing the specific armor.
| -
|-
| '''frontArmor'''
| Protection provided on the front of the unit.
| 0
|-
| '''sideArmor'''
| Protection provided on the sides of the unit.
| 0
|-
| '''rearArmor'''
| Protection provided on the rear of the unit.
| 0
|-
| '''underArmor'''
| Protection provided under the unit (eg. from explosions).
| 0
|-
| '''drawingRoutine'''
| Drawing routine used to put together the body parts in the unit's '''spriteSheet''':
* 0 = [[Soldier]], [[Sectoid]]
* 1 = [[Floater]]
* 2 = [[HWP]]
* 3 = [[Cyberdisk]]
* 4 = [[Civilian]], [[Ethereal]]
* 5 = [[Sectopod]], [[Reaper]]
* 6 = [[Snakeman]]
* 7 = [[Chryssalid]]
* 8 = [[Silacoid]]
* 9 = [[Celatid]]
* 10 = [[Muton]]
* 11 = [[Submersible Weapons Systems]]
* 12 = [[Hallucinoid]]
* 13 = [[Aquanauts]]
* 14 = [[Calcinite]], [[Deep One]], [[Gillman]], [[Lobster Man]], [[Tasoth]]
* 15 = [[Aquatoid]]
* 16 = [[Bio-Drone]]
| 0
|-
| '''movementType'''
| Type of movement provided by this armor:
* 0 = Walking
* 1 = Flying
* 2 = Sliding (no walking animation)
it also defines the body of an tank (32-images) in your spriteSheet or the change in sprites while flying using a flying armour see: [[TANKS.PCK]], [[XCOM_2.PCK]]
| 0
|-
| '''damageModifier'''
| List of decimal damage modifiers (1.0 = 100%) this armor applies to each damage type (see [[#Items|Items section]]) received. Modifiers must be specified for all damage types, in this order:
* None
* Armor Piercing
* Incendiary
* High Explosive
* Laser
* Plasma
* Stun
* Melee
* Acid
* Smoke
|
- 1.0 
- 1.0 
- 1.0 
- 1.0 
- 1.0 
- 1.0 
- 1.0 
- 1.0 
- 1.0 
- 1.0
|-
| '''size'''
| Size of the unit wearing this armor, in Battlescape grid units. Every unit is square, so a size of 2 means 2x2.
| 1
|-
| '''loftempsSet'''
| List of [[LOFTEMPS]] IDs (one per unit tile, so a 1x1 unit has 1, a 2x2 unit has 4, etc.) used to represent a unit wearing this armor in 3D space.
| -
|-
| '''loftemps'''
| loftemps is a deprecated option that only works for 1x1 sized units.
| -
|-
| '''forcedTorso'''
| soldier sprites have female and male torsos. some armours reuse these sprites for flying/non flying torso without difference between genders. This can be controlled by the parameter: 0 = use genderrelated torso, 1 = use male torso, 2 = use female torso
| 0

|}

=== Player Units (Soldiers) ===

Defines a [[soldier]] recruited by X-COM, listed in ''"soldiers:"''. Currently only one soldier unit type (''XCOM'') is supported.

Unit stats are represented as follows:
* [[Time Units|tu]]
* [[Energy|stamina]]
* [[Health|health]]
* [[Bravery|bravery]] (always a multiple of 10)
* [[Reactions|reactions]]
* [[Firing Accuracy|firing]]
* [[Throwing Accuracy|throwing]]
* [[Strength|strength]]
* [[Psi Strength|psiStrength]]
* [[Psi Skill|psiSkill]]
* [[Melee Accuracy|melee]] (not visible)

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the soldier name.
| ''required''
|-
| '''minStats'''
| Minimum values used to generate the soldier's [[Starting Stats]]. In this case, ''psiSkill'' is treated as the initial stat (not generated).
| -
|-
| '''maxStats'''
| Maximum values used to generate the soldier's [[Starting Stats]]. In this case, ''psiSkill'' is treated as the minimum value for the first month of psi training (actual value is 100%-150%).
| -
|-
| '''statCaps'''
| Maximum stats this soldier can gain through [[Experience]]. '''NOTE:''' A stat will still go over the limit once, and then will no longer increase (see [[Experience#Regarding Caps|Regarding Caps]]).
| -
|-
| '''armor'''
| String ID of the [[#Armor|armor]] this soldier uses by default.
| -
|-
| '''standHeight'''
| Height of this soldier when standing.
| 0
|-
| '''kneelHeight'''
| Height of this soldier when kneeling.
| 0
|-
| '''floatHeight'''
| Distance between the bottom of this unit and the ground.
| 0
|-
| '''femaleFrequency'''
| The probability that a female soldier is hired.
| 50
|}

=== AI Units (Aliens/Civilians) ===

Defines an [[Alien Life Forms|alien]] (enemy) or [[civilian]] (neutral) unit, listed in ''"units:"''. Every different alien rank is a different unit, since they have completely different stats. Unit stats are represented as follows:
* [[Time Units|tu]]
* [[Energy|stamina]]
* [[Health|health]]
* [[Bravery|bravery]] (always a multiple of 10)
* [[Reactions|reactions]]
* [[Firing Accuracy|firing]]
* [[Throwing Accuracy|throwing]]
* [[Strength|strength]]
* [[Psi Strength|psiStrength]]
* [[Psi Skill|psiSkill]]
* [[Melee Accuracy|melee]] (not visible)

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the unit name.
| ''required''
|-
| '''race'''
| String ID of the unit race (for alien units).
| -
|-
| '''rank'''
| String ID of the unit rank (for alien units).
| -
|-
| '''stats'''
| Battlescape stats of this unit.
| -
|-
| '''armor'''
| String ID of the [[#Armor|armor]] this unit uses by default.
| -
|-
| '''standHeight'''
| Height of this unit when standing.
| 0
|-
| '''floatHeight'''
| Distance between the bottom of this unit and the ground.
| 0
|-
| '''value'''
| [[Score]] this unit is worth.
| 0
|-
| '''deathSound'''
| Sound ID from [[#Extra_Sounds|BATTLE.CAT]] played when this unit dies.
| -1
|-
| '''aggroSound'''
| Sound ID from [[#Extra_Sounds|BATTLE.CAT]] played when this unit aggros.
| -1
|-
| '''moveSound'''
| Sound ID from [[#Extra_Sounds|BATTLE.CAT]] played when this unit moves.
| -1
|-
| '''intelligence'''
| Intelligence of this unit's AI. The higher the value, the longer this unit remembers player troops between turns.
| 0
|-
| '''aggression'''
| Aggression of this unit's AI. The higher the value, the more ruthless the unit, the more likely to make a frontal assault. Less aggressive units tend to set up ambushes.
Vanilla values are:
* 0 = mostly passive
* 1 = balanced
* 2 = mostly aggresive
| 0
|-
| '''energyRecovery'''
| Energy recovered by the unit each turn (needs verification)
| 40 (?)
|-
| '''specab'''
| Special ability of this unit:
* 0 = None
* 1 = [[Cyberdisc|Explodes on Death]]
* 2 = [[Bio-Drone|Burns Floor]]
* 3 = [[Zombie|Respawns on Death]]
| 0
|-
| '''spawnUnit'''
| String ID of the unit used to respawn on death (eg. [[Zombie]]s respawn as [[Chrysallid]]s).
| -
|-
| '''livingWeapon'''
| Is this unit a living weapon? (only attacks with a '''fixedWeapon''')
| false
|-
|}

=== Alien Races ===

Defines a [[Alien Life Forms|race]] used in [[Alien Missions]], listed in ''"alienRaces:"''. Heavily tied with deployment data.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''id'''
| String ID of the alien race name.
| ''required''
|-
| '''members'''
| Alien crew associated with this alien race (eg. race units + terrorist units), defined by a list of unit string IDs. Order here will define rank in terms of deployment. generally speaking the order is:
* 0 - Commander
* 1 - Leader
* 2 - Engineer
* 3 - Medic
* 4 - Navigator
* 5 - Soldier
* 6 - Terrorist 1
* 7 - Terrorist 2
but of course, not all races have all ranks, so the "fill in" rank would be listed multiple times (see ethereals).
| -
|-
| '''retaliation'''
| retaliation enables/disables the race for retaliation missions.
| ''True''
|-
|}

=== Alien Deployments ===

Defines a Battlescape deployment data used in [[Alien Missions]] (such as alien and map configurations), listed in ''"alienDeployments:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the deployment name.
| ''required''
|-
| '''width'''
| Width of the Battlescape map in grid units.
| 0
|-
| '''length'''
| Length of the Battlescape map in grid units.
| 0
|-
| '''height'''
| Vertical height of the Battlescape map in grid units.
| 0
|-
| '''terrains'''
| list of string IDs of the [[#Terrains|terrain]] to choose from to generate this map. This is not used for UFO sites where the terrain comes from the Geoscape.
| -
|-
| '''shade'''
| Shade of the map (0-15, where 0 is full daytime and 15 is full nighttime). This is not used for UFO sites where the shade comes from the Geoscape.
| 0
|-
| '''nextStage'''
| String ID of the next deployment stage to use after this one, for multi-stage missions.
| -
|-
| '''data'''
| List of deployment data for each alien rank on this mission (see below).
| -
|}

Notes:
* '''terrains''' can also be used with UFOs, with the game using instead the listed terrain rather than the location of the UFO on Geoscape.
==== Deployment Data ====

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''alienRank'''
| [[Alien Rank|Rank]] associated with this deployment data, as defined by the order of the race in question (see above)
| ''required''
|-
| '''lowQty'''
| Maximum quantity of aliens to spawn (beginner).
| 0
|-
| '''highQty'''
| Maximum quantity of aliens to spawn (superhuman).
| 0
|-
| '''dQty'''
| Minimum Desired Quantity of aliens to spawn.
| 0
|-
| '''percentageOutsideUfo'''
| Percentage (0-100%) of aliens to spawn outside in UFO sites.
| 0
|-
| '''itemSets'''
| Three lists (one for each alien technology level) of [[#Items|items]] (string IDs) for the aliens to equip.
| ''required''
|-
|}

=== Research ===

Defines a [[Research|research topic]] that X-COM scientists can investigate, listed in ''"research:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''name'''
| String ID of the research project's name (or item, if a '''lookup''' is defined).
| ''required''
|-
| '''lookup'''
| String ID of the research project's display name and UFOPaedia article reference.
| -
|-
| '''cost'''
| Number of man hours (on average) required to complete this project.
| 0
|-
| '''points'''
| [[Score]] earned for completing this project.
| 0
|-
| '''needItem'''
| Does this project require an [[#Items|item]] of the same name?
| false
|-
| '''dependencies'''
| List of research projects that can unlock access to this one. If the full list is researched, or if one of the projects on the list "unlocks" this one, it becomes available.
| -
|-
| '''unlocks'''
| List of research projects unlocked, regardless of other dependencies, but not requirements, by completing this project (for example, any live alien unlocks "alien origins").
| -
|-
| '''requires'''
| List of research projects unilaterally required before this project can be unlocked (for example, "the martian solution" will not even be considered for unlocking until AFTER "alien origins" is completed).
| -
|-
| '''getOneFree'''
| List of "bonus" research projects that may be granted when completing this project (for example, alien medics will give you information on other alien races). Only applies to living aliens.
| -
|-
|}

=== Manufacture ===

Defines a [[Manufacture|manufacture project]] that X-COM engineers can produce, listed in ''"manufacture:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''name'''
| String ID of the manufacturing project's name (and the item it produces).
| ''required''
|-
| '''category'''
| String ID of the manufacturing project's category.
| -
|-
| '''requires'''
| List of [[#Research|topics]] (string IDs) that must be researched to unlock this project. If none are specified, this project is unlocked from the start.
| -
|-
| '''space'''
| Amount of [[Workshop]] space required to begin this project.
| 0
|-
| '''time'''
| Number of man hours (on average) required per item.
| 0
|-
| '''cost'''
| Monetary deduction per item manufactured.
| 0
|-
| '''requiredItems'''
| List of [[#Items|items]] required and consumed per item manufactured.
| -
|-
| '''producedItems'''
| List of [[#Items|items]] produced per each item consumed. If not specified, defaults to 1 item with the same string ID as the manufacture.
| 1
|-
|}

=== UFOpaedia Article ===

Defines an article in the in-game [[UFOpaedia]], listed in ''"ufopaedia:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''id'''
| String ID of the article name. This must match the ID of the object associated with this article, if applicable.
| ''required''
|-
| '''title'''
| String ID of the article title. If omitted, the '''id''' is used.
| -
|-
| '''type_id'''
| Type of this article:
* 0 = Unknown
* 1 = [[Craft]]
* 2 = [[Craft Armaments]]
* 3 = [[HWP]]
* 4 = [[Equipment (EU)|Equipment]]
* 5 = [[Armour]]
* 6 = [[Base Facilities]]
* 7 = Text & Image (eg. [[Alien Life Forms]], [[UFO Components]])
* 8 = Text (eg. [[Alien Research]])
* 9 = [[UFO]]
| 0
|-
| '''section'''
| String ID of the UFOpaedia section this article belongs in.
| -
|-
| '''requires'''
| List of [[#Research|topics]] (string IDs) that must be researched to unlock this article. If none are specified, this article is unlocked from the start.
| -
|-
| '''image_id'''
| Filename of the [[UP001.SPK-UP042.SPK|background image]] displayed on this article, if applicable.
| -
|-
| '''text'''
| String ID of the description displayed on this article.
| -
|-
| '''text_width'''
| Maximum width of the text displayed, only applicable to ''Text & Image'' articles.
| 0
|-
| '''rect_stats'''
| Rectangle ('''x''', '''y''', '''width''', '''height''') of the stats text on the screen, only applicable to ''Craft'' articles.
| 0
|-
| '''rect_text'''
| Rectangle ('''x''', '''y''', '''width''', '''height''') of the description text on the screen, only applicable to ''Craft'' articles.
| 0
|-
| '''weapon'''
| String ID of the weapon, only applicable to ''HWP'' articles.
| -
|}

=== UFO Trajectories ===

Defines a trajectory carried out by an UFO during an [[#Alien Missions|alien mission]], listed in ''"ufoTrajectories:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''id'''
| String ID of the trajectory name.
| ''required''
|-
| '''groundTimer'''
| Amount of seconds for the UFO to spend on Ground waypoints.
| 0
|-
| '''waypoints'''
| List of waypoints for the UFO to traverse, defined as ''[zone, altitude, speed]''. 
'''zone''': Globe zone where the waypoint is located. 
'''altitude''': UFO altitude after reaching this waypoint:
* 0 - Ground
* 1 - Very Low
* 2 - Low
* 3 - High
* 4 - Very High
'''speed''': UFO speed after reaching this waypoint, as a percentage (0-100%) of its maximum speed.
| -
|}

=== Alien Missions ===

Defines an [[Alien Missions|alien mission]] carried out by UFOs on the Geoscape, listed in ''"alienMissions:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the mission type.
| ''required''
|-
| '''points'''
| [[Score]] allocated to aliens for successfully completing this mission.
| 0
|-
| '''raceWeights'''
| List of alien races likely to carry out this mission, and the % chance of them being allocated to this mission, listed by "number of months after game beginning".
| ''required''
|-
| '''waves'''
| List of UFO waves to spawn as this mission progresses, as described below.
| ''required''
|}

==== Waves ====

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''ufo'''
| String ID of the [[#UFOs|UFO]] to spawn.
| ''required''
|-
| '''count'''
| Number of UFOs to spawn.
| 0
|-
| '''trajectory'''
| String ID of the [[#UFO Trajectories|trajectory]] for this UFO to use when entering Earth's atmosphere.
| ''required''
|-
| '''timer'''
| How long after the previous wave should this wave arrive? (in seconds)
| 0
|-
|}

=== Alien Item Levels ===

This is a list of item level probabilities, with a number between 0 and 2 representing an item level from plasma pistols to heavy plasmas, as defined in the deployments, expressing a 10% probability for that item level being used.

0 = first set (plasma pistol/clip)
1 = second set (plasma rifle/clip)
2 = third set (heavy plasma/clip)

For example:
[ 2, 0, 0, 0, 0, 0, 0, 1, 1, 1 ]
would represent a 60% chance for pistols, 30% rifles, and 10% heavy weapons. 
Note that the order does not matter, but the length DOES. each line MUST have 10 digits.

The above can be confusing. There are 10 fields; each number represents 10%. 
There are six instances of '0'. 6x10% = 60% chance of plasma pistol 
There are three instances of '1'. 3x10% = 30% chance of plasma rifle 
There is only one instance of '2'. 1x10% = 10% chance of heavy plasma 

Each line represents a month after the beginning of the game, and there is no limit to the number defined. 
OpenXCom will use the most recently available item level in the event the game goes on forever.

=== Extra Sprites ===

Adds or replaces sprites in an existing [[Image Formats|X-COM image file]], listed in ''"extraSprites:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| Filename of the original/new image to modify.
| ''required''
|-
| '''width'''
'''height'''
| Size of the sprite(s) in pixels.
| 0
0
|-
| '''singleImage'''
| Is the image file just a single sprite (true) or a spritesheet (false)?
| false
|-
| '''subX'''
'''subY'''
| Size of the subdivision in pixels. If a subdivision is specified, then the image file is divided into chunks to form the sprites (eg. spritesheets).
| 0
0
|-
| '''files'''
| List of the new sprites to add/replace, listed as ''spriteID: filename''.
| -
|}

Example:
- type: GIANTBUNNY.PCK
width: 32
height: 40
files:
0: Resources/Bunny/Bunny00.png
1: Resources/Bunny/Bunny01.bmp
2: Resources/Bunny/Bunny02.gif

=== Extra Sounds ===

Adds or replaces sounds in an existing [[SOUND|X-COM sound file]], listed in ''"extraSounds:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| ID of the original sound file to modify:
* BATTLE.CAT - Battlescape sounds, corresponds to ''SOUND1.CAT'' or ''SAMPLE2.CAT'' (55 sounds).
* INTRO.CAT - Intro sounds, corresponds to ''INTRO.CAT'' or ''SAMPLE3.CAT'', probably best not to mess with these.
* GEO.CAT - Geoscape sounds, corresponds to ''SOUND2.CAT'' or ''SAMPLE.CAT'' (14 sounds).
| ''required''
|-
| '''files'''
| List of the new sounds to add/replace, listed as ''soundID: filename''.
| -
|}

Example:
- type: BATTLE.CAT
files:
55: Resources/Sounds/sample.wav

=== Extra Strings ===

Adds or replaces text strings in an existing [[Translations (OpenXcom)|OpenXcom language file]], listed in ''"extraStrings:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| Filename of the original language file to modify, sans extension.
| ''required''
|-
| '''strings'''
| List of the new strings to add/replace, listed as ''stringID: text''.
| -
|}

Example:
- type: en-US
strings:
STR_SNIPER_RIFLE: Sniper Rifle
STR_SNIPER_RIFLE_CLIP: Sniper Rifle Clip
- type: en-GB
strings:
STR_SNIPER_RIFLE: Sniper Rifle
STR_SNIPER_RIFLE_CLIP: Sniper Rifle Clip
- type: de
strings:
STR_SNIPER_RIFLE: Scharfschützengewehr
STR_SNIPER_RIFLE_CLIP: Scharfschützengewehrmunition
- type: ru
strings:
STR_SNIPER_RIFLE: Снайперская винтовка
STR_SNIPER_RIFLE_CLIP: Магазин к снайп. винтовке

=== Interfaces ===

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| ''?''
| -
|-
| '''elements'''
| ''?''
| -
|-
| '''id'''
| ''?''
| -
|-
| '''color'''
| ''?''
| -
|}

=== StatStrings ===

[[Statstrings]] are used for automatically renaming soldiers. They are case sensitive and they are processed in the order in which they are specified.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''string'''
| String to add to name.
| ''required''
|-
| '''psiStrength''' 
'''psiSkill''' 
'''bravery''' 
'''strength''' 
'''firing''' 
'''reactions''' 
'''stamina''' 
'''tu''' 
'''health''' 
'''throwing'''
| One or more stat ranges are ANDed together for success. Each range has a minVal and maxVal. Use YAML standard tilde (~) to indicate null. ((~) = 0 as minvalue; (~) =255 as maxvalue)
| -
|}

Example:
statStrings:
- string: "x"
psiStrength: [~, 30]
- string: "P"
psiStrength: [80, ~]
- string: "p"
psiStrength: [60, 79]
- string: "K"
psiSkill: [60, ~]
- string: "k"
psiSkill: [30, 59]
- string: "b"
bravery: [60, ~]
- string: "c"
bravery: [~, 10]
- string: "w"
strength: [~, 25]
- string: "Snpr"
firing: [60, ~]
reactions: [60, ~]
- string: "M"
firing: [70, ~]
- string: "m"
firing: [60, 69]
- string: "Sct"
reactions: [50, ~]
tu: [60, ~]
- string: "R"
reactions: [60, ~]
- string: "r"
reactions: [50, 59]

==References==
<references />

[[Category:OpenXcom]]

Ruleset Reference (OpenXcom)

2014-12-04T18:47:02Z

Falko: /* Armor */

A reference of all the customizable values of everything in a [[Rulesets (OpenXcom)|ruleset]]. Some guidelines:
* If a value is omitted from the ruleset, the default is used. You cannot omit ''required'' values.
* Text strings (eg. names) are represented by string IDs from the [[Translations (OpenXcom)|language files]]
* Numerical IDs (used for sprites, sounds, etc.) start at 0, not 1.
* Boolean (yes/no) values are represented by true/false.
* World coordinates are represented in degrees (see [[WORLD.DAT]]).
* Money amounts (prices, costs, etc.) are represented in dollars.
* All paths are '''case sensitive'''! If your ruleset uses external files, make sure that they named properly as described in ruleset.

Items are ordered as they come in the ruleset. To override this, you can specify a ''listOrder''. You can find the default listOrders in [[Ruleset List Order (OpenXcom)|Ruleset List Order]].

=== Globe ===

Defines the drawing of landmasses and borders on the globe.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''data'''
| Path name of file which contains polygon and texture information. (For example WORLD.DAT).
| -
|-
| '''polygons'''
| List of polygons drawn on the globe surface. A triangle consist of seven values: the first number defines the texture, followed by three pairs of (x,y) globe coordinates. Only polygons with 3 or 4 vertices are reliable shown on the globe = 7 or 9 values per entry.
| -
|-
| '''polylines'''
| List of border lines. Each list entry consist of a list of (x,y) globe coordinates.
| -
|}

=== Countries ===

Defines one of the [[Country Funding (EU)|funding nations]], listed in ''"countries:"''. They're used for activity graphs and player scoring.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the country name.
| ''required''
|-
| '''fundingBase'''
| Country's base funding, in thousands. The starting funding can be anywhere between 1x and 2x the base funding.
| 0
|-
| '''fundingCap'''
| Country's funding cap, in thousands. Once a country reaches this maximum, it will no longer increase its funding.
| 0
|-
| '''labelLon'''
'''labelLat'''
| Longitude and latitude coordinates of the country's label on the globe. This label is only shown when the globe is zoomed in and "detail" is turned on.
| 0.0
0.0
|-
| '''areas'''
| List of "rectangles" on the globe defined as [''lon1'' ''lat1'' ''lon2'' ''lat2'']. Any activity within these areas counts towards the country's graph activity and affects their opinion of the player.
| -
|}

=== Regions ===

Defines one of the [[Geoscape (EU)#World Regions/Countries|world regions]], listed in ''"regions:"''. They're used for base placement, activity graphs and mission spawning.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the region name.
| ''required''
|-
| '''cost'''
| Amount of money spent building an X-COM base in this region (first base is free).
| 0
|-
| '''areas'''
| List of "rectangles" on the globe defined as ''[lon1, lat1, lon2, lat2]''. Any activity within these areas counts towards the region's graph activity.
| -
|-
| '''cities'''
| List of cities belonging to this region. They will be displayed on the globe and used for terror site missions. Each city is defined by their '''lon''' and '''lat''' coordinates and a '''name''' string ID.
| -
|-
| '''regionWeight'''
| Weight of this region when selecting regions for alien missions.
| 0
|-
| '''missionWeights'''
| Weighted list of the different mission types for this region (eg. ''STR_ALIEN_RESEARCH: 14'').
| -
|-
| '''missionZones'''
| List of "rectangles" (''[lon1, lat1, lon2, lat2]'') defining the mission zones for this region. Mission zones are waypoints for UFO trajectories.
| -
|-
| '''missionRegion'''
| Spawn mission in this region instead (used for regions without land).
| -
|}

=== Base Facilities ===

Defines one of the [[Base Facilities (EU)|facilities]] that can be built in an X-COM base, listed in ''"facilities:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the facility name.
| ''required''
|-
| '''requires'''
| List of [[#Research|topics]] (string IDs) that must be researched to unlock this facility. If none are specified, this facility is unlocked from the start.
| -
|-
| '''spriteShape'''
| Sprite ID from [[BASEBITS.PCK]] used to draw the facility's outer shape in the Basescape and UFOpaedia.
| -1
|-
| '''spriteFacility'''
| Sprite ID from [[BASEBITS.PCK]] used to draw the facility's contents in the Basescape and UFOpaedia. Drawn on top of '''spriteShape'''.
| -1
|-
| '''lift'''
| Is this facility an [[Access Lift]]? All base facilities must be connected to the lift.
| false
|-
| '''hyper'''
| Is this facility a [[Hyperwave Decoder]]? Displays extra information for detected UFOs. Only valid for radar facilities.
| false
|-
| '''mind'''
| Is this facility a [[Mind Shield]]? Reduces the chance of UFOs finding your base. Does not stack.
| false
|-
| '''grav'''
| Is this facility a [[Grav Shield]]? Doubles the power of your base defenses. Does not stack.
| false
|-
| '''size'''
| Size of the facility, in grid units. Every facility is square, so a size of 1 means 1x1, 2 means 2x2, etc. Bigger facilities are made up of multiple sprites, for example a 2x2 facility will use 4 sprites for '''spriteShape''' and 4 sprites for '''spriteFacility''' (top-left, top-right, bottom-left, bottom-right).
| 1
|-
| '''buildCost'''
| Amount of money spent to build this facility in the base.
| 0
|-
| '''buildTime'''
| Amount of days it takes for this facility to be built.
| 0
|-
| '''monthlyCost'''
| Amount of money spent monthly for the maintenance of this facility.
| 0
|-
| '''storage'''
| Amount of storage space (for items) this facility provides. See [[Base Stores]].
| 0
|-
| '''personnel'''
| Amount of personnel (soldiers, scientsts, engineers) these quarters can contain.
| 0
|-
| '''aliens'''
| Amount of live aliens this facility can contain. Only checked if the ''alienContainmentLimitEnforced'' option is enabled.
| 0
|-
| '''crafts'''
| Amount of X-COM craft this facility can contain.
| 0
|-
| '''labs'''
| Amount of lab space this facility provides for research projects.
| 0
|-
| '''workshops'''
| Amount of workshop space this facility provides for manufacture projects.
| 0
|-
| '''psiLabs'''
| Amount of soldier space this facility provides for psionic training.
| 0
|-
| '''radarRange'''
| Maximum radar detection range of this facility, in nautical miles.
| 0
|-
| '''radarChance'''
| Chance (0-100%) of this radar detecting a UFO that enters its range.
| 0
|-
| '''defense'''
| Offensive power provided by this base defense against attacking UFOs.
| 0
|-
| '''hitRatio'''
| Chance (0-100) of the base defense hitting an attacking UFO.
| 0
|-
| '''fireSound'''
| Sound ID from [[#Extra_Sounds|GEO.CAT]] played when the base defense fires.
| -1
|-
| '''hitSound'''
| Sound ID from [[#Extra_Sounds|GEO.CAT]] played when the base defense hits a target.
| -1
|-
| '''mapName'''
| [[MAPS|Map]] associated to this facility in Battlescape base defenses.
| -
|-
|}

=== Crafts ===

Defines one of the [[Craft|X-COM crafts]] that go on interception missions, listed in ''"crafts:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the craft name.
| ''required''
|-
| '''requires'''
| List of [[#Research|topics]] (string IDs) that must be researched to unlock this craft. If none are specified, this craft is unlocked from the start.
| -
|-
| '''sprite'''
| Sprite ID from [[BASEBITS.PCK]] used to draw this craft in the Basescape and from [[INTICON.PCK]] used to draw the damage indicator in dogfights.
modders: the corresponding extrasprite file id for BASEBITS.PCK is sprite+33 INTICON.PCK contains a minimized icon id=sprite the file id for the dogfight image is sprite+11
| -1
|-
| '''fuelMax'''
| Maximum amount of fuel this craft can carry. Crafts use up fuel based on their speed while travelling.
| 0
|-
| '''damageMax'''
| Maximum amount of damage this craft can take. If this amount is exceeded, the craft is destroyed.
| 0
|-
| '''speedMax'''
| Maximum speed in nautical miles. Crafts travel at max speed when flying and half speed when patrolling.
| 0
|-
| '''accel'''
| Aceeleration value shown in the UFOpaedia.
| 0
|-
| '''weapons'''
| Amount of craft weapons this craft can equip. The UI can only display a max of 2 weapons.
| 0
|-
| '''soldiers'''
| Amount of soldiers this craft can carry.
| 0
|-
| '''maxItems'''
| Amount of items this craft can carry.
| 80
|-
| '''vehicles'''
| Amount of vehicles this craft can carry.
| 0
|-
| '''costBuy'''
| Amount of money spent for purchasing this craft. If set to 0, the craft will not be available in the Purchase/Recruit screen.
| 0
|-
| '''costRent'''
| Amount of money spent monthly for renting this craft. If set to 0, the craft is not on rental and won't count towards base maintenance.
| 0
|-
| '''costSell'''
| Amount of money gained for selling this craft.
| 0
|-
| '''refuelItem'''
| Item required for refuelling this craft. If no item is specified, the craft uses human fuel.
| 0
|-
| '''repairRate'''
| Amount of damage restored every hour while [[Repairs|Repairing]] in base.
| 1
|-
| '''refuelRate'''
| Amount of fuel restored every 30 mins while [[Refueling]] in base. If specified, a '''refuelItem''' is spent each time.
| 1
|-
| '''radarRange'''
| Detection range of the craft's radar in nautical miles. Every craft radar has a 100% detection chance.
| 600
|-
| '''transferTime'''
| Number of hours it takes to purchase/transfer this craft to a base.
| 0
|-
| '''score'''
| [[Score]] lost when this craft is destroyed.
| 0
|-
| '''spacecraft'''
| Can this craft go to [[Cydonia]]?
| false
|-
| '''battlescapeTerrainData'''
| [[#Terrains|Terrain]] associated to this craft in Battlescape missions.
| -
|}

=== Craft Weapons ===

Defines one of the [[Craft Armaments|weapons]] equipped by X-COM craft for shooting down UFOs, listed in ''"craftWeapons:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the weapon name.
| ''required''
|-
| '''sprite'''
| Sprite ID from [[BASEBITS.PCK]] used to draw the weapon in the Basescape and from [[INTICON.PCK]] used to draw the weapon in dogfights.
modders: the corresponding extrasprites file id for INTICON.PCK is sprite+5 and sprite+48 for BASEBITS.PCK
| -1
|-
| '''sound'''
| Sound ID from [[#Extra_Sounds|GEO.CAT]] played when this weapon fires.
| -1
|-
| '''damage'''
| Amount of damage this weapon does to enemy UFOs.
| 0
|-
| '''range'''
| Maximum range of this weapon in dogfights (in meters).
| 0
|-
| '''accuracy'''
| Chance (0-100%) of each shot hitting the enemy UFO.
| 0
|-
| '''reloadCautious'''
| Time this weapon takes to fire between each shot in ''Cautious Mode''.
| 0
|-
| '''reloadStandard'''
| Time this weapon takes to fire between each shot in ''Standard Mode''.
| 0
|-
| '''reloadAggressive'''
| Time this weapon takes to fire between each shot in ''Aggressive Mode''.
| 0
|-
| '''ammoMax'''
| Maximum amount of ammo this weapon can carry.
| 0
|-
| '''rearmRate'''
| Amount of ammo restored every 30 mins while the craft is [[Rearming]] in base. If specified, '''clip'''s are spent depending on their '''clipSize'''. If the '''clipSize''' of the specified ammo is 0, no '''clip'''s are spent.
| 1
|-
| '''projectileType'''
| Type of the weapon projectile, used for the projectile sprite in dogfights:
* 0 - [[Stingray]]
* 1 - [[Avalanche]]
* 2 - [[Cannon]]
* 3 - [[Fusion Ball]]
* 4 - [[Laser Cannon]]
* 5 - [[Plasma Beam]]
| 2
|-
| '''projectileSpeed'''
| Speed of the weapon projectile in dogfights.
| 0
|-
| '''launcher'''
| String ID of the [[#Items|item]] required to equip this weapon.
| -
|-
| '''clip'''
| String ID of the [[#Items|item]] required to rearm this weapon.
| -
|}

=== Items ===

Defines the Geoscape and Battlescape properties of an [[Equipment (EU)|item]] that can be stored in X-COM bases, listed in ''"items:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the internal item name.
| ''required''
|-
| '''name'''
| String ID of the displayed item name, for cases where it's different from the internal name. If omitted, '''type''' is used.
| -
|-
| '''requires'''
| List of [[#Research|topics]] (string IDs) that must be researched to unlock this item. If none are specified, this item is unlocked from the start. Soldiers can only use unlocked items in the Battlescape.
| -
|-
| '''size'''
| Space occupied by this item in [[Base Stores]]. Can be a decimal value.
| 0.0
|-
| '''costBuy'''
| Amount of money spent for purchasing this item. If set to 0, this item will not be available in the Purchase/Recruit screen.
| 0
|-
| '''costSell'''
| Amount of money gained for selling this item.
| 0
|-
| '''transferTime'''
| Number of hours it takes to purchase/transfer this item to a base.
| 24
|-
| '''weight'''
| [[Item_Weight|Weight]] occupied by this item in a soldier's inventory.
| 999
|-
| '''bigSprite'''
| Sprite ID from [[BIGOBS.PCK]] used to draw this item in a soldier's inventory and UFOpaedia.
| -1
|-
| '''floorSprite'''
| Sprite ID from [[FLOOROB.PCK]] used to draw this item on the floor of a Battlescape tile.
| -1
|-
| '''handSprite'''
| Sprite ID from [[HANDOB.PCK]] used to draw this item on a soldier's hand in the Battlescape.
modders: each handobject needs 8 images (8 directions) define the extrasprites accordingly
| 120
|-
| '''bulletSprite'''
| Sprite ID from ''BulletSprites.png'' used to draw this weapon's projectile on the Battlescape:
* 0 - [[Rocket Launcher]]
* 1 - [[Pistol]]
* 2 - [[Rifle]]
* 3 - [[Auto Cannon]]
* 4 - [[Heavy Cannon]]
* 5 - [[Laser Pistol]]
* 6 - [[Laser Rifle]]
* 7 - [[Heavy Laser]]
* 8 - [[Plasma Rifle|Plasma]]
* 9 - [[Small Launcher]]
* 10 - [[Blaster Launcher]]
for modders: the bulletsprite needs to be put into the extraSprites type "Projectiles" the bulletsprite can contain up to 35 3x3 images. The corresponding file id is 35*[bulletSprite]
| -1
|-
| '''fireSound'''
| Sound ID from [[#Extra_Sounds|BATTLE.CAT]] played when this weapon fires.
| -1
|-
| '''hitSound'''
| Sound ID from [[#Extra_Sounds|BATTLE.CAT]] played when this weapon hits a target.
| -1
|-
| '''hitAnimation'''
| Sprite ID from [[SMOKE.PCK]] used to draw the weapon's "hit explosion".
'''NOTE''': Do not define this value for melee/psi weapons, they use [[HIT.PCK]] and therefore meleeAnimation instead.
| 0
|-
| '''power'''
| Average damage of the weapon, in most cases it will be +-50% this value.
| 0
|-
| '''strengthApplied'''
| Add the attacking unit's strength to this weapon's damage.
| false
|-
| '''compatibleAmmo'''
| List of string IDs of the ammo items that can be loaded on this weapon. If none are specified, the weapon doesn't need ammo.
| -
|-
| '''damageType'''
| What type of [[damage]] does this weapon do:
* 0 - None
* 1 - Armor Piercing
* 2 - Incendiary
* 3 - High Explosive
* 4 - Laser
* 5 - Plasma
* 6 - Stun
* 7 - Melee
* 8 - Acid
* 9 - Smoke
'''NOTE:''' A damage type other than 0-9 will do nothing.
| 0
|-
| '''tuAuto'''
'''accuracyAuto'''
| The percentage (0-100%) of [[Time Units]] (from the soldier's total) required to fire an Auto Shot. If 0, the weapon does not have an Auto Shot.
The base accuracy (0-100%) applied to a soldier's [[Firing Accuracy]] when firing an Auto Shot.
| 0
0
|-
| '''tuSnap'''
'''accuracySnap'''
| The percentage (0-100%) of [[Time Units]] (from the soldier's total) required to fire a Snap Shot. If 0, the weapon does not have a Snap Shot.
The base accuracy (0-100%) applied to a soldier's [[Firing Accuracy]] when firing a Snap Shot.
| 0
0
|-
| '''tuAimed'''
'''accuracyAimed'''
| The percentage (0-100%) of [[Time Units]] (from the soldier's total) required to fire an Aimed Shot. If 0, the weapon does not have an Aimed Shot.
The base accuracy (0-100%) applied to a soldier's [[Firing Accuracy]] when firing an Aimed Shot.
| 0
0
|-
|-
| '''tuMelee'''
'''accuracyMelee'''
| The percentage (0-100%) of [[Time Units]] (from the soldier's total) required to do a melee attack (Hit). If 0, the weapon does not have a melee attack.
The base accuracy (0-100%) applied to a soldier's [[Melee Accuracy]] when doing a melee attack.
| 0
0
|-
| '''clipSize'''
| The amount of ammo stored in each weapon clip. If -1 is specified, this weapon has infinite ammo.
| 0
|-
| '''battleType'''
| Defines the weapon's behavior in the Battlescape:
* 0 - None (Geoscape-only item)
* 1 - [[Weapons|Firearm]]
* 2 - Ammo
* 3 - Melee
* 4 - [[Grenade]]
* 5 - [[Proximity Grenade]]
* 6 - [[Medi-Kit (EU)|Medi-Kit]]
* 7 - [[Motion Scanner]]
* 8 - [[Mind Probe]]
* 9 - [[Psi-Amp]]
* 10 - [[Electro-flare]]
* 11 - Corpse
| 0
|-
| '''twoHanded'''
| Is this weapon two-handed? If true, incurs an accuracy penalty if used with both hands occupied. Note that the handsprite of a twoHanded item is also drawn at a slightly different position than a one handed item.
| false
|-
| '''waypoint'''
| Does this weapon use waypoints? (eg. [[Blaster Launcher]]). Can also be used to make ammo items use the waypoint system.
| false
|-
| '''fixedWeapon'''
| Is this weapon fixed? (it's part of a unit, eg. tanks and terrorist units)
| false
|-
| '''invWidth'''
| Item width in a soldier's inventory (in grid units).
| 1
|-
| '''invHeight'''
| Item height in a soldier's inventory (in grid units).
| 1
|-
| '''painKiller'''
| Amount of painkillers contained in a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''heal'''
| Amount of heal's contained in a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''stimulant'''
| Amount of stimulants contained in a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''woundRecovery'''
| Amount of [[Fatal Wounds]] treated by each heal of a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''healthRecovery'''
| Amount of [[Health]] recovered by each heal of a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''stunRecovery'''
| Amount of [[Stun]] removed by each stimulant of a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''energyRecovery'''
| Amount of [[Energy]] recovered by each stimulant of a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''tuUse'''
| Amount of [[Time Units]] required to use this item (for non-offensive items). It's a flat rate if '''flatRate''' is true, otherwise it's a percentage (0-100%).
| 0
|-
| '''recoveryPoints'''
| [[Score]] gained for recovering this alien artifact.
| 0
|-
| '''armor'''
| How much damage is needed to destroy this item on the ground.
| 20
|-
| '''recover'''
| Is this item recoverable? (gets transported to the X-COM base on mission success)
| true
|-
| '''turretType'''
| Sprite ID from [[TANKS.PCK]] of the turret to assign to this tank:
* 0 - [[Tank/Cannon]]
* 1 - [[Tank/Rocket Launcher]]
* 2 - [[Tank/Laser Cannon]]
* 3 - [[Hovertank/Plasma]]
* 4 - [[Hovertank/Launcher]]
| -1
|-
| '''liveAlien'''
| Does this item represent a live alien? (counts towards [[Alien Containment]])
| false
|-
| '''blastRadius'''
| Size of the projectile explosions. 0 for no explosion. -1 to automatically calculate based on weapon power and damage type (actual '''blastRadius''' currently is capped due [[Explosions#Playing_With_Fire|Explosion calculations]]).
| -1
|-
| '''flatRate'''
| If true, then TU costs for this weapon are a flat rate (instead of a percentage of unit TUs).
| false
|-
| '''arcingShot'''
| Does this weapon fire in an arc?
| false
|-
| '''attraction'''
| Represents how likely an alien is to pick up this item. Values below 5 will be ignored (by design).
| 0
|-
| '''maxRange'''
| Maximum range at which this weapon can operate.
| 200
|-
| '''aimRange'''
| Maximum effective range with this weapon before which range-based dropoff occurs.
| 200
|-
| '''snapRange'''
| Maximum effective range with snap shot before which range-based dropoff occurs. (ufoextender accuracy only)
| 15
|-
| '''autoRange'''
| Maximum effective range with auto shot before which range-based dropoff occurs. (ufoextender accuracy only)
| 7
|-
| '''minRange'''
| Range-based dropoff will work in reverse for ranges below this.
| 0
|-
| '''dropoff'''
| The value by which the accuracy lowers for each tile after (or before) the thresholds above.
| 2
|-
| '''bulletSpeed'''
| How much faster (or slower, if you use a negative number) is a projectile fired from this weapon compared to the average.
| 0
|-
| '''autoShots'''
| How many auto shots does this weapon fire.
| 3
|-
| '''shotgunPellets'''
| Number of projectiles fired per unit of ammunition. (note: due to engine limitations it is currently impossible to draw multiple projectiles in flight.)
| 0
|-
| '''zombieUnit'''
| String ID of the unit used for zombification (eg. [[Chrysallid]]s turn units into [[Zombie]]s).
| none
|-
| '''meleeSound'''
| Sound ID from [[#Extra_Sounds|BATTLE.CAT]] played when this weapon attacks a target with melee.
| 39
|-
| '''meleeHitSound'''
| Sound ID from [[#Extra_Sounds|BATTLE.CAT]] played when this weapon HITS a target with melee.
| -1
|-
| '''meleeAnimation'''
| Sprite ID from HIT.PCK played when this weapon attacks a target with melee.
| 0
|-
| '''meleePower'''
| Damage this weapon will do when using melee. This only applies to Firearms, and is only available as stun damage. For normal melee weapons, use regular power and damage types.
| 0
|-
| '''LOSRequired'''
| Does this item require line of sight? (only applies to mind probes and psi-amps)
| false
|-
| '''skillApplied'''
| Is melee skill applied to the accuracy of an attack made with this object?
| true
|-
|}

=== UFOs ===

Defines one of the [[UFOs]] that invade Earth, listed in ''"ufos:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the UFO name.
| ''required''
|-
| '''size'''
| String ID of the UFO size.
| STR_VERY_SMALL
|-
| '''sprite'''
| Sprite ID from [[INTERWIN.DAT]] used to draw this UFO in the dogfight view and UFOpaedia.
don't try to add more images if you don't want to punch yourself in the face - use modsprite
| -1
|-
| '''modSprite'''
| Filename used to draw this UFO in the dogfight view and UFOpaedia.
| -
|-
| '''damageMax'''
| Maximum amount of damage this UFO can take. If the UFO takes 50% damage, it crash lands. If it takes 100% damage, it is destroyed.
| 0
|-
| '''speedMax'''
| Maximum speed in nautical miles.
| 0
|-
| '''accel'''
| Aceeleration value shown in the UFOpaedia.
| 0
|-
| '''power'''
| Damage power of this UFO's weapon in dogfights.
| 0
|-
| '''range'''
| Maximum range of this UFO's weapon in dogfights (in meters).
| 0
|-
| '''score'''
| [[Score]] gained when this UFO is destroyed, or half this score if it crash lands.
| 0
|-
| '''reload'''
| Time the UFO's weapon takes to fire between each shot.
| 0
|-
| '''breakOffTime'''
| Minimum amount of time for the UFO to be able to break off of a dogfight.
| 0
|-
| '''battlescapeTerrainData'''
| [[#Terrains|Terrain]] associated to this UFO in Battlescape missions.
| ''required''
|-
|}

=== Inventory Sections ===

Defines one of the sections of the [[Inventory TU Table|Battlescape inventory]] (eg. Backpack), listed in ''"invs:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the inventory name.
| ''required''
|-
| '''x'''
'''y'''
| Pixel coordinates of this section on the inventory screen.
| 0
0
|-
| '''type'''
| Type of this section:
* 0 = Slot section, can contain as many items as will fit on the slots.
* 1 = Hand section, can only contain one item regardless of size.
* 2 = Ground section, can contain infinite items.
| 0
|-
| '''slots'''
| List of the grid slots (''[x, y]'') that this section is composed of. For example, to make a 2x2 section, you would have ''[0, 0] [0, 1] [1, 0] [1, 1]''.
| -
|-
| '''costs'''
| List of [[Time Units]] costs to move an item from this section to another one (eg. ''STR_BACKPACK: 16'' means it will cost 16 TUs to move an item from this section to the Backpack).
| -
|-
|}

=== Terrains ===

Defines one of the [[TERRAIN|terrains]] used to generate a Battlescape map, listed in "terrains:".

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''name'''
| String ID of the terrain name.
| ''required''
|-
| '''largeBlockLimit'''
| Maximum amount of large blocks that can be used on map generation.
| 0
|-
| '''textures'''
| List of [[TEXTURE.DAT|Geoscape textures]] that correspond to this terrain.
| -
|-
| '''hemisphere'''
| Geoscape hemisphere associated with this terrain:
* -1 - Northern hemisphere.
* 0 - Both hemispheres.
* 1 - Southern hemisphere.
| 0
|-
| '''mapDataSets'''
| List of filenames (each with matching [[MCD]]/[[Image Formats#PCK|PCK/TAB]] files) that contain the tiles of this terrain.
| -
|-
| '''mapBlocks'''
| List of map blocks (see below) that are used for generating a map.
| -
|-
| '''roadTypeOdds'''
| Odds as a % of generating each type of road (E-W Road, N-S Road, Crossing) odds for crossing are: 100 - EW - NS.
| [0 0]
|-|-
| '''civilianTypes'''
| List of units to use as civilians for this mission.
| [MALE_CIVILIAN, FEMALE_CIVILIAN]
|-
|}

==== Map Blocks ====

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''name'''
| Filename of the [[MAPS|map]].
| ''required''
|-
| '''width'''
| Width of this map block in Battlescape grid units.
| 0
|-
| '''length'''
| Length of this map block in Battlescape grid units.
| 0
|-
| '''height'''
| Height of this map block in Battlescape grid units.
| 1
|-
| '''type'''
| Type of this map block:
* -1 - Undefined
* 0 - Default
* 1 - Landing Zone (for placing X-COM / alien craft)
* 2 - E-W Road (for city maps)
* 3 - N-S Road (for city maps)
* 4 - Road Crossing (for city maps)
* 5 - Dirt (for filling empty base blocks)
* 6 - X-COM spawn point (for [[Alien Base]] / [[Cydonia]] missions)
* 7 - [[Alien Base]] Target
* 8 - [[Cydonia]] Target
| -1
|-
| '''subType'''
| Sub-type of this map block (see '''type''').
| -1
|-
| '''frequency'''
| Frequency of this block in a map.
| 1
|-
| '''maxCount'''
| Maximum amount of times this block can be used in a map. If -1 there is no limit.
| -1
|-
| '''items'''
| An array of items to add to this mapblock, an the positions to place them at.
| -1
|}

*'''frequency''' defines the odds of the map appearing on the map
** The value assigned (default: 1) is used in ''x/n'', which defines the probability of being chosen.
** ''x'' is the integer defined for the map block's frequency and ''n'' is the combined total of probabilities for all the map types combined.
** This property can only be used in type 0 map blocks.
*'''maxCount''' is the maximum number of times it can be used.
** The value assigned is also used in ''x/n'' to determine the probability of being chosen.
** Each use reduces ''x'' by -1, with the caveat that being used as a Landing Zone type will not reduce the x value since it could result in no available Landing Zones.
** This property can only be used in type 0 map blocks.
* '''hemisphere''' only applies to UFO missions, not Terror ones.
*'''width/length''' defines the size of the map
** be aware that the mapview "width"-label is the openxcom ruleset length parameter
** be aware that the mapview "length"-label is the openxcom ruleset width parameter

==== Guidelines/Tips ====
* All maps with an XCOM/Alien craft require at least one type 1 map block. This map block can only contain ground tiles (no walls or objects), otherwise the game will crash or the walls/objects will be removed.
* All Terror terrains (listed under STR_TERROR_MISSION) require at least 1 map block of '''Types''' 2, 3 and 4 (for a total of 3 maps, which are required to place roads) and the corresponding '''roadTypeOdds''' added to the ruleset.
* If there isn't any map blocks designed as roads since you want to keep your terrain 'random', this can be circumvented by designating all 10x10 map blocks, excluding the one(s) used for the XCOM craft, as either '''Type''' 2, 3 and 4 and by defining their '''subType''' to 0. The game will then randomly choose between the map blocks for each type used in the roads, making them map more random.

=== Armor ===

Defines a Battlescape unit's [[armor]] as well as visual representation (so every unit has an armor), listed in ''"armors:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the armor name.
| ''required''
|-
| '''spriteSheet'''
| Sprite sheet from [[UNITS]] used to draw a unit wearing this armor.
| -
|-
| '''spriteInv'''
| Sprite used for the [[Inventory Backgrounds]] of a unit wearing this armor.
| -
|-
| '''corpseBattle'''
| List of string IDs of the corpse [[#Items|items]] generated when a unit wearing this armor is killed (one per unit tile) on the Battlescape.
| -
|-
| '''corpseGeo'''
| String ID of the corpse [[#Items|item]] associated with this unit on the Geoscape.
| -
|-
| '''storeItem'''
| String ID of the [[#Items|item]] that represents this armor in [[Base Stores]] for equipping.
| -
|-
| '''weight'''
| Physical weight of the armor when worn
| 6
|-
| '''stats'''
| like soldier stats (see below) but these are treated as stat bonuses for wearing the specific armor.
| -
|-
| '''frontArmor'''
| Protection provided on the front of the unit.
| 0
|-
| '''sideArmor'''
| Protection provided on the sides of the unit.
| 0
|-
| '''rearArmor'''
| Protection provided on the rear of the unit.
| 0
|-
| '''underArmor'''
| Protection provided under the unit (eg. from explosions).
| 0
|-
| '''drawingRoutine'''
| Drawing routine used to put together the body parts in the unit's '''spriteSheet''':
* 0 = [[Soldier]], [[Sectoid]]
* 1 = [[Floater]]
* 2 = [[HWP]]
* 3 = [[Cyberdisk]]
* 4 = [[Civilian]], [[Ethereal]]
* 5 = [[Sectopod]], [[Reaper]]
* 6 = [[Snakeman]]
* 7 = [[Chryssalid]]
* 8 = [[Silacoid]]
* 9 = [[Celatid]]
* 10 = [[Muton]]
* 11 = [[Submersible Weapons Systems]]
* 12 = [[Hallucinoid]]
* 13 = [[Aquanauts]]
* 14 = [[Calcinite]], [[Deep One]], [[Gillman]], [[Lobster Man]], [[Tasoth]]
* 15 = [[Aquatoid]]
* 16 = [[Bio-Drone]]
| 0
|-
| '''movementType'''
| Type of movement provided by this armor:
* 0 = Walking
* 1 = Flying
* 2 = Sliding (no walking animation)
it also defines the body of an tank (32-images) in your spriteSheet or the change in sprites while flying using a flying armour see: [[TANKS.PCK]], [[XCOM_2.PCK]]
| 0
|-
| '''damageModifier'''
| List of decimal damage modifiers (1.0 = 100%) this armor applies to each damage type (see [[#Items|Items section]]) received. Modifiers must be specified for all damage types, in this order:
* None
* Armor Piercing
* Incendiary
* High Explosive
* Laser
* Plasma
* Stun
* Melee
* Acid
* Smoke
|
- 1.0 
- 1.0 
- 1.0 
- 1.0 
- 1.0 
- 1.0 
- 1.0 
- 1.0 
- 1.0 
- 1.0
|-
| '''size'''
| Size of the unit wearing this armor, in Battlescape grid units. Every unit is square, so a size of 2 means 2x2.
| 1
|-
| '''loftempsSet'''
| List of [[LOFTEMPS]] IDs (one per unit tile, so a 1x1 unit has 1, a 2x2 unit has 4, etc.) used to represent a unit wearing this armor in 3D space.
| -
|-
| '''loftemps'''
| loftemps is a deprecated option that only works for 1x1 sized units.
| -
|-
| '''forcedTorso'''
| soldier sprites have female and male torsos. some armours reuse these sprites for flying/non flying torso without difference between genders. This can be controlled by the parameter: 0 = use genderrelated torso, 1 = use male torso, 2 = use female torso
| 0

|}

=== Player Units (Soldiers) ===

Defines a [[soldier]] recruited by X-COM, listed in ''"soldiers:"''. Currently only one soldier unit type (''XCOM'') is supported.

Unit stats are represented as follows:
* [[Time Units|tu]]
* [[Energy|stamina]]
* [[Health|health]]
* [[Bravery|bravery]] (always a multiple of 10)
* [[Reactions|reactions]]
* [[Firing Accuracy|firing]]
* [[Throwing Accuracy|throwing]]
* [[Strength|strength]]
* [[Psi Strength|psiStrength]]
* [[Psi Skill|psiSkill]]
* [[Melee Accuracy|melee]] (not visible)

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the soldier name.
| ''required''
|-
| '''minStats'''
| Minimum values used to generate the soldier's [[Starting Stats]]. In this case, ''psiSkill'' is treated as the initial stat (not generated).
| -
|-
| '''maxStats'''
| Maximum values used to generate the soldier's [[Starting Stats]]. In this case, ''psiSkill'' is treated as the minimum value for the first month of psi training (actual value is 100%-150%).
| -
|-
| '''statCaps'''
| Maximum stats this soldier can gain through [[Experience]]. '''NOTE:''' A stat will still go over the limit once, and then will no longer increase (see [[Experience#Regarding Caps|Regarding Caps]]).
| -
|-
| '''armor'''
| String ID of the [[#Armor|armor]] this soldier uses by default.
| -
|-
| '''standHeight'''
| Height of this soldier when standing.
| 0
|-
| '''kneelHeight'''
| Height of this soldier when kneeling.
| 0
|-
| '''floatHeight'''
| Distance between the bottom of this unit and the ground.
| 0
|}

=== AI Units (Aliens/Civilians) ===

Defines an [[Alien Life Forms|alien]] (enemy) or [[civilian]] (neutral) unit, listed in ''"units:"''. Every different alien rank is a different unit, since they have completely different stats. Unit stats are represented as follows:
* [[Time Units|tu]]
* [[Energy|stamina]]
* [[Health|health]]
* [[Bravery|bravery]] (always a multiple of 10)
* [[Reactions|reactions]]
* [[Firing Accuracy|firing]]
* [[Throwing Accuracy|throwing]]
* [[Strength|strength]]
* [[Psi Strength|psiStrength]]
* [[Psi Skill|psiSkill]]
* [[Melee Accuracy|melee]] (not visible)

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the unit name.
| ''required''
|-
| '''race'''
| String ID of the unit race (for alien units).
| -
|-
| '''rank'''
| String ID of the unit rank (for alien units).
| -
|-
| '''stats'''
| Battlescape stats of this unit.
| -
|-
| '''armor'''
| String ID of the [[#Armor|armor]] this unit uses by default.
| -
|-
| '''standHeight'''
| Height of this unit when standing.
| 0
|-
| '''floatHeight'''
| Distance between the bottom of this unit and the ground.
| 0
|-
| '''value'''
| [[Score]] this unit is worth.
| 0
|-
| '''deathSound'''
| Sound ID from [[#Extra_Sounds|BATTLE.CAT]] played when this unit dies.
| -1
|-
| '''aggroSound'''
| Sound ID from [[#Extra_Sounds|BATTLE.CAT]] played when this unit aggros.
| -1
|-
| '''moveSound'''
| Sound ID from [[#Extra_Sounds|BATTLE.CAT]] played when this unit moves.
| -1
|-
| '''intelligence'''
| Intelligence of this unit's AI. The higher the value, the longer this unit remembers player troops between turns.
| 0
|-
| '''aggression'''
| Aggression of this unit's AI. The higher the value, the more ruthless the unit, the more likely to make a frontal assault. Less aggressive units tend to set up ambushes.
Vanilla values are:
* 0 = mostly passive
* 1 = balanced
* 2 = mostly aggresive
| 0
|-
| '''energyRecovery'''
| Energy recovered by the unit each turn (needs verification)
| 40 (?)
|-
| '''specab'''
| Special ability of this unit:
* 0 = None
* 1 = [[Cyberdisc|Explodes on Death]]
* 2 = [[Bio-Drone|Burns Floor]]
* 3 = [[Zombie|Respawns on Death]]
| 0
|-
| '''spawnUnit'''
| String ID of the unit used to respawn on death (eg. [[Zombie]]s respawn as [[Chrysallid]]s).
| -
|-
| '''livingWeapon'''
| Is this unit a living weapon? (only attacks with a '''fixedWeapon''')
| false
|-
|}

=== Alien Races ===

Defines a [[Alien Life Forms|race]] used in [[Alien Missions]], listed in ''"alienRaces:"''. Heavily tied with deployment data.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''id'''
| String ID of the alien race name.
| ''required''
|-
| '''members'''
| Alien crew associated with this alien race (eg. race units + terrorist units), defined by a list of unit string IDs. Order here will define rank in terms of deployment. generally speaking the order is:
* 0 - Commander
* 1 - Leader
* 2 - Engineer
* 3 - Medic
* 4 - Navigator
* 5 - Soldier
* 6 - Terrorist 1
* 7 - Terrorist 2
but of course, not all races have all ranks, so the "fill in" rank would be listed multiple times (see ethereals).
| -
|-
| '''retaliation'''
| retaliation enables/disables the race for retaliation missions.
| ''True''
|-
|}

=== Alien Deployments ===

Defines a Battlescape deployment data used in [[Alien Missions]] (such as alien and map configurations), listed in ''"alienDeployments:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the deployment name.
| ''required''
|-
| '''width'''
| Width of the Battlescape map in grid units.
| 0
|-
| '''length'''
| Length of the Battlescape map in grid units.
| 0
|-
| '''height'''
| Vertical height of the Battlescape map in grid units.
| 0
|-
| '''terrains'''
| list of string IDs of the [[#Terrains|terrain]] to choose from to generate this map. This is not used for UFO sites where the terrain comes from the Geoscape.
| -
|-
| '''shade'''
| Shade of the map (0-15, where 0 is full daytime and 15 is full nighttime). This is not used for UFO sites where the shade comes from the Geoscape.
| 0
|-
| '''nextStage'''
| String ID of the next deployment stage to use after this one, for multi-stage missions.
| -
|-
| '''data'''
| List of deployment data for each alien rank on this mission (see below).
| -
|}

Notes:
* '''terrains''' can also be used with UFOs, with the game using instead the listed terrain rather than the location of the UFO on Geoscape.
==== Deployment Data ====

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''alienRank'''
| [[Alien Rank|Rank]] associated with this deployment data, as defined by the order of the race in question (see above)
| ''required''
|-
| '''lowQty'''
| Maximum quantity of aliens to spawn (beginner).
| 0
|-
| '''highQty'''
| Maximum quantity of aliens to spawn (superhuman).
| 0
|-
| '''dQty'''
| Minimum Desired Quantity of aliens to spawn.
| 0
|-
| '''percentageOutsideUfo'''
| Percentage (0-100%) of aliens to spawn outside in UFO sites.
| 0
|-
| '''itemSets'''
| Three lists (one for each alien technology level) of [[#Items|items]] (string IDs) for the aliens to equip.
| ''required''
|-
|}

=== Research ===

Defines a [[Research|research topic]] that X-COM scientists can investigate, listed in ''"research:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''name'''
| String ID of the research project's name (or item, if a '''lookup''' is defined).
| ''required''
|-
| '''lookup'''
| String ID of the research project's display name and UFOPaedia article reference.
| -
|-
| '''cost'''
| Number of man hours (on average) required to complete this project.
| 0
|-
| '''points'''
| [[Score]] earned for completing this project.
| 0
|-
| '''needItem'''
| Does this project require an [[#Items|item]] of the same name?
| false
|-
| '''dependencies'''
| List of research projects that can unlock access to this one. If the full list is researched, or if one of the projects on the list "unlocks" this one, it becomes available.
| -
|-
| '''unlocks'''
| List of research projects unlocked, regardless of other dependencies, but not requirements, by completing this project (for example, any live alien unlocks "alien origins").
| -
|-
| '''requires'''
| List of research projects unilaterally required before this project can be unlocked (for example, "the martian solution" will not even be considered for unlocking until AFTER "alien origins" is completed).
| -
|-
| '''getOneFree'''
| List of "bonus" research projects that may be granted when completing this project (for example, alien medics will give you information on other alien races). Only applies to living aliens.
| -
|-
|}

=== Manufacture ===

Defines a [[Manufacture|manufacture project]] that X-COM engineers can produce, listed in ''"manufacture:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''name'''
| String ID of the manufacturing project's name (and the item it produces).
| ''required''
|-
| '''category'''
| String ID of the manufacturing project's category.
| -
|-
| '''requires'''
| List of [[#Research|topics]] (string IDs) that must be researched to unlock this project. If none are specified, this project is unlocked from the start.
| -
|-
| '''space'''
| Amount of [[Workshop]] space required to begin this project.
| 0
|-
| '''time'''
| Number of man hours (on average) required per item.
| 0
|-
| '''cost'''
| Monetary deduction per item manufactured.
| 0
|-
| '''requiredItems'''
| List of [[#Items|items]] required and consumed per item manufactured.
| -
|-
| '''producedItems'''
| List of [[#Items|items]] produced per each item consumed. If not specified, defaults to 1 item with the same string ID as the manufacture.
| 1
|-
|}

=== UFOpaedia Article ===

Defines an article in the in-game [[UFOpaedia]], listed in ''"ufopaedia:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''id'''
| String ID of the article name. This must match the ID of the object associated with this article, if applicable.
| ''required''
|-
| '''title'''
| String ID of the article title. If omitted, the '''id''' is used.
| -
|-
| '''type_id'''
| Type of this article:
* 0 = Unknown
* 1 = [[Craft]]
* 2 = [[Craft Armaments]]
* 3 = [[HWP]]
* 4 = [[Equipment (EU)|Equipment]]
* 5 = [[Armour]]
* 6 = [[Base Facilities]]
* 7 = Text & Image (eg. [[Alien Life Forms]], [[UFO Components]])
* 8 = Text (eg. [[Alien Research]])
* 9 = [[UFO]]
| 0
|-
| '''section'''
| String ID of the UFOpaedia section this article belongs in.
| -
|-
| '''requires'''
| List of [[#Research|topics]] (string IDs) that must be researched to unlock this article. If none are specified, this article is unlocked from the start.
| -
|-
| '''image_id'''
| Filename of the [[UP001.SPK-UP042.SPK|background image]] displayed on this article, if applicable.
| -
|-
| '''text'''
| String ID of the description displayed on this article.
| -
|-
| '''text_width'''
| Maximum width of the text displayed, only applicable to ''Text & Image'' articles.
| 0
|-
| '''rect_stats'''
| Rectangle ('''x''', '''y''', '''width''', '''height''') of the stats text on the screen, only applicable to ''Craft'' articles.
| 0
|-
| '''rect_text'''
| Rectangle ('''x''', '''y''', '''width''', '''height''') of the description text on the screen, only applicable to ''Craft'' articles.
| 0
|-
| '''weapon'''
| String ID of the weapon, only applicable to ''HWP'' articles.
| -
|}

=== UFO Trajectories ===

Defines a trajectory carried out by an UFO during an [[#Alien Missions|alien mission]], listed in ''"ufoTrajectories:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''id'''
| String ID of the trajectory name.
| ''required''
|-
| '''groundTimer'''
| Amount of seconds for the UFO to spend on Ground waypoints.
| 0
|-
| '''waypoints'''
| List of waypoints for the UFO to traverse, defined as ''[zone, altitude, speed]''. 
'''zone''': Globe zone where the waypoint is located. 
'''altitude''': UFO altitude after reaching this waypoint:
* 0 - Ground
* 1 - Very Low
* 2 - Low
* 3 - High
* 4 - Very High
'''speed''': UFO speed after reaching this waypoint, as a percentage (0-100%) of its maximum speed.
| -
|}

=== Alien Missions ===

Defines an [[Alien Missions|alien mission]] carried out by UFOs on the Geoscape, listed in ''"alienMissions:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the mission type.
| ''required''
|-
| '''points'''
| [[Score]] allocated to aliens for successfully completing this mission.
| 0
|-
| '''raceWeights'''
| List of alien races likely to carry out this mission, and the % chance of them being allocated to this mission, listed by "number of months after game beginning".
| ''required''
|-
| '''waves'''
| List of UFO waves to spawn as this mission progresses, as described below.
| ''required''
|}

==== Waves ====

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''ufo'''
| String ID of the [[#UFOs|UFO]] to spawn.
| ''required''
|-
| '''count'''
| Number of UFOs to spawn.
| 0
|-
| '''trajectory'''
| String ID of the [[#UFO Trajectories|trajectory]] for this UFO to use when entering Earth's atmosphere.
| ''required''
|-
| '''timer'''
| How long after the previous wave should this wave arrive? (in seconds)
| 0
|-
|}

=== Alien Item Levels ===

This is a list of item level probabilities, with a number between 0 and 2 representing an item level from plasma pistols to heavy plasmas, as defined in the deployments, expressing a 10% probability for that item level being used.

0 = first set (plasma pistol/clip)
1 = second set (plasma rifle/clip)
2 = third set (heavy plasma/clip)

For example:
[ 2, 0, 0, 0, 0, 0, 0, 1, 1, 1 ]
would represent a 60% chance for pistols, 30% rifles, and 10% heavy weapons. 
Note that the order does not matter, but the length DOES. each line MUST have 10 digits.

The above can be confusing. There are 10 fields; each number represents 10%. 
There are six instances of '0'. 6x10% = 60% chance of plasma pistol 
There are three instances of '1'. 3x10% = 30% chance of plasma rifle 
There is only one instance of '2'. 1x10% = 10% chance of heavy plasma 

Each line represents a month after the beginning of the game, and there is no limit to the number defined. 
OpenXCom will use the most recently available item level in the event the game goes on forever.

=== Extra Sprites ===

Adds or replaces sprites in an existing [[Image Formats|X-COM image file]], listed in ''"extraSprites:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| Filename of the original/new image to modify.
| ''required''
|-
| '''width'''
'''height'''
| Size of the sprite(s) in pixels.
| 0
0
|-
| '''singleImage'''
| Is the image file just a single sprite (true) or a spritesheet (false)?
| false
|-
| '''subX'''
'''subY'''
| Size of the subdivision in pixels. If a subdivision is specified, then the image file is divided into chunks to form the sprites (eg. spritesheets).
| 0
0
|-
| '''files'''
| List of the new sprites to add/replace, listed as ''spriteID: filename''.
| -
|}

Example:
- type: GIANTBUNNY.PCK
width: 32
height: 40
files:
0: Resources/Bunny/Bunny00.png
1: Resources/Bunny/Bunny01.bmp
2: Resources/Bunny/Bunny02.gif

=== Extra Sounds ===

Adds or replaces sounds in an existing [[SOUND|X-COM sound file]], listed in ''"extraSounds:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| ID of the original sound file to modify:
* BATTLE.CAT - Battlescape sounds, corresponds to ''SOUND1.CAT'' or ''SAMPLE2.CAT'' (55 sounds).
* INTRO.CAT - Intro sounds, corresponds to ''INTRO.CAT'' or ''SAMPLE3.CAT'', probably best not to mess with these.
* GEO.CAT - Geoscape sounds, corresponds to ''SOUND2.CAT'' or ''SAMPLE.CAT'' (14 sounds).
| ''required''
|-
| '''files'''
| List of the new sounds to add/replace, listed as ''soundID: filename''.
| -
|}

Example:
- type: BATTLE.CAT
files:
55: Resources/Sounds/sample.wav

=== Extra Strings ===

Adds or replaces text strings in an existing [[Translations (OpenXcom)|OpenXcom language file]], listed in ''"extraStrings:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| Filename of the original language file to modify, sans extension.
| ''required''
|-
| '''strings'''
| List of the new strings to add/replace, listed as ''stringID: text''.
| -
|}

Example:
- type: en-US
strings:
STR_SNIPER_RIFLE: Sniper Rifle
STR_SNIPER_RIFLE_CLIP: Sniper Rifle Clip
- type: en-GB
strings:
STR_SNIPER_RIFLE: Sniper Rifle
STR_SNIPER_RIFLE_CLIP: Sniper Rifle Clip
- type: de
strings:
STR_SNIPER_RIFLE: Scharfschützengewehr
STR_SNIPER_RIFLE_CLIP: Scharfschützengewehrmunition
- type: ru
strings:
STR_SNIPER_RIFLE: Снайперская винтовка
STR_SNIPER_RIFLE_CLIP: Магазин к снайп. винтовке

=== Interfaces ===

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| ''?''
| -
|-
| '''elements'''
| ''?''
| -
|-
| '''id'''
| ''?''
| -
|-
| '''color'''
| ''?''
| -
|}

=== StatStrings ===

[[Statstrings]] are used for automatically renaming soldiers. They are case sensitive and they are processed in the order in which they are specified.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''string'''
| String to add to name.
| ''required''
|-
| '''psiStrength''' 
'''psiSkill''' 
'''bravery''' 
'''strength''' 
'''firing''' 
'''reactions''' 
'''stamina''' 
'''tu''' 
'''health''' 
'''throwing'''
| One or more stat ranges are ANDed together for success. Each range has a minVal and maxVal. Use YAML standard tilde (~) to indicate null. ((~) = 0 as minvalue; (~) =255 as maxvalue)
| -
|}

Example:
statStrings:
- string: "x"
psiStrength: [~, 30]
- string: "P"
psiStrength: [80, ~]
- string: "p"
psiStrength: [60, 79]
- string: "K"
psiSkill: [60, ~]
- string: "k"
psiSkill: [30, 59]
- string: "b"
bravery: [60, ~]
- string: "c"
bravery: [~, 10]
- string: "w"
strength: [~, 25]
- string: "Snpr"
firing: [60, ~]
reactions: [60, ~]
- string: "M"
firing: [70, ~]
- string: "m"
firing: [60, 69]
- string: "Sct"
reactions: [50, ~]
tu: [60, ~]
- string: "R"
reactions: [60, ~]
- string: "r"
reactions: [50, 59]

==References==
<references />

[[Category:OpenXcom]]

Ruleset Reference (OpenXcom)

2014-10-19T16:07:54Z

Falko: /* Alien Races */

A reference of all the customizable values of everything in a [[Rulesets (OpenXcom)|ruleset]]. Some guidelines:
* If a value is omitted from the ruleset, the default is used. You cannot omit ''required'' values.
* Text strings (eg. names) are represented by string IDs from the [[Translations (OpenXcom)|language files]]
* Numerical IDs (used for sprites, sounds, etc.) start at 0, not 1.
* Boolean (yes/no) values are represented by true/false.
* World coordinates are represented in degrees (see [[WORLD.DAT]]).
* Money amounts (prices, costs, etc.) are represented in dollars.
* All paths are '''case sensitive'''! If your ruleset uses external files, make sure that they named properly as described in ruleset.

Items are ordered as they come in the ruleset. To override this, you can specify a ''listOrder''. You can find the default listOrders in [[Ruleset List Order (OpenXcom)|Ruleset List Order]].

=== Globe ===

Defines the drawing of landmasses and borders on the globe.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''data'''
| Path name of file which contains polygon and texture information. (For example WORLD.DAT).
| -
|-
| '''polygons'''
| List of polygons drawn on the globe surface. A triangle consist of seven values: the first number defines the texture, followed by three pairs of (x,y) globe coordinates. Only polygons with 3 or 4 vertices are reliable shown on the globe = 7 or 9 values per entry.
| -
|-
| '''polylines'''
| List of border lines. Each list entry consist of a list of (x,y) globe coordinates.
| -
|}

=== Countries ===

Defines one of the [[Country Funding (EU)|funding nations]], listed in ''"countries:"''. They're used for activity graphs and player scoring.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the country name.
| ''required''
|-
| '''fundingBase'''
| Country's base funding, in thousands. The starting funding can be anywhere between 1x and 2x the base funding.
| 0
|-
| '''fundingCap'''
| Country's funding cap, in thousands. Once a country reaches this maximum, it will no longer increase its funding.
| 0
|-
| '''labelLon'''
'''labelLat'''
| Longitude and latitude coordinates of the country's label on the globe. This label is only shown when the globe is zoomed in and "detail" is turned on.
| 0.0
0.0
|-
| '''areas'''
| List of "rectangles" on the globe defined as [''lon1'' ''lat1'' ''lon2'' ''lat2'']. Any activity within these areas counts towards the country's graph activity and affects their opinion of the player.
| -
|}

=== Regions ===

Defines one of the [[Geoscape (EU)#World Regions/Countries|world regions]], listed in ''"regions:"''. They're used for base placement, activity graphs and mission spawning.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the region name.
| ''required''
|-
| '''cost'''
| Amount of money spent building an X-COM base in this region (first base is free).
| 0
|-
| '''areas'''
| List of "rectangles" on the globe defined as ''[lon1, lat1, lon2, lat2]''. Any activity within these areas counts towards the region's graph activity.
| -
|-
| '''cities'''
| List of cities belonging to this region. They will be displayed on the globe and used for terror site missions. Each city is defined by their '''lon''' and '''lat''' coordinates and a '''name''' string ID.
| -
|-
| '''regionWeight'''
| Weight of this region when selecting regions for alien missions.
| 0
|-
| '''missionWeights'''
| Weighted list of the different mission types for this region (eg. ''STR_ALIEN_RESEARCH: 14'').
| -
|-
| '''missionZones'''
| List of "rectangles" (''[lon1, lat1, lon2, lat2]'') defining the mission zones for this region. Mission zones are waypoints for UFO trajectories.
| -
|-
| '''missionRegion'''
| Spawn mission in this region instead (used for regions without land).
| -
|}

=== Base Facilities ===

Defines one of the [[Base Facilities (EU)|facilities]] that can be built in an X-COM base, listed in ''"facilities:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the facility name.
| ''required''
|-
| '''requires'''
| List of [[#Research|topics]] (string IDs) that must be researched to unlock this facility. If none are specified, this facility is unlocked from the start.
| -
|-
| '''spriteShape'''
| Sprite ID from [[BASEBITS.PCK]] used to draw the facility's outer shape in the Basescape and UFOpaedia.
| -1
|-
| '''spriteFacility'''
| Sprite ID from [[BASEBITS.PCK]] used to draw the facility's contents in the Basescape and UFOpaedia. Drawn on top of '''spriteShape'''.
| -1
|-
| '''lift'''
| Is this facility an [[Access Lift]]? All base facilities must be connected to the lift.
| false
|-
| '''hyper'''
| Is this facility a [[Hyperwave Decoder]]? Displays extra information for detected UFOs. Only valid for radar facilities.
| false
|-
| '''mind'''
| Is this facility a [[Mind Shield]]? Reduces the chance of UFOs finding your base. Does not stack.
| false
|-
| '''grav'''
| Is this facility a [[Grav Shield]]? Doubles the power of your base defenses. Does not stack.
| false
|-
| '''size'''
| Size of the facility, in grid units. Every facility is square, so a size of 1 means 1x1, 2 means 2x2, etc. Bigger facilities are made up of multiple sprites, for example a 2x2 facility will use 4 sprites for '''spriteShape''' and 4 sprites for '''spriteFacility''' (top-left, top-right, bottom-left, bottom-right).
| 1
|-
| '''buildCost'''
| Amount of money spent to build this facility in the base.
| 0
|-
| '''buildTime'''
| Amount of days it takes for this facility to be built.
| 0
|-
| '''monthlyCost'''
| Amount of money spent monthly for the maintenance of this facility.
| 0
|-
| '''storage'''
| Amount of storage space (for items) this facility provides. See [[Base Stores]].
| 0
|-
| '''personnel'''
| Amount of personnel (soldiers, scientsts, engineers) these quarters can contain.
| 0
|-
| '''aliens'''
| Amount of live aliens this facility can contain. Only checked if the ''alienContainmentLimitEnforced'' option is enabled.
| 0
|-
| '''crafts'''
| Amount of X-COM craft this facility can contain.
| 0
|-
| '''labs'''
| Amount of lab space this facility provides for research projects.
| 0
|-
| '''workshops'''
| Amount of workshop space this facility provides for manufacture projects.
| 0
|-
| '''psiLabs'''
| Amount of soldier space this facility provides for psionic training.
| 0
|-
| '''radarRange'''
| Maximum radar detection range of this facility, in nautical miles.
| 0
|-
| '''radarChance'''
| Chance (0-100%) of this radar detecting a UFO that enters its range.
| 0
|-
| '''defense'''
| Offensive power provided by this base defense against attacking UFOs.
| 0
|-
| '''hitRatio'''
| Chance (0-100) of the base defense hitting an attacking UFO.
| 0
|-
| '''fireSound'''
| Sound ID from [[#Extra_Sounds|GEO.CAT]] played when the base defense fires.
| -1
|-
| '''hitSound'''
| Sound ID from [[#Extra_Sounds|GEO.CAT]] played when the base defense hits a target.
| -1
|-
| '''mapName'''
| [[MAPS|Map]] associated to this facility in Battlescape base defenses.
| -
|-
|}

=== Crafts ===

Defines one of the [[Craft|X-COM crafts]] that go on interception missions, listed in ''"crafts:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the craft name.
| ''required''
|-
| '''requires'''
| List of [[#Research|topics]] (string IDs) that must be researched to unlock this craft. If none are specified, this craft is unlocked from the start.
| -
|-
| '''sprite'''
| Sprite ID from [[BASEBITS.PCK]] used to draw this craft in the Basescape and from [[INTICON.PCK]] used to draw the damage indicator in dogfights.
modders: the corresponding extrasprite file id for BASEBITS.PCK is sprite+33 INTICON.PCK contains a minimized icon id=sprite the file id for the dogfight image is sprite+11
| -1
|-
| '''fuelMax'''
| Maximum amount of fuel this craft can carry. Crafts use up fuel based on their speed while travelling.
| 0
|-
| '''damageMax'''
| Maximum amount of damage this craft can take. If this amount is exceeded, the craft is destroyed.
| 0
|-
| '''speedMax'''
| Maximum speed in nautical miles. Crafts travel at max speed when flying and half speed when patrolling.
| 0
|-
| '''accel'''
| Aceeleration value shown in the UFOpaedia.
| 0
|-
| '''weapons'''
| Amount of craft weapons this craft can equip. The UI can only display a max of 2 weapons.
| 0
|-
| '''soldiers'''
| Amount of soldiers this craft can carry.
| 0
|-
| '''maxItems'''
| Amount of items this craft can carry.
| 80
|-
| '''vehicles'''
| Amount of vehicles this craft can carry.
| 0
|-
| '''costBuy'''
| Amount of money spent for purchasing this craft. If set to 0, the craft will not be available in the Purchase/Recruit screen.
| 0
|-
| '''costRent'''
| Amount of money spent monthly for renting this craft. If set to 0, the craft is not on rental and won't count towards base maintenance.
| 0
|-
| '''costSell'''
| Amount of money gained for selling this craft.
| 0
|-
| '''refuelItem'''
| Item required for refuelling this craft. If no item is specified, the craft uses human fuel.
| 0
|-
| '''repairRate'''
| Amount of damage restored every hour while [[Repairs|Repairing]] in base.
| 1
|-
| '''refuelRate'''
| Amount of fuel restored every 30 mins while [[Refueling]] in base. If specified, a '''refuelItem''' is spent each time.
| 1
|-
| '''radarRange'''
| Detection range of the craft's radar in nautical miles. Every craft radar has a 100% detection chance.
| 600
|-
| '''transferTime'''
| Number of hours it takes to purchase/transfer this craft to a base.
| 0
|-
| '''score'''
| [[Score]] lost when this craft is destroyed.
| 0
|-
| '''spacecraft'''
| Can this craft go to [[Cydonia]]?
| false
|-
| '''battlescapeTerrainData'''
| [[#Terrains|Terrain]] associated to this craft in Battlescape missions.
| -
|}

=== Craft Weapons ===

Defines one of the [[Craft Armaments|weapons]] equipped by X-COM craft for shooting down UFOs, listed in ''"craftWeapons:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the weapon name.
| ''required''
|-
| '''sprite'''
| Sprite ID from [[BASEBITS.PCK]] used to draw the weapon in the Basescape and from [[INTICON.PCK]] used to draw the weapon in dogfights.
modders: the corresponding extrasprites file id for INTICON.PCK is sprite+5 and sprite+48 for BASEBITS.PCK
| -1
|-
| '''sound'''
| Sound ID from [[#Extra_Sounds|GEO.CAT]] played when this weapon fires.
| -1
|-
| '''damage'''
| Amount of damage this weapon does to enemy UFOs.
| 0
|-
| '''range'''
| Maximum range of this weapon in dogfights (in meters).
| 0
|-
| '''accuracy'''
| Chance (0-100%) of each shot hitting the enemy UFO.
| 0
|-
| '''reloadCautious'''
| Time this weapon takes to fire between each shot in ''Cautious Mode''.
| 0
|-
| '''reloadStandard'''
| Time this weapon takes to fire between each shot in ''Standard Mode''.
| 0
|-
| '''reloadAggressive'''
| Time this weapon takes to fire between each shot in ''Aggressive Mode''.
| 0
|-
| '''ammoMax'''
| Maximum amount of ammo this weapon can carry.
| 0
|-
| '''rearmRate'''
| Amount of ammo restored every 30 mins while the craft is [[Rearming]] in base. If specified, '''clip'''s are spent depending on their '''clipSize'''. If the '''clipSize''' of the specified ammo is 0, no '''clip'''s are spent.
| 1
|-
| '''projectileType'''
| Type of the weapon projectile, used for the projectile sprite in dogfights:
* 0 - [[Stingray]]
* 1 - [[Avalanche]]
* 2 - [[Cannon]]
* 3 - [[Fusion Ball]]
* 4 - [[Laser Cannon]]
* 5 - [[Plasma Beam]]
| 2
|-
| '''projectileSpeed'''
| Speed of the weapon projectile in dogfights.
| 0
|-
| '''launcher'''
| String ID of the [[#Items|item]] required to equip this weapon.
| -
|-
| '''clip'''
| String ID of the [[#Items|item]] required to rearm this weapon.
| -
|}

=== Items ===

Defines the Geoscape and Battlescape properties of an [[Equipment (EU)|item]] that can be stored in X-COM bases, listed in ''"items:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the internal item name.
| ''required''
|-
| '''name'''
| String ID of the displayed item name, for cases where it's different from the internal name. If omitted, '''type''' is used.
| -
|-
| '''requires'''
| List of [[#Research|topics]] (string IDs) that must be researched to unlock this item. If none are specified, this item is unlocked from the start. Soldiers can only use unlocked items in the Battlescape.
| -
|-
| '''size'''
| Space occupied by this item in [[Base Stores]]. Can be a decimal value.
| 0.0
|-
| '''costBuy'''
| Amount of money spent for purchasing this item. If set to 0, this item will not be available in the Purchase/Recruit screen.
| 0
|-
| '''costSell'''
| Amount of money gained for selling this item.
| 0
|-
| '''transferTime'''
| Number of hours it takes to purchase/transfer this item to a base.
| 24
|-
| '''weight'''
| [[Item_Weight|Weight]] occupied by this item in a soldier's inventory.
| 999
|-
| '''bigSprite'''
| Sprite ID from [[BIGOBS.PCK]] used to draw this item in a soldier's inventory and UFOpaedia.
| -1
|-
| '''floorSprite'''
| Sprite ID from [[FLOOROB.PCK]] used to draw this item on the floor of a Battlescape tile.
| -1
|-
| '''handSprite'''
| Sprite ID from [[HANDOB.PCK]] used to draw this item on a soldier's hand in the Battlescape.
modders: each handobject needs 8 images (8 directions) define the extrasprites accordingly
| 120
|-
| '''bulletSprite'''
| Sprite ID from ''BulletSprites.png'' used to draw this weapon's projectile on the Battlescape:
* 0 - [[Rocket Launcher]]
* 1 - [[Pistol]]
* 2 - [[Rifle]]
* 3 - [[Auto Cannon]]
* 4 - [[Heavy Cannon]]
* 5 - [[Laser Pistol]]
* 6 - [[Laser Rifle]]
* 7 - [[Heavy Laser]]
* 8 - [[Plasma Rifle|Plasma]]
* 9 - [[Small Launcher]]
* 10 - [[Blaster Launcher]]
for modders: the bulletsprite needs to be put into the extraSprites type "Projectiles" the bulletsprite can contain up to 35 3x3 images. The corresponding file id is 35*[bulletSprite]
| -1
|-
| '''fireSound'''
| Sound ID from [[#Extra_Sounds|BATTLE.CAT]] played when this weapon fires.
| -1
|-
| '''hitSound'''
| Sound ID from [[#Extra_Sounds|BATTLE.CAT]] played when this weapon hits a target.
| -1
|-
| '''hitAnimation'''
| Sprite ID from [[SMOKE.PCK]] used to draw the weapon's "hit explosion".
'''NOTE''': Do not define this value for melee/psi weapons, they use [[HIT.PCK]] and therefore meleeAnimation instead.
| 0
|-
| '''power'''
| Average damage of the weapon, in most cases it will be +-50% this value.
| 0
|-
| '''strengthApplied'''
| Add the attacking unit's strength to this weapon's damage.
| false
|-
| '''compatibleAmmo'''
| List of string IDs of the ammo items that can be loaded on this weapon. If none are specified, the weapon doesn't need ammo.
| -
|-
| '''damageType'''
| What type of [[damage]] does this weapon do:
* 0 - None
* 1 - Armor Piercing
* 2 - Incendiary
* 3 - High Explosive
* 4 - Laser
* 5 - Plasma
* 6 - Stun
* 7 - Melee
* 8 - Acid
* 9 - Smoke
'''NOTE:''' A damage type other than 0-9 will do nothing.
| 0
|-
| '''tuAuto'''
'''accuracyAuto'''
| The percentage (0-100%) of [[Time Units]] (from the soldier's total) required to fire an Auto Shot. If 0, the weapon does not have an Auto Shot.
The base accuracy (0-100%) applied to a soldier's [[Firing Accuracy]] when firing an Auto Shot.
| 0
0
|-
| '''tuSnap'''
'''accuracySnap'''
| The percentage (0-100%) of [[Time Units]] (from the soldier's total) required to fire a Snap Shot. If 0, the weapon does not have a Snap Shot.
The base accuracy (0-100%) applied to a soldier's [[Firing Accuracy]] when firing a Snap Shot.
| 0
0
|-
| '''tuAimed'''
'''accuracyAimed'''
| The percentage (0-100%) of [[Time Units]] (from the soldier's total) required to fire an Aimed Shot. If 0, the weapon does not have an Aimed Shot.
The base accuracy (0-100%) applied to a soldier's [[Firing Accuracy]] when firing an Aimed Shot.
| 0
0
|-
|-
| '''tuMelee'''
'''accuracyMelee'''
| The percentage (0-100%) of [[Time Units]] (from the soldier's total) required to do a melee attack (Hit). If 0, the weapon does not have a melee attack.
The base accuracy (0-100%) applied to a soldier's [[Melee Accuracy]] when doing a melee attack.
| 0
0
|-
| '''clipSize'''
| The amount of ammo stored in each weapon clip. If -1 is specified, this weapon has infinite ammo.
| 0
|-
| '''battleType'''
| Defines the weapon's behavior in the Battlescape:
* 0 - None (Geoscape-only item)
* 1 - [[Weapons|Firearm]]
* 2 - Ammo
* 3 - Melee
* 4 - [[Grenade]]
* 5 - [[Proximity Grenade]]
* 6 - [[Medi-Kit (EU)|Medi-Kit]]
* 7 - [[Motion Scanner]]
* 8 - [[Mind Probe]]
* 9 - [[Psi-Amp]]
* 10 - [[Electro-flare]]
* 11 - Corpse
| 0
|-
| '''twoHanded'''
| Is this weapon two-handed? If true, incurs an accuracy penalty if used with both hands occupied. Note that the handsprite of a twoHanded item is also drawn at a slightly different position than a one handed item.
| false
|-
| '''waypoint'''
| Does this weapon use waypoints? (eg. [[Blaster Launcher]]). Can also be used to make ammo items use the waypoint system.
| false
|-
| '''fixedWeapon'''
| Is this weapon fixed? (it's part of a unit, eg. tanks and terrorist units)
| false
|-
| '''invWidth'''
| Item width in a soldier's inventory (in grid units).
| 1
|-
| '''invHeight'''
| Item height in a soldier's inventory (in grid units).
| 1
|-
| '''painKiller'''
| Amount of painkillers contained in a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''heal'''
| Amount of heal's contained in a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''stimulant'''
| Amount of stimulants contained in a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''woundRecovery'''
| Amount of [[Fatal Wounds]] treated by each heal of a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''healthRecovery'''
| Amount of [[Health]] recovered by each heal of a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''stunRecovery'''
| Amount of [[Stun]] removed by each stimulant of a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''energyRecovery'''
| Amount of [[Energy]] recovered by each stimulant of a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''tuUse'''
| Amount of [[Time Units]] required to use this item (for non-offensive items). It's a flat rate if '''flatRate''' is true, otherwise it's a percentage (0-100%).
| 0
|-
| '''recoveryPoints'''
| [[Score]] gained for recovering this alien artifact.
| 0
|-
| '''armor'''
| How much damage is needed to destroy this item on the ground.
| 20
|-
| '''recover'''
| Is this item recoverable? (gets transported to the X-COM base on mission success)
| true
|-
| '''turretType'''
| Sprite ID from [[TANKS.PCK]] of the turret to assign to this tank:
* 0 - [[Tank/Cannon]]
* 1 - [[Tank/Rocket Launcher]]
* 2 - [[Tank/Laser Cannon]]
* 3 - [[Hovertank/Plasma]]
* 4 - [[Hovertank/Launcher]]
| -1
|-
| '''liveAlien'''
| Does this item represent a live alien? (counts towards [[Alien Containment]])
| false
|-
| '''blastRadius'''
| Size of the projectile explosions. 0 for no explosion. -1 to automatically calculate based on weapon power and damage type (actual '''blastRadius''' currently is capped due [[Explosions#Playing_With_Fire|Explosion calculations]]).
| -1
|-
| '''flatRate'''
| If true, then TU costs for this weapon are a flat rate (instead of a percentage of unit TUs).
| false
|-
| '''arcingShot'''
| Does this weapon fire in an arc?
| false
|-
| '''attraction'''
| Represents how likely an alien is to pick up this item. Values below 5 will be ignored (by design).
| 0
|-
| '''maxRange'''
| Maximum range at which this weapon can operate.
| 200
|-
| '''aimRange'''
| Maximum effective range with this weapon before which range-based dropoff occurs.
| 200
|-
| '''snapRange'''
| Maximum effective range with snap shot before which range-based dropoff occurs. (ufoextender accuracy only)
| 15
|-
| '''autoRange'''
| Maximum effective range with auto shot before which range-based dropoff occurs. (ufoextender accuracy only)
| 7
|-
| '''minRange'''
| Range-based dropoff will work in reverse for ranges below this.
| 0
|-
| '''dropoff'''
| The value by which the accuracy lowers for each tile after (or before) the thresholds above.
| 2
|-
| '''bulletSpeed'''
| How much faster (or slower, if you use a negative number) is a projectile fired from this weapon compared to the average.
| 0
|-
| '''autoShots'''
| How many auto shots does this weapon fire.
| 3
|-
| '''shotgunPellets'''
| Number of projectiles fired per unit of ammunition. (note: due to engine limitations it is currently impossible to draw multiple projectiles in flight.)
| 0
|-
| '''zombieUnit'''
| String ID of the unit used for zombification (eg. [[Chrysallid]]s turn units into [[Zombie]]s).
| none
|-
| '''meleeSound'''
| Sound ID from [[#Extra_Sounds|BATTLE.CAT]] played when this weapon attacks a target with melee.
| 39
|-
| '''meleeHitSound'''
| Sound ID from [[#Extra_Sounds|BATTLE.CAT]] played when this weapon HITS a target with melee.
| -1
|-
| '''meleeAnimation'''
| Sprite ID from HIT.PCK played when this weapon attacks a target with melee.
| 0
|-
| '''meleePower'''
| Damage this weapon will do when using melee. This only applies to Firearms, and is only available as stun damage. For normal melee weapons, use regular power and damage types.
| 0
|-
| '''LOSRequired'''
| Does this item require line of sight? (only applies to mind probes and psi-amps)
| false
|-
| '''skillApplied'''
| Is melee skill applied to the accuracy of an attack made with this object?
| true
|-
|}

=== UFOs ===

Defines one of the [[UFOs]] that invade Earth, listed in ''"ufos:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the UFO name.
| ''required''
|-
| '''size'''
| String ID of the UFO size.
| STR_VERY_SMALL
|-
| '''sprite'''
| Sprite ID from [[INTERWIN.DAT]] used to draw this UFO in the dogfight view and UFOpaedia.
don't try to add more images if you don't want to punch yourself in the face - use modsprite
| -1
|-
| '''modSprite'''
| Filename used to draw this UFO in the dogfight view and UFOpaedia.
| -
|-
| '''damageMax'''
| Maximum amount of damage this UFO can take. If the UFO takes 50% damage, it crash lands. If it takes 100% damage, it is destroyed.
| 0
|-
| '''speedMax'''
| Maximum speed in nautical miles.
| 0
|-
| '''accel'''
| Aceeleration value shown in the UFOpaedia.
| 0
|-
| '''power'''
| Damage power of this UFO's weapon in dogfights.
| 0
|-
| '''range'''
| Maximum range of this UFO's weapon in dogfights (in meters).
| 0
|-
| '''score'''
| [[Score]] gained when this UFO is destroyed, or half this score if it crash lands.
| 0
|-
| '''reload'''
| Time the UFO's weapon takes to fire between each shot.
| 0
|-
| '''breakOffTime'''
| Minimum amount of time for the UFO to be able to break off of a dogfight.
| 0
|-
| '''battlescapeTerrainData'''
| [[#Terrains|Terrain]] associated to this UFO in Battlescape missions.
| ''required''
|-
|}

=== Inventory Sections ===

Defines one of the sections of the [[Inventory TU Table|Battlescape inventory]] (eg. Backpack), listed in ''"invs:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the inventory name.
| ''required''
|-
| '''x'''
'''y'''
| Pixel coordinates of this section on the inventory screen.
| 0
0
|-
| '''type'''
| Type of this section:
* 0 = Slot section, can contain as many items as will fit on the slots.
* 1 = Hand section, can only contain one item regardless of size.
* 2 = Ground section, can contain infinite items.
| 0
|-
| '''slots'''
| List of the grid slots (''[x, y]'') that this section is composed of. For example, to make a 2x2 section, you would have ''[0, 0] [0, 1] [1, 0] [1, 1]''.
| -
|-
| '''costs'''
| List of [[Time Units]] costs to move an item from this section to another one (eg. ''STR_BACKPACK: 16'' means it will cost 16 TUs to move an item from this section to the Backpack).
| -
|-
|}

=== Terrains ===

Defines one of the [[TERRAIN|terrains]] used to generate a Battlescape map, listed in "terrains:".

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''name'''
| String ID of the terrain name.
| ''required''
|-
| '''largeBlockLimit'''
| Maximum amount of large blocks that can be used on map generation.
| 0
|-
| '''textures'''
| List of [[TEXTURE.DAT|Geoscape textures]] that correspond to this terrain.
| -
|-
| '''hemisphere'''
| Geoscape hemisphere associated with this terrain:
* -1 - Northern hemisphere.
* 0 - Both hemispheres.
* 1 - Southern hemisphere.
| 0
|-
| '''mapDataSets'''
| List of filenames (each with matching [[MCD]]/[[Image Formats#PCK|PCK/TAB]] files) that contain the tiles of this terrain.
| -
|-
| '''mapBlocks'''
| List of map blocks (see below) that are used for generating a map.
| -
|-
| '''roadTypeOdds'''
| Odds as a % of generating each type of road (E-W Road, N-S Road, Crossing) odds for crossing are: 100 - EW - NS.
| [0 0]
|-|-
| '''civilianTypes'''
| List of units to use as civilians for this mission.
| [MALE_CIVILIAN, FEMALE_CIVILIAN]
|-
|}

==== Map Blocks ====

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''name'''
| Filename of the [[MAPS|map]].
| ''required''
|-
| '''width'''
| Width of this map block in Battlescape grid units.
| 0
|-
| '''length'''
| Length of this map block in Battlescape grid units.
| 0
|-
| '''height'''
| Height of this map block in Battlescape grid units.
| 1
|-
| '''type'''
| Type of this map block:
* -1 - Undefined
* 0 - Default
* 1 - Landing Zone (for placing X-COM / alien craft)
* 2 - E-W Road (for city maps)
* 3 - N-S Road (for city maps)
* 4 - Road Crossing (for city maps)
* 5 - Dirt (for filling empty base blocks)
* 6 - X-COM spawn point (for [[Alien Base]] / [[Cydonia]] missions)
* 7 - [[Alien Base]] Target
* 8 - [[Cydonia]] Target
| -1
|-
| '''subType'''
| Sub-type of this map block (see '''type''').
| -1
|-
| '''frequency'''
| Frequency of this block in a map.
| 1
|-
| '''maxCount'''
| Maximum amount of times this block can be used in a map. If -1 there is no limit.
| -1
|-
| '''items'''
| An array of items to add to this mapblock, an the positions to place them at.
| -1
|}

*'''frequency''' defines the odds of the map appearing on the map
** The value assigned (default: 1) is used in ''x/n'', which defines the probability of being chosen.
** ''x'' is the integer defined for the map block's frequency and ''n'' is the combined total of probabilities for all the map types combined.
** This property can only be used in type 0 map blocks.
*'''maxCount''' is the maximum number of times it can be used.
** The value assigned is also used in ''x/n'' to determine the probability of being chosen.
** Each use reduces ''x'' by -1, with the caveat that being used as a Landing Zone type will not reduce the x value since it could result in no available Landing Zones.
** This property can only be used in type 0 map blocks.
* '''hemisphere''' only applies to UFO missions, not Terror ones.
*'''width/length''' defines the size of the map
** be aware that the mapview "width"-label is the openxcom ruleset length parameter
** be aware that the mapview "length"-label is the openxcom ruleset width parameter

==== Guidelines/Tips ====
* All maps with an XCOM/Alien craft require at least one type 1 map block. This map block can only contain ground tiles (no walls or objects), otherwise the game will crash or the walls/objects will be removed.
* All Terror terrains (listed under STR_TERROR_MISSION) require at least 1 map block of '''Types''' 2, 3 and 4 (for a total of 3 maps, which are required to place roads) and the corresponding '''roadTypeOdds''' added to the ruleset.
* If there isn't any map blocks designed as roads since you want to keep your terrain 'random', this can be circumvented by designating all 10x10 map blocks, excluding the one(s) used for the XCOM craft, as either '''Type''' 2, 3 and 4 and by defining their '''subType''' to 0. The game will then randomly choose between the map blocks for each type used in the roads, making them map more random.

=== Armor ===

Defines a Battlescape unit's [[armor]] as well as visual representation (so every unit has an armor), listed in ''"armors:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the armor name.
| ''required''
|-
| '''spriteSheet'''
| Sprite sheet from [[UNITS]] used to draw a unit wearing this armor.
| -
|-
| '''spriteInv'''
| Sprite used for the [[Inventory Backgrounds]] of a unit wearing this armor.
| -
|-
| '''corpseBattle'''
| List of string IDs of the corpse [[#Items|items]] generated when a unit wearing this armor is killed (one per unit tile) on the Battlescape.
| -
|-
| '''corpseGeo'''
| String ID of the corpse [[#Items|item]] associated with this unit on the Geoscape.
| -
|-
| '''storeItem'''
| String ID of the [[#Items|item]] that represents this armor in [[Base Stores]] for equipping.
| -
|-
| '''weight'''
| Physical weight of the armor when worn
| 6
|-
| '''stats'''
| like soldier stats (see below) but these are treated as stat bonuses for wearing the specific armor.
| -
|-
| '''frontArmor'''
| Protection provided on the front of the unit.
| 0
|-
| '''sideArmor'''
| Protection provided on the sides of the unit.
| 0
|-
| '''rearArmor'''
| Protection provided on the rear of the unit.
| 0
|-
| '''underArmor'''
| Protection provided under the unit (eg. from explosions).
| 0
|-
| '''drawingRoutine'''
| Drawing routine used to put together the body parts in the unit's '''spriteSheet''':
* 0 = [[Soldier]], [[Sectoid]]
* 1 = [[Floater]]
* 2 = [[HWP]]
* 3 = [[Cyberdisk]]
* 4 = [[Civilian]], [[Ethereal]]
* 5 = [[Sectopod]], [[Reaper]]
* 6 = [[Snakeman]]
* 7 = [[Chryssalid]]
* 8 = [[Silacoid]]
* 9 = [[Celatid]]
* 10 = [[Muton]]
| 0
|-
| '''movementType'''
| Type of movement provided by this armor:
* 0 = Walking
* 1 = Flying
* 2 = Sliding (no walking animation)
it also defines the body of an tank (32-images) in your spriteSheet or the change in sprites while flying using a flying armour see: [[TANKS.PCK]], [[XCOM_2.PCK]]
| 0
|-
| '''damageModifier'''
| List of decimal damage modifiers (1.0 = 100%) this armor applies to each damage type (see [[#Items|Items section]]) received. Modifiers must be specified for all damage types, in this order:
* None
* Armor Piercing
* Incendiary
* High Explosive
* Laser
* Plasma
* Stun
* Melee
* Acid
* Smoke
|
- 1.0 
- 1.0 
- 1.0 
- 1.0 
- 1.0 
- 1.0 
- 1.0 
- 1.0 
- 1.0 
- 1.0
|-
| '''size'''
| Size of the unit wearing this armor, in Battlescape grid units. Every unit is square, so a size of 2 means 2x2.
| 1
|-
| '''loftempsSet'''
| List of [[LOFTEMPS]] IDs (one per unit tile, so a 1x1 unit has 1, a 2x2 unit has 4, etc.) used to represent a unit wearing this armor in 3D space.
| -
|-
| '''loftemps'''
| loftemps is a deprecated option that only works for 1x1 sized units.
| -
|}

=== Player Units (Soldiers) ===

Defines a [[soldier]] recruited by X-COM, listed in ''"soldiers:"''. Currently only one soldier unit type (''XCOM'') is supported.

Unit stats are represented as follows:
* [[Time Units|tu]]
* [[Energy|stamina]]
* [[Health|health]]
* [[Bravery|bravery]] (always a multiple of 10)
* [[Reactions|reactions]]
* [[Firing Accuracy|firing]]
* [[Throwing Accuracy|throwing]]
* [[Strength|strength]]
* [[Psi Strength|psiStrength]]
* [[Psi Skill|psiSkill]]
* [[Melee Accuracy|melee]] (not visible)

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the soldier name.
| ''required''
|-
| '''minStats'''
| Minimum values used to generate the soldier's [[Starting Stats]]. In this case, ''psiSkill'' is treated as the initial stat (not generated).
| -
|-
| '''maxStats'''
| Maximum values used to generate the soldier's [[Starting Stats]]. In this case, ''psiSkill'' is treated as the minimum value for the first month of psi training (actual value is 100%-150%).
| -
|-
| '''statCaps'''
| Maximum stats this soldier can gain through [[Experience]]. '''NOTE:''' A stat will still go over the limit once, and then will no longer increase (see [[Experience#Regarding Caps|Regarding Caps]]).
| -
|-
| '''armor'''
| String ID of the [[#Armor|armor]] this soldier uses by default.
| -
|-
| '''standHeight'''
| Height of this soldier when standing.
| 0
|-
| '''kneelHeight'''
| Height of this soldier when kneeling.
| 0
|-
| '''floatHeight'''
| Distance between the bottom of this unit and the ground.
| 0
|}

=== AI Units (Aliens/Civilians) ===

Defines an [[Alien Life Forms|alien]] (enemy) or [[civilian]] (neutral) unit, listed in ''"units:"''. Every different alien rank is a different unit, since they have completely different stats. Unit stats are represented as follows:
* [[Time Units|tu]]
* [[Energy|stamina]]
* [[Health|health]]
* [[Bravery|bravery]] (always a multiple of 10)
* [[Reactions|reactions]]
* [[Firing Accuracy|firing]]
* [[Throwing Accuracy|throwing]]
* [[Strength|strength]]
* [[Psi Strength|psiStrength]]
* [[Psi Skill|psiSkill]]
* [[Melee Accuracy|melee]] (not visible)

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the unit name.
| ''required''
|-
| '''race'''
| String ID of the unit race (for alien units).
| -
|-
| '''rank'''
| String ID of the unit rank (for alien units).
| -
|-
| '''stats'''
| Battlescape stats of this unit.
| -
|-
| '''armor'''
| String ID of the [[#Armor|armor]] this unit uses by default.
| -
|-
| '''standHeight'''
| Height of this unit when standing.
| 0
|-
| '''floatHeight'''
| Distance between the bottom of this unit and the ground.
| 0
|-
| '''value'''
| [[Score]] this unit is worth.
| 0
|-
| '''deathSound'''
| Sound ID from [[#Extra_Sounds|BATTLE.CAT]] played when this unit dies.
| -1
|-
| '''aggroSound'''
| Sound ID from [[#Extra_Sounds|BATTLE.CAT]] played when this unit aggros.
| -1
|-
| '''moveSound'''
| Sound ID from [[#Extra_Sounds|BATTLE.CAT]] played when this unit moves.
| -1
|-
| '''intelligence'''
| Intelligence of this unit's AI. The higher the value, the longer this unit remembers player troops between turns.
| 0
|-
| '''aggression'''
| Aggression of this unit's AI. The higher the value, the more ruthless the unit, the more likely to make a frontal assault. Less aggressive units tend to set up ambushes.
Vanilla values are:
* 0 = mostly passive
* 1 = balanced
* 2 = mostly aggresive
| 0
|-
| '''energyRecovery'''
| Energy recovered by the unit each turn (needs verification)
| 40 (?)
|-
| '''specab'''
| Special ability of this unit:
* 0 = None
* 1 = [[Cyberdisc|Explodes on Death]]
* 2 = [[Bio-Drone|Burns Floor]]
* 3 = [[Zombie|Respawns on Death]]
| 0
|-
| '''spawnUnit'''
| String ID of the unit used to respawn on death (eg. [[Zombie]]s respawn as [[Chrysallid]]s).
| -
|-
| '''livingWeapon'''
| Is this unit a living weapon? (only attacks with a '''fixedWeapon''')
| false
|-
|}

=== Alien Races ===

Defines a [[Alien Life Forms|race]] used in [[Alien Missions]], listed in ''"alienRaces:"''. Heavily tied with deployment data.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''id'''
| String ID of the alien race name.
| ''required''
|-
| '''members'''
| Alien crew associated with this alien race (eg. race units + terrorist units), defined by a list of unit string IDs. Order here will define rank in terms of deployment. generally speaking the order is:
* 0 - Commander
* 1 - Leader
* 2 - Engineer
* 3 - Medic
* 4 - Navigator
* 5 - Soldier
* 6 - Terrorist 1
* 7 - Terrorist 2
but of course, not all races have all ranks, so the "fill in" rank would be listed multiple times (see ethereals).
| -
|-
| '''retaliation'''
| retaliation enables/disables the race for retaliation missions.
| ''True''
|-
|}

=== Alien Deployments ===

Defines a Battlescape deployment data used in [[Alien Missions]] (such as alien and map configurations), listed in ''"alienDeployments:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the deployment name.
| ''required''
|-
| '''width'''
| Width of the Battlescape map in grid units.
| 0
|-
| '''length'''
| Length of the Battlescape map in grid units.
| 0
|-
| '''height'''
| Vertical height of the Battlescape map in grid units.
| 0
|-
| '''terrains'''
| list of string IDs of the [[#Terrains|terrain]] to choose from to generate this map. This is not used for UFO sites where the terrain comes from the Geoscape.
| -
|-
| '''shade'''
| Shade of the map (0-15, where 0 is full daytime and 15 is full nighttime). This is not used for UFO sites where the shade comes from the Geoscape.
| 0
|-
| '''nextStage'''
| String ID of the next deployment stage to use after this one, for multi-stage missions.
| -
|-
| '''data'''
| List of deployment data for each alien rank on this mission (see below).
| -
|}

Notes:
* '''terrains''' can also be used with UFOs, with the game using instead the listed terrain rather than the location of the UFO on Geoscape.
==== Deployment Data ====

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''alienRank'''
| [[Alien Rank|Rank]] associated with this deployment data, as defined by the order of the race in question (see above)
| ''required''
|-
| '''lowQty'''
| Maximum quantity of aliens to spawn (beginner).
| 0
|-
| '''highQty'''
| Maximum quantity of aliens to spawn (superhuman).
| 0
|-
| '''dQty'''
| Minimum Desired Quantity of aliens to spawn.
| 0
|-
| '''percentageOutsideUfo'''
| Percentage (0-100%) of aliens to spawn outside in UFO sites.
| 0
|-
| '''itemSets'''
| Three lists (one for each alien technology level) of [[#Items|items]] (string IDs) for the aliens to equip.
| ''required''
|-
|}

=== Research ===

Defines a [[Research|research topic]] that X-COM scientists can investigate, listed in ''"research:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''name'''
| String ID of the research project's name (or item, if a '''lookup''' is defined).
| ''required''
|-
| '''lookup'''
| String ID of the research project's display name and UFOPaedia article reference.
| -
|-
| '''cost'''
| Number of man hours (on average) required to complete this project.
| 0
|-
| '''points'''
| [[Score]] earned for completing this project.
| 0
|-
| '''needItem'''
| Does this project require an [[#Items|item]] of the same name?
| false
|-
| '''dependencies'''
| List of research projects that can unlock access to this one. If the full list is researched, or if one of the projects on the list "unlocks" this one, it becomes available.
| -
|-
| '''unlocks'''
| List of research projects unlocked, regardless of other dependencies, but not requirements, by completing this project (for example, any live alien unlocks "alien origins").
| -
|-
| '''requires'''
| List of research projects unilaterally required before this project can be unlocked (for example, "the martian solution" will not even be considered for unlocking until AFTER "alien origins" is completed).
| -
|-
| '''getOneFree'''
| List of "bonus" research projects that may be granted when completing this project (for example, alien medics will give you information on other alien races). Only applies to living aliens.
| -
|-
|}

=== Manufacture ===

Defines a [[Manufacture|manufacture project]] that X-COM engineers can produce, listed in ''"manufacture:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''name'''
| String ID of the manufacturing project's name (and the item it produces).
| ''required''
|-
| '''category'''
| String ID of the manufacturing project's category.
| -
|-
| '''requires'''
| List of [[#Research|topics]] (string IDs) that must be researched to unlock this project. If none are specified, this project is unlocked from the start.
| -
|-
| '''space'''
| Amount of [[Workshop]] space required to begin this project.
| 0
|-
| '''time'''
| Number of man hours (on average) required per item.
| 0
|-
| '''cost'''
| Monetary deduction per item manufactured.
| 0
|-
| '''requiredItems'''
| List of [[#Items|items]] required and consumed per item manufactured.
| -
|-
| '''producedItems'''
| List of [[#Items|items]] produced per each item consumed. If not specified, defaults to 1 item with the same string ID as the manufacture.
| 1
|-
|}

=== UFOpaedia Article ===

Defines an article in the in-game [[UFOpaedia]], listed in ''"ufopaedia:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''id'''
| String ID of the article name. This must match the ID of the object associated with this article, if applicable.
| ''required''
|-
| '''title'''
| String ID of the article title. If omitted, the '''id''' is used.
| -
|-
| '''type_id'''
| Type of this article:
* 0 = Unknown
* 1 = [[Craft]]
* 2 = [[Craft Armaments]]
* 3 = [[HWP]]
* 4 = [[Equipment (EU)|Equipment]]
* 5 = [[Armour]]
* 6 = [[Base Facilities]]
* 7 = Text & Image (eg. [[Alien Life Forms]], [[UFO Components]])
* 8 = Text (eg. [[Alien Research]])
* 9 = [[UFO]]
| 0
|-
| '''section'''
| String ID of the UFOpaedia section this article belongs in.
| -
|-
| '''requires'''
| List of [[#Research|topics]] (string IDs) that must be researched to unlock this article. If none are specified, this article is unlocked from the start.
| -
|-
| '''image_id'''
| Filename of the [[UP001.SPK-UP042.SPK|background image]] displayed on this article, if applicable.
| -
|-
| '''text'''
| String ID of the description displayed on this article.
| -
|-
| '''text_width'''
| Maximum width of the text displayed, only applicable to ''Text & Image'' articles.
| 0
|-
| '''rect_stats'''
| Rectangle ('''x''', '''y''', '''width''', '''height''') of the stats text on the screen, only applicable to ''Craft'' articles.
| 0
|-
| '''rect_text'''
| Rectangle ('''x''', '''y''', '''width''', '''height''') of the description text on the screen, only applicable to ''Craft'' articles.
| 0
|-
| '''weapon'''
| String ID of the weapon, only applicable to ''HWP'' articles.
| -
|}

=== UFO Trajectories ===

Defines a trajectory carried out by an UFO during an [[#Alien Missions|alien mission]], listed in ''"ufoTrajectories:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''id'''
| String ID of the trajectory name.
| ''required''
|-
| '''groundTimer'''
| Amount of seconds for the UFO to spend on Ground waypoints.
| 0
|-
| '''waypoints'''
| List of waypoints for the UFO to traverse, defined as ''[zone, altitude, speed]''. 
'''zone''': Globe zone where the waypoint is located. 
'''altitude''': UFO altitude after reaching this waypoint:
* 0 - Ground
* 1 - Very Low
* 2 - Low
* 3 - High
* 4 - Very High
'''speed''': UFO speed after reaching this waypoint, as a percentage (0-100%) of its maximum speed.
| -
|}

=== Alien Missions ===

Defines an [[Alien Missions|alien mission]] carried out by UFOs on the Geoscape, listed in ''"alienMissions:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the mission type.
| ''required''
|-
| '''points'''
| [[Score]] allocated to aliens for successfully completing this mission.
| 0
|-
| '''raceWeights'''
| List of alien races likely to carry out this mission, and the % chance of them being allocated to this mission, listed by "number of months after game beginning".
| ''required''
|-
| '''waves'''
| List of UFO waves to spawn as this mission progresses, as described below.
| ''required''
|}

==== Waves ====

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''ufo'''
| String ID of the [[#UFOs|UFO]] to spawn.
| ''required''
|-
| '''count'''
| Number of UFOs to spawn.
| 0
|-
| '''trajectory'''
| String ID of the [[#UFO Trajectories|trajectory]] for this UFO to use when entering Earth's atmosphere.
| ''required''
|-
| '''timer'''
| How long after the previous wave should this wave arrive? (in seconds)
| 0
|-
|}

=== Alien Item Levels ===

This is a list of item level probabilities, with a number between 0 and 2 representing an item level from plasma pistols to heavy plasmas, as defined in the deployments, expressing a 10% probability for that item level being used.

0 = first set (plasma pistol/clip)
1 = second set (plasma rifle/clip)
2 = third set (heavy plasma/clip)

For example:
[ 2, 0, 0, 0, 0, 0, 0, 1, 1, 1 ]
would represent a 60% chance for pistols, 30% rifles, and 10% heavy weapons. 
Note that the order does not matter, but the length DOES. each line MUST have 10 digits.

The above can be confusing. There are 10 fields; each number represents 10%. 
There are six instances of '0'. 6x10% = 60% chance of plasma pistol 
There are three instances of '1'. 3x10% = 30% chance of plasma rifle 
There is only one instance of '2'. 1x10% = 10% chance of heavy plasma 

Each line represents a month after the beginning of the game, and there is no limit to the number defined. 
OpenXCom will use the most recently available item level in the event the game goes on forever.

=== Extra Sprites ===

Adds or replaces sprites in an existing [[Image Formats|X-COM image file]], listed in ''"extraSprites:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| Filename of the original/new image to modify.
| ''required''
|-
| '''width'''
'''height'''
| Size of the sprite(s) in pixels.
| 0
0
|-
| '''singleImage'''
| Is the image file just a single sprite (true) or a spritesheet (false)?
| false
|-
| '''subX'''
'''subY'''
| Size of the subdivision in pixels. If a subdivision is specified, then the image file is divided into chunks to form the sprites (eg. spritesheets).
| 0
0
|-
| '''files'''
| List of the new sprites to add/replace, listed as ''spriteID: filename''.
| -
|}

Example:
- type: GIANTBUNNY.PCK
width: 32
height: 40
files:
0: Resources/Bunny/Bunny00.png
1: Resources/Bunny/Bunny01.bmp
2: Resources/Bunny/Bunny02.gif

=== Extra Sounds ===

Adds or replaces sounds in an existing [[SOUND|X-COM sound file]], listed in ''"extraSounds:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| ID of the original sound file to modify:
* BATTLE.CAT - Battlescape sounds, corresponds to ''SOUND1.CAT'' or ''SAMPLE2.CAT'' (55 sounds).
* INTRO.CAT - Intro sounds, corresponds to ''INTRO.CAT'' or ''SAMPLE3.CAT'', probably best not to mess with these.
* GEO.CAT - Geoscape sounds, corresponds to ''SOUND2.CAT'' or ''SAMPLE.CAT'' (14 sounds).
| ''required''
|-
| '''files'''
| List of the new sounds to add/replace, listed as ''soundID: filename''.
| -
|}

Example:
- type: BATTLE.CAT
files:
55: Resources/Sounds/sample.wav

=== Extra Strings ===

Adds or replaces text strings in an existing [[Translations (OpenXcom)|OpenXcom language file]], listed in ''"extraStrings:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| Filename of the original language file to modify, sans extension.
| ''required''
|-
| '''strings'''
| List of the new strings to add/replace, listed as ''stringID: text''.
| -
|}

Example:
- type: en-US
strings:
STR_SNIPER_RIFLE: Sniper Rifle
STR_SNIPER_RIFLE_CLIP: Sniper Rifle Clip
- type: en-GB
strings:
STR_SNIPER_RIFLE: Sniper Rifle
STR_SNIPER_RIFLE_CLIP: Sniper Rifle Clip
- type: de
strings:
STR_SNIPER_RIFLE: Scharfschützengewehr
STR_SNIPER_RIFLE_CLIP: Scharfschützengewehrmunition
- type: ru
strings:
STR_SNIPER_RIFLE: Снайперская винтовка
STR_SNIPER_RIFLE_CLIP: Магазин к снайп. винтовке

=== Interfaces ===

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| ''?''
| -
|-
| '''elements'''
| ''?''
| -
|-
| '''id'''
| ''?''
| -
|-
| '''color'''
| ''?''
| -
|}

=== StatStrings ===

[[Statstrings]] are used for automatically renaming soldiers. They are case sensitive and they are processed in the order in which they are specified.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''string'''
| String to add to name.
| ''required''
|-
| '''psiStrength''' 
'''psiSkill''' 
'''bravery''' 
'''strength''' 
'''firing''' 
'''reactions''' 
'''stamina''' 
'''tu''' 
'''health''' 
'''throwing'''
| One or more stat ranges are ANDed together for success. Each range has a minVal and maxVal. Use YAML standard tilde (~) to indicate null. ((~) = 0 as minvalue; (~) =255 as maxvalue)
| -
|}

Example:
statStrings:
- string: "x"
psiStrength: [~, 30]
- string: "P"
psiStrength: [80, ~]
- string: "p"
psiStrength: [60, 79]
- string: "K"
psiSkill: [60, ~]
- string: "k"
psiSkill: [30, 59]
- string: "b"
bravery: [60, ~]
- string: "c"
bravery: [~, 10]
- string: "w"
strength: [~, 25]
- string: "Snpr"
firing: [60, ~]
reactions: [60, ~]
- string: "M"
firing: [70, ~]
- string: "m"
firing: [60, 69]
- string: "Sct"
reactions: [50, ~]
tu: [60, ~]
- string: "R"
reactions: [60, ~]
- string: "r"
reactions: [50, 59]

==References==
<references />

[[Category:OpenXcom]]

Ruleset Reference (OpenXcom)

2014-10-10T10:41:29Z

Falko: /* Alien Item Levels */

A reference of all the customizable values of everything in a [[Rulesets (OpenXcom)|ruleset]]. Some guidelines:
* If a value is omitted from the ruleset, the default is used. You cannot omit ''required'' values.
* Text strings (eg. names) are represented by string IDs from the [[Translations (OpenXcom)|language files]]
* Numerical IDs (used for sprites, sounds, etc.) start at 0, not 1.
* Boolean (yes/no) values are represented by true/false.
* World coordinates are represented in degrees (see [[WORLD.DAT]]).
* Money amounts (prices, costs, etc.) are represented in dollars.
* All paths are '''case sensitive'''! If your ruleset uses external files, make sure that they named properly as described in ruleset.

Items are ordered as they come in the ruleset. To override this, you can specify a ''listOrder''. You can find the default listOrders in [[Ruleset List Order (OpenXcom)|Ruleset List Order]].

=== Globe ===

Defines the drawing of landmasses and borders on the globe.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''data'''
| Path name of file which contains polygon and texture information. (For example WORLD.DAT).
| -
|-
| '''polygons'''
| List of polygons drawn on the globe surface. A triangle consist of seven values: the first number defines the texture, followed by three pairs of (x,y) globe coordinates. Only polygons with 3 or 4 vertices are reliable shown on the globe = 7 or 9 values per entry.
| -
|-
| '''polylines'''
| List of border lines. Each list entry consist of a list of (x,y) globe coordinates.
| -
|}

=== Countries ===

Defines one of the [[Country Funding (EU)|funding nations]], listed in ''"countries:"''. They're used for activity graphs and player scoring.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the country name.
| ''required''
|-
| '''fundingBase'''
| Country's base funding, in thousands. The starting funding can be anywhere between 1x and 2x the base funding.
| 0
|-
| '''fundingCap'''
| Country's funding cap, in thousands. Once a country reaches this maximum, it will no longer increase its funding.
| 0
|-
| '''labelLon'''
'''labelLat'''
| Longitude and latitude coordinates of the country's label on the globe. This label is only shown when the globe is zoomed in and "detail" is turned on.
| 0.0
0.0
|-
| '''areas'''
| List of "rectangles" on the globe defined as [''lon1'' ''lat1'' ''lon2'' ''lat2'']. Any activity within these areas counts towards the country's graph activity and affects their opinion of the player.
| -
|}

=== Regions ===

Defines one of the [[Geoscape (EU)#World Regions/Countries|world regions]], listed in ''"regions:"''. They're used for base placement, activity graphs and mission spawning.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the region name.
| ''required''
|-
| '''cost'''
| Amount of money spent building an X-COM base in this region (first base is free).
| 0
|-
| '''areas'''
| List of "rectangles" on the globe defined as ''[lon1, lat1, lon2, lat2]''. Any activity within these areas counts towards the region's graph activity.
| -
|-
| '''cities'''
| List of cities belonging to this region. They will be displayed on the globe and used for terror site missions. Each city is defined by their '''lon''' and '''lat''' coordinates and a '''name''' string ID.
| -
|-
| '''regionWeight'''
| Weight of this region when selecting regions for alien missions.
| 0
|-
| '''missionWeights'''
| Weighted list of the different mission types for this region (eg. ''STR_ALIEN_RESEARCH: 14'').
| -
|-
| '''missionZones'''
| List of "rectangles" (''[lon1, lat1, lon2, lat2]'') defining the mission zones for this region.
| -
|-
| '''missionRegion'''
| Spawn mission in this region instead (used for regions without land).
| -
|}

=== Base Facilities ===

Defines one of the [[Base Facilities (EU)|facilities]] that can be built in an X-COM base, listed in ''"facilities:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the facility name.
| ''required''
|-
| '''requires'''
| List of [[#Research|topics]] (string IDs) that must be researched to unlock this facility. If none are specified, this facility is unlocked from the start.
| -
|-
| '''spriteShape'''
| Sprite ID from [[BASEBITS.PCK]] used to draw the facility's outer shape in the Basescape and UFOpaedia.
| -1
|-
| '''spriteFacility'''
| Sprite ID from [[BASEBITS.PCK]] used to draw the facility's contents in the Basescape and UFOpaedia. Drawn on top of '''spriteShape'''.
| -1
|-
| '''lift'''
| Is this facility an [[Access Lift]]? All base facilities must be connected to the lift.
| false
|-
| '''hyper'''
| Is this facility a [[Hyperwave Decoder]]? Displays extra information for detected UFOs. Only valid for radar facilities.
| false
|-
| '''mind'''
| Is this facility a [[Mind Shield]]? Reduces the chance of UFOs finding your base. Does not stack.
| false
|-
| '''grav'''
| Is this facility a [[Grav Shield]]? Doubles the power of your base defenses. Does not stack.
| false
|-
| '''size'''
| Size of the facility, in grid units. Every facility is square, so a size of 1 means 1x1, 2 means 2x2, etc. Bigger facilities are made up of multiple sprites, for example a 2x2 facility will use 4 sprites for '''spriteShape''' and 4 sprites for '''spriteFacility''' (top-left, top-right, bottom-left, bottom-right).
| 1
|-
| '''buildCost'''
| Amount of money spent to build this facility in the base.
| 0
|-
| '''buildTime'''
| Amount of days it takes for this facility to be built.
| 0
|-
| '''monthlyCost'''
| Amount of money spent monthly for the maintenance of this facility.
| 0
|-
| '''storage'''
| Amount of storage space (for items) this facility provides. See [[Base Stores]].
| 0
|-
| '''personnel'''
| Amount of personnel (soldiers, scientsts, engineers) these quarters can contain.
| 0
|-
| '''aliens'''
| Amount of live aliens this facility can contain. Only checked if the ''alienContainmentLimitEnforced'' option is enabled.
| 0
|-
| '''crafts'''
| Amount of X-COM craft this facility can contain.
| 0
|-
| '''labs'''
| Amount of lab space this facility provides for research projects.
| 0
|-
| '''workshops'''
| Amount of workshop space this facility provides for manufacture projects.
| 0
|-
| '''psiLabs'''
| Amount of soldier space this facility provides for psionic training.
| 0
|-
| '''radarRange'''
| Maximum radar detection range of this facility, in nautical miles.
| 0
|-
| '''radarChance'''
| Chance (0-100%) of this radar detecting a UFO that enters its range.
| 0
|-
| '''defense'''
| Offensive power provided by this base defense against attacking UFOs.
| 0
|-
| '''hitRatio'''
| Chance (0-100) of the base defense hitting an attacking UFO.
| 0
|-
| '''fireSound'''
| Sound ID from [[#Extra_Sounds|GEO.CAT]] played when the base defense fires.
| -1
|-
| '''hitSound'''
| Sound ID from [[#Extra_Sounds|GEO.CAT]] played when the base defense hits a target.
| -1
|-
| '''mapName'''
| [[MAPS|Map]] associated to this facility in Battlescape base defenses.
| -
|-
|}

=== Crafts ===

Defines one of the [[Craft|X-COM crafts]] that go on interception missions, listed in ''"crafts:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the craft name.
| ''required''
|-
| '''requires'''
| List of [[#Research|topics]] (string IDs) that must be researched to unlock this craft. If none are specified, this craft is unlocked from the start.
| -
|-
| '''sprite'''
| Sprite ID from [[BASEBITS.PCK]] used to draw this craft in the Basescape and from [[INTICON.PCK]] used to draw the damage indicator in dogfights.
modders: the corresponding extrasprite file id for BASEBITS.PCK is sprite+33 INTICON.PCK contains a minimized icon id=sprite the file id for the dogfight image is sprite+11
| -1
|-
| '''fuelMax'''
| Maximum amount of fuel this craft can carry. Crafts use up fuel based on their speed while travelling.
| 0
|-
| '''damageMax'''
| Maximum amount of damage this craft can take. If this amount is exceeded, the craft is destroyed.
| 0
|-
| '''speedMax'''
| Maximum speed in nautical miles. Crafts travel at max speed when flying and half speed when patrolling.
| 0
|-
| '''accel'''
| Aceeleration value shown in the UFOpaedia.
| 0
|-
| '''weapons'''
| Amount of craft weapons this craft can equip. The UI can only display a max of 2 weapons.
| 0
|-
| '''soldiers'''
| Amount of soldiers this craft can carry.
| 0
|-
| '''maxItems'''
| Amount of items this craft can carry.
| 80
|-
| '''vehicles'''
| Amount of vehicles this craft can carry.
| 0
|-
| '''costBuy'''
| Amount of money spent for purchasing this craft. If set to 0, the craft will not be available in the Purchase/Recruit screen.
| 0
|-
| '''costRent'''
| Amount of money spent monthly for renting this craft. If set to 0, the craft is not on rental and won't count towards base maintenance.
| 0
|-
| '''costSell'''
| Amount of money gained for selling this craft.
| 0
|-
| '''refuelItem'''
| Item required for refuelling this craft. If no item is specified, the craft uses human fuel.
| 0
|-
| '''repairRate'''
| Amount of damage restored every hour while [[Repairs|Repairing]] in base.
| 1
|-
| '''refuelRate'''
| Amount of fuel restored every 30 mins while [[Refueling]] in base. If specified, a '''refuelItem''' is spent each time.
| 1
|-
| '''radarRange'''
| Detection range of the craft's radar in nautical miles. Every craft radar has a 100% detection chance.
| 600
|-
| '''transferTime'''
| Number of hours it takes to purchase/transfer this craft to a base.
| 0
|-
| '''score'''
| [[Score]] lost when this craft is destroyed.
| 0
|-
| '''spacecraft'''
| Can this craft go to [[Cydonia]]?
| false
|-
| '''battlescapeTerrainData'''
| [[#Terrains|Terrain]] associated to this craft in Battlescape missions.
| -
|}

=== Craft Weapons ===

Defines one of the [[Craft Armaments|weapons]] equipped by X-COM craft for shooting down UFOs, listed in ''"craftWeapons:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the weapon name.
| ''required''
|-
| '''sprite'''
| Sprite ID from [[BASEBITS.PCK]] used to draw the weapon in the Basescape and from [[INTICON.PCK]] used to draw the weapon in dogfights.
modders: the corresponding extrasprites file id for INTICON.PCK is sprite+5 and sprite+48 for BASEBITS.PCK
| -1
|-
| '''sound'''
| Sound ID from [[#Extra_Sounds|GEO.CAT]] played when this weapon fires.
| -1
|-
| '''damage'''
| Amount of damage this weapon does to enemy UFOs.
| 0
|-
| '''range'''
| Maximum range of this weapon in dogfights (in meters).
| 0
|-
| '''accuracy'''
| Chance (0-100%) of each shot hitting the enemy UFO.
| 0
|-
| '''reloadCautious'''
| Time this weapon takes to fire between each shot in ''Cautious Mode''.
| 0
|-
| '''reloadStandard'''
| Time this weapon takes to fire between each shot in ''Standard Mode''.
| 0
|-
| '''reloadAggressive'''
| Time this weapon takes to fire between each shot in ''Aggressive Mode''.
| 0
|-
| '''ammoMax'''
| Maximum amount of ammo this weapon can carry.
| 0
|-
| '''rearmRate'''
| Amount of ammo restored every 30 mins while the craft is [[Rearming]] in base. If specified, '''clip'''s are spent depending on their '''clipSize'''. If the '''clipSize''' of the specified ammo is 0, no '''clip'''s are spent.
| 1
|-
| '''projectileType'''
| Type of the weapon projectile, used for the projectile sprite in dogfights:
* 0 - [[Stingray]]
* 1 - [[Avalanche]]
* 2 - [[Cannon]]
* 3 - [[Fusion Ball]]
* 4 - [[Laser Cannon]]
* 5 - [[Plasma Beam]]
| 2
|-
| '''projectileSpeed'''
| Speed of the weapon projectile in dogfights.
| 0
|-
| '''launcher'''
| String ID of the [[#Items|item]] required to equip this weapon.
| -
|-
| '''clip'''
| String ID of the [[#Items|item]] required to rearm this weapon.
| -
|}

=== Items ===

Defines the Geoscape and Battlescape properties of an [[Equipment (EU)|item]] that can be stored in X-COM bases, listed in ''"items:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the internal item name.
| ''required''
|-
| '''name'''
| String ID of the displayed item name, for cases where it's different from the internal name. If omitted, '''type''' is used.
| -
|-
| '''requires'''
| List of [[#Research|topics]] (string IDs) that must be researched to unlock this item. If none are specified, this item is unlocked from the start. Soldiers can only use unlocked items in the Battlescape.
| -
|-
| '''size'''
| Space occupied by this item in [[Base Stores]]. Can be a decimal value.
| 0.0
|-
| '''costBuy'''
| Amount of money spent for purchasing this item. If set to 0, this item will not be available in the Purchase/Recruit screen.
| 0
|-
| '''costSell'''
| Amount of money gained for selling this item.
| 0
|-
| '''transferTime'''
| Number of hours it takes to purchase/transfer this item to a base.
| 24
|-
| '''weight'''
| [[Item_Weight|Weight]] occupied by this item in a soldier's inventory.
| 999
|-
| '''bigSprite'''
| Sprite ID from [[BIGOBS.PCK]] used to draw this item in a soldier's inventory and UFOpaedia.
| -1
|-
| '''floorSprite'''
| Sprite ID from [[FLOOROB.PCK]] used to draw this item on the floor of a Battlescape tile.
| -1
|-
| '''handSprite'''
| Sprite ID from [[HANDOB.PCK]] used to draw this item on a soldier's hand in the Battlescape.
modders: each handobject needs 8 images (8 directions) define the extrasprites accordingly
| 120
|-
| '''bulletSprite'''
| Sprite ID from ''BulletSprites.png'' used to draw this weapon's projectile on the Battlescape:
* 0 - [[Rocket Launcher]]
* 1 - [[Pistol]]
* 2 - [[Rifle]]
* 3 - [[Auto Cannon]]
* 4 - [[Heavy Cannon]]
* 5 - [[Laser Pistol]]
* 6 - [[Laser Rifle]]
* 7 - [[Heavy Laser]]
* 8 - [[Plasma Rifle|Plasma]]
* 9 - [[Small Launcher]]
* 10 - [[Blaster Launcher]]
for modders: the bulletsprite needs to be put into the extraSprites type "Projectiles" the bulletsprite can contain up to 35 3x3 images. The corresponding file id is 35*[bulletSprite]
| -1
|-
| '''fireSound'''
| Sound ID from [[#Extra_Sounds|BATTLE.CAT]] played when this weapon fires.
| -1
|-
| '''hitSound'''
| Sound ID from [[#Extra_Sounds|BATTLE.CAT]] played when this weapon hits a target.
| -1
|-
| '''hitAnimation'''
| Sprite ID from [[SMOKE.PCK]] used to draw the weapon's "hit explosion".
'''NOTE''': Do not define this value for melee/psi weapons, they use [[HIT.PCK]] and therefore meleeAnimation instead.
| 0
|-
| '''power'''
| Average damage of the weapon, in most cases it will be +-50% this value.
| 0
|-
| '''strengthApplied'''
| Add the attacking unit's strength to this weapon's damage.
| false
|-
| '''compatibleAmmo'''
| List of string IDs of the ammo items that can be loaded on this weapon. If none are specified, the weapon doesn't need ammo.
| -
|-
| '''damageType'''
| What type of [[damage]] does this weapon do:
* 0 - None
* 1 - Armor Piercing
* 2 - Incendiary
* 3 - High Explosive
* 4 - Laser
* 5 - Plasma
* 6 - Stun
* 7 - Melee
* 8 - Acid
* 9 - Smoke
'''NOTE:''' A damage type other than 0-9 will do nothing.
| 0
|-
| '''tuAuto'''
'''accuracyAuto'''
| The percentage (0-100%) of [[Time Units]] (from the soldier's total) required to fire an Auto Shot. If 0, the weapon does not have an Auto Shot.
The base accuracy (0-100%) applied to a soldier's [[Firing Accuracy]] when firing an Auto Shot.
| 0
0
|-
| '''tuSnap'''
'''accuracySnap'''
| The percentage (0-100%) of [[Time Units]] (from the soldier's total) required to fire a Snap Shot. If 0, the weapon does not have a Snap Shot.
The base accuracy (0-100%) applied to a soldier's [[Firing Accuracy]] when firing a Snap Shot.
| 0
0
|-
| '''tuAimed'''
'''accuracyAimed'''
| The percentage (0-100%) of [[Time Units]] (from the soldier's total) required to fire an Aimed Shot. If 0, the weapon does not have an Aimed Shot.
The base accuracy (0-100%) applied to a soldier's [[Firing Accuracy]] when firing an Aimed Shot.
| 0
0
|-
|-
| '''tuMelee'''
'''accuracyMelee'''
| The percentage (0-100%) of [[Time Units]] (from the soldier's total) required to do a melee attack (Hit). If 0, the weapon does not have a melee attack.
The base accuracy (0-100%) applied to a soldier's [[Melee Accuracy]] when doing a melee attack.
| 0
0
|-
| '''clipSize'''
| The amount of ammo stored in each weapon clip. If -1 is specified, this weapon has infinite ammo.
| 0
|-
| '''battleType'''
| Defines the weapon's behavior in the Battlescape:
* 0 - None (Geoscape-only item)
* 1 - [[Weapons|Firearm]]
* 2 - Ammo
* 3 - Melee
* 4 - [[Grenade]]
* 5 - [[Proximity Grenade]]
* 6 - [[Medi-Kit (EU)|Medi-Kit]]
* 7 - [[Motion Scanner]]
* 8 - [[Mind Probe]]
* 9 - [[Psi-Amp]]
* 10 - [[Electro-flare]]
* 11 - Corpse
| 0
|-
| '''twoHanded'''
| Is this weapon two-handed? If true, incurs an accuracy penalty if used with both hands occupied. Note that the handsprite of a twoHanded item is also drawn at a slightly different position than a one handed item.
| false
|-
| '''waypoint'''
| Does this weapon use waypoints? (eg. [[Blaster Launcher]]). Can also be used to make ammo items use the waypoint system.
| false
|-
| '''fixedWeapon'''
| Is this weapon fixed? (it's part of a unit, eg. tanks and terrorist units)
| false
|-
| '''invWidth'''
| Item width in a soldier's inventory (in grid units).
| 1
|-
| '''invHeight'''
| Item height in a soldier's inventory (in grid units).
| 1
|-
| '''painKiller'''
| Amount of painkillers contained in a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''heal'''
| Amount of heal's contained in a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''stimulant'''
| Amount of stimulants contained in a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''woundRecovery'''
| Amount of [[Fatal Wounds]] treated by each heal of a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''healthRecovery'''
| Amount of [[Health]] recovered by each heal of a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''stunRecovery'''
| Amount of [[Stun]] removed by each stimulant of a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''energyRecovery'''
| Amount of [[Energy]] recovered by each stimulant of a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''tuUse'''
| Amount of [[Time Units]] required to use this item (for non-offensive items). It's a flat rate if '''flatRate''' is true, otherwise it's a percentage (0-100%).
| 0
|-
| '''recoveryPoints'''
| [[Score]] gained for recovering this alien artifact.
| 0
|-
| '''armor'''
| How much damage is needed to destroy this item on the ground.
| 20
|-
| '''recover'''
| Is this item recoverable? (gets transported to the X-COM base on mission success)
| true
|-
| '''turretType'''
| Sprite ID from [[TANKS.PCK]] of the turret to assign to this tank:
* 0 - [[Tank/Cannon]]
* 1 - [[Tank/Rocket Launcher]]
* 2 - [[Tank/Laser Cannon]]
* 3 - [[Hovertank/Plasma]]
* 4 - [[Hovertank/Launcher]]
| -1
|-
| '''liveAlien'''
| Does this item represent a live alien? (counts towards [[Alien Containment]])
| false
|-
| '''blastRadius'''
| Size of the projectile explosions. 0 for no explosion. -1 to automatically calculate based on weapon power and damage type (actual '''blastRadius''' currently is capped due [[Explosions#Playing_With_Fire|Explosion calculations]]).
| -1
|-
| '''flatRate'''
| If true, then TU costs for this weapon are a flat rate (instead of a percentage of unit TUs).
| false
|-
| '''arcingShot'''
| Does this weapon fire in an arc?
| false
|-
| '''attraction'''
| Represents how likely an alien is to pick up this item. Values below 5 will be ignored (by design).
| 0
|-
| '''maxRange'''
| Maximum range at which this weapon can operate.
| 200
|-
| '''aimRange'''
| Maximum effective range with this weapon before which range-based dropoff occurs.
| 200
|-
| '''snapRange'''
| Maximum effective range with snap shot before which range-based dropoff occurs. (ufoextender accuracy only)
| 15
|-
| '''autoRange'''
| Maximum effective range with auto shot before which range-based dropoff occurs. (ufoextender accuracy only)
| 7
|-
| '''minRange'''
| Range-based dropoff will work in reverse for ranges below this.
| 0
|-
| '''dropoff'''
| The value by which the accuracy lowers for each tile after (or before) the thresholds above.
| 2
|-
| '''bulletSpeed'''
| How much faster (or slower, if you use a negative number) is a projectile fired from this weapon compared to the average.
| 0
|-
| '''autoShots'''
| How many auto shots does this weapon fire.
| 3
|-
| '''shotgunPellets'''
| Number of projectiles fired per unit of ammunition. (note: due to engine limitations it is currently impossible to draw multiple projectiles in flight.)
| 0
|-
| '''zombieUnit'''
| String ID of the unit used for zombification (eg. [[Chrysallid]]s turn units into [[Zombie]]s).
| none
|-
| '''meleeSound'''
| Sound ID from [[#Extra_Sounds|BATTLE.CAT]] played when this weapon attacks a target with melee.
| 39
|-
| '''meleeHitSound'''
| Sound ID from [[#Extra_Sounds|BATTLE.CAT]] played when this weapon HITS a target with melee.
| -1
|-
| '''meleeAnimation'''
| Sprite ID from HIT.PCK played when this weapon attacks a target with melee.
| 0
|-
| '''meleePower'''
| Damage this weapon will do when using melee. This only applies to Firearms, and is only available as stun damage. For normal melee weapons, use regular power and damage types.
| 0
|-
| '''LOSRequired'''
| Does this item require line of sight? (only applies to mind probes and psi-amps)
| false
|-
| '''skillApplied'''
| Is melee skill applied to the accuracy of an attack made with this object?
| true
|-
|}

=== UFOs ===

Defines one of the [[UFOs]] that invade Earth, listed in ''"ufos:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the UFO name.
| ''required''
|-
| '''size'''
| String ID of the UFO size.
| STR_VERY_SMALL
|-
| '''sprite'''
| Sprite ID from [[INTERWIN.DAT]] used to draw this UFO in the dogfight view and UFOpaedia.
don't try to add more images if you don't want to punch yourself in the face - use modsprite
| -1
|-
| '''modSprite'''
| Filename used to draw this UFO in the dogfight view and UFOpaedia.
| -
|-
| '''damageMax'''
| Maximum amount of damage this UFO can take. If the UFO takes 50% damage, it crash lands. If it takes 100% damage, it is destroyed.
| 0
|-
| '''speedMax'''
| Maximum speed in nautical miles.
| 0
|-
| '''accel'''
| Aceeleration value shown in the UFOpaedia.
| 0
|-
| '''power'''
| Damage power of this UFO's weapon in dogfights.
| 0
|-
| '''range'''
| Maximum range of this UFO's weapon in dogfights (in meters).
| 0
|-
| '''score'''
| [[Score]] gained when this UFO is destroyed, or half this score if it crash lands.
| 0
|-
| '''reload'''
| Time the UFO's weapon takes to fire between each shot.
| 0
|-
| '''breakOffTime'''
| Minimum amount of time for the UFO to be able to break off of a dogfight.
| 0
|-
| '''battlescapeTerrainData'''
| [[#Terrains|Terrain]] associated to this UFO in Battlescape missions.
| ''required''
|-
|}

=== Inventory Sections ===

Defines one of the sections of the [[Inventory TU Table|Battlescape inventory]] (eg. Backpack), listed in ''"invs:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the inventory name.
| ''required''
|-
| '''x'''
'''y'''
| Pixel coordinates of this section on the inventory screen.
| 0
0
|-
| '''type'''
| Type of this section:
* 0 = Slot section, can contain as many items as will fit on the slots.
* 1 = Hand section, can only contain one item regardless of size.
* 2 = Ground section, can contain infinite items.
| 0
|-
| '''slots'''
| List of the grid slots (''[x, y]'') that this section is composed of. For example, to make a 2x2 section, you would have ''[0, 0] [0, 1] [1, 0] [1, 1]''.
| -
|-
| '''costs'''
| List of [[Time Units]] costs to move an item from this section to another one (eg. ''STR_BACKPACK: 16'' means it will cost 16 TUs to move an item from this section to the Backpack).
| -
|-
|}

=== Terrains ===

Defines one of the [[TERRAIN|terrains]] used to generate a Battlescape map, listed in "terrains:".

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''name'''
| String ID of the terrain name.
| ''required''
|-
| '''largeBlockLimit'''
| Maximum amount of large blocks that can be used on map generation.
| 0
|-
| '''textures'''
| List of [[TEXTURE.DAT|Geoscape textures]] that correspond to this terrain.
| -
|-
| '''hemisphere'''
| Geoscape hemisphere associated with this terrain:
* -1 - Northern hemisphere.
* 0 - Both hemispheres.
* 1 - Southern hemisphere.
| 0
|-
| '''mapDataSets'''
| List of filenames (each with matching [[MCD]]/[[Image Formats#PCK|PCK/TAB]] files) that contain the tiles of this terrain.
| -
|-
| '''mapBlocks'''
| List of map blocks (see below) that are used for generating a map.
| -
|-
| '''roadTypeOdds'''
| Odds as a % of generating each type of road (E-W Road, N-S Road, Crossing) odds for crossing are: 100 - EW - NS.
| [0 0]
|-|-
| '''civilianTypes'''
| List of units to use as civilians for this mission.
| [MALE_CIVILIAN, FEMALE_CIVILIAN]
|-
|}

==== Map Blocks ====

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''name'''
| Filename of the [[MAPS|map]].
| ''required''
|-
| '''width'''
| Width of this map block in Battlescape grid units.
| 0
|-
| '''length'''
| Length of this map block in Battlescape grid units.
| 0
|-
| '''height'''
| Height of this map block in Battlescape grid units.
| 1
|-
| '''type'''
| Type of this map block:
* -1 - Undefined
* 0 - Default
* 1 - Landing Zone (for placing X-COM / alien craft)
* 2 - E-W Road (for city maps)
* 3 - N-S Road (for city maps)
* 4 - Road Crossing (for city maps)
* 5 - Dirt (for filling empty base blocks)
* 6 - X-COM spawn point (for [[Alien Base]] / [[Cydonia]] missions)
* 7 - [[Alien Base]] Target
* 8 - [[Cydonia]] Target
| -1
|-
| '''subType'''
| Sub-type of this map block (see '''type''').
| -1
|-
| '''frequency'''
| Frequency of this block in a map.
| 1
|-
| '''maxCount'''
| Maximum amount of times this block can be used in a map. If -1 there is no limit.
| -1
|-
| '''items'''
| An array of items to add to this mapblock, an the positions to place them at.
| -1
|}

*'''frequency''' defines the odds of the map appearing on the map
** The value assigned (default: 1) is used in ''x/n'', which defines the probability of being chosen.
** ''x'' is the integer defined for the map block's frequency and ''n'' is the combined total of probabilities for all the map types combined.
** This property can only be used in type 0 map blocks.
*'''maxCount''' is the maximum number of times it can be used.
** The value assigned is also used in ''x/n'' to determine the probability of being chosen.
** Each use reduces ''x'' by -1, with the caveat that being used as a Landing Zone type will not reduce the x value since it could result in no available Landing Zones.
** This property can only be used in type 0 map blocks.
* '''hemisphere''' only applies to UFO missions, not Terror ones.
*'''width/length''' defines the size of the map
** be aware that the mapview "width"-label is the openxcom ruleset length parameter
** be aware that the mapview "length"-label is the openxcom ruleset width parameter

==== Guidelines/Tips ====
* All maps with an XCOM/Alien craft require at least one type 1 map block. This map block can only contain ground tiles (no walls or objects), otherwise the game will crash or the walls/objects will be removed.
* All Terror terrains (listed under STR_TERROR_MISSION) require at least 1 map block of '''Types''' 2, 3 and 4 (for a total of 3 maps, which are required to place roads) and the corresponding '''roadTypeOdds''' added to the ruleset.
* If there isn't any map blocks designed as roads since you want to keep your terrain 'random', this can be circumvented by designating all 10x10 map blocks, excluding the one(s) used for the XCOM craft, as either '''Type''' 2, 3 and 4 and by defining their '''subType''' to 0. The game will then randomly choose between the map blocks for each type used in the roads, making them map more random.

=== Armor ===

Defines a Battlescape unit's [[armor]] as well as visual representation (so every unit has an armor), listed in ''"armors:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the armor name.
| ''required''
|-
| '''spriteSheet'''
| Sprite sheet from [[UNITS]] used to draw a unit wearing this armor.
| -
|-
| '''spriteInv'''
| Sprite used for the [[Inventory Backgrounds]] of a unit wearing this armor.
| -
|-
| '''corpseBattle'''
| List of string IDs of the corpse [[#Items|items]] generated when a unit wearing this armor is killed (one per unit tile) on the Battlescape.
| -
|-
| '''corpseGeo'''
| String ID of the corpse [[#Items|item]] associated with this unit on the Geoscape.
| -
|-
| '''storeItem'''
| String ID of the [[#Items|item]] that represents this armor in [[Base Stores]] for equipping.
| -
|-
| '''weight'''
| Physical weight of the armor when worn
| 6
|-
| '''stats'''
| like soldier stats (see below) but these are treated as stat bonuses for wearing the specific armor.
| -
|-
| '''frontArmor'''
| Protection provided on the front of the unit.
| 0
|-
| '''sideArmor'''
| Protection provided on the sides of the unit.
| 0
|-
| '''rearArmor'''
| Protection provided on the rear of the unit.
| 0
|-
| '''underArmor'''
| Protection provided under the unit (eg. from explosions).
| 0
|-
| '''drawingRoutine'''
| Drawing routine used to put together the body parts in the unit's '''spriteSheet''':
* 0 = [[Soldier]], [[Sectoid]]
* 1 = [[Floater]]
* 2 = [[HWP]]
* 3 = [[Cyberdisk]]
* 4 = [[Civilian]], [[Ethereal]]
* 5 = [[Sectopod]], [[Reaper]]
* 6 = [[Snakeman]]
* 7 = [[Chryssalid]]
* 8 = [[Silacoid]]
* 9 = [[Celatid]]
* 10 = [[Muton]]
| 0
|-
| '''movementType'''
| Type of movement provided by this armor:
* 0 = Walking
* 1 = Flying
* 2 = Sliding (no walking animation)
it also defines the body of an tank (32-images) in your spriteSheet or the change in sprites while flying using a flying armour see: [[TANKS.PCK]], [[XCOM_2.PCK]]
| 0
|-
| '''damageModifier'''
| List of decimal damage modifiers (1.0 = 100%) this armor applies to each damage type (see [[#Items|Items section]]) received. Modifiers must be specified for all damage types, in this order:
* None
* Armor Piercing
* Incendiary
* High Explosive
* Laser
* Plasma
* Stun
* Melee
* Acid
* Smoke
|
- 1.0 
- 1.0 
- 1.0 
- 1.0 
- 1.0 
- 1.0 
- 1.0 
- 1.0 
- 1.0 
- 1.0
|-
| '''size'''
| Size of the unit wearing this armor, in Battlescape grid units. Every unit is square, so a size of 2 means 2x2.
| 1
|-
| '''loftempsSet'''
| List of [[LOFTEMPS]] IDs (one per unit tile, so a 1x1 unit has 1, a 2x2 unit has 4, etc.) used to represent a unit wearing this armor in 3D space.
| -
|-
| '''loftemps'''
| loftemps is a deprecated option that only works for 1x1 sized units.
| -
|}

=== Player Units (Soldiers) ===

Defines a [[soldier]] recruited by X-COM, listed in ''"soldiers:"''. Currently only one soldier unit type (''XCOM'') is supported.

Unit stats are represented as follows:
* [[Time Units|tu]]
* [[Energy|stamina]]
* [[Health|health]]
* [[Bravery|bravery]] (always a multiple of 10)
* [[Reactions|reactions]]
* [[Firing Accuracy|firing]]
* [[Throwing Accuracy|throwing]]
* [[Strength|strength]]
* [[Psi Strength|psiStrength]]
* [[Psi Skill|psiSkill]]
* [[Melee Accuracy|melee]] (not visible)

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the soldier name.
| ''required''
|-
| '''minStats'''
| Minimum values used to generate the soldier's [[Starting Stats]]. In this case, ''psiSkill'' is treated as the initial stat (not generated).
| -
|-
| '''maxStats'''
| Maximum values used to generate the soldier's [[Starting Stats]]. In this case, ''psiSkill'' is treated as the minimum value for the first month of psi training (actual value is 100%-150%).
| -
|-
| '''statCaps'''
| Maximum stats this soldier can gain through [[Experience]]. '''NOTE:''' A stat will still go over the limit once, and then will no longer increase (see [[Experience#Regarding Caps|Regarding Caps]]).
| -
|-
| '''armor'''
| String ID of the [[#Armor|armor]] this soldier uses by default.
| -
|-
| '''standHeight'''
| Height of this soldier when standing.
| 0
|-
| '''kneelHeight'''
| Height of this soldier when kneeling.
| 0
|-
| '''floatHeight'''
| Distance between the bottom of this unit and the ground.
| 0
|}

=== AI Units (Aliens/Civilians) ===

Defines an [[Alien Life Forms|alien]] (enemy) or [[civilian]] (neutral) unit, listed in ''"units:"''. Every different alien rank is a different unit, since they have completely different stats. Unit stats are represented as follows:
* [[Time Units|tu]]
* [[Energy|stamina]]
* [[Health|health]]
* [[Bravery|bravery]] (always a multiple of 10)
* [[Reactions|reactions]]
* [[Firing Accuracy|firing]]
* [[Throwing Accuracy|throwing]]
* [[Strength|strength]]
* [[Psi Strength|psiStrength]]
* [[Psi Skill|psiSkill]]
* [[Melee Accuracy|melee]] (not visible)

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the unit name.
| ''required''
|-
| '''race'''
| String ID of the unit race (for alien units).
| -
|-
| '''rank'''
| String ID of the unit rank (for alien units).
| -
|-
| '''stats'''
| Battlescape stats of this unit.
| -
|-
| '''armor'''
| String ID of the [[#Armor|armor]] this unit uses by default.
| -
|-
| '''standHeight'''
| Height of this unit when standing.
| 0
|-
| '''floatHeight'''
| Distance between the bottom of this unit and the ground.
| 0
|-
| '''value'''
| [[Score]] this unit is worth.
| 0
|-
| '''deathSound'''
| Sound ID from [[#Extra_Sounds|BATTLE.CAT]] played when this unit dies.
| -1
|-
| '''aggroSound'''
| Sound ID from [[#Extra_Sounds|BATTLE.CAT]] played when this unit aggros.
| -1
|-
| '''moveSound'''
| Sound ID from [[#Extra_Sounds|BATTLE.CAT]] played when this unit moves.
| -1
|-
| '''intelligence'''
| Intelligence of this unit's AI. The higher the value, the longer this unit remembers player troops between turns.
| 0
|-
| '''aggression'''
| Aggression of this unit's AI. The higher the value, the more ruthless the unit, the more likely to make a frontal assault. Less aggressive units tend to set up ambushes.
Vanilla values are:
* 0 = mostly passive
* 1 = balanced
* 2 = mostly aggresive
| 0
|-
| '''energyRecovery'''
| Energy recovered by the unit each turn (needs verification)
| 40 (?)
|-
| '''specab'''
| Special ability of this unit:
* 0 = None
* 1 = [[Cyberdisc|Explodes on Death]]
* 2 = [[Bio-Drone|Burns Floor]]
* 3 = [[Zombie|Respawns on Death]]
| 0
|-
| '''spawnUnit'''
| String ID of the unit used to respawn on death (eg. [[Zombie]]s respawn as [[Chrysallid]]s).
| -
|-
| '''livingWeapon'''
| Is this unit a living weapon? (only attacks with a '''fixedWeapon''')
| false
|-
|}

=== Alien Races ===

Defines a [[Alien Life Forms|race]] used in [[Alien Missions]], listed in ''"alienRaces:"''. Heavily tied with deployment data.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''id'''
| String ID of the alien race name.
| ''required''
|-
| '''members'''
| Alien crew associated with this alien race (eg. race units + terrorist units), defined by a list of unit string IDs. Order here will define rank in terms of deployment. generally speaking the order is:
* 0 - Commander
* 1 - Leader
* 2 - Engineer
* 3 - Medic
* 4 - Navigator
* 5 - Soldier
* 6 - Terrorist 1
* 7 - Terrorist 2
but of course, not all races have all ranks, so the "fill in" rank would be listed multiple times (see ethereals).
|-
| '''retaliation'''
| retaliation enables/disables the race for retaliation missions.
| ''True''
| -
|}

=== Alien Deployments ===

Defines a Battlescape deployment data used in [[Alien Missions]] (such as alien and map configurations), listed in ''"alienDeployments:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the deployment name.
| ''required''
|-
| '''width'''
| Width of the Battlescape map in grid units.
| 0
|-
| '''length'''
| Length of the Battlescape map in grid units.
| 0
|-
| '''height'''
| Vertical height of the Battlescape map in grid units.
| 0
|-
| '''terrains'''
| list of string IDs of the [[#Terrains|terrain]] to choose from to generate this map. This is not used for UFO sites where the terrain comes from the Geoscape.
| -
|-
| '''shade'''
| Shade of the map (0-15, where 0 is full daytime and 15 is full nighttime). This is not used for UFO sites where the shade comes from the Geoscape.
| 0
|-
| '''nextStage'''
| String ID of the next deployment stage to use after this one, for multi-stage missions.
| -
|-
| '''data'''
| List of deployment data for each alien rank on this mission (see below).
| -
|}

Notes:
* '''terrains''' can also be used with UFOs, with the game using instead the listed terrain rather than the location of the UFO on Geoscape.
==== Deployment Data ====

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''alienRank'''
| [[Alien Rank|Rank]] associated with this deployment data, as defined by the order of the race in question (see above)
| ''required''
|-
| '''lowQty'''
| Maximum quantity of aliens to spawn (beginner).
| 0
|-
| '''highQty'''
| Maximum quantity of aliens to spawn (superhuman).
| 0
|-
| '''dQty'''
| Minimum Desired Quantity of aliens to spawn.
| 0
|-
| '''percentageOutsideUfo'''
| Percentage (0-100%) of aliens to spawn outside in UFO sites.
| 0
|-
| '''itemSets'''
| Three lists (one for each alien technology level) of [[#Items|items]] (string IDs) for the aliens to equip.
| ''required''
|-
|}

=== Research ===

Defines a [[Research|research topic]] that X-COM scientists can investigate, listed in ''"research:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''name'''
| String ID of the research project's name (or item, if a '''lookup''' is defined).
| ''required''
|-
| '''lookup'''
| String ID of the research project's display name and UFOPaedia article reference.
| -
|-
| '''cost'''
| Number of man hours (on average) required to complete this project.
| 0
|-
| '''points'''
| [[Score]] earned for completing this project.
| 0
|-
| '''needItem'''
| Does this project require an [[#Items|item]] of the same name?
| false
|-
| '''dependencies'''
| List of research projects that can unlock access to this one. If the full list is researched, or if one of the projects on the list "unlocks" this one, it becomes available.
| -
|-
| '''unlocks'''
| List of research projects unlocked, regardless of other dependencies, but not requirements, by completing this project (for example, any live alien unlocks "alien origins").
| -
|-
| '''requires'''
| List of research projects unilaterally required before this project can be unlocked (for example, "the martian solution" will not even be considered for unlocking until AFTER "alien origins" is completed).
| -
|-
| '''getOneFree'''
| List of "bonus" research projects that may be granted when completing this project (for example, alien medics will give you information on other alien races). Only applies to living aliens.
| -
|-
|}

=== Manufacture ===

Defines a [[Manufacture|manufacture project]] that X-COM engineers can produce, listed in ''"manufacture:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''name'''
| String ID of the manufacturing project's name (and the item it produces).
| ''required''
|-
| '''category'''
| String ID of the manufacturing project's category.
| -
|-
| '''requires'''
| List of [[#Research|topics]] (string IDs) that must be researched to unlock this project. If none are specified, this project is unlocked from the start.
| -
|-
| '''space'''
| Amount of [[Workshop]] space required to begin this project.
| 0
|-
| '''time'''
| Number of man hours (on average) required per item.
| 0
|-
| '''cost'''
| Monetary deduction per item manufactured.
| 0
|-
| '''requiredItems'''
| List of [[#Items|items]] required and consumed per item manufactured.
| -
|-
| '''producedItems'''
| List of [[#Items|items]] produced per each item consumed. If not specified, defaults to 1 item with the same string ID as the manufacture.
| 1
|-
|}

=== UFOpaedia Article ===

Defines an article in the in-game [[UFOpaedia]], listed in ''"ufopaedia:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''id'''
| String ID of the article name. This must match the ID of the object associated with this article, if applicable.
| ''required''
|-
| '''title'''
| String ID of the article title. If omitted, the '''id''' is used.
| -
|-
| '''type_id'''
| Type of this article:
* 0 = Unknown
* 1 = [[Craft]]
* 2 = [[Craft Armaments]]
* 3 = [[HWP]]
* 4 = [[Equipment (EU)|Equipment]]
* 5 = [[Armour]]
* 6 = [[Base Facilities]]
* 7 = Text & Image (eg. [[Alien Life Forms]], [[UFO Components]])
* 8 = Text (eg. [[Alien Research]])
* 9 = [[UFO]]
| 0
|-
| '''section'''
| String ID of the UFOpaedia section this article belongs in.
| -
|-
| '''requires'''
| List of [[#Research|topics]] (string IDs) that must be researched to unlock this article. If none are specified, this article is unlocked from the start.
| -
|-
| '''image_id'''
| Filename of the [[UP001.SPK-UP042.SPK|background image]] displayed on this article, if applicable.
| -
|-
| '''text'''
| String ID of the description displayed on this article.
| -
|-
| '''text_width'''
| Maximum width of the text displayed, only applicable to ''Text & Image'' articles.
| 0
|-
| '''rect_stats'''
| Rectangle ('''x''', '''y''', '''width''', '''height''') of the stats text on the screen, only applicable to ''Craft'' articles.
| 0
|-
| '''rect_text'''
| Rectangle ('''x''', '''y''', '''width''', '''height''') of the description text on the screen, only applicable to ''Craft'' articles.
| 0
|-
| '''weapon'''
| String ID of the weapon, only applicable to ''HWP'' articles.
| -
|}

=== UFO Trajectories ===

Defines a trajectory carried out by an UFO during an [[#Alien Missions|alien mission]], listed in ''"ufoTrajectories:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''id'''
| String ID of the trajectory name.
| ''required''
|-
| '''groundTimer'''
| Amount of seconds for the UFO to spend on Ground waypoints.
| 0
|-
| '''waypoints'''
| List of waypoints for the UFO to traverse, defined as ''[zone, altitude, speed]''. 
'''zone''': Globe zone where the waypoint is located. 
'''altitude''': UFO altitude after reaching this waypoint:
* 0 - Ground
* 1 - Very Low
* 2 - Low
* 3 - High
* 4 - Very High
'''speed''': UFO speed after reaching this waypoint, as a percentage (0-100%) of its maximum speed.
| -
|}

=== Alien Missions ===

Defines an [[Alien Missions|alien mission]] carried out by UFOs on the Geoscape, listed in ''"alienMissions:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the mission type.
| ''required''
|-
| '''points'''
| [[Score]] allocated to aliens for successfully completing this mission.
| 0
|-
| '''raceWeights'''
| List of alien races likely to carry out this mission, and the % chance of them being allocated to this mission, listed by "number of months after game beginning".
| ''required''
|-
| '''waves'''
| List of UFO waves to spawn as this mission progresses, as described below.
| ''required''
|}

==== Waves ====

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''ufo'''
| String ID of the [[#UFOs|UFO]] to spawn.
| ''required''
|-
| '''count'''
| Number of UFOs to spawn.
| 0
|-
| '''trajectory'''
| String ID of the [[#UFO Trajectories|trajectory]] for this UFO to use when entering Earth's atmosphere.
| ''required''
|-
| '''timer'''
| How long after the previous wave should this wave arrive? (in seconds)
| 0
|-
|}

=== Alien Item Levels ===

This is a list of item level probabilities, with a number between 0 and 2 representing an item level from plasma pistols to heavy plasmas, as defined in the deployments, expressing a 10% probability for that item level being used.

0 = first set (plasma pistol/clip)
1 = second set (plasma rifle/clip)
2 = third set (heavy plasma/clip)

For example:
[ 2, 0, 0, 0, 0, 0, 0, 1, 1, 1 ]
would represent a 60% chance for pistols, 30% rifles, and 10% heavy weapons. 
Note that the order does not matter, but the length DOES. each line MUST have 10 digits.

The above can be confusing. There are 10 fields; each number represents 10%. 
There are six instances of '0'. 6x10% = 60% chance of plasma pistol 
There are three instances of '1'. 3x10% = 30% chance of plasma rifle 
There is only one instance of '2'. 1x10% = 10% chance of heavy plasma 

Each line represents a month after the beginning of the game, and there is no limit to the number defined. 
OpenXCom will use the most recently available item level in the event the game goes on forever.

=== Extra Sprites ===

Adds or replaces sprites in an existing [[Image Formats|X-COM image file]], listed in ''"extraSprites:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| Filename of the original/new image to modify.
| ''required''
|-
| '''width'''
'''height'''
| Size of the sprite(s) in pixels.
| 0
0
|-
| '''singleImage'''
| Is the image file just a single sprite (true) or a spritesheet (false)?
| false
|-
| '''subX'''
'''subY'''
| Size of the subdivision in pixels. If a subdivision is specified, then the image file is divided into chunks to form the sprites (eg. spritesheets).
| 0
0
|-
| '''files'''
| List of the new sprites to add/replace, listed as ''spriteID: filename''.
| -
|}

Example:
- type: GIANTBUNNY.PCK
width: 32
height: 40
files:
0: Resources/Bunny/Bunny00.png
1: Resources/Bunny/Bunny01.bmp
2: Resources/Bunny/Bunny02.gif

=== Extra Sounds ===

Adds or replaces sounds in an existing [[SOUND|X-COM sound file]], listed in ''"extraSounds:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| ID of the original sound file to modify:
* BATTLE.CAT - Battlescape sounds, corresponds to ''SOUND1.CAT'' or ''SAMPLE2.CAT'' (55 sounds).
* INTRO.CAT - Intro sounds, corresponds to ''INTRO.CAT'' or ''SAMPLE3.CAT'', probably best not to mess with these.
* GEO.CAT - Geoscape sounds, corresponds to ''SOUND2.CAT'' or ''SAMPLE.CAT'' (14 sounds).
| ''required''
|-
| '''files'''
| List of the new sounds to add/replace, listed as ''soundID: filename''.
| -
|}

Example:
- type: BATTLE.CAT
files:
55: Resources/Sounds/sample.wav

=== Extra Strings ===

Adds or replaces text strings in an existing [[Translations (OpenXcom)|OpenXcom language file]], listed in ''"extraStrings:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| Filename of the original language file to modify, sans extension.
| ''required''
|-
| '''strings'''
| List of the new strings to add/replace, listed as ''stringID: text''.
| -
|}

Example:
- type: en-US
strings:
STR_SNIPER_RIFLE: Sniper Rifle
STR_SNIPER_RIFLE_CLIP: Sniper Rifle Clip
- type: en-GB
strings:
STR_SNIPER_RIFLE: Sniper Rifle
STR_SNIPER_RIFLE_CLIP: Sniper Rifle Clip
- type: de
strings:
STR_SNIPER_RIFLE: Scharfschützengewehr
STR_SNIPER_RIFLE_CLIP: Scharfschützengewehrmunition
- type: ru
strings:
STR_SNIPER_RIFLE: Снайперская винтовка
STR_SNIPER_RIFLE_CLIP: Магазин к снайп. винтовке

=== Interfaces ===

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| ''?''
| -
|-
| '''elements'''
| ''?''
| -
|-
| '''id'''
| ''?''
| -
|-
| '''color'''
| ''?''
| -
|}

=== StatStrings ===

[[Statstrings]] are used for automatically renaming soldiers. They are case sensitive and they are processed in the order in which they are specified.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''string'''
| String to add to name.
| ''required''
|-
| '''psiStrength''' 
'''psiSkill''' 
'''bravery''' 
'''strength''' 
'''firing''' 
'''reactions''' 
'''stamina''' 
'''tu''' 
'''health''' 
'''throwing'''
| One or more stat ranges are ANDed together for success. Each range has a minVal and maxVal. Use YAML standard tilde (~) to indicate null. ((~) = 0 as minvalue; (~) =255 as maxvalue)
| -
|}

Example:
statStrings:
- string: "x"
psiStrength: [~, 30]
- string: "P"
psiStrength: [80, ~]
- string: "p"
psiStrength: [60, 79]
- string: "K"
psiSkill: [60, ~]
- string: "k"
psiSkill: [30, 59]
- string: "b"
bravery: [60, ~]
- string: "c"
bravery: [~, 10]
- string: "w"
strength: [~, 25]
- string: "Snpr"
firing: [60, ~]
reactions: [60, ~]
- string: "M"
firing: [70, ~]
- string: "m"
firing: [60, 69]
- string: "Sct"
reactions: [50, ~]
tu: [60, ~]
- string: "R"
reactions: [60, ~]
- string: "r"
reactions: [50, 59]

==References==
<references />

[[Category:OpenXcom]]

Ruleset Reference (OpenXcom)

2014-10-08T15:28:24Z

Falko: /* StatStrings */

A reference of all the customizable values of everything in a [[Rulesets (OpenXcom)|ruleset]]. Some guidelines:
* If a value is omitted from the ruleset, the default is used. You cannot omit ''required'' values.
* Text strings (eg. names) are represented by string IDs from the [[Translations (OpenXcom)|language files]]
* Numerical IDs (used for sprites, sounds, etc.) start at 0, not 1.
* Boolean (yes/no) values are represented by true/false.
* World coordinates are represented in degrees (see [[WORLD.DAT]]).
* Money amounts (prices, costs, etc.) are represented in dollars.
* All paths are '''case sensitive'''! If your ruleset uses external files, make sure that they named properly as described in ruleset.

Items are ordered as they come in the ruleset. To override this, you can specify a ''listOrder''. You can find the default listOrders in [[Ruleset List Order (OpenXcom)|Ruleset List Order]].

=== Globe ===

Defines the drawing of landmasses and borders on the globe.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''data'''
| Path name of file which contains polygon and texture information. (For example WORLD.DAT).
| -
|-
| '''polygons'''
| List of polygons drawn on the globe surface. A triangle consist of seven values: the first number defines the texture, followed by three pairs of (x,y) globe coordinates. Only polygons with 3 or 4 vertices are reliable shown on the globe = 7 or 9 values per entry.
| -
|-
| '''polylines'''
| List of border lines. Each list entry consist of a list of (x,y) globe coordinates.
| -
|}

=== Countries ===

Defines one of the [[Country Funding (EU)|funding nations]], listed in ''"countries:"''. They're used for activity graphs and player scoring.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the country name.
| ''required''
|-
| '''fundingBase'''
| Country's base funding, in thousands. The starting funding can be anywhere between 1x and 2x the base funding.
| 0
|-
| '''fundingCap'''
| Country's funding cap, in thousands. Once a country reaches this maximum, it will no longer increase its funding.
| 0
|-
| '''labelLon'''
'''labelLat'''
| Longitude and latitude coordinates of the country's label on the globe. This label is only shown when the globe is zoomed in and "detail" is turned on.
| 0.0
0.0
|-
| '''areas'''
| List of "rectangles" on the globe defined as [''lon1'' ''lat1'' ''lon2'' ''lat2'']. Any activity within these areas counts towards the country's graph activity and affects their opinion of the player.
| -
|}

=== Regions ===

Defines one of the [[Geoscape (EU)#World Regions/Countries|world regions]], listed in ''"regions:"''. They're used for base placement, activity graphs and mission spawning.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the region name.
| ''required''
|-
| '''cost'''
| Amount of money spent building an X-COM base in this region (first base is free).
| 0
|-
| '''areas'''
| List of "rectangles" on the globe defined as ''[lon1, lat1, lon2, lat2]''. Any activity within these areas counts towards the region's graph activity.
| -
|-
| '''cities'''
| List of cities belonging to this region. They will be displayed on the globe and used for terror site missions. Each city is defined by their '''lon''' and '''lat''' coordinates and a '''name''' string ID.
| -
|-
| '''regionWeight'''
| Weight of this region when selecting regions for alien missions.
| 0
|-
| '''missionWeights'''
| Weighted list of the different mission types for this region (eg. ''STR_ALIEN_RESEARCH: 14'').
| -
|-
| '''missionZones'''
| List of "rectangles" (''[lon1, lat1, lon2, lat2]'') defining the mission zones for this region.
| -
|-
| '''missionRegion'''
| Spawn mission in this region instead (used for regions without land).
| -
|}

=== Base Facilities ===

Defines one of the [[Base Facilities (EU)|facilities]] that can be built in an X-COM base, listed in ''"facilities:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the facility name.
| ''required''
|-
| '''requires'''
| List of [[#Research|topics]] (string IDs) that must be researched to unlock this facility. If none are specified, this facility is unlocked from the start.
| -
|-
| '''spriteShape'''
| Sprite ID from [[BASEBITS.PCK]] used to draw the facility's outer shape in the Basescape and UFOpaedia.
| -1
|-
| '''spriteFacility'''
| Sprite ID from [[BASEBITS.PCK]] used to draw the facility's contents in the Basescape and UFOpaedia. Drawn on top of '''spriteShape'''.
| -1
|-
| '''lift'''
| Is this facility an [[Access Lift]]? All base facilities must be connected to the lift.
| false
|-
| '''hyper'''
| Is this facility a [[Hyperwave Decoder]]? Displays extra information for detected UFOs. Only valid for radar facilities.
| false
|-
| '''mind'''
| Is this facility a [[Mind Shield]]? Reduces the chance of UFOs finding your base. Does not stack.
| false
|-
| '''grav'''
| Is this facility a [[Grav Shield]]? Doubles the power of your base defenses. Does not stack.
| false
|-
| '''size'''
| Size of the facility, in grid units. Every facility is square, so a size of 1 means 1x1, 2 means 2x2, etc. Bigger facilities are made up of multiple sprites, for example a 2x2 facility will use 4 sprites for '''spriteShape''' and 4 sprites for '''spriteFacility''' (top-left, top-right, bottom-left, bottom-right).
| 1
|-
| '''buildCost'''
| Amount of money spent to build this facility in the base.
| 0
|-
| '''buildTime'''
| Amount of days it takes for this facility to be built.
| 0
|-
| '''monthlyCost'''
| Amount of money spent monthly for the maintenance of this facility.
| 0
|-
| '''storage'''
| Amount of storage space (for items) this facility provides. See [[Base Stores]].
| 0
|-
| '''personnel'''
| Amount of personnel (soldiers, scientsts, engineers) these quarters can contain.
| 0
|-
| '''aliens'''
| Amount of live aliens this facility can contain. Only checked if the ''alienContainmentLimitEnforced'' option is enabled.
| 0
|-
| '''crafts'''
| Amount of X-COM craft this facility can contain.
| 0
|-
| '''labs'''
| Amount of lab space this facility provides for research projects.
| 0
|-
| '''workshops'''
| Amount of workshop space this facility provides for manufacture projects.
| 0
|-
| '''psiLabs'''
| Amount of soldier space this facility provides for psionic training.
| 0
|-
| '''radarRange'''
| Maximum radar detection range of this facility, in nautical miles.
| 0
|-
| '''radarChance'''
| Chance (0-100%) of this radar detecting a UFO that enters its range.
| 0
|-
| '''defense'''
| Offensive power provided by this base defense against attacking UFOs.
| 0
|-
| '''hitRatio'''
| Chance (0-100) of the base defense hitting an attacking UFO.
| 0
|-
| '''fireSound'''
| Sound ID from [[#Extra_Sounds|GEO.CAT]] played when the base defense fires.
| -1
|-
| '''hitSound'''
| Sound ID from [[#Extra_Sounds|GEO.CAT]] played when the base defense hits a target.
| -1
|-
| '''mapName'''
| [[MAPS|Map]] associated to this facility in Battlescape base defenses.
| -
|-
|}

=== Crafts ===

Defines one of the [[Craft|X-COM crafts]] that go on interception missions, listed in ''"crafts:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the craft name.
| ''required''
|-
| '''requires'''
| List of [[#Research|topics]] (string IDs) that must be researched to unlock this craft. If none are specified, this craft is unlocked from the start.
| -
|-
| '''sprite'''
| Sprite ID from [[BASEBITS.PCK]] used to draw this craft in the Basescape and from [[INTICON.PCK]] used to draw the damage indicator in dogfights.
modders: the corresponding extrasprite file id for BASEBITS.PCK is sprite+33 INTICON.PCK contains a minimized icon id=sprite the file id for the dogfight image is sprite+11
| -1
|-
| '''fuelMax'''
| Maximum amount of fuel this craft can carry. Crafts use up fuel based on their speed while travelling.
| 0
|-
| '''damageMax'''
| Maximum amount of damage this craft can take. If this amount is exceeded, the craft is destroyed.
| 0
|-
| '''speedMax'''
| Maximum speed in nautical miles. Crafts travel at max speed when flying and half speed when patrolling.
| 0
|-
| '''accel'''
| Aceeleration value shown in the UFOpaedia.
| 0
|-
| '''weapons'''
| Amount of craft weapons this craft can equip. The UI can only display a max of 2 weapons.
| 0
|-
| '''soldiers'''
| Amount of soldiers this craft can carry.
| 0
|-
| '''maxItems'''
| Amount of items this craft can carry.
| 80
|-
| '''vehicles'''
| Amount of vehicles this craft can carry.
| 0
|-
| '''costBuy'''
| Amount of money spent for purchasing this craft. If set to 0, the craft will not be available in the Purchase/Recruit screen.
| 0
|-
| '''costRent'''
| Amount of money spent monthly for renting this craft. If set to 0, the craft is not on rental and won't count towards base maintenance.
| 0
|-
| '''costSell'''
| Amount of money gained for selling this craft.
| 0
|-
| '''refuelItem'''
| Item required for refuelling this craft. If no item is specified, the craft uses human fuel.
| 0
|-
| '''repairRate'''
| Amount of damage restored every hour while [[Repairs|Repairing]] in base.
| 1
|-
| '''refuelRate'''
| Amount of fuel restored every 30 mins while [[Refueling]] in base. If specified, a '''refuelItem''' is spent each time.
| 1
|-
| '''radarRange'''
| Detection range of the craft's radar in nautical miles. Every craft radar has a 100% detection chance.
| 600
|-
| '''transferTime'''
| Number of hours it takes to purchase/transfer this craft to a base.
| 0
|-
| '''score'''
| [[Score]] lost when this craft is destroyed.
| 0
|-
| '''spacecraft'''
| Can this craft go to [[Cydonia]]?
| false
|-
| '''battlescapeTerrainData'''
| [[#Terrains|Terrain]] associated to this craft in Battlescape missions.
| -
|}

=== Craft Weapons ===

Defines one of the [[Craft Armaments|weapons]] equipped by X-COM craft for shooting down UFOs, listed in ''"craftWeapons:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the weapon name.
| ''required''
|-
| '''sprite'''
| Sprite ID from [[BASEBITS.PCK]] used to draw the weapon in the Basescape and from [[INTICON.PCK]] used to draw the weapon in dogfights.
modders: the corresponding extrasprites file id for INTICON.PCK is sprite+5 and sprite+48 for BASEBITS.PCK
| -1
|-
| '''sound'''
| Sound ID from [[#Extra_Sounds|GEO.CAT]] played when this weapon fires.
| -1
|-
| '''damage'''
| Amount of damage this weapon does to enemy UFOs.
| 0
|-
| '''range'''
| Maximum range of this weapon in dogfights (in meters).
| 0
|-
| '''accuracy'''
| Chance (0-100%) of each shot hitting the enemy UFO.
| 0
|-
| '''reloadCautious'''
| Time this weapon takes to fire between each shot in ''Cautious Mode''.
| 0
|-
| '''reloadStandard'''
| Time this weapon takes to fire between each shot in ''Standard Mode''.
| 0
|-
| '''reloadAggressive'''
| Time this weapon takes to fire between each shot in ''Aggressive Mode''.
| 0
|-
| '''ammoMax'''
| Maximum amount of ammo this weapon can carry.
| 0
|-
| '''rearmRate'''
| Amount of ammo restored every 30 mins while the craft is [[Rearming]] in base. If specified, '''clip'''s are spent depending on their '''clipSize'''. If the '''clipSize''' of the specified ammo is 0, no '''clip'''s are spent.
| 1
|-
| '''projectileType'''
| Type of the weapon projectile, used for the projectile sprite in dogfights:
* 0 - [[Stingray]]
* 1 - [[Avalanche]]
* 2 - [[Cannon]]
* 3 - [[Fusion Ball]]
* 4 - [[Laser Cannon]]
* 5 - [[Plasma Beam]]
| 2
|-
| '''projectileSpeed'''
| Speed of the weapon projectile in dogfights.
| 0
|-
| '''launcher'''
| String ID of the [[#Items|item]] required to equip this weapon.
| -
|-
| '''clip'''
| String ID of the [[#Items|item]] required to rearm this weapon.
| -
|}

=== Items ===

Defines the Geoscape and Battlescape properties of an [[Equipment (EU)|item]] that can be stored in X-COM bases, listed in ''"items:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the internal item name.
| ''required''
|-
| '''name'''
| String ID of the displayed item name, for cases where it's different from the internal name. If omitted, '''type''' is used.
| -
|-
| '''requires'''
| List of [[#Research|topics]] (string IDs) that must be researched to unlock this item. If none are specified, this item is unlocked from the start. Soldiers can only use unlocked items in the Battlescape.
| -
|-
| '''size'''
| Space occupied by this item in [[Base Stores]]. Can be a decimal value.
| 0.0
|-
| '''costBuy'''
| Amount of money spent for purchasing this item. If set to 0, this item will not be available in the Purchase/Recruit screen.
| 0
|-
| '''costSell'''
| Amount of money gained for selling this item.
| 0
|-
| '''transferTime'''
| Number of hours it takes to purchase/transfer this item to a base.
| 24
|-
| '''weight'''
| [[Item_Weight|Weight]] occupied by this item in a soldier's inventory.
| 999
|-
| '''bigSprite'''
| Sprite ID from [[BIGOBS.PCK]] used to draw this item in a soldier's inventory and UFOpaedia.
| -1
|-
| '''floorSprite'''
| Sprite ID from [[FLOOROB.PCK]] used to draw this item on the floor of a Battlescape tile.
| -1
|-
| '''handSprite'''
| Sprite ID from [[HANDOB.PCK]] used to draw this item on a soldier's hand in the Battlescape.
modders: each handobject needs 8 images (8 directions) define the extrasprites accordingly
| 120
|-
| '''bulletSprite'''
| Sprite ID from ''BulletSprites.png'' used to draw this weapon's projectile on the Battlescape:
* 0 - [[Rocket Launcher]]
* 1 - [[Pistol]]
* 2 - [[Rifle]]
* 3 - [[Auto Cannon]]
* 4 - [[Heavy Cannon]]
* 5 - [[Laser Pistol]]
* 6 - [[Laser Rifle]]
* 7 - [[Heavy Laser]]
* 8 - [[Plasma Rifle|Plasma]]
* 9 - [[Small Launcher]]
* 10 - [[Blaster Launcher]]
for modders: the bulletsprite needs to be put into the extraSprites type "Projectiles" the bulletsprite can contain up to 35 3x3 images. The corresponding file id is 35*[bulletSprite]
| -1
|-
| '''fireSound'''
| Sound ID from [[#Extra_Sounds|BATTLE.CAT]] played when this weapon fires.
| -1
|-
| '''hitSound'''
| Sound ID from [[#Extra_Sounds|BATTLE.CAT]] played when this weapon hits a target.
| -1
|-
| '''hitAnimation'''
| Sprite ID from [[SMOKE.PCK]] used to draw the weapon's "hit explosion".
'''NOTE''': Do not define this value for melee/psi weapons, they use [[HIT.PCK]] and therefore meleeAnimation instead.
| 0
|-
| '''power'''
| Average damage of the weapon, in most cases it will be +-50% this value.
| 0
|-
| '''strengthApplied'''
| Add the attacking unit's strength to this weapon's damage.
| false
|-
| '''compatibleAmmo'''
| List of string IDs of the ammo items that can be loaded on this weapon. If none are specified, the weapon doesn't need ammo.
| -
|-
| '''damageType'''
| What type of [[damage]] does this weapon do:
* 0 - None
* 1 - Armor Piercing
* 2 - Incendiary
* 3 - High Explosive
* 4 - Laser
* 5 - Plasma
* 6 - Stun
* 7 - Melee
* 8 - Acid
* 9 - Smoke
'''NOTE:''' A damage type other than 0-9 will do nothing.
| 0
|-
| '''tuAuto'''
'''accuracyAuto'''
| The percentage (0-100%) of [[Time Units]] (from the soldier's total) required to fire an Auto Shot. If 0, the weapon does not have an Auto Shot.
The base accuracy (0-100%) applied to a soldier's [[Firing Accuracy]] when firing an Auto Shot.
| 0
0
|-
| '''tuSnap'''
'''accuracySnap'''
| The percentage (0-100%) of [[Time Units]] (from the soldier's total) required to fire a Snap Shot. If 0, the weapon does not have a Snap Shot.
The base accuracy (0-100%) applied to a soldier's [[Firing Accuracy]] when firing a Snap Shot.
| 0
0
|-
| '''tuAimed'''
'''accuracyAimed'''
| The percentage (0-100%) of [[Time Units]] (from the soldier's total) required to fire an Aimed Shot. If 0, the weapon does not have an Aimed Shot.
The base accuracy (0-100%) applied to a soldier's [[Firing Accuracy]] when firing an Aimed Shot.
| 0
0
|-
|-
| '''tuMelee'''
'''accuracyMelee'''
| The percentage (0-100%) of [[Time Units]] (from the soldier's total) required to do a melee attack (Hit). If 0, the weapon does not have a melee attack.
The base accuracy (0-100%) applied to a soldier's [[Melee Accuracy]] when doing a melee attack.
| 0
0
|-
| '''clipSize'''
| The amount of ammo stored in each weapon clip. If -1 is specified, this weapon has infinite ammo.
| 0
|-
| '''battleType'''
| Defines the weapon's behavior in the Battlescape:
* 0 - None (Geoscape-only item)
* 1 - [[Weapons|Firearm]]
* 2 - Ammo
* 3 - Melee
* 4 - [[Grenade]]
* 5 - [[Proximity Grenade]]
* 6 - [[Medi-Kit (EU)|Medi-Kit]]
* 7 - [[Motion Scanner]]
* 8 - [[Mind Probe]]
* 9 - [[Psi-Amp]]
* 10 - [[Electro-flare]]
* 11 - Corpse
| 0
|-
| '''twoHanded'''
| Is this weapon two-handed? (incurs an accuracy penalty if used with both hands occupied)
| false
|-
| '''waypoint'''
| Does this weapon use waypoints? (eg. [[Blaster Launcher]]). Can also be used to make ammo items use the waypoint system.
| false
|-
| '''fixedWeapon'''
| Is this weapon fixed? (it's part of a unit, eg. tanks and terrorist units)
| false
|-
| '''invWidth'''
| Item width in a soldier's inventory (in grid units).
| 1
|-
| '''invHeight'''
| Item height in a soldier's inventory (in grid units).
| 1
|-
| '''painKiller'''
| Amount of painkillers contained in a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''heal'''
| Amount of heal's contained in a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''stimulant'''
| Amount of stimulants contained in a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''woundRecovery'''
| Amount of [[Fatal Wounds]] treated by each heal of a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''healthRecovery'''
| Amount of [[Health]] recovered by each heal of a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''stunRecovery'''
| Amount of [[Stun]] removed by each stimulant of a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''energyRecovery'''
| Amount of [[Energy]] recovered by each stimulant of a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''tuUse'''
| Amount of [[Time Units]] required to use this item (for non-offensive items). It's a flat rate if '''flatRate''' is true, otherwise it's a percentage (0-100%).
| 0
|-
| '''recoveryPoints'''
| [[Score]] gained for recovering this alien artifact.
| 0
|-
| '''armor'''
| How much damage is needed to destroy this item on the ground.
| 20
|-
| '''recover'''
| Is this item recoverable? (gets transported to the X-COM base on mission success)
| true
|-
| '''turretType'''
| Sprite ID from [[TANKS.PCK]] of the turret to assign to this tank:
* 0 - [[Tank/Cannon]]
* 1 - [[Tank/Rocket Launcher]]
* 2 - [[Tank/Laser Cannon]]
* 3 - [[Hovertank/Plasma]]
* 4 - [[Hovertank/Launcher]]
| -1
|-
| '''liveAlien'''
| Does this item represent a live alien? (counts towards [[Alien Containment]])
| false
|-
| '''blastRadius'''
| Size of the projectile explosions. 0 for no explosion. -1 to automatically calculate based on weapon power and damage type (actual '''blastRadius''' currently is capped due [[Explosions#Playing_With_Fire|Explosion calculations]]).
| -1
|-
| '''flatRate'''
| If true, then TU costs for this weapon are a flat rate (instead of a percentage of unit TUs).
| false
|-
| '''arcingShot'''
| Does this weapon fire in an arc?
| false
|-
| '''attraction'''
| Represents how likely an alien is to pick up this item. Values below 5 will be ignored (by design).
| 0
|-
| '''maxRange'''
| Maximum range at which this weapon can operate.
| 200
|-
| '''aimRange'''
| Maximum effective range with this weapon before which range-based dropoff occurs.
| 200
|-
| '''snapRange'''
| Maximum effective range with snap shot before which range-based dropoff occurs. (ufoextender accuracy only)
| 15
|-
| '''autoRange'''
| Maximum effective range with auto shot before which range-based dropoff occurs. (ufoextender accuracy only)
| 7
|-
| '''minRange'''
| Range-based dropoff will work in reverse for ranges below this.
| 0
|-
| '''dropoff'''
| The value by which the accuracy lowers for each tile after (or before) the thresholds above.
| 2
|-
| '''bulletSpeed'''
| How much faster (or slower, if you use a negative number) is a projectile fired from this weapon compared to the average.
| 0
|-
| '''autoShots'''
| How many auto shots does this weapon fire.
| 3
|-
| '''shotgunPellets'''
| Number of projectiles fired per unit of ammunition. (note: due to engine limitations it is currently impossible to draw multiple projectiles in flight.)
| 0
|-
| '''zombieUnit'''
| String ID of the unit used for zombification (eg. [[Chrysallid]]s turn units into [[Zombie]]s).
| none
|-
| '''meleeSound'''
| Sound ID from [[#Extra_Sounds|BATTLE.CAT]] played when this weapon attacks a target with melee.
| 39
|-
| '''meleeHitSound'''
| Sound ID from [[#Extra_Sounds|BATTLE.CAT]] played when this weapon HITS a target with melee.
| -1
|-
| '''meleeAnimation'''
| Sprite ID from HIT.PCK played when this weapon attacks a target with melee.
| 0
|-
| '''meleePower'''
| Damage this weapon will do when using melee. This only applies to Firearms, and is only available as stun damage. For normal melee weapons, use regular power and damage types.
| 0
|-
| '''LOSRequired'''
| Does this item require line of sight? (only applies to mind probes and psi-amps)
| false
|-
| '''skillApplied'''
| Is melee skill applied to the accuracy of an attack made with this object?
| true
|-
|}

=== UFOs ===

Defines one of the [[UFOs]] that invade Earth, listed in ''"ufos:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the UFO name.
| ''required''
|-
| '''size'''
| String ID of the UFO size.
| STR_VERY_SMALL
|-
| '''sprite'''
| Sprite ID from [[INTERWIN.DAT]] used to draw this UFO in the dogfight view and UFOpaedia.
don't try to add more images if you don't want to punch yourself in the face - use modsprite
| -1
|-
| '''modSprite'''
| Filename used to draw this UFO in the dogfight view and UFOpaedia.
| -
|-
| '''damageMax'''
| Maximum amount of damage this UFO can take. If the UFO takes 50% damage, it crash lands. If it takes 100% damage, it is destroyed.
| 0
|-
| '''speedMax'''
| Maximum speed in nautical miles.
| 0
|-
| '''accel'''
| Aceeleration value shown in the UFOpaedia.
| 0
|-
| '''power'''
| Damage power of this UFO's weapon in dogfights.
| 0
|-
| '''range'''
| Maximum range of this UFO's weapon in dogfights (in meters).
| 0
|-
| '''score'''
| [[Score]] gained when this UFO is destroyed, or half this score if it crash lands.
| 0
|-
| '''reload'''
| Time the UFO's weapon takes to fire between each shot.
| 0
|-
| '''breakOffTime'''
| Minimum amount of time for the UFO to be able to break off of a dogfight.
| 0
|-
| '''battlescapeTerrainData'''
| [[#Terrains|Terrain]] associated to this UFO in Battlescape missions.
| ''required''
|-
|}

=== Inventory Sections ===

Defines one of the sections of the [[Inventory TU Table|Battlescape inventory]] (eg. Backpack), listed in ''"invs:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the inventory name.
| ''required''
|-
| '''x'''
'''y'''
| Pixel coordinates of this section on the inventory screen.
| 0
0
|-
| '''type'''
| Type of this section:
* 0 = Slot section, can contain as many items as will fit on the slots.
* 1 = Hand section, can only contain one item regardless of size.
* 2 = Ground section, can contain infinite items.
| 0
|-
| '''slots'''
| List of the grid slots (''[x, y]'') that this section is composed of. For example, to make a 2x2 section, you would have ''[0, 0] [0, 1] [1, 0] [1, 1]''.
| -
|-
| '''costs'''
| List of [[Time Units]] costs to move an item from this section to another one (eg. ''STR_BACKPACK: 16'' means it will cost 16 TUs to move an item from this section to the Backpack).
| -
|-
|}

=== Terrains ===

Defines one of the [[TERRAIN|terrains]] used to generate a Battlescape map, listed in "terrains:".

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''name'''
| String ID of the terrain name.
| ''required''
|-
| '''largeBlockLimit'''
| Maximum amount of large blocks that can be used on map generation.
| 0
|-
| '''textures'''
| List of [[TEXTURE.DAT|Geoscape textures]] that correspond to this terrain.
| -
|-
| '''hemisphere'''
| Geoscape hemisphere associated with this terrain:
* -1 - Northern hemisphere.
* 0 - Both hemispheres.
* 1 - Southern hemisphere.
| 0
|-
| '''mapDataSets'''
| List of filenames (each with matching [[MCD]]/[[Image Formats#PCK|PCK/TAB]] files) that contain the tiles of this terrain.
| -
|-
| '''mapBlocks'''
| List of map blocks (see below) that are used for generating a map.
| -
|-
| '''roadTypeOdds'''
| Odds as a % of generating each type of road (E-W Road, N-S Road, Crossing) odds for crossing are: 100 - EW - NS.
| [0 0]
|-|-
| '''civilianTypes'''
| List of units to use as civilians for this mission.
| [MALE_CIVILIAN, FEMALE_CIVILIAN]
|-
|}

==== Map Blocks ====

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''name'''
| Filename of the [[MAPS|map]].
| ''required''
|-
| '''width'''
| Width of this map block in Battlescape grid units.
| 0
|-
| '''length'''
| Length of this map block in Battlescape grid units.
| 0
|-
| '''height'''
| Height of this map block in Battlescape grid units.
| 1
|-
| '''type'''
| Type of this map block:
* -1 - Undefined
* 0 - Default
* 1 - Landing Zone (for placing X-COM / alien craft)
* 2 - E-W Road (for city maps)
* 3 - N-S Road (for city maps)
* 4 - Road Crossing (for city maps)
* 5 - Dirt (for filling empty base blocks)
* 6 - X-COM spawn point (for [[Alien Base]] / [[Cydonia]] missions)
* 7 - [[Alien Base]] Target
* 8 - [[Cydonia]] Target
| -1
|-
| '''subType'''
| Sub-type of this map block (see '''type''').
| -1
|-
| '''frequency'''
| Frequency of this block in a map.
| 1
|-
| '''maxCount'''
| Maximum amount of times this block can be used in a map. If -1 there is no limit.
| -1
|-
| '''items'''
| An array of items to add to this mapblock, an the positions to place them at.
| -1
|}

*'''frequency''' defines the odds of the map appearing on the map
** The value assigned (default: 1) is used in ''x/n'', which defines the probability of being chosen.
** ''x'' is the integer defined for the map block's frequency and ''n'' is the combined total of probabilities for all the map types combined.
** This property can only be used in type 0 map blocks.
*'''maxCount''' is the maximum number of times it can be used.
** The value assigned is also used in ''x/n'' to determine the probability of being chosen.
** Each use reduces ''x'' by -1, with the caveat that being used as a Landing Zone type will not reduce the x value since it could result in no available Landing Zones.
** This property can only be used in type 0 map blocks.
* '''hemisphere''' only applies to UFO missions, not Terror ones.
*'''width/length''' defines the size of the map
** be aware that the mapview "width"-label is the openxcom ruleset length parameter
** be aware that the mapview "length"-label is the openxcom ruleset width parameter

==== Guidelines/Tips ====
* All maps with an XCOM/Alien craft require at least one type 1 map block. This map block can only contain ground tiles (no walls or objects), otherwise the game will crash or the walls/objects will be removed.
* All Terror terrains (listed under STR_TERROR_MISSION) require at least 1 map block of '''Types''' 2, 3 and 4 (for a total of 3 maps, which are required to place roads) and the corresponding '''roadTypeOdds''' added to the ruleset.
* If there isn't any map blocks designed as roads since you want to keep your terrain 'random', this can be circumvented by designating all 10x10 map blocks, excluding the one(s) used for the XCOM craft, as either '''Type''' 2, 3 and 4 and by defining their '''subType''' to 0. The game will then randomly choose between the map blocks for each type used in the roads, making them map more random.

=== Armor ===

Defines a Battlescape unit's [[armor]] as well as visual representation (so every unit has an armor), listed in ''"armors:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the armor name.
| ''required''
|-
| '''spriteSheet'''
| Sprite sheet from [[UNITS]] used to draw a unit wearing this armor.
| -
|-
| '''spriteInv'''
| Sprite used for the [[Inventory Backgrounds]] of a unit wearing this armor.
| -
|-
| '''corpseBattle'''
| List of string IDs of the corpse [[#Items|items]] generated when a unit wearing this armor is killed (one per unit tile) on the Battlescape.
| -
|-
| '''corpseGeo'''
| String ID of the corpse [[#Items|item]] associated with this unit on the Geoscape.
| -
|-
| '''storeItem'''
| String ID of the [[#Items|item]] that represents this armor in [[Base Stores]] for equipping.
| -
|-
| '''weight'''
| Physical weight of the armor when worn
| 6
|-
| '''stats'''
| like soldier stats (see below) but these are treated as stat bonuses for wearing the specific armor.
| -
|-
| '''frontArmor'''
| Protection provided on the front of the unit.
| 0
|-
| '''sideArmor'''
| Protection provided on the sides of the unit.
| 0
|-
| '''rearArmor'''
| Protection provided on the rear of the unit.
| 0
|-
| '''underArmor'''
| Protection provided under the unit (eg. from explosions).
| 0
|-
| '''drawingRoutine'''
| Drawing routine used to put together the body parts in the unit's '''spriteSheet''':
* 0 = [[Soldier]], [[Sectoid]]
* 1 = [[Floater]]
* 2 = [[HWP]]
* 3 = [[Cyberdisk]]
* 4 = [[Civilian]], [[Ethereal]]
* 5 = [[Sectopod]], [[Reaper]]
* 6 = [[Snakeman]]
* 7 = [[Chryssalid]]
* 8 = [[Silacoid]]
* 9 = [[Celatid]]
* 10 = [[Muton]]
| 0
|-
| '''movementType'''
| Type of movement provided by this armor:
* 0 = Walking
* 1 = Flying
* 2 = Sliding (no walking animation)
it also defines the body of an tank (32-images) in your spriteSheet or the change in sprites while flying using a flying armour see: [[TANKS.PCK]], [[XCOM_2.PCK]]
| 0
|-
| '''damageModifier'''
| List of decimal damage modifiers (1.0 = 100%) this armor applies to each damage type (see [[#Items|Items section]]) received. Modifiers must be specified for all damage types, in this order:
* None
* Armor Piercing
* Incendiary
* High Explosive
* Laser
* Plasma
* Stun
* Melee
* Acid
* Smoke
|
- 1.0 
- 1.0 
- 1.0 
- 1.0 
- 1.0 
- 1.0 
- 1.0 
- 1.0 
- 1.0 
- 1.0
|-
| '''size'''
| Size of the unit wearing this armor, in Battlescape grid units. Every unit is square, so a size of 2 means 2x2.
| 1
|-
| '''loftempsSet'''
| List of [[LOFTEMPS]] IDs (one per unit tile, so a 1x1 unit has 1, a 2x2 unit has 4, etc.) used to represent a unit wearing this armor in 3D space.
| -
|-
| '''loftemps'''
| loftemps is a deprecated option that only works for 1x1 sized units.
| -
|}

=== Player Units (Soldiers) ===

Defines a [[soldier]] recruited by X-COM, listed in ''"soldiers:"''. Currently only one soldier unit type (''XCOM'') is supported.

Unit stats are represented as follows:
* [[Time Units|tu]]
* [[Energy|stamina]]
* [[Health|health]]
* [[Bravery|bravery]] (always a multiple of 10)
* [[Reactions|reactions]]
* [[Firing Accuracy|firing]]
* [[Throwing Accuracy|throwing]]
* [[Strength|strength]]
* [[Psi Strength|psiStrength]]
* [[Psi Skill|psiSkill]]
* [[Melee Accuracy|melee]] (not visible)

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the soldier name.
| ''required''
|-
| '''minStats'''
| Minimum values used to generate the soldier's [[Starting Stats]]. In this case, ''psiSkill'' is treated as the initial stat (not generated).
| -
|-
| '''maxStats'''
| Maximum values used to generate the soldier's [[Starting Stats]]. In this case, ''psiSkill'' is treated as the minimum value for the first month of psi training (actual value is 100%-150%).
| -
|-
| '''statCaps'''
| Maximum stats this soldier can gain through [[Experience]]. '''NOTE:''' A stat will still go over the limit once, and then will no longer increase (see [[Experience#Regarding Caps|Regarding Caps]]).
| -
|-
| '''armor'''
| String ID of the [[#Armor|armor]] this soldier uses by default.
| -
|-
| '''standHeight'''
| Height of this soldier when standing.
| 0
|-
| '''kneelHeight'''
| Height of this soldier when kneeling.
| 0
|-
| '''floatHeight'''
| Distance between the bottom of this unit and the ground.
| 0
|}

=== AI Units (Aliens/Civilians) ===

Defines an [[Alien Life Forms|alien]] (enemy) or [[civilian]] (neutral) unit, listed in ''"units:"''. Every different alien rank is a different unit, since they have completely different stats. Unit stats are represented as follows:
* [[Time Units|tu]]
* [[Energy|stamina]]
* [[Health|health]]
* [[Bravery|bravery]] (always a multiple of 10)
* [[Reactions|reactions]]
* [[Firing Accuracy|firing]]
* [[Throwing Accuracy|throwing]]
* [[Strength|strength]]
* [[Psi Strength|psiStrength]]
* [[Psi Skill|psiSkill]]
* [[Melee Accuracy|melee]] (not visible)

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the unit name.
| ''required''
|-
| '''race'''
| String ID of the unit race (for alien units).
| -
|-
| '''rank'''
| String ID of the unit rank (for alien units).
| -
|-
| '''stats'''
| Battlescape stats of this unit.
| -
|-
| '''armor'''
| String ID of the [[#Armor|armor]] this unit uses by default.
| -
|-
| '''standHeight'''
| Height of this unit when standing.
| 0
|-
| '''floatHeight'''
| Distance between the bottom of this unit and the ground.
| 0
|-
| '''value'''
| [[Score]] this unit is worth.
| 0
|-
| '''deathSound'''
| Sound ID from [[#Extra_Sounds|BATTLE.CAT]] played when this unit dies.
| -1
|-
| '''aggroSound'''
| Sound ID from [[#Extra_Sounds|BATTLE.CAT]] played when this unit aggros.
| -1
|-
| '''moveSound'''
| Sound ID from [[#Extra_Sounds|BATTLE.CAT]] played when this unit moves.
| -1
|-
| '''intelligence'''
| Intelligence of this unit's AI. The higher the value, the longer this unit remembers player troops between turns.
| 0
|-
| '''aggression'''
| Aggression of this unit's AI. The higher the value, the more ruthless the unit, the more likely to make a frontal assault. Less aggressive units tend to set up ambushes.
Vanilla values are:
* 0 = mostly passive
* 1 = balanced
* 2 = mostly aggresive
| 0
|-
| '''energyRecovery'''
| Energy recovered by the unit each turn (needs verification)
| 40 (?)
|-
| '''specab'''
| Special ability of this unit:
* 0 = None
* 1 = [[Cyberdisc|Explodes on Death]]
* 2 = [[Bio-Drone|Burns Floor]]
* 3 = [[Zombie|Respawns on Death]]
| 0
|-
| '''spawnUnit'''
| String ID of the unit used to respawn on death (eg. [[Zombie]]s respawn as [[Chrysallid]]s).
| -
|-
| '''livingWeapon'''
| Is this unit a living weapon? (only attacks with a '''fixedWeapon''')
| false
|-
|}

=== Alien Races ===

Defines a [[Alien Life Forms|race]] used in [[Alien Missions]], listed in ''"alienRaces:"''. Heavily tied with deployment data.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''id'''
| String ID of the alien race name.
| ''required''
|-
| '''members'''
| Alien crew associated with this alien race (eg. race units + terrorist units), defined by a list of unit string IDs. Order here will define rank in terms of deployment. generally speaking the order is:
* 0 - Commander
* 1 - Leader
* 2 - Engineer
* 3 - Medic
* 4 - Navigator
* 5 - Soldier
* 6 - Terrorist 1
* 7 - Terrorist 2
but of course, not all races have all ranks, so the "fill in" rank would be listed multiple times (see ethereals).
|-
| '''retaliation'''
| retaliation enables/disables the race for retaliation missions.
| ''True''
| -
|}

=== Alien Deployments ===

Defines a Battlescape deployment data used in [[Alien Missions]] (such as alien and map configurations), listed in ''"alienDeployments:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the deployment name.
| ''required''
|-
| '''width'''
| Width of the Battlescape map in grid units.
| 0
|-
| '''length'''
| Length of the Battlescape map in grid units.
| 0
|-
| '''height'''
| Vertical height of the Battlescape map in grid units.
| 0
|-
| '''terrains'''
| list of string IDs of the [[#Terrains|terrain]] to choose from to generate this map. This is not used for UFO sites where the terrain comes from the Geoscape.
| -
|-
| '''shade'''
| Shade of the map (0-15, where 0 is full daytime and 15 is full nighttime). This is not used for UFO sites where the shade comes from the Geoscape.
| 0
|-
| '''nextStage'''
| String ID of the next deployment stage to use after this one, for multi-stage missions.
| -
|-
| '''data'''
| List of deployment data for each alien rank on this mission (see below).
| -
|}

Notes:
* '''terrains''' can also be used with UFOs, with the game using instead the listed terrain rather than the location of the UFO on Geoscape.
==== Deployment Data ====

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''alienRank'''
| [[Alien Rank|Rank]] associated with this deployment data, as defined by the order of the race in question (see above)
| ''required''
|-
| '''lowQty'''
| Maximum quantity of aliens to spawn (beginner).
| 0
|-
| '''highQty'''
| Maximum quantity of aliens to spawn (superhuman).
| 0
|-
| '''dQty'''
| Minimum Desired Quantity of aliens to spawn.
| 0
|-
| '''percentageOutsideUfo'''
| Percentage (0-100%) of aliens to spawn outside in UFO sites.
| 0
|-
| '''itemSets'''
| Three lists (one for each alien technology level) of [[#Items|items]] (string IDs) for the aliens to equip.
| ''required''
|-
|}

=== Research ===

Defines a [[Research|research topic]] that X-COM scientists can investigate, listed in ''"research:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''name'''
| String ID of the research project's name (or item, if a '''lookup''' is defined).
| ''required''
|-
| '''lookup'''
| String ID of the research project's display name and UFOPaedia article reference.
| -
|-
| '''cost'''
| Number of man hours (on average) required to complete this project.
| 0
|-
| '''points'''
| [[Score]] earned for completing this project.
| 0
|-
| '''needItem'''
| Does this project require an [[#Items|item]] of the same name?
| false
|-
| '''dependencies'''
| List of research projects that can unlock access to this one. If the full list is researched, or if one of the projects on the list "unlocks" this one, it becomes available.
| -
|-
| '''unlocks'''
| List of research projects unlocked, regardless of other dependencies, but not requirements, by completing this project (for example, any live alien unlocks "alien origins").
| -
|-
| '''requires'''
| List of research projects unilaterally required before this project can be unlocked (for example, "the martian solution" will not even be considered for unlocking until AFTER "alien origins" is completed).
| -
|-
| '''getOneFree'''
| List of "bonus" research projects that may be granted when completing this project (for example, alien medics will give you information on other alien races). Only applies to living aliens.
| -
|-
|}

=== Manufacture ===

Defines a [[Manufacture|manufacture project]] that X-COM engineers can produce, listed in ''"manufacture:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''name'''
| String ID of the manufacturing project's name (and the item it produces).
| ''required''
|-
| '''category'''
| String ID of the manufacturing project's category.
| -
|-
| '''requires'''
| List of [[#Research|topics]] (string IDs) that must be researched to unlock this project. If none are specified, this project is unlocked from the start.
| -
|-
| '''space'''
| Amount of [[Workshop]] space required to begin this project.
| 0
|-
| '''time'''
| Number of man hours (on average) required per item.
| 0
|-
| '''cost'''
| Monetary deduction per item manufactured.
| 0
|-
| '''requiredItems'''
| List of [[#Items|items]] required and consumed per item manufactured.
| -
|-
| '''producedItems'''
| List of [[#Items|items]] produced per each item consumed. If not specified, defaults to 1 item with the same string ID as the manufacture.
| 1
|-
|}

=== UFOpaedia Article ===

Defines an article in the in-game [[UFOpaedia]], listed in ''"ufopaedia:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''id'''
| String ID of the article name. This must match the ID of the object associated with this article, if applicable.
| ''required''
|-
| '''title'''
| String ID of the article title. If omitted, the '''id''' is used.
| -
|-
| '''type_id'''
| Type of this article:
* 0 = Unknown
* 1 = [[Craft]]
* 2 = [[Craft Armaments]]
* 3 = [[HWP]]
* 4 = [[Equipment (EU)|Equipment]]
* 5 = [[Armour]]
* 6 = [[Base Facilities]]
* 7 = Text & Image (eg. [[Alien Life Forms]], [[UFO Components]])
* 8 = Text (eg. [[Alien Research]])
* 9 = [[UFO]]
| 0
|-
| '''section'''
| String ID of the UFOpaedia section this article belongs in.
| -
|-
| '''requires'''
| List of [[#Research|topics]] (string IDs) that must be researched to unlock this article. If none are specified, this article is unlocked from the start.
| -
|-
| '''image_id'''
| Filename of the [[UP001.SPK-UP042.SPK|background image]] displayed on this article, if applicable.
| -
|-
| '''text'''
| String ID of the description displayed on this article.
| -
|-
| '''text_width'''
| Maximum width of the text displayed, only applicable to ''Text & Image'' articles.
| 0
|-
| '''rect_stats'''
| Rectangle ('''x''', '''y''', '''width''', '''height''') of the stats text on the screen, only applicable to ''Craft'' articles.
| 0
|-
| '''rect_text'''
| Rectangle ('''x''', '''y''', '''width''', '''height''') of the description text on the screen, only applicable to ''Craft'' articles.
| 0
|-
| '''weapon'''
| String ID of the weapon, only applicable to ''HWP'' articles.
| -
|}

=== UFO Trajectories ===

Defines a trajectory carried out by an UFO during an [[#Alien Missions|alien mission]], listed in ''"ufoTrajectories:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''id'''
| String ID of the trajectory name.
| ''required''
|-
| '''groundTimer'''
| Amount of seconds for the UFO to spend on Ground waypoints.
| 0
|-
| '''waypoints'''
| List of waypoints for the UFO to traverse, defined as ''[zone, altitude, speed]''. 
'''zone''': Globe zone where the waypoint is located. 
'''altitude''': UFO altitude after reaching this waypoint:
* 0 - Ground
* 1 - Very Low
* 2 - Low
* 3 - High
* 4 - Very High
'''speed''': UFO speed after reaching this waypoint, as a percentage (0-100%) of its maximum speed.
| -
|}

=== Alien Missions ===

Defines an [[Alien Missions|alien mission]] carried out by UFOs on the Geoscape, listed in ''"alienMissions:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the mission type.
| ''required''
|-
| '''points'''
| [[Score]] allocated to aliens for successfully completing this mission.
| 0
|-
| '''raceWeights'''
| List of alien races likely to carry out this mission, and the % chance of them being allocated to this mission, listed by "number of months after game beginning".
| ''required''
|-
| '''waves'''
| List of UFO waves to spawn as this mission progresses, as described below.
| ''required''
|}

==== Waves ====

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''ufo'''
| String ID of the [[#UFOs|UFO]] to spawn.
| ''required''
|-
| '''count'''
| Number of UFOs to spawn.
| 0
|-
| '''trajectory'''
| String ID of the [[#UFO Trajectories|trajectory]] for this UFO to use when entering Earth's atmosphere.
| ''required''
|-
| '''timer'''
| How long after the previous wave should this wave arrive? (in seconds)
| 0
|-
|}

=== Alien Item Levels ===

This is a list of item level probabilities, with a number between 0 and 2 representing an item level from plasma pistols to heavy plasmas, as defined in the deployments, expressing a 10% probability for that item level being used.

0 = first set (plasma pistol/clip)
1 = second set (plasma rifle/clip)
2 = third set (heavy plasma/clip)

For example:
[ 2, 0, 0, 0, 0, 0, 0, 1, 1, 1 ]
would represent a 60% chance for pistols, 30% rifles, and 10% heavy weapons. 
Note that the order does not matter, but the length DOES. each line MUST have 10 digits.

The above can be confusing. There are 10 fields; each number represents 10%. 
There is only one instance of '2'. 1x10% = 10% chance of plasma pistol 
There are three instances of '1'. 3x10% = 30% chance of plasma rifle 
There are six instances of '0'. 6x10% = 60% chance of heavy plasma 

Each line represents a month after the beginning of the game, and there is no limit to the number defined. 
OpenXCom will use the most recently available item level in the event the game goes on forever.

=== Extra Sprites ===

Adds or replaces sprites in an existing [[Image Formats|X-COM image file]], listed in ''"extraSprites:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| Filename of the original/new image to modify.
| ''required''
|-
| '''width'''
'''height'''
| Size of the sprite(s) in pixels.
| 0
0
|-
| '''singleImage'''
| Is the image file just a single sprite (true) or a spritesheet (false)?
| false
|-
| '''subX'''
'''subY'''
| Size of the subdivision in pixels. If a subdivision is specified, then the image file is divided into chunks to form the sprites (eg. spritesheets).
| 0
0
|-
| '''files'''
| List of the new sprites to add/replace, listed as ''spriteID: filename''.
| -
|}

Example:
- type: GIANTBUNNY.PCK
width: 32
height: 40
files:
0: Resources/Bunny/Bunny00.png
1: Resources/Bunny/Bunny01.bmp
2: Resources/Bunny/Bunny02.gif

=== Extra Sounds ===

Adds or replaces sounds in an existing [[SOUND|X-COM sound file]], listed in ''"extraSounds:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| ID of the original sound file to modify:
* BATTLE.CAT - Battlescape sounds, corresponds to ''SOUND1.CAT'' or ''SAMPLE2.CAT'' (55 sounds).
* INTRO.CAT - Intro sounds, corresponds to ''INTRO.CAT'' or ''SAMPLE3.CAT'', probably best not to mess with these.
* GEO.CAT - Geoscape sounds, corresponds to ''SOUND2.CAT'' or ''SAMPLE.CAT'' (14 sounds).
| ''required''
|-
| '''files'''
| List of the new sounds to add/replace, listed as ''soundID: filename''.
| -
|}

Example:
- type: BATTLE.CAT
files:
55: Resources/Sounds/sample.wav

=== Extra Strings ===

Adds or replaces text strings in an existing [[Translations (OpenXcom)|OpenXcom language file]], listed in ''"extraStrings:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| Filename of the original language file to modify, sans extension.
| ''required''
|-
| '''strings'''
| List of the new strings to add/replace, listed as ''stringID: text''.
| -
|}

Example:
- type: en-US
strings:
STR_SNIPER_RIFLE: Sniper Rifle
STR_SNIPER_RIFLE_CLIP: Sniper Rifle Clip
- type: en-GB
strings:
STR_SNIPER_RIFLE: Sniper Rifle
STR_SNIPER_RIFLE_CLIP: Sniper Rifle Clip
- type: de
strings:
STR_SNIPER_RIFLE: Scharfschützengewehr
STR_SNIPER_RIFLE_CLIP: Scharfschützengewehrmunition
- type: ru
strings:
STR_SNIPER_RIFLE: Снайперская винтовка
STR_SNIPER_RIFLE_CLIP: Магазин к снайп. винтовке

=== Interfaces ===

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| ''?''
| -
|-
| '''elements'''
| ''?''
| -
|-
| '''id'''
| ''?''
| -
|-
| '''color'''
| ''?''
| -
|}

=== StatStrings ===

[[Statstrings]] are used for automatically renaming soldiers. They are case sensitive and they are processed in the order in which they are specified.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''string'''
| String to add to name.
| ''required''
|-
| '''psiStrength''' 
'''psiSkill''' 
'''bravery''' 
'''strength''' 
'''firing''' 
'''reactions''' 
'''stamina''' 
'''tu''' 
'''health''' 
'''throwing'''
| One or more stat ranges are ANDed together for success. Each range has a minVal and maxVal. Use YAML standard tilde (~) to indicate null. ((~) = 0 as minvalue; (~) =255 as maxvalue)
| -
|}

Example:
statStrings:
- string: "x"
psiStrength: [~, 30]
- string: "P"
psiStrength: [80, ~]
- string: "p"
psiStrength: [60, 79]
- string: "K"
psiSkill: [60, ~]
- string: "k"
psiSkill: [30, 59]
- string: "b"
bravery: [60, ~]
- string: "c"
bravery: [~, 10]
- string: "w"
strength: [~, 25]
- string: "Snpr"
firing: [60, ~]
reactions: [60, ~]
- string: "M"
firing: [70, ~]
- string: "m"
firing: [60, 69]
- string: "Sct"
reactions: [50, ~]
tu: [60, ~]
- string: "R"
reactions: [60, ~]
- string: "r"
reactions: [50, 59]

==References==
<references />

[[Category:OpenXcom]]

Ruleset Reference (OpenXcom)

2014-09-28T07:27:55Z

Falko: /* Globe */

A reference of all the customizable values of everything in a [[Rulesets (OpenXcom)|ruleset]]. Some guidelines:
* If a value is omitted from the ruleset, the default is used. You cannot omit ''required'' values.
* Text strings (eg. names) are represented by string IDs from the [[Translations (OpenXcom)|language files]]
* Numerical IDs (used for sprites, sounds, etc.) start at 0, not 1.
* Boolean (yes/no) values are represented by true/false.
* World coordinates are represented in degrees (see [[WORLD.DAT]]).
* Money amounts (prices, costs, etc.) are represented in dollars.
* All paths are '''case sensitive'''! If your ruleset uses external files, make sure that they named properly as described in ruleset.

Items are ordered as they come in the ruleset. To override this, you can specify a ''listOrder''. You can find the default listOrders in [[Ruleset List Order (OpenXcom)|Ruleset List Order]].

=== Globe ===

Defines the drawing of landmasses and borders on the globe.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''data'''
| Path name of file which contains polygon and texture information. (For example WORLD.DAT).
| -
|-
| '''polygons'''
| List of polygons drawn on the globe surface. A triangle consist of seven values: the first number defines the texture, followed by three pairs of (x,y) globe coordinates. Only polygons with 3 or 4 vertices are reliable shown on the globe = 7 or 9 values per entry.
| -
|-
| '''polylines'''
| List of border lines. Each list entry consist of a list of (x,y) globe coordinates.
| -
|}

=== Countries ===

Defines one of the [[Country Funding (EU)|funding nations]], listed in ''"countries:"''. They're used for activity graphs and player scoring.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the country name.
| ''required''
|-
| '''fundingBase'''
| Country's base funding, in thousands. The starting funding can be anywhere between 1x and 2x the base funding.
| 0
|-
| '''fundingCap'''
| Country's funding cap, in thousands. Once a country reaches this maximum, it will no longer increase its funding.
| 0
|-
| '''labelLon'''
'''labelLat'''
| Longitude and latitude coordinates of the country's label on the globe. This label is only shown when the globe is zoomed in and "detail" is turned on.
| 0.0
0.0
|-
| '''areas'''
| List of "rectangles" on the globe defined as [''lon1'' ''lat1'' ''lon2'' ''lat2'']. Any activity within these areas counts towards the country's graph activity and affects their opinion of the player.
| -
|}

=== Regions ===

Defines one of the [[Geoscape (EU)#World Regions/Countries|world regions]], listed in ''"regions:"''. They're used for base placement, activity graphs and mission spawning.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the region name.
| ''required''
|-
| '''cost'''
| Amount of money spent building an X-COM base in this region (first base is free).
| 0
|-
| '''areas'''
| List of "rectangles" on the globe defined as ''[lon1, lat1, lon2, lat2]''. Any activity within these areas counts towards the region's graph activity.
| -
|-
| '''cities'''
| List of cities belonging to this region. They will be displayed on the globe and used for terror site missions. Each city is defined by their '''lon''' and '''lat''' coordinates and a '''name''' string ID.
| -
|-
| '''regionWeight'''
| Weight of this region when selecting regions for alien missions.
| 0
|-
| '''missionWeights'''
| Weighted list of the different mission types for this region (eg. ''STR_ALIEN_RESEARCH: 14'').
| -
|-
| '''missionZones'''
| List of "rectangles" (''[lon1, lat1, lon2, lat2]'') defining the mission zones for this region.
| -
|-
| '''missionRegion'''
| Spawn mission in this region instead (used for regions without land).
| -
|}

=== Base Facilities ===

Defines one of the [[Base Facilities (EU)|facilities]] that can be built in an X-COM base, listed in ''"facilities:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the facility name.
| ''required''
|-
| '''requires'''
| List of [[#Research|topics]] (string IDs) that must be researched to unlock this facility. If none are specified, this facility is unlocked from the start.
| -
|-
| '''spriteShape'''
| Sprite ID from [[BASEBITS.PCK]] used to draw the facility's outer shape in the Basescape and UFOpaedia.
| -1
|-
| '''spriteFacility'''
| Sprite ID from [[BASEBITS.PCK]] used to draw the facility's contents in the Basescape and UFOpaedia. Drawn on top of '''spriteShape'''.
| -1
|-
| '''lift'''
| Is this facility an [[Access Lift]]? All base facilities must be connected to the lift.
| false
|-
| '''hyper'''
| Is this facility a [[Hyperwave Decoder]]? Displays extra information for detected UFOs. Only valid for radar facilities.
| false
|-
| '''mind'''
| Is this facility a [[Mind Shield]]? Reduces the chance of UFOs finding your base. Does not stack.
| false
|-
| '''grav'''
| Is this facility a [[Grav Shield]]? Doubles the power of your base defenses. Does not stack.
| false
|-
| '''size'''
| Size of the facility, in grid units. Every facility is square, so a size of 1 means 1x1, 2 means 2x2, etc. Bigger facilities are made up of multiple sprites, for example a 2x2 facility will use 4 sprites for '''spriteShape''' and 4 sprites for '''spriteFacility''' (top-left, top-right, bottom-left, bottom-right).
| 1
|-
| '''buildCost'''
| Amount of money spent to build this facility in the base.
| 0
|-
| '''buildTime'''
| Amount of days it takes for this facility to be built.
| 0
|-
| '''monthlyCost'''
| Amount of money spent monthly for the maintenance of this facility.
| 0
|-
| '''storage'''
| Amount of storage space (for items) this facility provides. See [[Base Stores]].
| 0
|-
| '''personnel'''
| Amount of personnel (soldiers, scientsts, engineers) these quarters can contain.
| 0
|-
| '''aliens'''
| Amount of live aliens this facility can contain. Only checked if the ''alienContainmentLimitEnforced'' option is enabled.
| 0
|-
| '''crafts'''
| Amount of X-COM craft this facility can contain.
| 0
|-
| '''labs'''
| Amount of lab space this facility provides for research projects.
| 0
|-
| '''workshops'''
| Amount of workshop space this facility provides for manufacture projects.
| 0
|-
| '''psiLabs'''
| Amount of soldier space this facility provides for psionic training.
| 0
|-
| '''radarRange'''
| Maximum radar detection range of this facility, in nautical miles.
| 0
|-
| '''radarChance'''
| Chance (0-100%) of this radar detecting a UFO that enters its range.
| 0
|-
| '''defense'''
| Offensive power provided by this base defense against attacking UFOs.
| 0
|-
| '''hitRatio'''
| Chance (0-100) of the base defense hitting an attacking UFO.
| 0
|-
| '''fireSound'''
| Sound ID from [[#Extra_Sounds|GEO.CAT]] played when the base defense fires.
| -1
|-
| '''hitSound'''
| Sound ID from [[#Extra_Sounds|GEO.CAT]] played when the base defense hits a target.
| -1
|-
| '''mapName'''
| [[MAPS|Map]] associated to this facility in Battlescape base defenses.
| -
|-
|}

=== Crafts ===

Defines one of the [[Craft|X-COM crafts]] that go on interception missions, listed in ''"crafts:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the craft name.
| ''required''
|-
| '''requires'''
| List of [[#Research|topics]] (string IDs) that must be researched to unlock this craft. If none are specified, this craft is unlocked from the start.
| -
|-
| '''sprite'''
| Sprite ID from [[BASEBITS.PCK]] used to draw this craft in the Basescape and from [[INTICON.PCK]] used to draw the damage indicator in dogfights.
modders: the corresponding extrasprite file id for BASEBITS.PCK is sprite+33 INTICON.PCK contains a minimized icon id=sprite the file id for the dogfight image is sprite+11
| -1
|-
| '''fuelMax'''
| Maximum amount of fuel this craft can carry. Crafts use up fuel based on their speed while travelling.
| 0
|-
| '''damageMax'''
| Maximum amount of damage this craft can take. If this amount is exceeded, the craft is destroyed.
| 0
|-
| '''speedMax'''
| Maximum speed in nautical miles. Crafts travel at max speed when flying and half speed when patrolling.
| 0
|-
| '''accel'''
| Aceeleration value shown in the UFOpaedia.
| 0
|-
| '''weapons'''
| Amount of craft weapons this craft can equip. The UI can only display a max of 2 weapons.
| 0
|-
| '''soldiers'''
| Amount of soldiers this craft can carry.
| 0
|-
| '''maxItems'''
| Amount of items this craft can carry.
| 80
|-
| '''vehicles'''
| Amount of vehicles this craft can carry.
| 0
|-
| '''costBuy'''
| Amount of money spent for purchasing this craft. If set to 0, the craft will not be available in the Purchase/Recruit screen.
| 0
|-
| '''costRent'''
| Amount of money spent monthly for renting this craft. If set to 0, the craft is not on rental and won't count towards base maintenance.
| 0
|-
| '''costSell'''
| Amount of money gained for selling this craft.
| 0
|-
| '''refuelItem'''
| Item required for refuelling this craft. If no item is specified, the craft uses human fuel.
| 0
|-
| '''repairRate'''
| Amount of damage restored every hour while [[Repairs|Repairing]] in base.
| 1
|-
| '''refuelRate'''
| Amount of fuel restored every 30 mins while [[Refueling]] in base. If specified, a '''refuelItem''' is spent each time.
| 1
|-
| '''radarRange'''
| Detection range of the craft's radar in nautical miles. Every craft radar has a 100% detection chance.
| 600
|-
| '''transferTime'''
| Number of hours it takes to purchase/transfer this craft to a base.
| 0
|-
| '''score'''
| [[Score]] lost when this craft is destroyed.
| 0
|-
| '''spacecraft'''
| Can this craft go to [[Cydonia]]?
| false
|-
| '''battlescapeTerrainData'''
| [[#Terrains|Terrain]] associated to this craft in Battlescape missions.
| -
|}

=== Craft Weapons ===

Defines one of the [[Craft Armaments|weapons]] equipped by X-COM craft for shooting down UFOs, listed in ''"craftWeapons:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the weapon name.
| ''required''
|-
| '''sprite'''
| Sprite ID from [[BASEBITS.PCK]] used to draw the weapon in the Basescape and from [[INTICON.PCK]] used to draw the weapon in dogfights.
modders: the corresponding extrasprites file id for INTICON.PCK is sprite+5 and sprite+48 for BASEBITS.PCK
| -1
|-
| '''sound'''
| Sound ID from [[#Extra_Sounds|GEO.CAT]] played when this weapon fires.
| -1
|-
| '''damage'''
| Amount of damage this weapon does to enemy UFOs.
| 0
|-
| '''range'''
| Maximum range of this weapon in dogfights (in meters).
| 0
|-
| '''accuracy'''
| Chance (0-100%) of each shot hitting the enemy UFO.
| 0
|-
| '''reloadCautious'''
| Time this weapon takes to fire between each shot in ''Cautious Mode''.
| 0
|-
| '''reloadStandard'''
| Time this weapon takes to fire between each shot in ''Standard Mode''.
| 0
|-
| '''reloadAggressive'''
| Time this weapon takes to fire between each shot in ''Aggressive Mode''.
| 0
|-
| '''ammoMax'''
| Maximum amount of ammo this weapon can carry.
| 0
|-
| '''rearmRate'''
| Amount of ammo restored every 30 mins while the craft is [[Rearming]] in base. If specified, '''clip'''s are spent depending on their '''clipSize'''. If the '''clipSize''' of the specified ammo is 0, no '''clip'''s are spent.
| 1
|-
| '''projectileType'''
| Type of the weapon projectile, used for the projectile sprite in dogfights:
* 0 - [[Stingray]]
* 1 - [[Avalanche]]
* 2 - [[Cannon]]
* 3 - [[Fusion Ball]]
* 4 - [[Laser Cannon]]
* 5 - [[Plasma Beam]]
| 2
|-
| '''projectileSpeed'''
| Speed of the weapon projectile in dogfights.
| 0
|-
| '''launcher'''
| String ID of the [[#Items|item]] required to equip this weapon.
| -
|-
| '''clip'''
| String ID of the [[#Items|item]] required to rearm this weapon.
| -
|}

=== Items ===

Defines the Geoscape and Battlescape properties of an [[Equipment (EU)|item]] that can be stored in X-COM bases, listed in ''"items:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the internal item name.
| ''required''
|-
| '''name'''
| String ID of the displayed item name, for cases where it's different from the internal name. If omitted, '''type''' is used.
| -
|-
| '''requires'''
| List of [[#Research|topics]] (string IDs) that must be researched to unlock this item. If none are specified, this item is unlocked from the start. Soldiers can only use unlocked items in the Battlescape.
| -
|-
| '''size'''
| Space occupied by this item in [[Base Stores]]. Can be a decimal value.
| 0.0
|-
| '''costBuy'''
| Amount of money spent for purchasing this item. If set to 0, this item will not be available in the Purchase/Recruit screen.
| 0
|-
| '''costSell'''
| Amount of money gained for selling this item.
| 0
|-
| '''transferTime'''
| Number of hours it takes to purchase/transfer this item to a base.
| 24
|-
| '''weight'''
| [[Item_Weight|Weight]] occupied by this item in a soldier's inventory.
| 999
|-
| '''bigSprite'''
| Sprite ID from [[BIGOBS.PCK]] used to draw this item in a soldier's inventory and UFOpaedia.
| -1
|-
| '''floorSprite'''
| Sprite ID from [[FLOOROB.PCK]] used to draw this item on the floor of a Battlescape tile.
| -1
|-
| '''handSprite'''
| Sprite ID from [[HANDOB.PCK]] used to draw this item on a soldier's hand in the Battlescape.
modders: each handobject needs 8 images (8 directions) define the extrasprites accordingly
| 120
|-
| '''bulletSprite'''
| Sprite ID from ''BulletSprites.png'' used to draw this weapon's projectile on the Battlescape:
* 0 - [[Rocket Launcher]]
* 1 - [[Pistol]]
* 2 - [[Rifle]]
* 3 - [[Auto Cannon]]
* 4 - [[Heavy Cannon]]
* 5 - [[Laser Pistol]]
* 6 - [[Laser Rifle]]
* 7 - [[Heavy Laser]]
* 8 - [[Plasma Rifle|Plasma]]
* 9 - [[Small Launcher]]
* 10 - [[Blaster Launcher]]
for modders: the bulletsprite needs to be put into the extraSprites type "Projectiles" the bulletsprite can contain up to 35 3x3 images. The corresponding file id is 35*[bulletSprite]
| -1
|-
| '''fireSound'''
| Sound ID from [[#Extra_Sounds|BATTLE.CAT]] played when this weapon fires.
| -1
|-
| '''hitSound'''
| Sound ID from [[#Extra_Sounds|BATTLE.CAT]] played when this weapon hits a target.
| -1
|-
| '''hitAnimation'''
| Sprite ID from [[SMOKE.PCK]] used to draw the weapon's "hit explosion".
'''NOTE''': Do not define this value for melee/psi weapons, they use [[HIT.PCK]] and therefore meleeAnimation instead.
| 0
|-
| '''power'''
| Average damage of the weapon, in most cases it will be +-50% this value.
| 0
|-
| '''strengthApplied'''
| Add the attacking unit's strength to this weapon's damage.
| false
|-
| '''compatibleAmmo'''
| List of string IDs of the ammo items that can be loaded on this weapon. If none are specified, the weapon doesn't need ammo.
| -
|-
| '''damageType'''
| What type of [[damage]] does this weapon do:
* 0 - None
* 1 - Armor Piercing
* 2 - Incendiary
* 3 - High Explosive
* 4 - Laser
* 5 - Plasma
* 6 - Stun
* 7 - Melee
* 8 - Acid
* 9 - Smoke
'''NOTE:''' A damage type other than 0-9 will do nothing.
| 0
|-
| '''tuAuto'''
'''accuracyAuto'''
| The percentage (0-100%) of [[Time Units]] (from the soldier's total) required to fire an Auto Shot. If 0, the weapon does not have an Auto Shot.
The base accuracy (0-100%) applied to a soldier's [[Firing Accuracy]] when firing an Auto Shot.
| 0
0
|-
| '''tuSnap'''
'''accuracySnap'''
| The percentage (0-100%) of [[Time Units]] (from the soldier's total) required to fire a Snap Shot. If 0, the weapon does not have a Snap Shot.
The base accuracy (0-100%) applied to a soldier's [[Firing Accuracy]] when firing a Snap Shot.
| 0
0
|-
| '''tuAimed'''
'''accuracyAimed'''
| The percentage (0-100%) of [[Time Units]] (from the soldier's total) required to fire an Aimed Shot. If 0, the weapon does not have an Aimed Shot.
The base accuracy (0-100%) applied to a soldier's [[Firing Accuracy]] when firing an Aimed Shot.
| 0
0
|-
|-
| '''tuMelee'''
'''accuracyMelee'''
| The percentage (0-100%) of [[Time Units]] (from the soldier's total) required to do a melee attack (Hit). If 0, the weapon does not have a melee attack.
The base accuracy (0-100%) applied to a soldier's [[Melee Accuracy]] when doing a melee attack.
| 0
0
|-
| '''clipSize'''
| The amount of ammo stored in each weapon clip. If -1 is specified, this weapon has infinite ammo.
| 0
|-
| '''battleType'''
| Defines the weapon's behavior in the Battlescape:
* 0 - None (Geoscape-only item)
* 1 - [[Weapons|Firearm]]
* 2 - Ammo
* 3 - Melee
* 4 - [[Grenade]]
* 5 - [[Proximity Grenade]]
* 6 - [[Medi-Kit (EU)|Medi-Kit]]
* 7 - [[Motion Scanner]]
* 8 - [[Mind Probe]]
* 9 - [[Psi-Amp]]
* 10 - [[Electro-flare]]
* 11 - Corpse
| 0
|-
| '''twoHanded'''
| Is this weapon two-handed? (incurs an accuracy penalty if used with both hands occupied)
| false
|-
| '''waypoint'''
| Does this weapon use waypoints? (eg. [[Blaster Launcher]]). Can also be used to make ammo items use the waypoint system.
| false
|-
| '''fixedWeapon'''
| Is this weapon fixed? (it's part of a unit, eg. tanks and terrorist units)
| false
|-
| '''invWidth'''
| Item width in a soldier's inventory (in grid units).
| 1
|-
| '''invHeight'''
| Item height in a soldier's inventory (in grid units).
| 1
|-
| '''painKiller'''
| Amount of painkillers contained in a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''heal'''
| Amount of heal's contained in a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''stimulant'''
| Amount of stimulants contained in a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''woundRecovery'''
| Amount of [[Fatal Wounds]] treated by each heal of a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''healthRecovery'''
| Amount of [[Health]] recovered by each heal of a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''stunRecovery'''
| Amount of [[Stun]] removed by each stimulant of a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''energyRecovery'''
| Amount of [[Energy]] recovered by each stimulant of a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''tuUse'''
| Amount of [[Time Units]] required to use this item (for non-offensive items). It's a flat rate if '''flatRate''' is true, otherwise it's a percentage (0-100%).
| 0
|-
| '''recoveryPoints'''
| [[Score]] gained for recovering this alien artifact.
| 0
|-
| '''armor'''
| How much damage is needed to destroy this item on the ground.
| 20
|-
| '''recover'''
| Is this item recoverable? (gets transported to the X-COM base on mission success)
| true
|-
| '''turretType'''
| Sprite ID from [[TANKS.PCK]] of the turret to assign to this tank:
* 0 - [[Tank/Cannon]]
* 1 - [[Tank/Rocket Launcher]]
* 2 - [[Tank/Laser Cannon]]
* 3 - [[Hovertank/Plasma]]
* 4 - [[Hovertank/Launcher]]
| -1
|-
| '''liveAlien'''
| Does this item represent a live alien? (counts towards [[Alien Containment]])
| false
|-
| '''blastRadius'''
| Size of the projectile explosions. 0 for no explosion. -1 to automatically calculate based on weapon power and damage type (actual '''blastRadius''' currently is capped due [[Explosions#Playing_With_Fire|Explosion calculations]]).
| -1
|-
| '''flatRate'''
| If true, then TU costs for this weapon are a flat rate (instead of a percentage of unit TUs).
| false
|-
| '''arcingShot'''
| Does this weapon fire in an arc?
| false
|-
| '''attraction'''
| Represents how likely an alien is to pick up this item. Values below 5 will be ignored (by design).
| 0
|-
| '''maxRange'''
| Maximum range at which this weapon can operate.
| 200
|-
| '''aimRange'''
| Maximum effective range with this weapon before which range-based dropoff occurs.
| 200
|-
| '''snapRange'''
| Maximum effective range with snap shot before which range-based dropoff occurs. (ufoextender accuracy only)
| 15
|-
| '''autoRange'''
| Maximum effective range with auto shot before which range-based dropoff occurs. (ufoextender accuracy only)
| 7
|-
| '''minRange'''
| Range-based dropoff will work in reverse for ranges below this.
| 0
|-
| '''dropoff'''
| The value by which the accuracy lowers for each tile after (or before) the thresholds above.
| 2
|-
| '''bulletSpeed'''
| How much faster (or slower, if you use a negative number) is a projectile fired from this weapon compared to the average.
| 0
|-
| '''autoShots'''
| How many auto shots does this weapon fire.
| 3
|-
| '''shotgunPellets'''
| Number of projectiles fired per unit of ammunition. (note: due to engine limitations it is currently impossible to draw multiple projectiles in flight.)
| 0
|-
| '''zombieUnit'''
| String ID of the unit used for zombification (eg. [[Chrysallid]]s turn units into [[Zombie]]s).
| none
|-
| '''meleeSound'''
| Sound ID from [[#Extra_Sounds|BATTLE.CAT]] played when this weapon attacks a target with melee.
| 39
|-
| '''meleeHitSound'''
| Sound ID from [[#Extra_Sounds|BATTLE.CAT]] played when this weapon HITS a target with melee.
| -1
|-
| '''meleeAnimation'''
| Sprite ID from HIT.PCK played when this weapon attacks a target with melee.
| 0
|-
| '''meleePower'''
| Damage this weapon will do when using melee. This only applies to Firearms, and is only available as stun damage. For normal melee weapons, use regular power and damage types.
| 0
|-
| '''LOSRequired'''
| Does this item require line of sight? (only applies to mind probes and psi-amps)
| false
|-
| '''skillApplied'''
| Is melee skill applied to the accuracy of an attack made with this object?
| true
|-
|}

=== UFOs ===

Defines one of the [[UFOs]] that invade Earth, listed in ''"ufos:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the UFO name.
| ''required''
|-
| '''size'''
| String ID of the UFO size.
| STR_VERY_SMALL
|-
| '''sprite'''
| Sprite ID from [[INTERWIN.DAT]] used to draw this UFO in the dogfight view and UFOpaedia.
don't try to add more images if you don't want to punch yourself in the face - use modsprite
| -1
|-
| '''modSprite'''
| Filename used to draw this UFO in the dogfight view and UFOpaedia.
| -
|-
| '''damageMax'''
| Maximum amount of damage this UFO can take. If the UFO takes 50% damage, it crash lands. If it takes 100% damage, it is destroyed.
| 0
|-
| '''speedMax'''
| Maximum speed in nautical miles.
| 0
|-
| '''accel'''
| Aceeleration value shown in the UFOpaedia.
| 0
|-
| '''power'''
| Damage power of this UFO's weapon in dogfights.
| 0
|-
| '''range'''
| Maximum range of this UFO's weapon in dogfights (in meters).
| 0
|-
| '''score'''
| [[Score]] gained when this UFO is destroyed, or half this score if it crash lands.
| 0
|-
| '''reload'''
| Time the UFO's weapon takes to fire between each shot.
| 0
|-
| '''breakOffTime'''
| Minimum amount of time for the UFO to be able to break off of a dogfight.
| 0
|-
| '''battlescapeTerrainData'''
| [[#Terrains|Terrain]] associated to this UFO in Battlescape missions.
| ''required''
|-
|}

=== Inventory Sections ===

Defines one of the sections of the [[Inventory TU Table|Battlescape inventory]] (eg. Backpack), listed in ''"invs:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the inventory name.
| ''required''
|-
| '''x'''
'''y'''
| Pixel coordinates of this section on the inventory screen.
| 0
0
|-
| '''type'''
| Type of this section:
* 0 = Slot section, can contain as many items as will fit on the slots.
* 1 = Hand section, can only contain one item regardless of size.
* 2 = Ground section, can contain infinite items.
| 0
|-
| '''slots'''
| List of the grid slots (''[x, y]'') that this section is composed of. For example, to make a 2x2 section, you would have ''[0, 0] [0, 1] [1, 0] [1, 1]''.
| -
|-
| '''costs'''
| List of [[Time Units]] costs to move an item from this section to another one (eg. ''STR_BACKPACK: 16'' means it will cost 16 TUs to move an item from this section to the Backpack).
| -
|-
|}

=== Terrains ===

Defines one of the [[TERRAIN|terrains]] used to generate a Battlescape map, listed in "terrains:".

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''name'''
| String ID of the terrain name.
| ''required''
|-
| '''largeBlockLimit'''
| Maximum amount of large blocks that can be used on map generation.
| 0
|-
| '''textures'''
| List of [[TEXTURE.DAT|Geoscape textures]] that correspond to this terrain.
| -
|-
| '''hemisphere'''
| Geoscape hemisphere associated with this terrain:
* -1 - Northern hemisphere.
* 0 - Both hemispheres.
* 1 - Southern hemisphere.
| 0
|-
| '''mapDataSets'''
| List of filenames (each with matching [[MCD]]/[[Image Formats#PCK|PCK/TAB]] files) that contain the tiles of this terrain.
| -
|-
| '''mapBlocks'''
| List of map blocks (see below) that are used for generating a map.
| -
|-
| '''roadTypeOdds'''
| Odds as a % of generating each type of road (E-W Road, N-S Road, Crossing) odds for crossing are: 100 - EW - NS.
| [0 0]
|-|-
| '''civilianTypes'''
| List of units to use as civilians for this mission.
| [MALE_CIVILIAN, FEMALE_CIVILIAN]
|-
|}

==== Map Blocks ====

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''name'''
| Filename of the [[MAPS|map]].
| ''required''
|-
| '''width'''
| Width of this map block in Battlescape grid units.
| 0
|-
| '''length'''
| Length of this map block in Battlescape grid units.
| 0
|-
| '''height'''
| Height of this map block in Battlescape grid units.
| 1
|-
| '''type'''
| Type of this map block:
* -1 - Undefined
* 0 - Default
* 1 - Landing Zone (for placing X-COM / alien craft)
* 2 - E-W Road (for city maps)
* 3 - N-S Road (for city maps)
* 4 - Road Crossing (for city maps)
* 5 - Dirt (for filling empty base blocks)
* 6 - X-COM spawn point (for [[Alien Base]] / [[Cydonia]] missions)
* 7 - [[Alien Base]] Target
* 8 - [[Cydonia]] Target
| -1
|-
| '''subType'''
| Sub-type of this map block (see '''type''').
| -1
|-
| '''frequency'''
| Frequency of this block in a map.
| 1
|-
| '''maxCount'''
| Maximum amount of times this block can be used in a map. If -1 there is no limit.
| -1
|-
| '''items'''
| An array of items to add to this mapblock, an the positions to place them at.
| -1
|}

*'''frequency''' defines the odds of the map appearing on the map
** The value assigned (default: 1) is used in ''x/n'', which defines the probability of being chosen.
** ''x'' is the integer defined for the map block's frequency and ''n'' is the combined total of probabilities for all the map types combined.
** This property can only be used in type 0 map blocks.
*'''maxCount''' is the maximum number of times it can be used.
** The value assigned is also used in ''x/n'' to determine the probability of being chosen.
** Each use reduces ''x'' by -1, with the caveat that being used as a Landing Zone type will not reduce the x value since it could result in no available Landing Zones.
** This property can only be used in type 0 map blocks.
* '''hemisphere''' only applies to UFO missions, not Terror ones.
*'''width/length''' defines the size of the map
** be aware that the mapview "width"-label is the openxcom ruleset length parameter
** be aware that the mapview "length"-label is the openxcom ruleset width parameter

==== Guidelines/Tips ====
* All maps with an XCOM/Alien craft require at least one type 1 map block. This map block can only contain ground tiles (no walls or objects), otherwise the game will crash or the walls/objects will be removed.
* All Terror terrains (listed under STR_TERROR_MISSION) require at least 1 map block of '''Types''' 2, 3 and 4 (for a total of 3 maps, which are required to place roads) and the corresponding '''roadTypeOdds''' added to the ruleset.
* If there isn't any map blocks designed as roads since you want to keep your terrain 'random', this can be circumvented by designating all 10x10 map blocks, excluding the one(s) used for the XCOM craft, as either '''Type''' 2, 3 and 4 and by defining their '''subType''' to 0. The game will then randomly choose between the map blocks for each type used in the roads, making them map more random.

=== Armor ===

Defines a Battlescape unit's [[armor]] as well as visual representation (so every unit has an armor), listed in ''"armors:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the armor name.
| ''required''
|-
| '''spriteSheet'''
| Sprite sheet from [[UNITS]] used to draw a unit wearing this armor.
| -
|-
| '''spriteInv'''
| Sprite used for the [[Inventory Backgrounds]] of a unit wearing this armor.
| -
|-
| '''corpseBattle'''
| List of string IDs of the corpse [[#Items|items]] generated when a unit wearing this armor is killed (one per unit tile) on the Battlescape.
| -
|-
| '''corpseGeo'''
| String ID of the corpse [[#Items|item]] associated with this unit on the Geoscape.
| -
|-
| '''storeItem'''
| String ID of the [[#Items|item]] that represents this armor in [[Base Stores]] for equipping.
| -
|-
| '''weight'''
| Physical weight of the armor when worn
| 6
|-
| '''stats'''
| like soldier stats (see below) but these are treated as stat bonuses for wearing the specific armor.
| -
|-
| '''frontArmor'''
| Protection provided on the front of the unit.
| 0
|-
| '''sideArmor'''
| Protection provided on the sides of the unit.
| 0
|-
| '''rearArmor'''
| Protection provided on the rear of the unit.
| 0
|-
| '''underArmor'''
| Protection provided under the unit (eg. from explosions).
| 0
|-
| '''drawingRoutine'''
| Drawing routine used to put together the body parts in the unit's '''spriteSheet''':
* 0 = [[Soldier]], [[Sectoid]]
* 1 = [[Floater]]
* 2 = [[HWP]]
* 3 = [[Cyberdisk]]
* 4 = [[Civilian]], [[Ethereal]]
* 5 = [[Sectopod]], [[Reaper]]
* 6 = [[Snakeman]]
* 7 = [[Chryssalid]]
* 8 = [[Silacoid]]
* 9 = [[Celatid]]
* 10 = [[Muton]]
| 0
|-
| '''movementType'''
| Type of movement provided by this armor:
* 0 = Walking
* 1 = Flying
* 2 = Sliding (no walking animation)
it also defines the body of an tank (32-images) in your spriteSheet or the change in sprites while flying using a flying armour see: [[TANKS.PCK]], [[XCOM_2.PCK]]
| 0
|-
| '''damageModifier'''
| List of decimal damage modifiers (1.0 = 100%) this armor applies to each damage type (see [[#Items|Items section]]) received. Modifiers must be specified for all damage types, in this order:
* None
* Armor Piercing
* Incendiary
* High Explosive
* Laser
* Plasma
* Stun
* Melee
* Acid
* Smoke
|
- 1.0 
- 1.0 
- 1.0 
- 1.0 
- 1.0 
- 1.0 
- 1.0 
- 1.0 
- 1.0 
- 1.0
|-
| '''size'''
| Size of the unit wearing this armor, in Battlescape grid units. Every unit is square, so a size of 2 means 2x2.
| 1
|-
| '''loftempsSet'''
| List of [[LOFTEMPS]] IDs (one per unit tile, so a 1x1 unit has 1, a 2x2 unit has 4, etc.) used to represent a unit wearing this armor in 3D space.
| -
|-
| '''loftemps'''
| loftemps is a deprecated option that only works for 1x1 sized units.
| -
|}

=== Player Units (Soldiers) ===

Defines a [[soldier]] recruited by X-COM, listed in ''"soldiers:"''. Currently only one soldier unit type (''XCOM'') is supported.

Unit stats are represented as follows:
* [[Time Units|tu]]
* [[Energy|stamina]]
* [[Health|health]]
* [[Bravery|bravery]] (always a multiple of 10)
* [[Reactions|reactions]]
* [[Firing Accuracy|firing]]
* [[Throwing Accuracy|throwing]]
* [[Strength|strength]]
* [[Psi Strength|psiStrength]]
* [[Psi Skill|psiSkill]]
* [[Melee Accuracy|melee]] (not visible)

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the soldier name.
| ''required''
|-
| '''minStats'''
| Minimum values used to generate the soldier's [[Starting Stats]]. In this case, ''psiSkill'' is treated as the initial stat (not generated).
| -
|-
| '''maxStats'''
| Maximum values used to generate the soldier's [[Starting Stats]]. In this case, ''psiSkill'' is treated as the minimum value for the first month of psi training (actual value is 100%-150%).
| -
|-
| '''statCaps'''
| Maximum stats this soldier can gain through [[Experience]]. '''NOTE:''' A stat will still go over the limit once, and then will no longer increase (see [[Experience#Regarding Caps|Regarding Caps]]).
| -
|-
| '''armor'''
| String ID of the [[#Armor|armor]] this soldier uses by default.
| -
|-
| '''standHeight'''
| Height of this soldier when standing.
| 0
|-
| '''kneelHeight'''
| Height of this soldier when kneeling.
| 0
|-
| '''floatHeight'''
| Distance between the bottom of this unit and the ground.
| 0
|}

=== AI Units (Aliens/Civilians) ===

Defines an [[Alien Life Forms|alien]] (enemy) or [[civilian]] (neutral) unit, listed in ''"units:"''. Every different alien rank is a different unit, since they have completely different stats. Unit stats are represented as follows:
* [[Time Units|tu]]
* [[Energy|stamina]]
* [[Health|health]]
* [[Bravery|bravery]] (always a multiple of 10)
* [[Reactions|reactions]]
* [[Firing Accuracy|firing]]
* [[Throwing Accuracy|throwing]]
* [[Strength|strength]]
* [[Psi Strength|psiStrength]]
* [[Psi Skill|psiSkill]]
* [[Melee Accuracy|melee]] (not visible)

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the unit name.
| ''required''
|-
| '''race'''
| String ID of the unit race (for alien units).
| -
|-
| '''rank'''
| String ID of the unit rank (for alien units).
| -
|-
| '''stats'''
| Battlescape stats of this unit.
| -
|-
| '''armor'''
| String ID of the [[#Armor|armor]] this unit uses by default.
| -
|-
| '''standHeight'''
| Height of this unit when standing.
| 0
|-
| '''floatHeight'''
| Distance between the bottom of this unit and the ground.
| 0
|-
| '''value'''
| [[Score]] this unit is worth.
| 0
|-
| '''deathSound'''
| Sound ID from [[#Extra_Sounds|BATTLE.CAT]] played when this unit dies.
| -1
|-
| '''aggroSound'''
| Sound ID from [[#Extra_Sounds|BATTLE.CAT]] played when this unit aggros.
| -1
|-
| '''moveSound'''
| Sound ID from [[#Extra_Sounds|BATTLE.CAT]] played when this unit moves.
| -1
|-
| '''intelligence'''
| Intelligence of this unit's AI. The higher the value, the longer this unit remembers player troops between turns.
| 0
|-
| '''aggression'''
| Aggression of this unit's AI. The higher the value, the more ruthless the unit, the more likely to make a frontal assault. Less aggressive units tend to set up ambushes.
Vanilla values are:
* 0 = mostly passive
* 1 = balanced
* 2 = mostly aggresive
| 0
|-
| '''energyRecovery'''
| Energy recovered by the unit each turn (needs verification)
| 40 (?)
|-
| '''specab'''
| Special ability of this unit:
* 0 = None
* 1 = [[Cyberdisc|Explodes on Death]]
* 2 = [[Bio-Drone|Burns Floor]]
* 3 = [[Zombie|Respawns on Death]]
| 0
|-
| '''spawnUnit'''
| String ID of the unit used to respawn on death (eg. [[Zombie]]s respawn as [[Chrysallid]]s).
| -
|-
| '''livingWeapon'''
| Is this unit a living weapon? (only attacks with a '''fixedWeapon''')
| false
|-
|}

=== Alien Races ===

Defines a [[Alien Life Forms|race]] used in [[Alien Missions]], listed in ''"alienRaces:"''. Heavily tied with deployment data.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''id'''
| String ID of the alien race name.
| ''required''
|-
| '''members'''
| Alien crew associated with this alien race (eg. race units + terrorist units), defined by a list of unit string IDs. Order here will define rank in terms of deployment. generally speaking the order is:
* 0 - Commander
* 1 - Leader
* 2 - Engineer
* 3 - Medic
* 4 - Navigator
* 5 - Soldier
* 6 - Terrorist 1
* 7 - Terrorist 2
but of course, not all races have all ranks, so the "fill in" rank would be listed multiple times (see ethereals).
|-
| '''retaliation'''
| retaliation enables/disables the race for retaliation missions.
| ''True''
| -
|}

=== Alien Deployments ===

Defines a Battlescape deployment data used in [[Alien Missions]] (such as alien and map configurations), listed in ''"alienDeployments:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the deployment name.
| ''required''
|-
| '''width'''
| Width of the Battlescape map in grid units.
| 0
|-
| '''length'''
| Length of the Battlescape map in grid units.
| 0
|-
| '''height'''
| Vertical height of the Battlescape map in grid units.
| 0
|-
| '''terrains'''
| list of string IDs of the [[#Terrains|terrain]] to choose from to generate this map. This is not used for UFO sites where the terrain comes from the Geoscape.
| -
|-
| '''shade'''
| Shade of the map (0-15, where 0 is full daytime and 15 is full nighttime). This is not used for UFO sites where the shade comes from the Geoscape.
| 0
|-
| '''nextStage'''
| String ID of the next deployment stage to use after this one, for multi-stage missions.
| -
|-
| '''data'''
| List of deployment data for each alien rank on this mission (see below).
| -
|}

Notes:
* '''terrains''' can also be used with UFOs, with the game using instead the listed terrain rather than the location of the UFO on Geoscape.
==== Deployment Data ====

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''alienRank'''
| [[Alien Rank|Rank]] associated with this deployment data, as defined by the order of the race in question (see above)
| ''required''
|-
| '''lowQty'''
| Maximum quantity of aliens to spawn (beginner).
| 0
|-
| '''highQty'''
| Maximum quantity of aliens to spawn (superhuman).
| 0
|-
| '''dQty'''
| Minimum Desired Quantity of aliens to spawn.
| 0
|-
| '''percentageOutsideUfo'''
| Percentage (0-100%) of aliens to spawn outside in UFO sites.
| 0
|-
| '''itemSets'''
| Three lists (one for each alien technology level) of [[#Items|items]] (string IDs) for the aliens to equip.
| ''required''
|-
|}

=== Research ===

Defines a [[Research|research topic]] that X-COM scientists can investigate, listed in ''"research:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''name'''
| String ID of the research project's name (or item, if a '''lookup''' is defined).
| ''required''
|-
| '''lookup'''
| String ID of the research project's display name and UFOPaedia article reference.
| -
|-
| '''cost'''
| Number of man hours (on average) required to complete this project.
| 0
|-
| '''points'''
| [[Score]] earned for completing this project.
| 0
|-
| '''needItem'''
| Does this project require an [[#Items|item]] of the same name?
| false
|-
| '''dependencies'''
| List of research projects that can unlock access to this one. If the full list is researched, or if one of the projects on the list "unlocks" this one, it becomes available.
| -
|-
| '''unlocks'''
| List of research projects unlocked, regardless of other dependencies, but not requirements, by completing this project (for example, any live alien unlocks "alien origins").
| -
|-
| '''requires'''
| List of research projects unilaterally required before this project can be unlocked (for example, "the martian solution" will not even be considered for unlocking until AFTER "alien origins" is completed).
| -
|-
| '''getOneFree'''
| List of "bonus" research projects that may be granted when completing this project (for example, alien medics will give you information on other alien races). Only applies to living aliens.
| -
|-
|}

=== Manufacture ===

Defines a [[Manufacture|manufacture project]] that X-COM engineers can produce, listed in ''"manufacture:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''name'''
| String ID of the manufacturing project's name (and the item it produces).
| ''required''
|-
| '''category'''
| String ID of the manufacturing project's category.
| -
|-
| '''requires'''
| List of [[#Research|topics]] (string IDs) that must be researched to unlock this project. If none are specified, this project is unlocked from the start.
| -
|-
| '''space'''
| Amount of [[Workshop]] space required to begin this project.
| 0
|-
| '''time'''
| Number of man hours (on average) required per item.
| 0
|-
| '''cost'''
| Monetary deduction per item manufactured.
| 0
|-
| '''requiredItems'''
| List of [[#Items|items]] required and consumed per item manufactured.
| -
|-
| '''producedItems'''
| List of [[#Items|items]] produced per each item consumed. If not specified, defaults to 1 item with the same string ID as the manufacture.
| 1
|-
|}

=== UFOpaedia Article ===

Defines an article in the in-game [[UFOpaedia]], listed in ''"ufopaedia:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''id'''
| String ID of the article name. This must match the ID of the object associated with this article, if applicable.
| ''required''
|-
| '''title'''
| String ID of the article title. If omitted, the '''id''' is used.
| -
|-
| '''type_id'''
| Type of this article:
* 0 = Unknown
* 1 = [[Craft]]
* 2 = [[Craft Armaments]]
* 3 = [[HWP]]
* 4 = [[Equipment (EU)|Equipment]]
* 5 = [[Armour]]
* 6 = [[Base Facilities]]
* 7 = Text & Image (eg. [[Alien Life Forms]], [[UFO Components]])
* 8 = Text (eg. [[Alien Research]])
* 9 = [[UFO]]
| 0
|-
| '''section'''
| String ID of the UFOpaedia section this article belongs in.
| -
|-
| '''requires'''
| List of [[#Research|topics]] (string IDs) that must be researched to unlock this article. If none are specified, this article is unlocked from the start.
| -
|-
| '''image_id'''
| Filename of the [[UP001.SPK-UP042.SPK|background image]] displayed on this article, if applicable.
| -
|-
| '''text'''
| String ID of the description displayed on this article.
| -
|-
| '''text_width'''
| Maximum width of the text displayed, only applicable to ''Text & Image'' articles.
| 0
|-
| '''rect_stats'''
| Rectangle ('''x''', '''y''', '''width''', '''height''') of the stats text on the screen, only applicable to ''Craft'' articles.
| 0
|-
| '''rect_text'''
| Rectangle ('''x''', '''y''', '''width''', '''height''') of the description text on the screen, only applicable to ''Craft'' articles.
| 0
|-
| '''weapon'''
| String ID of the weapon, only applicable to ''HWP'' articles.
| -
|}

=== UFO Trajectories ===

Defines a trajectory carried out by an UFO during an [[#Alien Missions|alien mission]], listed in ''"ufoTrajectories:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''id'''
| String ID of the trajectory name.
| ''required''
|-
| '''groundTimer'''
| Amount of seconds for the UFO to spend on Ground waypoints.
| 0
|-
| '''waypoints'''
| List of waypoints for the UFO to traverse, defined as ''[zone, altitude, speed]''. 
'''zone''': Globe zone where the waypoint is located. 
'''altitude''': UFO altitude after reaching this waypoint:
* 0 - Ground
* 1 - Very Low
* 2 - Low
* 3 - High
* 4 - Very High
'''speed''': UFO speed after reaching this waypoint, as a percentage (0-100%) of its maximum speed.
| -
|}

=== Alien Missions ===

Defines an [[Alien Missions|alien mission]] carried out by UFOs on the Geoscape, listed in ''"alienMissions:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the mission type.
| ''required''
|-
| '''points'''
| [[Score]] allocated to aliens for successfully completing this mission.
| 0
|-
| '''raceWeights'''
| List of alien races likely to carry out this mission, and the % chance of them being allocated to this mission, listed by "number of months after game beginning".
| ''required''
|-
| '''waves'''
| List of UFO waves to spawn as this mission progresses, as described below.
| ''required''
|}

==== Waves ====

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''ufo'''
| String ID of the [[#UFOs|UFO]] to spawn.
| ''required''
|-
| '''count'''
| Number of UFOs to spawn.
| 0
|-
| '''trajectory'''
| String ID of the [[#UFO Trajectories|trajectory]] for this UFO to use when entering Earth's atmosphere.
| ''required''
|-
| '''timer'''
| How long after the previous wave should this wave arrive? (in seconds)
| 0
|-
|}

=== Alien Item Levels ===

This is a list of item level probabilities, with a number between 0 and 2 representing an item level from plasma pistols to heavy plasmas, as defined in the deployments, expressing a 10% probability for that item level being used.

0 = first set (plasma pistol/clip)
1 = second set (plasma rifle/clip)
2 = third set (heavy plasma/clip)

For example:
[ 2, 0, 0, 0, 0, 0, 0, 1, 1, 1 ]
would represent a 60% chance for pistols, 30% rifles, and 10% heavy weapons. 
Note that the order does not matter, but the length DOES. each line MUST have 10 digits.

The above can be confusing. There are 10 fields; each number represents 10%. 
There is only one instance of '2'. 1x10% = 10% chance of plasma pistol 
There are three instances of '1'. 3x10% = 30% chance of plasma rifle 
There are six instances of '0'. 6x10% = 60% chance of heavy plasma 

Each line represents a month after the beginning of the game, and there is no limit to the number defined. 
OpenXCom will use the most recently available item level in the event the game goes on forever.

=== Extra Sprites ===

Adds or replaces sprites in an existing [[Image Formats|X-COM image file]], listed in ''"extraSprites:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| Filename of the original/new image to modify.
| ''required''
|-
| '''width'''
'''height'''
| Size of the sprite(s) in pixels.
| 0
0
|-
| '''singleImage'''
| Is the image file just a single sprite (true) or a spritesheet (false)?
| false
|-
| '''subX'''
'''subY'''
| Size of the subdivision in pixels. If a subdivision is specified, then the image file is divided into chunks to form the sprites (eg. spritesheets).
| 0
0
|-
| '''files'''
| List of the new sprites to add/replace, listed as ''spriteID: filename''.
| -
|}

Example:
- type: GIANTBUNNY.PCK
width: 32
height: 40
files:
0: Resources/Bunny/Bunny00.png
1: Resources/Bunny/Bunny01.bmp
2: Resources/Bunny/Bunny02.gif

=== Extra Sounds ===

Adds or replaces sounds in an existing [[SOUND|X-COM sound file]], listed in ''"extraSounds:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| ID of the original sound file to modify:
* BATTLE.CAT - Battlescape sounds, corresponds to ''SOUND1.CAT'' or ''SAMPLE2.CAT'' (55 sounds).
* INTRO.CAT - Intro sounds, corresponds to ''INTRO.CAT'' or ''SAMPLE3.CAT'', probably best not to mess with these.
* GEO.CAT - Geoscape sounds, corresponds to ''SOUND2.CAT'' or ''SAMPLE.CAT'' (14 sounds).
| ''required''
|-
| '''files'''
| List of the new sounds to add/replace, listed as ''soundID: filename''.
| -
|}

Example:
- type: BATTLE.CAT
files:
55: Resources/Sounds/sample.wav

=== Extra Strings ===

Adds or replaces text strings in an existing [[Translations (OpenXcom)|OpenXcom language file]], listed in ''"extraStrings:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| Filename of the original language file to modify, sans extension.
| ''required''
|-
| '''strings'''
| List of the new strings to add/replace, listed as ''stringID: text''.
| -
|}

Example:
- type: en-US
strings:
STR_SNIPER_RIFLE: Sniper Rifle
STR_SNIPER_RIFLE_CLIP: Sniper Rifle Clip
- type: en-GB
strings:
STR_SNIPER_RIFLE: Sniper Rifle
STR_SNIPER_RIFLE_CLIP: Sniper Rifle Clip
- type: de
strings:
STR_SNIPER_RIFLE: Scharfschützengewehr
STR_SNIPER_RIFLE_CLIP: Scharfschützengewehrmunition
- type: ru
strings:
STR_SNIPER_RIFLE: Снайперская винтовка
STR_SNIPER_RIFLE_CLIP: Магазин к снайп. винтовке

=== Interfaces ===

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| ''?''
| -
|-
| '''elements'''
| ''?''
| -
|-
| '''id'''
| ''?''
| -
|-
| '''color'''
| ''?''
| -
|}

=== StatStrings ===

[[Statstrings]] are used for automatically renaming soldiers. They are case sensitive and they are processed in the order in which they are specified.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''string'''
| String to add to name.
| ''required''
|-
| '''psiStrength''' 
'''psiSkill''' 
'''bravery''' 
'''strength''' 
'''firing''' 
'''reactions''' 
'''stamina''' 
'''tu''' 
'''health''' 
'''throwing'''
| One or more stat ranges are ANDed together for success. Each range has a minVal and maxVal. Use YAML standard tilde (~) to indicate null.
| -
|}

Example:
statStrings:
- string: "x"
psiStrength: [~, 30]
- string: "P"
psiStrength: [80, ~]
- string: "p"
psiStrength: [60, 79]
- string: "K"
psiSkill: [60, ~]
- string: "k"
psiSkill: [30, 59]
- string: "b"
bravery: [60, ~]
- string: "c"
bravery: [~, 10]
- string: "w"
strength: [~, 25]
- string: "Snpr"
firing: [60, ~]
reactions: [60, ~]
- string: "M"
firing: [70, ~]
- string: "m"
firing: [60, 69]
- string: "Sct"
reactions: [50, ~]
tu: [60, ~]
- string: "R"
reactions: [60, ~]
- string: "r"
reactions: [50, 59]

==References==
<references />

[[Category:OpenXcom]]

Ruleset Reference (OpenXcom)

2014-09-28T07:22:52Z

Falko: /* Items */

A reference of all the customizable values of everything in a [[Rulesets (OpenXcom)|ruleset]]. Some guidelines:
* If a value is omitted from the ruleset, the default is used. You cannot omit ''required'' values.
* Text strings (eg. names) are represented by string IDs from the [[Translations (OpenXcom)|language files]]
* Numerical IDs (used for sprites, sounds, etc.) start at 0, not 1.
* Boolean (yes/no) values are represented by true/false.
* World coordinates are represented in degrees (see [[WORLD.DAT]]).
* Money amounts (prices, costs, etc.) are represented in dollars.
* All paths are '''case sensitive'''! If your ruleset uses external files, make sure that they named properly as described in ruleset.

Items are ordered as they come in the ruleset. To override this, you can specify a ''listOrder''. You can find the default listOrders in [[Ruleset List Order (OpenXcom)|Ruleset List Order]].

=== Globe ===

Defines the drawing of landmasses and borders on the globe.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''data'''
| Path name of file which contains polygon and texture information. (For example WORLD.DAT).
| -
|-
| '''polygons'''
| List of polygons drawn on the globe surface. A triangle consist of seven values: the first number defines the texture, followed by three pairs of (x,y) globe coordinates. Polygons with more nodes can be defined by adding additional (x,y) coordinates.
| -
|-
| '''polylines'''
| List of border lines. Each list entry consist of a list of (x,y) globe coordinates.
| -
|}

=== Countries ===

Defines one of the [[Country Funding (EU)|funding nations]], listed in ''"countries:"''. They're used for activity graphs and player scoring.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the country name.
| ''required''
|-
| '''fundingBase'''
| Country's base funding, in thousands. The starting funding can be anywhere between 1x and 2x the base funding.
| 0
|-
| '''fundingCap'''
| Country's funding cap, in thousands. Once a country reaches this maximum, it will no longer increase its funding.
| 0
|-
| '''labelLon'''
'''labelLat'''
| Longitude and latitude coordinates of the country's label on the globe. This label is only shown when the globe is zoomed in and "detail" is turned on.
| 0.0
0.0
|-
| '''areas'''
| List of "rectangles" on the globe defined as [''lon1'' ''lat1'' ''lon2'' ''lat2'']. Any activity within these areas counts towards the country's graph activity and affects their opinion of the player.
| -
|}

=== Regions ===

Defines one of the [[Geoscape (EU)#World Regions/Countries|world regions]], listed in ''"regions:"''. They're used for base placement, activity graphs and mission spawning.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the region name.
| ''required''
|-
| '''cost'''
| Amount of money spent building an X-COM base in this region (first base is free).
| 0
|-
| '''areas'''
| List of "rectangles" on the globe defined as ''[lon1, lat1, lon2, lat2]''. Any activity within these areas counts towards the region's graph activity.
| -
|-
| '''cities'''
| List of cities belonging to this region. They will be displayed on the globe and used for terror site missions. Each city is defined by their '''lon''' and '''lat''' coordinates and a '''name''' string ID.
| -
|-
| '''regionWeight'''
| Weight of this region when selecting regions for alien missions.
| 0
|-
| '''missionWeights'''
| Weighted list of the different mission types for this region (eg. ''STR_ALIEN_RESEARCH: 14'').
| -
|-
| '''missionZones'''
| List of "rectangles" (''[lon1, lat1, lon2, lat2]'') defining the mission zones for this region.
| -
|-
| '''missionRegion'''
| Spawn mission in this region instead (used for regions without land).
| -
|}

=== Base Facilities ===

Defines one of the [[Base Facilities (EU)|facilities]] that can be built in an X-COM base, listed in ''"facilities:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the facility name.
| ''required''
|-
| '''requires'''
| List of [[#Research|topics]] (string IDs) that must be researched to unlock this facility. If none are specified, this facility is unlocked from the start.
| -
|-
| '''spriteShape'''
| Sprite ID from [[BASEBITS.PCK]] used to draw the facility's outer shape in the Basescape and UFOpaedia.
| -1
|-
| '''spriteFacility'''
| Sprite ID from [[BASEBITS.PCK]] used to draw the facility's contents in the Basescape and UFOpaedia. Drawn on top of '''spriteShape'''.
| -1
|-
| '''lift'''
| Is this facility an [[Access Lift]]? All base facilities must be connected to the lift.
| false
|-
| '''hyper'''
| Is this facility a [[Hyperwave Decoder]]? Displays extra information for detected UFOs. Only valid for radar facilities.
| false
|-
| '''mind'''
| Is this facility a [[Mind Shield]]? Reduces the chance of UFOs finding your base. Does not stack.
| false
|-
| '''grav'''
| Is this facility a [[Grav Shield]]? Doubles the power of your base defenses. Does not stack.
| false
|-
| '''size'''
| Size of the facility, in grid units. Every facility is square, so a size of 1 means 1x1, 2 means 2x2, etc. Bigger facilities are made up of multiple sprites, for example a 2x2 facility will use 4 sprites for '''spriteShape''' and 4 sprites for '''spriteFacility''' (top-left, top-right, bottom-left, bottom-right).
| 1
|-
| '''buildCost'''
| Amount of money spent to build this facility in the base.
| 0
|-
| '''buildTime'''
| Amount of days it takes for this facility to be built.
| 0
|-
| '''monthlyCost'''
| Amount of money spent monthly for the maintenance of this facility.
| 0
|-
| '''storage'''
| Amount of storage space (for items) this facility provides. See [[Base Stores]].
| 0
|-
| '''personnel'''
| Amount of personnel (soldiers, scientsts, engineers) these quarters can contain.
| 0
|-
| '''aliens'''
| Amount of live aliens this facility can contain. Only checked if the ''alienContainmentLimitEnforced'' option is enabled.
| 0
|-
| '''crafts'''
| Amount of X-COM craft this facility can contain.
| 0
|-
| '''labs'''
| Amount of lab space this facility provides for research projects.
| 0
|-
| '''workshops'''
| Amount of workshop space this facility provides for manufacture projects.
| 0
|-
| '''psiLabs'''
| Amount of soldier space this facility provides for psionic training.
| 0
|-
| '''radarRange'''
| Maximum radar detection range of this facility, in nautical miles.
| 0
|-
| '''radarChance'''
| Chance (0-100%) of this radar detecting a UFO that enters its range.
| 0
|-
| '''defense'''
| Offensive power provided by this base defense against attacking UFOs.
| 0
|-
| '''hitRatio'''
| Chance (0-100) of the base defense hitting an attacking UFO.
| 0
|-
| '''fireSound'''
| Sound ID from [[#Extra_Sounds|GEO.CAT]] played when the base defense fires.
| -1
|-
| '''hitSound'''
| Sound ID from [[#Extra_Sounds|GEO.CAT]] played when the base defense hits a target.
| -1
|-
| '''mapName'''
| [[MAPS|Map]] associated to this facility in Battlescape base defenses.
| -
|-
|}

=== Crafts ===

Defines one of the [[Craft|X-COM crafts]] that go on interception missions, listed in ''"crafts:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the craft name.
| ''required''
|-
| '''requires'''
| List of [[#Research|topics]] (string IDs) that must be researched to unlock this craft. If none are specified, this craft is unlocked from the start.
| -
|-
| '''sprite'''
| Sprite ID from [[BASEBITS.PCK]] used to draw this craft in the Basescape and from [[INTICON.PCK]] used to draw the damage indicator in dogfights.
modders: the corresponding extrasprite file id for BASEBITS.PCK is sprite+33 INTICON.PCK contains a minimized icon id=sprite the file id for the dogfight image is sprite+11
| -1
|-
| '''fuelMax'''
| Maximum amount of fuel this craft can carry. Crafts use up fuel based on their speed while travelling.
| 0
|-
| '''damageMax'''
| Maximum amount of damage this craft can take. If this amount is exceeded, the craft is destroyed.
| 0
|-
| '''speedMax'''
| Maximum speed in nautical miles. Crafts travel at max speed when flying and half speed when patrolling.
| 0
|-
| '''accel'''
| Aceeleration value shown in the UFOpaedia.
| 0
|-
| '''weapons'''
| Amount of craft weapons this craft can equip. The UI can only display a max of 2 weapons.
| 0
|-
| '''soldiers'''
| Amount of soldiers this craft can carry.
| 0
|-
| '''maxItems'''
| Amount of items this craft can carry.
| 80
|-
| '''vehicles'''
| Amount of vehicles this craft can carry.
| 0
|-
| '''costBuy'''
| Amount of money spent for purchasing this craft. If set to 0, the craft will not be available in the Purchase/Recruit screen.
| 0
|-
| '''costRent'''
| Amount of money spent monthly for renting this craft. If set to 0, the craft is not on rental and won't count towards base maintenance.
| 0
|-
| '''costSell'''
| Amount of money gained for selling this craft.
| 0
|-
| '''refuelItem'''
| Item required for refuelling this craft. If no item is specified, the craft uses human fuel.
| 0
|-
| '''repairRate'''
| Amount of damage restored every hour while [[Repairs|Repairing]] in base.
| 1
|-
| '''refuelRate'''
| Amount of fuel restored every 30 mins while [[Refueling]] in base. If specified, a '''refuelItem''' is spent each time.
| 1
|-
| '''radarRange'''
| Detection range of the craft's radar in nautical miles. Every craft radar has a 100% detection chance.
| 600
|-
| '''transferTime'''
| Number of hours it takes to purchase/transfer this craft to a base.
| 0
|-
| '''score'''
| [[Score]] lost when this craft is destroyed.
| 0
|-
| '''spacecraft'''
| Can this craft go to [[Cydonia]]?
| false
|-
| '''battlescapeTerrainData'''
| [[#Terrains|Terrain]] associated to this craft in Battlescape missions.
| -
|}

=== Craft Weapons ===

Defines one of the [[Craft Armaments|weapons]] equipped by X-COM craft for shooting down UFOs, listed in ''"craftWeapons:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the weapon name.
| ''required''
|-
| '''sprite'''
| Sprite ID from [[BASEBITS.PCK]] used to draw the weapon in the Basescape and from [[INTICON.PCK]] used to draw the weapon in dogfights.
modders: the corresponding extrasprites file id for INTICON.PCK is sprite+5 and sprite+48 for BASEBITS.PCK
| -1
|-
| '''sound'''
| Sound ID from [[#Extra_Sounds|GEO.CAT]] played when this weapon fires.
| -1
|-
| '''damage'''
| Amount of damage this weapon does to enemy UFOs.
| 0
|-
| '''range'''
| Maximum range of this weapon in dogfights (in meters).
| 0
|-
| '''accuracy'''
| Chance (0-100%) of each shot hitting the enemy UFO.
| 0
|-
| '''reloadCautious'''
| Time this weapon takes to fire between each shot in ''Cautious Mode''.
| 0
|-
| '''reloadStandard'''
| Time this weapon takes to fire between each shot in ''Standard Mode''.
| 0
|-
| '''reloadAggressive'''
| Time this weapon takes to fire between each shot in ''Aggressive Mode''.
| 0
|-
| '''ammoMax'''
| Maximum amount of ammo this weapon can carry.
| 0
|-
| '''rearmRate'''
| Amount of ammo restored every 30 mins while the craft is [[Rearming]] in base. If specified, '''clip'''s are spent depending on their '''clipSize'''. If the '''clipSize''' of the specified ammo is 0, no '''clip'''s are spent.
| 1
|-
| '''projectileType'''
| Type of the weapon projectile, used for the projectile sprite in dogfights:
* 0 - [[Stingray]]
* 1 - [[Avalanche]]
* 2 - [[Cannon]]
* 3 - [[Fusion Ball]]
* 4 - [[Laser Cannon]]
* 5 - [[Plasma Beam]]
| 2
|-
| '''projectileSpeed'''
| Speed of the weapon projectile in dogfights.
| 0
|-
| '''launcher'''
| String ID of the [[#Items|item]] required to equip this weapon.
| -
|-
| '''clip'''
| String ID of the [[#Items|item]] required to rearm this weapon.
| -
|}

=== Items ===

Defines the Geoscape and Battlescape properties of an [[Equipment (EU)|item]] that can be stored in X-COM bases, listed in ''"items:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the internal item name.
| ''required''
|-
| '''name'''
| String ID of the displayed item name, for cases where it's different from the internal name. If omitted, '''type''' is used.
| -
|-
| '''requires'''
| List of [[#Research|topics]] (string IDs) that must be researched to unlock this item. If none are specified, this item is unlocked from the start. Soldiers can only use unlocked items in the Battlescape.
| -
|-
| '''size'''
| Space occupied by this item in [[Base Stores]]. Can be a decimal value.
| 0.0
|-
| '''costBuy'''
| Amount of money spent for purchasing this item. If set to 0, this item will not be available in the Purchase/Recruit screen.
| 0
|-
| '''costSell'''
| Amount of money gained for selling this item.
| 0
|-
| '''transferTime'''
| Number of hours it takes to purchase/transfer this item to a base.
| 24
|-
| '''weight'''
| [[Item_Weight|Weight]] occupied by this item in a soldier's inventory.
| 999
|-
| '''bigSprite'''
| Sprite ID from [[BIGOBS.PCK]] used to draw this item in a soldier's inventory and UFOpaedia.
| -1
|-
| '''floorSprite'''
| Sprite ID from [[FLOOROB.PCK]] used to draw this item on the floor of a Battlescape tile.
| -1
|-
| '''handSprite'''
| Sprite ID from [[HANDOB.PCK]] used to draw this item on a soldier's hand in the Battlescape.
modders: each handobject needs 8 images (8 directions) define the extrasprites accordingly
| 120
|-
| '''bulletSprite'''
| Sprite ID from ''BulletSprites.png'' used to draw this weapon's projectile on the Battlescape:
* 0 - [[Rocket Launcher]]
* 1 - [[Pistol]]
* 2 - [[Rifle]]
* 3 - [[Auto Cannon]]
* 4 - [[Heavy Cannon]]
* 5 - [[Laser Pistol]]
* 6 - [[Laser Rifle]]
* 7 - [[Heavy Laser]]
* 8 - [[Plasma Rifle|Plasma]]
* 9 - [[Small Launcher]]
* 10 - [[Blaster Launcher]]
for modders: the bulletsprite needs to be put into the extraSprites type "Projectiles" the bulletsprite can contain up to 35 3x3 images. The corresponding file id is 35*[bulletSprite]
| -1
|-
| '''fireSound'''
| Sound ID from [[#Extra_Sounds|BATTLE.CAT]] played when this weapon fires.
| -1
|-
| '''hitSound'''
| Sound ID from [[#Extra_Sounds|BATTLE.CAT]] played when this weapon hits a target.
| -1
|-
| '''hitAnimation'''
| Sprite ID from [[SMOKE.PCK]] used to draw the weapon's "hit explosion".
'''NOTE''': Do not define this value for melee/psi weapons, they use [[HIT.PCK]] and therefore meleeAnimation instead.
| 0
|-
| '''power'''
| Average damage of the weapon, in most cases it will be +-50% this value.
| 0
|-
| '''strengthApplied'''
| Add the attacking unit's strength to this weapon's damage.
| false
|-
| '''compatibleAmmo'''
| List of string IDs of the ammo items that can be loaded on this weapon. If none are specified, the weapon doesn't need ammo.
| -
|-
| '''damageType'''
| What type of [[damage]] does this weapon do:
* 0 - None
* 1 - Armor Piercing
* 2 - Incendiary
* 3 - High Explosive
* 4 - Laser
* 5 - Plasma
* 6 - Stun
* 7 - Melee
* 8 - Acid
* 9 - Smoke
'''NOTE:''' A damage type other than 0-9 will do nothing.
| 0
|-
| '''tuAuto'''
'''accuracyAuto'''
| The percentage (0-100%) of [[Time Units]] (from the soldier's total) required to fire an Auto Shot. If 0, the weapon does not have an Auto Shot.
The base accuracy (0-100%) applied to a soldier's [[Firing Accuracy]] when firing an Auto Shot.
| 0
0
|-
| '''tuSnap'''
'''accuracySnap'''
| The percentage (0-100%) of [[Time Units]] (from the soldier's total) required to fire a Snap Shot. If 0, the weapon does not have a Snap Shot.
The base accuracy (0-100%) applied to a soldier's [[Firing Accuracy]] when firing a Snap Shot.
| 0
0
|-
| '''tuAimed'''
'''accuracyAimed'''
| The percentage (0-100%) of [[Time Units]] (from the soldier's total) required to fire an Aimed Shot. If 0, the weapon does not have an Aimed Shot.
The base accuracy (0-100%) applied to a soldier's [[Firing Accuracy]] when firing an Aimed Shot.
| 0
0
|-
|-
| '''tuMelee'''
'''accuracyMelee'''
| The percentage (0-100%) of [[Time Units]] (from the soldier's total) required to do a melee attack (Hit). If 0, the weapon does not have a melee attack.
The base accuracy (0-100%) applied to a soldier's [[Melee Accuracy]] when doing a melee attack.
| 0
0
|-
| '''clipSize'''
| The amount of ammo stored in each weapon clip. If -1 is specified, this weapon has infinite ammo.
| 0
|-
| '''battleType'''
| Defines the weapon's behavior in the Battlescape:
* 0 - None (Geoscape-only item)
* 1 - [[Weapons|Firearm]]
* 2 - Ammo
* 3 - Melee
* 4 - [[Grenade]]
* 5 - [[Proximity Grenade]]
* 6 - [[Medi-Kit (EU)|Medi-Kit]]
* 7 - [[Motion Scanner]]
* 8 - [[Mind Probe]]
* 9 - [[Psi-Amp]]
* 10 - [[Electro-flare]]
* 11 - Corpse
| 0
|-
| '''twoHanded'''
| Is this weapon two-handed? (incurs an accuracy penalty if used with both hands occupied)
| false
|-
| '''waypoint'''
| Does this weapon use waypoints? (eg. [[Blaster Launcher]]). Can also be used to make ammo items use the waypoint system.
| false
|-
| '''fixedWeapon'''
| Is this weapon fixed? (it's part of a unit, eg. tanks and terrorist units)
| false
|-
| '''invWidth'''
| Item width in a soldier's inventory (in grid units).
| 1
|-
| '''invHeight'''
| Item height in a soldier's inventory (in grid units).
| 1
|-
| '''painKiller'''
| Amount of painkillers contained in a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''heal'''
| Amount of heal's contained in a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''stimulant'''
| Amount of stimulants contained in a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''woundRecovery'''
| Amount of [[Fatal Wounds]] treated by each heal of a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''healthRecovery'''
| Amount of [[Health]] recovered by each heal of a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''stunRecovery'''
| Amount of [[Stun]] removed by each stimulant of a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''energyRecovery'''
| Amount of [[Energy]] recovered by each stimulant of a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''tuUse'''
| Amount of [[Time Units]] required to use this item (for non-offensive items). It's a flat rate if '''flatRate''' is true, otherwise it's a percentage (0-100%).
| 0
|-
| '''recoveryPoints'''
| [[Score]] gained for recovering this alien artifact.
| 0
|-
| '''armor'''
| How much damage is needed to destroy this item on the ground.
| 20
|-
| '''recover'''
| Is this item recoverable? (gets transported to the X-COM base on mission success)
| true
|-
| '''turretType'''
| Sprite ID from [[TANKS.PCK]] of the turret to assign to this tank:
* 0 - [[Tank/Cannon]]
* 1 - [[Tank/Rocket Launcher]]
* 2 - [[Tank/Laser Cannon]]
* 3 - [[Hovertank/Plasma]]
* 4 - [[Hovertank/Launcher]]
| -1
|-
| '''liveAlien'''
| Does this item represent a live alien? (counts towards [[Alien Containment]])
| false
|-
| '''blastRadius'''
| Size of the projectile explosions. 0 for no explosion. -1 to automatically calculate based on weapon power and damage type (actual '''blastRadius''' currently is capped due [[Explosions#Playing_With_Fire|Explosion calculations]]).
| -1
|-
| '''flatRate'''
| If true, then TU costs for this weapon are a flat rate (instead of a percentage of unit TUs).
| false
|-
| '''arcingShot'''
| Does this weapon fire in an arc?
| false
|-
| '''attraction'''
| Represents how likely an alien is to pick up this item. Values below 5 will be ignored (by design).
| 0
|-
| '''maxRange'''
| Maximum range at which this weapon can operate.
| 200
|-
| '''aimRange'''
| Maximum effective range with this weapon before which range-based dropoff occurs.
| 200
|-
| '''snapRange'''
| Maximum effective range with snap shot before which range-based dropoff occurs. (ufoextender accuracy only)
| 15
|-
| '''autoRange'''
| Maximum effective range with auto shot before which range-based dropoff occurs. (ufoextender accuracy only)
| 7
|-
| '''minRange'''
| Range-based dropoff will work in reverse for ranges below this.
| 0
|-
| '''dropoff'''
| The value by which the accuracy lowers for each tile after (or before) the thresholds above.
| 2
|-
| '''bulletSpeed'''
| How much faster (or slower, if you use a negative number) is a projectile fired from this weapon compared to the average.
| 0
|-
| '''autoShots'''
| How many auto shots does this weapon fire.
| 3
|-
| '''shotgunPellets'''
| Number of projectiles fired per unit of ammunition. (note: due to engine limitations it is currently impossible to draw multiple projectiles in flight.)
| 0
|-
| '''zombieUnit'''
| String ID of the unit used for zombification (eg. [[Chrysallid]]s turn units into [[Zombie]]s).
| none
|-
| '''meleeSound'''
| Sound ID from [[#Extra_Sounds|BATTLE.CAT]] played when this weapon attacks a target with melee.
| 39
|-
| '''meleeHitSound'''
| Sound ID from [[#Extra_Sounds|BATTLE.CAT]] played when this weapon HITS a target with melee.
| -1
|-
| '''meleeAnimation'''
| Sprite ID from HIT.PCK played when this weapon attacks a target with melee.
| 0
|-
| '''meleePower'''
| Damage this weapon will do when using melee. This only applies to Firearms, and is only available as stun damage. For normal melee weapons, use regular power and damage types.
| 0
|-
| '''LOSRequired'''
| Does this item require line of sight? (only applies to mind probes and psi-amps)
| false
|-
| '''skillApplied'''
| Is melee skill applied to the accuracy of an attack made with this object?
| true
|-
|}

=== UFOs ===

Defines one of the [[UFOs]] that invade Earth, listed in ''"ufos:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the UFO name.
| ''required''
|-
| '''size'''
| String ID of the UFO size.
| STR_VERY_SMALL
|-
| '''sprite'''
| Sprite ID from [[INTERWIN.DAT]] used to draw this UFO in the dogfight view and UFOpaedia.
don't try to add more images if you don't want to punch yourself in the face - use modsprite
| -1
|-
| '''modSprite'''
| Filename used to draw this UFO in the dogfight view and UFOpaedia.
| -
|-
| '''damageMax'''
| Maximum amount of damage this UFO can take. If the UFO takes 50% damage, it crash lands. If it takes 100% damage, it is destroyed.
| 0
|-
| '''speedMax'''
| Maximum speed in nautical miles.
| 0
|-
| '''accel'''
| Aceeleration value shown in the UFOpaedia.
| 0
|-
| '''power'''
| Damage power of this UFO's weapon in dogfights.
| 0
|-
| '''range'''
| Maximum range of this UFO's weapon in dogfights (in meters).
| 0
|-
| '''score'''
| [[Score]] gained when this UFO is destroyed, or half this score if it crash lands.
| 0
|-
| '''reload'''
| Time the UFO's weapon takes to fire between each shot.
| 0
|-
| '''breakOffTime'''
| Minimum amount of time for the UFO to be able to break off of a dogfight.
| 0
|-
| '''battlescapeTerrainData'''
| [[#Terrains|Terrain]] associated to this UFO in Battlescape missions.
| ''required''
|-
|}

=== Inventory Sections ===

Defines one of the sections of the [[Inventory TU Table|Battlescape inventory]] (eg. Backpack), listed in ''"invs:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the inventory name.
| ''required''
|-
| '''x'''
'''y'''
| Pixel coordinates of this section on the inventory screen.
| 0
0
|-
| '''type'''
| Type of this section:
* 0 = Slot section, can contain as many items as will fit on the slots.
* 1 = Hand section, can only contain one item regardless of size.
* 2 = Ground section, can contain infinite items.
| 0
|-
| '''slots'''
| List of the grid slots (''[x, y]'') that this section is composed of. For example, to make a 2x2 section, you would have ''[0, 0] [0, 1] [1, 0] [1, 1]''.
| -
|-
| '''costs'''
| List of [[Time Units]] costs to move an item from this section to another one (eg. ''STR_BACKPACK: 16'' means it will cost 16 TUs to move an item from this section to the Backpack).
| -
|-
|}

=== Terrains ===

Defines one of the [[TERRAIN|terrains]] used to generate a Battlescape map, listed in "terrains:".

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''name'''
| String ID of the terrain name.
| ''required''
|-
| '''largeBlockLimit'''
| Maximum amount of large blocks that can be used on map generation.
| 0
|-
| '''textures'''
| List of [[TEXTURE.DAT|Geoscape textures]] that correspond to this terrain.
| -
|-
| '''hemisphere'''
| Geoscape hemisphere associated with this terrain:
* -1 - Northern hemisphere.
* 0 - Both hemispheres.
* 1 - Southern hemisphere.
| 0
|-
| '''mapDataSets'''
| List of filenames (each with matching [[MCD]]/[[Image Formats#PCK|PCK/TAB]] files) that contain the tiles of this terrain.
| -
|-
| '''mapBlocks'''
| List of map blocks (see below) that are used for generating a map.
| -
|-
| '''roadTypeOdds'''
| Odds as a % of generating each type of road (E-W Road, N-S Road, Crossing) odds for crossing are: 100 - EW - NS.
| [0 0]
|-|-
| '''civilianTypes'''
| List of units to use as civilians for this mission.
| [MALE_CIVILIAN, FEMALE_CIVILIAN]
|-
|}

==== Map Blocks ====

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''name'''
| Filename of the [[MAPS|map]].
| ''required''
|-
| '''width'''
| Width of this map block in Battlescape grid units.
| 0
|-
| '''length'''
| Length of this map block in Battlescape grid units.
| 0
|-
| '''height'''
| Height of this map block in Battlescape grid units.
| 1
|-
| '''type'''
| Type of this map block:
* -1 - Undefined
* 0 - Default
* 1 - Landing Zone (for placing X-COM / alien craft)
* 2 - E-W Road (for city maps)
* 3 - N-S Road (for city maps)
* 4 - Road Crossing (for city maps)
* 5 - Dirt (for filling empty base blocks)
* 6 - X-COM spawn point (for [[Alien Base]] / [[Cydonia]] missions)
* 7 - [[Alien Base]] Target
* 8 - [[Cydonia]] Target
| -1
|-
| '''subType'''
| Sub-type of this map block (see '''type''').
| -1
|-
| '''frequency'''
| Frequency of this block in a map.
| 1
|-
| '''maxCount'''
| Maximum amount of times this block can be used in a map. If -1 there is no limit.
| -1
|-
| '''items'''
| An array of items to add to this mapblock, an the positions to place them at.
| -1
|}

*'''frequency''' defines the odds of the map appearing on the map
** The value assigned (default: 1) is used in ''x/n'', which defines the probability of being chosen.
** ''x'' is the integer defined for the map block's frequency and ''n'' is the combined total of probabilities for all the map types combined.
** This property can only be used in type 0 map blocks.
*'''maxCount''' is the maximum number of times it can be used.
** The value assigned is also used in ''x/n'' to determine the probability of being chosen.
** Each use reduces ''x'' by -1, with the caveat that being used as a Landing Zone type will not reduce the x value since it could result in no available Landing Zones.
** This property can only be used in type 0 map blocks.
* '''hemisphere''' only applies to UFO missions, not Terror ones.
*'''width/length''' defines the size of the map
** be aware that the mapview "width"-label is the openxcom ruleset length parameter
** be aware that the mapview "length"-label is the openxcom ruleset width parameter

==== Guidelines/Tips ====
* All maps with an XCOM/Alien craft require at least one type 1 map block. This map block can only contain ground tiles (no walls or objects), otherwise the game will crash or the walls/objects will be removed.
* All Terror terrains (listed under STR_TERROR_MISSION) require at least 1 map block of '''Types''' 2, 3 and 4 (for a total of 3 maps, which are required to place roads) and the corresponding '''roadTypeOdds''' added to the ruleset.
* If there isn't any map blocks designed as roads since you want to keep your terrain 'random', this can be circumvented by designating all 10x10 map blocks, excluding the one(s) used for the XCOM craft, as either '''Type''' 2, 3 and 4 and by defining their '''subType''' to 0. The game will then randomly choose between the map blocks for each type used in the roads, making them map more random.

=== Armor ===

Defines a Battlescape unit's [[armor]] as well as visual representation (so every unit has an armor), listed in ''"armors:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the armor name.
| ''required''
|-
| '''spriteSheet'''
| Sprite sheet from [[UNITS]] used to draw a unit wearing this armor.
| -
|-
| '''spriteInv'''
| Sprite used for the [[Inventory Backgrounds]] of a unit wearing this armor.
| -
|-
| '''corpseBattle'''
| List of string IDs of the corpse [[#Items|items]] generated when a unit wearing this armor is killed (one per unit tile) on the Battlescape.
| -
|-
| '''corpseGeo'''
| String ID of the corpse [[#Items|item]] associated with this unit on the Geoscape.
| -
|-
| '''storeItem'''
| String ID of the [[#Items|item]] that represents this armor in [[Base Stores]] for equipping.
| -
|-
| '''weight'''
| Physical weight of the armor when worn
| 6
|-
| '''stats'''
| like soldier stats (see below) but these are treated as stat bonuses for wearing the specific armor.
| -
|-
| '''frontArmor'''
| Protection provided on the front of the unit.
| 0
|-
| '''sideArmor'''
| Protection provided on the sides of the unit.
| 0
|-
| '''rearArmor'''
| Protection provided on the rear of the unit.
| 0
|-
| '''underArmor'''
| Protection provided under the unit (eg. from explosions).
| 0
|-
| '''drawingRoutine'''
| Drawing routine used to put together the body parts in the unit's '''spriteSheet''':
* 0 = [[Soldier]], [[Sectoid]]
* 1 = [[Floater]]
* 2 = [[HWP]]
* 3 = [[Cyberdisk]]
* 4 = [[Civilian]], [[Ethereal]]
* 5 = [[Sectopod]], [[Reaper]]
* 6 = [[Snakeman]]
* 7 = [[Chryssalid]]
* 8 = [[Silacoid]]
* 9 = [[Celatid]]
* 10 = [[Muton]]
| 0
|-
| '''movementType'''
| Type of movement provided by this armor:
* 0 = Walking
* 1 = Flying
* 2 = Sliding (no walking animation)
it also defines the body of an tank (32-images) in your spriteSheet or the change in sprites while flying using a flying armour see: [[TANKS.PCK]], [[XCOM_2.PCK]]
| 0
|-
| '''damageModifier'''
| List of decimal damage modifiers (1.0 = 100%) this armor applies to each damage type (see [[#Items|Items section]]) received. Modifiers must be specified for all damage types, in this order:
* None
* Armor Piercing
* Incendiary
* High Explosive
* Laser
* Plasma
* Stun
* Melee
* Acid
* Smoke
|
- 1.0 
- 1.0 
- 1.0 
- 1.0 
- 1.0 
- 1.0 
- 1.0 
- 1.0 
- 1.0 
- 1.0
|-
| '''size'''
| Size of the unit wearing this armor, in Battlescape grid units. Every unit is square, so a size of 2 means 2x2.
| 1
|-
| '''loftempsSet'''
| List of [[LOFTEMPS]] IDs (one per unit tile, so a 1x1 unit has 1, a 2x2 unit has 4, etc.) used to represent a unit wearing this armor in 3D space.
| -
|-
| '''loftemps'''
| loftemps is a deprecated option that only works for 1x1 sized units.
| -
|}

=== Player Units (Soldiers) ===

Defines a [[soldier]] recruited by X-COM, listed in ''"soldiers:"''. Currently only one soldier unit type (''XCOM'') is supported.

Unit stats are represented as follows:
* [[Time Units|tu]]
* [[Energy|stamina]]
* [[Health|health]]
* [[Bravery|bravery]] (always a multiple of 10)
* [[Reactions|reactions]]
* [[Firing Accuracy|firing]]
* [[Throwing Accuracy|throwing]]
* [[Strength|strength]]
* [[Psi Strength|psiStrength]]
* [[Psi Skill|psiSkill]]
* [[Melee Accuracy|melee]] (not visible)

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the soldier name.
| ''required''
|-
| '''minStats'''
| Minimum values used to generate the soldier's [[Starting Stats]]. In this case, ''psiSkill'' is treated as the initial stat (not generated).
| -
|-
| '''maxStats'''
| Maximum values used to generate the soldier's [[Starting Stats]]. In this case, ''psiSkill'' is treated as the minimum value for the first month of psi training (actual value is 100%-150%).
| -
|-
| '''statCaps'''
| Maximum stats this soldier can gain through [[Experience]]. '''NOTE:''' A stat will still go over the limit once, and then will no longer increase (see [[Experience#Regarding Caps|Regarding Caps]]).
| -
|-
| '''armor'''
| String ID of the [[#Armor|armor]] this soldier uses by default.
| -
|-
| '''standHeight'''
| Height of this soldier when standing.
| 0
|-
| '''kneelHeight'''
| Height of this soldier when kneeling.
| 0
|-
| '''floatHeight'''
| Distance between the bottom of this unit and the ground.
| 0
|}

=== AI Units (Aliens/Civilians) ===

Defines an [[Alien Life Forms|alien]] (enemy) or [[civilian]] (neutral) unit, listed in ''"units:"''. Every different alien rank is a different unit, since they have completely different stats. Unit stats are represented as follows:
* [[Time Units|tu]]
* [[Energy|stamina]]
* [[Health|health]]
* [[Bravery|bravery]] (always a multiple of 10)
* [[Reactions|reactions]]
* [[Firing Accuracy|firing]]
* [[Throwing Accuracy|throwing]]
* [[Strength|strength]]
* [[Psi Strength|psiStrength]]
* [[Psi Skill|psiSkill]]
* [[Melee Accuracy|melee]] (not visible)

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the unit name.
| ''required''
|-
| '''race'''
| String ID of the unit race (for alien units).
| -
|-
| '''rank'''
| String ID of the unit rank (for alien units).
| -
|-
| '''stats'''
| Battlescape stats of this unit.
| -
|-
| '''armor'''
| String ID of the [[#Armor|armor]] this unit uses by default.
| -
|-
| '''standHeight'''
| Height of this unit when standing.
| 0
|-
| '''floatHeight'''
| Distance between the bottom of this unit and the ground.
| 0
|-
| '''value'''
| [[Score]] this unit is worth.
| 0
|-
| '''deathSound'''
| Sound ID from [[#Extra_Sounds|BATTLE.CAT]] played when this unit dies.
| -1
|-
| '''aggroSound'''
| Sound ID from [[#Extra_Sounds|BATTLE.CAT]] played when this unit aggros.
| -1
|-
| '''moveSound'''
| Sound ID from [[#Extra_Sounds|BATTLE.CAT]] played when this unit moves.
| -1
|-
| '''intelligence'''
| Intelligence of this unit's AI. The higher the value, the longer this unit remembers player troops between turns.
| 0
|-
| '''aggression'''
| Aggression of this unit's AI. The higher the value, the more ruthless the unit, the more likely to make a frontal assault. Less aggressive units tend to set up ambushes.
Vanilla values are:
* 0 = mostly passive
* 1 = balanced
* 2 = mostly aggresive
| 0
|-
| '''energyRecovery'''
| Energy recovered by the unit each turn (needs verification)
| 40 (?)
|-
| '''specab'''
| Special ability of this unit:
* 0 = None
* 1 = [[Cyberdisc|Explodes on Death]]
* 2 = [[Bio-Drone|Burns Floor]]
* 3 = [[Zombie|Respawns on Death]]
| 0
|-
| '''spawnUnit'''
| String ID of the unit used to respawn on death (eg. [[Zombie]]s respawn as [[Chrysallid]]s).
| -
|-
| '''livingWeapon'''
| Is this unit a living weapon? (only attacks with a '''fixedWeapon''')
| false
|-
|}

=== Alien Races ===

Defines a [[Alien Life Forms|race]] used in [[Alien Missions]], listed in ''"alienRaces:"''. Heavily tied with deployment data.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''id'''
| String ID of the alien race name.
| ''required''
|-
| '''members'''
| Alien crew associated with this alien race (eg. race units + terrorist units), defined by a list of unit string IDs. Order here will define rank in terms of deployment. generally speaking the order is:
* 0 - Commander
* 1 - Leader
* 2 - Engineer
* 3 - Medic
* 4 - Navigator
* 5 - Soldier
* 6 - Terrorist 1
* 7 - Terrorist 2
but of course, not all races have all ranks, so the "fill in" rank would be listed multiple times (see ethereals).
|-
| '''retaliation'''
| retaliation enables/disables the race for retaliation missions.
| ''True''
| -
|}

=== Alien Deployments ===

Defines a Battlescape deployment data used in [[Alien Missions]] (such as alien and map configurations), listed in ''"alienDeployments:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the deployment name.
| ''required''
|-
| '''width'''
| Width of the Battlescape map in grid units.
| 0
|-
| '''length'''
| Length of the Battlescape map in grid units.
| 0
|-
| '''height'''
| Vertical height of the Battlescape map in grid units.
| 0
|-
| '''terrains'''
| list of string IDs of the [[#Terrains|terrain]] to choose from to generate this map. This is not used for UFO sites where the terrain comes from the Geoscape.
| -
|-
| '''shade'''
| Shade of the map (0-15, where 0 is full daytime and 15 is full nighttime). This is not used for UFO sites where the shade comes from the Geoscape.
| 0
|-
| '''nextStage'''
| String ID of the next deployment stage to use after this one, for multi-stage missions.
| -
|-
| '''data'''
| List of deployment data for each alien rank on this mission (see below).
| -
|}

Notes:
* '''terrains''' can also be used with UFOs, with the game using instead the listed terrain rather than the location of the UFO on Geoscape.
==== Deployment Data ====

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''alienRank'''
| [[Alien Rank|Rank]] associated with this deployment data, as defined by the order of the race in question (see above)
| ''required''
|-
| '''lowQty'''
| Maximum quantity of aliens to spawn (beginner).
| 0
|-
| '''highQty'''
| Maximum quantity of aliens to spawn (superhuman).
| 0
|-
| '''dQty'''
| Minimum Desired Quantity of aliens to spawn.
| 0
|-
| '''percentageOutsideUfo'''
| Percentage (0-100%) of aliens to spawn outside in UFO sites.
| 0
|-
| '''itemSets'''
| Three lists (one for each alien technology level) of [[#Items|items]] (string IDs) for the aliens to equip.
| ''required''
|-
|}

=== Research ===

Defines a [[Research|research topic]] that X-COM scientists can investigate, listed in ''"research:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''name'''
| String ID of the research project's name (or item, if a '''lookup''' is defined).
| ''required''
|-
| '''lookup'''
| String ID of the research project's display name and UFOPaedia article reference.
| -
|-
| '''cost'''
| Number of man hours (on average) required to complete this project.
| 0
|-
| '''points'''
| [[Score]] earned for completing this project.
| 0
|-
| '''needItem'''
| Does this project require an [[#Items|item]] of the same name?
| false
|-
| '''dependencies'''
| List of research projects that can unlock access to this one. If the full list is researched, or if one of the projects on the list "unlocks" this one, it becomes available.
| -
|-
| '''unlocks'''
| List of research projects unlocked, regardless of other dependencies, but not requirements, by completing this project (for example, any live alien unlocks "alien origins").
| -
|-
| '''requires'''
| List of research projects unilaterally required before this project can be unlocked (for example, "the martian solution" will not even be considered for unlocking until AFTER "alien origins" is completed).
| -
|-
| '''getOneFree'''
| List of "bonus" research projects that may be granted when completing this project (for example, alien medics will give you information on other alien races). Only applies to living aliens.
| -
|-
|}

=== Manufacture ===

Defines a [[Manufacture|manufacture project]] that X-COM engineers can produce, listed in ''"manufacture:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''name'''
| String ID of the manufacturing project's name (and the item it produces).
| ''required''
|-
| '''category'''
| String ID of the manufacturing project's category.
| -
|-
| '''requires'''
| List of [[#Research|topics]] (string IDs) that must be researched to unlock this project. If none are specified, this project is unlocked from the start.
| -
|-
| '''space'''
| Amount of [[Workshop]] space required to begin this project.
| 0
|-
| '''time'''
| Number of man hours (on average) required per item.
| 0
|-
| '''cost'''
| Monetary deduction per item manufactured.
| 0
|-
| '''requiredItems'''
| List of [[#Items|items]] required and consumed per item manufactured.
| -
|-
| '''producedItems'''
| List of [[#Items|items]] produced per each item consumed. If not specified, defaults to 1 item with the same string ID as the manufacture.
| 1
|-
|}

=== UFOpaedia Article ===

Defines an article in the in-game [[UFOpaedia]], listed in ''"ufopaedia:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''id'''
| String ID of the article name. This must match the ID of the object associated with this article, if applicable.
| ''required''
|-
| '''title'''
| String ID of the article title. If omitted, the '''id''' is used.
| -
|-
| '''type_id'''
| Type of this article:
* 0 = Unknown
* 1 = [[Craft]]
* 2 = [[Craft Armaments]]
* 3 = [[HWP]]
* 4 = [[Equipment (EU)|Equipment]]
* 5 = [[Armour]]
* 6 = [[Base Facilities]]
* 7 = Text & Image (eg. [[Alien Life Forms]], [[UFO Components]])
* 8 = Text (eg. [[Alien Research]])
* 9 = [[UFO]]
| 0
|-
| '''section'''
| String ID of the UFOpaedia section this article belongs in.
| -
|-
| '''requires'''
| List of [[#Research|topics]] (string IDs) that must be researched to unlock this article. If none are specified, this article is unlocked from the start.
| -
|-
| '''image_id'''
| Filename of the [[UP001.SPK-UP042.SPK|background image]] displayed on this article, if applicable.
| -
|-
| '''text'''
| String ID of the description displayed on this article.
| -
|-
| '''text_width'''
| Maximum width of the text displayed, only applicable to ''Text & Image'' articles.
| 0
|-
| '''rect_stats'''
| Rectangle ('''x''', '''y''', '''width''', '''height''') of the stats text on the screen, only applicable to ''Craft'' articles.
| 0
|-
| '''rect_text'''
| Rectangle ('''x''', '''y''', '''width''', '''height''') of the description text on the screen, only applicable to ''Craft'' articles.
| 0
|-
| '''weapon'''
| String ID of the weapon, only applicable to ''HWP'' articles.
| -
|}

=== UFO Trajectories ===

Defines a trajectory carried out by an UFO during an [[#Alien Missions|alien mission]], listed in ''"ufoTrajectories:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''id'''
| String ID of the trajectory name.
| ''required''
|-
| '''groundTimer'''
| Amount of seconds for the UFO to spend on Ground waypoints.
| 0
|-
| '''waypoints'''
| List of waypoints for the UFO to traverse, defined as ''[zone, altitude, speed]''. 
'''zone''': Globe zone where the waypoint is located. 
'''altitude''': UFO altitude after reaching this waypoint:
* 0 - Ground
* 1 - Very Low
* 2 - Low
* 3 - High
* 4 - Very High
'''speed''': UFO speed after reaching this waypoint, as a percentage (0-100%) of its maximum speed.
| -
|}

=== Alien Missions ===

Defines an [[Alien Missions|alien mission]] carried out by UFOs on the Geoscape, listed in ''"alienMissions:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the mission type.
| ''required''
|-
| '''points'''
| [[Score]] allocated to aliens for successfully completing this mission.
| 0
|-
| '''raceWeights'''
| List of alien races likely to carry out this mission, and the % chance of them being allocated to this mission, listed by "number of months after game beginning".
| ''required''
|-
| '''waves'''
| List of UFO waves to spawn as this mission progresses, as described below.
| ''required''
|}

==== Waves ====

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''ufo'''
| String ID of the [[#UFOs|UFO]] to spawn.
| ''required''
|-
| '''count'''
| Number of UFOs to spawn.
| 0
|-
| '''trajectory'''
| String ID of the [[#UFO Trajectories|trajectory]] for this UFO to use when entering Earth's atmosphere.
| ''required''
|-
| '''timer'''
| How long after the previous wave should this wave arrive? (in seconds)
| 0
|-
|}

=== Alien Item Levels ===

This is a list of item level probabilities, with a number between 0 and 2 representing an item level from plasma pistols to heavy plasmas, as defined in the deployments, expressing a 10% probability for that item level being used.

0 = first set (plasma pistol/clip)
1 = second set (plasma rifle/clip)
2 = third set (heavy plasma/clip)

For example:
[ 2, 0, 0, 0, 0, 0, 0, 1, 1, 1 ]
would represent a 60% chance for pistols, 30% rifles, and 10% heavy weapons. 
Note that the order does not matter, but the length DOES. each line MUST have 10 digits.

The above can be confusing. There are 10 fields; each number represents 10%. 
There is only one instance of '2'. 1x10% = 10% chance of plasma pistol 
There are three instances of '1'. 3x10% = 30% chance of plasma rifle 
There are six instances of '0'. 6x10% = 60% chance of heavy plasma 

Each line represents a month after the beginning of the game, and there is no limit to the number defined. 
OpenXCom will use the most recently available item level in the event the game goes on forever.

=== Extra Sprites ===

Adds or replaces sprites in an existing [[Image Formats|X-COM image file]], listed in ''"extraSprites:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| Filename of the original/new image to modify.
| ''required''
|-
| '''width'''
'''height'''
| Size of the sprite(s) in pixels.
| 0
0
|-
| '''singleImage'''
| Is the image file just a single sprite (true) or a spritesheet (false)?
| false
|-
| '''subX'''
'''subY'''
| Size of the subdivision in pixels. If a subdivision is specified, then the image file is divided into chunks to form the sprites (eg. spritesheets).
| 0
0
|-
| '''files'''
| List of the new sprites to add/replace, listed as ''spriteID: filename''.
| -
|}

Example:
- type: GIANTBUNNY.PCK
width: 32
height: 40
files:
0: Resources/Bunny/Bunny00.png
1: Resources/Bunny/Bunny01.bmp
2: Resources/Bunny/Bunny02.gif

=== Extra Sounds ===

Adds or replaces sounds in an existing [[SOUND|X-COM sound file]], listed in ''"extraSounds:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| ID of the original sound file to modify:
* BATTLE.CAT - Battlescape sounds, corresponds to ''SOUND1.CAT'' or ''SAMPLE2.CAT'' (55 sounds).
* INTRO.CAT - Intro sounds, corresponds to ''INTRO.CAT'' or ''SAMPLE3.CAT'', probably best not to mess with these.
* GEO.CAT - Geoscape sounds, corresponds to ''SOUND2.CAT'' or ''SAMPLE.CAT'' (14 sounds).
| ''required''
|-
| '''files'''
| List of the new sounds to add/replace, listed as ''soundID: filename''.
| -
|}

Example:
- type: BATTLE.CAT
files:
55: Resources/Sounds/sample.wav

=== Extra Strings ===

Adds or replaces text strings in an existing [[Translations (OpenXcom)|OpenXcom language file]], listed in ''"extraStrings:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| Filename of the original language file to modify, sans extension.
| ''required''
|-
| '''strings'''
| List of the new strings to add/replace, listed as ''stringID: text''.
| -
|}

Example:
- type: en-US
strings:
STR_SNIPER_RIFLE: Sniper Rifle
STR_SNIPER_RIFLE_CLIP: Sniper Rifle Clip
- type: en-GB
strings:
STR_SNIPER_RIFLE: Sniper Rifle
STR_SNIPER_RIFLE_CLIP: Sniper Rifle Clip
- type: de
strings:
STR_SNIPER_RIFLE: Scharfschützengewehr
STR_SNIPER_RIFLE_CLIP: Scharfschützengewehrmunition
- type: ru
strings:
STR_SNIPER_RIFLE: Снайперская винтовка
STR_SNIPER_RIFLE_CLIP: Магазин к снайп. винтовке

=== Interfaces ===

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| ''?''
| -
|-
| '''elements'''
| ''?''
| -
|-
| '''id'''
| ''?''
| -
|-
| '''color'''
| ''?''
| -
|}

=== StatStrings ===

[[Statstrings]] are used for automatically renaming soldiers. They are case sensitive and they are processed in the order in which they are specified.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''string'''
| String to add to name.
| ''required''
|-
| '''psiStrength''' 
'''psiSkill''' 
'''bravery''' 
'''strength''' 
'''firing''' 
'''reactions''' 
'''stamina''' 
'''tu''' 
'''health''' 
'''throwing'''
| One or more stat ranges are ANDed together for success. Each range has a minVal and maxVal. Use YAML standard tilde (~) to indicate null.
| -
|}

Example:
statStrings:
- string: "x"
psiStrength: [~, 30]
- string: "P"
psiStrength: [80, ~]
- string: "p"
psiStrength: [60, 79]
- string: "K"
psiSkill: [60, ~]
- string: "k"
psiSkill: [30, 59]
- string: "b"
bravery: [60, ~]
- string: "c"
bravery: [~, 10]
- string: "w"
strength: [~, 25]
- string: "Snpr"
firing: [60, ~]
reactions: [60, ~]
- string: "M"
firing: [70, ~]
- string: "m"
firing: [60, 69]
- string: "Sct"
reactions: [50, ~]
tu: [60, ~]
- string: "R"
reactions: [60, ~]
- string: "r"
reactions: [50, 59]

==References==
<references />

[[Category:OpenXcom]]

Ruleset Reference (OpenXcom)

2014-09-01T02:51:10Z

Falko: should now be more clear what type the extrrasounds need instead of sound/sample....cat

A reference of all the customizable values of everything in a [[Rulesets (OpenXcom)|ruleset]]. Some guidelines:
* If a value is omitted from the ruleset, the default is used. You cannot omit ''required'' values.
* Text strings (eg. names) are represented by string IDs from the [[Translations (OpenXcom)|language files]]
* Numerical IDs (used for sprites, sounds, etc.) start at 0, not 1.
* Boolean (yes/no) values are represented by true/false.
* World coordinates are represented in degrees (see [[WORLD.DAT]]).
* Money amounts (prices, costs, etc.) are represented in dollars.
* All paths are '''case sensitive'''! If your ruleset uses external files, make sure that they named properly as described in ruleset.

Items are ordered as they come in the ruleset. To override this, you can specify a ''listOrder''. You can find the default listOrders in [[Ruleset List Order (OpenXcom)|Ruleset List Order]].

=== Globe ===

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''data'''
| ''path name of ?.''
| ''required''
|-
| '''polylines'''
| ''?''
| -
|}

=== Countries ===

Defines one of the [[Country Funding (EU)|funding nations]], listed in ''"countries:"''. They're used for activity graphs and player scoring.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the country name.
| ''required''
|-
| '''fundingBase'''
| Country's base funding, in thousands. The starting funding can be anywhere between 1x and 2x the base funding.
| 0
|-
| '''fundingCap'''
| Country's funding cap, in thousands. Once a country reaches this maximum, it will no longer increase its funding.
| 0
|-
| '''labelLon'''
'''labelLat'''
| Longitude and latitude coordinates of the country's label on the globe. This label is only shown when the globe is zoomed in and "detail" is turned on.
| 0.0
0.0
|-
| '''areas'''
| List of "rectangles" on the globe defined as [''lon1'' ''lat1'' ''lon2'' ''lat2'']. Any activity within these areas counts towards the country's graph activity and affects their opinion of the player.
| -
|}

=== Regions ===

Defines one of the [[Geoscape (EU)#World Regions/Countries|world regions]], listed in ''"regions:"''. They're used for base placement, activity graphs and mission spawning.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the region name.
| ''required''
|-
| '''cost'''
| Amount of money spent building an X-COM base in this region (first base is free).
| 0
|-
| '''areas'''
| List of "rectangles" on the globe defined as ''[lon1, lat1, lon2, lat2]''. Any activity within these areas counts towards the region's graph activity.
| -
|-
| '''cities'''
| List of cities belonging to this region. They will be displayed on the globe and used for terror site missions. Each city is defined by their '''lon''' and '''lat''' coordinates and a '''name''' string ID.
| -
|-
| '''regionWeight'''
| Weight of this region when selecting regions for alien missions.
| 0
|-
| '''missionWeights'''
| Weighted list of the different mission types for this region (eg. ''STR_ALIEN_RESEARCH: 14'').
| -
|-
| '''missionZones'''
| List of "rectangles" (''[lon1, lat1, lon2, lat2]'') defining the mission zones for this region.
| -
|-
| '''missionRegion'''
| Spawn mission in this region instead (used for regions without land).
| -
|}

=== Base Facilities ===

Defines one of the [[Base Facilities (EU)|facilities]] that can be built in an X-COM base, listed in ''"facilities:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the facility name.
| ''required''
|-
| '''requires'''
| List of [[#Research|topics]] (string IDs) that must be researched to unlock this facility. If none are specified, this facility is unlocked from the start.
| -
|-
| '''spriteShape'''
| Sprite ID from [[BASEBITS.PCK]] used to draw the facility's outer shape in the Basescape and UFOpaedia.
| -1
|-
| '''spriteFacility'''
| Sprite ID from [[BASEBITS.PCK]] used to draw the facility's contents in the Basescape and UFOpaedia. Drawn on top of '''spriteShape'''.
| -1
|-
| '''lift'''
| Is this facility an [[Access Lift]]? All base facilities must be connected to the lift.
| false
|-
| '''hyper'''
| Is this facility a [[Hyperwave Decoder]]? Displays extra information for detected UFOs. Only valid for radar facilities.
| false
|-
| '''mind'''
| Is this facility a [[Mind Shield]]? Reduces the chance of UFOs finding your base. Does not stack.
| false
|-
| '''grav'''
| Is this facility a [[Grav Shield]]? Doubles the power of your base defenses. Does not stack.
| false
|-
| '''size'''
| Size of the facility, in grid units. Every facility is square, so a size of 1 means 1x1, 2 means 2x2, etc. Bigger facilities are made up of multiple sprites, for example a 2x2 facility will use 4 sprites for '''spriteShape''' and 4 sprites for '''spriteFacility''' (top-left, top-right, bottom-left, bottom-right).
| 1
|-
| '''buildCost'''
| Amount of money spent to build this facility in the base.
| 0
|-
| '''buildTime'''
| Amount of days it takes for this facility to be built.
| 0
|-
| '''monthlyCost'''
| Amount of money spent monthly for the maintenance of this facility.
| 0
|-
| '''storage'''
| Amount of storage space (for items) this facility provides. See [[Base Stores]].
| 0
|-
| '''personnel'''
| Amount of personnel (soldiers, scientsts, engineers) these quarters can contain.
| 0
|-
| '''aliens'''
| Amount of live aliens this facility can contain. Only checked if the ''alienContainmentLimitEnforced'' option is enabled.
| 0
|-
| '''crafts'''
| Amount of X-COM craft this facility can contain.
| 0
|-
| '''labs'''
| Amount of lab space this facility provides for research projects.
| 0
|-
| '''workshops'''
| Amount of workshop space this facility provides for manufacture projects.
| 0
|-
| '''psiLabs'''
| Amount of soldier space this facility provides for psionic training.
| 0
|-
| '''radarRange'''
| Maximum radar detection range of this facility, in nautical miles.
| 0
|-
| '''radarChance'''
| Chance (0-100%) of this radar detecting a UFO that enters its range.
| 0
|-
| '''defense'''
| Offensive power provided by this base defense against attacking UFOs.
| 0
|-
| '''hitRatio'''
| Chance (0-100) of the base defense hitting an attacking UFO.
| 0
|-
| '''fireSound'''
| Sound ID from [[#Extra_Sounds|GEO.CAT]] played when the base defense fires.
| -1
|-
| '''hitSound'''
| Sound ID from [[#Extra_Sounds|GEO.CAT]] played when the base defense hits a target.
| -1
|-
| '''mapName'''
| [[MAPS|Map]] associated to this facility in Battlescape base defenses.
| -
|-
|}

=== Crafts ===

Defines one of the [[Craft|X-COM crafts]] that go on interception missions, listed in ''"crafts:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the craft name.
| ''required''
|-
| '''requires'''
| List of [[#Research|topics]] (string IDs) that must be researched to unlock this craft. If none are specified, this craft is unlocked from the start.
| -
|-
| '''sprite'''
| Sprite ID from [[BASEBITS.PCK]] used to draw this craft in the Basescape and from [[INTICON.PCK]] used to draw the damage indicator in dogfights.
modders: the corresponding extrasprite file id for BASEBITS.PCK is sprite+33 INTICON.PCK contains a minimized icon id=sprite the file id for the dogfight image is sprite+11
| -1
|-
| '''fuelMax'''
| Maximum amount of fuel this craft can carry. Crafts use up fuel based on their speed while travelling.
| 0
|-
| '''damageMax'''
| Maximum amount of damage this craft can take. If this amount is exceeded, the craft is destroyed.
| 0
|-
| '''speedMax'''
| Maximum speed in nautical miles. Crafts travel at max speed when flying and half speed when patrolling.
| 0
|-
| '''accel'''
| Aceeleration value shown in the UFOpaedia.
| 0
|-
| '''weapons'''
| Amount of craft weapons this craft can equip. The UI can only display a max of 2 weapons.
| 0
|-
| '''soldiers'''
| Amount of soldiers this craft can carry.
| 0
|-
| '''maxItems'''
| Amount of items this craft can carry.
| 80
|-
| '''vehicles'''
| Amount of vehicles this craft can carry.
| 0
|-
| '''costBuy'''
| Amount of money spent for purchasing this craft. If set to 0, the craft will not be available in the Purchase/Recruit screen.
| 0
|-
| '''costRent'''
| Amount of money spent monthly for renting this craft. If set to 0, the craft is not on rental and won't count towards base maintenance.
| 0
|-
| '''costSell'''
| Amount of money gained for selling this craft.
| 0
|-
| '''refuelItem'''
| Item required for refuelling this craft. If no item is specified, the craft uses human fuel.
| 0
|-
| '''repairRate'''
| Amount of damage restored every hour while [[Repairs|Repairing]] in base.
| 1
|-
| '''refuelRate'''
| Amount of fuel restored every 30 mins while [[Refueling]] in base. If specified, a '''refuelItem''' is spent each time.
| 1
|-
| '''radarRange'''
| Detection range of the craft's radar in nautical miles. Every craft radar has a 100% detection chance.
| 600
|-
| '''transferTime'''
| Number of hours it takes to purchase/transfer this craft to a base.
| 0
|-
| '''score'''
| [[Score]] lost when this craft is destroyed.
| 0
|-
| '''spacecraft'''
| Can this craft go to [[Cydonia]]?
| false
|-
| '''battlescapeTerrainData'''
| [[#Terrains|Terrain]] associated to this craft in Battlescape missions.
| -
|}

=== Craft Weapons ===

Defines one of the [[Craft Armaments|weapons]] equipped by X-COM craft for shooting down UFOs, listed in ''"craftWeapons:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the weapon name.
| ''required''
|-
| '''sprite'''
| Sprite ID from [[BASEBITS.PCK]] used to draw the weapon in the Basescape and from [[INTICON.PCK]] used to draw the weapon in dogfights.
modders: the corresponding extrasprites file id for INTICON.PCK is sprite+5 and sprite+48 for BASEBITS.PCK
| -1
|-
| '''sound'''
| Sound ID from [[#Extra_Sounds|GEO.CAT]] played when this weapon fires.
| -1
|-
| '''damage'''
| Amount of damage this weapon does to enemy UFOs.
| 0
|-
| '''range'''
| Maximum range of this weapon in dogfights (in meters).
| 0
|-
| '''accuracy'''
| Chance (0-100%) of each shot hitting the enemy UFO.
| 0
|-
| '''reloadCautious'''
| Time this weapon takes to fire between each shot in ''Cautious Mode''.
| 0
|-
| '''reloadStandard'''
| Time this weapon takes to fire between each shot in ''Standard Mode''.
| 0
|-
| '''reloadAggressive'''
| Time this weapon takes to fire between each shot in ''Aggressive Mode''.
| 0
|-
| '''ammoMax'''
| Maximum amount of ammo this weapon can carry.
| 0
|-
| '''rearmRate'''
| Amount of ammo restored every 30 mins while the craft is [[Rearming]] in base. If specified, '''clip'''s are spent depending on their '''clipSize'''. If the '''clipSize''' of the specified ammo is 0, no '''clip'''s are spent.
| 1
|-
| '''projectileType'''
| Type of the weapon projectile, used for the projectile sprite in dogfights:
* 0 - [[Stingray]]
* 1 - [[Avalanche]]
* 2 - [[Cannon]]
* 3 - [[Fusion Ball]]
* 4 - [[Laser Cannon]]
* 5 - [[Plasma Beam]]
| 2
|-
| '''projectileSpeed'''
| Speed of the weapon projectile in dogfights.
| 0
|-
| '''launcher'''
| String ID of the [[#Items|item]] required to equip this weapon.
| -
|-
| '''clip'''
| String ID of the [[#Items|item]] required to rearm this weapon.
| -
|}

=== Items ===

Defines the Geoscape and Battlescape properties of an [[Equipment (EU)|item]] that can be stored in X-COM bases, listed in ''"items:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the internal item name.
| ''required''
|-
| '''name'''
| String ID of the displayed item name, for cases where it's different from the internal name. If omitted, '''type''' is used.
| -
|-
| '''requires'''
| List of [[#Research|topics]] (string IDs) that must be researched to unlock this item. If none are specified, this item is unlocked from the start. Soldiers can only use unlocked items in the Battlescape.
| -
|-
| '''size'''
| Space occupied by this item in [[Base Stores]]. Can be a decimal value.
| 0.0
|-
| '''costBuy'''
| Amount of money spent for purchasing this item. If set to 0, this item will not be available in the Purchase/Recruit screen.
| 0
|-
| '''costSell'''
| Amount of money gained for selling this item.
| 0
|-
| '''transferTime'''
| Number of hours it takes to purchase/transfer this item to a base.
| 24
|-
| '''weight'''
| [[Item_Weight|Weight]] occupied by this item in a soldier's inventory.
| 999
|-
| '''bigSprite'''
| Sprite ID from [[BIGOBS.PCK]] used to draw this item in a soldier's inventory and UFOpaedia.
| -1
|-
| '''floorSprite'''
| Sprite ID from [[FLOOROB.PCK]] used to draw this item on the floor of a Battlescape tile.
| -1
|-
| '''handSprite'''
| Sprite ID from [[HANDOB.PCK]] used to draw this item on a soldier's hand in the Battlescape.
modders: each handobject needs 8 images (8 directions) define the extrasprites accordingly
| 120
|-
| '''bulletSprite'''
| Sprite ID from ''BulletSprites.png'' used to draw this weapon's projectile on the Battlescape:
* 0 - [[Rocket Launcher]]
* 1 - [[Pistol]]
* 2 - [[Rifle]]
* 3 - [[Auto Cannon]]
* 4 - [[Heavy Cannon]]
* 5 - [[Laser Pistol]]
* 6 - [[Laser Rifle]]
* 7 - [[Heavy Laser]]
* 8 - [[Plasma Rifle|Plasma]]
* 9 - [[Small Launcher]]
* 10 - [[Blaster Launcher]]
for modders: the bulletsprite needs to be put into the extraSprites type "Projectiles" the bulletsprite can contain up to 35 3x3 images
| -1
|-
| '''fireSound'''
| Sound ID from [[#Extra_Sounds|BATTLE.CAT]] played when this weapon fires.
| -1
|-
| '''hitSound'''
| Sound ID from [[#Extra_Sounds|BATTLE.CAT]] played when this weapon hits a target.
| -1
|-
| '''hitAnimation'''
| Sprite ID from [[SMOKE.PCK]] used to draw the weapon's "hit explosion".
'''NOTE''': Do not define this value for melee/psi weapons, they use [[HIT.PCK]] and therefore meleeAnimation instead.
| 0
|-
| '''power'''
| Average damage of the weapon, in most cases it will be +-50% this value.
| 0
|-
| '''strengthApplied'''
| Add the attacking unit's strength to this weapon's damage.
| false
|-
| '''compatibleAmmo'''
| List of string IDs of the ammo items that can be loaded on this weapon. If none are specified, the weapon doesn't need ammo.
| -
|-
| '''damageType'''
| What type of [[damage]] does this weapon do:
* 0 - None
* 1 - Armor Piercing
* 2 - Incendiary
* 3 - High Explosive
* 4 - Laser
* 5 - Plasma
* 6 - Stun
* 7 - Melee
* 8 - Acid
* 9 - Smoke
'''NOTE:''' A damage type other than 0-9 will do nothing.
| 0
|-
| '''tuAuto'''
'''accuracyAuto'''
| The percentage (0-100%) of [[Time Units]] (from the soldier's total) required to fire an Auto Shot. If 0, the weapon does not have an Auto Shot.
The base accuracy (0-100%) applied to a soldier's [[Firing Accuracy]] when firing an Auto Shot.
| 0
0
|-
| '''tuSnap'''
'''accuracySnap'''
| The percentage (0-100%) of [[Time Units]] (from the soldier's total) required to fire a Snap Shot. If 0, the weapon does not have a Snap Shot.
The base accuracy (0-100%) applied to a soldier's [[Firing Accuracy]] when firing a Snap Shot.
| 0
0
|-
| '''tuAimed'''
'''accuracyAimed'''
| The percentage (0-100%) of [[Time Units]] (from the soldier's total) required to fire an Aimed Shot. If 0, the weapon does not have an Aimed Shot.
The base accuracy (0-100%) applied to a soldier's [[Firing Accuracy]] when firing an Aimed Shot.
| 0
0
|-
|-
| '''tuMelee'''
'''accuracyMelee'''
| The percentage (0-100%) of [[Time Units]] (from the soldier's total) required to do a melee attack (Hit). If 0, the weapon does not have a melee attack.
The base accuracy (0-100%) applied to a soldier's [[Melee Accuracy]] when doing a melee attack.
| 0
0
|-
| '''clipSize'''
| The amount of ammo stored in each weapon clip. If -1 is specified, this weapon has infinite ammo.
| 0
|-
| '''battleType'''
| Defines the weapon's behavior in the Battlescape:
* 0 - None (Geoscape-only item)
* 1 - [[Weapons|Firearm]]
* 2 - Ammo
* 3 - Melee
* 4 - [[Grenade]]
* 5 - [[Proximity Grenade]]
* 6 - [[Medi-Kit (EU)|Medi-Kit]]
* 7 - [[Motion Scanner]]
* 8 - [[Mind Probe]]
* 9 - [[Psi-Amp]]
* 10 - [[Electro-flare]]
* 11 - Corpse
| 0
|-
| '''twoHanded'''
| Is this weapon two-handed? (incurs an accuracy penalty if used with both hands occupied)
| false
|-
| '''waypoint'''
| Does this weapon use waypoints? (eg. [[Blaster Launcher]]). Can also be used to make ammo items use the waypoint system.
| false
|-
| '''fixedWeapon'''
| Is this weapon fixed? (it's part of a unit, eg. tanks and terrorist units)
| false
|-
| '''invWidth'''
| Item width in a soldier's inventory (in grid units).
| 1
|-
| '''invHeight'''
| Item height in a soldier's inventory (in grid units).
| 1
|-
| '''painKiller'''
| Amount of painkillers contained in a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''heal'''
| Amount of heal's contained in a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''stimulant'''
| Amount of stimulants contained in a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''woundRecovery'''
| Amount of [[Fatal Wounds]] treated by each heal of a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''healthRecovery'''
| Amount of [[Health]] recovered by each heal of a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''stunRecovery'''
| Amount of [[Stun]] removed by each stimulant of a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''energyRecovery'''
| Amount of [[Energy]] recovered by each stimulant of a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''tuUse'''
| Amount of [[Time Units]] required to use this item (for non-offensive items). It's a flat rate if '''flatRate''' is true, otherwise it's a percentage (0-100%).
| 0
|-
| '''recoveryPoints'''
| [[Score]] gained for recovering this alien artifact.
| 0
|-
| '''armor'''
| How much damage is needed to destroy this item on the ground.
| 20
|-
| '''recover'''
| Is this item recoverable? (gets transported to the X-COM base on mission success)
| true
|-
| '''turretType'''
| Sprite ID from [[TANKS.PCK]] of the turret to assign to this tank:
* 0 - [[Tank/Cannon]]
* 1 - [[Tank/Rocket Launcher]]
* 2 - [[Tank/Laser Cannon]]
* 3 - [[Hovertank/Plasma]]
* 4 - [[Hovertank/Launcher]]
| -1
|-
| '''liveAlien'''
| Does this item represent a live alien? (counts towards [[Alien Containment]])
| false
|-
| '''blastRadius'''
| Size of the projectile explosions. 0 for no explosion. -1 to automatically calculate based on weapon power and damage type (actual '''blastRadius''' currently is capped due [[Explosions#Playing_With_Fire|Explosion calculations]]).
| -1
|-
| '''flatRate'''
| If true, then TU costs for this weapon are a flat rate (instead of a percentage of unit TUs).
| false
|-
| '''arcingShot'''
| Does this weapon fire in an arc?
| false
|-
| '''attraction'''
| Represents how likely an alien is to pick up this item. Values below 5 will be ignored (by design).
| 0
|-
| '''maxRange'''
| Maximum range at which this weapon can operate.
| 200
|-
| '''aimRange'''
| Maximum effective range with this weapon before which range-based dropoff occurs.
| 200
|-
| '''snapRange'''
| Maximum effective range with snap shot before which range-based dropoff occurs. (ufoextender accuracy only)
| 15
|-
| '''autoRange'''
| Maximum effective range with auto shot before which range-based dropoff occurs. (ufoextender accuracy only)
| 7
|-
| '''minRange'''
| Range-based dropoff will work in reverse for ranges below this.
| 0
|-
| '''dropoff'''
| The value by which the accuracy lowers for each tile after (or before) the thresholds above.
| 2
|-
| '''bulletSpeed'''
| How much faster (or slower, if you use a negative number) is a projectile fired from this weapon compared to the average.
| 0
|-
| '''autoShots'''
| How many auto shots does this weapon fire.
| 3
|-
| '''shotgunPellets'''
| Number of projectiles fired per unit of ammunition. (note: due to engine limitations it is currently impossible to draw multiple projectiles in flight.)
| 0
|-
| '''zombieUnit'''
| String ID of the unit used for zombification (eg. [[Chrysallid]]s turn units into [[Zombie]]s).
| none
|-
| '''meleeSound'''
| Sound ID from [[#Extra_Sounds|BATTLE.CAT]] played when this weapon attacks a target with melee.
| 39
|-
| '''meleeHitSound'''
| Sound ID from [[#Extra_Sounds|BATTLE.CAT]] played when this weapon HITS a target with melee.
| -1
|-
| '''meleeAnimation'''
| Sprite ID from HIT.PCK played when this weapon attacks a target with melee.
| 0
|-
| '''meleePower'''
| Damage this weapon will do when using melee. This only applies to Firearms, and is only available as stun damage. For normal melee weapons, use regular power and damage types.
| 0
|-
| '''LOSRequired'''
| Does this item require line of sight? (only applies to mind probes and psi-amps)
| false
|-
| '''skillApplied'''
| Is melee skill applied to the accuracy of an attack made with this object?
| true
|-
|}

=== UFOs ===

Defines one of the [[UFOs]] that invade Earth, listed in ''"ufos:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the UFO name.
| ''required''
|-
| '''size'''
| String ID of the UFO size.
| STR_VERY_SMALL
|-
| '''sprite'''
| Sprite ID from [[INTERWIN.DAT]] used to draw this UFO in the dogfight view and UFOpaedia.
don't try to add more images if you don't want to punch yourself in the face - use modsprite
| -1
|-
| '''modSprite'''
| Filename used to draw this UFO in the dogfight view and UFOpaedia.
| -
|-
| '''damageMax'''
| Maximum amount of damage this UFO can take. If the UFO takes 50% damage, it crash lands. If it takes 100% damage, it is destroyed.
| 0
|-
| '''speedMax'''
| Maximum speed in nautical miles.
| 0
|-
| '''accel'''
| Aceeleration value shown in the UFOpaedia.
| 0
|-
| '''power'''
| Damage power of this UFO's weapon in dogfights.
| 0
|-
| '''range'''
| Maximum range of this UFO's weapon in dogfights (in meters).
| 0
|-
| '''score'''
| [[Score]] gained when this UFO is destroyed, or half this score if it crash lands.
| 0
|-
| '''reload'''
| Time the UFO's weapon takes to fire between each shot.
| 0
|-
| '''breakOffTime'''
| Minimum amount of time for the UFO to be able to break off of a dogfight.
| 0
|-
| '''battlescapeTerrainData'''
| [[#Terrains|Terrain]] associated to this UFO in Battlescape missions.
| ''required''
|-
|}

=== Inventory Sections ===

Defines one of the sections of the [[Inventory TU Table|Battlescape inventory]] (eg. Backpack), listed in ''"invs:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the inventory name.
| ''required''
|-
| '''x'''
'''y'''
| Pixel coordinates of this section on the inventory screen.
| 0
0
|-
| '''type'''
| Type of this section:
* 0 = Slot section, can contain as many items as will fit on the slots.
* 1 = Hand section, can only contain one item regardless of size.
* 2 = Ground section, can contain infinite items.
| 0
|-
| '''slots'''
| List of the grid slots (''[x, y]'') that this section is composed of. For example, to make a 2x2 section, you would have ''[0, 0] [0, 1] [1, 0] [1, 1]''.
| -
|-
| '''costs'''
| List of [[Time Units]] costs to move an item from this section to another one (eg. ''STR_BACKPACK: 16'' means it will cost 16 TUs to move an item from this section to the Backpack).
| -
|-
|}

=== Terrains ===

Defines one of the [[TERRAIN|terrains]] used to generate a Battlescape map, listed in "terrains:".

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''name'''
| String ID of the terrain name.
| ''required''
|-
| '''largeBlockLimit'''
| Maximum amount of large blocks that can be used on map generation.
| 0
|-
| '''textures'''
| List of [[TEXTURE.DAT|Geoscape textures]] that correspond to this terrain.
| -
|-
| '''hemisphere'''
| Geoscape hemisphere associated with this terrain:
* -1 - Northern hemisphere.
* 0 - Both hemispheres.
* 1 - Southern hemisphere.
| 0
|-
| '''mapDataSets'''
| List of filenames (each with matching [[MCD]]/[[Image Formats#PCK|PCK/TAB]] files) that contain the tiles of this terrain.
| -
|-
| '''mapBlocks'''
| List of map blocks (see below) that are used for generating a map.
| -
|-
| '''roadTypeOdds'''
| Odds as a % of generating each type of road (E-W Road, N-S Road, Crossing) odds for crossing are: 100 - EW - NS.
| [0 0]
|-|-
| '''civilianTypes'''
| List of units to use as civilians for this mission.
| [MALE_CIVILIAN, FEMALE_CIVILIAN]
|-
|}

==== Map Blocks ====

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''name'''
| Filename of the [[MAPS|map]].
| ''required''
|-
| '''width'''
| Width of this map block in Battlescape grid units.
| 0
|-
| '''length'''
| Length of this map block in Battlescape grid units.
| 0
|-
| '''height'''
| Height of this map block in Battlescape grid units.
| 1
|-
| '''type'''
| Type of this map block:
* -1 - Undefined
* 0 - Default
* 1 - Landing Zone (for placing X-COM / alien craft)
* 2 - E-W Road (for city maps)
* 3 - N-S Road (for city maps)
* 4 - Road Crossing (for city maps)
* 5 - Dirt (for filling empty base blocks)
* 6 - X-COM spawn point (for [[Alien Base]] / [[Cydonia]] missions)
* 7 - [[Alien Base]] Target
* 8 - [[Cydonia]] Target
| -1
|-
| '''subType'''
| Sub-type of this map block (see '''type''').
| -1
|-
| '''frequency'''
| Frequency of this block in a map.
| 1
|-
| '''maxCount'''
| Maximum amount of times this block can be used in a map. If -1 there is no limit.
| -1
|-
| '''items'''
| An array of items to add to this mapblock, an the positions to place them at.
| -1
|}

*'''frequency''' defines the odds of the map appearing on the map
** The value assigned (default: 1) is used in ''x/n'', which defines the probability of being chosen.
** ''x'' is the integer defined for the map block's frequency and ''n'' is the combined total of probabilities for all the map types combined.
** This property can only be used in type 0 map blocks.
*'''maxCount''' is the maximum number of times it can be used.
** The value assigned is also used in ''x/n'' to determine the probability of being chosen.
** Each use reduces ''x'' by -1, with the caveat that being used as a Landing Zone type will not reduce the x value since it could result in no available Landing Zones.
** This property can only be used in type 0 map blocks.
* '''hemisphere''' only applies to UFO missions, not Terror ones.
*'''width/length''' defines the size of the map
** be aware that the mapview "width"-label is the openxcom ruleset length parameter
** be aware that the mapview "length"-label is the openxcom ruleset width parameter

==== Guidelines/Tips ====
* All maps with an XCOM/Alien craft require at least one type 1 map block. This map block can only contain ground tiles (no walls or objects), otherwise the game will crash or the walls/objects will be removed.
* All Terror terrains (listed under STR_TERROR_MISSION) require at least 1 map block of '''Types''' 2, 3 and 4 (for a total of 3 maps, which are required to place roads) and the corresponding '''roadTypeOdds''' added to the ruleset.
* If there isn't any map blocks designed as roads since you want to keep your terrain 'random', this can be circumvented by designating all 10x10 map blocks, excluding the one(s) used for the XCOM craft, as either '''Type''' 2, 3 and 4 and by defining their '''subType''' to 0. The game will then randomly choose between the map blocks for each type used in the roads, making them map more random.

=== Armor ===

Defines a Battlescape unit's [[armor]] as well as visual representation (so every unit has an armor), listed in ''"armors:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the armor name.
| ''required''
|-
| '''spriteSheet'''
| Sprite sheet from [[UNITS]] used to draw a unit wearing this armor.
| -
|-
| '''spriteInv'''
| Sprite used for the [[Inventory Backgrounds]] of a unit wearing this armor.
| -
|-
| '''corpseBattle'''
| List of string IDs of the corpse [[#Items|items]] generated when a unit wearing this armor is killed (one per unit tile) on the Battlescape.
| -
|-
| '''corpseGeo'''
| String ID of the corpse [[#Items|item]] associated with this unit on the Geoscape.
| -
|-
| '''storeItem'''
| String ID of the [[#Items|item]] that represents this armor in [[Base Stores]] for equipping.
| -
|-
| '''weight'''
| Physical weight of the armor when worn
| 6
|-
| '''stats'''
| like soldier stats (see below) but these are treated as stat bonuses for wearing the specific armor.
| -
|-
| '''frontArmor'''
| Protection provided on the front of the unit.
| 0
|-
| '''sideArmor'''
| Protection provided on the sides of the unit.
| 0
|-
| '''rearArmor'''
| Protection provided on the rear of the unit.
| 0
|-
| '''underArmor'''
| Protection provided under the unit (eg. from explosions).
| 0
|-
| '''drawingRoutine'''
| Drawing routine used to put together the body parts in the unit's '''spriteSheet''':
* 0 = [[Soldier]], [[Sectoid]]
* 1 = [[Floater]]
* 2 = [[HWP]]
* 3 = [[Cyberdisk]]
* 4 = [[Civilian]], [[Ethereal]]
* 5 = [[Sectopod]], [[Reaper]]
* 6 = [[Snakeman]]
* 7 = [[Chryssalid]]
* 8 = [[Silacoid]]
* 9 = [[Celatid]]
* 10 = [[Muton]]
| 0
|-
| '''movementType'''
| Type of movement provided by this armor:
* 0 = Walking
* 1 = Flying
* 2 = Sliding (no walking animation)
it also defines the body of an tank (32-images) in your spriteSheet or the change in sprites while flying using a flying armour see: [[TANKS.PCK]], [[XCOM_2.PCK]]
| 0
|-
| '''damageModifier'''
| List of decimal damage modifiers (1.0 = 100%) this armor applies to each damage type (see [[#Items|Items section]]) received. Modifiers must be specified for all damage types, in this order:
* None
* Armor Piercing
* Incendiary
* High Explosive
* Laser
* Plasma
* Stun
* Melee
* Acid
* Smoke
|
- 1.0 
- 1.0 
- 1.0 
- 1.0 
- 1.0 
- 1.0 
- 1.0 
- 1.0 
- 1.0 
- 1.0
|-
| '''size'''
| Size of the unit wearing this armor, in Battlescape grid units. Every unit is square, so a size of 2 means 2x2.
| 1
|-
| '''loftempsSet'''
| List of [[LOFTEMPS]] IDs (one per unit tile, so a 1x1 unit has 1, a 2x2 unit has 4, etc.) used to represent a unit wearing this armor in 3D space.
| -
|-
| '''loftemps'''
| loftemps is a deprecated option that only works for 1x1 sized units.
| -
|}

=== Player Units (Soldiers) ===

Defines a [[soldier]] recruited by X-COM, listed in ''"soldiers:"''. Currently only one soldier unit type (''XCOM'') is supported.

Unit stats are represented as follows:
* [[Time Units|tu]]
* [[Energy|stamina]]
* [[Health|health]]
* [[Bravery|bravery]] (always a multiple of 10)
* [[Reactions|reactions]]
* [[Firing Accuracy|firing]]
* [[Throwing Accuracy|throwing]]
* [[Strength|strength]]
* [[Psi Strength|psiStrength]]
* [[Psi Skill|psiSkill]]
* [[Melee Accuracy|melee]] (not visible)

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the soldier name.
| ''required''
|-
| '''minStats'''
| Minimum values used to generate the soldier's [[Starting Stats]]. In this case, ''psiSkill'' is treated as the initial stat (not generated).
| -
|-
| '''maxStats'''
| Maximum values used to generate the soldier's [[Starting Stats]]. In this case, ''psiSkill'' is treated as the minimum value for the first month of psi training (actual value is 100%-150%).
| -
|-
| '''statCaps'''
| Maximum stats this soldier can gain through [[Experience]]. '''NOTE:''' A stat will still go over the limit once, and then will no longer increase (see [[Experience#Regarding Caps|Regarding Caps]]).
| -
|-
| '''armor'''
| String ID of the [[#Armor|armor]] this soldier uses by default.
| -
|-
| '''standHeight'''
| Height of this soldier when standing.
| 0
|-
| '''kneelHeight'''
| Height of this soldier when kneeling.
| 0
|-
| '''floatHeight'''
| Distance between the bottom of this unit and the ground.
| 0
|}

=== AI Units (Aliens/Civilians) ===

Defines an [[Alien Life Forms|alien]] (enemy) or [[civilian]] (neutral) unit, listed in ''"units:"''. Every different alien rank is a different unit, since they have completely different stats. Unit stats are represented as follows:
* [[Time Units|tu]]
* [[Energy|stamina]]
* [[Health|health]]
* [[Bravery|bravery]] (always a multiple of 10)
* [[Reactions|reactions]]
* [[Firing Accuracy|firing]]
* [[Throwing Accuracy|throwing]]
* [[Strength|strength]]
* [[Psi Strength|psiStrength]]
* [[Psi Skill|psiSkill]]
* [[Melee Accuracy|melee]] (not visible)

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the unit name.
| ''required''
|-
| '''race'''
| String ID of the unit race (for alien units).
| -
|-
| '''rank'''
| String ID of the unit rank (for alien units).
| -
|-
| '''stats'''
| Battlescape stats of this unit.
| -
|-
| '''armor'''
| String ID of the [[#Armor|armor]] this unit uses by default.
| -
|-
| '''standHeight'''
| Height of this unit when standing.
| 0
|-
| '''floatHeight'''
| Distance between the bottom of this unit and the ground.
| 0
|-
| '''value'''
| [[Score]] this unit is worth.
| 0
|-
| '''deathSound'''
| Sound ID from [[#Extra_Sounds|BATTLE.CAT]] played when this unit dies.
| -1
|-
| '''aggroSound'''
| Sound ID from [[#Extra_Sounds|BATTLE.CAT]] played when this unit aggros.
| -1
|-
| '''moveSound'''
| Sound ID from [[#Extra_Sounds|BATTLE.CAT]] played when this unit moves.
| -1
|-
| '''intelligence'''
| Intelligence of this unit's AI. The higher the value, the longer this unit remembers player troops.
| 0
|-
| '''aggression'''
| Aggression of this unit's AI. The higher the value, the more ruthless the unit.
| 0
|-
| '''energyRecovery'''
| Energy recovered by the unit each turn (needs verification)
| 40 (?)
|-
| '''specab'''
| Special ability of this unit:
* 0 = None
* 1 = [[Cyberdisc|Explodes on Death]]
* 2 = [[Bio-Drone|Burns Floor]]
* 3 = [[Zombie|Respawns on Death]]
| 0
|-
| '''spawnUnit'''
| String ID of the unit used to respawn on death (eg. [[Zombie]]s respawn as [[Chrysallid]]s).
| -
|-
| '''livingWeapon'''
| Is this unit a living weapon? (only attacks with a '''fixedWeapon''')
| false
|-
|}

=== Alien Races ===

Defines a [[Alien Life Forms|race]] used in [[Alien Missions]], listed in ''"alienRaces:"''. Heavily tied with deployment data.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''id'''
| String ID of the alien race name.
| ''required''
|-
| '''members'''
| Alien crew associated with this alien race (eg. race units + terrorist units), defined by a list of unit string IDs. Order here will define rank in terms of deployment. generally speaking the order is:
* 0 - Commander
* 1 - Leader
* 2 - Engineer
* 3 - Medic
* 4 - Navigator
* 5 - Soldier
* 6 - Terrorist 1
* 7 - Terrorist 2
but of course, not all races have all ranks, so the "fill in" rank would be listed multiple times (see ethereals).
|-
| '''retaliation'''
| retaliation enables/disables the race for retaliation missions.
| ''True''
| -
|}

=== Alien Deployments ===

Defines a Battlescape deployment data used in [[Alien Missions]] (such as alien and map configurations), listed in ''"alienDeployments:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the deployment name.
| ''required''
|-
| '''width'''
| Width of the Battlescape map in grid units.
| 0
|-
| '''length'''
| Length of the Battlescape map in grid units.
| 0
|-
| '''height'''
| Vertical height of the Battlescape map in grid units.
| 0
|-
| '''terrains'''
| list of string IDs of the [[#Terrains|terrain]] to choose from to generate this map. This is not used for UFO sites where the terrain comes from the Geoscape.
| -
|-
| '''shade'''
| Shade of the map (0-15, where 0 is full daytime and 15 is full nighttime). This is not used for UFO sites where the shade comes from the Geoscape.
| 0
|-
| '''nextStage'''
| String ID of the next deployment stage to use after this one, for multi-stage missions.
| -
|-
| '''data'''
| List of deployment data for each alien rank on this mission (see below).
| -
|}

Notes:
* '''terrains''' can also be used with UFOs, with the game using instead the listed terrain rather than the location of the UFO on Geoscape.
==== Deployment Data ====

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''alienRank'''
| [[Alien Rank|Rank]] associated with this deployment data, as defined by the order of the race in question (see above)
| ''required''
|-
| '''lowQty'''
| Maximum quantity of aliens to spawn (beginner).
| 0
|-
| '''highQty'''
| Maximum quantity of aliens to spawn (superhuman).
| 0
|-
| '''dQty'''
| Minimum Desired Quantity of aliens to spawn.
| 0
|-
| '''percentageOutsideUfo'''
| Percentage (0-100%) of aliens to spawn outside in UFO sites.
| 0
|-
| '''itemSets'''
| Three lists (one for each alien technology level) of [[#Items|items]] (string IDs) for the aliens to equip.
| ''required''
|-
|}

=== Research ===

Defines a [[Research|research topic]] that X-COM scientists can investigate, listed in ''"research:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''name'''
| String ID of the research project's name (or item, if a '''lookup''' is defined).
| ''required''
|-
| '''lookup'''
| String ID of the research project's display name and UFOPaedia article reference.
| -
|-
| '''cost'''
| Number of man hours (on average) required to complete this project.
| 0
|-
| '''points'''
| [[Score]] earned for completing this project.
| 0
|-
| '''needItem'''
| Does this project require an [[#Items|item]] of the same name?
| false
|-
| '''dependencies'''
| List of research projects that can unlock access to this one. If the full list is researched, or if one of the projects on the list "unlocks" this one, it becomes available.
| -
|-
| '''unlocks'''
| List of research projects unlocked, regardless of other dependencies, but not requirements, by completing this project (for example, any live alien unlocks "alien origins").
| -
|-
| '''requires'''
| List of research projects unilaterally required before this project can be unlocked (for example, "the martian solution" will not even be considered for unlocking until AFTER "alien origins" is completed).
| -
|-
| '''getOneFree'''
| List of "bonus" research projects that may be granted when completing this project (for example, alien medics will give you information on other alien races). Only applies to living aliens.
| -
|-
|}

=== Manufacture ===

Defines a [[Manufacture|manufacture project]] that X-COM engineers can produce, listed in ''"manufacture:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''name'''
| String ID of the manufacturing project's name (and the item it produces).
| ''required''
|-
| '''category'''
| String ID of the manufacturing project's category.
| -
|-
| '''requires'''
| List of [[#Research|topics]] (string IDs) that must be researched to unlock this project. If none are specified, this project is unlocked from the start.
| -
|-
| '''space'''
| Amount of [[Workshop]] space required to begin this project.
| 0
|-
| '''time'''
| Number of man hours (on average) required per item.
| 0
|-
| '''cost'''
| Monetary deduction per item manufactured.
| 0
|-
| '''requiredItems'''
| List of [[#Items|items]] required and consumed per item manufactured.
| -
|-
| '''producedItems'''
| List of [[#Items|items]] produced per each item consumed. If not specified, defaults to 1 item with the same string ID as the manufacture.
| 1
|-
|}

=== UFOpaedia Article ===

Defines an article in the in-game [[UFOpaedia]], listed in ''"ufopaedia:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''id'''
| String ID of the article name. This must match the ID of the object associated with this article, if applicable.
| ''required''
|-
| '''title'''
| String ID of the article title. If omitted, the '''id''' is used.
| -
|-
| '''type_id'''
| Type of this article:
* 0 = Unknown
* 1 = [[Craft]]
* 2 = [[Craft Armaments]]
* 3 = [[HWP]]
* 4 = [[Equipment (EU)|Equipment]]
* 5 = [[Armour]]
* 6 = [[Base Facilities]]
* 7 = Text & Image (eg. [[Alien Life Forms]], [[UFO Components]])
* 8 = Text (eg. [[Alien Research]])
* 9 = [[UFO]]
| 0
|-
| '''section'''
| String ID of the UFOpaedia section this article belongs in.
| -
|-
| '''requires'''
| List of [[#Research|topics]] (string IDs) that must be researched to unlock this article. If none are specified, this article is unlocked from the start.
| -
|-
| '''image_id'''
| Filename of the [[UP001.SPK-UP042.SPK|background image]] displayed on this article, if applicable.
| -
|-
| '''text'''
| String ID of the description displayed on this article.
| -
|-
| '''text_width'''
| Maximum width of the text displayed, only applicable to ''Text & Image'' articles.
| 0
|-
| '''rect_stats'''
| Rectangle ('''x''', '''y''', '''width''', '''height''') of the stats text on the screen, only applicable to ''Craft'' articles.
| 0
|-
| '''rect_text'''
| Rectangle ('''x''', '''y''', '''width''', '''height''') of the description text on the screen, only applicable to ''Craft'' articles.
| 0
|-
| '''weapon'''
| String ID of the weapon, only applicable to ''HWP'' articles.
| -
|}

=== UFO Trajectories ===

Defines a trajectory carried out by an UFO during an [[#Alien Missions|alien mission]], listed in ''"ufoTrajectories:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''id'''
| String ID of the trajectory name.
| ''required''
|-
| '''groundTimer'''
| Amount of seconds for the UFO to spend on Ground waypoints.
| 0
|-
| '''waypoints'''
| List of waypoints for the UFO to traverse, defined as ''[zone, altitude, speed]''. 
'''zone''': Globe zone where the waypoint is located. 
'''altitude''': UFO altitude after reaching this waypoint:
* 0 - Ground
* 1 - Very Low
* 2 - Low
* 3 - High
* 4 - Very High
'''speed''': UFO speed after reaching this waypoint, as a percentage (0-100%) of its maximum speed.
| -
|}

=== Alien Missions ===

Defines an [[Alien Missions|alien mission]] carried out by UFOs on the Geoscape, listed in ''"alienMissions:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the mission type.
| ''required''
|-
| '''points'''
| [[Score]] allocated to aliens for successfully completing this mission.
| 0
|-
| '''raceWeights'''
| List of alien races likely to carry out this mission, and the % chance of them being allocated to this mission, listed by "number of months after game beginning".
| ''required''
|-
| '''waves'''
| List of UFO waves to spawn as this mission progresses, as described below.
| ''required''
|}

==== Waves ====

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''ufo'''
| String ID of the [[#UFOs|UFO]] to spawn.
| ''required''
|-
| '''count'''
| Number of UFOs to spawn.
| 0
|-
| '''trajectory'''
| String ID of the [[#UFO Trajectories|trajectory]] for this UFO to use when entering Earth's atmosphere.
| ''required''
|-
| '''timer'''
| How long after the previous wave should this wave arrive? (in seconds)
| 0
|-
|}

=== Alien Item Levels ===

This is a list of item level probabilities, with a number between 0 and 2 representing an item level from plasma pistols to heavy plasmas, as defined in the deployments, expressing a 10% probability for that item level being used.

0 = first set (plasma pistol/clip)
1 = second set (plasma rifle/clip)
2 = third set (heavy plasma/clip)

For example:
[ 2, 0, 0, 0, 0, 0, 0, 1, 1, 1 ]
would represent a 60% chance for pistols, 30% rifles, and 10% heavy weapons. 
Note that the order does not matter, but the length DOES. each line MUST have 10 digits.

The above can be confusing. There are 10 fields; each number represents 10%. 
There is only one instance of '2'. 1x10% = 10% chance of plasma pistol 
There are three instances of '1'. 3x10% = 30% chance of plasma rifle 
There are six instances of '0'. 6x10% = 60% chance of heavy plasma 

Each line represents a month after the beginning of the game, and there is no limit to the number defined. 
OpenXCom will use the most recently available item level in the event the game goes on forever.

=== Extra Sprites ===

Adds or replaces sprites in an existing [[Image Formats|X-COM image file]], listed in ''"extraSprites:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| Filename of the original/new image to modify.
| ''required''
|-
| '''width'''
'''height'''
| Size of the sprite(s) in pixels.
| 0
0
|-
| '''singleImage'''
| Is the image file just a single sprite (true) or a spritesheet (false)?
| false
|-
| '''subX'''
'''subY'''
| Size of the subdivision in pixels. If a subdivision is specified, then the image file is divided into chunks to form the sprites (eg. spritesheets).
| 0
0
|-
| '''files'''
| List of the new sprites to add/replace, listed as ''spriteID: filename''.
| -
|}

Example:
- type: GIANTBUNNY.PCK
width: 32
height: 40
files:
0: Resources/Bunny/Bunny00.png
1: Resources/Bunny/Bunny01.bmp
2: Resources/Bunny/Bunny02.gif

=== Extra Sounds ===

Adds or replaces sounds in an existing [[SOUND|X-COM sound file]], listed in ''"extraSounds:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| ID of the original sound file to modify:
* BATTLE.CAT - Battlescape sounds, corresponds to ''SOUND1.CAT'' or ''SAMPLE2.CAT'' (55 sounds).
* INTRO.CAT - Intro sounds, corresponds to ''INTRO.CAT'' or ''SAMPLE3.CAT'', probably best not to mess with these.
* GEO.CAT - Geoscape sounds, corresponds to ''SOUND2.CAT'' or ''SAMPLE.CAT'' (14 sounds).
| ''required''
|-
| '''files'''
| List of the new sounds to add/replace, listed as ''soundID: filename''.
| -
|}

Example:
- type: BATTLE.CAT
files:
55: Resources/Sounds/sample.wav

=== Extra Strings ===

Adds or replaces text strings in an existing [[Translations (OpenXcom)|OpenXcom language file]], listed in ''"extraStrings:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| Filename of the original language file to modify, sans extension.
| ''required''
|-
| '''strings'''
| List of the new strings to add/replace, listed as ''stringID: text''.
| -
|}

Example:
- type: en-US
strings:
STR_SNIPER_RIFLE: Sniper Rifle
STR_SNIPER_RIFLE_CLIP: Sniper Rifle Clip
- type: en-GB
strings:
STR_SNIPER_RIFLE: Sniper Rifle
STR_SNIPER_RIFLE_CLIP: Sniper Rifle Clip
- type: de
strings:
STR_SNIPER_RIFLE: Scharfschützengewehr
STR_SNIPER_RIFLE_CLIP: Scharfschützengewehrmunition
- type: ru
strings:
STR_SNIPER_RIFLE: Снайперская винтовка
STR_SNIPER_RIFLE_CLIP: Магазин к снайп. винтовке

=== Interfaces ===

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| ''?''
| -
|-
| '''elements'''
| ''?''
| -
|-
| '''id'''
| ''?''
| -
|-
| '''color'''
| ''?''
| -
|}

=== StatStrings ===

[[Statstrings]] are used for automatically renaming soldiers. They are case sensitive and they are processed in the order in which they are specified.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''string'''
| String to add to name.
| ''required''
|-
| '''psiStrength''' 
'''psiSkill''' 
'''bravery''' 
'''strength''' 
'''firing''' 
'''reactions''' 
'''stamina''' 
'''tu''' 
'''health''' 
'''throwing'''
| One or more stat ranges are ANDed together for success. Each range has a minVal and maxVal. Use YAML standard tilde (~) to indicate null.
| -
|}

Example:
statStrings:
- string: "x"
psiStrength: [~, 30]
- string: "P"
psiStrength: [80, ~]
- string: "p"
psiStrength: [60, 79]
- string: "K"
psiSkill: [60, ~]
- string: "k"
psiSkill: [30, 59]
- string: "b"
bravery: [60, ~]
- string: "c"
bravery: [~, 10]
- string: "w"
strength: [~, 25]
- string: "Snpr"
firing: [60, ~]
reactions: [60, ~]
- string: "M"
firing: [70, ~]
- string: "m"
firing: [60, 69]
- string: "Sct"
reactions: [50, ~]
tu: [60, ~]
- string: "R"
reactions: [60, ~]
- string: "r"
reactions: [50, 59]

==References==
<references />

[[Category:OpenXcom]]

Ruleset Reference (OpenXcom)

2014-09-01T02:46:17Z

Falko: GEO.CAT bette rthan sample for oxc modder

A reference of all the customizable values of everything in a [[Rulesets (OpenXcom)|ruleset]]. Some guidelines:
* If a value is omitted from the ruleset, the default is used. You cannot omit ''required'' values.
* Text strings (eg. names) are represented by string IDs from the [[Translations (OpenXcom)|language files]]
* Numerical IDs (used for sprites, sounds, etc.) start at 0, not 1.
* Boolean (yes/no) values are represented by true/false.
* World coordinates are represented in degrees (see [[WORLD.DAT]]).
* Money amounts (prices, costs, etc.) are represented in dollars.
* All paths are '''case sensitive'''! If your ruleset uses external files, make sure that they named properly as described in ruleset.

Items are ordered as they come in the ruleset. To override this, you can specify a ''listOrder''. You can find the default listOrders in [[Ruleset List Order (OpenXcom)|Ruleset List Order]].

=== Globe ===

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''data'''
| ''path name of ?.''
| ''required''
|-
| '''polylines'''
| ''?''
| -
|}

=== Countries ===

Defines one of the [[Country Funding (EU)|funding nations]], listed in ''"countries:"''. They're used for activity graphs and player scoring.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the country name.
| ''required''
|-
| '''fundingBase'''
| Country's base funding, in thousands. The starting funding can be anywhere between 1x and 2x the base funding.
| 0
|-
| '''fundingCap'''
| Country's funding cap, in thousands. Once a country reaches this maximum, it will no longer increase its funding.
| 0
|-
| '''labelLon'''
'''labelLat'''
| Longitude and latitude coordinates of the country's label on the globe. This label is only shown when the globe is zoomed in and "detail" is turned on.
| 0.0
0.0
|-
| '''areas'''
| List of "rectangles" on the globe defined as [''lon1'' ''lat1'' ''lon2'' ''lat2'']. Any activity within these areas counts towards the country's graph activity and affects their opinion of the player.
| -
|}

=== Regions ===

Defines one of the [[Geoscape (EU)#World Regions/Countries|world regions]], listed in ''"regions:"''. They're used for base placement, activity graphs and mission spawning.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the region name.
| ''required''
|-
| '''cost'''
| Amount of money spent building an X-COM base in this region (first base is free).
| 0
|-
| '''areas'''
| List of "rectangles" on the globe defined as ''[lon1, lat1, lon2, lat2]''. Any activity within these areas counts towards the region's graph activity.
| -
|-
| '''cities'''
| List of cities belonging to this region. They will be displayed on the globe and used for terror site missions. Each city is defined by their '''lon''' and '''lat''' coordinates and a '''name''' string ID.
| -
|-
| '''regionWeight'''
| Weight of this region when selecting regions for alien missions.
| 0
|-
| '''missionWeights'''
| Weighted list of the different mission types for this region (eg. ''STR_ALIEN_RESEARCH: 14'').
| -
|-
| '''missionZones'''
| List of "rectangles" (''[lon1, lat1, lon2, lat2]'') defining the mission zones for this region.
| -
|-
| '''missionRegion'''
| Spawn mission in this region instead (used for regions without land).
| -
|}

=== Base Facilities ===

Defines one of the [[Base Facilities (EU)|facilities]] that can be built in an X-COM base, listed in ''"facilities:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the facility name.
| ''required''
|-
| '''requires'''
| List of [[#Research|topics]] (string IDs) that must be researched to unlock this facility. If none are specified, this facility is unlocked from the start.
| -
|-
| '''spriteShape'''
| Sprite ID from [[BASEBITS.PCK]] used to draw the facility's outer shape in the Basescape and UFOpaedia.
| -1
|-
| '''spriteFacility'''
| Sprite ID from [[BASEBITS.PCK]] used to draw the facility's contents in the Basescape and UFOpaedia. Drawn on top of '''spriteShape'''.
| -1
|-
| '''lift'''
| Is this facility an [[Access Lift]]? All base facilities must be connected to the lift.
| false
|-
| '''hyper'''
| Is this facility a [[Hyperwave Decoder]]? Displays extra information for detected UFOs. Only valid for radar facilities.
| false
|-
| '''mind'''
| Is this facility a [[Mind Shield]]? Reduces the chance of UFOs finding your base. Does not stack.
| false
|-
| '''grav'''
| Is this facility a [[Grav Shield]]? Doubles the power of your base defenses. Does not stack.
| false
|-
| '''size'''
| Size of the facility, in grid units. Every facility is square, so a size of 1 means 1x1, 2 means 2x2, etc. Bigger facilities are made up of multiple sprites, for example a 2x2 facility will use 4 sprites for '''spriteShape''' and 4 sprites for '''spriteFacility''' (top-left, top-right, bottom-left, bottom-right).
| 1
|-
| '''buildCost'''
| Amount of money spent to build this facility in the base.
| 0
|-
| '''buildTime'''
| Amount of days it takes for this facility to be built.
| 0
|-
| '''monthlyCost'''
| Amount of money spent monthly for the maintenance of this facility.
| 0
|-
| '''storage'''
| Amount of storage space (for items) this facility provides. See [[Base Stores]].
| 0
|-
| '''personnel'''
| Amount of personnel (soldiers, scientsts, engineers) these quarters can contain.
| 0
|-
| '''aliens'''
| Amount of live aliens this facility can contain. Only checked if the ''alienContainmentLimitEnforced'' option is enabled.
| 0
|-
| '''crafts'''
| Amount of X-COM craft this facility can contain.
| 0
|-
| '''labs'''
| Amount of lab space this facility provides for research projects.
| 0
|-
| '''workshops'''
| Amount of workshop space this facility provides for manufacture projects.
| 0
|-
| '''psiLabs'''
| Amount of soldier space this facility provides for psionic training.
| 0
|-
| '''radarRange'''
| Maximum radar detection range of this facility, in nautical miles.
| 0
|-
| '''radarChance'''
| Chance (0-100%) of this radar detecting a UFO that enters its range.
| 0
|-
| '''defense'''
| Offensive power provided by this base defense against attacking UFOs.
| 0
|-
| '''hitRatio'''
| Chance (0-100) of the base defense hitting an attacking UFO.
| 0
|-
| '''fireSound'''
| Sound ID from GEO.CAT played when the base defense fires.
| -1
|-
| '''hitSound'''
| Sound ID from GEO.CAT played when the base defense hits a target.
| -1
|-
| '''mapName'''
| [[MAPS|Map]] associated to this facility in Battlescape base defenses.
| -
|-
|}

=== Crafts ===

Defines one of the [[Craft|X-COM crafts]] that go on interception missions, listed in ''"crafts:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the craft name.
| ''required''
|-
| '''requires'''
| List of [[#Research|topics]] (string IDs) that must be researched to unlock this craft. If none are specified, this craft is unlocked from the start.
| -
|-
| '''sprite'''
| Sprite ID from [[BASEBITS.PCK]] used to draw this craft in the Basescape and from [[INTICON.PCK]] used to draw the damage indicator in dogfights.
modders: the corresponding extrasprite file id for BASEBITS.PCK is sprite+33 INTICON.PCK contains a minimized icon id=sprite the file id for the dogfight image is sprite+11
| -1
|-
| '''fuelMax'''
| Maximum amount of fuel this craft can carry. Crafts use up fuel based on their speed while travelling.
| 0
|-
| '''damageMax'''
| Maximum amount of damage this craft can take. If this amount is exceeded, the craft is destroyed.
| 0
|-
| '''speedMax'''
| Maximum speed in nautical miles. Crafts travel at max speed when flying and half speed when patrolling.
| 0
|-
| '''accel'''
| Aceeleration value shown in the UFOpaedia.
| 0
|-
| '''weapons'''
| Amount of craft weapons this craft can equip. The UI can only display a max of 2 weapons.
| 0
|-
| '''soldiers'''
| Amount of soldiers this craft can carry.
| 0
|-
| '''maxItems'''
| Amount of items this craft can carry.
| 80
|-
| '''vehicles'''
| Amount of vehicles this craft can carry.
| 0
|-
| '''costBuy'''
| Amount of money spent for purchasing this craft. If set to 0, the craft will not be available in the Purchase/Recruit screen.
| 0
|-
| '''costRent'''
| Amount of money spent monthly for renting this craft. If set to 0, the craft is not on rental and won't count towards base maintenance.
| 0
|-
| '''costSell'''
| Amount of money gained for selling this craft.
| 0
|-
| '''refuelItem'''
| Item required for refuelling this craft. If no item is specified, the craft uses human fuel.
| 0
|-
| '''repairRate'''
| Amount of damage restored every hour while [[Repairs|Repairing]] in base.
| 1
|-
| '''refuelRate'''
| Amount of fuel restored every 30 mins while [[Refueling]] in base. If specified, a '''refuelItem''' is spent each time.
| 1
|-
| '''radarRange'''
| Detection range of the craft's radar in nautical miles. Every craft radar has a 100% detection chance.
| 600
|-
| '''transferTime'''
| Number of hours it takes to purchase/transfer this craft to a base.
| 0
|-
| '''score'''
| [[Score]] lost when this craft is destroyed.
| 0
|-
| '''spacecraft'''
| Can this craft go to [[Cydonia]]?
| false
|-
| '''battlescapeTerrainData'''
| [[#Terrains|Terrain]] associated to this craft in Battlescape missions.
| -
|}

=== Craft Weapons ===

Defines one of the [[Craft Armaments|weapons]] equipped by X-COM craft for shooting down UFOs, listed in ''"craftWeapons:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the weapon name.
| ''required''
|-
| '''sprite'''
| Sprite ID from [[BASEBITS.PCK]] used to draw the weapon in the Basescape and from [[INTICON.PCK]] used to draw the weapon in dogfights.
modders: the corresponding extrasprites file id for INTICON.PCK is sprite+5 and sprite+48 for BASEBITS.PCK
| -1
|-
| '''sound'''
| Sound ID from GEO.CAT played when this weapon fires.
| -1
|-
| '''damage'''
| Amount of damage this weapon does to enemy UFOs.
| 0
|-
| '''range'''
| Maximum range of this weapon in dogfights (in meters).
| 0
|-
| '''accuracy'''
| Chance (0-100%) of each shot hitting the enemy UFO.
| 0
|-
| '''reloadCautious'''
| Time this weapon takes to fire between each shot in ''Cautious Mode''.
| 0
|-
| '''reloadStandard'''
| Time this weapon takes to fire between each shot in ''Standard Mode''.
| 0
|-
| '''reloadAggressive'''
| Time this weapon takes to fire between each shot in ''Aggressive Mode''.
| 0
|-
| '''ammoMax'''
| Maximum amount of ammo this weapon can carry.
| 0
|-
| '''rearmRate'''
| Amount of ammo restored every 30 mins while the craft is [[Rearming]] in base. If specified, '''clip'''s are spent depending on their '''clipSize'''. If the '''clipSize''' of the specified ammo is 0, no '''clip'''s are spent.
| 1
|-
| '''projectileType'''
| Type of the weapon projectile, used for the projectile sprite in dogfights:
* 0 - [[Stingray]]
* 1 - [[Avalanche]]
* 2 - [[Cannon]]
* 3 - [[Fusion Ball]]
* 4 - [[Laser Cannon]]
* 5 - [[Plasma Beam]]
| 2
|-
| '''projectileSpeed'''
| Speed of the weapon projectile in dogfights.
| 0
|-
| '''launcher'''
| String ID of the [[#Items|item]] required to equip this weapon.
| -
|-
| '''clip'''
| String ID of the [[#Items|item]] required to rearm this weapon.
| -
|}

=== Items ===

Defines the Geoscape and Battlescape properties of an [[Equipment (EU)|item]] that can be stored in X-COM bases, listed in ''"items:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the internal item name.
| ''required''
|-
| '''name'''
| String ID of the displayed item name, for cases where it's different from the internal name. If omitted, '''type''' is used.
| -
|-
| '''requires'''
| List of [[#Research|topics]] (string IDs) that must be researched to unlock this item. If none are specified, this item is unlocked from the start. Soldiers can only use unlocked items in the Battlescape.
| -
|-
| '''size'''
| Space occupied by this item in [[Base Stores]]. Can be a decimal value.
| 0.0
|-
| '''costBuy'''
| Amount of money spent for purchasing this item. If set to 0, this item will not be available in the Purchase/Recruit screen.
| 0
|-
| '''costSell'''
| Amount of money gained for selling this item.
| 0
|-
| '''transferTime'''
| Number of hours it takes to purchase/transfer this item to a base.
| 24
|-
| '''weight'''
| [[Item_Weight|Weight]] occupied by this item in a soldier's inventory.
| 999
|-
| '''bigSprite'''
| Sprite ID from [[BIGOBS.PCK]] used to draw this item in a soldier's inventory and UFOpaedia.
| -1
|-
| '''floorSprite'''
| Sprite ID from [[FLOOROB.PCK]] used to draw this item on the floor of a Battlescape tile.
| -1
|-
| '''handSprite'''
| Sprite ID from [[HANDOB.PCK]] used to draw this item on a soldier's hand in the Battlescape.
modders: each handobject needs 8 images (8 directions) define the extrasprites accordingly
| 120
|-
| '''bulletSprite'''
| Sprite ID from ''BulletSprites.png'' used to draw this weapon's projectile on the Battlescape:
* 0 - [[Rocket Launcher]]
* 1 - [[Pistol]]
* 2 - [[Rifle]]
* 3 - [[Auto Cannon]]
* 4 - [[Heavy Cannon]]
* 5 - [[Laser Pistol]]
* 6 - [[Laser Rifle]]
* 7 - [[Heavy Laser]]
* 8 - [[Plasma Rifle|Plasma]]
* 9 - [[Small Launcher]]
* 10 - [[Blaster Launcher]]
for modders: the bulletsprite needs to be put into the extraSprites type "Projectiles" the bulletsprite can contain up to 35 3x3 images
| -1
|-
| '''fireSound'''
| Sound ID from [[SOUND#SAMPLE2.CAT|SAMPLE2.CAT]] played when this weapon fires.
| -1
|-
| '''hitSound'''
| Sound ID from [[SOUND#SAMPLE2.CAT|SAMPLE2.CAT]] played when this weapon hits a target.
| -1
|-
| '''hitAnimation'''
| Sprite ID from [[SMOKE.PCK]] used to draw the weapon's "hit explosion".
'''NOTE''': Do not define this value for melee/psi weapons, they use [[HIT.PCK]] and therefore meleeAnimation instead.
| 0
|-
| '''power'''
| Average damage of the weapon, in most cases it will be +-50% this value.
| 0
|-
| '''strengthApplied'''
| Add the attacking unit's strength to this weapon's damage.
| false
|-
| '''compatibleAmmo'''
| List of string IDs of the ammo items that can be loaded on this weapon. If none are specified, the weapon doesn't need ammo.
| -
|-
| '''damageType'''
| What type of [[damage]] does this weapon do:
* 0 - None
* 1 - Armor Piercing
* 2 - Incendiary
* 3 - High Explosive
* 4 - Laser
* 5 - Plasma
* 6 - Stun
* 7 - Melee
* 8 - Acid
* 9 - Smoke
'''NOTE:''' A damage type other than 0-9 will do nothing.
| 0
|-
| '''tuAuto'''
'''accuracyAuto'''
| The percentage (0-100%) of [[Time Units]] (from the soldier's total) required to fire an Auto Shot. If 0, the weapon does not have an Auto Shot.
The base accuracy (0-100%) applied to a soldier's [[Firing Accuracy]] when firing an Auto Shot.
| 0
0
|-
| '''tuSnap'''
'''accuracySnap'''
| The percentage (0-100%) of [[Time Units]] (from the soldier's total) required to fire a Snap Shot. If 0, the weapon does not have a Snap Shot.
The base accuracy (0-100%) applied to a soldier's [[Firing Accuracy]] when firing a Snap Shot.
| 0
0
|-
| '''tuAimed'''
'''accuracyAimed'''
| The percentage (0-100%) of [[Time Units]] (from the soldier's total) required to fire an Aimed Shot. If 0, the weapon does not have an Aimed Shot.
The base accuracy (0-100%) applied to a soldier's [[Firing Accuracy]] when firing an Aimed Shot.
| 0
0
|-
|-
| '''tuMelee'''
'''accuracyMelee'''
| The percentage (0-100%) of [[Time Units]] (from the soldier's total) required to do a melee attack (Hit). If 0, the weapon does not have a melee attack.
The base accuracy (0-100%) applied to a soldier's [[Melee Accuracy]] when doing a melee attack.
| 0
0
|-
| '''clipSize'''
| The amount of ammo stored in each weapon clip. If -1 is specified, this weapon has infinite ammo.
| 0
|-
| '''battleType'''
| Defines the weapon's behavior in the Battlescape:
* 0 - None (Geoscape-only item)
* 1 - [[Weapons|Firearm]]
* 2 - Ammo
* 3 - Melee
* 4 - [[Grenade]]
* 5 - [[Proximity Grenade]]
* 6 - [[Medi-Kit (EU)|Medi-Kit]]
* 7 - [[Motion Scanner]]
* 8 - [[Mind Probe]]
* 9 - [[Psi-Amp]]
* 10 - [[Electro-flare]]
* 11 - Corpse
| 0
|-
| '''twoHanded'''
| Is this weapon two-handed? (incurs an accuracy penalty if used with both hands occupied)
| false
|-
| '''waypoint'''
| Does this weapon use waypoints? (eg. [[Blaster Launcher]]). Can also be used to make ammo items use the waypoint system.
| false
|-
| '''fixedWeapon'''
| Is this weapon fixed? (it's part of a unit, eg. tanks and terrorist units)
| false
|-
| '''invWidth'''
| Item width in a soldier's inventory (in grid units).
| 1
|-
| '''invHeight'''
| Item height in a soldier's inventory (in grid units).
| 1
|-
| '''painKiller'''
| Amount of painkillers contained in a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''heal'''
| Amount of heal's contained in a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''stimulant'''
| Amount of stimulants contained in a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''woundRecovery'''
| Amount of [[Fatal Wounds]] treated by each heal of a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''healthRecovery'''
| Amount of [[Health]] recovered by each heal of a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''stunRecovery'''
| Amount of [[Stun]] removed by each stimulant of a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''energyRecovery'''
| Amount of [[Energy]] recovered by each stimulant of a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''tuUse'''
| Amount of [[Time Units]] required to use this item (for non-offensive items). It's a flat rate if '''flatRate''' is true, otherwise it's a percentage (0-100%).
| 0
|-
| '''recoveryPoints'''
| [[Score]] gained for recovering this alien artifact.
| 0
|-
| '''armor'''
| How much damage is needed to destroy this item on the ground.
| 20
|-
| '''recover'''
| Is this item recoverable? (gets transported to the X-COM base on mission success)
| true
|-
| '''turretType'''
| Sprite ID from [[TANKS.PCK]] of the turret to assign to this tank:
* 0 - [[Tank/Cannon]]
* 1 - [[Tank/Rocket Launcher]]
* 2 - [[Tank/Laser Cannon]]
* 3 - [[Hovertank/Plasma]]
* 4 - [[Hovertank/Launcher]]
| -1
|-
| '''liveAlien'''
| Does this item represent a live alien? (counts towards [[Alien Containment]])
| false
|-
| '''blastRadius'''
| Size of the projectile explosions. 0 for no explosion. -1 to automatically calculate based on weapon power and damage type (actual '''blastRadius''' currently is capped due [[Explosions#Playing_With_Fire|Explosion calculations]]).
| -1
|-
| '''flatRate'''
| If true, then TU costs for this weapon are a flat rate (instead of a percentage of unit TUs).
| false
|-
| '''arcingShot'''
| Does this weapon fire in an arc?
| false
|-
| '''attraction'''
| Represents how likely an alien is to pick up this item. Values below 5 will be ignored (by design).
| 0
|-
| '''maxRange'''
| Maximum range at which this weapon can operate.
| 200
|-
| '''aimRange'''
| Maximum effective range with this weapon before which range-based dropoff occurs.
| 200
|-
| '''snapRange'''
| Maximum effective range with snap shot before which range-based dropoff occurs. (ufoextender accuracy only)
| 15
|-
| '''autoRange'''
| Maximum effective range with auto shot before which range-based dropoff occurs. (ufoextender accuracy only)
| 7
|-
| '''minRange'''
| Range-based dropoff will work in reverse for ranges below this.
| 0
|-
| '''dropoff'''
| The value by which the accuracy lowers for each tile after (or before) the thresholds above.
| 2
|-
| '''bulletSpeed'''
| How much faster (or slower, if you use a negative number) is a projectile fired from this weapon compared to the average.
| 0
|-
| '''autoShots'''
| How many auto shots does this weapon fire.
| 3
|-
| '''shotgunPellets'''
| Number of projectiles fired per unit of ammunition. (note: due to engine limitations it is currently impossible to draw multiple projectiles in flight.)
| 0
|-
| '''zombieUnit'''
| String ID of the unit used for zombification (eg. [[Chrysallid]]s turn units into [[Zombie]]s).
| none
|-
| '''meleeSound'''
| Sound ID from [[SOUND#SAMPLE2.CAT|SAMPLE2.CAT]] played when this weapon attacks a target with melee.
| 39
|-
| '''meleeHitSound'''
| Sound ID from [[SOUND#SAMPLE2.CAT|SAMPLE2.CAT]] played when this weapon HITS a target with melee.
| -1
|-
| '''meleeAnimation'''
| Sprite ID from HIT.PCK played when this weapon attacks a target with melee.
| 0
|-
| '''meleePower'''
| Damage this weapon will do when using melee. This only applies to Firearms, and is only available as stun damage. For normal melee weapons, use regular power and damage types.
| 0
|-
| '''LOSRequired'''
| Does this item require line of sight? (only applies to mind probes and psi-amps)
| false
|-
| '''skillApplied'''
| Is melee skill applied to the accuracy of an attack made with this object?
| true
|-
|}

=== UFOs ===

Defines one of the [[UFOs]] that invade Earth, listed in ''"ufos:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the UFO name.
| ''required''
|-
| '''size'''
| String ID of the UFO size.
| STR_VERY_SMALL
|-
| '''sprite'''
| Sprite ID from [[INTERWIN.DAT]] used to draw this UFO in the dogfight view and UFOpaedia.
don't try to add more images if you don't want to punch yourself in the face - use modsprite
| -1
|-
| '''modSprite'''
| Filename used to draw this UFO in the dogfight view and UFOpaedia.
| -
|-
| '''damageMax'''
| Maximum amount of damage this UFO can take. If the UFO takes 50% damage, it crash lands. If it takes 100% damage, it is destroyed.
| 0
|-
| '''speedMax'''
| Maximum speed in nautical miles.
| 0
|-
| '''accel'''
| Aceeleration value shown in the UFOpaedia.
| 0
|-
| '''power'''
| Damage power of this UFO's weapon in dogfights.
| 0
|-
| '''range'''
| Maximum range of this UFO's weapon in dogfights (in meters).
| 0
|-
| '''score'''
| [[Score]] gained when this UFO is destroyed, or half this score if it crash lands.
| 0
|-
| '''reload'''
| Time the UFO's weapon takes to fire between each shot.
| 0
|-
| '''breakOffTime'''
| Minimum amount of time for the UFO to be able to break off of a dogfight.
| 0
|-
| '''battlescapeTerrainData'''
| [[#Terrains|Terrain]] associated to this UFO in Battlescape missions.
| ''required''
|-
|}

=== Inventory Sections ===

Defines one of the sections of the [[Inventory TU Table|Battlescape inventory]] (eg. Backpack), listed in ''"invs:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the inventory name.
| ''required''
|-
| '''x'''
'''y'''
| Pixel coordinates of this section on the inventory screen.
| 0
0
|-
| '''type'''
| Type of this section:
* 0 = Slot section, can contain as many items as will fit on the slots.
* 1 = Hand section, can only contain one item regardless of size.
* 2 = Ground section, can contain infinite items.
| 0
|-
| '''slots'''
| List of the grid slots (''[x, y]'') that this section is composed of. For example, to make a 2x2 section, you would have ''[0, 0] [0, 1] [1, 0] [1, 1]''.
| -
|-
| '''costs'''
| List of [[Time Units]] costs to move an item from this section to another one (eg. ''STR_BACKPACK: 16'' means it will cost 16 TUs to move an item from this section to the Backpack).
| -
|-
|}

=== Terrains ===

Defines one of the [[TERRAIN|terrains]] used to generate a Battlescape map, listed in "terrains:".

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''name'''
| String ID of the terrain name.
| ''required''
|-
| '''largeBlockLimit'''
| Maximum amount of large blocks that can be used on map generation.
| 0
|-
| '''textures'''
| List of [[TEXTURE.DAT|Geoscape textures]] that correspond to this terrain.
| -
|-
| '''hemisphere'''
| Geoscape hemisphere associated with this terrain:
* -1 - Northern hemisphere.
* 0 - Both hemispheres.
* 1 - Southern hemisphere.
| 0
|-
| '''mapDataSets'''
| List of filenames (each with matching [[MCD]]/[[Image Formats#PCK|PCK/TAB]] files) that contain the tiles of this terrain.
| -
|-
| '''mapBlocks'''
| List of map blocks (see below) that are used for generating a map.
| -
|-
| '''roadTypeOdds'''
| Odds as a % of generating each type of road (E-W Road, N-S Road, Crossing) odds for crossing are: 100 - EW - NS.
| [0 0]
|-|-
| '''civilianTypes'''
| List of units to use as civilians for this mission.
| [MALE_CIVILIAN, FEMALE_CIVILIAN]
|-
|}

==== Map Blocks ====

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''name'''
| Filename of the [[MAPS|map]].
| ''required''
|-
| '''width'''
| Width of this map block in Battlescape grid units.
| 0
|-
| '''length'''
| Length of this map block in Battlescape grid units.
| 0
|-
| '''height'''
| Height of this map block in Battlescape grid units.
| 1
|-
| '''type'''
| Type of this map block:
* -1 - Undefined
* 0 - Default
* 1 - Landing Zone (for placing X-COM / alien craft)
* 2 - E-W Road (for city maps)
* 3 - N-S Road (for city maps)
* 4 - Road Crossing (for city maps)
* 5 - Dirt (for filling empty base blocks)
* 6 - X-COM spawn point (for [[Alien Base]] / [[Cydonia]] missions)
* 7 - [[Alien Base]] Target
* 8 - [[Cydonia]] Target
| -1
|-
| '''subType'''
| Sub-type of this map block (see '''type''').
| -1
|-
| '''frequency'''
| Frequency of this block in a map.
| 1
|-
| '''maxCount'''
| Maximum amount of times this block can be used in a map. If -1 there is no limit.
| -1
|-
| '''items'''
| An array of items to add to this mapblock, an the positions to place them at.
| -1
|}

*'''frequency''' defines the odds of the map appearing on the map
** The value assigned (default: 1) is used in ''x/n'', which defines the probability of being chosen.
** ''x'' is the integer defined for the map block's frequency and ''n'' is the combined total of probabilities for all the map types combined.
** This property can only be used in type 0 map blocks.
*'''maxCount''' is the maximum number of times it can be used.
** The value assigned is also used in ''x/n'' to determine the probability of being chosen.
** Each use reduces ''x'' by -1, with the caveat that being used as a Landing Zone type will not reduce the x value since it could result in no available Landing Zones.
** This property can only be used in type 0 map blocks.
* '''hemisphere''' only applies to UFO missions, not Terror ones.
*'''width/length''' defines the size of the map
** be aware that the mapview "width"-label is the openxcom ruleset length parameter
** be aware that the mapview "length"-label is the openxcom ruleset width parameter

==== Guidelines/Tips ====
* All maps with an XCOM/Alien craft require at least one type 1 map block. This map block can only contain ground tiles (no walls or objects), otherwise the game will crash or the walls/objects will be removed.
* All Terror terrains (listed under STR_TERROR_MISSION) require at least 1 map block of '''Types''' 2, 3 and 4 (for a total of 3 maps, which are required to place roads) and the corresponding '''roadTypeOdds''' added to the ruleset.
* If there isn't any map blocks designed as roads since you want to keep your terrain 'random', this can be circumvented by designating all 10x10 map blocks, excluding the one(s) used for the XCOM craft, as either '''Type''' 2, 3 and 4 and by defining their '''subType''' to 0. The game will then randomly choose between the map blocks for each type used in the roads, making them map more random.

=== Armor ===

Defines a Battlescape unit's [[armor]] as well as visual representation (so every unit has an armor), listed in ''"armors:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the armor name.
| ''required''
|-
| '''spriteSheet'''
| Sprite sheet from [[UNITS]] used to draw a unit wearing this armor.
| -
|-
| '''spriteInv'''
| Sprite used for the [[Inventory Backgrounds]] of a unit wearing this armor.
| -
|-
| '''corpseBattle'''
| List of string IDs of the corpse [[#Items|items]] generated when a unit wearing this armor is killed (one per unit tile) on the Battlescape.
| -
|-
| '''corpseGeo'''
| String ID of the corpse [[#Items|item]] associated with this unit on the Geoscape.
| -
|-
| '''storeItem'''
| String ID of the [[#Items|item]] that represents this armor in [[Base Stores]] for equipping.
| -
|-
| '''weight'''
| Physical weight of the armor when worn
| 6
|-
| '''stats'''
| like soldier stats (see below) but these are treated as stat bonuses for wearing the specific armor.
| -
|-
| '''frontArmor'''
| Protection provided on the front of the unit.
| 0
|-
| '''sideArmor'''
| Protection provided on the sides of the unit.
| 0
|-
| '''rearArmor'''
| Protection provided on the rear of the unit.
| 0
|-
| '''underArmor'''
| Protection provided under the unit (eg. from explosions).
| 0
|-
| '''drawingRoutine'''
| Drawing routine used to put together the body parts in the unit's '''spriteSheet''':
* 0 = [[Soldier]], [[Sectoid]]
* 1 = [[Floater]]
* 2 = [[HWP]]
* 3 = [[Cyberdisk]]
* 4 = [[Civilian]], [[Ethereal]]
* 5 = [[Sectopod]], [[Reaper]]
* 6 = [[Snakeman]]
* 7 = [[Chryssalid]]
* 8 = [[Silacoid]]
* 9 = [[Celatid]]
* 10 = [[Muton]]
| 0
|-
| '''movementType'''
| Type of movement provided by this armor:
* 0 = Walking
* 1 = Flying
* 2 = Sliding (no walking animation)
it also defines the body of an tank (32-images) in your spriteSheet or the change in sprites while flying using a flying armour see: [[TANKS.PCK]], [[XCOM_2.PCK]]
| 0
|-
| '''damageModifier'''
| List of decimal damage modifiers (1.0 = 100%) this armor applies to each damage type (see [[#Items|Items section]]) received. Modifiers must be specified for all damage types, in this order:
* None
* Armor Piercing
* Incendiary
* High Explosive
* Laser
* Plasma
* Stun
* Melee
* Acid
* Smoke
|
- 1.0 
- 1.0 
- 1.0 
- 1.0 
- 1.0 
- 1.0 
- 1.0 
- 1.0 
- 1.0 
- 1.0
|-
| '''size'''
| Size of the unit wearing this armor, in Battlescape grid units. Every unit is square, so a size of 2 means 2x2.
| 1
|-
| '''loftempsSet'''
| List of [[LOFTEMPS]] IDs (one per unit tile, so a 1x1 unit has 1, a 2x2 unit has 4, etc.) used to represent a unit wearing this armor in 3D space.
| -
|-
| '''loftemps'''
| loftemps is a deprecated option that only works for 1x1 sized units.
| -
|}

=== Player Units (Soldiers) ===

Defines a [[soldier]] recruited by X-COM, listed in ''"soldiers:"''. Currently only one soldier unit type (''XCOM'') is supported.

Unit stats are represented as follows:
* [[Time Units|tu]]
* [[Energy|stamina]]
* [[Health|health]]
* [[Bravery|bravery]] (always a multiple of 10)
* [[Reactions|reactions]]
* [[Firing Accuracy|firing]]
* [[Throwing Accuracy|throwing]]
* [[Strength|strength]]
* [[Psi Strength|psiStrength]]
* [[Psi Skill|psiSkill]]
* [[Melee Accuracy|melee]] (not visible)

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the soldier name.
| ''required''
|-
| '''minStats'''
| Minimum values used to generate the soldier's [[Starting Stats]]. In this case, ''psiSkill'' is treated as the initial stat (not generated).
| -
|-
| '''maxStats'''
| Maximum values used to generate the soldier's [[Starting Stats]]. In this case, ''psiSkill'' is treated as the minimum value for the first month of psi training (actual value is 100%-150%).
| -
|-
| '''statCaps'''
| Maximum stats this soldier can gain through [[Experience]]. '''NOTE:''' A stat will still go over the limit once, and then will no longer increase (see [[Experience#Regarding Caps|Regarding Caps]]).
| -
|-
| '''armor'''
| String ID of the [[#Armor|armor]] this soldier uses by default.
| -
|-
| '''standHeight'''
| Height of this soldier when standing.
| 0
|-
| '''kneelHeight'''
| Height of this soldier when kneeling.
| 0
|-
| '''floatHeight'''
| Distance between the bottom of this unit and the ground.
| 0
|}

=== AI Units (Aliens/Civilians) ===

Defines an [[Alien Life Forms|alien]] (enemy) or [[civilian]] (neutral) unit, listed in ''"units:"''. Every different alien rank is a different unit, since they have completely different stats. Unit stats are represented as follows:
* [[Time Units|tu]]
* [[Energy|stamina]]
* [[Health|health]]
* [[Bravery|bravery]] (always a multiple of 10)
* [[Reactions|reactions]]
* [[Firing Accuracy|firing]]
* [[Throwing Accuracy|throwing]]
* [[Strength|strength]]
* [[Psi Strength|psiStrength]]
* [[Psi Skill|psiSkill]]
* [[Melee Accuracy|melee]] (not visible)

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the unit name.
| ''required''
|-
| '''race'''
| String ID of the unit race (for alien units).
| -
|-
| '''rank'''
| String ID of the unit rank (for alien units).
| -
|-
| '''stats'''
| Battlescape stats of this unit.
| -
|-
| '''armor'''
| String ID of the [[#Armor|armor]] this unit uses by default.
| -
|-
| '''standHeight'''
| Height of this unit when standing.
| 0
|-
| '''floatHeight'''
| Distance between the bottom of this unit and the ground.
| 0
|-
| '''value'''
| [[Score]] this unit is worth.
| 0
|-
| '''deathSound'''
| Sound ID from [[SOUND#SAMPLE2.CAT|SAMPLE2.CAT]] played when this unit dies.
| -1
|-
| '''aggroSound'''
| Sound ID from [[SOUND#SAMPLE2.CAT|SAMPLE2.CAT]] played when this unit aggros.
| -1
|-
| '''moveSound'''
| Sound ID from [[SOUND#SAMPLE2.CAT|SAMPLE2.CAT]] played when this unit moves.
| -1
|-
| '''intelligence'''
| Intelligence of this unit's AI. The higher the value, the longer this unit remembers player troops.
| 0
|-
| '''aggression'''
| Aggression of this unit's AI. The higher the value, the more ruthless the unit.
| 0
|-
| '''energyRecovery'''
| Energy recovered by the unit each turn (needs verification)
| 40 (?)
|-
| '''specab'''
| Special ability of this unit:
* 0 = None
* 1 = [[Cyberdisc|Explodes on Death]]
* 2 = [[Bio-Drone|Burns Floor]]
* 3 = [[Zombie|Respawns on Death]]
| 0
|-
| '''spawnUnit'''
| String ID of the unit used to respawn on death (eg. [[Zombie]]s respawn as [[Chrysallid]]s).
| -
|-
| '''livingWeapon'''
| Is this unit a living weapon? (only attacks with a '''fixedWeapon''')
| false
|-
|}

=== Alien Races ===

Defines a [[Alien Life Forms|race]] used in [[Alien Missions]], listed in ''"alienRaces:"''. Heavily tied with deployment data.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''id'''
| String ID of the alien race name.
| ''required''
|-
| '''members'''
| Alien crew associated with this alien race (eg. race units + terrorist units), defined by a list of unit string IDs. Order here will define rank in terms of deployment. generally speaking the order is:
* 0 - Commander
* 1 - Leader
* 2 - Engineer
* 3 - Medic
* 4 - Navigator
* 5 - Soldier
* 6 - Terrorist 1
* 7 - Terrorist 2
but of course, not all races have all ranks, so the "fill in" rank would be listed multiple times (see ethereals).
|-
| '''retaliation'''
| retaliation enables/disables the race for retaliation missions.
| ''True''
| -
|}

=== Alien Deployments ===

Defines a Battlescape deployment data used in [[Alien Missions]] (such as alien and map configurations), listed in ''"alienDeployments:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the deployment name.
| ''required''
|-
| '''width'''
| Width of the Battlescape map in grid units.
| 0
|-
| '''length'''
| Length of the Battlescape map in grid units.
| 0
|-
| '''height'''
| Vertical height of the Battlescape map in grid units.
| 0
|-
| '''terrains'''
| list of string IDs of the [[#Terrains|terrain]] to choose from to generate this map. This is not used for UFO sites where the terrain comes from the Geoscape.
| -
|-
| '''shade'''
| Shade of the map (0-15, where 0 is full daytime and 15 is full nighttime). This is not used for UFO sites where the shade comes from the Geoscape.
| 0
|-
| '''nextStage'''
| String ID of the next deployment stage to use after this one, for multi-stage missions.
| -
|-
| '''data'''
| List of deployment data for each alien rank on this mission (see below).
| -
|}

Notes:
* '''terrains''' can also be used with UFOs, with the game using instead the listed terrain rather than the location of the UFO on Geoscape.
==== Deployment Data ====

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''alienRank'''
| [[Alien Rank|Rank]] associated with this deployment data, as defined by the order of the race in question (see above)
| ''required''
|-
| '''lowQty'''
| Maximum quantity of aliens to spawn (beginner).
| 0
|-
| '''highQty'''
| Maximum quantity of aliens to spawn (superhuman).
| 0
|-
| '''dQty'''
| Minimum Desired Quantity of aliens to spawn.
| 0
|-
| '''percentageOutsideUfo'''
| Percentage (0-100%) of aliens to spawn outside in UFO sites.
| 0
|-
| '''itemSets'''
| Three lists (one for each alien technology level) of [[#Items|items]] (string IDs) for the aliens to equip.
| ''required''
|-
|}

=== Research ===

Defines a [[Research|research topic]] that X-COM scientists can investigate, listed in ''"research:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''name'''
| String ID of the research project's name (or item, if a '''lookup''' is defined).
| ''required''
|-
| '''lookup'''
| String ID of the research project's display name and UFOPaedia article reference.
| -
|-
| '''cost'''
| Number of man hours (on average) required to complete this project.
| 0
|-
| '''points'''
| [[Score]] earned for completing this project.
| 0
|-
| '''needItem'''
| Does this project require an [[#Items|item]] of the same name?
| false
|-
| '''dependencies'''
| List of research projects that can unlock access to this one. If the full list is researched, or if one of the projects on the list "unlocks" this one, it becomes available.
| -
|-
| '''unlocks'''
| List of research projects unlocked, regardless of other dependencies, but not requirements, by completing this project (for example, any live alien unlocks "alien origins").
| -
|-
| '''requires'''
| List of research projects unilaterally required before this project can be unlocked (for example, "the martian solution" will not even be considered for unlocking until AFTER "alien origins" is completed).
| -
|-
| '''getOneFree'''
| List of "bonus" research projects that may be granted when completing this project (for example, alien medics will give you information on other alien races). Only applies to living aliens.
| -
|-
|}

=== Manufacture ===

Defines a [[Manufacture|manufacture project]] that X-COM engineers can produce, listed in ''"manufacture:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''name'''
| String ID of the manufacturing project's name (and the item it produces).
| ''required''
|-
| '''category'''
| String ID of the manufacturing project's category.
| -
|-
| '''requires'''
| List of [[#Research|topics]] (string IDs) that must be researched to unlock this project. If none are specified, this project is unlocked from the start.
| -
|-
| '''space'''
| Amount of [[Workshop]] space required to begin this project.
| 0
|-
| '''time'''
| Number of man hours (on average) required per item.
| 0
|-
| '''cost'''
| Monetary deduction per item manufactured.
| 0
|-
| '''requiredItems'''
| List of [[#Items|items]] required and consumed per item manufactured.
| -
|-
| '''producedItems'''
| List of [[#Items|items]] produced per each item consumed. If not specified, defaults to 1 item with the same string ID as the manufacture.
| 1
|-
|}

=== UFOpaedia Article ===

Defines an article in the in-game [[UFOpaedia]], listed in ''"ufopaedia:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''id'''
| String ID of the article name. This must match the ID of the object associated with this article, if applicable.
| ''required''
|-
| '''title'''
| String ID of the article title. If omitted, the '''id''' is used.
| -
|-
| '''type_id'''
| Type of this article:
* 0 = Unknown
* 1 = [[Craft]]
* 2 = [[Craft Armaments]]
* 3 = [[HWP]]
* 4 = [[Equipment (EU)|Equipment]]
* 5 = [[Armour]]
* 6 = [[Base Facilities]]
* 7 = Text & Image (eg. [[Alien Life Forms]], [[UFO Components]])
* 8 = Text (eg. [[Alien Research]])
* 9 = [[UFO]]
| 0
|-
| '''section'''
| String ID of the UFOpaedia section this article belongs in.
| -
|-
| '''requires'''
| List of [[#Research|topics]] (string IDs) that must be researched to unlock this article. If none are specified, this article is unlocked from the start.
| -
|-
| '''image_id'''
| Filename of the [[UP001.SPK-UP042.SPK|background image]] displayed on this article, if applicable.
| -
|-
| '''text'''
| String ID of the description displayed on this article.
| -
|-
| '''text_width'''
| Maximum width of the text displayed, only applicable to ''Text & Image'' articles.
| 0
|-
| '''rect_stats'''
| Rectangle ('''x''', '''y''', '''width''', '''height''') of the stats text on the screen, only applicable to ''Craft'' articles.
| 0
|-
| '''rect_text'''
| Rectangle ('''x''', '''y''', '''width''', '''height''') of the description text on the screen, only applicable to ''Craft'' articles.
| 0
|-
| '''weapon'''
| String ID of the weapon, only applicable to ''HWP'' articles.
| -
|}

=== UFO Trajectories ===

Defines a trajectory carried out by an UFO during an [[#Alien Missions|alien mission]], listed in ''"ufoTrajectories:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''id'''
| String ID of the trajectory name.
| ''required''
|-
| '''groundTimer'''
| Amount of seconds for the UFO to spend on Ground waypoints.
| 0
|-
| '''waypoints'''
| List of waypoints for the UFO to traverse, defined as ''[zone, altitude, speed]''. 
'''zone''': Globe zone where the waypoint is located. 
'''altitude''': UFO altitude after reaching this waypoint:
* 0 - Ground
* 1 - Very Low
* 2 - Low
* 3 - High
* 4 - Very High
'''speed''': UFO speed after reaching this waypoint, as a percentage (0-100%) of its maximum speed.
| -
|}

=== Alien Missions ===

Defines an [[Alien Missions|alien mission]] carried out by UFOs on the Geoscape, listed in ''"alienMissions:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the mission type.
| ''required''
|-
| '''points'''
| [[Score]] allocated to aliens for successfully completing this mission.
| 0
|-
| '''raceWeights'''
| List of alien races likely to carry out this mission, and the % chance of them being allocated to this mission, listed by "number of months after game beginning".
| ''required''
|-
| '''waves'''
| List of UFO waves to spawn as this mission progresses, as described below.
| ''required''
|}

==== Waves ====

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''ufo'''
| String ID of the [[#UFOs|UFO]] to spawn.
| ''required''
|-
| '''count'''
| Number of UFOs to spawn.
| 0
|-
| '''trajectory'''
| String ID of the [[#UFO Trajectories|trajectory]] for this UFO to use when entering Earth's atmosphere.
| ''required''
|-
| '''timer'''
| How long after the previous wave should this wave arrive? (in seconds)
| 0
|-
|}

=== Alien Item Levels ===

This is a list of item level probabilities, with a number between 0 and 2 representing an item level from plasma pistols to heavy plasmas, as defined in the deployments, expressing a 10% probability for that item level being used.

0 = first set (plasma pistol/clip)
1 = second set (plasma rifle/clip)
2 = third set (heavy plasma/clip)

For example:
[ 2, 0, 0, 0, 0, 0, 0, 1, 1, 1 ]
would represent a 60% chance for pistols, 30% rifles, and 10% heavy weapons. 
Note that the order does not matter, but the length DOES. each line MUST have 10 digits.

The above can be confusing. There are 10 fields; each number represents 10%. 
There is only one instance of '2'. 1x10% = 10% chance of plasma pistol 
There are three instances of '1'. 3x10% = 30% chance of plasma rifle 
There are six instances of '0'. 6x10% = 60% chance of heavy plasma 

Each line represents a month after the beginning of the game, and there is no limit to the number defined. 
OpenXCom will use the most recently available item level in the event the game goes on forever.

=== Extra Sprites ===

Adds or replaces sprites in an existing [[Image Formats|X-COM image file]], listed in ''"extraSprites:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| Filename of the original/new image to modify.
| ''required''
|-
| '''width'''
'''height'''
| Size of the sprite(s) in pixels.
| 0
0
|-
| '''singleImage'''
| Is the image file just a single sprite (true) or a spritesheet (false)?
| false
|-
| '''subX'''
'''subY'''
| Size of the subdivision in pixels. If a subdivision is specified, then the image file is divided into chunks to form the sprites (eg. spritesheets).
| 0
0
|-
| '''files'''
| List of the new sprites to add/replace, listed as ''spriteID: filename''.
| -
|}

Example:
- type: GIANTBUNNY.PCK
width: 32
height: 40
files:
0: Resources/Bunny/Bunny00.png
1: Resources/Bunny/Bunny01.bmp
2: Resources/Bunny/Bunny02.gif

=== Extra Sounds ===

Adds or replaces sounds in an existing [[SOUND|X-COM sound file]], listed in ''"extraSounds:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| ID of the original sound file to modify:
* BATTLE.CAT - Battlescape sounds, corresponds to ''SOUND1.CAT'' or ''SAMPLE2.CAT'' (55 sounds).
* INTRO.CAT - Intro sounds, corresponds to ''INTRO.CAT'' or ''SAMPLE3.CAT'', probably best not to mess with these.
* GEO.CAT - Geoscape sounds, corresponds to ''SOUND2.CAT'' or ''SAMPLE.CAT'' (14 sounds).
| ''required''
|-
| '''files'''
| List of the new sounds to add/replace, listed as ''soundID: filename''.
| -
|}

Example:
- type: BATTLE.CAT
files:
55: Resources/Sounds/sample.wav

=== Extra Strings ===

Adds or replaces text strings in an existing [[Translations (OpenXcom)|OpenXcom language file]], listed in ''"extraStrings:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| Filename of the original language file to modify, sans extension.
| ''required''
|-
| '''strings'''
| List of the new strings to add/replace, listed as ''stringID: text''.
| -
|}

Example:
- type: en-US
strings:
STR_SNIPER_RIFLE: Sniper Rifle
STR_SNIPER_RIFLE_CLIP: Sniper Rifle Clip
- type: en-GB
strings:
STR_SNIPER_RIFLE: Sniper Rifle
STR_SNIPER_RIFLE_CLIP: Sniper Rifle Clip
- type: de
strings:
STR_SNIPER_RIFLE: Scharfschützengewehr
STR_SNIPER_RIFLE_CLIP: Scharfschützengewehrmunition
- type: ru
strings:
STR_SNIPER_RIFLE: Снайперская винтовка
STR_SNIPER_RIFLE_CLIP: Магазин к снайп. винтовке

=== Interfaces ===

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| ''?''
| -
|-
| '''elements'''
| ''?''
| -
|-
| '''id'''
| ''?''
| -
|-
| '''color'''
| ''?''
| -
|}

=== StatStrings ===

[[Statstrings]] are used for automatically renaming soldiers. They are case sensitive and they are processed in the order in which they are specified.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''string'''
| String to add to name.
| ''required''
|-
| '''psiStrength''' 
'''psiSkill''' 
'''bravery''' 
'''strength''' 
'''firing''' 
'''reactions''' 
'''stamina''' 
'''tu''' 
'''health''' 
'''throwing'''
| One or more stat ranges are ANDed together for success. Each range has a minVal and maxVal. Use YAML standard tilde (~) to indicate null.
| -
|}

Example:
statStrings:
- string: "x"
psiStrength: [~, 30]
- string: "P"
psiStrength: [80, ~]
- string: "p"
psiStrength: [60, 79]
- string: "K"
psiSkill: [60, ~]
- string: "k"
psiSkill: [30, 59]
- string: "b"
bravery: [60, ~]
- string: "c"
bravery: [~, 10]
- string: "w"
strength: [~, 25]
- string: "Snpr"
firing: [60, ~]
reactions: [60, ~]
- string: "M"
firing: [70, ~]
- string: "m"
firing: [60, 69]
- string: "Sct"
reactions: [50, ~]
tu: [60, ~]
- string: "R"
reactions: [60, ~]
- string: "r"
reactions: [50, 59]

==References==
<references />

[[Category:OpenXcom]]

Ruleset Reference (OpenXcom)

2014-09-01T02:44:55Z

Falko: geo.cat is the oxc id

A reference of all the customizable values of everything in a [[Rulesets (OpenXcom)|ruleset]]. Some guidelines:
* If a value is omitted from the ruleset, the default is used. You cannot omit ''required'' values.
* Text strings (eg. names) are represented by string IDs from the [[Translations (OpenXcom)|language files]]
* Numerical IDs (used for sprites, sounds, etc.) start at 0, not 1.
* Boolean (yes/no) values are represented by true/false.
* World coordinates are represented in degrees (see [[WORLD.DAT]]).
* Money amounts (prices, costs, etc.) are represented in dollars.
* All paths are '''case sensitive'''! If your ruleset uses external files, make sure that they named properly as described in ruleset.

Items are ordered as they come in the ruleset. To override this, you can specify a ''listOrder''. You can find the default listOrders in [[Ruleset List Order (OpenXcom)|Ruleset List Order]].

=== Globe ===

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''data'''
| ''path name of ?.''
| ''required''
|-
| '''polylines'''
| ''?''
| -
|}

=== Countries ===

Defines one of the [[Country Funding (EU)|funding nations]], listed in ''"countries:"''. They're used for activity graphs and player scoring.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the country name.
| ''required''
|-
| '''fundingBase'''
| Country's base funding, in thousands. The starting funding can be anywhere between 1x and 2x the base funding.
| 0
|-
| '''fundingCap'''
| Country's funding cap, in thousands. Once a country reaches this maximum, it will no longer increase its funding.
| 0
|-
| '''labelLon'''
'''labelLat'''
| Longitude and latitude coordinates of the country's label on the globe. This label is only shown when the globe is zoomed in and "detail" is turned on.
| 0.0
0.0
|-
| '''areas'''
| List of "rectangles" on the globe defined as [''lon1'' ''lat1'' ''lon2'' ''lat2'']. Any activity within these areas counts towards the country's graph activity and affects their opinion of the player.
| -
|}

=== Regions ===

Defines one of the [[Geoscape (EU)#World Regions/Countries|world regions]], listed in ''"regions:"''. They're used for base placement, activity graphs and mission spawning.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the region name.
| ''required''
|-
| '''cost'''
| Amount of money spent building an X-COM base in this region (first base is free).
| 0
|-
| '''areas'''
| List of "rectangles" on the globe defined as ''[lon1, lat1, lon2, lat2]''. Any activity within these areas counts towards the region's graph activity.
| -
|-
| '''cities'''
| List of cities belonging to this region. They will be displayed on the globe and used for terror site missions. Each city is defined by their '''lon''' and '''lat''' coordinates and a '''name''' string ID.
| -
|-
| '''regionWeight'''
| Weight of this region when selecting regions for alien missions.
| 0
|-
| '''missionWeights'''
| Weighted list of the different mission types for this region (eg. ''STR_ALIEN_RESEARCH: 14'').
| -
|-
| '''missionZones'''
| List of "rectangles" (''[lon1, lat1, lon2, lat2]'') defining the mission zones for this region.
| -
|-
| '''missionRegion'''
| Spawn mission in this region instead (used for regions without land).
| -
|}

=== Base Facilities ===

Defines one of the [[Base Facilities (EU)|facilities]] that can be built in an X-COM base, listed in ''"facilities:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the facility name.
| ''required''
|-
| '''requires'''
| List of [[#Research|topics]] (string IDs) that must be researched to unlock this facility. If none are specified, this facility is unlocked from the start.
| -
|-
| '''spriteShape'''
| Sprite ID from [[BASEBITS.PCK]] used to draw the facility's outer shape in the Basescape and UFOpaedia.
| -1
|-
| '''spriteFacility'''
| Sprite ID from [[BASEBITS.PCK]] used to draw the facility's contents in the Basescape and UFOpaedia. Drawn on top of '''spriteShape'''.
| -1
|-
| '''lift'''
| Is this facility an [[Access Lift]]? All base facilities must be connected to the lift.
| false
|-
| '''hyper'''
| Is this facility a [[Hyperwave Decoder]]? Displays extra information for detected UFOs. Only valid for radar facilities.
| false
|-
| '''mind'''
| Is this facility a [[Mind Shield]]? Reduces the chance of UFOs finding your base. Does not stack.
| false
|-
| '''grav'''
| Is this facility a [[Grav Shield]]? Doubles the power of your base defenses. Does not stack.
| false
|-
| '''size'''
| Size of the facility, in grid units. Every facility is square, so a size of 1 means 1x1, 2 means 2x2, etc. Bigger facilities are made up of multiple sprites, for example a 2x2 facility will use 4 sprites for '''spriteShape''' and 4 sprites for '''spriteFacility''' (top-left, top-right, bottom-left, bottom-right).
| 1
|-
| '''buildCost'''
| Amount of money spent to build this facility in the base.
| 0
|-
| '''buildTime'''
| Amount of days it takes for this facility to be built.
| 0
|-
| '''monthlyCost'''
| Amount of money spent monthly for the maintenance of this facility.
| 0
|-
| '''storage'''
| Amount of storage space (for items) this facility provides. See [[Base Stores]].
| 0
|-
| '''personnel'''
| Amount of personnel (soldiers, scientsts, engineers) these quarters can contain.
| 0
|-
| '''aliens'''
| Amount of live aliens this facility can contain. Only checked if the ''alienContainmentLimitEnforced'' option is enabled.
| 0
|-
| '''crafts'''
| Amount of X-COM craft this facility can contain.
| 0
|-
| '''labs'''
| Amount of lab space this facility provides for research projects.
| 0
|-
| '''workshops'''
| Amount of workshop space this facility provides for manufacture projects.
| 0
|-
| '''psiLabs'''
| Amount of soldier space this facility provides for psionic training.
| 0
|-
| '''radarRange'''
| Maximum radar detection range of this facility, in nautical miles.
| 0
|-
| '''radarChance'''
| Chance (0-100%) of this radar detecting a UFO that enters its range.
| 0
|-
| '''defense'''
| Offensive power provided by this base defense against attacking UFOs.
| 0
|-
| '''hitRatio'''
| Chance (0-100) of the base defense hitting an attacking UFO.
| 0
|-
| '''fireSound'''
| Sound ID from [[SOUND#SAMPLE.CAT|SAMPLE.CAT]] played when the base defense fires.
| -1
|-
| '''hitSound'''
| Sound ID from [[SOUND#SAMPLE.CAT|SAMPLE.CAT]] played when the base defense hits a target.
| -1
|-
| '''mapName'''
| [[MAPS|Map]] associated to this facility in Battlescape base defenses.
| -
|-
|}

=== Crafts ===

Defines one of the [[Craft|X-COM crafts]] that go on interception missions, listed in ''"crafts:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the craft name.
| ''required''
|-
| '''requires'''
| List of [[#Research|topics]] (string IDs) that must be researched to unlock this craft. If none are specified, this craft is unlocked from the start.
| -
|-
| '''sprite'''
| Sprite ID from [[BASEBITS.PCK]] used to draw this craft in the Basescape and from [[INTICON.PCK]] used to draw the damage indicator in dogfights.
modders: the corresponding extrasprite file id for BASEBITS.PCK is sprite+33 INTICON.PCK contains a minimized icon id=sprite the file id for the dogfight image is sprite+11
| -1
|-
| '''fuelMax'''
| Maximum amount of fuel this craft can carry. Crafts use up fuel based on their speed while travelling.
| 0
|-
| '''damageMax'''
| Maximum amount of damage this craft can take. If this amount is exceeded, the craft is destroyed.
| 0
|-
| '''speedMax'''
| Maximum speed in nautical miles. Crafts travel at max speed when flying and half speed when patrolling.
| 0
|-
| '''accel'''
| Aceeleration value shown in the UFOpaedia.
| 0
|-
| '''weapons'''
| Amount of craft weapons this craft can equip. The UI can only display a max of 2 weapons.
| 0
|-
| '''soldiers'''
| Amount of soldiers this craft can carry.
| 0
|-
| '''maxItems'''
| Amount of items this craft can carry.
| 80
|-
| '''vehicles'''
| Amount of vehicles this craft can carry.
| 0
|-
| '''costBuy'''
| Amount of money spent for purchasing this craft. If set to 0, the craft will not be available in the Purchase/Recruit screen.
| 0
|-
| '''costRent'''
| Amount of money spent monthly for renting this craft. If set to 0, the craft is not on rental and won't count towards base maintenance.
| 0
|-
| '''costSell'''
| Amount of money gained for selling this craft.
| 0
|-
| '''refuelItem'''
| Item required for refuelling this craft. If no item is specified, the craft uses human fuel.
| 0
|-
| '''repairRate'''
| Amount of damage restored every hour while [[Repairs|Repairing]] in base.
| 1
|-
| '''refuelRate'''
| Amount of fuel restored every 30 mins while [[Refueling]] in base. If specified, a '''refuelItem''' is spent each time.
| 1
|-
| '''radarRange'''
| Detection range of the craft's radar in nautical miles. Every craft radar has a 100% detection chance.
| 600
|-
| '''transferTime'''
| Number of hours it takes to purchase/transfer this craft to a base.
| 0
|-
| '''score'''
| [[Score]] lost when this craft is destroyed.
| 0
|-
| '''spacecraft'''
| Can this craft go to [[Cydonia]]?
| false
|-
| '''battlescapeTerrainData'''
| [[#Terrains|Terrain]] associated to this craft in Battlescape missions.
| -
|}

=== Craft Weapons ===

Defines one of the [[Craft Armaments|weapons]] equipped by X-COM craft for shooting down UFOs, listed in ''"craftWeapons:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the weapon name.
| ''required''
|-
| '''sprite'''
| Sprite ID from [[BASEBITS.PCK]] used to draw the weapon in the Basescape and from [[INTICON.PCK]] used to draw the weapon in dogfights.
modders: the corresponding extrasprites file id for INTICON.PCK is sprite+5 and sprite+48 for BASEBITS.PCK
| -1
|-
| '''sound'''
| Sound ID from GEO.CAT played when this weapon fires.
| -1
|-
| '''damage'''
| Amount of damage this weapon does to enemy UFOs.
| 0
|-
| '''range'''
| Maximum range of this weapon in dogfights (in meters).
| 0
|-
| '''accuracy'''
| Chance (0-100%) of each shot hitting the enemy UFO.
| 0
|-
| '''reloadCautious'''
| Time this weapon takes to fire between each shot in ''Cautious Mode''.
| 0
|-
| '''reloadStandard'''
| Time this weapon takes to fire between each shot in ''Standard Mode''.
| 0
|-
| '''reloadAggressive'''
| Time this weapon takes to fire between each shot in ''Aggressive Mode''.
| 0
|-
| '''ammoMax'''
| Maximum amount of ammo this weapon can carry.
| 0
|-
| '''rearmRate'''
| Amount of ammo restored every 30 mins while the craft is [[Rearming]] in base. If specified, '''clip'''s are spent depending on their '''clipSize'''. If the '''clipSize''' of the specified ammo is 0, no '''clip'''s are spent.
| 1
|-
| '''projectileType'''
| Type of the weapon projectile, used for the projectile sprite in dogfights:
* 0 - [[Stingray]]
* 1 - [[Avalanche]]
* 2 - [[Cannon]]
* 3 - [[Fusion Ball]]
* 4 - [[Laser Cannon]]
* 5 - [[Plasma Beam]]
| 2
|-
| '''projectileSpeed'''
| Speed of the weapon projectile in dogfights.
| 0
|-
| '''launcher'''
| String ID of the [[#Items|item]] required to equip this weapon.
| -
|-
| '''clip'''
| String ID of the [[#Items|item]] required to rearm this weapon.
| -
|}

=== Items ===

Defines the Geoscape and Battlescape properties of an [[Equipment (EU)|item]] that can be stored in X-COM bases, listed in ''"items:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the internal item name.
| ''required''
|-
| '''name'''
| String ID of the displayed item name, for cases where it's different from the internal name. If omitted, '''type''' is used.
| -
|-
| '''requires'''
| List of [[#Research|topics]] (string IDs) that must be researched to unlock this item. If none are specified, this item is unlocked from the start. Soldiers can only use unlocked items in the Battlescape.
| -
|-
| '''size'''
| Space occupied by this item in [[Base Stores]]. Can be a decimal value.
| 0.0
|-
| '''costBuy'''
| Amount of money spent for purchasing this item. If set to 0, this item will not be available in the Purchase/Recruit screen.
| 0
|-
| '''costSell'''
| Amount of money gained for selling this item.
| 0
|-
| '''transferTime'''
| Number of hours it takes to purchase/transfer this item to a base.
| 24
|-
| '''weight'''
| [[Item_Weight|Weight]] occupied by this item in a soldier's inventory.
| 999
|-
| '''bigSprite'''
| Sprite ID from [[BIGOBS.PCK]] used to draw this item in a soldier's inventory and UFOpaedia.
| -1
|-
| '''floorSprite'''
| Sprite ID from [[FLOOROB.PCK]] used to draw this item on the floor of a Battlescape tile.
| -1
|-
| '''handSprite'''
| Sprite ID from [[HANDOB.PCK]] used to draw this item on a soldier's hand in the Battlescape.
modders: each handobject needs 8 images (8 directions) define the extrasprites accordingly
| 120
|-
| '''bulletSprite'''
| Sprite ID from ''BulletSprites.png'' used to draw this weapon's projectile on the Battlescape:
* 0 - [[Rocket Launcher]]
* 1 - [[Pistol]]
* 2 - [[Rifle]]
* 3 - [[Auto Cannon]]
* 4 - [[Heavy Cannon]]
* 5 - [[Laser Pistol]]
* 6 - [[Laser Rifle]]
* 7 - [[Heavy Laser]]
* 8 - [[Plasma Rifle|Plasma]]
* 9 - [[Small Launcher]]
* 10 - [[Blaster Launcher]]
for modders: the bulletsprite needs to be put into the extraSprites type "Projectiles" the bulletsprite can contain up to 35 3x3 images
| -1
|-
| '''fireSound'''
| Sound ID from [[SOUND#SAMPLE2.CAT|SAMPLE2.CAT]] played when this weapon fires.
| -1
|-
| '''hitSound'''
| Sound ID from [[SOUND#SAMPLE2.CAT|SAMPLE2.CAT]] played when this weapon hits a target.
| -1
|-
| '''hitAnimation'''
| Sprite ID from [[SMOKE.PCK]] used to draw the weapon's "hit explosion".
'''NOTE''': Do not define this value for melee/psi weapons, they use [[HIT.PCK]] and therefore meleeAnimation instead.
| 0
|-
| '''power'''
| Average damage of the weapon, in most cases it will be +-50% this value.
| 0
|-
| '''strengthApplied'''
| Add the attacking unit's strength to this weapon's damage.
| false
|-
| '''compatibleAmmo'''
| List of string IDs of the ammo items that can be loaded on this weapon. If none are specified, the weapon doesn't need ammo.
| -
|-
| '''damageType'''
| What type of [[damage]] does this weapon do:
* 0 - None
* 1 - Armor Piercing
* 2 - Incendiary
* 3 - High Explosive
* 4 - Laser
* 5 - Plasma
* 6 - Stun
* 7 - Melee
* 8 - Acid
* 9 - Smoke
'''NOTE:''' A damage type other than 0-9 will do nothing.
| 0
|-
| '''tuAuto'''
'''accuracyAuto'''
| The percentage (0-100%) of [[Time Units]] (from the soldier's total) required to fire an Auto Shot. If 0, the weapon does not have an Auto Shot.
The base accuracy (0-100%) applied to a soldier's [[Firing Accuracy]] when firing an Auto Shot.
| 0
0
|-
| '''tuSnap'''
'''accuracySnap'''
| The percentage (0-100%) of [[Time Units]] (from the soldier's total) required to fire a Snap Shot. If 0, the weapon does not have a Snap Shot.
The base accuracy (0-100%) applied to a soldier's [[Firing Accuracy]] when firing a Snap Shot.
| 0
0
|-
| '''tuAimed'''
'''accuracyAimed'''
| The percentage (0-100%) of [[Time Units]] (from the soldier's total) required to fire an Aimed Shot. If 0, the weapon does not have an Aimed Shot.
The base accuracy (0-100%) applied to a soldier's [[Firing Accuracy]] when firing an Aimed Shot.
| 0
0
|-
|-
| '''tuMelee'''
'''accuracyMelee'''
| The percentage (0-100%) of [[Time Units]] (from the soldier's total) required to do a melee attack (Hit). If 0, the weapon does not have a melee attack.
The base accuracy (0-100%) applied to a soldier's [[Melee Accuracy]] when doing a melee attack.
| 0
0
|-
| '''clipSize'''
| The amount of ammo stored in each weapon clip. If -1 is specified, this weapon has infinite ammo.
| 0
|-
| '''battleType'''
| Defines the weapon's behavior in the Battlescape:
* 0 - None (Geoscape-only item)
* 1 - [[Weapons|Firearm]]
* 2 - Ammo
* 3 - Melee
* 4 - [[Grenade]]
* 5 - [[Proximity Grenade]]
* 6 - [[Medi-Kit (EU)|Medi-Kit]]
* 7 - [[Motion Scanner]]
* 8 - [[Mind Probe]]
* 9 - [[Psi-Amp]]
* 10 - [[Electro-flare]]
* 11 - Corpse
| 0
|-
| '''twoHanded'''
| Is this weapon two-handed? (incurs an accuracy penalty if used with both hands occupied)
| false
|-
| '''waypoint'''
| Does this weapon use waypoints? (eg. [[Blaster Launcher]]). Can also be used to make ammo items use the waypoint system.
| false
|-
| '''fixedWeapon'''
| Is this weapon fixed? (it's part of a unit, eg. tanks and terrorist units)
| false
|-
| '''invWidth'''
| Item width in a soldier's inventory (in grid units).
| 1
|-
| '''invHeight'''
| Item height in a soldier's inventory (in grid units).
| 1
|-
| '''painKiller'''
| Amount of painkillers contained in a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''heal'''
| Amount of heal's contained in a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''stimulant'''
| Amount of stimulants contained in a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''woundRecovery'''
| Amount of [[Fatal Wounds]] treated by each heal of a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''healthRecovery'''
| Amount of [[Health]] recovered by each heal of a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''stunRecovery'''
| Amount of [[Stun]] removed by each stimulant of a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''energyRecovery'''
| Amount of [[Energy]] recovered by each stimulant of a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''tuUse'''
| Amount of [[Time Units]] required to use this item (for non-offensive items). It's a flat rate if '''flatRate''' is true, otherwise it's a percentage (0-100%).
| 0
|-
| '''recoveryPoints'''
| [[Score]] gained for recovering this alien artifact.
| 0
|-
| '''armor'''
| How much damage is needed to destroy this item on the ground.
| 20
|-
| '''recover'''
| Is this item recoverable? (gets transported to the X-COM base on mission success)
| true
|-
| '''turretType'''
| Sprite ID from [[TANKS.PCK]] of the turret to assign to this tank:
* 0 - [[Tank/Cannon]]
* 1 - [[Tank/Rocket Launcher]]
* 2 - [[Tank/Laser Cannon]]
* 3 - [[Hovertank/Plasma]]
* 4 - [[Hovertank/Launcher]]
| -1
|-
| '''liveAlien'''
| Does this item represent a live alien? (counts towards [[Alien Containment]])
| false
|-
| '''blastRadius'''
| Size of the projectile explosions. 0 for no explosion. -1 to automatically calculate based on weapon power and damage type (actual '''blastRadius''' currently is capped due [[Explosions#Playing_With_Fire|Explosion calculations]]).
| -1
|-
| '''flatRate'''
| If true, then TU costs for this weapon are a flat rate (instead of a percentage of unit TUs).
| false
|-
| '''arcingShot'''
| Does this weapon fire in an arc?
| false
|-
| '''attraction'''
| Represents how likely an alien is to pick up this item. Values below 5 will be ignored (by design).
| 0
|-
| '''maxRange'''
| Maximum range at which this weapon can operate.
| 200
|-
| '''aimRange'''
| Maximum effective range with this weapon before which range-based dropoff occurs.
| 200
|-
| '''snapRange'''
| Maximum effective range with snap shot before which range-based dropoff occurs. (ufoextender accuracy only)
| 15
|-
| '''autoRange'''
| Maximum effective range with auto shot before which range-based dropoff occurs. (ufoextender accuracy only)
| 7
|-
| '''minRange'''
| Range-based dropoff will work in reverse for ranges below this.
| 0
|-
| '''dropoff'''
| The value by which the accuracy lowers for each tile after (or before) the thresholds above.
| 2
|-
| '''bulletSpeed'''
| How much faster (or slower, if you use a negative number) is a projectile fired from this weapon compared to the average.
| 0
|-
| '''autoShots'''
| How many auto shots does this weapon fire.
| 3
|-
| '''shotgunPellets'''
| Number of projectiles fired per unit of ammunition. (note: due to engine limitations it is currently impossible to draw multiple projectiles in flight.)
| 0
|-
| '''zombieUnit'''
| String ID of the unit used for zombification (eg. [[Chrysallid]]s turn units into [[Zombie]]s).
| none
|-
| '''meleeSound'''
| Sound ID from [[SOUND#SAMPLE2.CAT|SAMPLE2.CAT]] played when this weapon attacks a target with melee.
| 39
|-
| '''meleeHitSound'''
| Sound ID from [[SOUND#SAMPLE2.CAT|SAMPLE2.CAT]] played when this weapon HITS a target with melee.
| -1
|-
| '''meleeAnimation'''
| Sprite ID from HIT.PCK played when this weapon attacks a target with melee.
| 0
|-
| '''meleePower'''
| Damage this weapon will do when using melee. This only applies to Firearms, and is only available as stun damage. For normal melee weapons, use regular power and damage types.
| 0
|-
| '''LOSRequired'''
| Does this item require line of sight? (only applies to mind probes and psi-amps)
| false
|-
| '''skillApplied'''
| Is melee skill applied to the accuracy of an attack made with this object?
| true
|-
|}

=== UFOs ===

Defines one of the [[UFOs]] that invade Earth, listed in ''"ufos:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the UFO name.
| ''required''
|-
| '''size'''
| String ID of the UFO size.
| STR_VERY_SMALL
|-
| '''sprite'''
| Sprite ID from [[INTERWIN.DAT]] used to draw this UFO in the dogfight view and UFOpaedia.
don't try to add more images if you don't want to punch yourself in the face - use modsprite
| -1
|-
| '''modSprite'''
| Filename used to draw this UFO in the dogfight view and UFOpaedia.
| -
|-
| '''damageMax'''
| Maximum amount of damage this UFO can take. If the UFO takes 50% damage, it crash lands. If it takes 100% damage, it is destroyed.
| 0
|-
| '''speedMax'''
| Maximum speed in nautical miles.
| 0
|-
| '''accel'''
| Aceeleration value shown in the UFOpaedia.
| 0
|-
| '''power'''
| Damage power of this UFO's weapon in dogfights.
| 0
|-
| '''range'''
| Maximum range of this UFO's weapon in dogfights (in meters).
| 0
|-
| '''score'''
| [[Score]] gained when this UFO is destroyed, or half this score if it crash lands.
| 0
|-
| '''reload'''
| Time the UFO's weapon takes to fire between each shot.
| 0
|-
| '''breakOffTime'''
| Minimum amount of time for the UFO to be able to break off of a dogfight.
| 0
|-
| '''battlescapeTerrainData'''
| [[#Terrains|Terrain]] associated to this UFO in Battlescape missions.
| ''required''
|-
|}

=== Inventory Sections ===

Defines one of the sections of the [[Inventory TU Table|Battlescape inventory]] (eg. Backpack), listed in ''"invs:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the inventory name.
| ''required''
|-
| '''x'''
'''y'''
| Pixel coordinates of this section on the inventory screen.
| 0
0
|-
| '''type'''
| Type of this section:
* 0 = Slot section, can contain as many items as will fit on the slots.
* 1 = Hand section, can only contain one item regardless of size.
* 2 = Ground section, can contain infinite items.
| 0
|-
| '''slots'''
| List of the grid slots (''[x, y]'') that this section is composed of. For example, to make a 2x2 section, you would have ''[0, 0] [0, 1] [1, 0] [1, 1]''.
| -
|-
| '''costs'''
| List of [[Time Units]] costs to move an item from this section to another one (eg. ''STR_BACKPACK: 16'' means it will cost 16 TUs to move an item from this section to the Backpack).
| -
|-
|}

=== Terrains ===

Defines one of the [[TERRAIN|terrains]] used to generate a Battlescape map, listed in "terrains:".

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''name'''
| String ID of the terrain name.
| ''required''
|-
| '''largeBlockLimit'''
| Maximum amount of large blocks that can be used on map generation.
| 0
|-
| '''textures'''
| List of [[TEXTURE.DAT|Geoscape textures]] that correspond to this terrain.
| -
|-
| '''hemisphere'''
| Geoscape hemisphere associated with this terrain:
* -1 - Northern hemisphere.
* 0 - Both hemispheres.
* 1 - Southern hemisphere.
| 0
|-
| '''mapDataSets'''
| List of filenames (each with matching [[MCD]]/[[Image Formats#PCK|PCK/TAB]] files) that contain the tiles of this terrain.
| -
|-
| '''mapBlocks'''
| List of map blocks (see below) that are used for generating a map.
| -
|-
| '''roadTypeOdds'''
| Odds as a % of generating each type of road (E-W Road, N-S Road, Crossing) odds for crossing are: 100 - EW - NS.
| [0 0]
|-|-
| '''civilianTypes'''
| List of units to use as civilians for this mission.
| [MALE_CIVILIAN, FEMALE_CIVILIAN]
|-
|}

==== Map Blocks ====

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''name'''
| Filename of the [[MAPS|map]].
| ''required''
|-
| '''width'''
| Width of this map block in Battlescape grid units.
| 0
|-
| '''length'''
| Length of this map block in Battlescape grid units.
| 0
|-
| '''height'''
| Height of this map block in Battlescape grid units.
| 1
|-
| '''type'''
| Type of this map block:
* -1 - Undefined
* 0 - Default
* 1 - Landing Zone (for placing X-COM / alien craft)
* 2 - E-W Road (for city maps)
* 3 - N-S Road (for city maps)
* 4 - Road Crossing (for city maps)
* 5 - Dirt (for filling empty base blocks)
* 6 - X-COM spawn point (for [[Alien Base]] / [[Cydonia]] missions)
* 7 - [[Alien Base]] Target
* 8 - [[Cydonia]] Target
| -1
|-
| '''subType'''
| Sub-type of this map block (see '''type''').
| -1
|-
| '''frequency'''
| Frequency of this block in a map.
| 1
|-
| '''maxCount'''
| Maximum amount of times this block can be used in a map. If -1 there is no limit.
| -1
|-
| '''items'''
| An array of items to add to this mapblock, an the positions to place them at.
| -1
|}

*'''frequency''' defines the odds of the map appearing on the map
** The value assigned (default: 1) is used in ''x/n'', which defines the probability of being chosen.
** ''x'' is the integer defined for the map block's frequency and ''n'' is the combined total of probabilities for all the map types combined.
** This property can only be used in type 0 map blocks.
*'''maxCount''' is the maximum number of times it can be used.
** The value assigned is also used in ''x/n'' to determine the probability of being chosen.
** Each use reduces ''x'' by -1, with the caveat that being used as a Landing Zone type will not reduce the x value since it could result in no available Landing Zones.
** This property can only be used in type 0 map blocks.
* '''hemisphere''' only applies to UFO missions, not Terror ones.
*'''width/length''' defines the size of the map
** be aware that the mapview "width"-label is the openxcom ruleset length parameter
** be aware that the mapview "length"-label is the openxcom ruleset width parameter

==== Guidelines/Tips ====
* All maps with an XCOM/Alien craft require at least one type 1 map block. This map block can only contain ground tiles (no walls or objects), otherwise the game will crash or the walls/objects will be removed.
* All Terror terrains (listed under STR_TERROR_MISSION) require at least 1 map block of '''Types''' 2, 3 and 4 (for a total of 3 maps, which are required to place roads) and the corresponding '''roadTypeOdds''' added to the ruleset.
* If there isn't any map blocks designed as roads since you want to keep your terrain 'random', this can be circumvented by designating all 10x10 map blocks, excluding the one(s) used for the XCOM craft, as either '''Type''' 2, 3 and 4 and by defining their '''subType''' to 0. The game will then randomly choose between the map blocks for each type used in the roads, making them map more random.

=== Armor ===

Defines a Battlescape unit's [[armor]] as well as visual representation (so every unit has an armor), listed in ''"armors:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the armor name.
| ''required''
|-
| '''spriteSheet'''
| Sprite sheet from [[UNITS]] used to draw a unit wearing this armor.
| -
|-
| '''spriteInv'''
| Sprite used for the [[Inventory Backgrounds]] of a unit wearing this armor.
| -
|-
| '''corpseBattle'''
| List of string IDs of the corpse [[#Items|items]] generated when a unit wearing this armor is killed (one per unit tile) on the Battlescape.
| -
|-
| '''corpseGeo'''
| String ID of the corpse [[#Items|item]] associated with this unit on the Geoscape.
| -
|-
| '''storeItem'''
| String ID of the [[#Items|item]] that represents this armor in [[Base Stores]] for equipping.
| -
|-
| '''weight'''
| Physical weight of the armor when worn
| 6
|-
| '''stats'''
| like soldier stats (see below) but these are treated as stat bonuses for wearing the specific armor.
| -
|-
| '''frontArmor'''
| Protection provided on the front of the unit.
| 0
|-
| '''sideArmor'''
| Protection provided on the sides of the unit.
| 0
|-
| '''rearArmor'''
| Protection provided on the rear of the unit.
| 0
|-
| '''underArmor'''
| Protection provided under the unit (eg. from explosions).
| 0
|-
| '''drawingRoutine'''
| Drawing routine used to put together the body parts in the unit's '''spriteSheet''':
* 0 = [[Soldier]], [[Sectoid]]
* 1 = [[Floater]]
* 2 = [[HWP]]
* 3 = [[Cyberdisk]]
* 4 = [[Civilian]], [[Ethereal]]
* 5 = [[Sectopod]], [[Reaper]]
* 6 = [[Snakeman]]
* 7 = [[Chryssalid]]
* 8 = [[Silacoid]]
* 9 = [[Celatid]]
* 10 = [[Muton]]
| 0
|-
| '''movementType'''
| Type of movement provided by this armor:
* 0 = Walking
* 1 = Flying
* 2 = Sliding (no walking animation)
it also defines the body of an tank (32-images) in your spriteSheet or the change in sprites while flying using a flying armour see: [[TANKS.PCK]], [[XCOM_2.PCK]]
| 0
|-
| '''damageModifier'''
| List of decimal damage modifiers (1.0 = 100%) this armor applies to each damage type (see [[#Items|Items section]]) received. Modifiers must be specified for all damage types, in this order:
* None
* Armor Piercing
* Incendiary
* High Explosive
* Laser
* Plasma
* Stun
* Melee
* Acid
* Smoke
|
- 1.0 
- 1.0 
- 1.0 
- 1.0 
- 1.0 
- 1.0 
- 1.0 
- 1.0 
- 1.0 
- 1.0
|-
| '''size'''
| Size of the unit wearing this armor, in Battlescape grid units. Every unit is square, so a size of 2 means 2x2.
| 1
|-
| '''loftempsSet'''
| List of [[LOFTEMPS]] IDs (one per unit tile, so a 1x1 unit has 1, a 2x2 unit has 4, etc.) used to represent a unit wearing this armor in 3D space.
| -
|-
| '''loftemps'''
| loftemps is a deprecated option that only works for 1x1 sized units.
| -
|}

=== Player Units (Soldiers) ===

Defines a [[soldier]] recruited by X-COM, listed in ''"soldiers:"''. Currently only one soldier unit type (''XCOM'') is supported.

Unit stats are represented as follows:
* [[Time Units|tu]]
* [[Energy|stamina]]
* [[Health|health]]
* [[Bravery|bravery]] (always a multiple of 10)
* [[Reactions|reactions]]
* [[Firing Accuracy|firing]]
* [[Throwing Accuracy|throwing]]
* [[Strength|strength]]
* [[Psi Strength|psiStrength]]
* [[Psi Skill|psiSkill]]
* [[Melee Accuracy|melee]] (not visible)

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the soldier name.
| ''required''
|-
| '''minStats'''
| Minimum values used to generate the soldier's [[Starting Stats]]. In this case, ''psiSkill'' is treated as the initial stat (not generated).
| -
|-
| '''maxStats'''
| Maximum values used to generate the soldier's [[Starting Stats]]. In this case, ''psiSkill'' is treated as the minimum value for the first month of psi training (actual value is 100%-150%).
| -
|-
| '''statCaps'''
| Maximum stats this soldier can gain through [[Experience]]. '''NOTE:''' A stat will still go over the limit once, and then will no longer increase (see [[Experience#Regarding Caps|Regarding Caps]]).
| -
|-
| '''armor'''
| String ID of the [[#Armor|armor]] this soldier uses by default.
| -
|-
| '''standHeight'''
| Height of this soldier when standing.
| 0
|-
| '''kneelHeight'''
| Height of this soldier when kneeling.
| 0
|-
| '''floatHeight'''
| Distance between the bottom of this unit and the ground.
| 0
|}

=== AI Units (Aliens/Civilians) ===

Defines an [[Alien Life Forms|alien]] (enemy) or [[civilian]] (neutral) unit, listed in ''"units:"''. Every different alien rank is a different unit, since they have completely different stats. Unit stats are represented as follows:
* [[Time Units|tu]]
* [[Energy|stamina]]
* [[Health|health]]
* [[Bravery|bravery]] (always a multiple of 10)
* [[Reactions|reactions]]
* [[Firing Accuracy|firing]]
* [[Throwing Accuracy|throwing]]
* [[Strength|strength]]
* [[Psi Strength|psiStrength]]
* [[Psi Skill|psiSkill]]
* [[Melee Accuracy|melee]] (not visible)

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the unit name.
| ''required''
|-
| '''race'''
| String ID of the unit race (for alien units).
| -
|-
| '''rank'''
| String ID of the unit rank (for alien units).
| -
|-
| '''stats'''
| Battlescape stats of this unit.
| -
|-
| '''armor'''
| String ID of the [[#Armor|armor]] this unit uses by default.
| -
|-
| '''standHeight'''
| Height of this unit when standing.
| 0
|-
| '''floatHeight'''
| Distance between the bottom of this unit and the ground.
| 0
|-
| '''value'''
| [[Score]] this unit is worth.
| 0
|-
| '''deathSound'''
| Sound ID from [[SOUND#SAMPLE2.CAT|SAMPLE2.CAT]] played when this unit dies.
| -1
|-
| '''aggroSound'''
| Sound ID from [[SOUND#SAMPLE2.CAT|SAMPLE2.CAT]] played when this unit aggros.
| -1
|-
| '''moveSound'''
| Sound ID from [[SOUND#SAMPLE2.CAT|SAMPLE2.CAT]] played when this unit moves.
| -1
|-
| '''intelligence'''
| Intelligence of this unit's AI. The higher the value, the longer this unit remembers player troops.
| 0
|-
| '''aggression'''
| Aggression of this unit's AI. The higher the value, the more ruthless the unit.
| 0
|-
| '''energyRecovery'''
| Energy recovered by the unit each turn (needs verification)
| 40 (?)
|-
| '''specab'''
| Special ability of this unit:
* 0 = None
* 1 = [[Cyberdisc|Explodes on Death]]
* 2 = [[Bio-Drone|Burns Floor]]
* 3 = [[Zombie|Respawns on Death]]
| 0
|-
| '''spawnUnit'''
| String ID of the unit used to respawn on death (eg. [[Zombie]]s respawn as [[Chrysallid]]s).
| -
|-
| '''livingWeapon'''
| Is this unit a living weapon? (only attacks with a '''fixedWeapon''')
| false
|-
|}

=== Alien Races ===

Defines a [[Alien Life Forms|race]] used in [[Alien Missions]], listed in ''"alienRaces:"''. Heavily tied with deployment data.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''id'''
| String ID of the alien race name.
| ''required''
|-
| '''members'''
| Alien crew associated with this alien race (eg. race units + terrorist units), defined by a list of unit string IDs. Order here will define rank in terms of deployment. generally speaking the order is:
* 0 - Commander
* 1 - Leader
* 2 - Engineer
* 3 - Medic
* 4 - Navigator
* 5 - Soldier
* 6 - Terrorist 1
* 7 - Terrorist 2
but of course, not all races have all ranks, so the "fill in" rank would be listed multiple times (see ethereals).
|-
| '''retaliation'''
| retaliation enables/disables the race for retaliation missions.
| ''True''
| -
|}

=== Alien Deployments ===

Defines a Battlescape deployment data used in [[Alien Missions]] (such as alien and map configurations), listed in ''"alienDeployments:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the deployment name.
| ''required''
|-
| '''width'''
| Width of the Battlescape map in grid units.
| 0
|-
| '''length'''
| Length of the Battlescape map in grid units.
| 0
|-
| '''height'''
| Vertical height of the Battlescape map in grid units.
| 0
|-
| '''terrains'''
| list of string IDs of the [[#Terrains|terrain]] to choose from to generate this map. This is not used for UFO sites where the terrain comes from the Geoscape.
| -
|-
| '''shade'''
| Shade of the map (0-15, where 0 is full daytime and 15 is full nighttime). This is not used for UFO sites where the shade comes from the Geoscape.
| 0
|-
| '''nextStage'''
| String ID of the next deployment stage to use after this one, for multi-stage missions.
| -
|-
| '''data'''
| List of deployment data for each alien rank on this mission (see below).
| -
|}

Notes:
* '''terrains''' can also be used with UFOs, with the game using instead the listed terrain rather than the location of the UFO on Geoscape.
==== Deployment Data ====

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''alienRank'''
| [[Alien Rank|Rank]] associated with this deployment data, as defined by the order of the race in question (see above)
| ''required''
|-
| '''lowQty'''
| Maximum quantity of aliens to spawn (beginner).
| 0
|-
| '''highQty'''
| Maximum quantity of aliens to spawn (superhuman).
| 0
|-
| '''dQty'''
| Minimum Desired Quantity of aliens to spawn.
| 0
|-
| '''percentageOutsideUfo'''
| Percentage (0-100%) of aliens to spawn outside in UFO sites.
| 0
|-
| '''itemSets'''
| Three lists (one for each alien technology level) of [[#Items|items]] (string IDs) for the aliens to equip.
| ''required''
|-
|}

=== Research ===

Defines a [[Research|research topic]] that X-COM scientists can investigate, listed in ''"research:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''name'''
| String ID of the research project's name (or item, if a '''lookup''' is defined).
| ''required''
|-
| '''lookup'''
| String ID of the research project's display name and UFOPaedia article reference.
| -
|-
| '''cost'''
| Number of man hours (on average) required to complete this project.
| 0
|-
| '''points'''
| [[Score]] earned for completing this project.
| 0
|-
| '''needItem'''
| Does this project require an [[#Items|item]] of the same name?
| false
|-
| '''dependencies'''
| List of research projects that can unlock access to this one. If the full list is researched, or if one of the projects on the list "unlocks" this one, it becomes available.
| -
|-
| '''unlocks'''
| List of research projects unlocked, regardless of other dependencies, but not requirements, by completing this project (for example, any live alien unlocks "alien origins").
| -
|-
| '''requires'''
| List of research projects unilaterally required before this project can be unlocked (for example, "the martian solution" will not even be considered for unlocking until AFTER "alien origins" is completed).
| -
|-
| '''getOneFree'''
| List of "bonus" research projects that may be granted when completing this project (for example, alien medics will give you information on other alien races). Only applies to living aliens.
| -
|-
|}

=== Manufacture ===

Defines a [[Manufacture|manufacture project]] that X-COM engineers can produce, listed in ''"manufacture:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''name'''
| String ID of the manufacturing project's name (and the item it produces).
| ''required''
|-
| '''category'''
| String ID of the manufacturing project's category.
| -
|-
| '''requires'''
| List of [[#Research|topics]] (string IDs) that must be researched to unlock this project. If none are specified, this project is unlocked from the start.
| -
|-
| '''space'''
| Amount of [[Workshop]] space required to begin this project.
| 0
|-
| '''time'''
| Number of man hours (on average) required per item.
| 0
|-
| '''cost'''
| Monetary deduction per item manufactured.
| 0
|-
| '''requiredItems'''
| List of [[#Items|items]] required and consumed per item manufactured.
| -
|-
| '''producedItems'''
| List of [[#Items|items]] produced per each item consumed. If not specified, defaults to 1 item with the same string ID as the manufacture.
| 1
|-
|}

=== UFOpaedia Article ===

Defines an article in the in-game [[UFOpaedia]], listed in ''"ufopaedia:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''id'''
| String ID of the article name. This must match the ID of the object associated with this article, if applicable.
| ''required''
|-
| '''title'''
| String ID of the article title. If omitted, the '''id''' is used.
| -
|-
| '''type_id'''
| Type of this article:
* 0 = Unknown
* 1 = [[Craft]]
* 2 = [[Craft Armaments]]
* 3 = [[HWP]]
* 4 = [[Equipment (EU)|Equipment]]
* 5 = [[Armour]]
* 6 = [[Base Facilities]]
* 7 = Text & Image (eg. [[Alien Life Forms]], [[UFO Components]])
* 8 = Text (eg. [[Alien Research]])
* 9 = [[UFO]]
| 0
|-
| '''section'''
| String ID of the UFOpaedia section this article belongs in.
| -
|-
| '''requires'''
| List of [[#Research|topics]] (string IDs) that must be researched to unlock this article. If none are specified, this article is unlocked from the start.
| -
|-
| '''image_id'''
| Filename of the [[UP001.SPK-UP042.SPK|background image]] displayed on this article, if applicable.
| -
|-
| '''text'''
| String ID of the description displayed on this article.
| -
|-
| '''text_width'''
| Maximum width of the text displayed, only applicable to ''Text & Image'' articles.
| 0
|-
| '''rect_stats'''
| Rectangle ('''x''', '''y''', '''width''', '''height''') of the stats text on the screen, only applicable to ''Craft'' articles.
| 0
|-
| '''rect_text'''
| Rectangle ('''x''', '''y''', '''width''', '''height''') of the description text on the screen, only applicable to ''Craft'' articles.
| 0
|-
| '''weapon'''
| String ID of the weapon, only applicable to ''HWP'' articles.
| -
|}

=== UFO Trajectories ===

Defines a trajectory carried out by an UFO during an [[#Alien Missions|alien mission]], listed in ''"ufoTrajectories:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''id'''
| String ID of the trajectory name.
| ''required''
|-
| '''groundTimer'''
| Amount of seconds for the UFO to spend on Ground waypoints.
| 0
|-
| '''waypoints'''
| List of waypoints for the UFO to traverse, defined as ''[zone, altitude, speed]''. 
'''zone''': Globe zone where the waypoint is located. 
'''altitude''': UFO altitude after reaching this waypoint:
* 0 - Ground
* 1 - Very Low
* 2 - Low
* 3 - High
* 4 - Very High
'''speed''': UFO speed after reaching this waypoint, as a percentage (0-100%) of its maximum speed.
| -
|}

=== Alien Missions ===

Defines an [[Alien Missions|alien mission]] carried out by UFOs on the Geoscape, listed in ''"alienMissions:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the mission type.
| ''required''
|-
| '''points'''
| [[Score]] allocated to aliens for successfully completing this mission.
| 0
|-
| '''raceWeights'''
| List of alien races likely to carry out this mission, and the % chance of them being allocated to this mission, listed by "number of months after game beginning".
| ''required''
|-
| '''waves'''
| List of UFO waves to spawn as this mission progresses, as described below.
| ''required''
|}

==== Waves ====

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''ufo'''
| String ID of the [[#UFOs|UFO]] to spawn.
| ''required''
|-
| '''count'''
| Number of UFOs to spawn.
| 0
|-
| '''trajectory'''
| String ID of the [[#UFO Trajectories|trajectory]] for this UFO to use when entering Earth's atmosphere.
| ''required''
|-
| '''timer'''
| How long after the previous wave should this wave arrive? (in seconds)
| 0
|-
|}

=== Alien Item Levels ===

This is a list of item level probabilities, with a number between 0 and 2 representing an item level from plasma pistols to heavy plasmas, as defined in the deployments, expressing a 10% probability for that item level being used.

0 = first set (plasma pistol/clip)
1 = second set (plasma rifle/clip)
2 = third set (heavy plasma/clip)

For example:
[ 2, 0, 0, 0, 0, 0, 0, 1, 1, 1 ]
would represent a 60% chance for pistols, 30% rifles, and 10% heavy weapons. 
Note that the order does not matter, but the length DOES. each line MUST have 10 digits.

The above can be confusing. There are 10 fields; each number represents 10%. 
There is only one instance of '2'. 1x10% = 10% chance of plasma pistol 
There are three instances of '1'. 3x10% = 30% chance of plasma rifle 
There are six instances of '0'. 6x10% = 60% chance of heavy plasma 

Each line represents a month after the beginning of the game, and there is no limit to the number defined. 
OpenXCom will use the most recently available item level in the event the game goes on forever.

=== Extra Sprites ===

Adds or replaces sprites in an existing [[Image Formats|X-COM image file]], listed in ''"extraSprites:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| Filename of the original/new image to modify.
| ''required''
|-
| '''width'''
'''height'''
| Size of the sprite(s) in pixels.
| 0
0
|-
| '''singleImage'''
| Is the image file just a single sprite (true) or a spritesheet (false)?
| false
|-
| '''subX'''
'''subY'''
| Size of the subdivision in pixels. If a subdivision is specified, then the image file is divided into chunks to form the sprites (eg. spritesheets).
| 0
0
|-
| '''files'''
| List of the new sprites to add/replace, listed as ''spriteID: filename''.
| -
|}

Example:
- type: GIANTBUNNY.PCK
width: 32
height: 40
files:
0: Resources/Bunny/Bunny00.png
1: Resources/Bunny/Bunny01.bmp
2: Resources/Bunny/Bunny02.gif

=== Extra Sounds ===

Adds or replaces sounds in an existing [[SOUND|X-COM sound file]], listed in ''"extraSounds:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| ID of the original sound file to modify:
* BATTLE.CAT - Battlescape sounds, corresponds to ''SOUND1.CAT'' or ''SAMPLE2.CAT'' (55 sounds).
* INTRO.CAT - Intro sounds, corresponds to ''INTRO.CAT'' or ''SAMPLE3.CAT'', probably best not to mess with these.
* GEO.CAT - Geoscape sounds, corresponds to ''SOUND2.CAT'' or ''SAMPLE.CAT'' (14 sounds).
| ''required''
|-
| '''files'''
| List of the new sounds to add/replace, listed as ''soundID: filename''.
| -
|}

Example:
- type: BATTLE.CAT
files:
55: Resources/Sounds/sample.wav

=== Extra Strings ===

Adds or replaces text strings in an existing [[Translations (OpenXcom)|OpenXcom language file]], listed in ''"extraStrings:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| Filename of the original language file to modify, sans extension.
| ''required''
|-
| '''strings'''
| List of the new strings to add/replace, listed as ''stringID: text''.
| -
|}

Example:
- type: en-US
strings:
STR_SNIPER_RIFLE: Sniper Rifle
STR_SNIPER_RIFLE_CLIP: Sniper Rifle Clip
- type: en-GB
strings:
STR_SNIPER_RIFLE: Sniper Rifle
STR_SNIPER_RIFLE_CLIP: Sniper Rifle Clip
- type: de
strings:
STR_SNIPER_RIFLE: Scharfschützengewehr
STR_SNIPER_RIFLE_CLIP: Scharfschützengewehrmunition
- type: ru
strings:
STR_SNIPER_RIFLE: Снайперская винтовка
STR_SNIPER_RIFLE_CLIP: Магазин к снайп. винтовке

=== Interfaces ===

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| ''?''
| -
|-
| '''elements'''
| ''?''
| -
|-
| '''id'''
| ''?''
| -
|-
| '''color'''
| ''?''
| -
|}

=== StatStrings ===

[[Statstrings]] are used for automatically renaming soldiers. They are case sensitive and they are processed in the order in which they are specified.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''string'''
| String to add to name.
| ''required''
|-
| '''psiStrength''' 
'''psiSkill''' 
'''bravery''' 
'''strength''' 
'''firing''' 
'''reactions''' 
'''stamina''' 
'''tu''' 
'''health''' 
'''throwing'''
| One or more stat ranges are ANDed together for success. Each range has a minVal and maxVal. Use YAML standard tilde (~) to indicate null.
| -
|}

Example:
statStrings:
- string: "x"
psiStrength: [~, 30]
- string: "P"
psiStrength: [80, ~]
- string: "p"
psiStrength: [60, 79]
- string: "K"
psiSkill: [60, ~]
- string: "k"
psiSkill: [30, 59]
- string: "b"
bravery: [60, ~]
- string: "c"
bravery: [~, 10]
- string: "w"
strength: [~, 25]
- string: "Snpr"
firing: [60, ~]
reactions: [60, ~]
- string: "M"
firing: [70, ~]
- string: "m"
firing: [60, 69]
- string: "Sct"
reactions: [50, ~]
tu: [60, ~]
- string: "R"
reactions: [60, ~]
- string: "r"
reactions: [50, 59]

==References==
<references />

[[Category:OpenXcom]]

Ruleset Reference (OpenXcom)

2014-08-30T19:21:05Z

Falko: no civilian entry for terrain

A reference of all the customizable values of everything in a [[Rulesets (OpenXcom)|ruleset]]. Some guidelines:
* If a value is omitted from the ruleset, the default is used. You cannot omit ''required'' values.
* Text strings (eg. names) are represented by string IDs from the [[Translations (OpenXcom)|language files]]
* Numerical IDs (used for sprites, sounds, etc.) start at 0, not 1.
* Boolean (yes/no) values are represented by true/false.
* World coordinates are represented in degrees (see [[WORLD.DAT]]).
* Money amounts (prices, costs, etc.) are represented in dollars.
* All paths are '''case sensitive'''! If your ruleset uses external files, make sure that they named properly as described in ruleset.

Items are ordered as they come in the ruleset. To override this, you can specify a ''listOrder''. You can find the default listOrders in [[Ruleset List Order (OpenXcom)|Ruleset List Order]].

=== Globe ===

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''data'''
| ''path name of ?.''
| ''required''
|-
| '''polylines'''
| ''?''
| -
|}

=== Countries ===

Defines one of the [[Country Funding (EU)|funding nations]], listed in ''"countries:"''. They're used for activity graphs and player scoring.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the country name.
| ''required''
|-
| '''fundingBase'''
| Country's base funding, in thousands. The starting funding can be anywhere between 1x and 2x the base funding.
| 0
|-
| '''fundingCap'''
| Country's funding cap, in thousands. Once a country reaches this maximum, it will no longer increase its funding.
| 0
|-
| '''labelLon'''
'''labelLat'''
| Longitude and latitude coordinates of the country's label on the globe. This label is only shown when the globe is zoomed in and "detail" is turned on.
| 0.0
0.0
|-
| '''areas'''
| List of "rectangles" on the globe defined as [''lon1'' ''lat1'' ''lon2'' ''lat2'']. Any activity within these areas counts towards the country's graph activity and affects their opinion of the player.
| -
|}

=== Regions ===

Defines one of the [[Geoscape (EU)#World Regions/Countries|world regions]], listed in ''"regions:"''. They're used for base placement, activity graphs and mission spawning.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the region name.
| ''required''
|-
| '''cost'''
| Amount of money spent building an X-COM base in this region (first base is free).
| 0
|-
| '''areas'''
| List of "rectangles" on the globe defined as ''[lon1, lat1, lon2, lat2]''. Any activity within these areas counts towards the region's graph activity.
| -
|-
| '''cities'''
| List of cities belonging to this region. They will be displayed on the globe and used for terror site missions. Each city is defined by their '''lon''' and '''lat''' coordinates and a '''name''' string ID.
| -
|-
| '''regionWeight'''
| Weight of this region when selecting regions for alien missions.
| 0
|-
| '''missionWeights'''
| Weighted list of the different mission types for this region (eg. ''STR_ALIEN_RESEARCH: 14'').
| -
|-
| '''missionZones'''
| List of "rectangles" (''[lon1, lat1, lon2, lat2]'') defining the mission zones for this region.
| -
|-
| '''missionRegion'''
| Spawn mission in this region instead (used for regions without land).
| -
|}

=== Base Facilities ===

Defines one of the [[Base Facilities (EU)|facilities]] that can be built in an X-COM base, listed in ''"facilities:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the facility name.
| ''required''
|-
| '''requires'''
| List of [[#Research|topics]] (string IDs) that must be researched to unlock this facility. If none are specified, this facility is unlocked from the start.
| -
|-
| '''spriteShape'''
| Sprite ID from [[BASEBITS.PCK]] used to draw the facility's outer shape in the Basescape and UFOpaedia.
| -1
|-
| '''spriteFacility'''
| Sprite ID from [[BASEBITS.PCK]] used to draw the facility's contents in the Basescape and UFOpaedia. Drawn on top of '''spriteShape'''.
| -1
|-
| '''lift'''
| Is this facility an [[Access Lift]]? All base facilities must be connected to the lift.
| false
|-
| '''hyper'''
| Is this facility a [[Hyperwave Decoder]]? Displays extra information for detected UFOs. Only valid for radar facilities.
| false
|-
| '''mind'''
| Is this facility a [[Mind Shield]]? Reduces the chance of UFOs finding your base. Does not stack.
| false
|-
| '''grav'''
| Is this facility a [[Grav Shield]]? Doubles the power of your base defenses. Does not stack.
| false
|-
| '''size'''
| Size of the facility, in grid units. Every facility is square, so a size of 1 means 1x1, 2 means 2x2, etc. Bigger facilities are made up of multiple sprites, for example a 2x2 facility will use 4 sprites for '''spriteShape''' and 4 sprites for '''spriteFacility''' (top-left, top-right, bottom-left, bottom-right).
| 1
|-
| '''buildCost'''
| Amount of money spent to build this facility in the base.
| 0
|-
| '''buildTime'''
| Amount of days it takes for this facility to be built.
| 0
|-
| '''monthlyCost'''
| Amount of money spent monthly for the maintenance of this facility.
| 0
|-
| '''storage'''
| Amount of storage space (for items) this facility provides. See [[Base Stores]].
| 0
|-
| '''personnel'''
| Amount of personnel (soldiers, scientsts, engineers) these quarters can contain.
| 0
|-
| '''aliens'''
| Amount of live aliens this facility can contain. Only checked if the ''alienContainmentLimitEnforced'' option is enabled.
| 0
|-
| '''crafts'''
| Amount of X-COM craft this facility can contain.
| 0
|-
| '''labs'''
| Amount of lab space this facility provides for research projects.
| 0
|-
| '''workshops'''
| Amount of workshop space this facility provides for manufacture projects.
| 0
|-
| '''psiLabs'''
| Amount of soldier space this facility provides for psionic training.
| 0
|-
| '''radarRange'''
| Maximum radar detection range of this facility, in nautical miles.
| 0
|-
| '''radarChance'''
| Chance (0-100%) of this radar detecting a UFO that enters its range.
| 0
|-
| '''defense'''
| Offensive power provided by this base defense against attacking UFOs.
| 0
|-
| '''hitRatio'''
| Chance (0-100) of the base defense hitting an attacking UFO.
| 0
|-
| '''fireSound'''
| Sound ID from [[SOUND#SAMPLE.CAT|SAMPLE.CAT]] played when the base defense fires.
| -1
|-
| '''hitSound'''
| Sound ID from [[SOUND#SAMPLE.CAT|SAMPLE.CAT]] played when the base defense hits a target.
| -1
|-
| '''mapName'''
| [[MAPS|Map]] associated to this facility in Battlescape base defenses.
| -
|-
|}

=== Crafts ===

Defines one of the [[Craft|X-COM crafts]] that go on interception missions, listed in ''"crafts:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the craft name.
| ''required''
|-
| '''requires'''
| List of [[#Research|topics]] (string IDs) that must be researched to unlock this craft. If none are specified, this craft is unlocked from the start.
| -
|-
| '''sprite'''
| Sprite ID from [[BASEBITS.PCK]] used to draw this craft in the Basescape and from [[INTICON.PCK]] used to draw the damage indicator in dogfights.
modders: the corresponding extrasprite file id for BASEBITS.PCK is sprite+33 INTICON.PCK contains a minimized icon id=sprite the file id for the dogfight image is sprite+11
| -1
|-
| '''fuelMax'''
| Maximum amount of fuel this craft can carry. Crafts use up fuel based on their speed while travelling.
| 0
|-
| '''damageMax'''
| Maximum amount of damage this craft can take. If this amount is exceeded, the craft is destroyed.
| 0
|-
| '''speedMax'''
| Maximum speed in nautical miles. Crafts travel at max speed when flying and half speed when patrolling.
| 0
|-
| '''accel'''
| Aceeleration value shown in the UFOpaedia.
| 0
|-
| '''weapons'''
| Amount of craft weapons this craft can equip. The UI can only display a max of 2 weapons.
| 0
|-
| '''soldiers'''
| Amount of soldiers this craft can carry.
| 0
|-
| '''maxItems'''
| Amount of items this craft can carry.
| 80
|-
| '''vehicles'''
| Amount of vehicles this craft can carry.
| 0
|-
| '''costBuy'''
| Amount of money spent for purchasing this craft. If set to 0, the craft will not be available in the Purchase/Recruit screen.
| 0
|-
| '''costRent'''
| Amount of money spent monthly for renting this craft. If set to 0, the craft is not on rental and won't count towards base maintenance.
| 0
|-
| '''costSell'''
| Amount of money gained for selling this craft.
| 0
|-
| '''refuelItem'''
| Item required for refuelling this craft. If no item is specified, the craft uses human fuel.
| 0
|-
| '''repairRate'''
| Amount of damage restored every hour while [[Repairs|Repairing]] in base.
| 1
|-
| '''refuelRate'''
| Amount of fuel restored every 30 mins while [[Refueling]] in base. If specified, a '''refuelItem''' is spent each time.
| 1
|-
| '''radarRange'''
| Detection range of the craft's radar in nautical miles. Every craft radar has a 100% detection chance.
| 600
|-
| '''transferTime'''
| Number of hours it takes to purchase/transfer this craft to a base.
| 0
|-
| '''score'''
| [[Score]] lost when this craft is destroyed.
| 0
|-
| '''spacecraft'''
| Can this craft go to [[Cydonia]]?
| false
|-
| '''battlescapeTerrainData'''
| [[#Terrains|Terrain]] associated to this craft in Battlescape missions.
| -
|}

=== Craft Weapons ===

Defines one of the [[Craft Armaments|weapons]] equipped by X-COM craft for shooting down UFOs, listed in ''"craftWeapons:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the weapon name.
| ''required''
|-
| '''sprite'''
| Sprite ID from [[BASEBITS.PCK]] used to draw the weapon in the Basescape and from [[INTICON.PCK]] used to draw the weapon in dogfights.
modders: the corresponding extrasprites file id for INTICON.PCK is sprite+5 and sprite+48 for BASEBITS.PCK
| -1
|-
| '''sound'''
| Sound ID from [[SOUND#SAMPLE.CAT|SAMPLE.CAT]] played when this weapon fires.
| -1
|-
| '''damage'''
| Amount of damage this weapon does to enemy UFOs.
| 0
|-
| '''range'''
| Maximum range of this weapon in dogfights (in meters).
| 0
|-
| '''accuracy'''
| Chance (0-100%) of each shot hitting the enemy UFO.
| 0
|-
| '''reloadCautious'''
| Time this weapon takes to fire between each shot in ''Cautious Mode''.
| 0
|-
| '''reloadStandard'''
| Time this weapon takes to fire between each shot in ''Standard Mode''.
| 0
|-
| '''reloadAggressive'''
| Time this weapon takes to fire between each shot in ''Aggressive Mode''.
| 0
|-
| '''ammoMax'''
| Maximum amount of ammo this weapon can carry.
| 0
|-
| '''rearmRate'''
| Amount of ammo restored every 30 mins while the craft is [[Rearming]] in base. If specified, '''clip'''s are spent depending on their '''clipSize'''. If the '''clipSize''' of the specified ammo is 0, no '''clip'''s are spent.
| 1
|-
| '''projectileType'''
| Type of the weapon projectile, used for the projectile sprite in dogfights:
* 0 - [[Stingray]]
* 1 - [[Avalanche]]
* 2 - [[Cannon]]
* 3 - [[Fusion Ball]]
* 4 - [[Laser Cannon]]
* 5 - [[Plasma Beam]]
| 2
|-
| '''projectileSpeed'''
| Speed of the weapon projectile in dogfights.
| 0
|-
| '''launcher'''
| String ID of the [[#Items|item]] required to equip this weapon.
| -
|-
| '''clip'''
| String ID of the [[#Items|item]] required to rearm this weapon.
| -
|}

=== Items ===

Defines the Geoscape and Battlescape properties of an [[Equipment (EU)|item]] that can be stored in X-COM bases, listed in ''"items:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the internal item name.
| ''required''
|-
| '''name'''
| String ID of the displayed item name, for cases where it's different from the internal name. If omitted, '''type''' is used.
| -
|-
| '''requires'''
| List of [[#Research|topics]] (string IDs) that must be researched to unlock this item. If none are specified, this item is unlocked from the start. Soldiers can only use unlocked items in the Battlescape.
| -
|-
| '''size'''
| Space occupied by this item in [[Base Stores]]. Can be a decimal value.
| 0.0
|-
| '''costBuy'''
| Amount of money spent for purchasing this item. If set to 0, this item will not be available in the Purchase/Recruit screen.
| 0
|-
| '''costSell'''
| Amount of money gained for selling this item.
| 0
|-
| '''transferTime'''
| Number of hours it takes to purchase/transfer this item to a base.
| 24
|-
| '''weight'''
| [[Item_Weight|Weight]] occupied by this item in a soldier's inventory.
| 999
|-
| '''bigSprite'''
| Sprite ID from [[BIGOBS.PCK]] used to draw this item in a soldier's inventory and UFOpaedia.
| -1
|-
| '''floorSprite'''
| Sprite ID from [[FLOOROB.PCK]] used to draw this item on the floor of a Battlescape tile.
| -1
|-
| '''handSprite'''
| Sprite ID from [[HANDOB.PCK]] used to draw this item on a soldier's hand in the Battlescape.
modders: each handobject needs 8 images (8 directions) define the extrasprites accordingly
| 120
|-
| '''bulletSprite'''
| Sprite ID from ''BulletSprites.png'' used to draw this weapon's projectile on the Battlescape:
* 0 - [[Rocket Launcher]]
* 1 - [[Pistol]]
* 2 - [[Rifle]]
* 3 - [[Auto Cannon]]
* 4 - [[Heavy Cannon]]
* 5 - [[Laser Pistol]]
* 6 - [[Laser Rifle]]
* 7 - [[Heavy Laser]]
* 8 - [[Plasma Rifle|Plasma]]
* 9 - [[Small Launcher]]
* 10 - [[Blaster Launcher]]
for modders: the bulletsprite needs to be put into the extraSprites type "Projectiles" the bulletsprite can contain up to 35 3x3 images
| -1
|-
| '''fireSound'''
| Sound ID from [[SOUND#SAMPLE2.CAT|SAMPLE2.CAT]] played when this weapon fires.
| -1
|-
| '''hitSound'''
| Sound ID from [[SOUND#SAMPLE2.CAT|SAMPLE2.CAT]] played when this weapon hits a target.
| -1
|-
| '''hitAnimation'''
| Sprite ID from [[SMOKE.PCK]] used to draw the weapon's "hit explosion".
'''NOTE''': Do not define this value for melee/psi weapons, they use [[HIT.PCK]] and therefore meleeAnimation instead.
| 0
|-
| '''power'''
| Average damage of the weapon, in most cases it will be +-50% this value.
| 0
|-
| '''strengthApplied'''
| Add the attacking unit's strength to this weapon's damage.
| false
|-
| '''compatibleAmmo'''
| List of string IDs of the ammo items that can be loaded on this weapon. If none are specified, the weapon doesn't need ammo.
| -
|-
| '''damageType'''
| What type of [[damage]] does this weapon do:
* 0 - None
* 1 - Armor Piercing
* 2 - Incendiary
* 3 - High Explosive
* 4 - Laser
* 5 - Plasma
* 6 - Stun
* 7 - Melee
* 8 - Acid
* 9 - Smoke
'''NOTE:''' A damage type other than 0-9 will do nothing.
| 0
|-
| '''tuAuto'''
'''accuracyAuto'''
| The percentage (0-100%) of [[Time Units]] (from the soldier's total) required to fire an Auto Shot. If 0, the weapon does not have an Auto Shot.
The base accuracy (0-100%) applied to a soldier's [[Firing Accuracy]] when firing an Auto Shot.
| 0
0
|-
| '''tuSnap'''
'''accuracySnap'''
| The percentage (0-100%) of [[Time Units]] (from the soldier's total) required to fire a Snap Shot. If 0, the weapon does not have a Snap Shot.
The base accuracy (0-100%) applied to a soldier's [[Firing Accuracy]] when firing a Snap Shot.
| 0
0
|-
| '''tuAimed'''
'''accuracyAimed'''
| The percentage (0-100%) of [[Time Units]] (from the soldier's total) required to fire an Aimed Shot. If 0, the weapon does not have an Aimed Shot.
The base accuracy (0-100%) applied to a soldier's [[Firing Accuracy]] when firing an Aimed Shot.
| 0
0
|-
|-
| '''tuMelee'''
'''accuracyMelee'''
| The percentage (0-100%) of [[Time Units]] (from the soldier's total) required to do a melee attack (Hit). If 0, the weapon does not have a melee attack.
The base accuracy (0-100%) applied to a soldier's [[Melee Accuracy]] when doing a melee attack.
| 0
0
|-
| '''clipSize'''
| The amount of ammo stored in each weapon clip. If -1 is specified, this weapon has infinite ammo.
| 0
|-
| '''battleType'''
| Defines the weapon's behavior in the Battlescape:
* 0 - None (Geoscape-only item)
* 1 - [[Weapons|Firearm]]
* 2 - Ammo
* 3 - Melee
* 4 - [[Grenade]]
* 5 - [[Proximity Grenade]]
* 6 - [[Medi-Kit (EU)|Medi-Kit]]
* 7 - [[Motion Scanner]]
* 8 - [[Mind Probe]]
* 9 - [[Psi-Amp]]
* 10 - [[Electro-flare]]
* 11 - Corpse
| 0
|-
| '''twoHanded'''
| Is this weapon two-handed? (incurs an accuracy penalty if used with both hands occupied)
| false
|-
| '''waypoint'''
| Does this weapon use waypoints? (eg. [[Blaster Launcher]]). Can also be used to make ammo items use the waypoint system.
| false
|-
| '''fixedWeapon'''
| Is this weapon fixed? (it's part of a unit, eg. tanks and terrorist units)
| false
|-
| '''invWidth'''
| Item width in a soldier's inventory (in grid units).
| 1
|-
| '''invHeight'''
| Item height in a soldier's inventory (in grid units).
| 1
|-
| '''painKiller'''
| Amount of painkillers contained in a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''heal'''
| Amount of heal's contained in a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''stimulant'''
| Amount of stimulants contained in a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''woundRecovery'''
| Amount of [[Fatal Wounds]] treated by each heal of a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''healthRecovery'''
| Amount of [[Health]] recovered by each heal of a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''stunRecovery'''
| Amount of [[Stun]] removed by each stimulant of a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''energyRecovery'''
| Amount of [[Energy]] recovered by each stimulant of a [[Medi-Kit (EU)|Medi-Kit]].
| 0
|-
| '''tuUse'''
| Amount of [[Time Units]] required to use this item (for non-offensive items). It's a flat rate if '''flatRate''' is true, otherwise it's a percentage (0-100%).
| 0
|-
| '''recoveryPoints'''
| [[Score]] gained for recovering this alien artifact.
| 0
|-
| '''armor'''
| How much damage is needed to destroy this item on the ground.
| 20
|-
| '''recover'''
| Is this item recoverable? (gets transported to the X-COM base on mission success)
| true
|-
| '''turretType'''
| Sprite ID from [[TANKS.PCK]] of the turret to assign to this tank:
* 0 - [[Tank/Cannon]]
* 1 - [[Tank/Rocket Launcher]]
* 2 - [[Tank/Laser Cannon]]
* 3 - [[Hovertank/Plasma]]
* 4 - [[Hovertank/Launcher]]
| -1
|-
| '''liveAlien'''
| Does this item represent a live alien? (counts towards [[Alien Containment]])
| false
|-
| '''blastRadius'''
| Size of the projectile explosions. 0 for no explosion. -1 to automatically calculate based on weapon power and damage type (actual '''blastRadius''' currently is capped due [[Explosions#Playing_With_Fire|Explosion calculations]]).
| -1
|-
| '''flatRate'''
| If true, then TU costs for this weapon are a flat rate (instead of a percentage of unit TUs).
| false
|-
| '''arcingShot'''
| Does this weapon fire in an arc?
| false
|-
| '''attraction'''
| Represents how likely an alien is to pick up this item. Values below 5 will be ignored (by design).
| 0
|-
| '''maxRange'''
| Maximum range at which this weapon can operate.
| 200
|-
| '''aimRange'''
| Maximum effective range with this weapon before which range-based dropoff occurs.
| 200
|-
| '''snapRange'''
| Maximum effective range with snap shot before which range-based dropoff occurs. (ufoextender accuracy only)
| 15
|-
| '''autoRange'''
| Maximum effective range with auto shot before which range-based dropoff occurs. (ufoextender accuracy only)
| 7
|-
| '''minRange'''
| Range-based dropoff will work in reverse for ranges below this.
| 0
|-
| '''dropoff'''
| The value by which the accuracy lowers for each tile after (or before) the thresholds above.
| 2
|-
| '''bulletSpeed'''
| How much faster (or slower, if you use a negative number) is a projectile fired from this weapon compared to the average.
| 0
|-
| '''autoShots'''
| How many auto shots does this weapon fire.
| 3
|-
| '''shotgunPellets'''
| Number of projectiles fired per unit of ammunition. (note: due to engine limitations it is currently impossible to draw multiple projectiles in flight.)
| 0
|-
| '''zombieUnit'''
| String ID of the unit used for zombification (eg. [[Chrysallid]]s turn units into [[Zombie]]s).
| none
|-
| '''meleeSound'''
| Sound ID from [[SOUND#SAMPLE2.CAT|SAMPLE2.CAT]] played when this weapon attacks a target with melee.
| 39
|-
| '''meleeHitSound'''
| Sound ID from [[SOUND#SAMPLE2.CAT|SAMPLE2.CAT]] played when this weapon HITS a target with melee.
| -1
|-
| '''meleeAnimation'''
| Sprite ID from HIT.PCK played when this weapon attacks a target with melee.
| 0
|-
| '''meleePower'''
| Damage this weapon will do when using melee. This only applies to Firearms, and is only available as stun damage. For normal melee weapons, use regular power and damage types.
| 0
|-
| '''LOSRequired'''
| Does this item require line of sight? (only applies to mind probes and psi-amps)
| false
|-
| '''skillApplied'''
| Is melee skill applied to the accuracy of an attack made with this object?
| true
|-
|}

=== UFOs ===

Defines one of the [[UFOs]] that invade Earth, listed in ''"ufos:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the UFO name.
| ''required''
|-
| '''size'''
| String ID of the UFO size.
| STR_VERY_SMALL
|-
| '''sprite'''
| Sprite ID from [[INTERWIN.DAT]] used to draw this UFO in the dogfight view and UFOpaedia.
don't try to add more images if you don't want to punch yourself in the face - use modsprite
| -1
|-
| '''modSprite'''
| Filename used to draw this UFO in the dogfight view and UFOpaedia.
| -
|-
| '''damageMax'''
| Maximum amount of damage this UFO can take. If the UFO takes 50% damage, it crash lands. If it takes 100% damage, it is destroyed.
| 0
|-
| '''speedMax'''
| Maximum speed in nautical miles.
| 0
|-
| '''accel'''
| Aceeleration value shown in the UFOpaedia.
| 0
|-
| '''power'''
| Damage power of this UFO's weapon in dogfights.
| 0
|-
| '''range'''
| Maximum range of this UFO's weapon in dogfights (in meters).
| 0
|-
| '''score'''
| [[Score]] gained when this UFO is destroyed, or half this score if it crash lands.
| 0
|-
| '''reload'''
| Time the UFO's weapon takes to fire between each shot.
| 0
|-
| '''breakOffTime'''
| Minimum amount of time for the UFO to be able to break off of a dogfight.
| 0
|-
| '''battlescapeTerrainData'''
| [[#Terrains|Terrain]] associated to this UFO in Battlescape missions.
| ''required''
|-
|}

=== Inventory Sections ===

Defines one of the sections of the [[Inventory TU Table|Battlescape inventory]] (eg. Backpack), listed in ''"invs:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the inventory name.
| ''required''
|-
| '''x'''
'''y'''
| Pixel coordinates of this section on the inventory screen.
| 0
0
|-
| '''type'''
| Type of this section:
* 0 = Slot section, can contain as many items as will fit on the slots.
* 1 = Hand section, can only contain one item regardless of size.
* 2 = Ground section, can contain infinite items.
| 0
|-
| '''slots'''
| List of the grid slots (''[x, y]'') that this section is composed of. For example, to make a 2x2 section, you would have ''[0, 0] [0, 1] [1, 0] [1, 1]''.
| -
|-
| '''costs'''
| List of [[Time Units]] costs to move an item from this section to another one (eg. ''STR_BACKPACK: 16'' means it will cost 16 TUs to move an item from this section to the Backpack).
| -
|-
|}

=== Terrains ===

Defines one of the [[TERRAIN|terrains]] used to generate a Battlescape map, listed in "terrains:".

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''name'''
| String ID of the terrain name.
| ''required''
|-
| '''largeBlockLimit'''
| Maximum amount of large blocks that can be used on map generation.
| 0
|-
| '''textures'''
| List of [[TEXTURE.DAT|Geoscape textures]] that correspond to this terrain.
| -
|-
| '''hemisphere'''
| Geoscape hemisphere associated with this terrain:
* -1 - Northern hemisphere.
* 0 - Both hemispheres.
* 1 - Southern hemisphere.
| 0
|-
| '''mapDataSets'''
| List of filenames (each with matching [[MCD]]/[[Image Formats#PCK|PCK/TAB]] files) that contain the tiles of this terrain.
| -
|-
| '''mapBlocks'''
| List of map blocks (see below) that are used for generating a map.
| -
|-
| '''roadTypeOdds'''
| Odds as a % of generating each type of road (E-W Road, N-S Road, Crossing) odds for crossing are: 100 - EW - NS.
| [0 0]
|-|-
| '''civilianTypes'''
| List of units to use as civilians for this mission.
| [MALE_CIVILIAN, FEMALE_CIVILIAN]
|-
|}

==== Map Blocks ====

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''name'''
| Filename of the [[MAPS|map]].
| ''required''
|-
| '''width'''
| Width of this map block in Battlescape grid units.
| 0
|-
| '''length'''
| Length of this map block in Battlescape grid units.
| 0
|-
| '''height'''
| Height of this map block in Battlescape grid units.
| 1
|-
| '''type'''
| Type of this map block:
* -1 - Undefined
* 0 - Default
* 1 - Landing Zone (for placing X-COM / alien craft)
* 2 - E-W Road (for city maps)
* 3 - N-S Road (for city maps)
* 4 - Road Crossing (for city maps)
* 5 - Dirt (for filling empty base blocks)
* 6 - X-COM spawn point (for [[Alien Base]] / [[Cydonia]] missions)
* 7 - [[Alien Base]] Target
* 8 - [[Cydonia]] Target
| -1
|-
| '''subType'''
| Sub-type of this map block (see '''type''').
| -1
|-
| '''frequency'''
| Frequency of this block in a map.
| 1
|-
| '''maxCount'''
| Maximum amount of times this block can be used in a map. If -1 there is no limit.
| -1
|-
| '''items'''
| An array of items to add to this mapblock, an the positions to place them at.
| -1
|}

*'''frequency''' defines the odds of the map appearing on the map
** The value assigned (default: 1) is used in ''x/n'', which defines the probability of being chosen.
** ''x'' is the integer defined for the map block's frequency and ''n'' is the combined total of probabilities for all the map types combined.
** This property can only be used in type 0 map blocks.
*'''maxCount''' is the maximum number of times it can be used.
** The value assigned is also used in ''x/n'' to determine the probability of being chosen.
** Each use reduces ''x'' by -1, with the caveat that being used as a Landing Zone type will not reduce the x value since it could result in no available Landing Zones.
** This property can only be used in type 0 map blocks.
* '''hemisphere''' only applies to UFO missions, not Terror ones.
*'''width/length''' defines the size of the map
** be aware that the mapview "width"-label is the openxcom ruleset length parameter
** be aware that the mapview "length"-label is the openxcom ruleset width parameter

==== Guidelines/Tips ====
* All maps with an XCOM/Alien craft require at least one type 1 map block. This map block can only contain ground tiles (no walls or objects), otherwise the game will crash or the walls/objects will be removed.
* All Terror terrains (listed under STR_TERROR_MISSION) require at least 1 map block of '''Types''' 2, 3 and 4 (for a total of 3 maps, which are required to place roads) and the corresponding '''roadTypeOdds''' added to the ruleset.
* If there isn't any map blocks designed as roads since you want to keep your terrain 'random', this can be circumvented by designating all 10x10 map blocks, excluding the one(s) used for the XCOM craft, as either '''Type''' 2, 3 and 4 and by defining their '''subType''' to 0. The game will then randomly choose between the map blocks for each type used in the roads, making them map more random.

=== Armor ===

Defines a Battlescape unit's [[armor]] as well as visual representation (so every unit has an armor), listed in ''"armors:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the armor name.
| ''required''
|-
| '''spriteSheet'''
| Sprite sheet from [[UNITS]] used to draw a unit wearing this armor.
| -
|-
| '''spriteInv'''
| Sprite used for the [[Inventory Backgrounds]] of a unit wearing this armor.
| -
|-
| '''corpseBattle'''
| List of string IDs of the corpse [[#Items|items]] generated when a unit wearing this armor is killed (one per unit tile) on the Battlescape.
| -
|-
| '''corpseGeo'''
| String ID of the corpse [[#Items|item]] associated with this unit on the Geoscape.
| -
|-
| '''storeItem'''
| String ID of the [[#Items|item]] that represents this armor in [[Base Stores]] for equipping.
| -
|-
| '''weight'''
| Physical weight of the armor when worn
| 6
|-
| '''stats'''
| like soldier stats (see below) but these are treated as stat bonuses for wearing the specific armor.
| -
|-
| '''frontArmor'''
| Protection provided on the front of the unit.
| 0
|-
| '''sideArmor'''
| Protection provided on the sides of the unit.
| 0
|-
| '''rearArmor'''
| Protection provided on the rear of the unit.
| 0
|-
| '''underArmor'''
| Protection provided under the unit (eg. from explosions).
| 0
|-
| '''drawingRoutine'''
| Drawing routine used to put together the body parts in the unit's '''spriteSheet''':
* 0 = [[Soldier]], [[Sectoid]]
* 1 = [[Floater]]
* 2 = [[HWP]]
* 3 = [[Cyberdisk]]
* 4 = [[Civilian]], [[Ethereal]]
* 5 = [[Sectopod]], [[Reaper]]
* 6 = [[Snakeman]]
* 7 = [[Chryssalid]]
* 8 = [[Silacoid]]
* 9 = [[Celatid]]
* 10 = [[Muton]]
| 0
|-
| '''movementType'''
| Type of movement provided by this armor:
* 0 = Walking
* 1 = Flying
* 2 = Sliding (no walking animation)
it also defines the body of an tank (32-images) in your spriteSheet or the change in sprites while flying using a flying armour see: [[TANKS.PCK]], [[XCOM_2.PCK]]
| 0
|-
| '''damageModifier'''
| List of decimal damage modifiers (1.0 = 100%) this armor applies to each damage type (see [[#Items|Items section]]) received. Modifiers must be specified for all damage types, in this order:
* None
* Armor Piercing
* Incendiary
* High Explosive
* Laser
* Plasma
* Stun
* Melee
* Acid
* Smoke
|
- 1.0 
- 1.0 
- 1.0 
- 1.0 
- 1.0 
- 1.0 
- 1.0 
- 1.0 
- 1.0 
- 1.0
|-
| '''size'''
| Size of the unit wearing this armor, in Battlescape grid units. Every unit is square, so a size of 2 means 2x2.
| 1
|-
| '''loftempsSet'''
| List of [[LOFTEMPS]] IDs (one per unit tile, so a 1x1 unit has 1, a 2x2 unit has 4, etc.) used to represent a unit wearing this armor in 3D space.
| -
|-
| '''loftemps'''
| loftemps is a deprecated option that only works for 1x1 sized units.
| -
|}

=== Player Units (Soldiers) ===

Defines a [[soldier]] recruited by X-COM, listed in ''"soldiers:"''. Currently only one soldier unit type (''XCOM'') is supported.

Unit stats are represented as follows:
* [[Time Units|tu]]
* [[Energy|stamina]]
* [[Health|health]]
* [[Bravery|bravery]] (always a multiple of 10)
* [[Reactions|reactions]]
* [[Firing Accuracy|firing]]
* [[Throwing Accuracy|throwing]]
* [[Strength|strength]]
* [[Psi Strength|psiStrength]]
* [[Psi Skill|psiSkill]]
* [[Melee Accuracy|melee]] (not visible)

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the soldier name.
| ''required''
|-
| '''minStats'''
| Minimum values used to generate the soldier's [[Starting Stats]]. In this case, ''psiSkill'' is treated as the initial stat (not generated).
| -
|-
| '''maxStats'''
| Maximum values used to generate the soldier's [[Starting Stats]]. In this case, ''psiSkill'' is treated as the minimum value for the first month of psi training (actual value is 100%-150%).
| -
|-
| '''statCaps'''
| Maximum stats this soldier can gain through [[Experience]]. '''NOTE:''' A stat will still go over the limit once, and then will no longer increase (see [[Experience#Regarding Caps|Regarding Caps]]).
| -
|-
| '''armor'''
| String ID of the [[#Armor|armor]] this soldier uses by default.
| -
|-
| '''standHeight'''
| Height of this soldier when standing.
| 0
|-
| '''kneelHeight'''
| Height of this soldier when kneeling.
| 0
|-
| '''floatHeight'''
| Distance between the bottom of this unit and the ground.
| 0
|}

=== AI Units (Aliens/Civilians) ===

Defines an [[Alien Life Forms|alien]] (enemy) or [[civilian]] (neutral) unit, listed in ''"units:"''. Every different alien rank is a different unit, since they have completely different stats. Unit stats are represented as follows:
* [[Time Units|tu]]
* [[Energy|stamina]]
* [[Health|health]]
* [[Bravery|bravery]] (always a multiple of 10)
* [[Reactions|reactions]]
* [[Firing Accuracy|firing]]
* [[Throwing Accuracy|throwing]]
* [[Strength|strength]]
* [[Psi Strength|psiStrength]]
* [[Psi Skill|psiSkill]]
* [[Melee Accuracy|melee]] (not visible)

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the unit name.
| ''required''
|-
| '''race'''
| String ID of the unit race (for alien units).
| -
|-
| '''rank'''
| String ID of the unit rank (for alien units).
| -
|-
| '''stats'''
| Battlescape stats of this unit.
| -
|-
| '''armor'''
| String ID of the [[#Armor|armor]] this unit uses by default.
| -
|-
| '''standHeight'''
| Height of this unit when standing.
| 0
|-
| '''floatHeight'''
| Distance between the bottom of this unit and the ground.
| 0
|-
| '''value'''
| [[Score]] this unit is worth.
| 0
|-
| '''deathSound'''
| Sound ID from [[SOUND#SAMPLE2.CAT|SAMPLE2.CAT]] played when this unit dies.
| -1
|-
| '''aggroSound'''
| Sound ID from [[SOUND#SAMPLE2.CAT|SAMPLE2.CAT]] played when this unit aggros.
| -1
|-
| '''moveSound'''
| Sound ID from [[SOUND#SAMPLE2.CAT|SAMPLE2.CAT]] played when this unit moves.
| -1
|-
| '''intelligence'''
| Intelligence of this unit's AI. The higher the value, the longer this unit remembers player troops.
| 0
|-
| '''aggression'''
| Aggression of this unit's AI. The higher the value, the more ruthless the unit.
| 0
|-
| '''energyRecovery'''
| Energy recovered by the unit each turn (needs verification)
| 40 (?)
|-
| '''specab'''
| Special ability of this unit:
* 0 = None
* 1 = [[Cyberdisc|Explodes on Death]]
* 2 = [[Bio-Drone|Burns Floor]]
* 3 = [[Zombie|Respawns on Death]]
| 0
|-
| '''spawnUnit'''
| String ID of the unit used to respawn on death (eg. [[Zombie]]s respawn as [[Chrysallid]]s).
| -
|-
| '''livingWeapon'''
| Is this unit a living weapon? (only attacks with a '''fixedWeapon''')
| false
|-
|}

=== Alien Races ===

Defines a [[Alien Life Forms|race]] used in [[Alien Missions]], listed in ''"alienRaces:"''. Heavily tied with deployment data.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''id'''
| String ID of the alien race name.
| ''required''
|-
| '''members'''
| Alien crew associated with this alien race (eg. race units + terrorist units), defined by a list of unit string IDs. Order here will define rank in terms of deployment. generally speaking the order is:
* 0 - Commander
* 1 - Leader
* 2 - Engineer
* 3 - Medic
* 4 - Navigator
* 5 - Soldier
* 6 - Terrorist 1
* 7 - Terrorist 2
but of course, not all races have all ranks, so the "fill in" rank would be listed multiple times (see ethereals).
|-
| '''retaliation'''
| retaliation enables/disables the race for retaliation missions.
| ''True''
| -
|}

=== Alien Deployments ===

Defines a Battlescape deployment data used in [[Alien Missions]] (such as alien and map configurations), listed in ''"alienDeployments:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the deployment name.
| ''required''
|-
| '''width'''
| Width of the Battlescape map in grid units.
| 0
|-
| '''length'''
| Length of the Battlescape map in grid units.
| 0
|-
| '''height'''
| Vertical height of the Battlescape map in grid units.
| 0
|-
| '''terrains'''
| list of string IDs of the [[#Terrains|terrain]] to choose from to generate this map. This is not used for UFO sites where the terrain comes from the Geoscape.
| -
|-
| '''shade'''
| Shade of the map (0-15, where 0 is full daytime and 15 is full nighttime). This is not used for UFO sites where the shade comes from the Geoscape.
| 0
|-
| '''nextStage'''
| String ID of the next deployment stage to use after this one, for multi-stage missions.
| -
|-
| '''data'''
| List of deployment data for each alien rank on this mission (see below).
| -
|}

Notes:
* '''terrains''' can also be used with UFOs, with the game using instead the listed terrain rather than the location of the UFO on Geoscape.
==== Deployment Data ====

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''alienRank'''
| [[Alien Rank|Rank]] associated with this deployment data, as defined by the order of the race in question (see above)
| ''required''
|-
| '''lowQty'''
| Maximum quantity of aliens to spawn (beginner).
| 0
|-
| '''highQty'''
| Maximum quantity of aliens to spawn (superhuman).
| 0
|-
| '''dQty'''
| Minimum Desired Quantity of aliens to spawn.
| 0
|-
| '''percentageOutsideUfo'''
| Percentage (0-100%) of aliens to spawn outside in UFO sites.
| 0
|-
| '''itemSets'''
| Three lists (one for each alien technology level) of [[#Items|items]] (string IDs) for the aliens to equip.
| ''required''
|-
|}

=== Research ===

Defines a [[Research|research topic]] that X-COM scientists can investigate, listed in ''"research:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''name'''
| String ID of the research project's name (or item, if a '''lookup''' is defined).
| ''required''
|-
| '''lookup'''
| String ID of the research project's display name and UFOPaedia article reference.
| -
|-
| '''cost'''
| Number of man hours (on average) required to complete this project.
| 0
|-
| '''points'''
| [[Score]] earned for completing this project.
| 0
|-
| '''needItem'''
| Does this project require an [[#Items|item]] of the same name?
| false
|-
| '''dependencies'''
| List of research projects that can unlock access to this one. If the full list is researched, or if one of the projects on the list "unlocks" this one, it becomes available.
| -
|-
| '''unlocks'''
| List of research projects unlocked, regardless of other dependencies, but not requirements, by completing this project (for example, any live alien unlocks "alien origins").
| -
|-
| '''requires'''
| List of research projects unilaterally required before this project can be unlocked (for example, "the martian solution" will not even be considered for unlocking until AFTER "alien origins" is completed).
| -
|-
| '''getOneFree'''
| List of "bonus" research projects that may be granted when completing this project (for example, alien medics will give you information on other alien races). Only applies to living aliens.
| -
|-
|}

=== Manufacture ===

Defines a [[Manufacture|manufacture project]] that X-COM engineers can produce, listed in ''"manufacture:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''name'''
| String ID of the manufacturing project's name (and the item it produces).
| ''required''
|-
| '''category'''
| String ID of the manufacturing project's category.
| -
|-
| '''requires'''
| List of [[#Research|topics]] (string IDs) that must be researched to unlock this project. If none are specified, this project is unlocked from the start.
| -
|-
| '''space'''
| Amount of [[Workshop]] space required to begin this project.
| 0
|-
| '''time'''
| Number of man hours (on average) required per item.
| 0
|-
| '''cost'''
| Monetary deduction per item manufactured.
| 0
|-
| '''requiredItems'''
| List of [[#Items|items]] required and consumed per item manufactured.
| -
|-
| '''producedItems'''
| List of [[#Items|items]] produced per each item consumed. If not specified, defaults to 1 item with the same string ID as the manufacture.
| 1
|-
|}

=== UFOpaedia Article ===

Defines an article in the in-game [[UFOpaedia]], listed in ''"ufopaedia:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''id'''
| String ID of the article name. This must match the ID of the object associated with this article, if applicable.
| ''required''
|-
| '''title'''
| String ID of the article title. If omitted, the '''id''' is used.
| -
|-
| '''type_id'''
| Type of this article:
* 0 = Unknown
* 1 = [[Craft]]
* 2 = [[Craft Armaments]]
* 3 = [[HWP]]
* 4 = [[Equipment (EU)|Equipment]]
* 5 = [[Armour]]
* 6 = [[Base Facilities]]
* 7 = Text & Image (eg. [[Alien Life Forms]], [[UFO Components]])
* 8 = Text (eg. [[Alien Research]])
* 9 = [[UFO]]
| 0
|-
| '''section'''
| String ID of the UFOpaedia section this article belongs in.
| -
|-
| '''requires'''
| List of [[#Research|topics]] (string IDs) that must be researched to unlock this article. If none are specified, this article is unlocked from the start.
| -
|-
| '''image_id'''
| Filename of the [[UP001.SPK-UP042.SPK|background image]] displayed on this article, if applicable.
| -
|-
| '''text'''
| String ID of the description displayed on this article.
| -
|-
| '''text_width'''
| Maximum width of the text displayed, only applicable to ''Text & Image'' articles.
| 0
|-
| '''rect_stats'''
| Rectangle ('''x''', '''y''', '''width''', '''height''') of the stats text on the screen, only applicable to ''Craft'' articles.
| 0
|-
| '''rect_text'''
| Rectangle ('''x''', '''y''', '''width''', '''height''') of the description text on the screen, only applicable to ''Craft'' articles.
| 0
|-
| '''weapon'''
| String ID of the weapon, only applicable to ''HWP'' articles.
| -
|}

=== UFO Trajectories ===

Defines a trajectory carried out by an UFO during an [[#Alien Missions|alien mission]], listed in ''"ufoTrajectories:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''id'''
| String ID of the trajectory name.
| ''required''
|-
| '''groundTimer'''
| Amount of seconds for the UFO to spend on Ground waypoints.
| 0
|-
| '''waypoints'''
| List of waypoints for the UFO to traverse, defined as ''[zone, altitude, speed]''. 
'''zone''': Globe zone where the waypoint is located. 
'''altitude''': UFO altitude after reaching this waypoint:
* 0 - Ground
* 1 - Very Low
* 2 - Low
* 3 - High
* 4 - Very High
'''speed''': UFO speed after reaching this waypoint, as a percentage (0-100%) of its maximum speed.
| -
|}

=== Alien Missions ===

Defines an [[Alien Missions|alien mission]] carried out by UFOs on the Geoscape, listed in ''"alienMissions:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the mission type.
| ''required''
|-
| '''points'''
| [[Score]] allocated to aliens for successfully completing this mission.
| 0
|-
| '''raceWeights'''
| List of alien races likely to carry out this mission, and the % chance of them being allocated to this mission, listed by "number of months after game beginning".
| ''required''
|-
| '''waves'''
| List of UFO waves to spawn as this mission progresses, as described below.
| ''required''
|}

==== Waves ====

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''ufo'''
| String ID of the [[#UFOs|UFO]] to spawn.
| ''required''
|-
| '''count'''
| Number of UFOs to spawn.
| 0
|-
| '''trajectory'''
| String ID of the [[#UFO Trajectories|trajectory]] for this UFO to use when entering Earth's atmosphere.
| ''required''
|-
| '''timer'''
| How long after the previous wave should this wave arrive? (in seconds)
| 0
|-
|}

=== Alien Item Levels ===

This is a list of item level probabilities, with a number between 0 and 2 representing an item level from plasma pistols to heavy plasmas, as defined in the deployments, expressing a 10% probability for that item level being used.

0 = first set (plasma pistol/clip)
1 = second set (plasma rifle/clip)
2 = third set (heavy plasma/clip)

For example:
[ 2, 0, 0, 0, 0, 0, 0, 1, 1, 1 ]
would represent a 60% chance for pistols, 30% rifles, and 10% heavy weapons. 
Note that the order does not matter, but the length DOES. each line MUST have 10 digits.

The above can be confusing. There are 10 fields; each number represents 10%. 
There is only one instance of '2'. 1x10% = 10% chance of plasma pistol 
There are three instances of '1'. 3x10% = 30% chance of plasma rifle 
There are six instances of '0'. 6x10% = 60% chance of heavy plasma 

Each line represents a month after the beginning of the game, and there is no limit to the number defined. 
OpenXCom will use the most recently available item level in the event the game goes on forever.

=== Extra Sprites ===

Adds or replaces sprites in an existing [[Image Formats|X-COM image file]], listed in ''"extraSprites:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| Filename of the original/new image to modify.
| ''required''
|-
| '''width'''
'''height'''
| Size of the sprite(s) in pixels.
| 0
0
|-
| '''singleImage'''
| Is the image file just a single sprite (true) or a spritesheet (false)?
| false
|-
| '''subX'''
'''subY'''
| Size of the subdivision in pixels. If a subdivision is specified, then the image file is divided into chunks to form the sprites (eg. spritesheets).
| 0
0
|-
| '''files'''
| List of the new sprites to add/replace, listed as ''spriteID: filename''.
| -
|}

Example:
- type: GIANTBUNNY.PCK
width: 32
height: 40
files:
0: Resources/Bunny/Bunny00.png
1: Resources/Bunny/Bunny01.bmp
2: Resources/Bunny/Bunny02.gif

=== Extra Sounds ===

Adds or replaces sounds in an existing [[SOUND|X-COM sound file]], listed in ''"extraSounds:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| ID of the original sound file to modify:
* BATTLE.CAT - Battlescape sounds, corresponds to ''SOUND1.CAT'' or ''SAMPLE2.CAT'' (55 sounds).
* INTRO.CAT - Intro sounds, corresponds to ''INTRO.CAT'' or ''SAMPLE3.CAT'', probably best not to mess with these.
* GEO.CAT - Geoscape sounds, corresponds to ''SOUND2.CAT'' or ''SAMPLE.CAT'' (14 sounds).
| ''required''
|-
| '''files'''
| List of the new sounds to add/replace, listed as ''soundID: filename''.
| -
|}

Example:
- type: BATTLE.CAT
files:
55: Resources/Sounds/sample.wav

=== Extra Strings ===

Adds or replaces text strings in an existing [[Translations (OpenXcom)|OpenXcom language file]], listed in ''"extraStrings:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| Filename of the original language file to modify, sans extension.
| ''required''
|-
| '''strings'''
| List of the new strings to add/replace, listed as ''stringID: text''.
| -
|}

Example:
- type: en-US
strings:
STR_SNIPER_RIFLE: Sniper Rifle
STR_SNIPER_RIFLE_CLIP: Sniper Rifle Clip
- type: en-GB
strings:
STR_SNIPER_RIFLE: Sniper Rifle
STR_SNIPER_RIFLE_CLIP: Sniper Rifle Clip
- type: de
strings:
STR_SNIPER_RIFLE: Scharfschützengewehr
STR_SNIPER_RIFLE_CLIP: Scharfschützengewehrmunition
- type: ru
strings:
STR_SNIPER_RIFLE: Снайперская винтовка
STR_SNIPER_RIFLE_CLIP: Магазин к снайп. винтовке

=== Interfaces ===

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| ''?''
| -
|-
| '''elements'''
| ''?''
| -
|-
| '''id'''
| ''?''
| -
|-
| '''color'''
| ''?''
| -
|}

=== StatStrings ===

[[Statstrings]] are used for automatically renaming soldiers. They are case sensitive and they are processed in the order in which they are specified.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''string'''
| String to add to name.
| ''required''
|-
| '''psiStrength''' 
'''psiSkill''' 
'''bravery''' 
'''strength''' 
'''firing''' 
'''reactions''' 
'''stamina''' 
'''tu''' 
'''health''' 
'''throwing'''
| One or more stat ranges are ANDed together for success. Each range has a minVal and maxVal. Use YAML standard tilde (~) to indicate null.
| -
|}

Example:
statStrings:
- string: "x"
psiStrength: [~, 30]
- string: "P"
psiStrength: [80, ~]
- string: "p"
psiStrength: [60, 79]
- string: "K"
psiSkill: [60, ~]
- string: "k"
psiSkill: [30, 59]
- string: "b"
bravery: [60, ~]
- string: "c"
bravery: [~, 10]
- string: "w"
strength: [~, 25]
- string: "Snpr"
firing: [60, ~]
reactions: [60, ~]
- string: "M"
firing: [70, ~]
- string: "m"
firing: [60, 69]
- string: "Sct"
reactions: [50, ~]
tu: [60, ~]
- string: "R"
reactions: [60, ~]
- string: "r"
reactions: [50, 59]

==References==
<references />

[[Category:OpenXcom]]