1

OpenTTD README

     2

Last updated:    2005-09-09

     3

Release version: 0.4.1

     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.freenode.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 SourceForge 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 SourceForge project page URL is: http://sourceforge.net/projects/openttd/

    55

Click on "Bugs" to see the bug tracker.

    56

    57

Please include the following information in your bug report:

    58

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

    59

        - Bug details, including instructions how to reproduce it

    60

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

    61

        - Attach a saved game or a screenshot if possible

    62

        - If this bug only occurred recently please note the last

    63

          version without the bug and the first version including

    64

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

    65

          changes made.

    66

    67

    68

3.0) Supported Platforms:

    69

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

    70

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

    71

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

    72

are:

    73

    81

    82

    83

4.0) Running OpenTTD:

    84

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

    85

    86

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

    87

subdirectory. You need the following files from the original version

    88

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

    89

    90

List of the required files:

    91

sample.cat

    92

trg1r.grf

    93

trgcr.grf

    94

trghr.grf

    95

trgir.grf

    96

trgtr.grf

    97

    98

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

    99

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

   100

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

   101

look as nice as with the Windows graphics.)

   102

   103

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

   104

OpenTTD folder, not your data folder.

   105

   106

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

   107

Makefile.config by setting DATA_DIR_PREFIX and USE_HOMEDIR.

   108

   109

   110

5.0) OpenTTD features:

   111

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

   112

   113

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

   114

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

   115

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

   116

controlled through the Configure Patches dialog. We also implement some

   117

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

   118

   119

Several important non-standard controls:

   120

   121

* Use Ctrl to place semaphore signals

   122

* Ctrl-D toggles double mode in the Windows version

   123

* Ingame console. More information at

   124

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

   125

   126

   127

6.0) Configuration File:

   128

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

   129

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

   130

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

   131

ingame by using the 'Configure Patches' window.

   132

   133

   134

7.0) Compiling:

   135

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

   136

Windows:

   137

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

   138

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

   139

  you need to add WITH_SDL to the project settings.

   140

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

   141

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

   142

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

   143

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

   144

  into the lib/ directory.

   145

  For more help with VS6 see docs/Readme_Windows_MSVC6.0.txt.

   146

   147

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

   148

  Please read the Makefile for more information.

   149

   150

Unix:

   151

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

   152

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

   153

  (see also docs/Readme_Mandrake_Linux.txt)

   154

   157

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

   158

	To make an universal binary type "make FAT_BINARY:=1"

   159

   160

BeOS:

   161

  Use "make".

   162

   163

FreeBSD:

   164

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

   165

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

   166

  Use "gmake".

   167

   168

MorphOS:

   169

  Use "make". Note that you need the MorphOS SDK and the

   170

  powersdl.library SDK.

   171

   172

OS/2:

   173

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

   174

  docs/Readme_OS2.txt file for more information.

   175

   176

   177

8.0) Translating:

   178

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

   179

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

   180

   181

The use of the online Translator service, located at

   182

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

   183

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

   184

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

   185

read the online help located there.

   186

   187

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

   188

information below might be of help.

   189

   190

8.1) Guidelines:

   191

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

   192

Here are some translation guidelines which you should follow closely.

   193

   194

    * Please contact the development team before begining the translation

   195

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

   196

      started translating to the same language.

   197

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

   198

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

   199

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

   200

      Latin.

   201

   202

8.2) Translation:

   203

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

   204

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

   205

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

   206

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

   207

   208

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

   209

   210

##name English-Name-Of-Language

   211

##ownname Native-Name-Of-Language

   212

   213

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

   214

   215

    * String identifiers (the first word on each line)

   216

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

   217

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

   218

      the file

   219

   220

8.3) Previewing:

   221

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

   222

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

   223

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

   224

   225

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

   226

Example:

   227

   228

strgen lang/german.txt

   229

   230

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

   231

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

   232

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

   233

should also be.

   234

   235

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

   236

   237

9.0) Troubleshooting

   238

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

   239

   240

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

   241

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

   242

   243

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

   244

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

   245

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

   246

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

   247

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

   248

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

   249

   250

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

   251

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

   252

   253

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

   254

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

   255

for their stability.

   256

   257

X.X) Credits:

   258

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

   259

The OpenTTD team (in alphabetical order):

   260

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

   261

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

   262

  Tamás Faragó (Darkvater)       - Lead programmer

   263

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

   264

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

   265

  Peter Nelson (peter1138)       - NewGRF support wizard, OpenTTD addict

   266

  Christoph Mallon (Tron)        - Programmer, code correctness police

   267

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

   268

   269

Retired Developers:

   270

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

   271

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

   272

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

   273

   274

Thanks to:

   275

  Josef Drexler - For his great work on TTDPatch.

   276

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

   277

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

   278

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

   279

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

   280

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

   281

  Mike Ragsdale - OpenTTD installer

   282

  Cian Duffy (MYOB) - BeOS port / manual writing

   283

  Christian Rosentreter (tokaiz) - MorphOS / AmigaOS port

   284

  Michael Blunck - For revolutionizing TTD with awesome graphics

   285

  George - Canal graphics

   286

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

   287

  Bug Reporters - Thanks for all bug reports

   288

  Chris Sawyer - For an amazing game!