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

    17

5.0) OpenTTD features

    18

6.0) Configuration File

    19

7.0) Compiling

    20

8.0) Translating

    21

 * 8.1 Guidelines

    22

 * 8.2 Translation

    23

 * 8.3 Previewing

    24

9.0) Troubleshooting

    25

X.X) Credits

    26

    27

    28

1.0) About:

    29

---- ------

    30

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

    31

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

    32

as possible while extending it with new features.

    33

    34

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

    35

more information, see the file 'COPYING'.

    36

    37

2.0) Contacting:

    38

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

    39

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

    40

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

    41

on irc.oftc.net).

    42

    43

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

    44

    45

You can also find the OpenTTD forums at

    46

http://forum.openttd.org/

    47

    48

    49

2.1) Reporting Bugs:

    50

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

    51

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

    52

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

    53

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

    54

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

    55

is not already known.

    56

    57

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

    58

    59

Please include the following information in your bug report:

    60

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

    61

        - Bug details, including instructions how to reproduce it

    62

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

    63

        - Attach a saved game *and* a screenshot if possible

    64

        - If this bug only occurred recently please note the last

    65

          version without the bug and the first version including

    66

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

    67

          changes made.

    68

    69

    70

3.0) Supported Platforms:

    71

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

    72

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

    73

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

    74

are:

    75

    76

  BeOS                 - SDL

    77

  FreeBSD              - SDL

    78

  Linux                - SDL

    79

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

    80

  MorphOS              - SDL

    81

  OpenBSD              - SDL

    82

  OS/2                 - SDL

    83

  Windows              - Win32 GDI (faster) or SDL

    84

    85

    86

4.0) Running OpenTTD:

    87

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

    88

   110

   111

List of the required files:

   118

   125

   129

   183

   184

   185

5.0) OpenTTD features:

   186

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

   187

   188

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

   189

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

   190

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

   191

controlled through the Configure Patches dialog. We also implement some

   192

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

   193

   194

Several important non-standard controls:

   195

   196

* Use Ctrl to place semaphore signals

   197

* Ctrl-D toggles double mode in the Windows version

   198

* Ingame console. More information at

   199

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

   200

   201

   202

6.0) Configuration File:

   203

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

   204

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

   205

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

   206

ingame by using the 'Configure Patches' window.

   207

   208

   209

7.0) Compiling:

   210

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

   211

Windows:

   212

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

   213

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

   214

  you need to add WITH_SDL to the project settings.

   215

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

   216

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

   217

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

   218

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

   219

  into the lib/ directory.

   220

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

   221

   222

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

   223

  Please read the Makefile for more information.

   224

   225

Solaris 10:

   226

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

   227

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

   228

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

   229

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

   230

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

   231

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

   232

   233

Unix:

   234

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

   235

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

   236

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

   237

   238

MacOS X:

   239

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

   240

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

   241

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

   242

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

   243

  instead of "./configure".

   244

   245

BeOS:

   246

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

   247

   248

FreeBSD:

   249

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

   250

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

   251

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

   252

   253

OpenBSD:

   254

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

   255

  Note that you need the port devel/sdl to compile OpenTTD.

   256

   257

MorphOS:

   258

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

   259

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

   260

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

   261

  libpng and freetype2 developer files.

   262

   263

OS/2:

   264

  A comprehensive GNU build environment is required to build the OS/2 version.

   265

  See the docs/Readme_OS2.txt file for more information.

   266

   267

   268

8.0) Translating:

   269

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

   270

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

   271

   272

The use of the online Translator service, located at

   273

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

   274

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

   275

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

   276

read the online help located there.

   277

   278

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

   279

information below might be of help.

   280

   281

8.1) Guidelines:

   282

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

   283

Here are some translation guidelines which you should follow closely.

   284

   285

    * Please contact the development team before beginning the translation

   286

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

   287

      started translating to the same language.

   288

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

   289

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

   290

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

   291

      Latin.

   292

   293

8.2) Translation:

   294

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

   295

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

   296

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

   297

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

   298

   299

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

   300

   301

##name English-Name-Of-Language

   302

##ownname Native-Name-Of-Language

   303

   304

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

   305

   306

    * String identifiers (the first word on each line)

   307

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

   308

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

   309

      the file

   310

   311

8.3) Previewing:

   312

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

   313

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

   314

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

   315

   316

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

   317

Example:

   318

   319

strgen lang/german.txt

   320

   321

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

   322

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

   323

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

   324

should also be.

   325

   326

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

   327

   328

9.0) Troubleshooting

   329

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

   330

   331

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

   332

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

   333

   334

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

   335

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

   336

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

   337

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

   338

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

   339

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

   340

   341

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

   342

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

   343

   344

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

   345

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

   346

for their stability.

   347

   348

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

   349

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

   350

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

   351

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

   352

   353

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

   354

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

   355

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

   356

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

   357

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

   358

   359

X.X) Credits:

   360

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

   361

The OpenTTD team (in alphabetical order):

   362

  Jean-Francois Claeys (Belugas) - GUI, newindustries and more

   363

  Bjarni Corfitzen (Bjarni)      - MacOSX port, coder and vehicles

   364

  Matthijs Kooijman (blathijs)   - Pathfinder-guru, pool rework

   365

  Loïc Guilloux (glx)            - General coding

   367

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

   368

  Jonathan Coome (Maedhros)      - High priest of the newGRF Temple

   369

  Attila Bán (MiHaMiX)           - WebTranslator, Nightlies, Wiki and bugtracker host

   370

  Owen Rudge (orudge)            - Forum host, OS/2 port

   371

  Peter Nelson (peter1138)       - Spiritual descendant from newGRF gods

   372

  Remko Bijker (Rubidium)        - Lead coder and way more

   373

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

   374

  Zdenek Sojka (SmatZ)           - Bug finder and fixer

   375

   376

Inactive Developers:

   377

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

   378

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

   379

  Christoph Mallon (Tron)        - Programmer, code correctness police

   380

   381

Retired Developers:

   382

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

   383

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

   384

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

   385

  Patric Stout (TrueLight)       - Programmer, webhoster (0.3 - pre0.6)

   386

   387

Thanks to:

   388

  Josef Drexler                  - For his great work on TTDPatch.

   389

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

   390

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

   391

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

   392

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

   393

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

   394

  Mike Ragsdale                  - OpenTTD installer

   395

  Cian Duffy (MYOB)              - BeOS port / manual writing

   396

  Christian Rosentreter (tokai)  - MorphOS / AmigaOS port

   397

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

   398

  Michael Blunck                 - For revolutionizing TTD with awesome graphics

   399

  George                         - Canal graphics

   400

  David Dallaston (Pikka)        - Tram tracks

   401

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

   402

  Bug Reporters                  - Thanks for all bug reports

   403

  Chris Sawyer                   - For an amazing game!