posting comments in our forums. You can also chat with us on IRC (#openttd

on irc.oftc.net).

### 2.1) Reporting bugs

like this readme.

For tracking our bugs we are using GitHub's issue tracker. You can find

When you are sure it is not already reported you should:

- Bug details, including instructions how to reproduce it

- Platform (Windows, Linux, FreeBSD, …) and compiler (including version) if

   you compiled OpenTTD yourself.

- 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

- DOS (Allegro)

- FreeBSD (SDL)

- Linux (SDL or Allegro)

- MorphOS (SDL)

- OpenBSD (SDL)

- OS/2 (SDL)

The free data files, split into OpenGFX for graphics, OpenSFX for sounds and

OpenMSX for music can be found at:

Please follow the readme of these packages about the installation procedure.

The Windows installer can optionally download and install these packages.

does not matter whether you copy them from the DOS or Windows version of

Transport Tycoon Deluxe. The Windows install can optionally copy these files.

You need to copy the following files:

#### 4.1.3) Original Transport Tycoon Deluxe music

If you want the Transport Tycoon Deluxe music, copy the appropriate files from

the original game into the baseset folder.

#### 4.1.4) AIs

download system download the tar file and place it in the ai/ directory. If the

AI needs libraries you will have to download those too and put them in the

ai/library/ directory. All AIs and AI Libraries that have been uploaded to

The AIs and libraries can be found their in the form of .tar.gz packages.

To figure out which libraries you need for an AI you have to start the AI and

wait for an error message to pop up. The error message will tell you

1. The current working directory (from where you started OpenTTD)

2. Your personal directory

    - Windows:

        - `C:\My Documents\OpenTTD` (95, 98, ME)

        - `C:\Documents and Settings\<username>\My Documents\OpenTTD` (2000, XP)

    - Linux: `$XDG_DATA_HOME/openttd` which is usually `~/.local/share/openttd`

3. The shared directory

    - Windows:

        - `C:\Documents and Settings\All Users\Shared Documents\OpenTTD` (2000, XP)

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

Different types of data or extensions go into different subdirectories of the

chosen main OpenTTD directory:

| --- | --- | --- |

| Config File | (no subdirectory) | |

| Screenshots | screenshot | |

| GS Libraries | game/library | (or a subdirectory thereof) |

| Savegames | save | |

| Automatic Savegames | save/autosave | |

#### Notes:

- Linux in the previous list means .deb, but most paths should be similar for

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

- Savegames will be relative to the config file only if there is no save/

#### The preferred setup:

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 Advanced Settings dialog. We also implement some

Several important non-standard controls:

- Ctrl modifies many commands and makes them more powerful. For example Ctrl

- Hovering over a GUI element shows tooltips. This can be changed to right click

### 5.1) Logging of potentially dangerous actions

- Changing NewGRF parameters, loading compatible NewGRF

- Changing game mode (scenario editor <-> normal game)

- Loading game saved in a different OpenTTD / TTDPatch / Transport Tycoon Deluxe /

- Running a modified OpenTTD build

- Changing settings affecting NewGRF behaviour (non-network-safe settings)

- Triggering NewGRF bugs

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

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.

OpenTTD can be built with GNU '`make`'. On non-GNU systems it is called '`gmake`'.

However, for the first build one has to do a '`./configure`' first.

Use '`make`' or Xcode (which will then call make for you)

This will give you a binary for your CPU type (PPC/Intel)

- libSDL/liballegro: hardware access (video, sound, mouse)

- zlib: (de)compressing of old (0.3.0-1.0.5) savegames, content downloads,

- liblzo2: (de)compressing of old (pre 0.3.0) savegames

- liblzma: (de)compressing of savegames (1.1.0 and later)

- libpng: making screenshots and loading heightmaps

- libfreetype: loading generic fonts and rendering them

- libfontconfig: searching for fonts, resolving font names to actual fonts

- libicu: handling of right-to-left scripts (e.g. Arabic and Persian) and

OpenTTD does not require any of the libraries to be present, but without

liblzma you cannot open most recent savegames and without zlib you cannot

open most older savegames or use the content downloading system.

no graphical user interface; you would be building a dedicated server.

### 7.2) Supported compilers

The following compilers are known to compile OpenTTD:

- Microsoft Visual C++ (MSVC) 2005, 2008 and 2010.

- GNU Compiler Collection (GCC) 3.3 - 4.4, 4.6 - 4.8.

    - Versions 4.1 and earlier give bogus warnings about uninitialised variables.

    - Versions 4.4, 4.6 give bogus warnings about freeing non-heap objects.

    - Versions 4.6 and later give invalid warnings when lto is enabled.

- Intel C++ Compiler (ICC) 12.0.

- Clang/LLVM 2.9 - 3.0

The following compilers are known not to compile OpenTTD:

- Microsoft Visual C++ (MSVC) 2003 and earlier.

- GNU Compiler Collection (GCC) 3.2 and earlier.

- GNU Compiler Collection (GCC) 4.5. It optimizes enums too aggressively.

- Intel C++ Compiler (ICC) 11.1 and earlier.

    - Version 10.0 and earlier fail a configure check and fail with recent

    - Version 10.1 fails to compile station_gui.cpp.

    - Version 11.1 fails with an internal error when compiling network.cpp.

- Clang/LLVM 2.8 and earlier.

To recompile the extra graphics needed to play with the original Transport

Tycoon Deluxe graphics you need GRFCodec (which includes NFORenum) as well.

The compilation of these extra graphics does generally not happen, unless

you remove the graphics file using '`make maintainer-clean`'.

## 8.0) Translating

The use of the online Translator service, located at

If for some reason the website is down for a longer period of time, the

information below might be of help.

before beginning the translation process! This avoids double work, as

someone else may have already started translating to the same language.

- String identifiers (the first word on each line)

- Parts of the strings which are in curly braces (such as {STRING})

### 8.2) Previewing

debugging output. The 'name' variable can help you to display only some type of

debugging messages. This is mostly undocumented so best is to look in the

source code file debug.c for the various debugging types. For more information

The most frequent problem is missing data files. Please install OpenGFX and

possibly OpenSFX and OpenMSX. See section 4.1.1 for more information.

You should use a font name like 'Tahoma' or a path to the desired font.

You can try to obtain the missing files from that NewGRF dialogue or – if they

## 10.0) Licensing

The CWSDPMI implementation in os/dos/cwsdpmi is distributed under a

custom binary-only license that prohibits modification. The exact

licensing terms can be found in os/dos/cwsdpmi/cwsdpmi.txt. The sources

terms for Bootstrap documentation.

## X.X) Credits

### Inactive Developers:

- Jean-François Claeys (Belugas) - GUI, newindustries and more (0.4.5 - 1.0)

- Victor Fischer (Celestar) - Programming everywhere you need him to (0.3 - 0.6)

- Jaroslav Mazanec (KUDr) - YAPG (Yet Another Pathfinder God) ;) (0.4.5 - 0.6)

- Jonathan Coome (Maedhros) - High priest of the NewGRF Temple (0.5 - 0.6)

- Tamás Faragó (Darkvater) - Ex-Lead coder (0.3 - 0.5)

- Dominik Scherer (dominik81) - Lead programmer, GUI expert (0.3 - 0.3)

- Simon Sasburg (HackyKid) - Bug fixer (0.4 - 0.4.5)

- Ludvig Strigeus (ludde) - Original author of OpenTTD, main coder (0.1 - 0.3)

- Petr Baudiš (pasky) - Many patches, newgrf support, etc. (0.3 - 0.3)

- Benedikt Brüggemeier (skidd13) - Bug fixer and code reworker (0.6 - 0.7)

- Serge Paquet (vurlix) - 2nd contributor after ludde (0.1 - 0.3)

- All Translators - For their support to make OpenTTD a truly international game

- Bug Reporters - Thanks for all bug reports

- Chris Sawyer - For an amazing game!