1

OpenTTD README

     4

------------------------------------------------------------------------

     5

     6

     7

Table of Contents:

     8

------------------

     9

1.0) About

    10

2.0) Contacting

    11

 * 2.1 Reporting Bugs

    12

3.0) Supported Platforms

    13

4.0) Running OpenTTD

    14

5.0) OpenTTD features

    15

6.0) Configuration File

    16

7.0) Compiling

    17

8.0) Translating

    18

 * 8.1 Guidelines

    19

 * 8.2 Translation

    20

 * 8.3 Previewing

    21

9.0) Troubleshooting

    22

X.X) Credits

    23

    24

    25

1.0) About:

    26

---- ------

    27

OpenTTD is a clone of Transport Tycoon Deluxe, a popular game originally

    28

written by Chris Sawyer.  It attempts to mimic the original game as closely

    29

as possible while extending it with new features.

    30

    31

OpenTTD is licensed under the GNU General Public License version 2.0. For

    32

more information, see the file 'COPYING'.

    33

    34

2.0) Contacting:

    35

---- ----------

    36

The easiest way to contact the OpenTTD team is by submitting bug reports or

    37

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

    38

on irc.oftc.net).

    39

    40

The OpenTTD homepage is http://www.openttd.org/.

    41

    42

You can also find the OpenTTD forums at

    43

http://www.tt-forums.net/index.php?c=20

    44

    45

    46

2.1) Reporting Bugs:

    47

---- ---------------

    48

To report a bug, please create a Flyspray account and follow the bugs

    49

link from our homepage. Please make sure the bug is reproducible and

    50

still occurs in the latest daily build or the current SVN version. Also

    51

please look through the existing bug reports briefly to see whether the bug

    52

is not already known.

    53

    54

The Flyspray project page URL is: http://bugs.openttd.org/

    55

    56

Please include the following information in your bug report:

    57

        - OpenTTD version (PLEASE test the latest SVN/nightly build)

    58

        - Bug details, including instructions how to reproduce it

    59

        - Platform and compiler (Win32, Linux, FreeBSD, ...)

    60

        - Attach a saved game or a screenshot if possible

    61

        - If this bug only occurred recently please note the last

    62

          version without the bug and the first version including

    63

          the bug. That way we can fix it quicker by looking at the

    64

          changes made.

    65

    66

    67

3.0) Supported Platforms:

    68

---- --------------------

    69

OpenTTD has been ported to several platforms and operating systems. It shouldn't

    70

be very difficult to port it to a new platform. The currently working platforms

    71

are:

    72

    73

  BeOS                 - SDL

    74

  FreeBSD              - SDL

    75

  Linux                - SDL

    76

  MacOS X (universal)  - Cocoa video and sound drivers (SDL works too, but not 100% and not as a universal binary)

    77

  MorphOS              - SDL

    78

  OS/2                 - SDL

    79

  Windows              - Win32 GDI (faster) or SDL

    80

    81

    82

4.0) Running OpenTTD:

    83

---- ----------------

    84

    85

Before you run OpenTTD, you need to put the game's datafiles into the data/

    86

subdirectory. You need the following files from the original version

    87

of TTD as OpenTTD makes use of the original TTD artwork.

    88

    89

List of the required files:

    90

sample.cat

    91

trg1r.grf

    92

trgcr.grf

    93

trghr.grf

    94

trgir.grf

    95

trgtr.grf

    96

    97

(Alternatively you can use the TTD GRF files from the DOS version: TRG1.GRF,

    98

TRGC.GRF, TRGH.GRF, TRGI.GRF, TRGT.GRF. A few minor graphical glitches with

    99

the DOS graphics remain. E.g. the autorail button in the rail toolbar doesn't

   100

look as nice as with the Windows graphics.)

   101

   102

If you want music you need to copy the gm/ folder from Windows TTD into your

   103

OpenTTD folder, not your data folder.

   104

   105

You can change the data path (which contains savegames as well) in

   106

Makefile.config by setting DATA_DIR_PREFIX and USE_HOMEDIR.

   107

   108

   109

5.0) OpenTTD features:

   110

---- -----------------

   111

   112

OpenTTD has a lot of features going beyond the original TTD emulation.

   113

Unfortunately, there is currently no comprehensive list of features, but there

   114

is a basic features list on the web, and some optional features can be

   115

controlled through the Configure Patches dialog. We also implement some

   116

features known from TTDPatch (http://www.ttdpatch.net/).

   117

   118

Several important non-standard controls:

   119

   120

* Use Ctrl to place semaphore signals

   121

* Ctrl-D toggles double mode in the Windows version

   122

* Ingame console. More information at

   123

  http://wiki.openttd.org/index.php/Console

   124

   125

   126

6.0) Configuration File:

   127

---- -------------------

   128

The configuration file for OpenTTD (openttd.cfg) is in a simple Windows-like

   129

.INI format. It's mostly undocumented. Almost all settings can be changed

   130

ingame by using the 'Configure Patches' window.

   131

   132

   133

7.0) Compiling:

   134

---- ----------

   135

Windows:

   136

  You need Microsoft Visual Studio .NET. Open the project file

   137

  and it should build automatically. In case you want to build with SDL support

   138

  you need to add WITH_SDL to the project settings.

   139

  PNG (WITH_PNG) and ZLIB (WITH_ZLIB) support is enabled by default. For these

   140

  to work you need their development files. For best results, download the

   141

  openttd-useful.zip file from SourceForge under the Files tab. Put the header

   142

  files into your compiler's include/ directory and the library (.lib) files

   143

  into the lib/ directory.

   144

  For more help with VS see docs/Readme_Windows_MSVC.txt.

   145

   146

  You can also build it using the Makefile with MSYS/MinGW or Cygwin/MinGW.

   147

  Please read the Makefile for more information.

   148

   149

Solaris 10:

   150

  You need g++ (version 3 or higher), together with SDL. Installation of

   151

  libpng and zlib is recommended. For the first build it is required

   152

  to execute "bash configure" first. Note that ./configure does not work

   153

  yet. It is likely that you don't have a strip binary, so use the

   154

  --disable-strip option in that case. Fontconfig (>2.3.0) and freetype

   155

  are optional. "make run" will then run the program.

   156

   157

Unix:

   158

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

   159

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

   160

  Note that you need SDL-devel 1.2.5 (or higher) to compile OpenTTD.

   161

   162

MacOS X:

   163

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

   164

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

   165

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

   166

  To make a universal binary type "./configure --enabled-universal"

   167

  instead of "./configure".

   168

   169

BeOS:

   170

  Use "make", but do a "./configure" before the first build.

   171

   172

FreeBSD:

   173

  You need the port devel/sdl12 for a non-dedicated build.

   174

  graphics/png is optional for screenshots in the PNG format.

   175

  Use "gmake", but do a "./configure" before the first build.

   176

   177

MorphOS:

   178

  Use "make". However, for the first build one has to do a "./configure" first.

   179

  Note that you need the MorphOS SDK, latest libnix updates (else C++ parts of

   180

  OpenTTD will not build) and the powersdl.library SDK. Optionally libz,

   181

  libpng and freetype2 developer files.

   182

   183

OS/2:

   184

  Open Watcom C/C++ 1.3 or later is required to build the OS/2 version. See the

   185

  docs/Readme_OS2.txt file for more information.

   186

   187

   188

8.0) Translating:

   189

---- -------------------

   190

See http://www.openttd.org/translating.php for up-to-date information.

   191

   192

The use of the online Translator service, located at

   193

http://translator2.openttd.org/, is highly encouraged. For a username/password

   194

combo you should contact the development team, either by mail, IRC or the

   195

forums. The system is straightforward to use, and if you have any problems,

   196

read the online help located there.

   197

   198

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

   199

information below might be of help.

   200

   201

8.1) Guidelines:

   202

---- -------------------

   203

Here are some translation guidelines which you should follow closely.

   204

   205

    * Please contact the development team before beginning the translation

   206

      process! This avoids double work, as someone else may have already

   207

      started translating to the same language.

   208

    * Translators must use the character set ISO 8859-15.

   209

      Otherwise, some characters will not display correctly in the game.

   210

    * Currently it is not possible to translate into character sets other than

   211

      Latin.

   212

   213

8.2) Translation:

   214

---- -------------------

   215

So, now that you've notified the development team about your intention to

   216

translate (You did, right? Of course you did.) you can pick up english.txt

   217

(found in the SVN repository under /lang) and translate.

   218

   219

You must change the first two lines of the file appropriately:

   220

   221

##name English-Name-Of-Language

   222

##ownname Native-Name-Of-Language

   223

   224

Note: Do not alter the following parts of the file:

   225

   226

    * String identifiers (the first word on each line)

   227

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

   228

    * Lines beginning with ## (such as ##id), other than the first two lines of

   229

      the file

   230

   231

8.3) Previewing:

   232

---- -------------------

   233

In order to view the translation in the game, you need to compile your language

   234

file with the strgen utility, which is now bundled with the game.

   235

   236

strgen is a command-line utility. It takes the language filename as parameter.

   237

Example:

   238

   239

strgen lang/german.txt

   240

   241

This results in compiling german.txt and produces another file named german.lng.

   242

Any missing strings are replaced with the English strings. Note that it looks

   243

for english.txt in the lang subdirectory, which is where your language file

   244

should also be.

   245

   246

That's all! You should now be able to select the language in the game options.

   247

   248

9.0) Troubleshooting

   249

---- ---------------

   250

   251

To see all startup options available to you, start OpenTTD with the

   252

"./openttd -h" option. This might help you tweak some of the settings.

   253

   254

If the game is acting strange and you feel adventurous you can try the

   255

"-d [[<name>]=[<level>]" flag, where the higher levels will give you more

   256

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

   257

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

   258

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

   259

look at http://wiki.openttd.org/index.php/Command_line.

   260

   261

The most frequent problem is missing data files. Don't forget to put all GRF

   262

files from TTD into your data/ folder including sample.cat!

   263

   264

Under Windows 98 and lower it is impossible to use a dedicated server; it will

   265

fail to start. Perhaps this is for the better because those OS's are not known

   266

for their stability.

   267

   268

With the added support for font-based text selecting a non-latin language will

   269

result in garbage (lots of '?') shown on screen. Please open your configuration

   270

file and add a desired font for small/medium/-and large_font. This can be a font

   271

name like "Tahoma" or a path to a font.

   272

   273

Any NewGRF file used in a game is stored inside the savegame and will refuse

   274

to load if you don't have that grf file available. A list of missing files

   275

will be output to the console at the moment, so use the '-d' flag (on windows)

   276

to see this list. You just have to find the files (http://grfcrawler.tt-forums.net/)

   277

put them in the data/ folder and you're set to go.

   278

   279

X.X) Credits:

   280

---- --------

   281

The OpenTTD team (in alphabetical order):

   282

  Jean-Francois Claeys (Belugas) - In training, not yet specialized

   283

  Bjarni Corfitzen (Bjarni)      - Mac OS X port, coder

   284

  Matthijs Kooijman (blathijs)   - Pathfinder-guru

   285

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

   286

  Tamás Faragó (Darkvater)       - Lead programmer

   287

  Loïc Guilloux (glx)            - In training, not yet specialized

   288

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

   289

  Kerekes Miham (MiHaMiX)        - Maintainer of translator service, and host of nightlies

   290

   291

  Peter Nelson (peter1138)       - Spiritual descendant from newgrf gods

   292

  Remko Bijker (Rubidium)        - THE desync hunter

   293

  Christoph Mallon (Tron)        - Programmer, code correctness police

   294

  Patric Stout (TrueLight)       - Programmer, network guru, SVN-repository and website host

   295

   296

Retired Developers:

   297

  Dominik Scherer (dominik81)    - Lead programmer, GUI expert (0.3.0 - 0.3.6)

   298

  Owen Rudge (orudge)            - Contributor, forum host, master server host, OS/2 port (0.1 - 0.4.8)

   299

  Ludvig Strigeus (ludde)        - OpenTTD author, main coder (0.1 - 0.3.3)

   300

  Serge Paquet (vurlix)          - Assistant project manager, coder (0.1 - 0.3.3)

   301

   302

Thanks to:

   303

  Josef Drexler                  - For his great work on TTDPatch.

   304

  Marcin Grzegorczyk             - For his TTDPatch work and documentation of TTD internals and graphics (signals and track foundations)

   305

  Matthijs Kooijman (blathijs)   - For his many patches, suggestions and major work on maprewrite

   306

  Petr Baudis (pasky)            - Many patches, newgrf support, etc.

   307

  Simon Sasburg (HackyKid)       - For the many bugfixes he has blessed us with (and future PBS)

   308

  Stefan Meißner (sign_de)       - For his work on the console

   309

  Mike Ragsdale                  - OpenTTD installer

   310

  Cian Duffy (MYOB)              - BeOS port / manual writing

   311

  Christian Rosentreter (tokai)  - MorphOS / AmigaOS port

   312

  Richard Kempton (RichK67)      - Additional airports, initial TGP implementation

   313

  Michael Blunck                 - For revolutionizing TTD with awesome graphics

   314

  George                         - Canal graphics

   315

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

   316

  Bug Reporters                  - Thanks for all bug reports

   317

  Chris Sawyer                   - For an amazing game!