Getting Started

#The short version

1. Download the appropriate installer or package here: http://code.google.com/p/corsix-th/downloads/

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.

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

5. 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, etc.) - Supported. You can run CorsixTH only in Desktop modus at Windows 8. There's 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.
• 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 in order to use CorsixTH. The game is also available at [gog.com] (http://www.gog.com). 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, and use this for the theme_hospital_install setting later.

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 [http://code.google.com/p/corsix-th/downloads/list download page].
• The source code of the latest stable release can be downloaded as a tarball from the [http://code.google.com/p/corsix-th/downloads/list download page].
• Windows only: A ready-to-use executable of the latest development version can be downloaded via HTTP (use the prebuilt win32 version link).
• The very latest development source code can be checked-out from Subversion, or downloaded via HTTP.

If you've gone with option 2 or 4, then you will now need to compile CorsixTH. See HowToCompile 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. ~/.config/CorsixTH (where ~ is your home directory)

In-depth information about the Configuration File can be found [ConfigurationFile 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. Settings such as resolution can be changed in-game or edited in the config.txt file located as specified in step 4.

If things don't go quite so smoothly, then consult the [FrequentlyAskedQuestions FAQ] wiki page and the [http://code.google.com/p/corsix-th/wiki/HowToCompile#Common_errors list of common errors], or ask on the [http://groups.google.com/group/corsix-th-dev mailing list] or on [IRC 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 [http://code.google.com/p/corsix-th/issues/list 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 [http://code.google.com/p/corsix-th/source/checkout Subversion] 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 get in touch on the [http://groups.google.com/group/corsix-th-dev development list].
• 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)[http://forums.corsixth.com/index.php/board,11.0.html?PHPSESSID=06642361b55e26e3d83e1fba117b7b70] for more info.
• Contributing patches - If you'd like to contribute code, then patches are always welcomed with open arms. You may want to join the (development list)[http://groups.google.com/group/corsix-th-dev] for ideas on things to work on, and to get assistance with coding. To contribute code, please [http://code.google.com/p/corsix-th/issues/entry?template=Patch%20from%20user submit it as a patch] to the issue tracker (Subversion access can be obtained after several good patches).