Skip to content
MarkL edited this page Feb 25, 2014 · 12 revisions

###The short version

  1. Download the appropriate installer or package here: https://github.com/CorsixTH/CorsixTH/releases

  2. Run it and follow the instructions.

  3. The first time you start the game it may ask for the location of Theme Hospital. If it does not you are done! :-) Happy gaming!

Otherwise, point CorsixTH to an installation, the CD (the HOSP folder) or somewhere else you have put Theme Hospital. If you don't have Theme Hospital already you can buy it at gog.com or download the demo here. As an example, if you did buy the original game from www.gog.com and installed it on Windows using default settings you will want to point CorsixTH to C:\Program Files\GOG.com\Theme Hospital on first startup.

  1. Optionally copy the CD contents to a good place on your harddrive and point the game there instead so that you don't need to have the CD in the tray all the time.

  2. Play the game!

The long version

If the above is too short, or it does not work, this is the somewhat longer version.

####1. Operating Systems

To start, it is worthwhile to quickly ensure that your operating system is supported:

  • Windows (8, 7, Vista, XP) - Supported. Note that for Windows 8 you can only run CorsixTH in Desktop mode. There is currently no Modern-UI version. A [more detailed, Windows-specific version of this page] (http://edwardh.se/2010/03/26/installing-corsixth-and-theme-hospital/) (with lots of pictures) might be of interest, but have in mind that it was written a few years ago.
  • Linux - Supported.
  • Mac OS X - Supported.
  • Others - As long as you've got a C/C++ compiler and the SDL library available, then things should work.

####2. Prerequisite Data

At the moment, game assets (graphics, sounds, levels, translations, etc.) are loaded from the original game files. Therefore, you will require the original CD or a copy from e.g. [gog.com] (http://www.gog.com) in order to use CorsixTH. If you've got a copy of the original game disk lying around, then great - copy the HOSP folder (which should contain sub-directories called Data, QData, Levels, etc.) from the root of the CD to somewhere on your hard drive.

If you are unable to acquire the full game data files, then the demo can be downloaded easily and used instead (though the demo only has one level, and lacks most management screens).

####3. Downloading and Compiling

There are four ways to obtain a copy of CorsixTH:

  • A ready-to-use executable (compiled binary) or installer for the latest stable release can be downloaded from the release page.
  • The source code of the latest stable release can be downloaded as a tarball from the release page.
  • Windows only: A ready-to-use executable of the latest development version can be downloaded via HTTP (use the prebuilt win32 version link). Beware that this version can be quite unstable at times.
  • The very latest development source code can be checked-out from GitHub, or downloaded via HTTP.

If you've gone with option 2 or 4, then you will now need to compile CorsixTH. See How To Compile for a guide on doing so.

####4. Runtime Configuration

Note: If using the Windows installer, this step is done at install time.

The next step is to decide where to put saved games and other configuration files. The default location is the logged in user's "AppData" folder for Windows and XDG_CONFIG_HOME or equivalent for Linux and OS X. Continue to step 5 if that sounds good to you. If you want the game to put these files somwehere else, then create a file in the CorsixTH root directory called "config.path.txt" and let it contain one row specifying where to put the files instead. E.g. ~/.config/CorsixTH (where ~ is your home directory)

In-depth information about the Configuration File can be found here.

####5. Go Play!

At this point, you should be ready to try CorsixTH. Windows users should be able to double-click CorsixTH.exe, and users on other platforms should just as easily be able to launch the game executable.

Unless you used the Windows installer you'll be prompted for the original Theme Hospital install location on first startup. Other settings such as resolution can be changed in-game or edited directly in the config.txt file located as specified in step 4.

If things don't go quite so smoothly, then consult the FAQ wiki page and the list of common errors, or ask on the mailing list or on IRC.

####What next?

After trying CorsixTH, you may be interested in sticking around. If you'd like to get slightly more involved, then there are a number of ways to do so:

  • Bug reports - If you've noticed something which is wrong, then please report it at the issue tracker.
  • Testing the latest code - From time to time, when developers think that they fixed something, they end up breaking something else. Hence it is useful if people regularly build from GitHub and report things as they break.
  • Contributing documentation - If you're good at writing, and think that these wiki pages could do with some improvements, then please improve one of the wikipages.
  • Translations - If you'd like to see the game use your preferred language, or if there are mistakes or omissions in the existing translation. Look here for more info.
  • Contributing code - If you'd like to contribute code, then pull requests are always welcomed with open arms. You may want to join the development list for ideas on things to work on, and to get assistance with coding. To contribute code, please submit it as a pull request here on GitHub.
Clone this wiki locally