UFOpaedia - User contributions [en]

Installing (OpenXcom)

2016-02-05T03:35:55Z

Winterheart:

'''OpenXcom requires a vanilla version of the original [[X-COM]] resources.''' This can be any one of:

* DOS Version 1.4 (you can check if you have the correct version if it contains a "SOUND\GM.CAT" file)
* Windows Version / Collector's Edition
* Steam Version (you can find the game folder in "Steam\steamapps\common\xcom ufo defense\XCOM")

Make sure your copy has the [http://openxcom.org/index.php/downloads-extras/ latest patch]. '''Do not''' use modded versions (eg. [[XcomUtil]]) as they may cause bugs and crashes.

== Instructions ==

In the instructions below, we refer to three different folders a lot: the "data" folder, the "user" folder, and the "config" folder. See [https://github.com/SupSuper/OpenXcom#directory-locations here] for directory definitions and where they are located on your operating system.

=== All platforms ===

Copy the original resources (specifically the GEODATA, GEOGRAPH, MAPS, ROUTES, SOUND, TERRAIN, UFOGRAPH, UFOINTRO, and UNITS subfolders) to OpenXcom's [https://github.com/SupSuper/OpenXcom#directory-locations Data folder] for version 1.0 or to the UFO folder in the [https://github.com/SupSuper/OpenXcom#directory-locations User folder] for the nightly. If using the nightly, you can alternately/additionally copy in Terror From the Deep files to the TFTD folder in your User folder to prepare for when the TFTD OpenXcom ruleset is released. '''Do not''' just drag/copy your whole X-COM folder into the Data folder, it won't work. For version 1.0 it should end up like this:

* data
** '''GEODATA'''
** '''GEOGRAPH'''
** Language
** '''MAPS'''
** Resources
** '''ROUTES'''
** Ruleset
** Shaders
** SoldierName
** '''SOUND'''
** '''TERRAIN'''
** '''UFOGRAPH'''
** '''UFOINTRO'''
** '''UNITS'''

and for the nightly it should look like this:

* '''UFO'''
** '''GEODATA'''
** '''GEOGRAPH'''
** '''MAPS'''
** '''ROUTES'''
** Shaders
** '''SOUND'''
** '''TERRAIN'''
** '''UFOGRAPH'''
** '''UFOINTRO'''
** '''UNITS'''

If you do this incorrectly, you'll get an error about "X not found". For more specific instructions, check your platform below.

==== Video tutorial ====

A video tutorial that covers the installation of milestone version 1.0 [http://www.youtube.com/watch?v=rNneKAwvjoU is available here] (courtesy of [http://www.youtube.com/channel/UCHymw9FSZqharCpMW-WiiHg Ivan Dogovich]). Though recorded for the Windows platform, check it out if you have doubts about a particular step during the installation.

=== Windows ===

The installer will automatically detect Steam installations, patch the game and copy the original data for you, just follow the instructions.

=== Mac OS X ===

Copy the resources to the application's '''data''' resource (right click the application > Show Package Contents > Contents > Resources > data) for version 1.0 or the UFO and/or TFTD resources for the nightly.

=== Unix-like ===

OpenXcom requires the following libraries:

* [http://www.libsdl.org/ SDL] (libsdl1.2)
* [http://www.libsdl.org/projects/SDL_mixer/ SDL_mixer] (libsdl-mixer1.2)
* [http://www.ferzkopp.net/joomla/content/view/19/14/ SDL_gfx] (libsdl-gfx1.2), version 2.0.22 or later
* [http://www.libsdl.org/projects/SDL_image/ SDL_image] (libsdl-image1.2)
* [http://code.google.com/p/yaml-cpp/ yaml-cpp] (libyaml-cpp), version 0.5.1 or later (please note that 0.5.2 has issues, use 0.5.3)

Check your distribution's package manager or the library website on how to install them.

Copy game resources to the appropriate [https://github.com/SupSuper/OpenXcom#linux folder locations].

=== Portable ===

To make a portable version of OpenXcom, just put all the files in the game folder, with a '''data''' (1.0) or '''UFO''' (nightly) subfolder for the resources and a '''user''' subfolder for your saves and settings (you may need to delete your old User Folder so the game doesn't use it instead).

== Log file ==

In case you experience any problems or errors during the initial game loading/startup, these will be shown and logged in ''openxcom.log'' in the [https://github.com/SupSuper/OpenXcom#directory-locations User Folder]. Make sure you installed everything correctly as instructed, and if you still experience problems, check the [http://openxcom.org/forum/ forums].

[[Category:OpenXcom]]

Ruleset Reference Nightly (OpenXcom)

2015-11-03T14:32:34Z

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

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 file paths are case insensitive, but IDs (such as string IDs, music names, or cutscene names) are case sensitive. In general, though, if it works on one operating system, it will work on all operating systems.

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.
| -
|-
| '''textures'''
| List of terrains that correspond to each [[TEXTURE.DAT|Geoscape texture]]. Terrains can be restricted to certain areas on the globe with '''area: (''[lon1, lat1, lon2, lat2]'')''' and '''weight: NUMBER''' gives their chance of appearance.
| -
|-
| '''deployments'''
| List of alienDeployments that correspond to each [[TEXTURE.DAT|Geoscape texture]].
| -
|}

=== 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.
| -
|-
| '''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.
Mission zone 3 defines cities belonging to a region (''[lon1, lat1, lon2, lat2, -1, STR_CITY_NAME]''). They will be displayed on the globe and used for terror site missions. Cities can also have a '''zoom''' setting which determines the appearance of its name label according to the specified zoom level.
| -
|-
| '''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. If "true", the radar detection chance will be taken from '''radarChance''' value.
| 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.
'''NOTE''': Explosive style weapons (Damage type: smoke, incendiary, stun, & High Explosive) use [[X1.PCK]] and should always be set to 0.
| 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. If specified for a HWP, clipSize determines the maximum amount of shots which can be loaded into the HWP weapon.
| 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
|-
| '''specialType'''
| MCD value in map files to which this item corresponds for mission recovery.
| -
|-
| '''recover'''
| Is this item recoverable? (gets transported to the X-COM base on mission success)
| true
|-
| '''armor'''
| How much damage is needed to destroy this item on the ground.
| 20
|-
| '''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''
|-
| '''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
|-
|'''revealedFloors'''
| Map block floor to be revealed from the very beginning; use a list "[0, 1, ..]" to reveal multiple floors
|-
| '''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 - can also be used to place 'UFO' maps (or any other single map) on missionSite (objective 3) missions.
* digTunnel
* fillArea
* checkBlock
* removeBlock
* resize
| ''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, representing x/y/height/width.
| full map [0,0,mapSize_X,mapSize_Y]
|-
| '''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
|-
| '''UFOName'''
| TO define the UFO to be placed as a string (STR_).
| 0
|}

==== Guidelines/Tips ====
* There are 3 main 'types' of map generation in UFO/TFTD:
** Random, where any map block (including XCom craft and/or UFOs/USOs) can be placed anywhere in the [[Battlescape]];
** Procedurally generated, where placement of certain maps is defined by rules (i.e. the roads on the Urban terrain used in terror sites in Enemy Unknown/UFO Defense);
** Static, where only 1 or more maps are used (i.e. Cargo and Liner Ships in TFTD).
* Map scripting in OpenXcom allows also for a mixture of 2 or even all the 3 described above, where some parts of the map will be static, others will be filled according to certain rules and the remainer filled randomly.
* Every script requires at least 1 map block used for spawning XCom units. Usually that role is taken by XCom craft, except on the XCom Base, Alien Base and the 2nd part of the Cydonia mission. If the script can't place this map then OpenXcom will display a message saying that it couldn't place XCom units on the map.
* Every space on the Battlescape needs to be filled, so the script should have enough mapblocks available for use. In the case of the vanilla terrains, the maxUses settings were designed mostly for 50x50 dimensions so any increases to those dimensions will require adjusting the maxUses settings. Otherwise the game will crash and display an error message that it couldn't generate the map.
* The "addLine" command relies on groups 2, 3 and 4 as its vertical road, horizontal road and crossroad pieces.
* The "addCraft" and "addUFO" commands will place blocks from group 1 as well, by default, if any are defined.

=== Mission Scripts ===
MissionScripts determines how many missions are spawned each month.
{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| Name of the script the is used for overwriting or deleting purposes.
| ''required''
|-
| '''firstMonth'''
| Months this command runs on, 0 runs on startup of a new game
| 0
|-
| '''lastMonth'''
| Do not run after this month. In this context we mean "run once". -1 denotes no limit.
| -1
|-
| '''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. For example, [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.
| -
|-
| '''missionWeights'''
| The type of mission to spawn (omit to pick one from the mission table). These are split into monthly chunks, and can contain multiple entries including weighted odds, but there is a caveat here: You cannot mix and match missions with mission site objectives (ie: terror) with regular missions. They are generated too differently. Using executionOdds and conditionals instead can achieve exactly the same thing. Similarly, terror missions should not appear in regional mission weights (regions.rul).
| -
|-
| '''executionOdds'''
| % chances of this command executing.
| 100
|-
| '''targetBaseOdds'''
| % chances of this mission targeting a region containing an xcom base instead of random.
| 0
|-
| '''startDelay'''
| Number of minutes to delay the start of the mission (rounded down to the nearest 30). For 0 the wave timer from the mission itself is used.
| 0
|-
| '''raceWeights'''
| List which can override established monthly race weights if desired.
| -
|-
| '''regionWeights'''
| List which can override established monthly region weights if desired. This will come into play only if the mission doesn't target an xcom base.
If the list is omitted: for a terror type mission, all regions that meet the criteria will be weighed equally. For regular missions the normal regional distribution weights will be applied.
| -
|-
| '''minDifficulty'''
| This command only applies to difficulty levels of this or above.
| 0
|-
| '''researchTriggers'''
| A list of research topics that can influence the execution of this mission. For example
* "''STR_THE_ULTIMATE_THREAT: true''" means the mission would only run if the player has researched the ultimate threat.
* "''STR_TLETH_TH_ALIEN_CITY: false''" means the mission would only run if the player has not researched Tleth.
Several research triggers can be combined and for the mission to appear all must be fulfilled.
| 0
|-
| '''maxRuns'''
| This mission type can only execute this number of times, -1 for infinite.
| -1
|-
| '''avoidRepeats'''
| This is used to ensure different coordinates for this mission. It means "store an array of ''x'' previous coordinates, and don't use them again".
| 0
|-
| '''varName'''
| This is an internal variable name, used for tracking maxruns and avoidRepeats.
| -
|-
| '''useTable'''
| Check if this mission type appears in the mission tables. If ''true'' remove it from there?
| true
|}

==== Guidelines/Tips ====
Relevant ruleset files for editing missions are for a terror type mission:

* missionScripts.rul
* alienMissions.rul
* alienDeployments.rul
* ufoTrajectories.rul
* regions.rul
* globe.rul

alienDeployments.rul defines the mission site details the globe defines the terrain (id:-3) which references the deployment directly, because this is a terror site terrain. The region defines a number of city-style "points" (meaning the min/max values are the same for lat/lon) which use that terrain/texture. The trajectory points to these "points" as the mission site targets.
The alienMission provides the link between the trajectory and the region in its waves, which spawn the site directly instead of an actual UFO/USO and finally the missionScript invokes the AlienMission.

=== 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.
| -
|-
| '''spriteFaceGroup'''
| Pixel color group in [[PALETTES.DAT#Color Indexes|palette]] that will be replace in unit graphic by new color, range form 1-15 (its skip first group). Used by face recoloring based on nationality.
| ''example:'' 6
|-
| '''spriteFaceColor'''
| New colors index for face pixels. 8 values ordered by:
* Male Blond
* Female Blond
* Male Brown
* Female Brown
* Male Asian
* Female Asian
* Male African
* Female African
Other units use random position form table.
Value 0 mean original value.
| ''example:''
- 96
- 96
- 96
- 96
- 160
- 160
- 163
- 163
|-
| '''spriteHairGroup'''
| Pixel color group in [[PALETTES.DAT#Color Indexes|palette]] that will be replace in unit graphic by new color, range form 1-15 (its skip first group). Used by hair recoloring based on nationality.
| ''example:'' 9
|-
| '''spriteHairColor'''
| New colors index for hair pixels. 8 values ordered by:
* Male Blond
* Female Blond
* Male Brown
* Female Brown
* Male Asian
* Female Asian
* Male African
* Female African
Other units use random position form table.
Value 0 mean original value.
| ''example:''
- 144
- 144
- 164
- 164
- 245
- 245
- 166
- 166
|-
| '''spriteUtileGroup'''
| Pixel color group in [[PALETTES.DAT#Color Indexes|palette]] that will be replace in unit graphic by new color, range form 1-15 (its skip first group).
| -
|-
| '''spriteUtileColor'''
| New colors index for pixels. 8 values ordered by:
* Male Blond
* Female Blond
* Male Brown
* Female Brown
* Male Asian
* Female Asian
* Male African
* Female African
Other units use random position form table.
Value 0 mean original value.
| -
|-
| '''spriteRankGroup'''
| Pixel color group in [[PALETTES.DAT#Color Indexes|palette]] that will be replace in unit graphic by new color, range form 1-15 (its skip first group).
| -
|-
| '''spriteRankColor'''
| New colors index for pixels. For solders 6 values ordered by:
* STR_ROOKIE
* STR_SQUADDIE
* STR_SERGEANT
* STR_CAPTAIN
* STR_COLONEL
* STR_COMMANDER
For aliens 7 values ordered by (alien unit rank property):
* STR_LIVE_SOLDIER
* STR_LIVE_ENGINEER
* STR_LIVE_MEDIC
* STR_LIVE_NAVIGATOR
* STR_LIVE_LEADER
* STR_LIVE_COMMANDER
* STR_LIVE_TERRORIST
Civilians uses random position form 8 element table.
Value 0 mean original value.
| -
|-
| '''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
|-
| '''constantAnimation'''
| Set it to "true" for units that constantly show an animation, such as: Biodrone, Celatid, Silacoid.
| false
|-
| '''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:"''.

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]]

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the soldier type.
| ''required''
|-
| '''requires'''
| List of [[#Research|topics]] (string IDs) that must be researched to unlock this soldier type. If none are specified, this soldier type is unlocked from the start.
| -
|-
| '''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.
| -
|-
| '''costBuy'''
| Amount of money spent for hiring this soldier type. If set to 0, the soldier type will not be available in the Purchase/Recruit screen.
| 0
|-
| '''costSalary'''
| Amount of money spent monthly for employing this soldier type.
| 0
|-
| '''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
|-
| '''soldierNames'''
| List of soldier name files/paths. Use '''delete''' to clear previously-loaded names.
| -
|}

=== 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]]

{| 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. No value means no sound at death.
| -
|-
| '''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
| 30
|-
| '''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 = [[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
|-
| '''meleeWeapon'''
| If this unit has a built in weapon, what is it? this weapon does not go in an inventory slot. (must reference an item)
| -
|-
| '''builtInWeapons'''
| A list of weapons this unit comes pre-equipped with. these WILL appear in inventory slots (references items)
| -
|-
|}

=== 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.
| ""
|-
| '''finalDestination'''
| Sets whether this mission is where you send your [[Avenger|uber-craft]] to win the game.
| "false"
|-
| '''winCutscene'''
| Sets the cutscene to play when you win the mission. If set to "winGame" or "loseGame", the player will be returned to the main menu after the cutscene plays.
| -
|-
| '''loseCutscene'''
| Sets the cutscene to play when you lose the mission. If set to "winGame" or "loseGame", the player will be returned to the main menu after the cutscene plays.
| -
|-
| '''alert'''
| String ID to use when this mission spawns on the Geoscape.
| -
|-
| '''markerName'''
| String ID that identifies this mission on the Geoscape.
| -
|-
| '''durationMin'''
'''durationMax'''
| Minimum and maximum duration of this mission on the Geoscape (in hours).
I think these are deprecated; you should use '''duration'''.
| -
|-
| '''duration'''
| [''min'', ''max''] -- Minimum and maximum duration of this mission on the Geoscape (in hours).
| -
|-
| '''script'''
| Reference to a mapScript.
| -
|-
| '''data'''
| List of deployment data for each alien rank on this mission (see below).
| -
|-
| '''briefing'''
| Information about the mission briefing (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
|-
| '''extraQty'''
| functionally identical to dQty, 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''
|-
|}

==== Briefing Data ====

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''title'''
| String ID for a custom briefing title text. Defaults to the same name as the ''alienDeployment''.
| -
|-
| '''desc'''
| String ID for a custom briefing description text. Defaults to the same name as the ''alienDeployment + _BRIEFING''.
| -
|-
| '''palette'''
| The color swatch to use from [[BACKPALS.DAT]].
| 0
|-
| '''textOffset'''
| Number of pixels to vertically offset the briefing text. Larger values move the text further down the screen.
| 0
|-
| '''music'''
| The ID of the music to play.
| "GMDEFEND"
|-
| '''background'''
| The background screen to show.
| "BACK16.SCR"
|-
| '''showCraft'''
| Whether to show the name of craft that arrived at the mission site.
| true
|-
| '''showTarget'''
| Whether to display the mission target name.
| true
|-
| '''cutscene'''
| Sets the cutscene to play before the mission briefing.
| -
|-
|}

==== Objectives Data ====

Used to define tile types towards objectives. Used for Alien Base Control Modules (UFO & TFTD), Synomium Devices (TFTD) and Alien Brain/T'Leth (UFO/TFTD).
{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''objectiveType'''
| Defines which type of MCD to check for when tallying mission objectives.
| -
|-
| '''objectivesRequired'''
| How many of the previous tile types must be destroyed in order for the mission to be considered a success.
| -
|-
| '''objectivePopup'''
| Defines the message that will appear between turns, after the objective requirements have been fulfilled.
| -
|-
| '''objectiveComplete'''
| The string and score adjustment to be shown on the mission debriefing.
| [string, int]
|-
| '''objectiveFailed'''
| The string and score adjustment to be shown on the mission debriefing.
| [string, int]
|-
| '''despawnPenalty'''
| How many points the aliens will receive when this site despawns due to XCom negligence.
| -
|-
| '''points'''
| How many points the aliens will receive each half hour that the mission site stays active. Does not stack with despawnPenalty.
| -
|-
|}

=== 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-days (on average, the final time will be 50-150% this value) 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). Used in Alien Navigators (gives random alien Mission), Medics (random alien interrogation or autopsy) or Engineers (gives UFO type).
| -
|-
| '''unlockFinalMission'''
| If true, this research topic allows to send a spacecraft to the final mission.
| false
|-
| '''cutscene'''
| The name of the cutscene to play when this project is completed. If the cutscene is "wingame" or "losegame", the player is returned to the main menu after the cutscene plays.
| -
|}

=== 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)|Equipment]]
* 15 = TFTD Armour
* 16 = TFTD [[Base Facilities (TFTD)|Base Facilities]]
* 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
|-
| '''objective'''
| Missions are split by objective:
* 0 = score (default if omitted)
* 1 = infiltration
* 2 = alien base
* 3 = mission site (terror etc)
* 4 = retaliation
* 5 = supply
| 0
|-
| '''spawnZone'''
| mission zone to use when spawning mission sites / alien bases.
| -
|-
| '''spawnUfo'''
| UFO to spawn for retaliation.
| -
|-
| '''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
|-
| '''objective'''
| ''true'' Marks this wave as the one that carries out the mission objective. Only for mission site / supply missions.
| -
|-
|}

=== 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

=== Music ===

Custom music options can be defined in the Music.rul file. More details [[Audio Options (OpenXcom)#Custom Music|here]].

=== 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]

==Font==

Defines the [[Font collection (OpenXcom)|font collection]] used by default.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''fontName'''
| Name of *.dat file, placed in Language folder, which describes used [[Font collection (OpenXcom)|font collection]].
| Font.dat
|}

== Cutscenes ==

Defines a video playlist or a slideshow sequence, listed in ''"cutscenes:"''.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''type'''
| String ID of the cutscene.
| ''required''
|-
| '''useUfoAudioSequence'''
| Whether to use the audio sequence for the original UFO intro movie. This should only ever be set to true for the UFO intro.
| "false"
|-
| '''videos'''
| A list of video filenames to play with the FLC player.
| ''required if this is cutscene is a video playlist''
|-
| '''slideshow'''
| Info for playing a slideshow (see below).
| ''required if this is cutscene is a slideshow''
|}

==== Slideshow Data ====

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''transitionSeconds'''
| The number of seconds to wait before automatically transitioning to the next slide. The user can always force a transition faster by clicking.
| 30
|-
| '''musicId'''
| The id of the music to play.
| -
|-
| '''slides'''
| List of slide data elements (see below).
| ''required''
|}

==== Slide Data ====

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''imagePath'''
| The path to the image file to display in the background. The palette for the slide is taken from the image, so caption text color will be determined by the image palette.
| ''required''
|-
| '''caption'''
| The string ID of the caption text.
| -
|-
| '''captionSize'''
| The size of the text box, in pixels, in which to display the caption.
| [320, 200]
|-
| '''captionPos'''
| The screen position at which to display the caption.
| [0, 0]
|-
| '''captionColor'''
| The palette index to use for the caption color.
| ''required''
|}

==References==

<references />

[[Category:OpenXcom]]

Info (XCOM2)

2015-10-21T09:12:10Z

Winterheart: /* Aliens/Enemies */

[[File:XCOM2_SCREEN.PNG|450px|center]]
This page is to collect all the information related to Firaxis' upcoming XCOM 2 game, released through official channels and confirmed sources. '''XCOM 2 will be released on February 5, 2016'''. On September 10, 2015, the game was released for pre-order on steam.21 22

When adding new info please make sure to properly attribute its source(s). If there are conflicting pieces of information from different sources, list both and add them the <nowiki>{{Verify}}</nowiki> template. Any discussion/speculation about the game should be kept away from this page, use instead the [[Talk:XCOM2]] page.

==Storyline==
[[File:Advent_Solder_and_Statue.png|right|300px|The Alien Overlords]]
* The new game takes place 20 years after Earth's surrender to the aliens during the invasion. According to Jake Solomon, XCOM lost the initial alien invasion and as Earth surrendered, XCOM went underground to continue the fighting3.
* According to XCOM 2' storyline, XCOM never made it out of conventional weapons before the surrender. To Firaxis, the first game has ended with the same result of the majority of games played on Impossible Ironman, with a loss for the player. According to official stats, only 1.1% of players have earned the achievement for winning on Impossible and 1.7% for completing Ironman. 10
* The aliens established a world government called 'Advent Administration' staffed with human collaborators and their propaganda claims that the aliens had came initially in peace but by engaging the aliens in combat XCOM has caused countless casualties. They also created a holiday called 'Unification Day' to mark the date of their take over of Earth. 12
* The alien overlords have built megacities where war, poverty, crime and disease are supposedly eradicated, but which only serve as a cover for more sinister plans for humankind. Those cities have been built to attract the human population into them by offering gene therapy4.
** The megacities are a nod to [[Apocalypse|XCOM: Apocalypse]]4.
* The rest of humanity lives on the wilderness, where XCOM operates and there will also be missions there. Variety of combat environments.
* XCOM HQ is now a captured Alien Supply Ship that has been converted as a mobile command center to waging a guerrilla style war against the aliens. There have been hints by the developers that base management has been expanded, although no details have been released so far.
* Of all the characters in Enemy Unknown, at least [[Bradford (EU2012)|Bradford]] reappears on XCOM 2 still in his role as 'Central'. 10 According to the developers Bradford has been on the run until XCOM was reinstated, and until then he was a broken man due to the Council's betrayal that led to the defeat of XCOM during the invasion.
** Dr. Shen has passed away during the 20 years since XCOM lost the war, although he did manage to successfully teach his daughter everything he knew, allowing her to take up his position in the orginisation.20

==Engine==
* Wide mod support: you can create maps, new races, story lines and campaigns and share them via Steam Workshop.
* Game will be PC exclusive.
* XCOM 2 will run on a heavy modified version of the Unreal Engine 3.5 6.

==Soldiers==
[[File:03_x2_screens_overview_thm.png|right|300px|XCOM Squad]]
* The squad at the beginning of the game is not an elite force, but the player is in charge of a 'rag tag, freedom fighters, guerrilla fighters. They look like irregular troops.
* Soldiers appear to have 'Character Skills' (check Tactical picture)
* Customization now also applies to left/right arms, shoulders, etc., to reflect the rag tag nature of XCOM. Characters can also earn unique characterization features. Possible to change the gender/nationality of all human units.
* Squad sizes remain at 4-6 units.
* Carrying ability - when evacuating it is possible for soldiers to carry back to base the bodies of their injured or dead comrades4.
* All classes are capable of hacking, however only the Specialist can perform some hacks. Hacking includes devices, terminals, robotic aliens and possibly other targets.9.
* Customized soldiers can be saved to a player's pool of possible soldiers, allowing them to appear in a different campaign.24
* Pre-ordering the game grants access to the Resistance Warrior Pack, which features new customization options for your soldiers as well as a "Survivor of the Old War".21 22
===Classes===
[[File:04_x2_screens_overview_thm.png|right|300px|Sharpshooter]]
* There are 5 classes - Ranger, Sharpshooter, Grenadier, Specialist (those are evolved versions of the original 4 classes)
** 5th class is still undisclosed.
 
====Sharpshooter====
* New version of [[Sniper (EU2012)|Sniper]], can specialize in Pistol skills in alternative to the sniper rifle.
* Can wield both a sniper rifle and a pistol effectively, depending on skill tree choices17.
* Death From Above ability - grants an extra action when an enemy at a lower elevation is killed. (Sniper skill)17
* Fan Fire ability - allows three shots against a single target. (Pistol skill)17.
====Ranger====
[[File:07_x2_screens_news_thm.png|right|300px|Ranger]]
* New version of [[Assault (EU2012)|Assault]] class, carries sword, can engage on melee combat.
* Rangers carry either a Shotgun or Assault Rifle as primary weapons and a machete sword8.
* They are either damage dealing assaults or scouts that can move quickly and silently and even climb walls8.
* While advancing, they can be followed and buffed/protected by the Gremlin drone carried by the Specialist8.
* Reaper ability - every kill with a melee weapon allows for a further attack8.
* Phantom ability - when the squad is revealed, this soldier stays concealed18.
* Shadowstrike ability - bonus aim and 25 bonus critical chance when attacking enemies that can't see the Ranger18.
* Charge ability - may activate standard melee attack for free after Dashing in one turn18.
 
====Specialist====
[[File:08_x2_screens_news_thm.png|right|300px|Specialist and Gremlin drone]]
* Carries a 'Gremlin' drone that can be used as a secondary weapon, for stunning aliens or buff allies, or for hacking. AKA [[Support (EU2012)|Support]] class.
* Specialist is either support (healing, support buffs, boosting stats) or offensive (hacking and controlling enemies)9.
* Gremlin can carry a stun area effect weapon, heal, scout or even be assigned to protect a Ranger4.
** Can be upgraded to carry the stun area effect weapon or to hack a terminal 9.
* Gremlin doesn't move on its own - the Specialist needs to spend its action move for a turn to guide it.
* Specialists can get the Intrusion Protocol ability at later ranks, which allows it to hack and control robotic enemies.9
* Specialist class can improve its hacking skills faster than others9.
* Intrusion Protocol ability - The Gremlin hacks a robotic enemy and disables or takes over it12.
* Aid Protocol ability - The Gremlin grants a friendly target a bonus to Defense until the start of the next player turn18.
* Hacker ability - attempt to breach security on a network access point with the Gremlin18.
 
====Grenadier====
* The evolution of the [[Heavy (EU2012)|Heavy]] from Enemy Unknown.25[[File:Grenadier (XCOM2).jpg|300px|right]]
** The two ability trees for the Grenadier are called ''Demo expert'' and ''Heavy Gunner''.25
* Wield a Grenade Launcher and a Cannon.25
* Can be trained to focus on demoltion with the Grenade Launcher, or on making the most of the cannon.25
* New ability, ''Salvo'', allows the Grenadier to use a grenade or heavy weapon without ending his turn.25
* ''Shredder'' ability, disintegrates enemy armor25
* New ability, ''Rupture'', a "critical damage attack" that ensures the affected unit takes increased damage from all future attacks.25

==Combat System==
[[File:11_x2_screens_news_thm.png|right|300px|Readying for the ambush]]
* At the start of mission the player will have to move its units without being detected to their objectives. A lot of different elements can break concealment, not just enemies but civilians as well. Scanners can also break concealment4.
** Every XCOM unit starts the mission in concealment.8.
* XCOM now always has the first shot (aliens don't scatter for cover when activated) due to more emphasis on stealth and soldier placement before the shooting starts.
* Aliens will react differently when XCOM reveals its presence: some may still scatter or be completely surprised.4.
* New concealment system that uses waypoints to move and set up soldiers.
* Loot system - timers to recover items carried by dead aliens or even your own fallen soldiers (similar to Meld on EW). Inventory plays a bigger role since XCOM is also living off loot and scavenging.
* Weapon upgrades - variety of those4.
** Autoloaders - Grants free reload17.
** Expanded Magazines - Increased ammo capacity17.
** Can be salvaged from the battlefield and needs to be researched before use17.
* Secondary mission objectives that can be completed instead of the primary one.
* Call for EVAC can be done anywhere on the map on most mission types, as long as there is space for the Skyranger to land. There's still a danger of getting stopped by enemies when trying to reach the area designated for evacuation4.
* [[Meld (EU2012)|Meld]] will not be a part of the game and XCOM will not be able to create [[MEC Trooper (EU2012)|MEC Troopers]], although Advent will use them 13.
==Maps==
[[File:XCOM2terrains.png|right|300px|Different building versions]]
[[File:XCOM2_Wilderness_Types.png|right|300px|Different terrain versions]]

* Procedure generated maps. Large set of tiles (buildings, etc.) which are combined together to create maps. AI also made more procedural to better use the new map system. Terrain will be more dynamic and destructible, including exploding barrels and acid holes. Even floors and ceilings are destructable4.
* Free Aim (being able to target any feature, including terrain) will still be limited to weapons such grenades and rockets.7
* According to Lead Producer Garth DeAngelis, each map is a 'quilt' with holes where buildings are plugged, and the space between the buildings can be occupied with elements to display a variety of environments. 5.
* The space can be occupied by a variety of elements, and there are about 20 'diorama' sets that can be used when designing maps.
 
==Aliens/Enemies==
[[File:01_x2_screens_news_thm.png|right|300px|Sectoid]]
[[File:Viper Twitter.png|right|300px|Viper ]]
[[File:09_x2_screens_overview_thm.png|right|300px|Advent Soldiers]]
[[File:Xcom2 shieldbearer hero.jpg|right|300px|Advent Shieldbearer]]
[[File:XCOM2_stunlancer_hero.jpg|right|300px|Advent Stun Lancer]]
* The aliens have evolved significantly over 20 years and are much stronger; XCOM soldiers will not be able to take on aliens on their own early on.4
* Both new and old aliens are present.
* There are yet undisclosed mechanical aliens.9
* Aliens are able to call for reinforcements at any time.12
* '''Advent Troopers''' - human soldiers which act as city security on behalf of the aliens. They carry magnetic weaponry.4 23
** Speak a language unlike any human ones, and are nicknamed "Jabbers" by XCOM soldiers because of it.19
** Genetically modified to the point of inhuman, with no hair, flattened ears, and large, silvery eyes far apart with no orbs or pupils.19
* '''Advent Captains''' - clad in red armor with cape, stronger variants of Troopers.23
** Can AoE buff standard Troopers with "Command Aura" ability.23
** Can mark an XCOM soldier for death, forcing any Troopers in the area to focus fire on that soldier23
** Can summon reinforcements from Advent VTOL dropships.
* '''Shieldbearers''' - big, heavy troopers that can provide a Shield Bonus to other nearby enemy units on the battlefield.19 28
* '''Stun Lancers''' - aggressive soldiers who will try to get close to XCOM soldiers without regards for their own safety, can disable soldiers with a stun attack.27
* '''Advent MECs''' - similar to [[MEC_Trooper_(EU2012)|MEC Troopers]] and can do AoE damage with micro-missiles.12
* '''Advent Turrets''' - stationary, truck-mounted gauss turrets which can be hacked by XCOM soldiers.12
* '''Sectoids''' - Have now modified themselves using human DNA, making them bigger and possessing more psionic powers.
** Still carries the wrist-mounted plasma blaster.11
** ''Mind Spin'' or '' Psi Spin'' {Verify} is an ability with numerous possible effects, including disorientation, confusion, and mind control.
** ''Psi Reanimate'' can raise dead humans and aliens as "psi zombies" for the Sectoid to control.11
* '''Vipers''' - inspired by the [[Snakeman|Snakemen]] from the original [[X-COM|1994 Enemy Unkown]].
** True forms of the [[Thin Man (EU2012)|Thin Men]].4
** ''Tongue Pull'' can rip your soldiers from cover.11
** ''Bind'' locks soldiers in place and deals damage.11
** ''Poison Spit'' is retained from their Thin Men forms.11
* '''"Dark Collaborators"''' - humanlike individuals which may be assassination objectives.12
* '''Muton Berserkers''' - Evolved to be deadlier than before.12
* ''' Mutons''' - Evolved with Human DNA to be smarter and deadlier.15
** Gets to use ''Suppression'' right off the bat.15
** Still has ''Alien Grenades'', and will use them against groups of soldiers that don't watch their spacing.15
** Has equipped a bayonet on the front of their Plasma Rifles for use in melee.15
** Has an ability called ''Counterattack'' where they can dodge a Ranger's melee attack, and counter with a melee attack from their bayonets.15
* '''Chryssalids''' - Evolved to be deadlier than before.
** All melee attacks cause poison. 16
** XCOM soldiers and civilians killed by poison become cocoons.16
** If a cocoon is not destroyed during the gestation period, three new Chryssalids emerge.16
** Can burrow underground, but cannot move while burrowed.16
* '''Ethereals''' - Appear in various art around Advent cities. There's also a reference to 'Elders' on Advent's propaganda.12
* '''The Faceless''' - an alien race that can mimic the forms of other people.24[[File:Faceless (XCOM2).jpg|right|300px]]
** Undetectable before they transform from their civilian form.26
** "Central advises dispatching this unit from afar, Commander" - they presumably have a short-ranged or melee attack.26
* '''Archons''' - modified [[Floater (EU2012)|Floaters]] which looks like angels.
** ''Blazing Pinions'' - AoE attack like ''Cluster Bomb'' of [[Sectopod (EU2012)|Sectopod]].
** Wounded Archon will enter a frenzied state enabling them to melee attack nearby XCOM soldiers.

 

==Modding==
* Firaxis plans to release an Unreal Development Kit for XCOM 2 and the editor used to add content, either in November or later.7
* There will be Steam Workshop integration to facilitate distribution of mods 7.
* It will be possible to "literally make an Enemy Unknown map.”7
==Media==
<gallery mode="packed" widths=150px heights=100px caption="XCOM 2 Official Site">
File:01_x2_screens_media_thm.png|Tactical - Ranger class (notice sword icon)
File:02_x2_screens_overview_thm.png| Avenger - mobile XCOM base
File:06_x2_screens_overview_thm.png| Inside Avenger
File:Bradford (XCOM2).png|Officer Bradford "Central"
File:05_x2_screens_media_thm.png| New transport (updated [[Skyranger (EU2012)|Skyranger]]?)
File:03_x2_screens_overview_thm.png| XCOM squad
File:05_x2_screens_news_thm.png| XCOM squad concealed
File:07_x2_screens_overview_thm.png| XCOM soldier
File:11_x2_screens_news_thm.png|XCOM soldiers
File:07_x2_screens_news_thm.png| Ranger class
File:03_x2_screens_news_thm.png| Specialist class
File:08_x2_screens_news_thm.png| XCOM Specialist and Gremlin drone
File:04_x2_screens_overview_thm.png| Sharpshooter
File:01_x2_screens_news_thm.png| Sectoid (with human DNA)
File:02_x2_screens_media_thm.png| Sectoid (with human DNA)
File:05_x2_screens_overview_thm.png| Viper (snakewoman)
File:3_-_pBnHCEU.png|Viper
File:4_-_TwaGnRd.png|Evolved Berserker
File:2889649-xcom 2 e3 screenshot berserker .png|Evolved Berserker
File:Xc2 chryssalid.jpeg|Evolved Chryssalid
File:02_x2_screens_news_thm.png| Advent Administration
File:Advent_Solder_and_Statue.png|Advent Soldier
File:09_x2_screens_overview_thm.png| Advent Soldiers
File:04_x2_screens_media_thm.png| Advent Captain
File:1_-_zDCHlRx.png|Advent Soldiers and Captain
File:2_-_bcZ9mze.png|Advent MECs
File:2889658-xcom_2_e3_screenshot_advent-mec.png|Advent MEC
File:Muton1.jpg|Muton (with human DNA)
File:Muton2.jpg|Muton (with human DNA)
</gallery>

<gallery mode="packed" widths=150px heights=100px caption="Concepts">
File:XCOM2_ADVENT_CheckPoint.png|
File:XCOM2_ADVENT-Propaganda_Center_Atrium.png|
File:XCOM2_City_Center.png|
File:XCOM2_NewWorldOrderMood.png|
File:XCOM2_Sectoid.png|Sectoid
File:XCOM2_Viper.png|Viper
File:XCOM2_Soldiers_MedArmorGuerilla.png|Soldier
File:Bradford_Concept_(XCOM2).png|Bradford
File:Xcom2adventenemiesjpg-c7eddd_1670w.png|Advent units
</gallery>

<gallery mode="packed" widths=150px heights=100px caption="Terrains">
File:08_x2_screens_overview_thm.png|
File:06_x2_screens_news_thm.png|
File:Xcom-2-city-center-duskjpg-505ab9_1670w.png|Advent City Center (dusk)
File:Xcom-2-city-center-rainjpg-64b429_1670w.png|Advent City Center (rain)
File:XCOM2CityCentre.png|Advent City Center (fast food)
File:XCOM2_Wilderness_Types.png|Wilderness types
</gallery>

<gallery mode="packed" widths=150px heights=100px caption="Twitter, Initial Trailer and Gameplay Footage Captures">
File:XCOM2_1.png|A version of EXALT's logo?
File:XCOM2_2.png|Advent soldier with Ethereal image behind it
File:XCOM2_3.png|XCOM Squad at extraction
File:Thin Men Advent.png|Thin Man or Evolved Human (notice eye glasses and neck spots)
File:2889645-xcom_2__e3_screenshot_concealment.png|Concealment system
</gallery>

==Sources==
* 1 - Official XCOM 2 site [http://xcom.com/]
* 2 - IGN's 'XCOM 2 Reveal Trailer' [https://www.youtube.com/watch?v=2E_-2wIJIzQ&feature=youtu.be]
* 3 - IGN's 'XCOM 2: Welcoming our new alien overlords' video and article/interview with Jake Solomon [http://www.ign.com/articles/2015/06/02/xcom-2-welcoming-our-new-alien-overlords].
* 4 - IGN's 'XCOM 2 Reveal Trailer Rewind Theater' with Jake Solomon and Garth DeAngelis [http://www.ign.com/videos/2015/06/03/xcom-2-reveal-trailer-rewind-theater]
* 5 - IGN's 'XCOM 2’s Procedurally Generated Maps' [http://www.ign.com/articles/2015/06/04/xcom-2s-procedurally-generated-maps-ign-first].
* 6 - IGN's 'Why XCOM 2 had to be PC exclusive' [http://www.ign.com/articles/2015/06/05/why-xcom-2-had-to-be-pc-exclusive].
* 7 - IGN's 'XCOM 2's Exciting Modding Potential' article [http://www.ign.com/articles/2015/06/08/xcom-2s-exciting-modding-potential-ign-first].
[[Category: XCOM 2]]
* 8 - IGN's 'Meet The XCOM 2 Ranger' article and video [http://www.ign.com/articles/2015/06/09/meet-the-xcom-2-ranger-ign-first]
* 9 - IGN's 'Meet The XCOM 2 Specialist' article and video [http://www.ign.com/articles/2015/06/10/meet-the-xcom-2-specialist-ign-first]
* 10 - XCOM 2'S Bleak Future: Why Impossible Mode Is Canon - IGN First' article and video interview [http://www.ign.com/articles/2015/06/11/xcom-2s-bleak-future-why-impossible-iron-man-mode-is-canon-ign-first].
* 11 - IGN's 'Meet the XCOM2 Sectoid and Viper' [http://www.ign.com/articles/2015/06/12/meet-the-xcom-2-sectoid-and-viper-ign-first?watch]
[[Category: XCOM 2]]
* 12 - IGN's First XCOM 2 Gameplay Footage [https://www.youtube.com/watch?v=AzAKyj-KK-E&t=2m22s]
* 13 - IGN's "E3 2015: No Meld, MEC Troopers in XCOM 2" [http://ap.ign.com/e3-2015/90382/news/e3-2015-no-meld-mech-troopers-in-xcom-2]
* 14 - IGN's 'Meet the XCOM2 Muton' article [http://www.ign.com/articles/2015/07/23/xcom-2s-new-and-improved-muton-unveiled]
* 15 - Official XCOM2 Blog Post on XCOM2 Muton [http://xcom.com/news/the-muton-returns-in-xcom-2]
* 16 - XCOM 2 Exclusive Class Reveal: The Chryssalid [http://www.gamespot.com/articles/xcom-2-exclusive-class-reveal-the-chryssalid/1100-6429038]
* 17 - XCOM 2 Exclusive Class Reveal: The Sharpshooter [http://www.gamespot.com/articles/xcom-2-exclusive-class-reveal-the-sharpshooter/1100-6429035]
* 18 - Official XCOM 2 “Welcome to the Avenger” Gameplay [https://www.youtube.com/watch?v=uJ-rTdoiJZU]
* 19 - XCOM 2: Resurrection preview [http://www.amazon.com/XCOM-2-Resurrection-Greg-Keyes/dp/1608877124]
* 20 - MEET THE PERSONNEL OF THE AVENGER IN XCOM 2 [http://xcom.com/news/en-meet-the-personnel-of-the-avenger-in-xcom-2]
* 21 - XCOM: ENEMY UNKNOWN IS FREE-TO-PLAY ON STEAM THIS WEEKEND [http://xcom.com/news/xcom-enemy-unknown-is-free-to-play-on-steam-this-weekend]
* 22 - XCOM 2 on steam - [http://store.steampowered.com/app/268500/]
* 23 - IGN's 'Meet The XCOM 2 Advent Soldiers' article and video [http://au.ign.com/articles/2015/06/23/meet-the-xcom-2-advent-soldiers-ign-first]
* 24 - Firaxis Mega Panel at PAX Prime – Rising Tide and XCOM 2 [https://www.youtube.com/watch?v=1ep2OEsN07w]
* 25 - XCOM 2’S GRENADIER TURNS DEMOLITION INTO AN ARTFORM [http://xcom.com/news/en-xcom-2s-grenadier-turns-demolition-into-an-artform]
* 26 - XCOM 2’S FACELESS HIDES AMONG US [http://xcom.com/news/en-xcom-2s-faceless-hides-among-us]
* 27 - XCOM 2’S ADVENT STUN LANCER WILL DO ANYTHING TO GET NEAR [https://xcom.com/news/en-xcom-2s-advent-stun-lancer-will-do-anything-to-get-near]
* 28 - THE ADVENT SHIELDBEARER STANDS ITS GROUND IN XCOM 2 [https://xcom.com/news/the-advent-shieldbearer-stands-its-ground-in-xcom-2]

Talk:Translations (OpenXcom)

2015-09-16T11:18:18Z

Winterheart:

Re pluralizations, how does the engine know whether to pick 'few' or 'other', for instance? These rules have to be defined somewhere too.
--[[User:Trigger|Trigger]] ([[User talk:Trigger|talk]]) 12:26, 6 September 2015 (EDT)
: Plurality rules defined and assigned to languages here - https://github.com/SupSuper/OpenXcom/blob/master/src/Engine/LanguagePlurality.cpp --[[User:Winterheart|Winterheart]] ([[User talk:Winterheart|talk]]) 07:18, 16 September 2015 (EDT)

Compiling (OpenXcom)

2015-08-21T05:28:03Z

Winterheart: /* Dependencies */

The OpenXcom codebase is hosted on [https://github.com/SupSuper/OpenXcom Github], and you can grab the latest source with any Git client from: <code>https://github.com/SupSuper/OpenXcom.git</code>

If you're a Github user you might wanna [http://help.github.com/forking use a fork] instead so you can have your own remote repository (you can't push to the official OpenXcom repository without permission) and easily send in pull requests.

OpenXcom is a cross-platform game so it's possible to compile it on a variety of systems and project files for all the popular IDEs are included. There's also a [http://openxcom.org/docs/html/ Doxygen documentation] available.

'''Don't forget to copy the X-Com resources to your ''bin'' folder as shown in [[Installing (OpenXcom)|Installing]].'''

== Dependencies ==

OpenXcom requires the following libraries to compile:

* [http://www.libsdl.org/ SDL] (libsdl1.2)
* [http://www.libsdl.org/projects/SDL_mixer/ SDL_mixer] (libsdl-mixer1.2)
* [http://www.libsdl.org/projects/SDL_image/ SDL_image] (libsdl-image1.2)
* [http://cms.ferzkopp.net/index.php/software/13-sdl-gfx SDL_gfx] (libsdl-gfx1.2), version 2.0.22 or later
* [https://github.com/jbeder/yaml-cpp yaml-cpp], (libyaml-cpp), version 0.5.1 (0.5.2 does ''not'' work, use latest git HEAD if you want newer version)


== All operating systems ==

* [[Compiling with CMake (OpenXcom)|Compiling with CMake]]

== Windows ==

* [[Compiling with Microsoft Visual C++ (OpenXcom)|Compiling with Microsoft Visual C++]]
* [[Compiling with MinGW (OpenXcom)|Compiling with MinGW]]

== Mac OS X ==

* [[Compiling with Xcode (OpenXcom)|Compiling with Xcode]]
* [[Compiling with brew (OpenXcom)|Compiling with brew]]

== Linux/BSD ==

* [[Compiling with Make (OpenXcom)|Compiling with Make]]
* [[Compiling with CMake (OpenXcom)|Compiling with CMake]]
* [[Compiling with Autotools (OpenXcom)|Compiling with Autotools]]

== Misc. ==

* [[Android port (OpenXcom)|Compiling for Android]]

[[Category:OpenXcom]]

XCOM News

2015-08-08T08:41:39Z

Winterheart: /* XCOM2's Avenger mobile base revealed */

This is the Ufopaedia.org news page where relevant news and site messages will appear. When this page is transcluded into other pages, only the new news items should appear there. Everything else will only display on this page.

== News ==
<onlyinclude>
<div style="padding-left:10px;">
====XCOM2's Avenger mobile base revealed====
[[File:XCOM 2 Soldier Customization.png|240px|thumb|Soldier Customization]]
'''August 7th, 2015'''
:* Firaxis has released new [https://www.youtube.com/watch?v=lj42i7f1nj0&feature=youtu.be footage] of the upcoming [[XCOM2]] game, with a focus on the Avenger, the mobile base used by XCOM to fight the ADVENT forces. Highlights include a tour through the base facilities and XCOM's Chief Engineer and Scientist, as well as a display of the soldier customization and the strategic layer.
 

====OpenTFTD Beta Released====
[[File:OpenTFTD1.png|240px|thumb|OpenTFTD]]
'''August 4th, 2015'''
:* The developers of [[OpenXcom]] have released the first Nightly (a.k.a. beta version) of [http://openxcom.org/ OpenTFTD], an open source reimplementation of [[TFTD|XCOM: Terror From The Deep]]. OpenTFTD comes included with the engine of regular OpenXcom and requires a copy of the original TFTD game to play.
 
====XCOM 2 Gameplay Video Released====
'''June 16th, 2015'''
:* Firaxis has released the first [https://www.youtube.com/watch?v=AzAKyj-KK-E&t=2m22s video] of XCOM 2 gameplay during the E3 2015 conference. The footage features a tactical mission where XCOM troops have to blow up an Advent target and it shows several enemies, including the Advent units of Soldier, Captain, Turret and MEC, as well as the Viper and the evolved Muton Berserker. The video also shows the new concealment/ambush mechanic, as well as a Gremlin hacking a turret and the Skyranger retrieval. It is also possible to see Officer [[Bradford (EU2012)|Bradford]] ordering XCOM troops into action and a glimpse of the world under the alien occupation.

====XCOM2 confirmed!====
'''June 1st, 2015'''
:* 2K and Firaxis have confirmed today on the XCOM official website [[http://xcom.com/]] the upcoming sequel to XCOM: Enemy Unknown. [[XCOM2]] takes place 20 years after the events of the remake, where the aliens have taken over Earth and the remains of XCOM are waging a guerrilla war against the extraterrestrials. The game will feature new soldier classes, the return of the [[Snakemen]] along with other new aliens, procedure generated (random) maps, and will be exclusive to the PC with specific features for mod development. More features will be revealed soon on IGN [http://ca.ign.com/articles/2015/06/01/xcom-2-announced-ign-first].
'''May 29th, 2015'''
:* Two clues at the Advent website have a series of letters that when combined produce "VIGILO CONFIDO", or the motto of Enemy Unknown 2012. It seems that a new XCOM game is under development and more details should be announced later.
'''May 27th, 2015'''
:* 2K has released yesterday a link to a site that presents an alternate reality company called [http://www.adventfuture.org/ Advent Administration]. Its contents have triggered speculation on the 2K official forums and Xcom subreddit that it is related to a new upcoming XCOM announcement. The site contains a rotating globe, pictures depicting a XCOM: Apocalypse style city, one of which seems to contain artwork already present on XCOM: Enemy Unknown, and a downloadable .pdf file uses a font called 'XCOM-Regular'. The site also appears to be under some sort of hacking by an unknown party, with its contents being replaced by phrases such as 'we are still watching'. While all of this is merely circumstantial evidence, 2K is expected to announce a major title on the next E3 Conference in 3 weeks so keep tuned for further details.
'''October 21st, 2014'''
:* Firaxis has released video footage of the two panels dedicated to XCOM: Enemy Unknown during the company's 2014 community convention, which took place last month. The panels were called ''Designing the Soldiers in XCOM'', which was presented by Game Designer Ananda Gupta, and ''The Artwork of XCOM'', by Art Director Greg Foertsch. The Firaxicon videos are available at Firaxis's Youtube [https://www.youtube.com/playlist?list=PL-lTq9LJCHpRP88U3dngU2P6GhJ8KqEjP channel].
'''October 16th, 2014'''
:* Steam announced that XCOM: Enemy Unknown can be played for free this weekend, starting today and until next Sunday. For more details check Steam's [http://store.steampowered.com/news/14681/ announcement].

'''August 5th, 2014'''
:* Fantasy Flight Games announced that they'll be publishing ''XCOM: The Board Game'' on the last quarter of 2014. The tabletop board game is based on [[Enemy Unknown (2012)|XCOM: Enemy Unknown]] and can be played from 1-4 players, which take the individual roles of XCOM Commander, Chief Scientist, Central Officer and Squad Leader, with the help of an app companion to determine the moves of the alien forces. For more details check the publisher's [http://www.fantasyflightgames.com/edge_news.asp?eidn=4972 page], and yes, the game comes included with plastic figures representing all soldier classes, as well as the Interceptors and UFOs. Cost is presented as $59.95 for this game and it will be available for preview at the publisher's booth on Gen Con Indy 2014.
'''June 13th, 2014'''
:* [[OpenXcom]] has just completed its release 1.0 version, available for free at [http://openxcom.org/ openxcom.org]. If you're looking to spice up the original [[X-COM|UFO: Enemy Unknown]] game, then check out this revamped open source clone version, developed by [[User:SupSuper|SupSuper]] and a bunch of X-COM enthusiasts. For more details about OpenXcom, see this [https://www.youtube.com/watch?v=GL2x-Sz9Oa8 presentation].
'''May 29th, 2014'''
:*Feral Interactive has [http://www.feralinteractive.com/en/news/424/ announced] that they will release XCOM: Enemy Unknown as their first game for Linux this summer, using the Ubuntu 14.04 version and through SteamPlay.
'''May 17th, 2014'''
:*[https://www.youtube.com/watch?v=qsHppXrgP0I YCOM: Enemy Unlikely] - Another remake of the XCOM series, YCOM: Enemy Unlikely is a demake of XCOM: Enemy Unknown, with a bit of hilarity added. The video contains a link on its description to download and play the game.
'''April 29th, 2014'''
:*[http://xcomrl.blogspot.pt/ X@COM] - playable alpha demo. X@COM, or XCOM Rogue-like, is a current fan project that aims to replicate the original UFO: Enemy Unknown using only ASCII characters. They're aiming to finish the project by 2015 and they have a current playable alpha version that can be downloaded for playing.
'''March 9th, 2014'''
:*[http://www.kotaku.com.au/2014/03/x-coms-design-document-had-just-12-pages/ Kokatu] magazine has published an article about the creation of the original [[X-COM|UFO: Enemy Unknown]] which includes a [http://www.gdcvault.com/play/1017808/Classic-Game-Postmortem-X-COM link] to last year's video presentation made by its creator, Julian Gollop, about the original game's design process.
'''March 4th, 2014'''
:*XCOM: Complete Edition released for PC and Mac. Includes all of the DLCs released so far, including the Elite Soldier Pack, Slingshot and Enemy Within.
'''February 7th, 2014'''
:*[[XCOM: Enemy Within DLC (EU2012)|XCOM: Enemy Within]] has won the Best Strategy/Simulation Game of the Year 2013 DICE awards. For a list of winners see [http://www.interactive.org/news/17th_annual_dice_awards_winners.asp].
'''February 4th, 2014'''
:*2K Games is preparing the release a complete edition of [[Enemy Unknown (2012)|XCOM: Enemy Unknown]] on March 4th, according to [http://www.gameinformer.com/b/news/archive/2014/02/03/xcom-and-civilization-v-complete-editions-coming-soon.aspx Gameinformer]. No further details have been released yet about the edition but it's likely that it should include all of the DLCs released so far, such as [[Elite Soldier Pack DLC (EU2012)|Elite Soldier Pack]], [[Slingshot DLC (EU2012)|Slingshot]] and the [[XCOM: Enemy Within DLC (EU2012)|Enemy Within]] expansion.

==== [[XCOM: Enemy Within DLC (EU2012)|XCOM: Enemy Within]] and [[Hangar 6: R&D DLC (Bureau)|Hangar 6: R&D]] have been released! ====
====XCOM: Enemy Within released====
'''November 15th 2013'''
:*And now it is the rest of the world's turn as Enemy Within receives its international release today. So get on and enjoy the all new features!
'''November 12th 2013'''
:*XCOM Enemy Within is released in America with new features like the new human faction – EXALT, Base Defence and all new maps and council Missions. Enjoy the game and see you on the farm with the crashed UFO.

==== XCOM: Enemy Within Reviews! ====
'''November 11th 2013'''
:*Several reviews of [[XCOM: Enemy Within DLC (EU2012)|XCOM: Enemy Within]] have been published today. To read/see them, check [http://www.escapistmagazine.com/articles/view/editorials/reviews/10729-XCOM-Enemy-Within-Review Escapist Magazine] ("''All of the fun new toys, however, do work a bit against the game's biggest flaw - after a certain point of advancement, the challenge and satisfaction of snuffing aliens dissipates quickly.''"), [http://www.shacknews.com/article/81977/xcom-enemy-within-video-review Shacknews] ("''Firaxis once again manages to balance XCOM's disparate elements, resulting in a challenging and satisfying experience.''"), [http://uk.ign.com/articles/2013/11/11/xcom-enemy-within-review IGN] ("''Enemy Within is an amazing expansion to a brilliant tactical game.''") and [http://www.strategyinformer.com/pc/xcomenemyunknowntheenemywithin/reviews.html Strategy Informer] ("''I could go on about the virtues of Enemy Within, about how good it was to play through the whole campaign again, but ultimately it’ll come down to two factors: The fact that the ending hasn’t changed a bit, and the fact that, ultimately, you’re still playing the same game.''", and [http://www.youtube.com/watch?v=4mb_RXgIStw Revision3] ("''EW gets a 4 out of 5.''").

====The Bureau Expansion====
'''November 8th 2013'''
:*[[The Bureau: XCOM Declassified|The Bureau: XCOM Declassified]] gained it first DLC Pack today in the form of [[Hangar 6: R&D DLC (Bureau)|Hangar 6: R&D]] in which the player takes control of DaSilva in an attempt to get to the bottom of a mysterious new infection.

==== XCOM Base Defense confirmed on EW====
'''October 23th, 2013'''
:*The newest preview videos released ([http://www.escapistmagazine.com/articles/view/editorials/reviews/previews/10679-XCOM-Enemy-Within-Preview-Whole-New-Game here] and [http://www.gamespot.com/videos/base-defense-returns-in-xcom-enemy-within/2300-6415682/ here]) have confirmed the addition of a Base Defense mission to [[XCOM: Enemy Within DLC (EU2012)|XCOM: Enemy Within]], a feature of the original game long called for by players. Check for more details on the Enemy Within page.

==== EXALT revealed!====
'''October 9th, 2013'''
:*A new faction has been revealed for [[XCOM: Enemy Within DLC (EU2012)|XCOM: Enemy Within]], the upcoming [[Enemy Unknown (2012)|XCOM: Enemy Unknown]] expansion. XCOM's new enemies are called EXALT and they're a secret paramilitary human group that is conspiring to use the alien technology and chaos of the invasion to achieve world domination. More details available at the [[XCOM: Enemy Within DLC (EU2012)|Enemy Within]] page.

==== XCOM: Enemy Within details announced!====
'''August 21st, 2013'''
:*Producer 2K revealed details about '''XCOM: Enemy Within''', the upcoming expansion to [[Enemy Unknown (2012)|XCOM: Enemy Unknown]]. The main features are the addition of the Meld, a substance that allows you to create a new class (Mech Troopers), with new weapons and abilities or to genetically enhance your soldiers (Gene Mods), along with other features. The release date is November 12th (US) and 15th (rest of the world) and check the full details on the [[XCOM: Enemy Within DLC (EU2012)|XCOM: Enemy Within]] page.

==== XCOM: Enemy Within will be revealed on August 21st====
'''August 3rd, 2013'''
:*Producer 2K has confirmed that it will reveal during Gamescom 2013 a new DLC for XCOM: Enemy Unknown called [[XCOM: Enemy Within DLC (EU2012)|XCOM: Enemy Within]].

</onlyinclude>

== Archived News ==

==== The Bureau: XCOM Declassified will be released next month====
'''July 18th, 2013'''
:*The upcoming XCOM squad based shooter will be available for sale on stores on August 20th in the US and on the 23rd to the rest of the world. From the available previews/footage it seems the game has been redesigned as a prequel to ''XCOM: Enemy Unknown'', featuring Sectoids, Mutons and even Silacoids.

==== The Bureau: XCOM Declassified coming soon====
'''May 5th, 2013'''
:*Marin's 2K XCOM squad based shooter should be released soon as '''The Bureau: XCOM Declassified'''. The game was announced three years ago and has been redesigned.

==== Clash of the Titans: X-COM meets XCOM ====
'''April 2nd, 2013'''
:*Julian Gollop and Jake Solomon have met for the first time during Game Developers Conference 2013 to be interviewed regarding the original game and the 2012 remake. Check the video of the encounter here: [http://www.youtube.com/watch?v=z8zZsecTRfM].

==== GDC 2013: Julian Gollop's Postmortem on UFO: Enemy Unknown/XCOM: UFO Defense ====

'''March 28th, 2013'''

:*Julian Gollop gave a talk at Games Developers Conference 2013 on the development of the original UFO: Enemy Unknown/XCOM: UFO Defense. An interesting look into the philosophies and source material that went into the making of the game, and also how it nearly failed.

:: See the video at: http://www.gamespot.com/events/gdc-2013/video.html?sid=6406150
'''March 1st, 2013'''
:*'''Elite Edition for the Mac announced.''' Firaxis have announced that Feral Games are porting XCOM: Enemy Unknown to the OS X and will be released in an Elite Edition. This edition will include the [[Elite Soldier Pack DLC (EU2012)|Elite Soldier Pack]], [[Slingshot DLC (EU2012)|Slingshot]] and [[Second Wave (EU2012)|Second Wave]] DLCs and should be released this spring.

'''January 8th, 2013'''
:*'''[[Second Wave (EU2012)|Second Wave]] options now available on XCOM: Enemy Unknown.''' The latest patch released today by Firaxis now activates the Second Wave options and makes it available for the game. Despite it being already included but inactive (and playable through mods) the developers had stated that they didn't had time to complete Second Wave before XCOM: Enemy Unknown but it was on their intentions to finish it. It now includes the following [[Info_(EU2012)#Advanced Options|options]] as part of Advanced Gameplay: ''Damage Roulette, New Economy, Not Created Equally, Hidden Potential, Red Fog, Absolutely Critical, The Greater Good, Marathon, Results Driven, High Stakes, Diminishing Returns, More Than Human, Total Loss, War Wariness, E-115'' and ''Alternate Sources''. The [[Patches_(EU2012)#2013-01-08|patch]] also introduces fixes to the teleport bug and adds a new XCOM Hero.

'''December 4, 2012'''
:* 2K Games has released the first of two DLC packs for all platforms, named ''Slingshot''. The pack features several additional new helmets, 1 new armor decoration and 3 linked Council missions and a special playable soldier named ''Zhang''.

'''October 23, 2012'''
:* 2K Games has [http://www.2kgames.com/blog/add-on-content-packs-for-xcom-enemy-unknown-coming-soon announced] the first of two DLC packs for all platforms. The first, named ''Slingshot'', will feature 3 new linked Council missions that will focus on a playable character named ''Zhang''.

'''October 9, 2012'''
:* Eighteen years after the original release of ''UFO: Enemy Unknown'' (or ''XCOM: UFO Defense''), 2K Games has released today in North America ''XCOM: Enemy Unknown'', its remake of the original game, which will be followed by the international release next Friday. XCOM is back!

''' September 24, 2012 '''
:* Demo is released on '''[http://store.steampowered.com/app/200510/ Steam]'''. It features a tutorial mission, a standard mission and a limited interaction with the Base and Geoscape layer.

''' August 10, 2012 '''
:* Multiplayer deathmatch revealed for XCOM: Enemy Unknown (2012), mix your own squad of soldiers & aliens and battle online vs other players.

''' January 5, 2012 '''
:*Publisher 2K Games announces that Firaxis (makers of Civilization) is developing a re-imagining of the original XCOM: Enemy Unknown for release this fall (2012).

----

==== New XCOM FPS Game by 2k Marin ====
:* XCOM FPS has been delayed multiple times, release is late 2013 or 2014 at the earliest.
:* The game will focus on elite U.S. government operatives attempting to prevent a nightmarish invasion of the United States (while dropping the dash in X-COM). See:
:* The [http://www.xcom.com official XCOM] site (only a couple of trailers here)
:* Some criticism of its change in focus ([http://www.destructoid.com/2k-marin-s-22-minute-demonstration-of-xcom-209954.phtml 1], [http://www.destructoid.com/2k-xcom-changed-because-strategy-games-aren-t-modern-205991.phtml 2]), although 2k Marin may be rethinking this
:* [http://forums.2kgames.com/forums/forumdisplay.php?76-XCOM-General-Discussion 2k's XCOM forum], including passionate posts by X-Commies
:* Once slated for March 2012 release, it has now slipped to a later date ([http://www.videogamer.com/xbox360/xcom_2k_marin/news/xcom_release_date_slips_avoids_mass_effect_3.html 1], [http://www.gamespot.com/news/6344515.html?tag=nl.e579 2]).

----
==== X-COM Packages ====
Now available for less than $15
:*At [http://www.gamersgate.com/index.php?page=product&what=view&sku=DDB-XCOM&via=newly_added&aff=sc GamersGate], [http://store.steampowered.com/sub/964/ Steam] and [http://www.direct2drive.com/2/7614/product/Buy-X-Com-Complete-Bundle-Download Direct2Drive]. (Includes '''UFO''', '''TFTD''', '''Apoc''', '''Int''', and '''Enf''').

For "reviews", see [[GEOSCAPE.EXE#X-COM_Complete_Packages|this]].

'''OFFICIAL''' - [http://kotaku.com/5516654/x+com-is-back NEW X-COM GAME FROM THE DEVELOPERS OF BIOSHOCK 2] 
Yes, this will come as a shock to all, but 2K Australia and 2K Marin is busily working on a first-person shooter based on the X-COM franchise. More info will presumably become available on the 2010 E3.

For more information/rumors check 2K's [http://forums.2kgames.com/forums/forumdisplay.php?f=76 X-COM forum].
</div>

Compiling (OpenXcom)

2015-07-03T14:24:14Z

Winterheart:

The OpenXcom codebase is hosted on [https://github.com/SupSuper/OpenXcom Github], and you can grab the latest source with any Git client from: <code>https://github.com/SupSuper/OpenXcom.git</code>

If you're a Github user you might wanna [http://help.github.com/forking use a fork] instead so you can have your own remote repository (you can't push to the official OpenXcom repository without permission) and easily send in pull requests.

OpenXcom is a cross-platform game so it's possible to compile it on a variety of systems and project files for all the popular IDEs are included. There's also a [http://openxcom.org/docs/html/ Doxygen documentation] available.

'''Don't forget to copy the X-Com resources to your ''bin'' folder as shown in [[Installing (OpenXcom)|Installing]].'''

== Dependencies ==

OpenXcom requires the following libraries to compile:

* [http://www.libsdl.org/ SDL] (libsdl1.2)
* [http://www.libsdl.org/projects/SDL_mixer/ SDL_mixer] (libsdl-mixer1.2)
* [http://www.libsdl.org/projects/SDL_image/ SDL_image] (libsdl-image1.2)
* [http://cms.ferzkopp.net/index.php/software/13-sdl-gfx SDL_gfx] (libsdl-gfx1.2), version 2.0.22 or later
* [http://code.google.com/p/yaml-cpp/ yaml-cpp], (libyaml-cpp), version 0.5.1 (0.5.2 *does not work*)


== All operating systems ==

* [[Compiling with CMake (OpenXcom)|Compiling with CMake]]

== Windows ==

* [[Compiling with Microsoft Visual C++ (OpenXcom)|Compiling with Microsoft Visual C++]]
* [[Compiling with MinGW (OpenXcom)|Compiling with MinGW]]

== Mac OS X ==

* [[Compiling with Xcode (OpenXcom)|Compiling with Xcode]]
* [[Compiling with brew (OpenXcom)|Compiling with brew]]

== Linux/BSD ==

* [[Compiling with Make (OpenXcom)|Compiling with Make]]
* [[Compiling with CMake (OpenXcom)|Compiling with CMake]]
* [[Compiling with Autotools (OpenXcom)|Compiling with Autotools]]

== Misc. ==

* [[Android port (OpenXcom)|Compiling for Android]]

[[Category:OpenXcom]]

Scenarios (UFO2000)

2015-06-15T06:50:55Z

Winterheart:

The following are available scenario types for [[UFO2000|UFO2000 ]]:

*[[Deathmatch (UFO2000)|Deathmatch]]

*[[Escape (UFO2000)|Escape]]

*[[Control (UFO2000)|Control]]

*[[Assassination (UFO2000)|Assassination]]

*[[Hold (UFO2000)|Hold]]

*[[Breakthrough (UFO2000)|Breakthrough]]

*[[Capture (UFO2000)|Capture]]

*[[Search and Destroy (UFO2000)|Search and Destroy]]

[[Category:UFO2000]]
[[Category:Game and Squad Settings (UFO2000)]]

UFO2000

2015-06-15T06:50:37Z

Winterheart:

__NOTOC__

[[Image:Ufo2000logo.gif|center]]

'''Welcome to the UFO2000 Wiki, a part of UFOpaedia.org. UFO2000 is a free and opensource turn based tactical squad simulation game with multiplayer support. The game has its own engine written from scratch. With the data files from the X-COM: UFO Defense game the game gets even better with additional maps, more units and sounds. But it is stand alone!'''

The UFO2000 Wiki is meant to be a guide to the game, providing new players with a quick explanation of the game while introducing more complex tactics to advanced players. It will also contain information regarding how to costumize the game to add your own units, terrains and weapons, plus provide more technical details on the different aspects of the game.

This Wiki is a work in progress - all contributions to it are welcome as long as they are related with [http://ufo2000.sourceforge.net UFO2000]. Feel free to add new pages, edit the current ones and to use the [[Talk:UFO2000|discussion tab]] to ask any question.

For more information regarding UFO2000 please visit our [http://ufo2000.sourceforge.net site]. Happy gaming!

<table style="width: 100%;>
<tr style="vertical-align: top;">
<td colspan = "4">
{| {{stdTable}} title = "UFO2000 Main Directory" width = "100%"
|- {{stdTable Heading}}
| colspan = "4"| {{UFO2000 Icon}} '''UFO2000'''
|-
|}
</td>
</tr>
<tr style="vertical-align: top;">
<td style="width: 25%; border:1px gray solid;">
{| {{stdTable}} width="100%" style="border:none;"
|- {{stdTable Sub Heading}}
| '''Overview'''
|-
| [[Info (UFO2000)|About UFO2000]]
|-
| [[Authors (UFO2000)|Authors and Credits]]
|-
| [[Community (UFO2000)|Community]]
|-
|- {{stdTable Sub Heading}}
| '''Quick Start Guide'''
|-
| [[Quick guide to UFO2000 online playing]]
|-
| [[Interface (UFO2000)|The Main Interface]]
: [[Main Menu (UFO2000)|Main Menu]]
: [[Server (UFO2000)|Game Server]]
: [[Misson Planner (UFO2000)|Mission Planner]]
: [[Unit Editor (UFO2000)|Unit Editor]]
|-
| [[Tactical (UFO2000)|The Tactical Interface]]
: [[Tactical Window (UFO2000)|Tactical Window]]
: [[Keyboard Controls (UFO2000)|Keyboard Controls]]
: [[Control Panel (UFO2000)|Control Panel]]
|-
| [[Differences to X-COM (UFO2000)|Differences between UFO2000 and X-COM]]
|-
|}
</td>

<td style="width: 25%; border:1px gray solid;">
{| {{stdTable}} width="100%" style="border:none;"
|- {{stdTable Sub Heading}}
| '''Game and Squad Settings'''
|-
| [[Scenarios (UFO2000)|Scenarios]]
: [[Deathmatch (UFO2000)|Deathmatch]]
: [[Escape (UFO2000)|Escape]]
: [[Control (UFO2000)|Control]]
: [[Assassination (UFO2000)|Assassination]]
: [[Hold( UFO2000)|Hold]]
: [[Breakthrough (UFO2000)|Breakthrough]]
: [[Capture (UFO2000)|Capture]]
: [[Search and Destroy (UFO2000)|Search and Destroy]]
|-
| [[Game rule setups (UFO2000)|Game rule setups]]
: [[Regular 7K (UFO2000)|Regular 7K]]
: [[Shootout (UFO2000)|Shootout]]
: [[Other game types (UFO2000)|Other game types]]
|-
| [[Units (UFO2000)|Units]]
: [[Unit Types (UFO2000)|Unit Types]]
: [[Unit Stats (UFO2000)|Unit Stats]]
: [[New Units (UFO2000)|New Units]]
|-
| [[Weapon Sets (UFO2000)|Weapon Sets]]
: [[Weapon Types (UFO2000)|Weapon Types]]
: [[UFO2000 Weaponset (UFO2000)|UFO2000]]
: [[Galactic Weaponset (UFO2000)|Galactic]]
: [[Modified Weaponset (UFO2000)|Modified X-COM]]
: [[Original Weaponsets (UFO2000)|Original UFO&TFTD]]
|-
|}
</td>

<td style="width: 25%; border:1px gray solid;">
{| {{stdTable}} width="100%" style="border:none;"
|- {{stdTable Sub Heading}}
| '''Strategy Manual'''
|-
| [[Squads (UFO2000)|Designing&Deploying Squads]]
: [[Specialized Units (UFO2000)|Specialized Units]]
: [[Fireteams (UFO2000)|Fireteams]]
: [[Team Roles (UFO2000)|Team Roles]]
: [[Squad Action (UFO2000)|Squad Action]]
|-
| [[Squad Leadership (UFO2000)|Squad Leadership]]
|-
| [[Terrain and Combat (UFO2000)|Terrain and Combat]]
|-
| [[Operations (UFO2000)|Tactical Operations]]
: [[Scouting (UFO2000)|Scouting and Hiding]]
: [[Maneuvering (UFO2000)|Maneuvering]]
: [[Firing (UFO2000)|Firing]]
: [[Firing and Maneuvering (UFO2000)|Firing and Maneuvering]]
: [[Formations (UFO2000)|Squad Formations]]
|-
| [[Offensive Operations (UFO2000)|Offensive Operations]]
: [[Offensive Notes (UFO2000)|General Notes]]
: [[Offensive Requirements (UFO2000)|Offensive Requirements]]
: [[Offensive Strategies (UFO2000)|Offensive Strategies]]
|-
| [[Defensive Operations (UFO2000)|Defensive Operations]]
: [[Defensive Notes (UFO2000)|General Notes]]
: [[Defensive Dilemmas (UFO2000)|Defensive Dilemmas]]
: [[Defensive Tactics (UFO2000)|Defensive Tactics]]
|-
| [[Annexes (UFO2000)|Annexes]]
: [[Reaction Tactics (UFO2000)|Reaction Tactics]]
: [[Airborne Tactics (UFO2000)|Airborne Tactics]]
: [[Military Intelligence (UFO2000)|Military Intelligence]]
: [[Comm Center (UFO2000)|Comm Center]]
|-
|}
</td>

<td style="width: 25%; border:1px gray solid;">
{| {{stdTable}} width="100%" style="border:none;"
|- {{stdTable Sub Heading}}
| '''Technical Information'''
|-
| [[Customizing (UFO2000)|Customizing]]
: [[Custom Weapons (UFO2000)|Weapons]]
: [[Custom Maps (UFO2000)|Maps]]
: [[Custom Units (UFO2000)|Units]]
|-
| [[Game Engine (UFO2000)|Game Engine]]
: [[Accuracy Formula (UFO2000)|Accuracy Formula]]
: [[Reactions Formula (UFO2000)|Reactions Formula]]
: [[Morale Formula (UFO2000)|Morale Formula]]
: [[Stats System (UFO2000)|Statistics System]]
: [[Damage (UFO2000)|Damage]]
: [[Explosions (UFO2000)|Explosions]]
: [[Unit Stats in Details (UFO2000)|Unit Stats in Details]]
: [[Line of sight (UFO2000)|Line of sight]]
|-
| Compiling UFO2000
: [[Compiling for Mac OS X (UFO2000)|Compiling for Mac OS X]]
: [[Compiling for Linux (UFO2000)|Compiling for Linux]]
|-
| Running your own UFO2000 server
: [[Compiling for Linux (UFO2000)#Compiling_the_server|Compiling server for Linux]]
: [[Setting up an UFO2000 server]]
|-
| Helping with development
: [[Known issues (UFO2000)|Known issues]]
: [[Contributing Code (UFO2000)|Contributing Code]]
|-
| '''Resources'''
|
|-
| [[Links (UFO2000)|Links]]
|}
</td>
</tr>
</table>
[[Category:UFO2000]]

Hold( UFO2000)

2015-06-15T06:49:14Z

Winterheart: Winterheart moved page Hold( UFO2000) to Hold (UFO2000)

#REDIRECT [[Hold (UFO2000)]]

Hold (UFO2000)

2015-06-15T06:49:14Z

Winterheart: Winterheart moved page Hold( UFO2000) to Hold (UFO2000)

== Overview of Hold Scenario==

===Objective===

'''Player 1:''' You must save at least half of your squad (rounded down) until the end of the match (number of turns is set in the "Options" section.

'''Player 2:''' You must kill more than half of the enemy squad (rounded down) before the end of the match (number of turns is set in the "Options" section.

Options:

===Deployment Types===

*'''Surrounded'''

===Description===

...

===Options===

* Half-turns to hold (match length) <1~20>

===Tips===

...

[[Category:UFO2000]]
[[Category:UFO2000 Quick Start Guide]]
[[Category:Scenarios (UFO2000)]]

Known issues (UFO2000)

2015-06-15T06:48:06Z

Winterheart: /* Replay incompatibility */

UFO2000 is an open source game. As such, it relies completely on the work, people put in. For the most part, it works rather fine. However, there are still some issues to be resolved, aside from new features. If you want to help getting rid of some of the problems below, please also read [[Contributing Code (UFO2000)]].
=== Grenade drop inside rooms ===
Players from original [[X-COM]], [[TFTD]] or [[OpenXcom]] are used to throw grenades without necessarily thinking, before trying. If the throwing can't be done like this, the game simply refuses to do so, telling you with some sort of message. UFO2000 does ''not always''! It tries to do so, but when the grenade hits an obstacle, it only falls down. That's especially a problem, when standing inside a house or some other sort of room. Then the grenade just falls before your own feet. A warning or refusal of some kind still needs a little coding.

=== No music ===
UFO2000 used to play music files. At some point, the DUMB-Librarie changed it's API, so there's some work to be done, to give UFO2000 its music capabilities back.

=== Sluggish Mouse ===
The mouse is controlled by Allegro, which seems to be having problems, when the mouse-changes are to fast. This also happens, when playing on high screen resolutions, e. g. full HD.

=== Networkproblems ===
UFO2000 has still some issues with network communication. If you have a look at the [http://ufo2000.net/results.php|official Stats-Page], you will see, that ca. 75-80% of the games were completely successful, however that leaves around 20-25% games being interrupted by some sort of problem, causing games out of sync.

=== No path-searching through doors ===
In original [[X-COM]] and [[OpenXcom]], if you click inside a room, to get the soldier moving inside that room, the path search algorithm finds the shortest way inside the room. If that means going through a door, it will plot a path right through it. UFO2000 does not do so. If there is no way except through a door, it simply won't find a way (mostly the better case). If there is another way inside, without any doors used, it will take this way (usually the worse case, as this usually is the longer way).

=== No UFO-doors ===
Usually, doors have some sort of graphics. UFO-doors in UFO2000 don't show any door. Instead, it's just a plain hole in the wall, where the door is supposed to be. But you still can't look through that not existing door, as it behaves like an optical barrier. However the above mentioned path search ''does'' work properly.
=== Forgotten unit position ===
In original [[X-COM]] as well as in [[TFTD]] and [[OpenXcom]], once you discovered an enemy unit, it's position is remembered until the end of the round. In UFO2000, it is not. The moment the spotting unit looses LOS to that unit, it is removed from battlescape-view. This can produce strange situations, e. g. you turn a unit 90°. During that, you spot it for a very short moment (at 45°), just to loose sight immediately, when moving the second 45°. Also explosive weapons can have this effect. You fire with a gauge at a unit. The unit is hit, smoke is generated, so you lose sight of the unit. If you haven't remembered that units position properly, you won't be able to place an accurate shot, any more. One might consider this as an additional tactics aspect, when playing against humans. However, as UFO2000's game mechanics are quite clearly derived from the above mentioned games, it feels rather normal, when units don't vanish from the battelscape-view, before ending a turn.
=== Replay incompatibility ===
Currently, it seems, saved replays of UFO2000 can't be read by the same version on a different plattform. E. g. if you saved a replay with current 0.9.1176-version on Windows, you won't be able to watch it with 0.9.1176 under Linux, and vice versa. It is to be suspected, to behave the same way with MacOS.

[[Category:UFO2000]]

Tactical Window (UFO2000)

2015-06-15T06:47:36Z

Winterheart: /* Throwing */

= Control panel =
===Battlescape Screen===
The game will take place here. The player can view the areas of the playing board visible to their pieces and can choose actions for them via the Battlescape Control Bar. The main features of the Battlescape Screen are labeled. Refer to them below for an explanation.

==== UFO2000 interface ====

[[Image:ufo2kbsc.png]]

# Item carried in the left hand. Left click this area to use.
# Move up or down. Only usable if equipped with armor that can fly, or if located on an elevator tile.
# View different floors.
# View the map screen.
# Switch between kneeling and standing stance. Kneeling costs 4 TUs, standing up costs 8 TUs. Will affect the unit's height and [[Firing Accuracy]]. Unit will stand automatically upon being given a move command in exchange for 8 TUs.
# Show inventory screen.
# Center the Battlescape Screen onto the current unit.
# Select the next unit. When reaching the end of the units list, will cycle back to the beginning.
# Select the next unit and forget the current one. (Meaning: repeated use of 8. or 9. will no longer select it. You can still select it manually, though.) Use this, when you won't be moving the current unit any more in this turn.
# Hide or reveal the roof or ceiling. Useful for viewing inside enclosed areas.
# Open the Options menu. Use this to modify the firing, scrolling, movement speed and other settings.
# End player turn button. The opponents phase will then commence.
# Dust off button, give up or offer draw.
# Item carried in the right hand. Left click this area to use.
# Reserve TU buttons. Will stop the current unit from taking any action once a certain amount of TUs has been used. This is to ensure you have enough TUs to perform the selected action. Any other action will be cancelled except for the action that was reserved. Top left is to reserve none, Top right is to reserve enough TUs for a snap shot. Bottom left is to reserve for an aimed shot, with the bottom right similarly for auto-shot.
# Click here to view detailed vital statistics, including current armour values. Also the current round number is displayed here.
# Information panel detailing the name, and the current status. The green bar, and the number corresponds to the current TUs available, with the orange bar and number for the current energy. Likewise with the red bar and number for the current health and the purple bar and number representing the morale level.
# Currently selected unit.
# Mouse cursor and selection box. Select a tile and left click to move. Move to the edge of the screen to scroll along the board. Right click to have the currently selected unit face that direction or open a door, when standing in front of it.
# Opponent unit sighted buttons. Left-click to center the screen on the indexed alien. These buttons are assigned in "increasing order" in terms of the appropriate file. In particular, the numerically highest alien sighted will also be the highest rank sighted.
# Opponents number. It identifies a unit together with the sighted-button.
# units marker for selected unit. Lower Arrow-part will turn blue, if unit is kneeling. A »+« indicates items laying beneath the units field.

==== X-COM interface ====

[[Image:ufo2kxcbsc.png]]

# Item carried in the left hand. Left click this area to use.
# Move up or down. Only usable if equipped with armor that can fly, or if located on an elevator tile.
# View different floors.
# View the map screen.
# Switch between kneeling and standing stance. Kneeling costs 4 TUs, standing up costs 8 TUs. Will affect the unit's height and [[Firing Accuracy]]. Unit will stand automatically upon being given a move command in exchange for 8 TUs.
# Show inventory screen.
# Center the Battlescape Screen onto the current unit.
# Select the next unit. When reaching the end of the units list, will cycle back to the beginning.
# Select the next unit and forget the current one. (Meaning: repeated use of 8. or 9. will no longer select it. You can still select it manually, though.) Use this, when you won't be moving the current unit any more in this turn.
# Hide or reveal the roof or ceiling. Useful for viewing inside enclosed areas.
# Open the Options menu. Use this to modify the firing, scrolling, movement speed and other settings.
# End player turn button. The opponents phase will then commence.
# Dust off button, give up or offer draw.
# Item carried in the right hand. Left click this area to use.
# Reserve TU buttons. Will stop the current unit from taking any action once a certain amount of TUs has been used. This is to ensure you have enough TUs to perform the selected action. Any other action will be cancelled except for the action that was reserved. Top left is to reserve none, Top right is to reserve enough TUs for a snap shot. Bottom left is to reserve for an aimed shot, with the bottom right similarly for auto-shot.
# Click here to view detailed vital statistics, including current armour values. Also the current round number is displayed here.
# Information panel detailing the name, and the current status. The green bar, and the number corresponds to the current TUs available, with the orange bar and number for the current energy. Likewise with the red bar and number for the current health and the purple bar and number representing the morale level.
# Currently selected unit.
# Mouse cursor and selection box. Select a tile and left click to move. Move to the edge of the screen to scroll along the board. Right click to have the currently selected unit face that direction or open a door, when standing in front of it.
# Opponent unit sighted buttons. Left-click to center the screen on the indexed alien. These buttons are assigned in "increasing order" in terms of the appropriate file. In particular, the numerically highest alien sighted will also be the highest rank sighted.
# Opponents number. It identifies a unit together with the sighted-button.
# units marker for selected unit. Lower Arrow-part will turn blue, if unit is kneeling. A »+« indicates items laying beneath the units field.

==== Map overview ====
[[file:mapoverview.png]]

You can switch on the map-overview on the right hand side, by SHIFT+LEFT, resp., turn it off with SHIFT+RIGHT. It shows you armour- and health-values of every unit beneath the map, as well as the number of remaining units of both parties. The map itself shows the entire map, including the not discovered parts in black, the discovered parts in greyed, and also the view-area of every unit. Your own units are represented by a yellow dot, opponents' are red. This is very useful so see, if you have any blind spots.

==== Chat console ====
On the lower end of the screen you will find a grey field, where you can type in messages for your opponent. You can change the size of the area, where sent and received messages are displayed, by SHIFT+UP and SHIFT+DOWN. It also contains status-messages, like, when a unit is killed, or one side has ended its turn.

= Symbols =
== (Blue) arrow over soldier ==
[[File:plus.png|Arrows indicate the soldier being the active one.]]

The soldier with these arrows on top, is the currently active soldier. It will carry out orders you give it. If the lower part of the arrows is blueish, then the unit is currently kneeling.

== Plus over soldier ==
[[File:plus.png|The plus indicates something laying on the ground, beneath the soldier.]]

A »+« over the selected unit indicates, that the soldier is standing on a field with items laying around. You could pick them up via inventory menu.
= Additional information =
== Movement ==
If you hold down the CTRL-key, UFO2000 will show you, which way a soldier will take, to reach the field, you are currently pointing at.

[[file:move.png]]

It also shows you, how many time units this will cost. If the way would require an additional round, to get there, the numbering simply starts over again, after reaching < 3 TUs. Useful to avoid certain surprises, when the terrain isn't that simple (e. g. doors or other obstacles on the way).
== Aiming ==
If you point at a certain position for aiming, you can hold down the ALT-key, to show the line of fire.

[[file:aim.png]]

It's yellow for the obstacle free part of the LOF. Behind an obstacle, it turns more red-orange. If you want to further specify, where a soldier shall aim at the target, you can hold down SHIFT-key when giving the fire-command. You then will get a selection of modes, where to aim precisely.
== Throwing ==
If you want to be sure, what trajectory a grenade or other item will take, when thrown, hold down the ALT-key during pointing where to throw.

[[file:throw.png|500 px]]

The target doesn't necessarily need to be on the ground! That way you can get the unit to throw over certain obstacles. The color of the obstacle free part of the trajectory is blue. If there's an obstacle in the way, it will show a red part behind that obstacle. If you point outside the range of throwing of that unit (18 tiles), the part, which is to much, will turn in darker blue.

[[Category:UFO2000]]

Terror Units (TFTD)

2015-06-04T11:10:25Z

Winterheart: /* Terror Unit Types */

Just as in the [[Terror Units|First Alien War]], the various alien races will occasionally attack civilian targets. This time, the aliens target cruise ships, cargo ships, ports, and tropical resorts. Each race will be accompanied by specific terror units, which can change depending on whether the mission is above or underwater. Later in the game, [[Mixed Crew]] terror missions will appear in which a Tasoth or Lobster Man crew is accompanied by other races' terror units, plus a small number of Aquatoids. This can be an opportunity to obtain live specimens for research.

Terror units can also be found guarding Alien Colonies and Artefact Sites, but these will invariably be Hallucinoids and Tentaculats accompanying either Tasoths and Aquatoids or Lobstermen.

== Terror Unit Types ==

{|class="wikitable"
! TFTD Species
! Terror Unit
|-
| [[Aquatoid]] || [[Hallucinoid]] underwater and [[Calcinite]] on land
|-
| [[Gillman]] || [[Xarquid]] underwater and [[Deep One]] on land
|-
| [[Lobsterman|Lobster Man]] || [[Tentaculat]] underwater and [[Bio-Drone]] on land
|-
| [[Tasoth]] || [[Tentaculat]] underwater and [[Bio-Drone]]/[[Triscene]] mixture on land
|-
| [[Alien Colony Assault|Alien Colony]] || [[Hallucinoid]] (upper level only) and [[Tentaculat]]
|-
| [[Artefact Site]] || [[Hallucinoid]] and [[Tentaculat]]
|-
| [[T'leth]] || [[Hallucinoid]], [[Deep One]], [[Xarquid]], [[Tentaculat]]
|-
| [[Mixed Crew]] || almost anything goes - see article for details
|}

==See Also==
[[Terrorist (Alien Rank)]]
{{Aliens (TFTD)}}

[[Category:TFTD]]

Info (XCOM2)

2015-06-02T04:37:14Z

Winterheart:

This page is to start collect all the information related to Firaxis' upcoming XCOM 2 game, released through official channels and confirmed sources.

==Storyline==
According to the [http://xcom.com/#overview Overview] available at the official XCOM 2 website:
* The new game takes place 20 years after Earth's surrender to the aliens during the invasion.
* The alien overlords have built megacities where war, poverty, crime and disease are supposedly eradicated, but which only serve as a cover for more sinister plans for humankind.
* XCOM was beaten and defeated but they have waging a guerrilla style war against the aliens.
* XCOM HQ is now a captured Alien Supply Ship that has been converted as a mobile command center.
* New alien races, including [[Snakeman (XCOM2)|Snakemen]] and Sectoid hybrids.

==Engine==
* Procedural generated maps.
* Wide mod support: you can create maps, new races, storylines and campaigns and share them via Steam Workshop.

==Soldiers==
* 5 classes - no mention of how many new ones.
* Soldiers appear to have 'Character Skills' (check Tactical picture)
* Soldiers can use melee weapons.

==Media==
<gallery mode="packed" widths=150px heights=100px caption="XCOM 2 Official Site">
File:01_x2_screens_media_thm.png|Tactical
File:01_x2_screens_news_thm.png| Sectoid hybrid
File:02_x2_screens_overview_thm.png| New mobile XCOM base
File:02_x2_screens_media_thm.png| Sectoid hybrid
File:03_x2_screens_overview_thm.png|
File:04_x2_screens_media_thm.png|
File:04_x2_screens_overview_thm.png|
File:05_x2_screens_media_thm.png|
File:05_x2_screens_overview_thm.png|
File:06_x2_screens_overview_thm.png|
File:07_x2_screens_overview_thm.png|
File:08_x2_screens_overview_thm.png|
File:09_x2_screens_overview_thm.png|
</gallery>

Font collection (OpenXcom)

2015-05-25T12:18:31Z

Winterheart: /* Customizing */

'''Font collection''' is bitmap fonts used by game engine to represent text.

Original UFO/TFTD engine uses two font types: big ([[BIGLETS.DAT]], 16x16 pixels per character) and small ([[SMALLSET.DAT]], 8x9 pixels per character) for Battlescape and Geoscape. But OpenXcom uses four font types: FontBig, FontGeoBig, FontSmall, FontGeoSmall. All of them described in *.dat file (which is actually YAML-file). Default font collection is placed in Language folder and named simply '''Font.dat'''.

{|style="background:darkgray; border:1px solid dimgray;color:white" border="0" height="230" align="center" valign="bottom" cellpadding=10px cellspacing=0px
|+style="background:white; color:black"|'''Font.dat''' fonts (gray background used for transparent files)
|-align="center"

| [[File:FontBig.png|border|none]]
| [[File:FontGeoBig.png|border|none]]
| [[File:FontSmall.png|border|none]]
| [[File:FontGeoSmall.png|border|none]]
|-align="center" valign="top"
|'''FontBig.png'''
|'''FontGeoBig.png'''
|'''FontSmall.png'''
|'''FontGeoSmall.png'''
|}

''*.dat'' is divided in two sections: ''chars'' and ''fonts''. ''chars'' is string which contain all available characters, provided by this font collection. ''font'' section is bit more complicated:

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''id'''
| Type of charmap
| Should be '''FONT_BIG''', '''FONT_SMALL''', '''FONT_GEO_BIG''', or '''FONT_GEO_SMALL'''
|-
| '''image'''
| Relative path to PNG-file with contains actual glyphes
|
|-
| '''width'''
| Width of a character
|
|-
| '''height'''
| Height of a character
|
|-
| '''spacing'''
| Spacing between two characters.
|
|}

Each character in PNG-file have own rectangle with ''width'' and ''height''. Characters shouldn't overlapping each other. Characters in *.png-file placed by groups with 16 characters in each group and ordered accordingly ''chars'' string. So if you want find actual character in *.png file, here formula:

<code>
y = (''<number in chars>'' div 16) * ''height''

x = (''<number in chars>'' mod 16) * ''width''
</code>

Here example for default ''Font.dat'':

<pre>
chars: >
!"#$%&'()*+,-./0123456789:;<=>?@ABCDEFGHIJKLMNOPQRSTUVWXYZ[\]^_`abcdefghijklmnopqrstuvwxyz{|}~¡¢£¤¥¦§¨©ª«¬®¯°±²³´µ¶·¸¹º»¼½¾¿ÀÁÂÃÄÅÆÇÈÉÊËÌÍÎÏÐÑÒÓÔÕÖŐŰÙÚÛÜÝÞŸßàáâãäåæçèéêëìíîïðñòóôõöőűùúûüýþÿФИСВУАПРШОЛДЬТЩЗЙКЫЕГМЦЧНЯфисвуапршолдьтщзйкыегмцчнябБжЖхХъЪэЭюЮĆĘęąŁćłĄŚśźżŻŹŃńĂăȘȚșțČĎĚŇŘŠŤŮŽčďěňřšťůžЄєŒœіІїЇøØĞŞİğşıΑΒΓΔΕΖΗΘΙΚΛΜΝΞΟΠΡΣΤΥΦΧΨΩαβγδεζηθικλμνξοπρστυφχψωΆΈΉΊΌΎΏάέήίόύώςΐϊĹĽŔĺľŕ∞Ёё
fonts:
- id: FONT_BIG
image: FontBig.png
width: 16
height: 16
spacing: 0
- id: FONT_SMALL
image: FontSmall.png
width: 8
height: 9
spacing: -1
- id: FONT_GEO_BIG
image: FontGeoBig.png
width: 5
height: 9
spacing: 1
- id: FONT_GEO_SMALL
image: FontGeoSmall.png
width: 5
height: 7
spacing: 1
</pre>

==Customizing==
If you want customize font you can make it as mod. During initialization OpenXcom engine searches in [[Ruleset Reference (OpenXcom)|Ruleset]] ''fontName'' string, which by default is ''Font.dat''. You can redefine this string to another file, for example ''MyFont.dat'', and replace some ''image'' strings to your *.png-files.

Just remember, *.dat file should be placed in Language folder, and *.png files are searched relative to *.dat file!

[[Category:OpenXcom]]

Compiling with Autotools (OpenXcom)

2015-05-18T12:38:11Z

Winterheart:

== Required packages ==
In order to compile OpenXcom you need to install additional [[Compiling (OpenXcom)#Dependencies|dependencies]].

Check the library websites if you can't find them with your distribution's package manager.

'''Don't forget to copy the X-Com resources to your ''bin'' folder as shown in [[Installing (OpenXcom)|Installing]].'''

== Commands ==

<pre>
git clone https://github.com/SupSuper/OpenXcom.git
cd OpenXcom
./autogen.sh (optional)
./configure
make
</pre>

After last command and, hopefully, success compilation openxcom binary will be placed in bin folder. Enter to that directory and launch it:

<pre>
cd bin
./openxcom
</pre>

Now you done. Enjoy your invasion!

==Updating sources ==

To update sources just do:

<pre>
git pull
</pre>

And repeat compilation from running ./autogen.sh.

[[Category:OpenXcom]]

Compiling with Autotools (OpenXcom)

2015-05-18T12:33:51Z

Winterheart:

Ruleset Reference Nightly (OpenXcom)

2015-05-17T09:45:07Z

Winterheart: /* References */

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.
| -
|-
| '''textures'''
| List of terrains that correspond to each [[TEXTURE.DAT|Geoscape texture]]. Terrains can be restricted to certain areas on the globe with '''area: (''[lon1, lat1, lon2, lat2]'')''' and '''weight: NUMBER''' gives their chance of appearance.
| -
|}

=== 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.
| -
|-
| '''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.
Mission zone 3 defines cities belonging to a region (''[lon1, lat1, lon2, lat2, -1, STR_CITY_NAME]''). They will be displayed on the globe and used for terror site missions. Cities can also have a '''zoom''' setting which determines the appearance of its name label according to the specified zoom level.
| -
|-
| '''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. If "true", the radar detection chance will be set to 100% regardless of '''radarChance''' value.
| 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.
'''NOTE''': Explosive style weapons (Damage type: smoke, incendiary, stun, & High Explosive) use [[X1.PCK]] and should always be set to 0.
| 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''
|-
| '''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
|-
|'''revealedFloors'''
| Map block floor to be revealed from the very beginning; use a list "[0, 1, ..]" to reveal multiple floors
|-
| '''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.
| -
|-
| '''spriteFaceGroup'''
| Pixel color group in [[PALETTES.DAT#Color Indexes|palette]] that will be replace in unit graphic by new color, range form 1-15 (its skip first group). Used by face recoloring based on nationality.
| ''example:'' 6
|-
| '''spriteFaceColor'''
| New colors index for face pixels. 8 values ordered by:
* Male Blond
* Female Blond
* Male Brown
* Female Brown
* Male Asian
* Female Asian
* Male African
* Female African
Other units use random position form table.
Value 0 mean original value.
| ''example:''
- 96
- 96
- 96
- 96
- 160
- 160
- 163
- 163
|-
| '''spriteHairGroup'''
| Pixel color group in [[PALETTES.DAT#Color Indexes|palette]] that will be replace in unit graphic by new color, range form 1-15 (its skip first group). Used by hair recoloring based on nationality.
| ''example:'' 9
|-
| '''spriteHairColor'''
| New colors index for hair pixels. 8 values ordered by:
* Male Blond
* Female Blond
* Male Brown
* Female Brown
* Male Asian
* Female Asian
* Male African
* Female African
Other units use random position form table.
Value 0 mean original value.
| ''example:''
- 144
- 144
- 164
- 164
- 245
- 245
- 166
- 166
|-
| '''spriteUtileGroup'''
| Pixel color group in [[PALETTES.DAT#Color Indexes|palette]] that will be replace in unit graphic by new color, range form 1-15 (its skip first group).
| -
|-
| '''spriteUtileColor'''
| New colors index for pixels. 8 values ordered by:
* Male Blond
* Female Blond
* Male Brown
* Female Brown
* Male Asian
* Female Asian
* Male African
* Female African
Other units use random position form table.
Value 0 mean original value.
| -
|-
| '''spriteRankGroup'''
| Pixel color group in [[PALETTES.DAT#Color Indexes|palette]] that will be replace in unit graphic by new color, range form 1-15 (its skip first group).
| -
|-
| '''spriteRankColor'''
| New colors index for pixels. For solders 6 values ordered by:
* STR_ROOKIE
* STR_SQUADDIE
* STR_SERGEANT
* STR_CAPTAIN
* STR_COLONEL
* STR_COMMANDER
For aliens 7 values ordered by (alien unit rank property):
* STR_LIVE_SOLDIER
* STR_LIVE_ENGINEER
* STR_LIVE_MEDIC
* STR_LIVE_NAVIGATOR
* STR_LIVE_LEADER
* STR_LIVE_COMMANDER
* STR_LIVE_TERRORIST
Civilians uses random position form 8 element table.
Value 0 mean original value.
| -
|-
| '''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]]

{| 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]]

{| 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 = [[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'''
| 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
|-
| '''extraQty'''
| functionally identical to dQty, 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-days (on average, the final time will be 50-150% this value) 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). Used in Alien Navigators (gives random alien Mission), Medics (random alien interrogation or autopsy) or Engineers (gives UFO type).
| -
|-
|}

=== 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

=== Music ===

Custom music options can be defined in the Music.rul file. More details [[Audio Options (OpenXcom)#Custom Music|here]].

=== 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]

==Font==
Defines [[Font collection (OpenXcom)|font collection]] used by default.

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''fontName'''
| Name of *.dat file, placed in Language folder, which describes used [[Font collection (OpenXcom)|font collection]].
| Font.dat
|}

==References==
<references />

[[Category:OpenXcom]]

Ruleset Reference (OpenXcom)

2015-05-17T09:44:49Z

Winterheart: /* Font */ to nightly

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.
'''NOTE''': Explosive style weapons (Damage type: smoke, incendiary, stun, & High Explosive) use [[X1.PCK]] and should always be set to 0.
| 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]]

Font collection (OpenXcom)

2015-05-17T07:42:51Z

Winterheart:

'''Font collection''' is bitmap fonts used by game engine to represent text.

Original UFO/TFTD engine uses two font types: big ([[BIGLETS.DAT]], 16x16 pixels per character) and small ([[SMALLSET.DAT]], 8x9 pixels per character) for Battlescape and Geoscape. But OpenXcom uses four font types: FontBig, FontGeoBig, FontSmall, FontGeoSmall. All of them described in *.dat file (which is actually YAML-file). Default font collection is placed in Language folder and named simply '''Font.dat'''.

{|style="background:darkgray; border:1px solid dimgray;color:white" border="0" height="230" align="center" valign="bottom" cellpadding=10px cellspacing=0px
|+style="background:white; color:black"|'''Font.dat''' fonts (gray background used for transparent files)
|-align="center"

| [[File:FontBig.png|border|none]]
| [[File:FontGeoBig.png|border|none]]
| [[File:FontSmall.png|border|none]]
| [[File:FontGeoSmall.png|border|none]]
|-align="center" valign="top"
|'''FontBig.png'''
|'''FontGeoBig.png'''
|'''FontSmall.png'''
|'''FontGeoSmall.png'''
|}

''*.dat'' is divided in two sections: ''chars'' and ''fonts''. ''chars'' is string which contain all available characters, provided by this font collection. ''font'' section is bit more complicated:

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''id'''
| Type of charmap
| Should be '''FONT_BIG''', '''FONT_SMALL''', '''FONT_GEO_BIG''', or '''FONT_GEO_SMALL'''
|-
| '''image'''
| Relative path to PNG-file with contains actual glyphes
|
|-
| '''width'''
| Width of a character
|
|-
| '''height'''
| Height of a character
|
|-
| '''spacing'''
| Spacing between two characters.
|
|}

Each character in PNG-file have own rectangle with ''width'' and ''height''. Characters shouldn't overlapping each other. Characters in *.png-file placed by groups with 16 characters in each group and ordered accordingly ''chars'' string. So if you want find actual character in *.png file, here formula:

<code>
y = (''<number in chars>'' div 16) * ''height''

x = (''<number in chars>'' mod 16) * ''width''
</code>

Here example for default ''Font.dat'':

<pre>
chars: >
!"#$%&'()*+,-./0123456789:;<=>?@ABCDEFGHIJKLMNOPQRSTUVWXYZ[\]^_`abcdefghijklmnopqrstuvwxyz{|}~¡¢£¤¥¦§¨©ª«¬®¯°±²³´µ¶·¸¹º»¼½¾¿ÀÁÂÃÄÅÆÇÈÉÊËÌÍÎÏÐÑÒÓÔÕÖŐŰÙÚÛÜÝÞŸßàáâãäåæçèéêëìíîïðñòóôõöőűùúûüýþÿФИСВУАПРШОЛДЬТЩЗЙКЫЕГМЦЧНЯфисвуапршолдьтщзйкыегмцчнябБжЖхХъЪэЭюЮĆĘęąŁćłĄŚśźżŻŹŃńĂăȘȚșțČĎĚŇŘŠŤŮŽčďěňřšťůžЄєŒœіІїЇøØĞŞİğşıΑΒΓΔΕΖΗΘΙΚΛΜΝΞΟΠΡΣΤΥΦΧΨΩαβγδεζηθικλμνξοπρστυφχψωΆΈΉΊΌΎΏάέήίόύώςΐϊĹĽŔĺľŕ∞Ёё
fonts:
- id: FONT_BIG
image: FontBig.png
width: 16
height: 16
spacing: 0
- id: FONT_SMALL
image: FontSmall.png
width: 8
height: 9
spacing: -1
- id: FONT_GEO_BIG
image: FontGeoBig.png
width: 5
height: 9
spacing: 1
- id: FONT_GEO_SMALL
image: FontGeoSmall.png
width: 5
height: 7
spacing: 1
</pre>

==Customizing==
If you want customizing font you can make it as mod. During initialization OpenXcom engine searches in [[Ruleset Reference (OpenXcom)|Ruleset]] ''fontName'' string, which by default is ''Font.dat''. You can redefine this string to another file, for example ''MyFont.dat'', and replace some ''image'' strings to your *.png-files.

Just remember, *.dat file should be placed in Language folder, and *.png files are searched relative to *.dat file!

[[Category:OpenXcom]]

File:FontSmall.png

2015-05-17T07:27:26Z

Winterheart: Default FontSmall from OpenXcom

Default FontSmall from OpenXcom

File:FontGeoSmall.png

2015-05-17T07:27:01Z

Winterheart: Default FontGeoSmall from OpenXcom

Default FontGeoSmall from OpenXcom

File:FontGeoBig.png

2015-05-17T07:25:49Z

Winterheart: Default FontGeoBig from OpenXcom

Default FontGeoBig from OpenXcom

File:FontBig.png

2015-05-17T07:25:18Z

Winterheart: Default FontBig from OpenXcom

Default FontBig from OpenXcom

Font collection (OpenXcom)

2015-05-17T07:23:14Z

Winterheart: Created page with "'''Font collection''' is bitmap fonts used by game engine to represent text. Original UFO/TFTD engine uses two font types: big (BIGLETS.DAT, 16x16 pixels per character) a..."

'''Font collection''' is bitmap fonts used by game engine to represent text.

Original UFO/TFTD engine uses two font types: big ([[BIGLETS.DAT]], 16x16 pixels per character) and small ([[SMALLSET.DAT]], 8x9 pixels per character) for Battlescape and Geoscape. But OpenXcom uses four font types: FontBig, FontGeoBig, FontSmall, FontGeoSmall. All of them described in *.dat file (which is actually YAML-file). Default font collection is placed in Language folder and named simply '''Font.dat'''.

''*.dat'' is divided in two sections: ''chars'' and ''fonts''. ''chars'' is string which contain all available characters, provided by this font collection. ''font'' section is bit more complicated:

{| class="wikitable" width="100%"
! width="150"| Value
! width="*" | Description
! width="80" | Default
|-
| '''id'''
| Type of charmap
| Should be '''FONT_BIG''', '''FONT_SMALL''', '''FONT_GEO_BIG''', or '''FONT_GEO_SMALL'''
|-
| '''image'''
| Relative path to PNG-file with contains actual glyphes
|
|-
| '''width'''
| Width of a character
|
|-
| '''height'''
| Height of a character
|
|-
| '''spacing'''
| Spacing between two characters.
|
|}

Each character in PNG-file have own rectangle with ''width'' and ''height''. Characters shouldn't overlapping each other. Characters in *.png-file placed by groups with 16 characters in each group and ordered accordingly ''chars'' string. So if you want find actual character in *.png file, here formula:

<code>
y = (''<number in chars>'' div 16) * ''height''

x = (''<number in chars>'' mod 16) * ''width''
</code>

Here example for default ''Font.dat'':

<pre>
chars: >
!"#$%&'()*+,-./0123456789:;<=>?@ABCDEFGHIJKLMNOPQRSTUVWXYZ[\]^_`abcdefghijklmnopqrstuvwxyz{|}~¡¢£¤¥¦§¨©ª«¬®¯°±²³´µ¶·¸¹º»¼½¾¿ÀÁÂÃÄÅÆÇÈÉÊËÌÍÎÏÐÑÒÓÔÕÖŐŰÙÚÛÜÝÞŸßàáâãäåæçèéêëìíîïðñòóôõöőűùúûüýþÿФИСВУАПРШОЛДЬТЩЗЙКЫЕГМЦЧНЯфисвуапршолдьтщзйкыегмцчнябБжЖхХъЪэЭюЮĆĘęąŁćłĄŚśźżŻŹŃńĂăȘȚșțČĎĚŇŘŠŤŮŽčďěňřšťůžЄєŒœіІїЇøØĞŞİğşıΑΒΓΔΕΖΗΘΙΚΛΜΝΞΟΠΡΣΤΥΦΧΨΩαβγδεζηθικλμνξοπρστυφχψωΆΈΉΊΌΎΏάέήίόύώςΐϊĹĽŔĺľŕ∞Ёё
fonts:
- id: FONT_BIG
image: FontBig.png
width: 16
height: 16
spacing: 0
- id: FONT_SMALL
image: FontSmall.png
width: 8
height: 9
spacing: -1
- id: FONT_GEO_BIG
image: FontGeoBig.png
width: 5
height: 9
spacing: 1
- id: FONT_GEO_SMALL
image: FontGeoSmall.png
width: 5
height: 7
spacing: 1
</pre>

==Customizing==
If you want customizing font you can make it as mod. During initialization OpenXcom engine searches in [[Ruleset Reference (OpenXcom)|Ruleset]] ''fontName'' string, which by default is ''Font.dat''. You can redefine this string to another file, for example ''MyFont.dat'', and replace some ''image'' strings to your *.png-files.

Just remember, *.dat file should be placed in Language folder, and *.png files are searched relative to *.dat file!

[[Category:OpenXcom]]

Translations (OpenXcom)

2015-05-17T06:38:23Z

Winterheart:

Like [[GeoScape String Files|the original]], OpenXcom supports translation of all ingame strings. However, the format has been changed to make it easier to edit, maintain and add support for Unicode. Currently the easiest way to translate is to use the [https://www.transifex.com/projects/p/openxcom/ Transifex web site].

== Guidelines ==
* Preserve the original structure: Don't change text inside {} tags and keep any spaces, uppercases, etc. that the original string has, unless you have a good reason not to.
* Be consistent: Don't make the text look schizophrenic, stick to one style throughout. If a word has multiple translations, choose one and stick with it. If working with multiple translators, be sure to work this out before-hand. Transifex has handy [https://www.transifex.com/projects/p/openxcom/glossary/l/en_US/ Glossary tool] for that. During translation you will receive highlights for known words.
* Don't use automatic translations: We're not robots. Only use them to assist you. I recommend [http://www.linguee.com/ Linguee] since it uses real translations.
* Review your work: Again, we're not robots and make mistakes every now and then. Don't forget to use a spellchecker.
* Pay attention to length: while most of the interface is fairly roomy (eg. Ufopaedia screens), some elements just can't fit a lot of words into a tight 320x200 screen (eg. columned lists). Remember you can test your translation ingame by downloading the file to your Language folder.

== Graphics ==

Sadly a translator's job isn't just replacing strings. Sometimes you also need to have a little bit of artistry. The game uses bitmap fonts to display text. These fonts are limited with Latin extended, Greek, and Cyrillic alphabets. If your language has new characters that it doesn't support, you'll have to add [[font collection (OpenXcom)|them in yourself]] and create it as [[mods (OpenXcom)|mod]].

== Testing ==

To test your translations in-game you just need to put them in the ''Data\Language'' folder. You can get the latest translations directly from Transifex by clicking the resource name. They are also available in the Git builds. If you need to check how much room you have for a string, you can enable ''debugUi'' in your ''options.cfg'' to see the text boxes in-game.

== Format ==

Language files are stored in YAML format (UTF-8). Here's a typical language file:

<pre>
en-US:
STR_AVENGER_UFOPEDIA: "TRANSPORTER AND COMBAT SPACECRAFT. THE ULTIMATE REPLICATION OF ALIEN TECHNOLOGY."
STR_INTERCEPTOR_UFOPEDIA: "COMBAT AIRCRAFT WITH DUAL PULSE DETONATION ENGINES AND SPECIALLY SHIELDED ELECTRONIC SYSTEMS. THE BEST AVAILABLE EARTH BASED TECHNOLOGY."
STR_LIGHTNING_UFOPEDIA: "TRANSPORTER AND COMBAT CRAFT. A CRUDE BUT EFFECTIVE REPLICATION OF ALIEN PROPULSION SYSTEMS."
STR_SKYRANGER_UFOPEDIA: "TROOP TRANSPORTER. THE FASTEST OF ITS KIND, WITH VERTICAL TAKE OFF AND LANDING (V.T.O.L.) CAPABILITY."
STR_FIRESTORM_UFOPEDIA: "COMBAT CRAFT. THIS ONE-MAN FIGHTER REPLICATES THE CLASSIC ALIEN FLYING SAUCER DESIGN, WITH CENTRAL PROPULSION UNIT."
...
</pre>

The first line contains the [http://www.i18nguy.com/unicode/language-identifiers.html IETF language tag] (same as the filename). The rest of the text are just key-string pairs, separated by linebreaks. Language files are placed in the ''Data\Language'' folder and have the .yml extension.

==Special cases==
=== Pluralization ===

Some strings have different forms depending on the associated number {N}, for example "1 day" and "2 days". Different languages have different pluralization rules (See [http://cldr.unicode.org/index/cldr-spec/plural-rules Unicode Language Plural Rules] for the reference), you can ignore the cases that don't apply to your language as they won't be used by the game. Otherwise you should provide all plural forms, needed for your language.

For example, you translating OpenXcom to Czech. Source en-US.yml for English have these lines:

<code>
STR_DAY:
one: "{N} day"
other: "{N} days"
</code>

As we can see, English have only 2 plural forms, ''one'' and ''other''. But Czech, according to standards, have 3 plural forms: ''one'' ("1 den"), ''few'' ("2 dny") and ''other'' ("5 dní"). So here code how it should look in cz.yml file:

<code>
STR_DAY:
one: "{N} den"
few: "{N} dny"
other: "{N} dní"
</code>

OpenXcom engine based on digit, provided here as ''{N}'', will choose correct plural form.

=== Gender-specific messages ===
Again, some languages have messages, that differ for male or female character. For example, in Russian we have two variants of "''<Soldier name> has Panicked''": "''<Soldier name> запаниковал''" (for male character) and "''<Soldier name> запаниковала''" (for female character). For this case we have two strings with _MALE and _FEMALE suffixes:

<code>
STR_HAS_PANICKED_MALE: "{0}{NEWLINE}запаниковал"
STR_HAS_PANICKED_FEMALE: "{0}{NEWLINE}запаниковала"
</code>

If your language don't have such feature, just provide for both strings same translation. Otherwise, fill male and female messages accordingly their suffixes.

== External Links ==

* [http://openxcom.org/forum/index.php/board,6.0.html Translations forum]

[[Category:OpenXcom]]

Ruleset Reference (OpenXcom)

2015-05-17T06:26:28Z

Winterheart: /* Font */

Ruleset Reference (OpenXcom)

2015-05-17T06:26:03Z

Winterheart: /* StatStrings */

Translations (OpenXcom)

2014-10-08T08:55:15Z

Winterheart: /* Gender-specific messages */

Like [[GeoScape String Files|the original]], OpenXcom supports translation of all ingame strings. However, the format has been changed to make it easier to edit, maintain and add support for Unicode. Currently the easiest way to translate is to use the [https://www.transifex.com/projects/p/openxcom/ Transifex web site].

== Guidelines ==
* Preserve the original structure: Don't change text inside {} tags and keep any spaces, uppercases, etc. that the original string has, unless you have a good reason not to.
* Be consistent: Don't make the text look schizophrenic, stick to one style throughout. If a word has multiple translations, choose one and stick with it. If working with multiple translators, be sure to work this out before-hand. Transifex has handy [https://www.transifex.com/projects/p/openxcom/glossary/l/en_US/ Glossary tool] for that. During translation you will receive highlights for known words.
* Don't use automatic translations: We're not robots. Only use them to assist you. I recommend [http://www.linguee.com/ Linguee] since it uses real translations.
* Review your work: Again, we're not robots and make mistakes every now and then. Don't forget to use a spellchecker.
* Pay attention to length: while most of the interface is fairly roomy (eg. Ufopaedia screens), some elements just can't fit a lot of words into a tight 320x200 screen (eg. columned lists). Remember you can test your translation ingame by downloading the file to your Language folder.

== Graphics ==

Sadly a translator's job isn't just replacing strings. Sometimes you also need to have a little bit of artistry. The game uses bitmap fonts to display text, so if your language has new characters that it doesn't support, you'll have to add them in yourself. The font files are PNG images in the Language folder, which are referenced by a ''Font.dat'' text file which contains all the characters in the fonts (in UTF-8). To add a character you just put it at the end of the ''chars:'' in ''Font.dat'' and then draw them into the font files (both lowercase and uppercase).

== Testing ==

To test your translations in-game you just need to put them in the ''Data\Language'' folder. You can get the latest translations from GetLocalization [http://openxcom.org/translations/latest.zip here], they are updated hourly. If you need to check how much room you have for a string, you can enable ''debugUi'' in your ''options.cfg'' to see the text boxes in-game.

== Format ==

Language files are stored in YAML format (UTF-8). Here's a typical language file:

<pre>
en-US:
STR_AVENGER_UFOPEDIA: "TRANSPORTER AND COMBAT SPACECRAFT. THE ULTIMATE REPLICATION OF ALIEN TECHNOLOGY."
STR_INTERCEPTOR_UFOPEDIA: "COMBAT AIRCRAFT WITH DUAL PULSE DETONATION ENGINES AND SPECIALLY SHIELDED ELECTRONIC SYSTEMS. THE BEST AVAILABLE EARTH BASED TECHNOLOGY."
STR_LIGHTNING_UFOPEDIA: "TRANSPORTER AND COMBAT CRAFT. A CRUDE BUT EFFECTIVE REPLICATION OF ALIEN PROPULSION SYSTEMS."
STR_SKYRANGER_UFOPEDIA: "TROOP TRANSPORTER. THE FASTEST OF ITS KIND, WITH VERTICAL TAKE OFF AND LANDING (V.T.O.L.) CAPABILITY."
STR_FIRESTORM_UFOPEDIA: "COMBAT CRAFT. THIS ONE-MAN FIGHTER REPLICATES THE CLASSIC ALIEN FLYING SAUCER DESIGN, WITH CENTRAL PROPULSION UNIT."
...
</pre>

The first line contains the [http://www.i18nguy.com/unicode/language-identifiers.html IETF language tag] (same as the filename). The rest of the text are just key-string pairs, separated by linebreaks. Language files are placed in the ''Data\Language'' folder and have the .yml extension.

==Special cases==
=== Pluralization ===

Some strings have different forms depending on the associated number {N}, for example "1 day" and "2 days". Different languages have different pluralization rules (See [http://unicode.org/repos/cldr-tmp/trunk/diff/supplemental/language_plural_rules.html Unicode Language Plural Rules] for the reference), you can ignore the cases that don't apply to your language as they won't be used by the game. Otherwise you should provide all plural forms, needed for your language.

For example, you translating OpenXcom to Czech. Source en-US.yml for English have these lines:

<code>
STR_DAY:
one: "{N} day"
other: "{N} days"
</code>

As we can see, English have only 2 plural forms, ''one'' and ''other''. But Czech, according to standards, have 3 plural forms: ''one'' ("1 den"), ''few'' ("2 dny") and ''other'' ("5 dní"). So here code how it should look in cz.yml file:

<code>
STR_DAY:
one: "{N} den"
few: "{N} dny"
other: "{N} dní"
</code>

OpenXcom engine based on digit, provided here as ''{N}'', will choose correct plural form.

=== Gender-specific messages ===
Again, some languages have messages, that differ for male or female character. For example, in Russian we have two variants of "''<Soldier name> has Panicked''": "''<Soldier name> запаниковал''" (for male character) and "''<Soldier name> запаниковала''" (for female character). For this case we have two strings with _MALE and _FEMALE suffixes:

<code>
STR_HAS_PANICKED_MALE: "{0}{NEWLINE}запаниковал"
STR_HAS_PANICKED_FEMALE: "{0}{NEWLINE}запаниковала"
</code>

If your language don't have such feature, just provide for both strings same translation. Otherwise, fill male and female messages accordingly their suffixes.

== External Links ==

* [http://openxcom.org/forum/index.php/board,6.0.html Translations forum]

[[Category:OpenXcom]]

Translations (OpenXcom)

2014-10-08T08:54:11Z

Winterheart: /* Pluralization */

Like [[GeoScape String Files|the original]], OpenXcom supports translation of all ingame strings. However, the format has been changed to make it easier to edit, maintain and add support for Unicode. Currently the easiest way to translate is to use the [https://www.transifex.com/projects/p/openxcom/ Transifex web site].

== Guidelines ==
* Preserve the original structure: Don't change text inside {} tags and keep any spaces, uppercases, etc. that the original string has, unless you have a good reason not to.
* Be consistent: Don't make the text look schizophrenic, stick to one style throughout. If a word has multiple translations, choose one and stick with it. If working with multiple translators, be sure to work this out before-hand. Transifex has handy [https://www.transifex.com/projects/p/openxcom/glossary/l/en_US/ Glossary tool] for that. During translation you will receive highlights for known words.
* Don't use automatic translations: We're not robots. Only use them to assist you. I recommend [http://www.linguee.com/ Linguee] since it uses real translations.
* Review your work: Again, we're not robots and make mistakes every now and then. Don't forget to use a spellchecker.
* Pay attention to length: while most of the interface is fairly roomy (eg. Ufopaedia screens), some elements just can't fit a lot of words into a tight 320x200 screen (eg. columned lists). Remember you can test your translation ingame by downloading the file to your Language folder.

== Graphics ==

Sadly a translator's job isn't just replacing strings. Sometimes you also need to have a little bit of artistry. The game uses bitmap fonts to display text, so if your language has new characters that it doesn't support, you'll have to add them in yourself. The font files are PNG images in the Language folder, which are referenced by a ''Font.dat'' text file which contains all the characters in the fonts (in UTF-8). To add a character you just put it at the end of the ''chars:'' in ''Font.dat'' and then draw them into the font files (both lowercase and uppercase).

== Testing ==

To test your translations in-game you just need to put them in the ''Data\Language'' folder. You can get the latest translations from GetLocalization [http://openxcom.org/translations/latest.zip here], they are updated hourly. If you need to check how much room you have for a string, you can enable ''debugUi'' in your ''options.cfg'' to see the text boxes in-game.

== Format ==

Language files are stored in YAML format (UTF-8). Here's a typical language file:

<pre>
en-US:
STR_AVENGER_UFOPEDIA: "TRANSPORTER AND COMBAT SPACECRAFT. THE ULTIMATE REPLICATION OF ALIEN TECHNOLOGY."
STR_INTERCEPTOR_UFOPEDIA: "COMBAT AIRCRAFT WITH DUAL PULSE DETONATION ENGINES AND SPECIALLY SHIELDED ELECTRONIC SYSTEMS. THE BEST AVAILABLE EARTH BASED TECHNOLOGY."
STR_LIGHTNING_UFOPEDIA: "TRANSPORTER AND COMBAT CRAFT. A CRUDE BUT EFFECTIVE REPLICATION OF ALIEN PROPULSION SYSTEMS."
STR_SKYRANGER_UFOPEDIA: "TROOP TRANSPORTER. THE FASTEST OF ITS KIND, WITH VERTICAL TAKE OFF AND LANDING (V.T.O.L.) CAPABILITY."
STR_FIRESTORM_UFOPEDIA: "COMBAT CRAFT. THIS ONE-MAN FIGHTER REPLICATES THE CLASSIC ALIEN FLYING SAUCER DESIGN, WITH CENTRAL PROPULSION UNIT."
...
</pre>

The first line contains the [http://www.i18nguy.com/unicode/language-identifiers.html IETF language tag] (same as the filename). The rest of the text are just key-string pairs, separated by linebreaks. Language files are placed in the ''Data\Language'' folder and have the .yml extension.

==Special cases==
=== Pluralization ===

Some strings have different forms depending on the associated number {N}, for example "1 day" and "2 days". Different languages have different pluralization rules (See [http://unicode.org/repos/cldr-tmp/trunk/diff/supplemental/language_plural_rules.html Unicode Language Plural Rules] for the reference), you can ignore the cases that don't apply to your language as they won't be used by the game. Otherwise you should provide all plural forms, needed for your language.

For example, you translating OpenXcom to Czech. Source en-US.yml for English have these lines:

<code>
STR_DAY:
one: "{N} day"
other: "{N} days"
</code>

As we can see, English have only 2 plural forms, ''one'' and ''other''. But Czech, according to standards, have 3 plural forms: ''one'' ("1 den"), ''few'' ("2 dny") and ''other'' ("5 dní"). So here code how it should look in cz.yml file:

<code>
STR_DAY:
one: "{N} den"
few: "{N} dny"
other: "{N} dní"
</code>

OpenXcom engine based on digit, provided here as ''{N}'', will choose correct plural form.

=== Gender-specific messages ===
Again, some languages have messages, that differ for male or female character. For example, in Russian we have two variants of "''<Soldier name> has Panicked''": "''<Soldier name> запаниковал''" (for male character) and "''<Soldier name> запаниковала''" (for female character). For this case we have two strings with _MALE and _FEMALE suffixes. If your language don't have such feature, just provide for both strings same translation. Otherwise, fill male and female messages accordingly their suffixes.

== External Links ==

* [http://openxcom.org/forum/index.php/board,6.0.html Translations forum]

[[Category:OpenXcom]]

Translations (OpenXcom)

2014-10-08T08:42:53Z

Winterheart:

Like [[GeoScape String Files|the original]], OpenXcom supports translation of all ingame strings. However, the format has been changed to make it easier to edit, maintain and add support for Unicode. Currently the easiest way to translate is to use the [https://www.transifex.com/projects/p/openxcom/ Transifex web site].

== Guidelines ==
* Preserve the original structure: Don't change text inside {} tags and keep any spaces, uppercases, etc. that the original string has, unless you have a good reason not to.
* Be consistent: Don't make the text look schizophrenic, stick to one style throughout. If a word has multiple translations, choose one and stick with it. If working with multiple translators, be sure to work this out before-hand. Transifex has handy [https://www.transifex.com/projects/p/openxcom/glossary/l/en_US/ Glossary tool] for that. During translation you will receive highlights for known words.
* Don't use automatic translations: We're not robots. Only use them to assist you. I recommend [http://www.linguee.com/ Linguee] since it uses real translations.
* Review your work: Again, we're not robots and make mistakes every now and then. Don't forget to use a spellchecker.
* Pay attention to length: while most of the interface is fairly roomy (eg. Ufopaedia screens), some elements just can't fit a lot of words into a tight 320x200 screen (eg. columned lists). Remember you can test your translation ingame by downloading the file to your Language folder.

== Graphics ==

Sadly a translator's job isn't just replacing strings. Sometimes you also need to have a little bit of artistry. The game uses bitmap fonts to display text, so if your language has new characters that it doesn't support, you'll have to add them in yourself. The font files are PNG images in the Language folder, which are referenced by a ''Font.dat'' text file which contains all the characters in the fonts (in UTF-8). To add a character you just put it at the end of the ''chars:'' in ''Font.dat'' and then draw them into the font files (both lowercase and uppercase).

== Testing ==

To test your translations in-game you just need to put them in the ''Data\Language'' folder. You can get the latest translations from GetLocalization [http://openxcom.org/translations/latest.zip here], they are updated hourly. If you need to check how much room you have for a string, you can enable ''debugUi'' in your ''options.cfg'' to see the text boxes in-game.

== Format ==

Language files are stored in YAML format (UTF-8). Here's a typical language file:

<pre>
en-US:
STR_AVENGER_UFOPEDIA: "TRANSPORTER AND COMBAT SPACECRAFT. THE ULTIMATE REPLICATION OF ALIEN TECHNOLOGY."
STR_INTERCEPTOR_UFOPEDIA: "COMBAT AIRCRAFT WITH DUAL PULSE DETONATION ENGINES AND SPECIALLY SHIELDED ELECTRONIC SYSTEMS. THE BEST AVAILABLE EARTH BASED TECHNOLOGY."
STR_LIGHTNING_UFOPEDIA: "TRANSPORTER AND COMBAT CRAFT. A CRUDE BUT EFFECTIVE REPLICATION OF ALIEN PROPULSION SYSTEMS."
STR_SKYRANGER_UFOPEDIA: "TROOP TRANSPORTER. THE FASTEST OF ITS KIND, WITH VERTICAL TAKE OFF AND LANDING (V.T.O.L.) CAPABILITY."
STR_FIRESTORM_UFOPEDIA: "COMBAT CRAFT. THIS ONE-MAN FIGHTER REPLICATES THE CLASSIC ALIEN FLYING SAUCER DESIGN, WITH CENTRAL PROPULSION UNIT."
...
</pre>

The first line contains the [http://www.i18nguy.com/unicode/language-identifiers.html IETF language tag] (same as the filename). The rest of the text are just key-string pairs, separated by linebreaks. Language files are placed in the ''Data\Language'' folder and have the .yml extension.

== Pluralization ==

Some strings have different forms depending on the associated number {N}, for example "1 day" and "2 days". Different languages have different pluralization rules (See [http://unicode.org/repos/cldr-tmp/trunk/diff/supplemental/language_plural_rules.html Unicode Language Plural Rules] for the reference), you can ignore the cases that don't apply to your language as they won't be used by the game. Otherwise you should provide all plural forms, needed for your language.

For example, you translating OpenXcom to Czech. Source en-US.yml for English have these lines:

<code>
STR_DAY:
one: "{N} day"
other: "{N} days"
</code>

As we can see, English have only 2 plural forms, ''one'' and ''other''. But Czech, according to standards, have 3 plural forms: ''one'' ("1 den"), ''few'' ("2 dny") and ''other'' ("5 dní"). So here code how it should look in cz.yml file:

<code>
STR_DAY:
one: "{N} den"
few: "{N} dny"
other: "{N} dní"
</code>

OpenXcom engine based on digit, provided here as ''{N}'', will choose correct plural form.

== External Links ==

* [http://openxcom.org/forum/index.php/board,6.0.html Translations forum]

[[Category:OpenXcom]]

Translations (OpenXcom)

2014-10-08T08:36:53Z

Winterheart: /* Pluralization */

Like [[GeoScape String Files|the original]], OpenXcom supports translation of all ingame strings. However, the format has been changed to make it easier to edit, maintain and add support for Unicode. Currently the easiest way to translate is to use the [http://www.getlocalization.com/openxcom/ GetLocalization online tool].

== Guidelines ==
* Preserve the original structure: Don't change text inside {} tags and keep any spaces, uppercases, etc. that the original string has, unless you have a good reason not to.
* Be consistent: Don't make the text look schizophrenic, stick to one style throughout. If a word has multiple translations, choose one and stick with it. If working with multiple translators, be sure to work this out before-hand.
* Don't use automatic translations: We're not robots. Only use them to assist you. I recommend [http://www.linguee.com/ Linguee] since it uses real translations.
* Review your work: Again, we're not robots and make mistakes every now and then. Don't forget to use a spellchecker.
* Pay attention to length: while most of the interface is fairly roomy (eg. Ufopaedia screens), some elements just can't fit a lot of words into a tight 320x200 screen (eg. columned lists). Remember you can test your translation ingame by downloading the file to your Language folder.

== Pluralization ==

Some strings have different forms depending on the associated number {N}, for example "1 day" and "2 days". Different languages have different pluralization rules (See [http://unicode.org/repos/cldr-tmp/trunk/diff/supplemental/language_plural_rules.html Unicode Language Plural Rules] for the reference), you can ignore the cases that don't apply to your language as they won't be used by the game. Otherwise you should provide all plural forms, needed for your language.

For example, you translating OpenXcom to Czech. Source en-US.yml for English have these lines:

<code>
STR_DAY:
one: "{N} day"
other: "{N} days"
</code>

As we can see, English have only 2 plural forms, ''one'' and ''other''. But Czech, according to standards, have 3 plural forms: ''one'' ("1 den"), ''few'' ("2 dny") and ''other'' ("5 dní"). So here code how it should look in cz.yml file:

<code>
STR_DAY:
one: "{N} den"
few: "{N} dny"
other: "{N} dní"
</code>

OpenXcom engine based on digit, provided here as ''{N}'', will choose correct plural form.

== Graphics ==

Sadly a translator's job isn't just replacing strings. Sometimes you also need to have a little bit of artistry. The game uses bitmap fonts to display text, so if your language has new characters that it doesn't support, you'll have to add them in yourself. The font files are PNG images in the Language folder, which are referenced by a ''Font.dat'' text file which contains all the characters in the fonts (in UTF-8). To add a character you just put it at the end of the ''chars:'' in ''Font.dat'' and then draw them into the font files (both lowercase and uppercase).

== Testing ==

To test your translations in-game you just need to put them in the ''Data\Language'' folder. You can get the latest translations from GetLocalization [http://openxcom.org/translations/latest.zip here], they are updated hourly. If you need to check how much room you have for a string, you can enable ''debugUi'' in your ''options.cfg'' to see the text boxes in-game.

== Format ==

Language files are stored in YAML format (UTF-8). Here's a typical language file:

<pre>
en-US:
STR_AVENGER_UFOPEDIA: "TRANSPORTER AND COMBAT SPACECRAFT. THE ULTIMATE REPLICATION OF ALIEN TECHNOLOGY."
STR_INTERCEPTOR_UFOPEDIA: "COMBAT AIRCRAFT WITH DUAL PULSE DETONATION ENGINES AND SPECIALLY SHIELDED ELECTRONIC SYSTEMS. THE BEST AVAILABLE EARTH BASED TECHNOLOGY."
STR_LIGHTNING_UFOPEDIA: "TRANSPORTER AND COMBAT CRAFT. A CRUDE BUT EFFECTIVE REPLICATION OF ALIEN PROPULSION SYSTEMS."
STR_SKYRANGER_UFOPEDIA: "TROOP TRANSPORTER. THE FASTEST OF ITS KIND, WITH VERTICAL TAKE OFF AND LANDING (V.T.O.L.) CAPABILITY."
STR_FIRESTORM_UFOPEDIA: "COMBAT CRAFT. THIS ONE-MAN FIGHTER REPLICATES THE CLASSIC ALIEN FLYING SAUCER DESIGN, WITH CENTRAL PROPULSION UNIT."
...
</pre>

The first line contains the [http://www.i18nguy.com/unicode/language-identifiers.html IETF language tag] (same as the filename). The rest of the text are just key-string pairs, separated by linebreaks. Language files are placed in the ''Data\Language'' folder and have the .yml extension.

== External Links ==

* [http://openxcom.org/forum/index.php/board,6.0.html Translations forum]

[[Category:OpenXcom]]

Translations (OpenXcom)

2014-10-08T08:36:23Z

Winterheart: /* Pluralization */

Like [[GeoScape String Files|the original]], OpenXcom supports translation of all ingame strings. However, the format has been changed to make it easier to edit, maintain and add support for Unicode. Currently the easiest way to translate is to use the [http://www.getlocalization.com/openxcom/ GetLocalization online tool].

== Guidelines ==
* Preserve the original structure: Don't change text inside {} tags and keep any spaces, uppercases, etc. that the original string has, unless you have a good reason not to.
* Be consistent: Don't make the text look schizophrenic, stick to one style throughout. If a word has multiple translations, choose one and stick with it. If working with multiple translators, be sure to work this out before-hand.
* Don't use automatic translations: We're not robots. Only use them to assist you. I recommend [http://www.linguee.com/ Linguee] since it uses real translations.
* Review your work: Again, we're not robots and make mistakes every now and then. Don't forget to use a spellchecker.
* Pay attention to length: while most of the interface is fairly roomy (eg. Ufopaedia screens), some elements just can't fit a lot of words into a tight 320x200 screen (eg. columned lists). Remember you can test your translation ingame by downloading the file to your Language folder.

== Pluralization ==

Some strings have different forms depending on the associated number {N}, for example "1 day" and "2 days". Different languages have different pluralization rules (See [http://unicode.org/repos/cldr-tmp/trunk/diff/supplemental/language_plural_rules.html Unicode Language Plural Rules] for the reference), you can ignore the cases that don't apply to your language as they won't be used by the game. Otherwise you should provide all plural forms, needed for your language.

For example, you translating OpenXcom to Czech. Source en-US.yml for English have these lines:

<code>
STR_DAY
one: "{N} day"
other: "{N} days"
</code>

As we can see, English have only 2 plural forms, ''one'' and ''other''. But Czech, according to standards, have 3 plural forms: ''one'' ("1 den"), ''few'' ("2 dny") and ''other'' ("5 dní"). So here code how it should look in cz.yml file:

<code>
STR_DAY:
one: "{N} den"
few: "{N} dny"
other: "{N} dní"
</code>

OpenXcom engine based on digit, provided here as ''{N}'', will choose correct plural form.

== Graphics ==

Sadly a translator's job isn't just replacing strings. Sometimes you also need to have a little bit of artistry. The game uses bitmap fonts to display text, so if your language has new characters that it doesn't support, you'll have to add them in yourself. The font files are PNG images in the Language folder, which are referenced by a ''Font.dat'' text file which contains all the characters in the fonts (in UTF-8). To add a character you just put it at the end of the ''chars:'' in ''Font.dat'' and then draw them into the font files (both lowercase and uppercase).

== Testing ==

To test your translations in-game you just need to put them in the ''Data\Language'' folder. You can get the latest translations from GetLocalization [http://openxcom.org/translations/latest.zip here], they are updated hourly. If you need to check how much room you have for a string, you can enable ''debugUi'' in your ''options.cfg'' to see the text boxes in-game.

== Format ==

Language files are stored in YAML format (UTF-8). Here's a typical language file:

<pre>
en-US:
STR_AVENGER_UFOPEDIA: "TRANSPORTER AND COMBAT SPACECRAFT. THE ULTIMATE REPLICATION OF ALIEN TECHNOLOGY."
STR_INTERCEPTOR_UFOPEDIA: "COMBAT AIRCRAFT WITH DUAL PULSE DETONATION ENGINES AND SPECIALLY SHIELDED ELECTRONIC SYSTEMS. THE BEST AVAILABLE EARTH BASED TECHNOLOGY."
STR_LIGHTNING_UFOPEDIA: "TRANSPORTER AND COMBAT CRAFT. A CRUDE BUT EFFECTIVE REPLICATION OF ALIEN PROPULSION SYSTEMS."
STR_SKYRANGER_UFOPEDIA: "TROOP TRANSPORTER. THE FASTEST OF ITS KIND, WITH VERTICAL TAKE OFF AND LANDING (V.T.O.L.) CAPABILITY."
STR_FIRESTORM_UFOPEDIA: "COMBAT CRAFT. THIS ONE-MAN FIGHTER REPLICATES THE CLASSIC ALIEN FLYING SAUCER DESIGN, WITH CENTRAL PROPULSION UNIT."
...
</pre>

The first line contains the [http://www.i18nguy.com/unicode/language-identifiers.html IETF language tag] (same as the filename). The rest of the text are just key-string pairs, separated by linebreaks. Language files are placed in the ''Data\Language'' folder and have the .yml extension.

== External Links ==

* [http://openxcom.org/forum/index.php/board,6.0.html Translations forum]

[[Category:OpenXcom]]

Achievements (EU2012)

2014-08-10T12:54:34Z

Winterheart: /* Enemy Within DLC */

'''Achievements''' are separate goals or personal achievement trophies that you can earn as you play the game. These are obtained automatically through the normal progression of the game or by performing difficult tasks under harsh conditions.

These achievements provide no direct in-game benefits and can be collected at your leisure. They are mainly provided for players that wish to collect everything that can be collected and to perform everything that can be conceivably performed in the game.

The achievement lists are slightly different depending on the platform you're playing on - [[#Bubonic|Bubonic]] is only available to PC players, whilst [[#Poison Control|Poison Control]] is only for consolers. The [[#You Win|You Win]] trophy is PS3-only. [http://steamcommunity.com/stats/XCOMEnemyUnknown/achievements/ Steam offers a list of achievements with the percentages of PC players who have obtained them].

Unless otherwise specified, all achievements must be obtained whilst playing single player, but under any [[Difficulty (EU2012)|difficulty]]. Use of [[Hero (EU2012)|heroes]] will disable achievements for your campaign (even for missions that they don't attend). Achievement titles in dark cells are hidden until unlocked.
</noinclude>

==Original XCOM: Enemy Unknown==

{| class="wikitable sortable" width="100%" style="text-align: center
|-
! width="50px" | Image
! width="15%" | Name
! width="20%" | Description
! width="10%" | Xbox Gamerscore
! width="10%" | PS3 Trophy
! width="auto" | Notes
|-
|[[Image:You_Win_(EU2012).jpg]]
!You Win
|Gain all trophies.
| align="center" | -
| align="center" | Platinum
|Obtained after all other trophies are earned. PS3 only.
|-
|[[Image:Meet_New_People_Then_Kill_Them_(EU2012).jpg]]
!Meet New People. Then Kill Them.
|Win a [[Multiplayer_(EU2012)|multiplayer]] match.
| align="center" | 25 [[FIle:Gamescore.png]]
| align="center" | Bronze
|Doesn't have to be ranked.
|-
|[[Image:No_Looking_Back_(EU2012).jpg]]
!No Looking Back
| Beat the game in [[Difficulty_(EU2012)#Ironman|Ironman]] on [[Difficulty_(EU2012)#Classic|Classic]] or [[Difficulty_(EU2012)#Impossible|Impossible]] Difficulty.
| align="center" | 100 [[FIle:Gamescore.png]]
| align="center" | Gold
|
|-
|[[Image:Xavier_(EU2012).jpg]]
!Xavier
|Mind control an [[Ethereal_(EU2012)|Ethereal]] alien. Single player only.
| align="center" | 10 [[FIle:Gamescore.png]]
| align="center" | Silver
| Psi Armor, Mind Shield, and a Psi Inspiration boost make this feasable.
|-
|[[Image:Humanitys_Savior_(EU2012).jpg]]
!Humanity's Savior
|Beat the game on any difficulty.
| align="center" | 30 [[FIle:Gamescore.png]]
| align="center" | Bronze
|
|-
|[[Image:Earth_First_(EU2012).jpg]]
!Earth First
|Beat the game on [[Difficulty_(EU2012)#Classic|Classic]] difficulty.
| align="center" | 60 [[FIle:Gamescore.png]]
| align="center" | Silver
|
|-
|[[Image:Our_Finest_Hour_(EU2012).jpg]]
!Our Finest Hour
|Complete the game on [[Difficulty_(EU2012)#Impossible|Impossible]] difficulty.
| align="center" | 90 [[FIle:Gamescore.png]]
| align="center" | Gold
| Note that it doesn't say "on Ironman."
|-
|[[Image:Lone_Wolf_(EU2012).jpg]]
!Lone Wolf
|Clear a [[Missions_(EU2012)#UFO_Crash_Site|UFO Crash Site]] with one soldier on [[Difficulty_(EU2012)#Classic|Classic]] or [[Difficulty_(EU2012)#Impossible|Impossible]] difficulty.
| align="center" | 20 [[FIle:Gamescore.png]]
| align="center" | Silver
| You must only use one soldier, and it is not recommended that you have [[Difficulty_(EU2012)#Ironman|Ironman]] mode turned on while going for this achievement. Taking control of additional units via [[Psionic_(EU2012)|Mind Control]] is allowed. Heavy or Assault reccomended. An early Small Scout UFO crash is ideal. Most quickly done on Classic softcore with the Not Created Equally second wave option, just reroll the starting Meld Tutorial mission until you get an Assault squaddie with 80+ Aim after the first mission, you'll soon have a Small Scout. Now add Medkit and Assault Rifle and... Save. Often.
|-
|[[Image:Bada_Boom_(EU2012).jpg]]
!Bada Boom
|Kill 50 aliens with explosive weapons.
| align="center" | 10 [[FIle:Gamescore.png]]
| align="center" | Bronze
|
|-
|[[Image:Welcoming_Committee_(EU2012).jpg]]
!Welcoming Committee
|Kill 150 aliens.
| align="center" | 20 [[FIle:Gamescore.png]]
| align="center" | Bronze
|
|-
|[[Image:Pale_Horse_(EU2012).jpg]]
!Pale Horse
|Kill 500 aliens.
| align="center" | 50 [[FIle:Gamescore.png]]
| align="center" | Silver
|This can be done over several playthroughs.
|-
|[[Image:Shooting_Stars_(EU2012).jpg]]
!Shooting Stars
|Shoot down 40 UFOs.
| align="center" | 35 [[FIle:Gamescore.png]]
| align="center" | Silver
|This can be done over several playthroughs.
|-
|[[Image:Aint_No_Cavalry_Comin_(EU2012).jpg]]
!Ain't No Cavalry Comin'
|Have a soldier survive every mission in a full game.
| align="center" | 50 [[FIle:Gamescore.png]]
| align="center" | Silver
|One soldier must participate in every mission undertaken in the game, from the tutorial or first mission to the final mission. If they miss one (e.g. due to being stuck in the infirmary) then the achievement becomes void.
|-
|[[Image:As_A_Scalpel_(EU2012).jpg]]
!As A Scalpel
|Earn the "Excellent" rating in every performance category on a [[Missions_(EU2012)#Alien_Terror_Attack|terror mission]].
| align="center" | 25 [[FIle:Gamescore.png]]
| align="center" | Bronze
|At minimum you must save 14 civilians to get an excellent rating in the third category, and lose no XCOM soldiers to get excellent in the second category.
|-
|[[Image:Edison_(EU2012).jpg]]
!Edison
|In a single game, complete every [[Research_(EU2012)#Projects|research project]].
| align="center" | 25 [[FIle:Gamescore.png]]
| align="center" | Bronze
|
|-
|[[Image:Angel_of_Death_(EU2012).jpg]]
!Angel of Death
|Kill an alien while flying. Single Player only.
| align="center" | 10 [[FIle:Gamescore.png]]
| align="center" | Bronze
| Archangel Armor or HoverSHIV, of course.
|-
|[[Image:All_Employees_Must_Wash_Hands_(EU2012).jpg]]
!All Employees Must Wash Hands
|In a single game, complete every [[Research_(EU2012)#Autopsies|autopsy]].
| align="center" | 10 [[FIle:Gamescore.png]]
| align="center" | Bronze
|
|-
|[[Image:Beyond_the_Veil_(EU2012).jpg]]
!Beyond the Veil
|Find a soldier with the Gift.
| align="center" | 10 [[FIle:Gamescore.png]]
| align="center" | Bronze
|Obtained through story progression.
|-
|[[Image:Prisoner_of_War_(EU2012).jpg]]
!Prisoner of War
|[[Arc_Thrower_(EU2012)|Capture]] a live alien.
| align="center" | 10 [[FIle:Gamescore.png]]
| align="center" | Bronze
|Obtained through story progression.
|-
|[[Image:The_Gatekeeper_(EU2012).jpg]]
!The Gatekeeper
|Stun an [[Outsider_(EU2012)|Outsider]].
| align="center" | 10 [[FIle:Gamescore.png]]
| align="center" | Bronze
|Obtained through story progression.
|-
|[[Image:X_Marks_the_Spot_(EU2012).jpg]]
!X Marks the Spot
|Uncover the [[Storyline_(EU2012)#Assault_the_Alien_Base|alien base's]] location.
| align="center" | 10 [[FIle:Gamescore.png]]
| align="center" | Bronze
|Obtained through story progression.
|-
|[[Image:See_All_Know_All_(EU2012).jpg]]
!See All, Know All
|Build the [[Hyperwave_Relay_(EU2012)|Hyperwave Relay]].
| align="center" | 10 [[FIle:Gamescore.png]]
| align="center" | Bronze
|Obtained through story progression.
|-
|[[Image:On_the_Shoulders_of_Giants_(EU2012).jpg]]
!On the Shoulders of Giants
|Build the [[Gollop_Chamber_(EU2012)|Gollop Chamber]].
| align="center" | 10 [[FIle:Gamescore.png]]
| align="center" | Bronze
|Obtained through story progression.
|-
|[[Image:Ride_the_Lightning_(EU2012).jpg]]
!Ride the Lightning
|Build a [[Firestorm_(EU2012)|Firestorm]].
| align="center" | 10 [[FIle:Gamescore.png]]
| align="center" | Bronze
|
|-
|[[Image:Eye_in_the_Sky_(EU2012).jpg]]
!Eye in the Sky
|Launch a [[Satellite_(EU2012)|Satellite]].
| align="center" | 5 [[FIle:Gamescore.png]]
| align="center" | Bronze
|
|-
|[[Image:All_Together_Now_(EU2012).jpg]]
!All Together Now
|Get [[Satellite_(EU2012)|satellite]] coverage over every country in one continent.
| align="center" | 10 [[FIle:Gamescore.png]]
| align="center" | Bronze
|
|-
|[[Image:Hunter_Killer_(EU2012).jpg]]
!Hunter/Killer
|In a single game, shoot down one of each [[UFOs_(EU2012)|alien craft]].
| align="center" | 15 [[FIle:Gamescore.png]]
| align="center" | Bronze
|Modules are helpful in taking down Battleships. Also, you ''can'' send more than 1 Interceptor after a single UFO, but they have to take turns (previous one has to return to base or be destroyed, before sending the next).
|-
|[[Image:Man_No_More_(EU2012).jpg]]
!Man No More
|Build a suit of powered [[Armour_(EU2012)|armor]].
| align="center" | 10 [[FIle:Gamescore.png]]
| align="center" | Bronze
|
|-
|[[Image:Bubonic_(EU2012).jpg]]
!Bubonic
|Play a [[Multiplayer_(EU2012)|multiplayer]] match against someone with this achievement.
| align="center" | -
| align="center" | -
|Only exists for PC players, replacing [[#Poison Control|Poison Control]].
|-
|[[Image:Bubonic_(EU2012).jpg]]
!Poison Control
|Cure poison on five soldiers in a single mission. Single player only.
| align="center" | 10 [[FIle:Gamescore.png]]
| align="center" | Bronze
|Only exists for console players, replacing [[#Bubonic|Bubonic]]. You may cure the same soldier five times to earn this achievement. Note that [[Thin Man (EU2012)|Thin Men]] release poison on death, which is much easier to use then relying on them to fire poison spit.
|-
|[[Image:We_Happy_Few_(EU2012).jpg]]
!We Happy Few
|Complete a mission without losing a soldier.
| align="center" | 10 [[FIle:Gamescore.png]]
| align="center" | Bronze
|
|-
|[[Image:The_Hardest_Road_(EU2012).jpg]]
!The Hardest Road
|Advance one soldier to [[Soldiers_(EU2012)#Ranks|Colonel rank]].
| align="center" | 10 [[FIle:Gamescore.png]]
| align="center" | Silver
|
|-
|[[Image:Worth_Every_Penny_(EU2012).jpg]]
!Worth Every Penny
|Acquire 1000 credits in one month.
| align="center" | 20 [[FIle:Gamescore.png]]
| align="center" | Bronze
| Most easily done with global satellite coverage.
|-
|[[Image:Oppenheimer_(EU2012).jpg]]
!Oppenheimer
|Staff the research labs with 80 scientists.
| align="center" | 20 [[FIle:Gamescore.png]]
| align="center" | Bronze
|
|-
|[[Image:One_Gun_at_a_Time_(EU2012).jpg]]
!One Gun at a Time
|Staff the engineering department with 80 engineers.
| align="center" | 20 [[FIle:Gamescore.png]]
| align="center" | Bronze
|
|-
|[[Image:Skunkworks_(EU2012).jpg]]
!Skunkworks
|In a single game, complete every [[Foundry_(EU2012)|Foundry]] project.
| align="center" | 20 [[FIle:Gamescore.png]]
| align="center" | Bronze
| "Skunk Works" is the alias of Lockheed Martin's Advanced Development Programs division, responsible for the SR-71 "Blackbird" jet.
|-
|[[Image:You_Have_5_Seconds_to_Comply_(EU2012).jpg]]
!You Have 5 Seconds to Comply
|Build a [[SHIV_(EU2012)|S.H.I.V.]]
| align="center" | 10 [[FIle:Gamescore.png]]
| align="center" | Bronze
| [http://www.youtube.com/watch?v=xMMyVKm9BjM]
|-
|[[Image:Theory_(EU2012).jpg]]
!Theory...
|Build a [[Laboratory_(EU2012)|laboratory]].
| align="center" | 10 [[FIle:Gamescore.png]]
| align="center" | Bronze
|
|-
|[[Image:and_Practice_(EU2012).jpg]]
!...and Practice
|Build a [[Workshop_(EU2012)|workshop]].
| align="center" | 10 [[FIle:Gamescore.png]]
| align="center" | Silver
|
|-
|[[Image:Wet_Work_(EU2012).jpg]]
!Wet Work
|Complete a Very Difficult [[Missions_(EU2012)#Alien_Abductions|abduction mission]] in five turns or less on [[Difficulty_(EU2012)#Classic|Classic]] or [[Difficulty_(EU2012)#Impossible|Impossible]].
| align="center" | 10 [[FIle:Gamescore.png]]
| align="center" | Bronze
|Once you're familiar with the size of some of the different [[Maps (EU2012)|maps]] in the game, wait until you recognise that you've been dropped into a small one before attempting this.
|-
|[[Image:A_Continental_Fellow_(EU2012).jpg]]
!A Continental Fellow
|Win a game from each of the 5 starting locations.
| align="center" | 50 [[FIle:Gamescore.png]]
| align="center" | Silver
|Five separate games must be completed, with your starting base situated in each of the different continents. Surprisingly, Steam statistics reports this as having among the lowest completion rates, even below Finest Hour and No Looking Back completion.
|-
|[[Image:What_Wonders_Await_(EU2012).jpg]]
!What Wonders Await
|Complete a [[Research_(EU2012)#Projects|research project]].
| align="center" | 5 [[FIle:Gamescore.png]]
| align="center" | Bronze
|
|-
|[[Image:Up_and_Running_(EU2012).jpg]]
!Up and Running
|Build a [[Engineering_(EU2012)#Build_Facilities|base facility]].
| align="center" | 5 [[FIle:Gamescore.png]]
| align="center" | Bronze
|
|-
|[[Image:Combat_Ready_(EU2012).jpg]]
!Combat Ready
|Build an [[Engineering_(EU2012)#Build_Items|item]].
| align="center" | 5 [[FIle:Gamescore.png]]
| align="center" | Bronze
|
|-
|[[Image:Drums_in_the_Deep_(EU2012).jpg]]
!Drums in the Deep
|Gain access to the lowest level in your base.
| align="center" | 10 [[FIle:Gamescore.png]]
| align="center" | Bronze
| "Drums in the Deep South," a 1951 film, involved a Confederate artillery brigade entrenched in Devil's Mountain, with the Union forces (land)mining into the rock to blow the mountaintop off entirely. May also refer to "The Lord of the Rings" where the Dwarves of Moria describe their last stand: "We cannot get out. The end comes. Drums, drums in the deep. They are coming."
|-
|[[Image:Happy_to_Oblige_(EU2012).jpg]]
!Happy to Oblige
|Fulfil a [[Missions_(EU2012)#Council_Missions|Council request]].
| align="center" | 15 [[FIle:Gamescore.png]]
| align="center" | Bronze
|
|-
|[[Image:And_Hells_Coming_With_Me_(EU2012).jpg]]
!And Hell's Coming With Me
|Successfully assault an [[Storyline_(EU2012)#Assault_the_crashed_Overseer_UFO|Overseer UFO]].
| align="center" | 10 [[FIle:Gamescore.png]]
| align="center" | Bronze
|Obtained through story progression.
|-
|[[Image:Off_My_Planet_(EU2012).jpg]]
!Off My Planet
|Recover a [[Hyperwave Relay (EU2012)|Hyperwave Beacon]].
| align="center" | 25 [[FIle:Gamescore.png]]
| align="center" | Silver
|Obtained through story progression.
|-
|[[Image:Tables_Turned_(EU2012).jpg]]
!Tables Turned
|Shoot down a [[UFOs_(EU2012)|UFO]].
| align="center" | 10 [[FIle:Gamescore.png]]
| align="center" | Bronze
|
|-
|[[Image:And_So_It_Begins_(EU2012).jpg]]
!And So It Begins...
|Complete the tutorial mission.
| align="center" | 15 [[FIle:Gamescore.png]]
| align="center" | Bronze
|[[Difficulty_(EU2012)#Tutorial_Mode|Tutorial mode]] must be enabled (not on Impossible Difficulty).
|-
|[[Image:The_Volunteer_(EU2012).jpg]]
!The Volunteer
|Make contact with the Ethereal hive mind.
| align="center" | 10 [[FIle:Gamescore.png]]
| align="center" | Bronze
|Obtained through story progression.
|-
|[[Image:Flight_of_the_valkyries_(EU2012).jpg]]
!Flight of the Valkyries
|Complete a mission with an all female squad. Single player only.
| align="center" | 10 [[FIle:Gamescore.png]]
| align="center" | Bronze
|Can be obtained on your very first mission (without tutorial) depending on soldier generation.
|-
|}

==Slingshot==
{| class="wikitable sortable" width="100%" style="text-align: center
|-
! width="50px" | Image
! width="15%" | Name
! width="20%" | Description
! width="10%" | Xbox Gamerscore
! width="10%" | PS3 Trophy
! width="auto" | Notes
|-
!colspan=6 |The following five achievements require the [[Slingshot_DLC_(EU2012)|Slingshot DLC]].
|-
|[[Image:New_Friend_(EU2012).jpg]]
!New Friend
|Complete [[Low_Friends_(EU2012)|Friends in Low Places]].
| align="center" | 10 [[FIle:Gamescore.png]]
| align="center" | Bronze
|
|-
|[[Image:Bait_the_Hook_(EU2012).jpg]]
!Bait the Hook
|Complete [[CnfndLight_(EU2012)|Confounding Light]].
| align="center" | 10 [[FIle:Gamescore.png]]
| align="center" | Bronze
|
|-
|[[Image:The_Bigger_They_Are_(EU2012).jpg]]
!The Bigger They Are
|Complete [[Gangplank_(EU2012)|Gangplank]].
| align="center" | 20 [[FIle:Gamescore.png]]
| align="center" | Silver
|
|-
|[[Image:Rising_Dragon_(EU2012).jpg]]
!Rising Dragon
|Take your new ally into the final challenge.
| align="center" | 30 [[FIle:Gamescore.png]]
| align="center" | Gold
|[[Shaojie_Zhang_(EU2012)|Shaojie Zhang]] must attend the final mission of the campaign (as opposed to the final mission of the Slingshot DLC), does not need to be The Volunteer. Make him more suitable for endgame by purchasing OTS's Iron Will before leveling him. Second Wave's "Hidden Potential" might also give him larger stat increases.
|-
|[[Image:All_Aboard_(EU2012).jpg]]
!All Aboard!
|Complete [[CnfndLight_(EU2012)|Confounding Light]] with three or more turns left.
| align="center" | 30 [[FIle:Gamescore.png]]
| align="center" | Silver
|Not all aliens need to be killed: simply place the 4 transmitters, and get 1 soldier into the train conductor's cabin.
|-
|}

==Enemy Within DLC==

{| class="wikitable sortable" width="100%" style="text-align: center
|-
! width="50px" | Image
! width="15%" | Name
! width="20%" | Description
! width="10%" | Xbox Gamerscore
! width="10%" | PS3 Trophy
! width="auto" | Notes
|-
!colspan=6 |The following 30 achievements require the [[XCOM: Enemy Within DLC (EU2012)|Enemy Within DLC]].
|-
|[[Image:Anger Management (EU2012).jpg]]
!Anger Management
|Proc [[Gene_Mods_(EU2012)#Adrenal_Neurosympathy|Combat Rush]] on the entire squad (min. 4)
| align="center" | 20 [[FIle:Gamescore.png]]
| align="center" |
| Have at least 1 soldier (easier with 2) with the Adrenal Neurosympathy genetic mod on a mission. 'Pheromones' have significant range, so no need to risk Grenade Bait formations; just be close enough to have all squad members to be affected.
|-
|[[Image:Rise of the Machines (EU2012).jpg]]
!Rise of the Machines
|Field a squad consisting entirely of [[MEC Trooper (EU2012)|augmented soldiers]] and [[S.H.I.V. (EU2012)|SHIVs]] (min. 4) and win the mission
| align="center" | 20 [[FIle:Gamescore.png]]
| align="center" |
|
|-
|[[Image:Mutatis Mutandis (EU2012).jpg]]
!Mutatis Mutandis
|Field a squad where all members have at least two [[Gene_Mods_(EU2012)|modifications]] (min. 4) and win the mission
| align="center" | 20 [[FIle:Gamescore.png]]
| align="center" |
|
|-
|[[Image:Mental Minefield (EU2012).jpg]]
!Mental Minefield
|Kill an enemy as it is psionically attacking you in single player
| align="center" | 40 [[FIle:Gamescore.png]]
| align="center" |
| [[Gene_Mods_(EU2012)#Neural_Feedback|Neural Feedback's]] base damage is 7, about double if your soldier wins the Will Save roll. Weaken the Sectoid Commander/Ethereal before it's turn.
|-
|[[Image:Tingling Sensation (EU2012).jpg]]
!Tingling Sensation
|Kill an unseen enemy detected by a specially modified soldier in single player
| align="center" | 40 [[FIle:Gamescore.png]]
| align="center" |
| In battle, soldiers with [[Gene_Mods_(EU2012)#Bioelectric_Skin|Bioelectric Skin]] can detect enemies behind doors and walls and such. Use of high explosives (and hoping it's a low-HP alien) is the easiest way to get this.
|-
|[[Image:Steel Martyr (EU2012).jpg]]
!Steel Martyr
|Deploy [[MEC-3 Paladin (EU2012)|three tactical subsystems]] on a single soldier in single player
| align="center" | 40 [[FIle:Gamescore.png]]
| align="center" |
| Fully upgrade a MEC unit's Power Armor
|-
|[[Image:Enemy Within (EU2012).jpg]]
!Enemy Within
|Get a Soldier to have 5 modifications in single player
| align="center" | 20 [[FIle:Gamescore.png]]
| align="center" |
|
|-
|[[Image:Who Needs Limbs (EU2012).jpg]]
!Who Needs Limbs?
|Augment a soldier in single player
| align="center" | 20 [[FIle:Gamescore.png]]
| align="center" |
|
|-
|[[Image:A Little Bit Alien (EU2012).jpg]]
!A Little Bit Alien
|Modify a soldier in single player
| align="center" | 20 [[FIle:Gamescore.png]]
| align="center" |
|
|-
|[[Image:Mind the Step (EU2012).jpg]]
!Mind the Step
|Jump two stories in one move in single player
| align="center" | 20 [[FIle:Gamescore.png]]
| align="center" |
| [[Gene_Mods_(EU2012)#Muscle_Fiber_Density|Muscle Fiber Density]] Gen Mod. Find a map with two buildings of differing heights adjacent to each other. Easy.
|-
|[[Image:Someone Your Own Size (EU2012).jpg]]
!Someone Your Own Size
|Kill a [[Berserker (EU2012)|Muton Berserker]] in melee combat in single player
| align="center" | 20 [[FIle:Gamescore.png]]
| align="center" |
| MEC unit with Kinetic Punch
|-
|[[Image:The Meld Squad (EU2012).jpg]]
!The Meld Squad
|Field a fully enhanced squad and win the mission
| align="center" | 20 [[FIle:Gamescore.png]]
| align="center" |
| Gen Modded squad, at least one each. Essentialy the prereq to Mutatis Mutandis
|-
|[[Image:By Our Powers Combined (EU2012).jpg]]
!By Our Powers Combined
|Field a squad with 4 augmented soldiers, each with a different base ability and win the mission
| align="center" | 40 [[FIle:Gamescore.png]]
| align="center" |
| Requires 4 MEC soldiers who were originally one of each class. Can be done with Rise Of The Machines.
|-
|[[Image:Nice Cover (EU2012).jpg]]
!Nice Cover
|Use Collateral Damage to blow up a car in single player
| align="center" | 20 [[FIle:Gamescore.png]]
| align="center" |
| Requires a MEC soldier
|-
|[[Image:Taking A Load Off (EU2012).jpg]]
!Taking A Load Off
|Stop a squad member from suffocating in single player
| align="center" | 20 [[FIle:Gamescore.png]]
| align="center" |
|
|-
|[[Image:Shieldbuster (EU2012).jpg]]
!Shieldbuster
|Eliminate an enemy's shield and kill it on the same turn in single player
| align="center" | 20 [[FIle:Gamescore.png]]
| align="center" |
|
|-
|[[Image:Guardian of Earth (EU2012).jpg]]
!Guardian of Earth
|Designate a highly decorated soldier as the Volunteer
| align="center" | 100 [[FIle:Gamescore.png]]
| align="center" |
| [[Medals (EU2012)|Medals]] are acquired through missions. There seems to be a limit on how many medals can be acquired. Riskiest medal is the one that requires a soldier to die or be Critically Wounded. After the cap is reached, it seems no more are given. Best way to obtain this Achievement is to save 1 of each medal until you have your PSI Soldier and then give him the 5 medals before making him the Volunteer.
|-
|[[Image:Pain in the Neck (EU2012).jpg]]
!Pain in the Neck
|Cause an enemy to suicide
| align="center" | 40 [[FIle:Gamescore.png]]
| align="center" |
|This is done by successfully stunning an EXALT enemy using an Arc Thrower
|-
|[[Image:An Army Of Four (EU2012).jpg]]
!An Army Of Four
|Beat the game without buying a Squad Size upgrade (Classic+ difficulty)
| align="center" | 100 [[FIle:Gamescore.png]]
| align="center" |
|
|-
|[[Image:Solid Prospect (EU2012).jpg]]
!Solid Prospect
|Complete Deluge
| align="center" | 20 [[FIle:Gamescore.png]]
| align="center" |
|[[Progeny]] (Slingshot type Council mission) A fight across a dam that's on the brink of collapsing. Advance across the top of the dam and secure the transport vehicle on the far side. Wiping out all aliens is not required.
|-
|[[Image:Great_Minds_Think_Alike_(EU2012).jpg]]
!Ours are the Furies
|Complete Furies
| align="center" | 20 [[FIle:Gamescore.png]]
| align="center" |
| Progeny (Slingshot type Council mission) A landed Abductor in a snowy level: there is a unique command console in the middle room, just outside the bridge's door. Destroy or deactivate it.
|-
|[[Image:Remington (EU2012).jpg]]
!Remington… Max Remington
|Have your special-duty soldier kill three enemies in the same mission
| align="center" | 40 [[FIle:Gamescore.png]]
| align="center" |
| Flanking and grenades help, especially if, with Training Roulette, they're a pistol-carrying class with Grenadier (normally only Heavies). Tactical Rigging from the Foundry is also a big help. Having your full-kit soldiers soften targets is key. Pistol foundry projects are extremely helpful as well, laser or plasma depending on EXALT's tech.
|-
|[[Image:Elite Defense (EU2012).jpg]]
!Elite Defense
|Beat a new special mission without losing any assets
| align="center" | 40 [[FIle:Gamescore.png]]
| align="center" |
|Simply lock down the Encoder and kill all EXALT forces. They can't do anything to the Transmitter even if they find it before breaking the Encoder.
|-
|[[Image:G’day (EU2012).jpg]]
!G’day
|Kill an elite enemy Sniper with one of your own snipers in single player
| align="center" | 20 [[FIle:Gamescore.png]]
| align="center" |
| Elite Snipers will be carrying the EXALT version of the Laser Sniper Rifle. http://www.tf2sounds.com/1207
|-
|[[Image:Regenerate This (EU2012).jpg]]
!Regenerate This
|Kill an elite enemy Medic with explosive damage in single player
| align="center" | 20 [[FIle:Gamescore.png]]
| align="center" |
| Elite Medics will be carrying the EXALT Laser Assault Rifle
|-
|[[Image:All Hands on Deck (EU2012).jpg]]
!All Hands on Deck
|Get at least 4 kills with XCOM Base Security personnel
| align="center" | 20 [[FIle:Gamescore.png]]
| align="center" |
| Base Security are in blue-tint armor. They're essentially Rookies, so beware Panic chains. Their Assault Rifles have a base damage of 4, so they're 1 point less useless than what you're saddled with in the first mission. The easiest way to get this is to get Tactical Rigging so they carry two frag grenades and throw them around liberally at low HP aliens.
|-
|[[Image:Apotheosis Denied (EU2012).jpg]]
!Apotheosis Denied
|Deal with the newest global threat
| align="center" | 100 [[FIle:Gamescore.png]]
| align="center" |
| After "Where In The World", clear out the EXALT base
|-
|[[Image:They Shall Not Pass (EU2012).jpg]]
!They Shall Not Pass
|Eliminate all alien waves
| align="center" | 20 [[FIle:Gamescore.png]]
| align="center" |
| Base Defense
|-
|[[Image:Zom-B-Gone (EU2012).jpg]]
!Zom-B-Gone
|Eradicate the infestation
| align="center" | 20 [[FIle:Gamescore.png]]
| align="center" |
| Complete [[Site Recon (EU2012)|Site Recon]], aka "Operation: Run Like A Bitch"
|-
|[[Image:Where in The World (EU2012).jpg]]
!Where in the World
|Make certain of the new threat's location
| align="center" | 40 [[FIle:Gamescore.png]]
| align="center" |
| Either through Intelligence scans or in response to EXALT attacks (at the great risk of lost money, lost research, and Panic gains), sucessfully complete at least 3 covert operations to gain clues to open the chance to accuse a country of harboring the EXALT base. You can do more Covert ops untill all 15 other countries are deduced out (or savescum and go one by one)
|}

==Removed==
{| class="wikitable sortable" width="100%" style="text-align: center
|-
! width="50px" | Image
! width="15%" | Name
! width="auto" | Description
! width="10%" | Xbox Gamerscore
! width="10%" | PS3 Trophy
! width="auto" | Notes
|-
!colspan=6 |The following five achievements were removed from Steam 8th Jan 2013. Two of them have returned in the Enemy Within DLC with different names ('''Disaster Averted''' as '''Solid Prospect''' and '''Great Minds Think Alike''' as '''Ours Are The Furies''')
|-
|[[Image:No_Sweat_(EU2012).jpg]]
!No Sweat
|Complete Deluge without activating more than 2 valves.
| align="center" | ???
| align="center" | ???
| Deluge in EW has a turn limit, due to it being on a damaged Dam: opening valves releases water, thus extending the time before it breaks. While possible to complete without opening any valves at all, it will not unlock the achievement, and thus, has truly been removed
|-
|[[Image:Saved_to_Savior_(EU2012).jpg]]
!Saved to Savior
|Have your newest ally volunteer for the most difficult duty.
| align="center" | ???
| align="center" | ???
|The "newest ally" referred to was likely to've been called "Annette". Possibly an early name for Anna Sing? Icon and description suggest somthing like Zhang's Rising Dragon, except for "Annette" to be the Volunteer, specifically.
|-
|[[Image:Disaster_Averted_(EU2012).jpg]]
!Disaster Averted
|Complete Deluge.
| align="center" | ???
| align="center" | ???
|
|-
|[[Image:The_Chase_Is_On_(EU2012).jpg]]
!The Chase Is On
|Complete Portent.
| align="center" | ???
| align="center" | ???
| Replaced with the achievementless mission of finding/escorting the EXALT survivor of a damaged convoy
|-
|[[Image:Great_Minds_Think_Alike_(EU2012).jpg]]
!Great Minds Think Alike
|Complete Furies.
| align="center" | ???
| align="center" | ???
|
|}

{{StyleEU2012}}
[[Category: Enemy Unknown (2012)]]

Achievements (EU2012)

2014-08-10T12:54:11Z

Winterheart: /* Enemy Within DLC */

'''Achievements''' are separate goals or personal achievement trophies that you can earn as you play the game. These are obtained automatically through the normal progression of the game or by performing difficult tasks under harsh conditions.

These achievements provide no direct in-game benefits and can be collected at your leisure. They are mainly provided for players that wish to collect everything that can be collected and to perform everything that can be conceivably performed in the game.

The achievement lists are slightly different depending on the platform you're playing on - [[#Bubonic|Bubonic]] is only available to PC players, whilst [[#Poison Control|Poison Control]] is only for consolers. The [[#You Win|You Win]] trophy is PS3-only. [http://steamcommunity.com/stats/XCOMEnemyUnknown/achievements/ Steam offers a list of achievements with the percentages of PC players who have obtained them].

Unless otherwise specified, all achievements must be obtained whilst playing single player, but under any [[Difficulty (EU2012)|difficulty]]. Use of [[Hero (EU2012)|heroes]] will disable achievements for your campaign (even for missions that they don't attend). Achievement titles in dark cells are hidden until unlocked.
</noinclude>

==Original XCOM: Enemy Unknown==

{| class="wikitable sortable" width="100%" style="text-align: center
|-
! width="50px" | Image
! width="15%" | Name
! width="20%" | Description
! width="10%" | Xbox Gamerscore
! width="10%" | PS3 Trophy
! width="auto" | Notes
|-
|[[Image:You_Win_(EU2012).jpg]]
!You Win
|Gain all trophies.
| align="center" | -
| align="center" | Platinum
|Obtained after all other trophies are earned. PS3 only.
|-
|[[Image:Meet_New_People_Then_Kill_Them_(EU2012).jpg]]
!Meet New People. Then Kill Them.
|Win a [[Multiplayer_(EU2012)|multiplayer]] match.
| align="center" | 25 [[FIle:Gamescore.png]]
| align="center" | Bronze
|Doesn't have to be ranked.
|-
|[[Image:No_Looking_Back_(EU2012).jpg]]
!No Looking Back
| Beat the game in [[Difficulty_(EU2012)#Ironman|Ironman]] on [[Difficulty_(EU2012)#Classic|Classic]] or [[Difficulty_(EU2012)#Impossible|Impossible]] Difficulty.
| align="center" | 100 [[FIle:Gamescore.png]]
| align="center" | Gold
|
|-
|[[Image:Xavier_(EU2012).jpg]]
!Xavier
|Mind control an [[Ethereal_(EU2012)|Ethereal]] alien. Single player only.
| align="center" | 10 [[FIle:Gamescore.png]]
| align="center" | Silver
| Psi Armor, Mind Shield, and a Psi Inspiration boost make this feasable.
|-
|[[Image:Humanitys_Savior_(EU2012).jpg]]
!Humanity's Savior
|Beat the game on any difficulty.
| align="center" | 30 [[FIle:Gamescore.png]]
| align="center" | Bronze
|
|-
|[[Image:Earth_First_(EU2012).jpg]]
!Earth First
|Beat the game on [[Difficulty_(EU2012)#Classic|Classic]] difficulty.
| align="center" | 60 [[FIle:Gamescore.png]]
| align="center" | Silver
|
|-
|[[Image:Our_Finest_Hour_(EU2012).jpg]]
!Our Finest Hour
|Complete the game on [[Difficulty_(EU2012)#Impossible|Impossible]] difficulty.
| align="center" | 90 [[FIle:Gamescore.png]]
| align="center" | Gold
| Note that it doesn't say "on Ironman."
|-
|[[Image:Lone_Wolf_(EU2012).jpg]]
!Lone Wolf
|Clear a [[Missions_(EU2012)#UFO_Crash_Site|UFO Crash Site]] with one soldier on [[Difficulty_(EU2012)#Classic|Classic]] or [[Difficulty_(EU2012)#Impossible|Impossible]] difficulty.
| align="center" | 20 [[FIle:Gamescore.png]]
| align="center" | Silver
| You must only use one soldier, and it is not recommended that you have [[Difficulty_(EU2012)#Ironman|Ironman]] mode turned on while going for this achievement. Taking control of additional units via [[Psionic_(EU2012)|Mind Control]] is allowed. Heavy or Assault reccomended. An early Small Scout UFO crash is ideal. Most quickly done on Classic softcore with the Not Created Equally second wave option, just reroll the starting Meld Tutorial mission until you get an Assault squaddie with 80+ Aim after the first mission, you'll soon have a Small Scout. Now add Medkit and Assault Rifle and... Save. Often.
|-
|[[Image:Bada_Boom_(EU2012).jpg]]
!Bada Boom
|Kill 50 aliens with explosive weapons.
| align="center" | 10 [[FIle:Gamescore.png]]
| align="center" | Bronze
|
|-
|[[Image:Welcoming_Committee_(EU2012).jpg]]
!Welcoming Committee
|Kill 150 aliens.
| align="center" | 20 [[FIle:Gamescore.png]]
| align="center" | Bronze
|
|-
|[[Image:Pale_Horse_(EU2012).jpg]]
!Pale Horse
|Kill 500 aliens.
| align="center" | 50 [[FIle:Gamescore.png]]
| align="center" | Silver
|This can be done over several playthroughs.
|-
|[[Image:Shooting_Stars_(EU2012).jpg]]
!Shooting Stars
|Shoot down 40 UFOs.
| align="center" | 35 [[FIle:Gamescore.png]]
| align="center" | Silver
|This can be done over several playthroughs.
|-
|[[Image:Aint_No_Cavalry_Comin_(EU2012).jpg]]
!Ain't No Cavalry Comin'
|Have a soldier survive every mission in a full game.
| align="center" | 50 [[FIle:Gamescore.png]]
| align="center" | Silver
|One soldier must participate in every mission undertaken in the game, from the tutorial or first mission to the final mission. If they miss one (e.g. due to being stuck in the infirmary) then the achievement becomes void.
|-
|[[Image:As_A_Scalpel_(EU2012).jpg]]
!As A Scalpel
|Earn the "Excellent" rating in every performance category on a [[Missions_(EU2012)#Alien_Terror_Attack|terror mission]].
| align="center" | 25 [[FIle:Gamescore.png]]
| align="center" | Bronze
|At minimum you must save 14 civilians to get an excellent rating in the third category, and lose no XCOM soldiers to get excellent in the second category.
|-
|[[Image:Edison_(EU2012).jpg]]
!Edison
|In a single game, complete every [[Research_(EU2012)#Projects|research project]].
| align="center" | 25 [[FIle:Gamescore.png]]
| align="center" | Bronze
|
|-
|[[Image:Angel_of_Death_(EU2012).jpg]]
!Angel of Death
|Kill an alien while flying. Single Player only.
| align="center" | 10 [[FIle:Gamescore.png]]
| align="center" | Bronze
| Archangel Armor or HoverSHIV, of course.
|-
|[[Image:All_Employees_Must_Wash_Hands_(EU2012).jpg]]
!All Employees Must Wash Hands
|In a single game, complete every [[Research_(EU2012)#Autopsies|autopsy]].
| align="center" | 10 [[FIle:Gamescore.png]]
| align="center" | Bronze
|
|-
|[[Image:Beyond_the_Veil_(EU2012).jpg]]
!Beyond the Veil
|Find a soldier with the Gift.
| align="center" | 10 [[FIle:Gamescore.png]]
| align="center" | Bronze
|Obtained through story progression.
|-
|[[Image:Prisoner_of_War_(EU2012).jpg]]
!Prisoner of War
|[[Arc_Thrower_(EU2012)|Capture]] a live alien.
| align="center" | 10 [[FIle:Gamescore.png]]
| align="center" | Bronze
|Obtained through story progression.
|-
|[[Image:The_Gatekeeper_(EU2012).jpg]]
!The Gatekeeper
|Stun an [[Outsider_(EU2012)|Outsider]].
| align="center" | 10 [[FIle:Gamescore.png]]
| align="center" | Bronze
|Obtained through story progression.
|-
|[[Image:X_Marks_the_Spot_(EU2012).jpg]]
!X Marks the Spot
|Uncover the [[Storyline_(EU2012)#Assault_the_Alien_Base|alien base's]] location.
| align="center" | 10 [[FIle:Gamescore.png]]
| align="center" | Bronze
|Obtained through story progression.
|-
|[[Image:See_All_Know_All_(EU2012).jpg]]
!See All, Know All
|Build the [[Hyperwave_Relay_(EU2012)|Hyperwave Relay]].
| align="center" | 10 [[FIle:Gamescore.png]]
| align="center" | Bronze
|Obtained through story progression.
|-
|[[Image:On_the_Shoulders_of_Giants_(EU2012).jpg]]
!On the Shoulders of Giants
|Build the [[Gollop_Chamber_(EU2012)|Gollop Chamber]].
| align="center" | 10 [[FIle:Gamescore.png]]
| align="center" | Bronze
|Obtained through story progression.
|-
|[[Image:Ride_the_Lightning_(EU2012).jpg]]
!Ride the Lightning
|Build a [[Firestorm_(EU2012)|Firestorm]].
| align="center" | 10 [[FIle:Gamescore.png]]
| align="center" | Bronze
|
|-
|[[Image:Eye_in_the_Sky_(EU2012).jpg]]
!Eye in the Sky
|Launch a [[Satellite_(EU2012)|Satellite]].
| align="center" | 5 [[FIle:Gamescore.png]]
| align="center" | Bronze
|
|-
|[[Image:All_Together_Now_(EU2012).jpg]]
!All Together Now
|Get [[Satellite_(EU2012)|satellite]] coverage over every country in one continent.
| align="center" | 10 [[FIle:Gamescore.png]]
| align="center" | Bronze
|
|-
|[[Image:Hunter_Killer_(EU2012).jpg]]
!Hunter/Killer
|In a single game, shoot down one of each [[UFOs_(EU2012)|alien craft]].
| align="center" | 15 [[FIle:Gamescore.png]]
| align="center" | Bronze
|Modules are helpful in taking down Battleships. Also, you ''can'' send more than 1 Interceptor after a single UFO, but they have to take turns (previous one has to return to base or be destroyed, before sending the next).
|-
|[[Image:Man_No_More_(EU2012).jpg]]
!Man No More
|Build a suit of powered [[Armour_(EU2012)|armor]].
| align="center" | 10 [[FIle:Gamescore.png]]
| align="center" | Bronze
|
|-
|[[Image:Bubonic_(EU2012).jpg]]
!Bubonic
|Play a [[Multiplayer_(EU2012)|multiplayer]] match against someone with this achievement.
| align="center" | -
| align="center" | -
|Only exists for PC players, replacing [[#Poison Control|Poison Control]].
|-
|[[Image:Bubonic_(EU2012).jpg]]
!Poison Control
|Cure poison on five soldiers in a single mission. Single player only.
| align="center" | 10 [[FIle:Gamescore.png]]
| align="center" | Bronze
|Only exists for console players, replacing [[#Bubonic|Bubonic]]. You may cure the same soldier five times to earn this achievement. Note that [[Thin Man (EU2012)|Thin Men]] release poison on death, which is much easier to use then relying on them to fire poison spit.
|-
|[[Image:We_Happy_Few_(EU2012).jpg]]
!We Happy Few
|Complete a mission without losing a soldier.
| align="center" | 10 [[FIle:Gamescore.png]]
| align="center" | Bronze
|
|-
|[[Image:The_Hardest_Road_(EU2012).jpg]]
!The Hardest Road
|Advance one soldier to [[Soldiers_(EU2012)#Ranks|Colonel rank]].
| align="center" | 10 [[FIle:Gamescore.png]]
| align="center" | Silver
|
|-
|[[Image:Worth_Every_Penny_(EU2012).jpg]]
!Worth Every Penny
|Acquire 1000 credits in one month.
| align="center" | 20 [[FIle:Gamescore.png]]
| align="center" | Bronze
| Most easily done with global satellite coverage.
|-
|[[Image:Oppenheimer_(EU2012).jpg]]
!Oppenheimer
|Staff the research labs with 80 scientists.
| align="center" | 20 [[FIle:Gamescore.png]]
| align="center" | Bronze
|
|-
|[[Image:One_Gun_at_a_Time_(EU2012).jpg]]
!One Gun at a Time
|Staff the engineering department with 80 engineers.
| align="center" | 20 [[FIle:Gamescore.png]]
| align="center" | Bronze
|
|-
|[[Image:Skunkworks_(EU2012).jpg]]
!Skunkworks
|In a single game, complete every [[Foundry_(EU2012)|Foundry]] project.
| align="center" | 20 [[FIle:Gamescore.png]]
| align="center" | Bronze
| "Skunk Works" is the alias of Lockheed Martin's Advanced Development Programs division, responsible for the SR-71 "Blackbird" jet.
|-
|[[Image:You_Have_5_Seconds_to_Comply_(EU2012).jpg]]
!You Have 5 Seconds to Comply
|Build a [[SHIV_(EU2012)|S.H.I.V.]]
| align="center" | 10 [[FIle:Gamescore.png]]
| align="center" | Bronze
| [http://www.youtube.com/watch?v=xMMyVKm9BjM]
|-
|[[Image:Theory_(EU2012).jpg]]
!Theory...
|Build a [[Laboratory_(EU2012)|laboratory]].
| align="center" | 10 [[FIle:Gamescore.png]]
| align="center" | Bronze
|
|-
|[[Image:and_Practice_(EU2012).jpg]]
!...and Practice
|Build a [[Workshop_(EU2012)|workshop]].
| align="center" | 10 [[FIle:Gamescore.png]]
| align="center" | Silver
|
|-
|[[Image:Wet_Work_(EU2012).jpg]]
!Wet Work
|Complete a Very Difficult [[Missions_(EU2012)#Alien_Abductions|abduction mission]] in five turns or less on [[Difficulty_(EU2012)#Classic|Classic]] or [[Difficulty_(EU2012)#Impossible|Impossible]].
| align="center" | 10 [[FIle:Gamescore.png]]
| align="center" | Bronze
|Once you're familiar with the size of some of the different [[Maps (EU2012)|maps]] in the game, wait until you recognise that you've been dropped into a small one before attempting this.
|-
|[[Image:A_Continental_Fellow_(EU2012).jpg]]
!A Continental Fellow
|Win a game from each of the 5 starting locations.
| align="center" | 50 [[FIle:Gamescore.png]]
| align="center" | Silver
|Five separate games must be completed, with your starting base situated in each of the different continents. Surprisingly, Steam statistics reports this as having among the lowest completion rates, even below Finest Hour and No Looking Back completion.
|-
|[[Image:What_Wonders_Await_(EU2012).jpg]]
!What Wonders Await
|Complete a [[Research_(EU2012)#Projects|research project]].
| align="center" | 5 [[FIle:Gamescore.png]]
| align="center" | Bronze
|
|-
|[[Image:Up_and_Running_(EU2012).jpg]]
!Up and Running
|Build a [[Engineering_(EU2012)#Build_Facilities|base facility]].
| align="center" | 5 [[FIle:Gamescore.png]]
| align="center" | Bronze
|
|-
|[[Image:Combat_Ready_(EU2012).jpg]]
!Combat Ready
|Build an [[Engineering_(EU2012)#Build_Items|item]].
| align="center" | 5 [[FIle:Gamescore.png]]
| align="center" | Bronze
|
|-
|[[Image:Drums_in_the_Deep_(EU2012).jpg]]
!Drums in the Deep
|Gain access to the lowest level in your base.
| align="center" | 10 [[FIle:Gamescore.png]]
| align="center" | Bronze
| "Drums in the Deep South," a 1951 film, involved a Confederate artillery brigade entrenched in Devil's Mountain, with the Union forces (land)mining into the rock to blow the mountaintop off entirely. May also refer to "The Lord of the Rings" where the Dwarves of Moria describe their last stand: "We cannot get out. The end comes. Drums, drums in the deep. They are coming."
|-
|[[Image:Happy_to_Oblige_(EU2012).jpg]]
!Happy to Oblige
|Fulfil a [[Missions_(EU2012)#Council_Missions|Council request]].
| align="center" | 15 [[FIle:Gamescore.png]]
| align="center" | Bronze
|
|-
|[[Image:And_Hells_Coming_With_Me_(EU2012).jpg]]
!And Hell's Coming With Me
|Successfully assault an [[Storyline_(EU2012)#Assault_the_crashed_Overseer_UFO|Overseer UFO]].
| align="center" | 10 [[FIle:Gamescore.png]]
| align="center" | Bronze
|Obtained through story progression.
|-
|[[Image:Off_My_Planet_(EU2012).jpg]]
!Off My Planet
|Recover a [[Hyperwave Relay (EU2012)|Hyperwave Beacon]].
| align="center" | 25 [[FIle:Gamescore.png]]
| align="center" | Silver
|Obtained through story progression.
|-
|[[Image:Tables_Turned_(EU2012).jpg]]
!Tables Turned
|Shoot down a [[UFOs_(EU2012)|UFO]].
| align="center" | 10 [[FIle:Gamescore.png]]
| align="center" | Bronze
|
|-
|[[Image:And_So_It_Begins_(EU2012).jpg]]
!And So It Begins...
|Complete the tutorial mission.
| align="center" | 15 [[FIle:Gamescore.png]]
| align="center" | Bronze
|[[Difficulty_(EU2012)#Tutorial_Mode|Tutorial mode]] must be enabled (not on Impossible Difficulty).
|-
|[[Image:The_Volunteer_(EU2012).jpg]]
!The Volunteer
|Make contact with the Ethereal hive mind.
| align="center" | 10 [[FIle:Gamescore.png]]
| align="center" | Bronze
|Obtained through story progression.
|-
|[[Image:Flight_of_the_valkyries_(EU2012).jpg]]
!Flight of the Valkyries
|Complete a mission with an all female squad. Single player only.
| align="center" | 10 [[FIle:Gamescore.png]]
| align="center" | Bronze
|Can be obtained on your very first mission (without tutorial) depending on soldier generation.
|-
|}

==Slingshot==
{| class="wikitable sortable" width="100%" style="text-align: center
|-
! width="50px" | Image
! width="15%" | Name
! width="20%" | Description
! width="10%" | Xbox Gamerscore
! width="10%" | PS3 Trophy
! width="auto" | Notes
|-
!colspan=6 |The following five achievements require the [[Slingshot_DLC_(EU2012)|Slingshot DLC]].
|-
|[[Image:New_Friend_(EU2012).jpg]]
!New Friend
|Complete [[Low_Friends_(EU2012)|Friends in Low Places]].
| align="center" | 10 [[FIle:Gamescore.png]]
| align="center" | Bronze
|
|-
|[[Image:Bait_the_Hook_(EU2012).jpg]]
!Bait the Hook
|Complete [[CnfndLight_(EU2012)|Confounding Light]].
| align="center" | 10 [[FIle:Gamescore.png]]
| align="center" | Bronze
|
|-
|[[Image:The_Bigger_They_Are_(EU2012).jpg]]
!The Bigger They Are
|Complete [[Gangplank_(EU2012)|Gangplank]].
| align="center" | 20 [[FIle:Gamescore.png]]
| align="center" | Silver
|
|-
|[[Image:Rising_Dragon_(EU2012).jpg]]
!Rising Dragon
|Take your new ally into the final challenge.
| align="center" | 30 [[FIle:Gamescore.png]]
| align="center" | Gold
|[[Shaojie_Zhang_(EU2012)|Shaojie Zhang]] must attend the final mission of the campaign (as opposed to the final mission of the Slingshot DLC), does not need to be The Volunteer. Make him more suitable for endgame by purchasing OTS's Iron Will before leveling him. Second Wave's "Hidden Potential" might also give him larger stat increases.
|-
|[[Image:All_Aboard_(EU2012).jpg]]
!All Aboard!
|Complete [[CnfndLight_(EU2012)|Confounding Light]] with three or more turns left.
| align="center" | 30 [[FIle:Gamescore.png]]
| align="center" | Silver
|Not all aliens need to be killed: simply place the 4 transmitters, and get 1 soldier into the train conductor's cabin.
|-
|}

==Enemy Within DLC==

{| class="wikitable sortable" width="100%" style="text-align: center
|-
! width="50px" | Image
! width="15%" | Name
! width="20%" | Description
! width="10%" | Xbox Gamerscore
! width="10%" | PS3 Trophy
! width="auto" | Notes
|-
!colspan=6 |The following 30 achievements require the [[XCOM: Enemy Within DLC (EU2012)|Enemy Within DLC]].
|-
|[[Image:Anger Management (EU2012).jpg]]
!Anger Management
|Proc [[Gene_Mods_(EU2012)#Adrenal_Neurosympathy|Combat Rush]] on the entire squad (min. 4)
| align="center" | 20 [[FIle:Gamescore.png]]
| align="center" |
| Have at least 1 soldier (easier with 2) with the Adrenal Neurosympathy genetic mod on a mission. 'Pheromones' have significant range, so no need to risk Grenade Bait formations; just be close enough to have all squad members to be affected.
|-
|[[Image:Rise of the Machines (EU2012).jpg]]
!Rise of the Machines
|Field a squad consisting entirely of [[MEC Trooper (EU2012)|augmented soldiers]] and [[S.H.I.V. (EU2012|SHIVs]] (min. 4) and win the mission
| align="center" | 20 [[FIle:Gamescore.png]]
| align="center" |
|
|-
|[[Image:Mutatis Mutandis (EU2012).jpg]]
!Mutatis Mutandis
|Field a squad where all members have at least two [[Gene_Mods_(EU2012)|modifications]] (min. 4) and win the mission
| align="center" | 20 [[FIle:Gamescore.png]]
| align="center" |
|
|-
|[[Image:Mental Minefield (EU2012).jpg]]
!Mental Minefield
|Kill an enemy as it is psionically attacking you in single player
| align="center" | 40 [[FIle:Gamescore.png]]
| align="center" |
| [[Gene_Mods_(EU2012)#Neural_Feedback|Neural Feedback's]] base damage is 7, about double if your soldier wins the Will Save roll. Weaken the Sectoid Commander/Ethereal before it's turn.
|-
|[[Image:Tingling Sensation (EU2012).jpg]]
!Tingling Sensation
|Kill an unseen enemy detected by a specially modified soldier in single player
| align="center" | 40 [[FIle:Gamescore.png]]
| align="center" |
| In battle, soldiers with [[Gene_Mods_(EU2012)#Bioelectric_Skin|Bioelectric Skin]] can detect enemies behind doors and walls and such. Use of high explosives (and hoping it's a low-HP alien) is the easiest way to get this.
|-
|[[Image:Steel Martyr (EU2012).jpg]]
!Steel Martyr
|Deploy [[MEC-3 Paladin (EU2012)|three tactical subsystems]] on a single soldier in single player
| align="center" | 40 [[FIle:Gamescore.png]]
| align="center" |
| Fully upgrade a MEC unit's Power Armor
|-
|[[Image:Enemy Within (EU2012).jpg]]
!Enemy Within
|Get a Soldier to have 5 modifications in single player
| align="center" | 20 [[FIle:Gamescore.png]]
| align="center" |
|
|-
|[[Image:Who Needs Limbs (EU2012).jpg]]
!Who Needs Limbs?
|Augment a soldier in single player
| align="center" | 20 [[FIle:Gamescore.png]]
| align="center" |
|
|-
|[[Image:A Little Bit Alien (EU2012).jpg]]
!A Little Bit Alien
|Modify a soldier in single player
| align="center" | 20 [[FIle:Gamescore.png]]
| align="center" |
|
|-
|[[Image:Mind the Step (EU2012).jpg]]
!Mind the Step
|Jump two stories in one move in single player
| align="center" | 20 [[FIle:Gamescore.png]]
| align="center" |
| [[Gene_Mods_(EU2012)#Muscle_Fiber_Density|Muscle Fiber Density]] Gen Mod. Find a map with two buildings of differing heights adjacent to each other. Easy.
|-
|[[Image:Someone Your Own Size (EU2012).jpg]]
!Someone Your Own Size
|Kill a [[Berserker (EU2012)|Muton Berserker]] in melee combat in single player
| align="center" | 20 [[FIle:Gamescore.png]]
| align="center" |
| MEC unit with Kinetic Punch
|-
|[[Image:The Meld Squad (EU2012).jpg]]
!The Meld Squad
|Field a fully enhanced squad and win the mission
| align="center" | 20 [[FIle:Gamescore.png]]
| align="center" |
| Gen Modded squad, at least one each. Essentialy the prereq to Mutatis Mutandis
|-
|[[Image:By Our Powers Combined (EU2012).jpg]]
!By Our Powers Combined
|Field a squad with 4 augmented soldiers, each with a different base ability and win the mission
| align="center" | 40 [[FIle:Gamescore.png]]
| align="center" |
| Requires 4 MEC soldiers who were originally one of each class. Can be done with Rise Of The Machines.
|-
|[[Image:Nice Cover (EU2012).jpg]]
!Nice Cover
|Use Collateral Damage to blow up a car in single player
| align="center" | 20 [[FIle:Gamescore.png]]
| align="center" |
| Requires a MEC soldier
|-
|[[Image:Taking A Load Off (EU2012).jpg]]
!Taking A Load Off
|Stop a squad member from suffocating in single player
| align="center" | 20 [[FIle:Gamescore.png]]
| align="center" |
|
|-
|[[Image:Shieldbuster (EU2012).jpg]]
!Shieldbuster
|Eliminate an enemy's shield and kill it on the same turn in single player
| align="center" | 20 [[FIle:Gamescore.png]]
| align="center" |
|
|-
|[[Image:Guardian of Earth (EU2012).jpg]]
!Guardian of Earth
|Designate a highly decorated soldier as the Volunteer
| align="center" | 100 [[FIle:Gamescore.png]]
| align="center" |
| [[Medals (EU2012)|Medals]] are acquired through missions. There seems to be a limit on how many medals can be acquired. Riskiest medal is the one that requires a soldier to die or be Critically Wounded. After the cap is reached, it seems no more are given. Best way to obtain this Achievement is to save 1 of each medal until you have your PSI Soldier and then give him the 5 medals before making him the Volunteer.
|-
|[[Image:Pain in the Neck (EU2012).jpg]]
!Pain in the Neck
|Cause an enemy to suicide
| align="center" | 40 [[FIle:Gamescore.png]]
| align="center" |
|This is done by successfully stunning an EXALT enemy using an Arc Thrower
|-
|[[Image:An Army Of Four (EU2012).jpg]]
!An Army Of Four
|Beat the game without buying a Squad Size upgrade (Classic+ difficulty)
| align="center" | 100 [[FIle:Gamescore.png]]
| align="center" |
|
|-
|[[Image:Solid Prospect (EU2012).jpg]]
!Solid Prospect
|Complete Deluge
| align="center" | 20 [[FIle:Gamescore.png]]
| align="center" |
|[[Progeny]] (Slingshot type Council mission) A fight across a dam that's on the brink of collapsing. Advance across the top of the dam and secure the transport vehicle on the far side. Wiping out all aliens is not required.
|-
|[[Image:Great_Minds_Think_Alike_(EU2012).jpg]]
!Ours are the Furies
|Complete Furies
| align="center" | 20 [[FIle:Gamescore.png]]
| align="center" |
| Progeny (Slingshot type Council mission) A landed Abductor in a snowy level: there is a unique command console in the middle room, just outside the bridge's door. Destroy or deactivate it.
|-
|[[Image:Remington (EU2012).jpg]]
!Remington… Max Remington
|Have your special-duty soldier kill three enemies in the same mission
| align="center" | 40 [[FIle:Gamescore.png]]
| align="center" |
| Flanking and grenades help, especially if, with Training Roulette, they're a pistol-carrying class with Grenadier (normally only Heavies). Tactical Rigging from the Foundry is also a big help. Having your full-kit soldiers soften targets is key. Pistol foundry projects are extremely helpful as well, laser or plasma depending on EXALT's tech.
|-
|[[Image:Elite Defense (EU2012).jpg]]
!Elite Defense
|Beat a new special mission without losing any assets
| align="center" | 40 [[FIle:Gamescore.png]]
| align="center" |
|Simply lock down the Encoder and kill all EXALT forces. They can't do anything to the Transmitter even if they find it before breaking the Encoder.
|-
|[[Image:G’day (EU2012).jpg]]
!G’day
|Kill an elite enemy Sniper with one of your own snipers in single player
| align="center" | 20 [[FIle:Gamescore.png]]
| align="center" |
| Elite Snipers will be carrying the EXALT version of the Laser Sniper Rifle. http://www.tf2sounds.com/1207
|-
|[[Image:Regenerate This (EU2012).jpg]]
!Regenerate This
|Kill an elite enemy Medic with explosive damage in single player
| align="center" | 20 [[FIle:Gamescore.png]]
| align="center" |
| Elite Medics will be carrying the EXALT Laser Assault Rifle
|-
|[[Image:All Hands on Deck (EU2012).jpg]]
!All Hands on Deck
|Get at least 4 kills with XCOM Base Security personnel
| align="center" | 20 [[FIle:Gamescore.png]]
| align="center" |
| Base Security are in blue-tint armor. They're essentially Rookies, so beware Panic chains. Their Assault Rifles have a base damage of 4, so they're 1 point less useless than what you're saddled with in the first mission. The easiest way to get this is to get Tactical Rigging so they carry two frag grenades and throw them around liberally at low HP aliens.
|-
|[[Image:Apotheosis Denied (EU2012).jpg]]
!Apotheosis Denied
|Deal with the newest global threat
| align="center" | 100 [[FIle:Gamescore.png]]
| align="center" |
| After "Where In The World", clear out the EXALT base
|-
|[[Image:They Shall Not Pass (EU2012).jpg]]
!They Shall Not Pass
|Eliminate all alien waves
| align="center" | 20 [[FIle:Gamescore.png]]
| align="center" |
| Base Defense
|-
|[[Image:Zom-B-Gone (EU2012).jpg]]
!Zom-B-Gone
|Eradicate the infestation
| align="center" | 20 [[FIle:Gamescore.png]]
| align="center" |
| Complete [[Site Recon (EU2012)|Site Recon]], aka "Operation: Run Like A Bitch"
|-
|[[Image:Where in The World (EU2012).jpg]]
!Where in the World
|Make certain of the new threat's location
| align="center" | 40 [[FIle:Gamescore.png]]
| align="center" |
| Either through Intelligence scans or in response to EXALT attacks (at the great risk of lost money, lost research, and Panic gains), sucessfully complete at least 3 covert operations to gain clues to open the chance to accuse a country of harboring the EXALT base. You can do more Covert ops untill all 15 other countries are deduced out (or savescum and go one by one)
|}

==Removed==
{| class="wikitable sortable" width="100%" style="text-align: center
|-
! width="50px" | Image
! width="15%" | Name
! width="auto" | Description
! width="10%" | Xbox Gamerscore
! width="10%" | PS3 Trophy
! width="auto" | Notes
|-
!colspan=6 |The following five achievements were removed from Steam 8th Jan 2013. Two of them have returned in the Enemy Within DLC with different names ('''Disaster Averted''' as '''Solid Prospect''' and '''Great Minds Think Alike''' as '''Ours Are The Furies''')
|-
|[[Image:No_Sweat_(EU2012).jpg]]
!No Sweat
|Complete Deluge without activating more than 2 valves.
| align="center" | ???
| align="center" | ???
| Deluge in EW has a turn limit, due to it being on a damaged Dam: opening valves releases water, thus extending the time before it breaks. While possible to complete without opening any valves at all, it will not unlock the achievement, and thus, has truly been removed
|-
|[[Image:Saved_to_Savior_(EU2012).jpg]]
!Saved to Savior
|Have your newest ally volunteer for the most difficult duty.
| align="center" | ???
| align="center" | ???
|The "newest ally" referred to was likely to've been called "Annette". Possibly an early name for Anna Sing? Icon and description suggest somthing like Zhang's Rising Dragon, except for "Annette" to be the Volunteer, specifically.
|-
|[[Image:Disaster_Averted_(EU2012).jpg]]
!Disaster Averted
|Complete Deluge.
| align="center" | ???
| align="center" | ???
|
|-
|[[Image:The_Chase_Is_On_(EU2012).jpg]]
!The Chase Is On
|Complete Portent.
| align="center" | ???
| align="center" | ???
| Replaced with the achievementless mission of finding/escorting the EXALT survivor of a damaged convoy
|-
|[[Image:Great_Minds_Think_Alike_(EU2012).jpg]]
!Great Minds Think Alike
|Complete Furies.
| align="center" | ???
| align="center" | ???
|
|}

{{StyleEU2012}}
[[Category: Enemy Unknown (2012)]]

Achievements (EU2012)

2014-08-10T11:52:23Z

Winterheart:

'''Achievements''' are separate goals or personal achievement trophies that you can earn as you play the game. These are obtained automatically through the normal progression of the game or by performing difficult tasks under harsh conditions.

These achievements provide no direct in-game benefits and can be collected at your leisure. They are mainly provided for players that wish to collect everything that can be collected and to perform everything that can be conceivably performed in the game.

The achievement lists are slightly different depending on the platform you're playing on - [[#Bubonic|Bubonic]] is only available to PC players, whilst [[#Poison Control|Poison Control]] is only for consolers. The [[#You Win|You Win]] trophy is PS3-only. [http://steamcommunity.com/stats/XCOMEnemyUnknown/achievements/ Steam offers a list of achievements with the percentages of PC players who have obtained them].

Unless otherwise specified, all achievements must be obtained whilst playing single player, but under any [[Difficulty (EU2012)|difficulty]]. Use of [[Hero (EU2012)|heroes]] will disable achievements for your campaign (even for missions that they don't attend). Achievement titles in dark cells are hidden until unlocked.
</noinclude>

==Original XCOM: Enemy Unknown==

{| class="wikitable sortable" width="100%" style="text-align: center
|-
! width="50px" | Image
! width="15%" | Name
! width="20%" | Description
! width="10%" | Xbox Gamerscore
! width="10%" | PS3 Trophy
! width="auto" | Notes
|-
|[[Image:You_Win_(EU2012).jpg]]
!You Win
|Gain all trophies.
| align="center" | -
| align="center" | Platinum
|Obtained after all other trophies are earned. PS3 only.
|-
|[[Image:Meet_New_People_Then_Kill_Them_(EU2012).jpg]]
!Meet New People. Then Kill Them.
|Win a [[Multiplayer_(EU2012)|multiplayer]] match.
| align="center" | 25 [[FIle:Gamescore.png]]
| align="center" | Bronze
|Doesn't have to be ranked.
|-
|[[Image:No_Looking_Back_(EU2012).jpg]]
!No Looking Back
| Beat the game in [[Difficulty_(EU2012)#Ironman|Ironman]] on [[Difficulty_(EU2012)#Classic|Classic]] or [[Difficulty_(EU2012)#Impossible|Impossible]] Difficulty.
| align="center" | 100 [[FIle:Gamescore.png]]
| align="center" | Gold
|
|-
|[[Image:Xavier_(EU2012).jpg]]
!Xavier
|Mind control an [[Ethereal_(EU2012)|Ethereal]] alien. Single player only.
| align="center" | 10 [[FIle:Gamescore.png]]
| align="center" | Silver
| Psi Armor, Mind Shield, and a Psi Inspiration boost make this feasable.
|-
|[[Image:Humanitys_Savior_(EU2012).jpg]]
!Humanity's Savior
|Beat the game on any difficulty.
| align="center" | 30 [[FIle:Gamescore.png]]
| align="center" | Bronze
|
|-
|[[Image:Earth_First_(EU2012).jpg]]
!Earth First
|Beat the game on [[Difficulty_(EU2012)#Classic|Classic]] difficulty.
| align="center" | 60 [[FIle:Gamescore.png]]
| align="center" | Silver
|
|-
|[[Image:Our_Finest_Hour_(EU2012).jpg]]
!Our Finest Hour
|Complete the game on [[Difficulty_(EU2012)#Impossible|Impossible]] difficulty.
| align="center" | 90 [[FIle:Gamescore.png]]
| align="center" | Gold
| Note that it doesn't say "on Ironman."
|-
|[[Image:Lone_Wolf_(EU2012).jpg]]
!Lone Wolf
|Clear a [[Missions_(EU2012)#UFO_Crash_Site|UFO Crash Site]] with one soldier on [[Difficulty_(EU2012)#Classic|Classic]] or [[Difficulty_(EU2012)#Impossible|Impossible]] difficulty.
| align="center" | 20 [[FIle:Gamescore.png]]
| align="center" | Silver
| You must only use one soldier, and it is not recommended that you have [[Difficulty_(EU2012)#Ironman|Ironman]] mode turned on while going for this achievement. Taking control of additional units via [[Psionic_(EU2012)|Mind Control]] is allowed. Heavy or Assault reccomended. An early Small Scout UFO crash is ideal. Most quickly done on Classic softcore with the Not Created Equally second wave option, just reroll the starting Meld Tutorial mission until you get an Assault squaddie with 80+ Aim after the first mission, you'll soon have a Small Scout. Now add Medkit and Assault Rifle and... Save. Often.
|-
|[[Image:Bada_Boom_(EU2012).jpg]]
!Bada Boom
|Kill 50 aliens with explosive weapons.
| align="center" | 10 [[FIle:Gamescore.png]]
| align="center" | Bronze
|
|-
|[[Image:Welcoming_Committee_(EU2012).jpg]]
!Welcoming Committee
|Kill 150 aliens.
| align="center" | 20 [[FIle:Gamescore.png]]
| align="center" | Bronze
|
|-
|[[Image:Pale_Horse_(EU2012).jpg]]
!Pale Horse
|Kill 500 aliens.
| align="center" | 50 [[FIle:Gamescore.png]]
| align="center" | Silver
|This can be done over several playthroughs.
|-
|[[Image:Shooting_Stars_(EU2012).jpg]]
!Shooting Stars
|Shoot down 40 UFOs.
| align="center" | 35 [[FIle:Gamescore.png]]
| align="center" | Silver
|This can be done over several playthroughs.
|-
|[[Image:Aint_No_Cavalry_Comin_(EU2012).jpg]]
!Ain't No Cavalry Comin'
|Have a soldier survive every mission in a full game.
| align="center" | 50 [[FIle:Gamescore.png]]
| align="center" | Silver
|One soldier must participate in every mission undertaken in the game, from the tutorial or first mission to the final mission. If they miss one (e.g. due to being stuck in the infirmary) then the achievement becomes void.
|-
|[[Image:As_A_Scalpel_(EU2012).jpg]]
!As A Scalpel
|Earn the "Excellent" rating in every performance category on a [[Missions_(EU2012)#Alien_Terror_Attack|terror mission]].
| align="center" | 25 [[FIle:Gamescore.png]]
| align="center" | Bronze
|At minimum you must save 14 civilians to get an excellent rating in the third category, and lose no XCOM soldiers to get excellent in the second category.
|-
|[[Image:Edison_(EU2012).jpg]]
!Edison
|In a single game, complete every [[Research_(EU2012)#Projects|research project]].
| align="center" | 25 [[FIle:Gamescore.png]]
| align="center" | Bronze
|
|-
|[[Image:Angel_of_Death_(EU2012).jpg]]
!Angel of Death
|Kill an alien while flying. Single Player only.
| align="center" | 10 [[FIle:Gamescore.png]]
| align="center" | Bronze
| Archangel Armor or HoverSHIV, of course.
|-
|[[Image:All_Employees_Must_Wash_Hands_(EU2012).jpg]]
!All Employees Must Wash Hands
|In a single game, complete every [[Research_(EU2012)#Autopsies|autopsy]].
| align="center" | 10 [[FIle:Gamescore.png]]
| align="center" | Bronze
|
|-
|[[Image:Beyond_the_Veil_(EU2012).jpg]]
!Beyond the Veil
|Find a soldier with the Gift.
| align="center" | 10 [[FIle:Gamescore.png]]
| align="center" | Bronze
|Obtained through story progression.
|-
|[[Image:Prisoner_of_War_(EU2012).jpg]]
!Prisoner of War
|[[Arc_Thrower_(EU2012)|Capture]] a live alien.
| align="center" | 10 [[FIle:Gamescore.png]]
| align="center" | Bronze
|Obtained through story progression.
|-
|[[Image:The_Gatekeeper_(EU2012).jpg]]
!The Gatekeeper
|Stun an [[Outsider_(EU2012)|Outsider]].
| align="center" | 10 [[FIle:Gamescore.png]]
| align="center" | Bronze
|Obtained through story progression.
|-
|[[Image:X_Marks_the_Spot_(EU2012).jpg]]
!X Marks the Spot
|Uncover the [[Storyline_(EU2012)#Assault_the_Alien_Base|alien base's]] location.
| align="center" | 10 [[FIle:Gamescore.png]]
| align="center" | Bronze
|Obtained through story progression.
|-
|[[Image:See_All_Know_All_(EU2012).jpg]]
!See All, Know All
|Build the [[Hyperwave_Relay_(EU2012)|Hyperwave Relay]].
| align="center" | 10 [[FIle:Gamescore.png]]
| align="center" | Bronze
|Obtained through story progression.
|-
|[[Image:On_the_Shoulders_of_Giants_(EU2012).jpg]]
!On the Shoulders of Giants
|Build the [[Gollop_Chamber_(EU2012)|Gollop Chamber]].
| align="center" | 10 [[FIle:Gamescore.png]]
| align="center" | Bronze
|Obtained through story progression.
|-
|[[Image:Ride_the_Lightning_(EU2012).jpg]]
!Ride the Lightning
|Build a [[Firestorm_(EU2012)|Firestorm]].
| align="center" | 10 [[FIle:Gamescore.png]]
| align="center" | Bronze
|
|-
|[[Image:Eye_in_the_Sky_(EU2012).jpg]]
!Eye in the Sky
|Launch a [[Satellite_(EU2012)|Satellite]].
| align="center" | 5 [[FIle:Gamescore.png]]
| align="center" | Bronze
|
|-
|[[Image:All_Together_Now_(EU2012).jpg]]
!All Together Now
|Get [[Satellite_(EU2012)|satellite]] coverage over every country in one continent.
| align="center" | 10 [[FIle:Gamescore.png]]
| align="center" | Bronze
|
|-
|[[Image:Hunter_Killer_(EU2012).jpg]]
!Hunter/Killer
|In a single game, shoot down one of each [[UFOs_(EU2012)|alien craft]].
| align="center" | 15 [[FIle:Gamescore.png]]
| align="center" | Bronze
|Modules are helpful in taking down Battleships. Also, you ''can'' send more than 1 Interceptor after a single UFO, but they have to take turns (previous one has to return to base or be destroyed, before sending the next).
|-
|[[Image:Man_No_More_(EU2012).jpg]]
!Man No More
|Build a suit of powered [[Armour_(EU2012)|armor]].
| align="center" | 10 [[FIle:Gamescore.png]]
| align="center" | Bronze
|
|-
|[[Image:Bubonic_(EU2012).jpg]]
!Bubonic
|Play a [[Multiplayer_(EU2012)|multiplayer]] match against someone with this achievement.
| align="center" | -
| align="center" | -
|Only exists for PC players, replacing [[#Poison Control|Poison Control]].
|-
|[[Image:Bubonic_(EU2012).jpg]]
!Poison Control
|Cure poison on five soldiers in a single mission. Single player only.
| align="center" | 10 [[FIle:Gamescore.png]]
| align="center" | Bronze
|Only exists for console players, replacing [[#Bubonic|Bubonic]]. You may cure the same soldier five times to earn this achievement. Note that [[Thin Man (EU2012)|Thin Men]] release poison on death, which is much easier to use then relying on them to fire poison spit.
|-
|[[Image:We_Happy_Few_(EU2012).jpg]]
!We Happy Few
|Complete a mission without losing a soldier.
| align="center" | 10 [[FIle:Gamescore.png]]
| align="center" | Bronze
|
|-
|[[Image:The_Hardest_Road_(EU2012).jpg]]
!The Hardest Road
|Advance one soldier to [[Soldiers_(EU2012)#Ranks|Colonel rank]].
| align="center" | 10 [[FIle:Gamescore.png]]
| align="center" | Silver
|
|-
|[[Image:Worth_Every_Penny_(EU2012).jpg]]
!Worth Every Penny
|Acquire 1000 credits in one month.
| align="center" | 20 [[FIle:Gamescore.png]]
| align="center" | Bronze
| Most easily done with global satellite coverage.
|-
|[[Image:Oppenheimer_(EU2012).jpg]]
!Oppenheimer
|Staff the research labs with 80 scientists.
| align="center" | 20 [[FIle:Gamescore.png]]
| align="center" | Bronze
|
|-
|[[Image:One_Gun_at_a_Time_(EU2012).jpg]]
!One Gun at a Time
|Staff the engineering department with 80 engineers.
| align="center" | 20 [[FIle:Gamescore.png]]
| align="center" | Bronze
|
|-
|[[Image:Skunkworks_(EU2012).jpg]]
!Skunkworks
|In a single game, complete every [[Foundry_(EU2012)|Foundry]] project.
| align="center" | 20 [[FIle:Gamescore.png]]
| align="center" | Bronze
| "Skunk Works" is the alias of Lockheed Martin's Advanced Development Programs division, responsible for the SR-71 "Blackbird" jet.
|-
|[[Image:You_Have_5_Seconds_to_Comply_(EU2012).jpg]]
!You Have 5 Seconds to Comply
|Build a [[SHIV_(EU2012)|S.H.I.V.]]
| align="center" | 10 [[FIle:Gamescore.png]]
| align="center" | Bronze
| [http://www.youtube.com/watch?v=xMMyVKm9BjM]
|-
|[[Image:Theory_(EU2012).jpg]]
!Theory...
|Build a [[Laboratory_(EU2012)|laboratory]].
| align="center" | 10 [[FIle:Gamescore.png]]
| align="center" | Bronze
|
|-
|[[Image:and_Practice_(EU2012).jpg]]
!...and Practice
|Build a [[Workshop_(EU2012)|workshop]].
| align="center" | 10 [[FIle:Gamescore.png]]
| align="center" | Silver
|
|-
|[[Image:Wet_Work_(EU2012).jpg]]
!Wet Work
|Complete a Very Difficult [[Missions_(EU2012)#Alien_Abductions|abduction mission]] in five turns or less on [[Difficulty_(EU2012)#Classic|Classic]] or [[Difficulty_(EU2012)#Impossible|Impossible]].
| align="center" | 10 [[FIle:Gamescore.png]]
| align="center" | Bronze
|Once you're familiar with the size of some of the different [[Maps (EU2012)|maps]] in the game, wait until you recognise that you've been dropped into a small one before attempting this.
|-
|[[Image:A_Continental_Fellow_(EU2012).jpg]]
!A Continental Fellow
|Win a game from each of the 5 starting locations.
| align="center" | 50 [[FIle:Gamescore.png]]
| align="center" | Silver
|Five separate games must be completed, with your starting base situated in each of the different continents. Surprisingly, Steam statistics reports this as having among the lowest completion rates, even below Finest Hour and No Looking Back completion.
|-
|[[Image:What_Wonders_Await_(EU2012).jpg]]
!What Wonders Await
|Complete a [[Research_(EU2012)#Projects|research project]].
| align="center" | 5 [[FIle:Gamescore.png]]
| align="center" | Bronze
|
|-
|[[Image:Up_and_Running_(EU2012).jpg]]
!Up and Running
|Build a [[Engineering_(EU2012)#Build_Facilities|base facility]].
| align="center" | 5 [[FIle:Gamescore.png]]
| align="center" | Bronze
|
|-
|[[Image:Combat_Ready_(EU2012).jpg]]
!Combat Ready
|Build an [[Engineering_(EU2012)#Build_Items|item]].
| align="center" | 5 [[FIle:Gamescore.png]]
| align="center" | Bronze
|
|-
|[[Image:Drums_in_the_Deep_(EU2012).jpg]]
!Drums in the Deep
|Gain access to the lowest level in your base.
| align="center" | 10 [[FIle:Gamescore.png]]
| align="center" | Bronze
| "Drums in the Deep South," a 1951 film, involved a Confederate artillery brigade entrenched in Devil's Mountain, with the Union forces (land)mining into the rock to blow the mountaintop off entirely. May also refer to "The Lord of the Rings" where the Dwarves of Moria describe their last stand: "We cannot get out. The end comes. Drums, drums in the deep. They are coming."
|-
|[[Image:Happy_to_Oblige_(EU2012).jpg]]
!Happy to Oblige
|Fulfil a [[Missions_(EU2012)#Council_Missions|Council request]].
| align="center" | 15 [[FIle:Gamescore.png]]
| align="center" | Bronze
|
|-
|[[Image:And_Hells_Coming_With_Me_(EU2012).jpg]]
!And Hell's Coming With Me
|Successfully assault an [[Storyline_(EU2012)#Assault_the_crashed_Overseer_UFO|Overseer UFO]].
| align="center" | 10 [[FIle:Gamescore.png]]
| align="center" | Bronze
|Obtained through story progression.
|-
|[[Image:Off_My_Planet_(EU2012).jpg]]
!Off My Planet
|Recover a [[Hyperwave Relay (EU2012)|Hyperwave Beacon]].
| align="center" | 25 [[FIle:Gamescore.png]]
| align="center" | Silver
|Obtained through story progression.
|-
|[[Image:Tables_Turned_(EU2012).jpg]]
!Tables Turned
|Shoot down a [[UFOs_(EU2012)|UFO]].
| align="center" | 10 [[FIle:Gamescore.png]]
| align="center" | Bronze
|
|-
|[[Image:And_So_It_Begins_(EU2012).jpg]]
!And So It Begins...
|Complete the tutorial mission.
| align="center" | 15 [[FIle:Gamescore.png]]
| align="center" | Bronze
|[[Difficulty_(EU2012)#Tutorial_Mode|Tutorial mode]] must be enabled (not on Impossible Difficulty).
|-
|[[Image:The_Volunteer_(EU2012).jpg]]
!The Volunteer
|Make contact with the Ethereal hive mind.
| align="center" | 10 [[FIle:Gamescore.png]]
| align="center" | Bronze
|Obtained through story progression.
|-
|[[Image:Flight_of_the_valkyries_(EU2012).jpg]]
!Flight of the Valkyries
|Complete a mission with an all female squad. Single player only.
| align="center" | 10 [[FIle:Gamescore.png]]
| align="center" | Bronze
|Can be obtained on your very first mission (without tutorial) depending on soldier generation.
|-
|}

==Slingshot==
{| class="wikitable sortable" width="100%" style="text-align: center
|-
! width="50px" | Image
! width="15%" | Name
! width="20%" | Description
! width="10%" | Xbox Gamerscore
! width="10%" | PS3 Trophy
! width="auto" | Notes
|-
!colspan=6 |The following five achievements require the [[Slingshot_DLC_(EU2012)|Slingshot DLC]].
|-
|[[Image:New_Friend_(EU2012).jpg]]
!New Friend
|Complete [[Low_Friends_(EU2012)|Friends in Low Places]].
| align="center" | 10 [[FIle:Gamescore.png]]
| align="center" | Bronze
|
|-
|[[Image:Bait_the_Hook_(EU2012).jpg]]
!Bait the Hook
|Complete [[CnfndLight_(EU2012)|Confounding Light]].
| align="center" | 10 [[FIle:Gamescore.png]]
| align="center" | Bronze
|
|-
|[[Image:The_Bigger_They_Are_(EU2012).jpg]]
!The Bigger They Are
|Complete [[Gangplank_(EU2012)|Gangplank]].
| align="center" | 20 [[FIle:Gamescore.png]]
| align="center" | Silver
|
|-
|[[Image:Rising_Dragon_(EU2012).jpg]]
!Rising Dragon
|Take your new ally into the final challenge.
| align="center" | 30 [[FIle:Gamescore.png]]
| align="center" | Gold
|[[Shaojie_Zhang_(EU2012)|Shaojie Zhang]] must attend the final mission of the campaign (as opposed to the final mission of the Slingshot DLC), does not need to be The Volunteer. Make him more suitable for endgame by purchasing OTS's Iron Will before leveling him. Second Wave's "Hidden Potential" might also give him larger stat increases.
|-
|[[Image:All_Aboard_(EU2012).jpg]]
!All Aboard!
|Complete [[CnfndLight_(EU2012)|Confounding Light]] with three or more turns left.
| align="center" | 30 [[FIle:Gamescore.png]]
| align="center" | Silver
|Not all aliens need to be killed: simply place the 4 transmitters, and get 1 soldier into the train conductor's cabin.
|-
|}

==Enemy Within DLC==

{| class="wikitable sortable" width="100%" style="text-align: center
|-
! width="50px" | Image
! width="15%" | Name
! width="20%" | Description
! width="10%" | Xbox Gamerscore
! width="10%" | PS3 Trophy
! width="auto" | Notes
|-
!colspan=6 |The following 30 achievements require the [[XCOM: Enemy Within DLC (EU2012)|Enemy Within DLC]].
|-
|[[Image:Anger Management (EU2012).jpg]]
!Anger Management
|Proc Combat Rush on the entire squad (min. 4)
| align="center" | 20 [[FIle:Gamescore.png]]
| align="center" |
| Have at least 1 soldier (easier with 2) with the Adrenal Neurosympathy genetic mod on a mission. 'Pheromones' have significant range, so no need to risk Grenade Bait formations; just be close enough to have all squad members to be affected.
|-
|[[Image:Rise of the Machines (EU2012).jpg]]
!Rise of the Machines
|Field a squad consisting entirely of augmented soldiers and SHIVs (min. 4) and win the mission
| align="center" | 20 [[FIle:Gamescore.png]]
| align="center" |
|
|-
|[[Image:Mutatis Mutandis (EU2012).jpg]]
!Mutatis Mutandis
|Field a squad where all members have at least two modifications (min. 4) and win the mission
| align="center" | 20 [[FIle:Gamescore.png]]
| align="center" |
|
|-
|[[Image:Mental Minefield (EU2012).jpg]]
!Mental Minefield
|Kill an enemy as it is psionically attacking you in single player
| align="center" | 40 [[FIle:Gamescore.png]]
| align="center" |
| Neural Feedback's base damage is 7, about double if your soldier wins the Will Save roll. Weaken the Sectoid Commander/Ethereal before it's turn.
|-
|[[Image:Tingling Sensation (EU2012).jpg]]
!Tingling Sensation
|Kill an unseen enemy detected by a specially modified soldier in single player
| align="center" | 40 [[FIle:Gamescore.png]]
| align="center" |
| In battle, soldiers with Bioelectric Skin can detect enemies behind doors and walls and such. Use of high explosives (and hoping it's a low-HP alien) is the easiest way to get this.
|-
|[[Image:Steel Martyr (EU2012).jpg]]
!Steel Martyr
|Deploy three tactical subsystems on a single soldier in single player
| align="center" | 40 [[FIle:Gamescore.png]]
| align="center" |
| Fully upgrade a MEC unit's Power Armor
|-
|[[Image:Enemy Within (EU2012).jpg]]
!Enemy Within
|Get a Soldier to have 5 modifications in single player
| align="center" | 20 [[FIle:Gamescore.png]]
| align="center" |
|
|-
|[[Image:Who Needs Limbs (EU2012).jpg]]
!Who Needs Limbs?
|Augment a soldier in single player
| align="center" | 20 [[FIle:Gamescore.png]]
| align="center" |
|
|-
|[[Image:A Little Bit Alien (EU2012).jpg]]
!A Little Bit Alien
|Modify a soldier in single player
| align="center" | 20 [[FIle:Gamescore.png]]
| align="center" |
|
|-
|[[Image:Mind the Step (EU2012).jpg]]
!Mind the Step
|Jump two stories in one move in single player
| align="center" | 20 [[FIle:Gamescore.png]]
| align="center" |
| Muscle Fiber Density Gen Mod. Find a map with two buildings of differing heights adjacent to each other. Easy.
|-
|[[Image:Someone Your Own Size (EU2012).jpg]]
!Someone Your Own Size
|Kill a Muton Berserker in melee combat in single player
| align="center" | 20 [[FIle:Gamescore.png]]
| align="center" |
| MEC unit with Kinetic Punch
|-
|[[Image:The Meld Squad (EU2012).jpg]]
!The Meld Squad
|Field a fully enhanced squad and win the mission
| align="center" | 20 [[FIle:Gamescore.png]]
| align="center" |
| Gen Modded squad, at least one each. Essentialy the prereq to Mutatis Mutandis
|-
|[[Image:By Our Powers Combined (EU2012).jpg]]
!By Our Powers Combined
|Field a squad with 4 augmented soldiers, each with a different base ability and win the mission
| align="center" | 40 [[FIle:Gamescore.png]]
| align="center" |
| Requires 4 MEC soldiers who were originally one of each class. Can be done with Rise Of The Machines.
|-
|[[Image:Nice Cover (EU2012).jpg]]
!Nice Cover
|Use Collateral Damage to blow up a car in single player
| align="center" | 20 [[FIle:Gamescore.png]]
| align="center" |
| Requires a MEC soldier
|-
|[[Image:Taking A Load Off (EU2012).jpg]]
!Taking A Load Off
|Stop a squad member from suffocating in single player
| align="center" | 20 [[FIle:Gamescore.png]]
| align="center" |
|
|-
|[[Image:Shieldbuster (EU2012).jpg]]
!Shieldbuster
|Eliminate an enemy's shield and kill it on the same turn in single player
| align="center" | 20 [[FIle:Gamescore.png]]
| align="center" |
|
|-
|[[Image:Guardian of Earth (EU2012).jpg]]
!Guardian of Earth
|Designate a highly decorated soldier as the Volunteer
| align="center" | 100 [[FIle:Gamescore.png]]
| align="center" |
| Medals are acquired through missions. There seems to be a limit on how many medals can be acquired. Riskiest medal is the one that requires a soldier to die or be Critically Wounded. After the cap is reached, it seems no more are given. Best way to obtain this Achievement is to save 1 of each medal until you have your PSI Soldier and then give him the 5 medals before making him the Volunteer.
|-
|[[Image:Pain in the Neck (EU2012).jpg]]
!Pain in the Neck
|Cause an enemy to suicide
| align="center" | 40 [[FIle:Gamescore.png]]
| align="center" |
|This is done by successfully stunning an EXALT enemy using an Arc Thrower
|-
|[[Image:An Army Of Four (EU2012).jpg]]
!An Army Of Four
|Beat the game without buying a Squad Size upgrade (Classic+ difficulty)
| align="center" | 100 [[FIle:Gamescore.png]]
| align="center" |
|
|-
|[[Image:Solid Prospect (EU2012).jpg]]
!Solid Prospect
|Complete Deluge
| align="center" | 20 [[FIle:Gamescore.png]]
| align="center" |
|Progeny (Slingshot type Council mission) A fight across a dam that's on the brink of collapsing. Advance across the top of the dam and secure the transport vehicle on the far side. Wiping out all aliens is not required.
|-
|[[Image:Great_Minds_Think_Alike_(EU2012).jpg]]
!Ours are the Furies
|Complete Furies
| align="center" | 20 [[FIle:Gamescore.png]]
| align="center" |
| Progeny (Slingshot type Council mission) A landed Abductor in a snowy level: there is a unique command console in the middle room, just outside the bridge's door. Destroy or deactivate it.
|-
|[[Image:Remington (EU2012).jpg]]
!Remington… Max Remington
|Have your special-duty soldier kill three enemies in the same mission
| align="center" | 40 [[FIle:Gamescore.png]]
| align="center" |
| Flanking and grenades help, especially if, with Training Roulette, they're a pistol-carrying class with Grenadier (normally only Heavies). Tactical Rigging from the Foundry is also a big help. Having your full-kit soldiers soften targets is key. Pistol foundry projects are extremely helpful as well, laser or plasma depending on EXALT's tech.
|-
|[[Image:Elite Defense (EU2012).jpg]]
!Elite Defense
|Beat a new special mission without losing any assets
| align="center" | 40 [[FIle:Gamescore.png]]
| align="center" |
|Simply lock down the Encoder and kill all EXALT forces. They can't do anything to the Transmitter even if they find it before breaking the Encoder.
|-
|[[Image:G’day (EU2012).jpg]]
!G’day
|Kill an elite enemy Sniper with one of your own snipers in single player
| align="center" | 20 [[FIle:Gamescore.png]]
| align="center" |
| Elite Snipers will be carrying the EXALT version of the Laser Sniper Rifle.
|-
|[[Image:Regenerate This (EU2012).jpg]]
!Regenerate This
|Kill an elite enemy Medic with explosive damage in single player
| align="center" | 20 [[FIle:Gamescore.png]]
| align="center" |
| Elite Medics will be carrying the EXALT Laser Assault Rifle
|-
|[[Image:All Hands on Deck (EU2012).jpg]]
!All Hands on Deck
|Get at least 4 kills with XCOM Base Security personnel
| align="center" | 20 [[FIle:Gamescore.png]]
| align="center" |
| Base Security are in blue-tint armor. They're essentially Rookies, so beware Panic chains. Their Assault Rifles have a base damage of 4, so they're 1 point less useless than what you're saddled with in the first mission. The easiest way to get this is to get Tactical Rigging so they carry two frag grenades and throw them around liberally at low HP aliens.
|-
|[[Image:Apotheosis Denied (EU2012).jpg]]
!Apotheosis Denied
|Deal with the newest global threat
| align="center" | 100 [[FIle:Gamescore.png]]
| align="center" |
| After "Where In The World", clear out the EXALT base
|-
|[[Image:They Shall Not Pass (EU2012).jpg]]
!They Shall Not Pass
|Eliminate all alien waves
| align="center" | 20 [[FIle:Gamescore.png]]
| align="center" |
| Base Defense
|-
|[[Image:Zom-B-Gone (EU2012).jpg]]
!Zom-B-Gone
|Eradicate the infestation
| align="center" | 20 [[FIle:Gamescore.png]]
| align="center" |
| Complete [[Site Recon (EU2012)|Site Recon]], aka "Operation: Run Like A Bitch"
|-
|[[Image:Where in The World (EU2012).jpg]]
!Where in the World
|Make certain of the new threat's location
| align="center" | 40 [[FIle:Gamescore.png]]
| align="center" |
| Either through Intelligence scans or in response to EXALT attacks (at the great risk of lost money, lost research, and Panic gains), sucessfully complete at least 3 covert operations to gain clues to open the chance to accuse a country of harboring the EXALT base. You can do more Covert ops untill all 15 other countries are deduced out (or savescum and go one by one)
|}

==Removed==
{| class="wikitable sortable" width="100%" style="text-align: center
|-
! width="50px" | Image
! width="15%" | Name
! width="auto" | Description
! width="10%" | Xbox Gamerscore
! width="10%" | PS3 Trophy
! width="auto" | Notes
|-
!colspan=6 |The following five achievements were removed from Steam 8th Jan 2013. Two of them have returned in the Enemy Within DLC with different names ('''Disaster Averted''' as '''Solid Prospect''' and '''Great Minds Think Alike''' as '''Ours Are The Furies''')
|-
|[[Image:No_Sweat_(EU2012).jpg]]
!No Sweat
|Complete Deluge without activating more than 2 valves.
| align="center" | ???
| align="center" | ???
| Deluge in EW has a turn limit, due to it being on a damaged Dam: opening valves releases water, thus extending the time before it breaks. While possible to complete without opening any valves at all, it will not unlock the achievement, and thus, has truly been removed
|-
|[[Image:Saved_to_Savior_(EU2012).jpg]]
!Saved to Savior
|Have your newest ally volunteer for the most difficult duty.
| align="center" | ???
| align="center" | ???
|The "newest ally" referred to was likely to've been called "Annette". Possibly an early name for Anna Sing? Icon and description suggest somthing like Zhang's Rising Dragon, except for "Annette" to be the Volunteer, specifically.
|-
|[[Image:Disaster_Averted_(EU2012).jpg]]
!Disaster Averted
|Complete Deluge.
| align="center" | ???
| align="center" | ???
|
|-
|[[Image:The_Chase_Is_On_(EU2012).jpg]]
!The Chase Is On
|Complete Portent.
| align="center" | ???
| align="center" | ???
| Replaced with the achievementless mission of finding/escorting the EXALT survivor of a damaged convoy
|-
|[[Image:Great_Minds_Think_Alike_(EU2012).jpg]]
!Great Minds Think Alike
|Complete Furies.
| align="center" | ???
| align="center" | ???
|
|}

{{StyleEU2012}}
[[Category: Enemy Unknown (2012)]]

Ruleset Reference (OpenXcom)

2014-06-18T13:29:25Z

Winterheart: case sensitive

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]].

=== 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
|-
| '''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 only affect terrain, units will ignore it.
| 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.
| -
|-
| '''civilians'''
| Amount of civilians to deploy.
| 0
|-
| '''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.
*'''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.

=== 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]], [[Muton]]
* 1 = [[Floater]]
* 2 = [[HWP]]
* 3 = [[Cyberdisk]]
* 4 = [[Civilian]], [[Ethereal]]
* 5 = [[Sectopod]], [[Reaper]]
* 6 = [[Snakeman]]
* 7 = [[Chryssalid]]
* 8 = [[Silacoid]]
* 9 = [[Celatid]]
| 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
|-
| '''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).
| -
|}

==== 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).
| -
|-
|}

=== 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?
| 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.

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.

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.
| -
|}

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]]

Beginners Guide (OpenXcom)

2014-06-14T08:20:39Z

Winterheart: /* Basescape Intro */

=THIS PAGE IS UNDER CONSTRUCTION - CHECK BACK LATER=

This introductory guide assumes you have never seen an X-COM game before, but you can still do basic things like or open and close menus without having to be told how. If you get lost in the various interfaces - guess. It's OK.

This isn't a step-by-step tutorial, and you won't mess it up if you do something out of order. X-COM is all about open sandbox-style freedom.

==Stating a new game==
Start a new game and choose your [[Difficulty Levels|difficulty]], choose ''Beginner''.

==Base Placement==
[[File:OpenXcom - placing first base.png|thumb|Placing your first base]]
You can either pan the globe around with the controls in the box at the bottom right, by using arrow-keys, or by right-clicking anywhere on the globe to center on that location.

Now you pick where you want your first base. Look at the Radar coverage circles and the landmass within them - it's good to start out covering countries that give X-COM a lot of [[Country Funding (EU)|funding]] so either US and Canada or Europe are good options. It's not really important however, you could even put your first base in Antarctica and that would be OK too. #images

You can name your base whatever you want, or even no name at all, as long as it fits in the box. You can also change the name as often as you like.

==Geoscape Intro==
'''Interception''' brings up a list of crafts you control. Selecting a craft will allow you to give that craft orders - more on that later. You can also select craft by clicking on their home base.

'''Bases''' is covered in the next section. If you've turned on the ''custom base layout'' option then you would already be here, placing your base facilities.

'''Graphs''' provide a lot of statistical information that might look completely meaningless to you, don't worry about it. It's there for when you want it later.

'''Ufopedia''' might sound familiar, www.ufopaedia.org is not a coincidence. It's an in-game [[UFOpaedia|encyclopedia]] that will grow as you experience more of the game. Feel free to browse but don't be surprised if you don't understand the purpose of anything in there yet.

==Basescape Intro==
[[File:OpenXcom - Base layout.png|thumb|Default base layout]]

After pressing ''Bases'' in Geoscape screen you'll will get to Basescape screen.

=== Aircrafts ===

=== Research & Development ===

==Time management==

==UFO on sight!==

After some time of observation your radars will spot an UFO. You'll need bring down this aircraft with your interceptors. 

When UFO shot down and crashed on the ground, send your [[Skyranger]] with troops to crash site.

==Your First Mission==
===Meet the team===
==Battlescape Intro==

[[Category:OpenXcom]]

Beginners Guide (OpenXcom)

2014-06-14T08:14:33Z

Winterheart: /* Basescape Intro */

=THIS PAGE IS UNDER CONSTRUCTION - CHECK BACK LATER=

This introductory guide assumes you have never seen an X-COM game before, but you can still do basic things like or open and close menus without having to be told how. If you get lost in the various interfaces - guess. It's OK.

This isn't a step-by-step tutorial, and you won't mess it up if you do something out of order. X-COM is all about open sandbox-style freedom.

==Stating a new game==
Start a new game and choose your [[Difficulty Levels|difficulty]], choose ''Beginner''.

==Base Placement==
[[File:OpenXcom - placing first base.png|thumb|Placing your first base]]
You can either pan the globe around with the controls in the box at the bottom right, by using arrow-keys, or by right-clicking anywhere on the globe to center on that location.

Now you pick where you want your first base. Look at the Radar coverage circles and the landmass within them - it's good to start out covering countries that give X-COM a lot of [[Country Funding (EU)|funding]] so either US and Canada or Europe are good options. It's not really important however, you could even put your first base in Antarctica and that would be OK too. #images

You can name your base whatever you want, or even no name at all, as long as it fits in the box. You can also change the name as often as you like.

==Geoscape Intro==
'''Interception''' brings up a list of crafts you control. Selecting a craft will allow you to give that craft orders - more on that later. You can also select craft by clicking on their home base.

'''Bases''' is covered in the next section. If you've turned on the ''custom base layout'' option then you would already be here, placing your base facilities.

'''Graphs''' provide a lot of statistical information that might look completely meaningless to you, don't worry about it. It's there for when you want it later.

'''Ufopedia''' might sound familiar, www.ufopaedia.org is not a coincidence. It's an in-game [[UFOpaedia|encyclopedia]] that will grow as you experience more of the game. Feel free to browse but don't be surprised if you don't understand the purpose of anything in there yet.

==Basescape Intro==
[[File:OpenXcom - Base layout.png|thumb|Default base layout]]
=== Aircrafts ===

=== Research & Development ===

==Time management==

==UFO on sight!==

After some time of observation your radars will spot an UFO. You'll need bring down this aircraft with your interceptors. 

When UFO shot down and crashed on the ground, send your [[Skyranger]] with troops to crash site.

==Your First Mission==
===Meet the team===
==Battlescape Intro==

[[Category:OpenXcom]]

File:OpenXcom - Base layout.png

2014-06-14T08:13:14Z

Winterheart:

Beginners Guide (OpenXcom)

2014-06-14T07:52:42Z

Winterheart: /* Base Placement */

=THIS PAGE IS UNDER CONSTRUCTION - CHECK BACK LATER=

This introductory guide assumes you have never seen an X-COM game before, but you can still do basic things like or open and close menus without having to be told how. If you get lost in the various interfaces - guess. It's OK.

This isn't a step-by-step tutorial, and you won't mess it up if you do something out of order. X-COM is all about open sandbox-style freedom.

==Stating a new game==
Start a new game and choose your [[Difficulty Levels|difficulty]], choose ''Beginner''.

==Base Placement==
[[File:OpenXcom - placing first base.png|thumb|Placing your first base]]
You can either pan the globe around with the controls in the box at the bottom right, by using arrow-keys, or by right-clicking anywhere on the globe to center on that location.

Now you pick where you want your first base. Look at the Radar coverage circles and the landmass within them - it's good to start out covering countries that give X-COM a lot of [[Country Funding (EU)|funding]] so either US and Canada or Europe are good options. It's not really important however, you could even put your first base in Antarctica and that would be OK too. #images

You can name your base whatever you want, or even no name at all, as long as it fits in the box. You can also change the name as often as you like.

==Geoscape Intro==
'''Interception''' brings up a list of crafts you control. Selecting a craft will allow you to give that craft orders - more on that later. You can also select craft by clicking on their home base.

'''Bases''' is covered in the next section. If you've turned on the ''custom base layout'' option then you would already be here, placing your base facilities.

'''Graphs''' provide a lot of statistical information that might look completely meaningless to you, don't worry about it. It's there for when you want it later.

'''Ufopedia''' might sound familiar, www.ufopaedia.org is not a coincidence. It's an in-game [[UFOpaedia|encyclopedia]] that will grow as you experience more of the game. Feel free to browse but don't be surprised if you don't understand the purpose of anything in there yet.

==Basescape Intro==

=== Aircrafts ===

=== Research & Development ===

==Time management==

==UFO on sight!==

After some time of observation your radars will spot an UFO. You'll need bring down this aircraft with your interceptors. 

When UFO shot down and crashed on the ground, send your [[Skyranger]] with troops to crash site.

==Your First Mission==
===Meet the team===
==Battlescape Intro==

[[Category:OpenXcom]]

File:OpenXcom - placing first base.png

2014-06-14T07:48:31Z

Winterheart:

XCOM News

2014-06-14T07:46:03Z

Winterheart: /* News */

This is the Ufopaedia.org news page where relevant news and site messages will appear. When this page is transcluded into other pages, only the new news items should appear there. Everything else will only display on this page.

== News ==
<onlyinclude>
<div style="padding-left:10px;">
====OpenXcom 1.0 Released!====
[[File:OpenXcom - main screen.png|240px|thumb|OpenXcom 1.0]]
'''June 13th, 2014'''
:* [[OpenXcom]] has just completed its release 1.0 version, available for free at [http://openxcom.org/ openxcom.org]. If you're looking to spice up the original [[X-COM|UFO: Enemy Unknown]] game, then check out this revamped open source clone version, developed by Supsuper and a bunch of X-COM enthusiasts. For more details about Openxcom, see this [https://www.youtube.com/watch?v=GL2x-Sz9Oa8 presentation].
'''May 29th, 2014'''
:*Feral Interactive has [http://www.feralinteractive.com/en/news/424/ announced] that they will release XCOM: Enemy Unknown as their first game for Linux this summer, using the Ubuntu 14.04 version and through SteamPlay.
'''May 17th, 2014'''
:*[https://www.youtube.com/watch?v=qsHppXrgP0I YCOM: Enemy Unlikely] - Another remake of the XCOM series, YCOM: Enemy Unlikely is a demake of XCOM: Enemy Unknown, with a bit of hilarity added. The video contains a link on its description to download and play the game.
'''April 29th, 2014'''
:*[http://xcomrl.blogspot.pt/ X@COM] - playable alpha demo. X@COM, or XCOM Rogue-like, is a current fan project that aims to replicate the original UFO: Enemy Unknown using only ASCII characters. They're aiming to finish the project by 2015 and they have a current playable alpha version that can be downloaded for playing.
'''March 9th, 2014'''
:*[http://www.kotaku.com.au/2014/03/x-coms-design-document-had-just-12-pages/ Kokatu] magazine has published an article about the creation of the original [[X-COM|UFO: Enemy Unknown]] which includes a [http://www.gdcvault.com/play/1017808/Classic-Game-Postmortem-X-COM link] to last year's video presentation made by its creator, Jullian Gollop, about the original game's design process.
'''March 4th, 2014'''
:*XCOM: Complete Edition released for PC and Mac. Includes all of the DLCs released so far, including the Elite Soldier Pack, Slingshot and Enemy Within.
'''February 7th, 2014'''
:*[[XCOM: Enemy Within DLC (EU2012)|XCOM: Enemy Within]] has won the Best Strategy/Simulation Game of the Year 2013 DICE awards. For a list of winners see [http://www.interactive.org/news/17th_annual_dice_awards_winners.asp].
'''February 4th, 2014'''
:*2K Games is preparing the release a complete edition of [[Enemy Unknown (2012)|XCOM: Enemy Unknown]] on March 4th, according to [http://www.gameinformer.com/b/news/archive/2014/02/03/xcom-and-civilization-v-complete-editions-coming-soon.aspx Gameinformer]. No further details have been released yet about the edition but it's likely that it should include all of the DLCs released so far, such as [[Elite Soldier Pack DLC (EU2012)|Elite Soldier Pack]], [[Slingshot DLC (EU2012)|Slingshot]] and the [[XCOM: Enemy Within DLC (EU2012)|Enemy Within]] expansion.

==== [[XCOM: Enemy Within DLC (EU2012)|XCOM: Enemy Within]] and [[Hangar 6: R&D DLC (Bureau)|Hangar 6: R&D]] have been released! ====
====XCOM: Enemy Within released====
'''November 15th 2013'''
:*And now it is the rest of the world's turn as Enemy Within receives its international release today. So get on and enjoy the all new features!
'''November 12th 2013'''
:*XCOM Enemy Within is released in America with new features like the new human faction – EXALT, Base Defence and all new maps and council Missions. Enjoy the game and see you on the farm with the crashed UFO.

==== XCOM: Enemy Within Reviews! ====
'''November 11th 2013'''
:*Several reviews of [[XCOM: Enemy Within DLC (EU2012)|XCOM: Enemy Within]] have been published today. To read/see them, check [http://www.escapistmagazine.com/articles/view/editorials/reviews/10729-XCOM-Enemy-Within-Review Escapist Magazine] ("''All of the fun new toys, however, do work a bit against the game's biggest flaw - after a certain point of advancement, the challenge and satisfaction of snuffing aliens dissipates quickly.''"), [http://www.shacknews.com/article/81977/xcom-enemy-within-video-review Shacknews] ("''Firaxis once again manages to balance XCOM's disparate elements, resulting in a challenging and satisfying experience.''"), [http://uk.ign.com/articles/2013/11/11/xcom-enemy-within-review IGN] ("''Enemy Within is an amazing expansion to a brilliant tactical game.''") and [http://www.strategyinformer.com/pc/xcomenemyunknowntheenemywithin/reviews.html Strategy Informer] ("''I could go on about the virtues of Enemy Within, about how good it was to play through the whole campaign again, but ultimately it’ll come down to two factors: The fact that the ending hasn’t changed a bit, and the fact that, ultimately, you’re still playing the same game.''", and [http://www.youtube.com/watch?v=4mb_RXgIStw Revision3] ("''EW gets a 4 out of 5.''").

====The Bureau Expansion====
'''November 8th 2013'''
:*[[The Bureau: XCOM Declassified|The Bureau: XCOM Declassified]] gained it first DLC Pack today in the form of [[Hangar 6: R&D DLC (Bureau)|Hangar 6: R&D]] in which the player takes control of DaSilva in an attempt to get to the bottom of a mysterious new infection.

==== XCOM Base Defense confirmed on EW====
'''October 23th, 2013'''
:*The newest preview videos released ([http://www.escapistmagazine.com/articles/view/editorials/reviews/previews/10679-XCOM-Enemy-Within-Preview-Whole-New-Game here] and [http://www.gamespot.com/videos/base-defense-returns-in-xcom-enemy-within/2300-6415682/ here]) have confirmed the addition of a Base Defense mission to [[XCOM: Enemy Within DLC (EU2012)|XCOM: Enemy Within]], a feature of the original game long called for by players. Check for more details on the Enemy Within page.

==== EXALT revealed!====
'''October 9th, 2013'''
:*A new faction has been revealed for [[XCOM: Enemy Within DLC (EU2012)|XCOM: Enemy Within]], the upcoming [[Enemy Unknown (2012)|XCOM: Enemy Unknown]] expansion. XCOM's new enemies are called EXALT and they're a secret paramilitary human group that is conspiring to use the alien technology and chaos of the invasion to achieve world domination. More details available at the [[XCOM: Enemy Within DLC (EU2012)|Enemy Within]] page.

==== XCOM: Enemy Within details announced!====
'''August 21st, 2013'''
:*Producer 2K revealed details about '''XCOM: Enemy Within''', the upcoming expansion to [[Enemy Unknown (2012)|XCOM: Enemy Unknown]]. The main features are the addition of the Meld, a substance that allows you to create a new class (Mech Troopers), with new weapons and abilities or to genetically enhance your soldiers (Gene Mods), along with other features. The release date is November 12th (US) and 15th (rest of the world) and check the full details on the [[XCOM: Enemy Within DLC (EU2012)|XCOM: Enemy Within]] page.

==== XCOM: Enemy Within will be revealed on August 21st====
'''August 3rd, 2013'''
:*Producer 2K has confirmed that it will reveal during Gamescom 2013 a new DLC for XCOM: Enemy Unknown called [[XCOM: Enemy Within DLC (EU2012)|XCOM: Enemy Within]].

</onlyinclude>

== Archived News ==

==== The Bureau: XCOM Declassified will be released next month====
'''July 18th, 2013'''
:*The upcoming XCOM squad based shooter will be available for sale on stores on August 20th in the US and on the 23rd to the rest of the world. From the available previews/footage it seems the game has been redesigned as a prequel to ''XCOM: Enemy Unknown'', featuring Sectoids, Mutons and even Silacoids.

==== The Bureau: XCOM Declassified coming soon====
'''May 5th, 2013'''
:*Marin's 2K XCOM squad based shooter should be released soon as '''The Bureau: XCOM Declassified'''. The game was announced three years ago and has been redesigned.

==== Clash of the Titans: X-COM meets XCOM ====
'''April 2nd, 2013'''
:*Julian Gollop and Jake Solomon have met for the first time during Game Developers Conference 2013 to be interviewed regarding the original game and the 2012 remake. Check the video of the encounter here: [http://www.youtube.com/watch?v=z8zZsecTRfM].

==== GDC 2013: Julian Gollop's Postmortem on UFO: Enemy Unknown/XCOM: UFO Defense ====

'''March 28th, 2013'''

:*Julian Gollop gave a talk at Games Developers Conference 2013 on the development of the original UFO: Enemy Unknown/XCOM: UFO Defense. An interesting look into the philosophies and source material that went into the making of the game, and also how it nearly failed.

:: See the video at: http://www.gamespot.com/events/gdc-2013/video.html?sid=6406150
'''March 1st, 2013'''
:*'''Elite Edition for the Mac announced.''' Firaxis have announced that Feral Games are porting XCOM: Enemy Unknown to the OS X and will be released in an Elite Edition. This edition will include the [[Elite Soldier Pack DLC (EU2012)|Elite Soldier Pack]], [[Slingshot DLC (EU2012)|Slingshot]] and [[Second Wave (EU2012)|Second Wave]] DLCs and should be released this spring.

'''January 8th, 2013'''
:*'''[[Second Wave (EU2012)|Second Wave]] options now available on XCOM: Enemy Unknown.''' The latest patch released today by Firaxis now activates the Second Wave options and makes it available for the game. Despite it being already included but inactive (and playable through mods) the developers had stated that they didn't had time to complete Second Wave before XCOM: Enemy Unknown but it was on their intentions to finish it. It now includes the following [[Info_(EU2012)#Advanced Options|options]] as part of Advanced Gameplay: ''Damage Roulette, New Economy, Not Created Equally, Hidden Potential, Red Fog, Absolutely Critical, The Greater Good, Marathon, Results Driven, High Stakes, Diminishing Returns, More Than Human, Total Loss, War Wariness, E-115'' and ''Alternate Sources''. The [[Patches_(EU2012)#2013-01-08|patch]] also introduces fixes to the teleport bug and adds a new XCOM Hero.

'''December 4, 2012'''
:* 2K Games has released the first of two DLC packs for all platforms, named ''Slingshot''. The pack features several additional new helmets, 1 new armor decoration and 3 linked Council missions and a special playable soldier named ''Zhang''.

'''October 23, 2012'''
:* 2K Games has [http://www.2kgames.com/blog/add-on-content-packs-for-xcom-enemy-unknown-coming-soon announced] the first of two DLC packs for all platforms. The first, named ''Slingshot'', will feature 3 new linked Council missions that will focus on a playable character named ''Zhang''.

'''October 9, 2012'''
:* Eighteen years after the original release of ''UFO: Enemy Unknown'' (or ''XCOM: UFO Defense''), 2K Games has released today in North America ''XCOM: Enemy Unknown'', its remake of the original game, which will be followed by the international release next Friday. XCOM is back!

''' September 24, 2012 '''
:* Demo is released on '''[http://store.steampowered.com/app/200510/ Steam]'''. It features a tutorial mission, a standard mission and a limited interaction with the Base and Geoscape layer.

''' August 10, 2012 '''
:* Multiplayer deathmatch revealed for XCOM: Enemy Unknown (2012), mix your own squad of soldiers & aliens and battle online vs other players.

''' January 5, 2012 '''
:*Publisher 2K Games announces that Firaxis (makers of Civilization) is developing a re-imagining of the original XCOM: Enemy Unknown for release this fall (2012).

----

==== New XCOM FPS Game by 2k Marin ====
:* XCOM FPS has been delayed multiple times, release is late 2013 or 2014 at the earliest.
:* The game will focus on elite U.S. government operatives attempting to prevent a nightmarish invasion of the United States (while dropping the dash in X-COM). See:
:* The [http://www.xcom.com official XCOM] site (only a couple of trailers here)
:* Some criticism of its change in focus ([http://www.destructoid.com/2k-marin-s-22-minute-demonstration-of-xcom-209954.phtml 1], [http://www.destructoid.com/2k-xcom-changed-because-strategy-games-aren-t-modern-205991.phtml 2]), although 2k Marin may be rethinking this
:* [http://forums.2kgames.com/forums/forumdisplay.php?76-XCOM-General-Discussion 2k's XCOM forum], including passionate posts by X-Commies
:* Once slated for March 2012 release, it has now slipped to a later date ([http://www.videogamer.com/xbox360/xcom_2k_marin/news/xcom_release_date_slips_avoids_mass_effect_3.html 1], [http://www.gamespot.com/news/6344515.html?tag=nl.e579 2]).

----
==== X-COM Packages ====
Now available for less than $15
:*At [http://www.gamersgate.com/index.php?page=product&what=view&sku=DDB-XCOM&via=newly_added&aff=sc GamersGate], [http://store.steampowered.com/sub/964/ Steam] and [http://www.direct2drive.com/2/7614/product/Buy-X-Com-Complete-Bundle-Download Direct2Drive]. (Includes '''UFO''', '''TFTD''', '''Apoc''', '''Int''', and '''Enf''').

For "reviews", see [[GEOSCAPE.EXE#X-COM_Complete_Packages|this]].

'''OFFICIAL''' - [http://kotaku.com/5516654/x+com-is-back NEW X-COM GAME FROM THE DEVELOPERS OF BIOSHOCK 2] 
Yes, this will come as a shock to all, but 2K Australia and 2K Marin is busily working on a first-person shooter based on the X-COM franchise. More info will presumably become available on the 2010 E3.

For more information/rumors check 2K's [http://forums.2kgames.com/forums/forumdisplay.php?f=76 X-COM forum].
</div>

File:OpenXcom - main screen.png

2014-06-14T07:43:42Z

Winterheart: Winterheart uploaded a new version of "File:OpenXcom - main screen.png"

File:OpenXcom - main screen.png

2014-06-14T07:41:21Z

Winterheart:

XCOM News

2014-06-14T07:36:46Z

Winterheart: /* OpenXcom 1.0 Released! */

This is the Ufopaedia.org news page where relevant news and site messages will appear. When this page is transcluded into other pages, only the new news items should appear there. Everything else will only display on this page.

== News ==
<onlyinclude>
<div style="padding-left:10px;">
[[image:XCOM squad.jpg|thumb|300px|XCOM: Enemy Unknown on Linux]]
====OpenXcom 1.0 Released!====
'''June 13th, 2014'''
:* [[OpenXcom]] has just completed its release 1.0 version, available for free at [http://openxcom.org/ openxcom.org]. If you're looking to spice up the original [[X-COM|UFO: Enemy Unknown]] game, then check out this revamped open source clone version, developed by Supsuper and a bunch of X-COM enthusiasts. For more details about Openxcom, see this [https://www.youtube.com/watch?v=GL2x-Sz9Oa8 presentation].
'''May 29th, 2014'''
:*Feral Interactive has [http://www.feralinteractive.com/en/news/424/ announced] that they will release XCOM: Enemy Unknown as their first game for Linux this summer, using the Ubuntu 14.04 version and through SteamPlay.
'''May 17th, 2014'''
:*[https://www.youtube.com/watch?v=qsHppXrgP0I YCOM: Enemy Unlikely] - Another remake of the XCOM series, YCOM: Enemy Unlikely is a demake of XCOM: Enemy Unknown, with a bit of hilarity added. The video contains a link on its description to download and play the game.
'''April 29th, 2014'''
:*[http://xcomrl.blogspot.pt/ X@COM] - playable alpha demo. X@COM, or XCOM Rogue-like, is a current fan project that aims to replicate the original UFO: Enemy Unknown using only ASCII characters. They're aiming to finish the project by 2015 and they have a current playable alpha version that can be downloaded for playing.
'''March 9th, 2014'''
:*[http://www.kotaku.com.au/2014/03/x-coms-design-document-had-just-12-pages/ Kokatu] magazine has published an article about the creation of the original [[X-COM|UFO: Enemy Unknown]] which includes a [http://www.gdcvault.com/play/1017808/Classic-Game-Postmortem-X-COM link] to last year's video presentation made by its creator, Jullian Gollop, about the original game's design process.
'''March 4th, 2014'''
:*XCOM: Complete Edition released for PC and Mac. Includes all of the DLCs released so far, including the Elite Soldier Pack, Slingshot and Enemy Within.
'''February 7th, 2014'''
:*[[XCOM: Enemy Within DLC (EU2012)|XCOM: Enemy Within]] has won the Best Strategy/Simulation Game of the Year 2013 DICE awards. For a list of winners see [http://www.interactive.org/news/17th_annual_dice_awards_winners.asp].
'''February 4th, 2014'''
:*2K Games is preparing the release a complete edition of [[Enemy Unknown (2012)|XCOM: Enemy Unknown]] on March 4th, according to [http://www.gameinformer.com/b/news/archive/2014/02/03/xcom-and-civilization-v-complete-editions-coming-soon.aspx Gameinformer]. No further details have been released yet about the edition but it's likely that it should include all of the DLCs released so far, such as [[Elite Soldier Pack DLC (EU2012)|Elite Soldier Pack]], [[Slingshot DLC (EU2012)|Slingshot]] and the [[XCOM: Enemy Within DLC (EU2012)|Enemy Within]] expansion.

==== [[XCOM: Enemy Within DLC (EU2012)|XCOM: Enemy Within]] and [[Hangar 6: R&D DLC (Bureau)|Hangar 6: R&D]] have been released! ====
====XCOM: Enemy Within released====
'''November 15th 2013'''
:*And now it is the rest of the world's turn as Enemy Within receives its international release today. So get on and enjoy the all new features!
'''November 12th 2013'''
:*XCOM Enemy Within is released in America with new features like the new human faction – EXALT, Base Defence and all new maps and council Missions. Enjoy the game and see you on the farm with the crashed UFO.

==== XCOM: Enemy Within Reviews! ====
'''November 11th 2013'''
:*Several reviews of [[XCOM: Enemy Within DLC (EU2012)|XCOM: Enemy Within]] have been published today. To read/see them, check [http://www.escapistmagazine.com/articles/view/editorials/reviews/10729-XCOM-Enemy-Within-Review Escapist Magazine] ("''All of the fun new toys, however, do work a bit against the game's biggest flaw - after a certain point of advancement, the challenge and satisfaction of snuffing aliens dissipates quickly.''"), [http://www.shacknews.com/article/81977/xcom-enemy-within-video-review Shacknews] ("''Firaxis once again manages to balance XCOM's disparate elements, resulting in a challenging and satisfying experience.''"), [http://uk.ign.com/articles/2013/11/11/xcom-enemy-within-review IGN] ("''Enemy Within is an amazing expansion to a brilliant tactical game.''") and [http://www.strategyinformer.com/pc/xcomenemyunknowntheenemywithin/reviews.html Strategy Informer] ("''I could go on about the virtues of Enemy Within, about how good it was to play through the whole campaign again, but ultimately it’ll come down to two factors: The fact that the ending hasn’t changed a bit, and the fact that, ultimately, you’re still playing the same game.''", and [http://www.youtube.com/watch?v=4mb_RXgIStw Revision3] ("''EW gets a 4 out of 5.''").

====The Bureau Expansion====
'''November 8th 2013'''
:*[[The Bureau: XCOM Declassified|The Bureau: XCOM Declassified]] gained it first DLC Pack today in the form of [[Hangar 6: R&D DLC (Bureau)|Hangar 6: R&D]] in which the player takes control of DaSilva in an attempt to get to the bottom of a mysterious new infection.

==== XCOM Base Defense confirmed on EW====
'''October 23th, 2013'''
:*The newest preview videos released ([http://www.escapistmagazine.com/articles/view/editorials/reviews/previews/10679-XCOM-Enemy-Within-Preview-Whole-New-Game here] and [http://www.gamespot.com/videos/base-defense-returns-in-xcom-enemy-within/2300-6415682/ here]) have confirmed the addition of a Base Defense mission to [[XCOM: Enemy Within DLC (EU2012)|XCOM: Enemy Within]], a feature of the original game long called for by players. Check for more details on the Enemy Within page.

==== EXALT revealed!====
'''October 9th, 2013'''
:*A new faction has been revealed for [[XCOM: Enemy Within DLC (EU2012)|XCOM: Enemy Within]], the upcoming [[Enemy Unknown (2012)|XCOM: Enemy Unknown]] expansion. XCOM's new enemies are called EXALT and they're a secret paramilitary human group that is conspiring to use the alien technology and chaos of the invasion to achieve world domination. More details available at the [[XCOM: Enemy Within DLC (EU2012)|Enemy Within]] page.

==== XCOM: Enemy Within details announced!====
'''August 21st, 2013'''
:*Producer 2K revealed details about '''XCOM: Enemy Within''', the upcoming expansion to [[Enemy Unknown (2012)|XCOM: Enemy Unknown]]. The main features are the addition of the Meld, a substance that allows you to create a new class (Mech Troopers), with new weapons and abilities or to genetically enhance your soldiers (Gene Mods), along with other features. The release date is November 12th (US) and 15th (rest of the world) and check the full details on the [[XCOM: Enemy Within DLC (EU2012)|XCOM: Enemy Within]] page.

==== XCOM: Enemy Within will be revealed on August 21st====
'''August 3rd, 2013'''
:*Producer 2K has confirmed that it will reveal during Gamescom 2013 a new DLC for XCOM: Enemy Unknown called [[XCOM: Enemy Within DLC (EU2012)|XCOM: Enemy Within]].

</onlyinclude>

== Archived News ==

==== The Bureau: XCOM Declassified will be released next month====
'''July 18th, 2013'''
:*The upcoming XCOM squad based shooter will be available for sale on stores on August 20th in the US and on the 23rd to the rest of the world. From the available previews/footage it seems the game has been redesigned as a prequel to ''XCOM: Enemy Unknown'', featuring Sectoids, Mutons and even Silacoids.

==== The Bureau: XCOM Declassified coming soon====
'''May 5th, 2013'''
:*Marin's 2K XCOM squad based shooter should be released soon as '''The Bureau: XCOM Declassified'''. The game was announced three years ago and has been redesigned.

==== Clash of the Titans: X-COM meets XCOM ====
'''April 2nd, 2013'''
:*Julian Gollop and Jake Solomon have met for the first time during Game Developers Conference 2013 to be interviewed regarding the original game and the 2012 remake. Check the video of the encounter here: [http://www.youtube.com/watch?v=z8zZsecTRfM].

==== GDC 2013: Julian Gollop's Postmortem on UFO: Enemy Unknown/XCOM: UFO Defense ====

'''March 28th, 2013'''

:*Julian Gollop gave a talk at Games Developers Conference 2013 on the development of the original UFO: Enemy Unknown/XCOM: UFO Defense. An interesting look into the philosophies and source material that went into the making of the game, and also how it nearly failed.

:: See the video at: http://www.gamespot.com/events/gdc-2013/video.html?sid=6406150
'''March 1st, 2013'''
:*'''Elite Edition for the Mac announced.''' Firaxis have announced that Feral Games are porting XCOM: Enemy Unknown to the OS X and will be released in an Elite Edition. This edition will include the [[Elite Soldier Pack DLC (EU2012)|Elite Soldier Pack]], [[Slingshot DLC (EU2012)|Slingshot]] and [[Second Wave (EU2012)|Second Wave]] DLCs and should be released this spring.

'''January 8th, 2013'''
:*'''[[Second Wave (EU2012)|Second Wave]] options now available on XCOM: Enemy Unknown.''' The latest patch released today by Firaxis now activates the Second Wave options and makes it available for the game. Despite it being already included but inactive (and playable through mods) the developers had stated that they didn't had time to complete Second Wave before XCOM: Enemy Unknown but it was on their intentions to finish it. It now includes the following [[Info_(EU2012)#Advanced Options|options]] as part of Advanced Gameplay: ''Damage Roulette, New Economy, Not Created Equally, Hidden Potential, Red Fog, Absolutely Critical, The Greater Good, Marathon, Results Driven, High Stakes, Diminishing Returns, More Than Human, Total Loss, War Wariness, E-115'' and ''Alternate Sources''. The [[Patches_(EU2012)#2013-01-08|patch]] also introduces fixes to the teleport bug and adds a new XCOM Hero.

'''December 4, 2012'''
:* 2K Games has released the first of two DLC packs for all platforms, named ''Slingshot''. The pack features several additional new helmets, 1 new armor decoration and 3 linked Council missions and a special playable soldier named ''Zhang''.

'''October 23, 2012'''
:* 2K Games has [http://www.2kgames.com/blog/add-on-content-packs-for-xcom-enemy-unknown-coming-soon announced] the first of two DLC packs for all platforms. The first, named ''Slingshot'', will feature 3 new linked Council missions that will focus on a playable character named ''Zhang''.

'''October 9, 2012'''
:* Eighteen years after the original release of ''UFO: Enemy Unknown'' (or ''XCOM: UFO Defense''), 2K Games has released today in North America ''XCOM: Enemy Unknown'', its remake of the original game, which will be followed by the international release next Friday. XCOM is back!

''' September 24, 2012 '''
:* Demo is released on '''[http://store.steampowered.com/app/200510/ Steam]'''. It features a tutorial mission, a standard mission and a limited interaction with the Base and Geoscape layer.

''' August 10, 2012 '''
:* Multiplayer deathmatch revealed for XCOM: Enemy Unknown (2012), mix your own squad of soldiers & aliens and battle online vs other players.

''' January 5, 2012 '''
:*Publisher 2K Games announces that Firaxis (makers of Civilization) is developing a re-imagining of the original XCOM: Enemy Unknown for release this fall (2012).

----

==== New XCOM FPS Game by 2k Marin ====
:* XCOM FPS has been delayed multiple times, release is late 2013 or 2014 at the earliest.
:* The game will focus on elite U.S. government operatives attempting to prevent a nightmarish invasion of the United States (while dropping the dash in X-COM). See:
:* The [http://www.xcom.com official XCOM] site (only a couple of trailers here)
:* Some criticism of its change in focus ([http://www.destructoid.com/2k-marin-s-22-minute-demonstration-of-xcom-209954.phtml 1], [http://www.destructoid.com/2k-xcom-changed-because-strategy-games-aren-t-modern-205991.phtml 2]), although 2k Marin may be rethinking this
:* [http://forums.2kgames.com/forums/forumdisplay.php?76-XCOM-General-Discussion 2k's XCOM forum], including passionate posts by X-Commies
:* Once slated for March 2012 release, it has now slipped to a later date ([http://www.videogamer.com/xbox360/xcom_2k_marin/news/xcom_release_date_slips_avoids_mass_effect_3.html 1], [http://www.gamespot.com/news/6344515.html?tag=nl.e579 2]).

----
==== X-COM Packages ====
Now available for less than $15
:*At [http://www.gamersgate.com/index.php?page=product&what=view&sku=DDB-XCOM&via=newly_added&aff=sc GamersGate], [http://store.steampowered.com/sub/964/ Steam] and [http://www.direct2drive.com/2/7614/product/Buy-X-Com-Complete-Bundle-Download Direct2Drive]. (Includes '''UFO''', '''TFTD''', '''Apoc''', '''Int''', and '''Enf''').

For "reviews", see [[GEOSCAPE.EXE#X-COM_Complete_Packages|this]].

'''OFFICIAL''' - [http://kotaku.com/5516654/x+com-is-back NEW X-COM GAME FROM THE DEVELOPERS OF BIOSHOCK 2] 
Yes, this will come as a shock to all, but 2K Australia and 2K Marin is busily working on a first-person shooter based on the X-COM franchise. More info will presumably become available on the 2010 E3.

For more information/rumors check 2K's [http://forums.2kgames.com/forums/forumdisplay.php?f=76 X-COM forum].
</div>

Beginners Guide (OpenXcom)

2014-06-04T06:43:00Z

Winterheart:

=THIS PAGE IS UNDER CONSTRUCTION - CHECK BACK LATER=

This introductory guide assumes you have never seen an X-COM game before, but you can still do basic things like or open and close menus without having to be told how. If you get lost in the various interfaces - guess. It's OK.

This isn't a step-by-step tutorial, and you won't mess it up if you do something out of order. X-COM is all about open sandbox-style freedom.

==Stating a new game==
Start a new game and choose your [[Difficulty Levels|difficulty]], choose ''Beginner''.

==Base Placement==
You can either pan the globe around with the controls in the box at the bottom right, by using arrow-keys, or by right-clicking anywhere on the globe to center on that location.

Now you pick where you want your first base. Look at the Radar coverage circles and the landmass within them - it's good to start out covering countries that give X-COM a lot of [[Country Funding (EU)|funding]] so either US and Canada or Europe are good options. It's not really important however, you could even put your first base in Antarctica and that would be OK too. #images

You can name your base whatever you want, or even no name at all, as long as it fits in the box. You can also change the name as often as you like.

==Geoscape Intro==
'''Interception''' brings up a list of crafts you control. Selecting a craft will allow you to give that craft orders - more on that later. You can also select craft by clicking on their home base.

'''Bases''' is covered in the next section. If you've turned on the ''custom base layout'' option then you would already be here, placing your base facilities.

'''Graphs''' provide a lot of statistical information that might look completely meaningless to you, don't worry about it. It's there for when you want it later.

'''Ufopedia''' might sound familiar, www.ufopaedia.org is not a coincidence. It's an in-game [[UFOpaedia|encyclopedia]] that will grow as you experience more of the game. Feel free to browse but don't be surprised if you don't understand the purpose of anything in there yet.

==Basescape Intro==

=== Aircrafts ===

=== Research & Development ===

==Time management==

==UFO on sight!==

After some time of observation your radars will spot an UFO. You'll need bring down this aircraft with your interceptors. 

When UFO shot down and crashed on the ground, send your [[Skyranger]] with troops to crash site.

==Your First Mission==
===Meet the team===
==Battlescape Intro==

[[Category:OpenXcom]]

Assault (Long War)

2014-06-04T06:11:54Z

Winterheart:

The Long War Assault is similar to the vanilla Assault. Their signature ability is Run & Gun, which works exactly as it does in vanilla XCOM.

:'''Primary Weapons''': Assault Rifles, Shotguns
:'''Secondary Weapons''': Pistols

== Abilities ==
{| class="wikitable" width="70%"
|-
! width="10%" align="center" | Rank
! width="60%" align="center" colspan="4"| Ability
|- align="center"
! rowspan="1" | [[File:RANK SQUADDIE.png|32px]] '''Specialist'''
| colspan="3" | [[File:ASSAULT RUNGUN.png|32px|center]]'''Run & Gun''' ''Allows firing or Overwatch after Dashing on the turn Run & Gun is activated. 2 turn cooldown.''
|- align="center"
| colspan="3" | ''No other bonuses.''{{Verify}}
|}

[[Category:Long War]]

Scout (Long War)

2014-06-04T06:11:43Z

Winterheart:

'''The Scout''' is a unique class that doesn't have an equivalent in vanilla XCOM, combining elements of Assaults and Snap Shot Snipers. The Scout's signature ability is Lightning Reflexes, greatly reducing the chance to be hit by overwatch fire while moving. Scouts are the only class other than Snipers that can use sniper rifles.

:'''Primary Weapon''': Sniper Rifles, Assault Rifles, Shotguns
:'''Secondary Weapon''': Pistols

== Abilities ==
{| class="wikitable" width="100%"
|-
! width="10%" align="center" | Rank
! width="60%" align="center" colspan="4"| Ability
|- align="center"
! rowspan="2" | [[File:RANK SQUADDIE.png|32px]] '''Specialist'''
| colspan="3" | [[File:ASSAULT LIGHTNINGREFLEXES.png|32px|center]]'''Lightning Reflexes''' ''Reduces hit chance from overwatch fire by 90% for the first shot, and 75% for subsequent shots.''
|- align="center"
| colspan="3" | ''No other bonuses.''{{Verify}}
|}

[[Category:Long War]]