Installing (OpenXcom) - Revision history

Hobbes: Undo revision 126405 by Hobbes (talk)

2026-03-10T15:12:48Z

Undo revision 126405 by Hobbes (talk)

← Older revision		Revision as of 15:12, 10 March 2026
Line 1:		Line 1:
	#~~REDIRECT~~ [[OpenXcom]]		'''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")
			* Gog Version

			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.

			== OXC Versions ==
			First, you should decide what exactly you want to install.
			* "Nightlies". Development versions - less polished, much more recent, not really nightly, but actually update every few months: [https://openxcom.org/git-builds/ released builds], [https://github.com/OpenXcom/OpenXcom repository].
			* OpenXcom Extended, aka OXCE. Cutting edge, extra-modding-friendly development version: [https://openxcom.org/forum/index.php/topic,5258.0.html released builds], [https://github.com/MeridianOXC/OpenXcom repository].
			* And there's also available the OpenXcom 1.0 release but it has been discontinued a long time ago - use the nightlies or OXCE instead.

			== 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'''
			** '''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.

			This video: "[http://www.youtube.com/watch?v=L1WUpX9n7gY OpenXCOM Nightly Install Tutorial]" explains installing the '''Nightly''' (both with the installer and manually) and installing both simple and total conversion '''mods'''.

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

Hobbes: Removed protection from "Installing (OpenXcom)"

2026-03-10T14:46:58Z

Removed protection from "Installing (OpenXcom)"

← Older revision	Revision as of 14:46, 10 March 2026
(No difference)

Hobbes: Protected "Installing (OpenXcom)" ([Edit=Allow only administrators] (indefinite) [Move=Allow only administrators] (indefinite))

2026-03-10T13:55:02Z

Protected "Installing (OpenXcom)" ([Edit=Allow only administrators] (indefinite) [Move=Allow only administrators] (indefinite))

← Older revision	Revision as of 13:55, 10 March 2026
(No difference)

Hobbes: Redirected page to OpenXcom

2026-03-10T13:54:55Z

Redirected page to OpenXcom

← Older revision		Revision as of 13:54, 10 March 2026
Line 1:		Line 1:
	~~'''OpenXcom requires a vanilla version of the original [[X-COM]] resources.''' This can be any one of:~~		#REDIRECT [[OpenXcom]]

	* 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")
	* Gog Version

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

	~~== OXC Versions ==~~
	~~First, you should decide what exactly you want to install.~~
	* "Nightlies". Development versions - less polished, much more recent, not really nightly, but actually update every few months: [https://openxcom.org/git-builds/ released builds], [https://github.com/OpenXcom/OpenXcom repository].
	* OpenXcom Extended, aka OXCE. Cutting edge, extra-modding-friendly development version: [https://openxcom.org/forum/index.php/topic,5258.0.html released builds], [https://github.com/MeridianOXC/OpenXcom repository].
	* And there's also available the OpenXcom 1.0 release but it has been discontinued a long time ago - use the nightlies or OXCE instead.

	~~== 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'''
	** '''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.

	This video: "[http://www.youtube.com/watch?v=L1WUpX9n7gY OpenXCOM Nightly Install Tutorial]" explains installing the '''Nightly''' (both with the installer and manually) and installing both simple and total conversion '''mods'''.

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

Hobbes: /* OXC Versions */

2023-07-17T16:59:01Z

OXC Versions

← Older revision		Revision as of 16:59, 17 July 2023
Line 10:		Line 10:
	== OXC Versions ==		== OXC Versions ==
	First, you should decide what exactly you want to install.		First, you should decide what exactly you want to install.
	* OpenXcom release.
	* "Nightlies". Development versions - less polished, much more recent, not really nightly, but actually update every few months: [https://openxcom.org/git-builds/ released builds], [https://github.com/OpenXcom/OpenXcom repository].		* "Nightlies". Development versions - less polished, much more recent, not really nightly, but actually update every few months: [https://openxcom.org/git-builds/ released builds], [https://github.com/OpenXcom/OpenXcom repository].
	* OpenXcom Extended, aka OXCE. Cutting edge, extra-modding-friendly development version: [https://openxcom.org/forum/index.php/topic,5258.0.html released builds], [https://github.com/MeridianOXC/OpenXcom repository].		* OpenXcom Extended, aka OXCE. Cutting edge, extra-modding-friendly development version: [https://openxcom.org/forum/index.php/topic,5258.0.html released builds], [https://github.com/MeridianOXC/OpenXcom repository].
			* And there's also available the OpenXcom 1.0 release but it has been discontinued a long time ago - use the nightlies or OXCE instead.

	== Instructions ==		== Instructions ==

TBeholder: /* OXC Versions */

2022-12-10T13:25:41Z

OXC Versions

← Older revision		Revision as of 13:25, 10 December 2022
Line 9:		Line 9:

	== OXC Versions ==		== OXC Versions ==
			First, you should decide what exactly you want to install.
	* OpenXcom release.		* OpenXcom release.
	* "Nightlies". Development versions - less polished, much more recent, not really nightly, but actually update every few months: [https://openxcom.org/git-builds/ released builds], [https://github.com/OpenXcom/OpenXcom repository].		* "Nightlies". Development versions - less polished, much more recent, not really nightly, but actually update every few months: [https://openxcom.org/git-builds/ released builds], [https://github.com/OpenXcom/OpenXcom repository].

TBeholder at 13:24, 10 December 2022

2022-12-10T13:24:59Z

← Older revision		Revision as of 13:24, 10 December 2022
Line 7:		Line 7:

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

			== OXC Versions ==
			* OpenXcom release.
			* "Nightlies". Development versions - less polished, much more recent, not really nightly, but actually update every few months: [https://openxcom.org/git-builds/ released builds], [https://github.com/OpenXcom/OpenXcom repository].
			* OpenXcom Extended, aka OXCE. Cutting edge, extra-modding-friendly development version: [https://openxcom.org/forum/index.php/topic,5258.0.html released builds], [https://github.com/MeridianOXC/OpenXcom repository].

	== Instructions ==		== Instructions ==
Line 84:		Line 89:

	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].		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]]		[[Category:OpenXcom]]

Nl255: Add gog version as supported

2021-11-12T18:35:06Z

Add gog version as supported

← Older revision		Revision as of 18:35, 12 November 2021
Line 4:		Line 4:
	* Windows Version / Collector's Edition		* Windows Version / Collector's Edition
	* Steam Version (you can find the game folder in "Steam\steamapps\common\xcom ufo defense\XCOM")		* Steam Version (you can find the game folder in "Steam\steamapps\common\xcom ufo defense\XCOM")
			* Gog Version

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

Warboy1982: /* All platforms */

2017-03-17T00:02:29Z

All platforms

← Older revision		Revision as of 00:02, 17 March 2017
Line 13:		Line 13:
	=== All platforms ===		=== 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:		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		* data
Line 38:		Line 40:
	** '''MAPS'''		** '''MAPS'''
	** '''ROUTES'''		** '''ROUTES'''
	** Shaders
	** '''SOUND'''		** '''SOUND'''
	** '''TERRAIN'''		** '''TERRAIN'''

IvanDogovich: /* Video tutorial */

2016-09-25T21:27:51Z

Video tutorial

← Older revision		Revision as of 21:27, 25 September 2016
Line 51:		Line 51:
	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.		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.

	"This video: "[http://www.youtube.com/watch?v=L1WUpX9n7gY OpenXCOM Nightly Install Tutorial]" explains installing the '''Nightly''' (both with the installer and manually) and installing both simple and total conversion '''mods'''.		This video: "[http://www.youtube.com/watch?v=L1WUpX9n7gY OpenXCOM Nightly Install Tutorial]" explains installing the '''Nightly''' (both with the installer and manually) and installing both simple and total conversion '''mods'''.

	=== Windows ===		=== Windows ===