OpenTTD README Last updated: 2008-03-04 Release version: 0.6.0-beta5 ------------------------------------------------------------------------ Table of Contents: ------------------ 1.0) About 2.0) Contacting * 2.1 Reporting Bugs 3.0) Supported Platforms 4.0) Installing and running OpenTTD * 4.1 (Required) 3rd party files * 4.2 OpenTTD directories * 4.3 Portable Installations (External Media) 5.0) OpenTTD features 6.0) Configuration File 7.0) Compiling 8.0) Translating * 8.1 Guidelines * 8.2 Translation * 8.3 Previewing 9.0) Troubleshooting X.X) Credits 1.0) About: ---- ------ OpenTTD is a clone of Transport Tycoon Deluxe, a popular game originally written by Chris Sawyer. It attempts to mimic the original game as closely as possible while extending it with new features. OpenTTD is licensed under the GNU General Public License version 2.0. For more information, see the file 'COPYING'. 2.0) Contacting: ---- ---------- The easiest way to contact the OpenTTD team is by submitting bug reports or posting comments in our forums. You can also chat with us on IRC (#openttd on irc.oftc.net). The OpenTTD homepage is http://www.openttd.org/. You can also find the OpenTTD forums at http://forum.openttd.org/ 2.1) Reporting Bugs: ---- --------------- To report a bug, please create a Flyspray account and follow the bugs link from our homepage. Please make sure the bug is reproducible and still occurs in the latest daily build or the current SVN version. Also please look through the existing bug reports briefly to see whether the bug is not already known. The Flyspray project page URL is: http://bugs.openttd.org/ Please include the following information in your bug report: - OpenTTD version (PLEASE test the latest SVN/nightly build) - Bug details, including instructions how to reproduce it - Platform and compiler (Win32, Linux, FreeBSD, ...) - Attach a saved game *and* a screenshot if possible - If this bug only occurred recently please note the last version without the bug and the first version including the bug. That way we can fix it quicker by looking at the changes made. 3.0) Supported Platforms: ---- -------------------- OpenTTD has been ported to several platforms and operating systems. It shouldn't be very difficult to port it to a new platform. The currently working platforms are: BeOS - SDL FreeBSD - SDL Linux - SDL MacOS X (universal) - Cocoa video and sound drivers (SDL works too, but not 100% and not as a universal binary) MorphOS - SDL OpenBSD - SDL OS/2 - SDL Windows - Win32 GDI (faster) or SDL 4.0) Installing and running OpenTTD: ---- ------------------------------- Installing OpenTTD is fairly straightforward. Either you have downloaded an archive which you have to extract to a directory where you want OpenTTD to be installed, or you have downloaded an installer, which will automatically extract OpenTTD in the given directory. OpenTTD looks in multiple locations to find the required data files (described in section 4.2). Installing any 3rd party files into a "shared" location has the advantage that you only need to do this step once, rather than copying the data files into all OpenTTD versions you have. Savegames, screenshots, etc are saved relative to the config file (openttd.cfg) currently being used. This means that if you use a config file in one of the shared directories, savegames will reside in the save/ directory next to the openttd.cfg file there. If you want savegames and screenshots in the directory where the OpenTTD binary resides, simply have your config file in that location. But if you remove this config file, savegames will still be in this directory (see notes in section 4.2) 4.1) (Required) 3rd party files: ---- --------------------------- Before you run OpenTTD, you need to put the game's datafiles into a data/ directory which can be located in various places addressed in the following section. As OpenTTD makes use of the original TTD artwork you will need the files listed below, which you can find on a Transport Tycoon Deluxe CD-ROM. The Windows installer optionally can copy these files from that CD-ROM. List of the required files: - sample.cat - trg1r.grf - trgcr.grf - trghr.grf - trgir.grf - trgtr.grf Alternatively you can use the TTD GRF files from the DOS version: - TRG1.GRF - TRGC.GRF - TRGH.GRF - TRGI.GRF - TRGT.GRF If you want the TTD music, copy the gm/ folder from the Windows version of TTD to your OpenTTD folder (not your data folder - also explained in the following sections). Do NOT copy files included with OpenTTD into "shared" directories (explained in the following sections) as sooner or later you will run into graphical glitches when using other versions of the game. 4.2) OpenTTD directories ---- ------------------------------- The TTD artwork files listed in the section 4.1 "(Required) 3rd party files" can be placed in a few different locations: 1. The current working directory (from where you started OpenTTD) 2. Your personal directory Windows: C:\Documents and Settings\<username>\My Documents\OpenTTD Mac OSX: ~/Documents/OpenTTD Linux: ~/.openttd 3. The shared directory Windows: C:\Documents and Settings\All Users\Documents\OpenTTD Mac OSX: /Library/Application Support/OpenTTD Linux: not available 4. The binary directory (where the OpenTTD executable is) Windows: C:\Program Files\OpenTTD Linux: /usr/games 5. The installation directory (Linux only) Linux: /usr/share/games/openttd 6. The application bundle (Mac OSX only) It includes the OTTD files (grf+lng) and it will work as long as they aren't touched Notes: - Linux in the previous list means .deb, but most paths should be similar for others. - The previous search order is also used for newgrfs and openttd.cfg. - If openttd.cfg is not found, then it will be created using the 2, 4, 1, 3, 5 order. - Savegames will be relative to the config file only if there is no save/ directory in paths with higher priority than the config file path, but autosaves and screenshots will always be relative to the config file. The prefered setup: Place 3rd party files in shared directory (or in personal directory if you don't have write access on shared directory) and have your openttd.cfg config file in personal directory (where the game will then also place savegames and screenshots). 4.3) Portable Installations (External Media): ---- ---------------------------------------- You can install OpenTTD on external media so you can take it with you, i.e. using a USB key, or a USB HDD, etc. Create a directory where you shall store the game in (i.e. OpenTTD/). Copy the binary (OpenTTD.exe, OpenTTD.app, openttd, etc), data/ and your openttd.cfg to this directory. You can copy binaries for any operating system into this directory, which will allow you to play the game on nearly any computer you can attach the external media to. As always - additional grf files are stored in the data/ dir (for details, again, see section 4.1). 5.0) OpenTTD features: ---- ----------------- OpenTTD has a lot of features going beyond the original TTD emulation. Unfortunately, there is currently no comprehensive list of features, but there is a basic features list on the web, and some optional features can be controlled through the Configure Patches dialog. We also implement some features known from TTDPatch (http://www.ttdpatch.net/). Several important non-standard controls: * Use Ctrl to place semaphore signals * Ingame console. More information at http://wiki.openttd.org/index.php/Console 6.0) Configuration File: ---- ------------------- The configuration file for OpenTTD (openttd.cfg) is in a simple Windows-like .INI format. It's mostly undocumented. Almost all settings can be changed ingame by using the 'Configure Patches' window. 7.0) Compiling: ---- ---------- Windows: You need Microsoft Visual Studio .NET. Open the project file and it should build automatically. In case you want to build with SDL support you need to add WITH_SDL to the project settings. PNG (WITH_PNG) and ZLIB (WITH_ZLIB) support is enabled by default. For these to work you need their development files. For best results, download the openttd-useful.zip file from SourceForge under the Files tab. Put the header files into your compiler's include/ directory and the library (.lib) files into the lib/ directory. For more help with VS see docs/Readme_Windows_MSVC.txt. You can also build it using the Makefile with MSYS/MinGW or Cygwin/MinGW. Please read the Makefile for more information. Solaris 10: You need g++ (version 3 or higher), together with SDL. Installation of libpng and zlib is recommended. For the first build it is required to execute "bash configure" first. Note that ./configure does not work yet. It is likely that you don't have a strip binary, so use the --disable-strip option in that case. Fontconfig (>2.3.0) and freetype are optional. "make run" will then run the program. Unix: OpenTTD can be built with GNU "make". On non-GNU systems it's called "gmake". However, for the first build one has to do a "./configure" first. Note that you need SDL-devel 1.2.5 (or higher) to compile OpenTTD. MacOS X: Use "make" or Xcode (which will then call make for you) This will give you a binary for your CPU type (PPC/Intel) However, for the first build one has to do a "./configure" first. To make a universal binary type "./configure --enabled-universal" instead of "./configure". BeOS: Use "make", but do a "./configure" before the first build. FreeBSD: You need the port devel/sdl12 for a non-dedica...
smilingfish8