|
|
OpenTTD readme
|
|
|
Last updated: 2013-04-26
|
|
|
Last updated: 2013-05-23
|
|
|
Release version: 1.3.0
|
|
|
------------------------------------------------------------------------
|
|
|
|
|
|
|
|
|
Table of contents
|
|
|
-----------------
|
|
|
1.0) About
|
|
|
2.0) Contacting
|
|
|
* 2.1) Reporting bugs
|
|
|
* 2.2) Reporting desyncs
|
|
|
3.0) Supported platforms
|
|
|
4.0) Installing and running OpenTTD
|
|
@@ -210,27 +210,27 @@ 4.1.1) Free graphics and sound files
|
|
|
------ -----------------------------
|
|
|
The free data files, split into OpenGFX for graphics, OpenSFX for sounds and
|
|
|
OpenMSX for music can be found at:
|
|
|
- http://www.openttd.org/download-opengfx for OpenGFX
|
|
|
- http://www.openttd.org/download-opensfx for OpenSFX
|
|
|
- http://www.openttd.org/download-openmsx for OpenMSX
|
|
|
Please follow the readme of these packages about the installation procedure.
|
|
|
The Windows installer can optionally download and install these packages.
|
|
|
|
|
|
4.1.2) Original Transport Tycoon Deluxe graphics and sound files
|
|
|
------ ---------------------------------------------------------
|
|
|
If you want to play with the original Transport Tycoon Deluxe data files you
|
|
|
have to copy the data files from the CD-ROM into the data/ directory. It 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.
|
|
|
have to copy the data files from the CD-ROM into the baseset/ directory. It
|
|
|
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:
|
|
|
- sample.cat
|
|
|
- trg1r.grf or TRG1.GRF
|
|
|
- trgcr.grf or TRGC.GRF
|
|
|
- trghr.grf or TRGH.GRF
|
|
|
- trgir.grf or TRGI.GRF
|
|
|
- trgtr.grf or TRGT.GRF
|
|
|
|
|
|
4.1.3) Original Transport Tycoon Deluxe music
|
|
|
------ --------------------------------------
|
|
|
If you want the Transport Tycoon Deluxe music, copy the files from the gm/
|
|
|
folder from the Windows version of Transport Tycoon Deluxe to the baseset
|
|
@@ -401,25 +401,24 @@ However, we receive bug reports because
|
|
|
solving these problems, these potentially unsafe actions are logged in
|
|
|
the savegame (including crash.sav). Log is stored in crash logs, too.
|
|
|
|
|
|
Information logged:
|
|
|
|
|
|
* Adding / removing / changing order of NewGRFs
|
|
|
* Changing NewGRF parameters, loading compatible NewGRF
|
|
|
* Changing game mode (scenario editor <-> normal game)
|
|
|
* Loading game saved in a different OpenTTD / TTDPatch / Transport Tycoon Deluxe /
|
|
|
original Transport Tycoon version
|
|
|
* Running a modified OpenTTD build
|
|
|
* Changing settings affecting NewGRF behaviour (non-network-safe settings)
|
|
|
* Changing landscape (by cheat)
|
|
|
* Triggering NewGRF bugs
|
|
|
|
|
|
No personal information is stored.
|
|
|
|
|
|
You can show the game log by typing 'gamelog' in the console or by running
|
|
|
OpenTTD in debug mode.
|
|
|
|
|
|
|
|
|
6.0) Configuration file
|
|
|
---- ------------------
|
|
|
The configuration file for OpenTTD (openttd.cfg) is in a simple Windows-like
|
|
|
.INI format. It is mostly undocumented. Almost all settings can be changed
|
|
@@ -498,36 +497,38 @@ The following libraries are used by Open
|
|
|
|
|
|
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.
|
|
|
Without libSDL/liballegro on non-Windows and non-MacOS X machines you have
|
|
|
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.
|
|
|
Version 2005 gives bogus warnings about scoping issues.
|
|
|
- GNU Compiler Collection (GCC) 3.3 - 4.7.
|
|
|
- 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.5 and later give invalid warnings when lto is enabled.
|
|
|
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
|
|
|
Version 2.9 gives bogus warnings about code nonconformity.
|
|
|
|
|
|
The following compilers are known not to compile OpenTTD:
|
|
|
- Microsoft Visual C++ (MSVC) 2003 and earlier.
|
|
|
- GNU Compiler Collection (GCC) 3.2 and earlier.
|
|
|
These old versions fail due to OpenTTD's template usage.
|
|
|
- GNU Compiler Collection (GCC) 4.5. It optimizes enums too aggressively.
|
|
|
See http://bugs.openttd.org/task/5513 and references therein.
|
|
|
- Intel C++ Compiler (ICC) 11.1 and earlier.
|
|
|
Version 10.0 and earlier fail a configure check and fail with recent system
|
|
|
headers.
|
|
|
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.
|
|
|
- (Open) Watcom.
|
|
|
|
|
|
If any of these compilers can compile OpenTTD again, please let us know.
|
|
|
Patches to support more compilers are welcome.
|
|
|
|
|
|
7.3) Compilation of base sets
|
|
@@ -573,28 +574,27 @@ You must change the first two lines of t
|
|
|
##ownname Native-Name-Of-Language
|
|
|
|
|
|
Note: Do not alter the following parts of the file:
|
|
|
|
|
|
* String identifiers (the first word on each line)
|
|
|
* Parts of the strings which are in curly braces (such as {STRING})
|
|
|
* Lines beginning with ## (such as ##id), other than the first two lines of
|
|
|
the file
|
|
|
|
|
|
8.2) Previewing
|
|
|
---- ----------
|
|
|
In order to view the translation in the game, you need to compile your language
|
|
|
file with the strgen utility. You can download the precompiled strgen from:
|
|
|
http://www.openttd.org/download-strgen
|
|
|
To compile it yourself just take the normal OpenTTD sources and build that.
|
|
|
During the build process the strgen utility will be made.
|
|
|
file with the strgen utility. As this utility is tailored to a specific OpenTTD
|
|
|
version, you need to compile it yourself. Just take the normal OpenTTD sources
|
|
|
and build that. During the build process the strgen utility will be made.
|
|
|
|
|
|
strgen is a command-line utility. It takes the language filename as parameter.
|
|
|
Example:
|
|
|
|
|
|
strgen lang/german.txt
|
|
|
|
|
|
This results in compiling german.txt and produces another file named german.lng.
|
|
|
Any missing strings are replaced with the English strings. Note that it looks
|
|
|
for english.txt in the lang subdirectory, which is where your language file
|
|
|
should also be.
|
|
|
|
|
|
That is all! You should now be able to select the language in the game options.
|