annotate readme.txt @ 11464:56ddb993f77d draft

(svn r15822) -Codechange: replace some magic numbers and improve alignment of the start server window.
author rubidium <rubidium@openttd.org>
date Sun, 22 Mar 2009 23:38:29 +0000
parents 371d9d118d1d
children dd5b77965bb5
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
0
fa6ee4d75c8a (svn r1) Import of revision 975 of old (crashed) SVN
truelight <truelight@openttd.org>
parents:
diff changeset
1 OpenTTD README
11311
08424c8f7885 (svn r15660) -Prepare: for 0.7.0-beta2 (ofcourse)
rubidium <rubidium@openttd.org>
parents: 11225
diff changeset
2 Last updated: 2009-03-10
08424c8f7885 (svn r15660) -Prepare: for 0.7.0-beta2 (ofcourse)
rubidium <rubidium@openttd.org>
parents: 11225
diff changeset
3 Release version: 0.7.0-beta2
0
fa6ee4d75c8a (svn r1) Import of revision 975 of old (crashed) SVN
truelight <truelight@openttd.org>
parents:
diff changeset
4 ------------------------------------------------------------------------
fa6ee4d75c8a (svn r1) Import of revision 975 of old (crashed) SVN
truelight <truelight@openttd.org>
parents:
diff changeset
5
fa6ee4d75c8a (svn r1) Import of revision 975 of old (crashed) SVN
truelight <truelight@openttd.org>
parents:
diff changeset
6
fa6ee4d75c8a (svn r1) Import of revision 975 of old (crashed) SVN
truelight <truelight@openttd.org>
parents:
diff changeset
7 Table of Contents:
fa6ee4d75c8a (svn r1) Import of revision 975 of old (crashed) SVN
truelight <truelight@openttd.org>
parents:
diff changeset
8 ------------------
fa6ee4d75c8a (svn r1) Import of revision 975 of old (crashed) SVN
truelight <truelight@openttd.org>
parents:
diff changeset
9 1.0) About
fa6ee4d75c8a (svn r1) Import of revision 975 of old (crashed) SVN
truelight <truelight@openttd.org>
parents:
diff changeset
10 2.0) Contacting
fa6ee4d75c8a (svn r1) Import of revision 975 of old (crashed) SVN
truelight <truelight@openttd.org>
parents:
diff changeset
11 * 2.1 Reporting Bugs
fa6ee4d75c8a (svn r1) Import of revision 975 of old (crashed) SVN
truelight <truelight@openttd.org>
parents:
diff changeset
12 3.0) Supported Platforms
7686
48c969ebb8ba (svn r11217) -Update: the readme as some things weren't quite right anymore.
rubidium <rubidium@openttd.org>
parents: 7588
diff changeset
13 4.0) Installing and running OpenTTD
8659
8a48f9c9188e (svn r12321) -Change: update readme about where openttd looks for files (based on dih work)
glx <glx@openttd.org>
parents: 8605
diff changeset
14 * 4.1 (Required) 3rd party files
8a48f9c9188e (svn r12321) -Change: update readme about where openttd looks for files (based on dih work)
glx <glx@openttd.org>
parents: 8605
diff changeset
15 * 4.2 OpenTTD directories
8a48f9c9188e (svn r12321) -Change: update readme about where openttd looks for files (based on dih work)
glx <glx@openttd.org>
parents: 8605
diff changeset
16 * 4.3 Portable Installations (External Media)
0
fa6ee4d75c8a (svn r1) Import of revision 975 of old (crashed) SVN
truelight <truelight@openttd.org>
parents:
diff changeset
17 5.0) OpenTTD features
fa6ee4d75c8a (svn r1) Import of revision 975 of old (crashed) SVN
truelight <truelight@openttd.org>
parents:
diff changeset
18 6.0) Configuration File
fa6ee4d75c8a (svn r1) Import of revision 975 of old (crashed) SVN
truelight <truelight@openttd.org>
parents:
diff changeset
19 7.0) Compiling
fa6ee4d75c8a (svn r1) Import of revision 975 of old (crashed) SVN
truelight <truelight@openttd.org>
parents:
diff changeset
20 8.0) Translating
fa6ee4d75c8a (svn r1) Import of revision 975 of old (crashed) SVN
truelight <truelight@openttd.org>
parents:
diff changeset
21 * 8.1 Guidelines
fa6ee4d75c8a (svn r1) Import of revision 975 of old (crashed) SVN
truelight <truelight@openttd.org>
parents:
diff changeset
22 * 8.2 Translation
fa6ee4d75c8a (svn r1) Import of revision 975 of old (crashed) SVN
truelight <truelight@openttd.org>
parents:
diff changeset
23 * 8.3 Previewing
1703
2bd7418694e2 (svn r2207) - Update readme.txt about some windows compilation and troubleshooting running openttd without a soundcard.
Darkvater <Darkvater@openttd.org>
parents: 1694
diff changeset
24 9.0) Troubleshooting
0
fa6ee4d75c8a (svn r1) Import of revision 975 of old (crashed) SVN
truelight <truelight@openttd.org>
parents:
diff changeset
25 X.X) Credits
fa6ee4d75c8a (svn r1) Import of revision 975 of old (crashed) SVN
truelight <truelight@openttd.org>
parents:
diff changeset
26
fa6ee4d75c8a (svn r1) Import of revision 975 of old (crashed) SVN
truelight <truelight@openttd.org>
parents:
diff changeset
27
fa6ee4d75c8a (svn r1) Import of revision 975 of old (crashed) SVN
truelight <truelight@openttd.org>
parents:
diff changeset
28 1.0) About:
fa6ee4d75c8a (svn r1) Import of revision 975 of old (crashed) SVN
truelight <truelight@openttd.org>
parents:
diff changeset
29 ---- ------
fa6ee4d75c8a (svn r1) Import of revision 975 of old (crashed) SVN
truelight <truelight@openttd.org>
parents:
diff changeset
30 OpenTTD is a clone of Transport Tycoon Deluxe, a popular game originally
fa6ee4d75c8a (svn r1) Import of revision 975 of old (crashed) SVN
truelight <truelight@openttd.org>
parents:
diff changeset
31 written by Chris Sawyer. It attempts to mimic the original game as closely
fa6ee4d75c8a (svn r1) Import of revision 975 of old (crashed) SVN
truelight <truelight@openttd.org>
parents:
diff changeset
32 as possible while extending it with new features.
fa6ee4d75c8a (svn r1) Import of revision 975 of old (crashed) SVN
truelight <truelight@openttd.org>
parents:
diff changeset
33
1734
d37fcb08ac21 (svn r2238) - [ 1184377 ] Update to OpenTTD readme (orudge)
Darkvater <Darkvater@openttd.org>
parents: 1703
diff changeset
34 OpenTTD is licensed under the GNU General Public License version 2.0. For
d37fcb08ac21 (svn r2238) - [ 1184377 ] Update to OpenTTD readme (orudge)
Darkvater <Darkvater@openttd.org>
parents: 1703
diff changeset
35 more information, see the file 'COPYING'.
0
fa6ee4d75c8a (svn r1) Import of revision 975 of old (crashed) SVN
truelight <truelight@openttd.org>
parents:
diff changeset
36
fa6ee4d75c8a (svn r1) Import of revision 975 of old (crashed) SVN
truelight <truelight@openttd.org>
parents:
diff changeset
37 2.0) Contacting:
fa6ee4d75c8a (svn r1) Import of revision 975 of old (crashed) SVN
truelight <truelight@openttd.org>
parents:
diff changeset
38 ---- ----------
fa6ee4d75c8a (svn r1) Import of revision 975 of old (crashed) SVN
truelight <truelight@openttd.org>
parents:
diff changeset
39 The easiest way to contact the OpenTTD team is by submitting bug reports or
fa6ee4d75c8a (svn r1) Import of revision 975 of old (crashed) SVN
truelight <truelight@openttd.org>
parents:
diff changeset
40 posting comments in our forums. You can also chat with us on IRC (#openttd
5404
2a651add2378 (svn r7600) -Remove: out-dated documentation about console and Mandrake Readme.
rubidium <rubidium@openttd.org>
parents: 5397
diff changeset
41 on irc.oftc.net).
0
fa6ee4d75c8a (svn r1) Import of revision 975 of old (crashed) SVN
truelight <truelight@openttd.org>
parents:
diff changeset
42
250
9995f44f61b7 (svn r251) -Project ready for 0.3.4 release. Updated installer, readme and fileinformation
darkvater <darkvater@openttd.org>
parents: 222
diff changeset
43 The OpenTTD homepage is http://www.openttd.org/.
0
fa6ee4d75c8a (svn r1) Import of revision 975 of old (crashed) SVN
truelight <truelight@openttd.org>
parents:
diff changeset
44
1734
d37fcb08ac21 (svn r2238) - [ 1184377 ] Update to OpenTTD readme (orudge)
Darkvater <Darkvater@openttd.org>
parents: 1703
diff changeset
45 You can also find the OpenTTD forums at
7908
7519c50587e5 (svn r11460) -Documentation: update some documentation to better match the current state and the state in the nearby future of OpenTTD.
rubidium <rubidium@openttd.org>
parents: 7859
diff changeset
46 http://forum.openttd.org/
0
fa6ee4d75c8a (svn r1) Import of revision 975 of old (crashed) SVN
truelight <truelight@openttd.org>
parents:
diff changeset
47
fa6ee4d75c8a (svn r1) Import of revision 975 of old (crashed) SVN
truelight <truelight@openttd.org>
parents:
diff changeset
48
fa6ee4d75c8a (svn r1) Import of revision 975 of old (crashed) SVN
truelight <truelight@openttd.org>
parents:
diff changeset
49 2.1) Reporting Bugs:
fa6ee4d75c8a (svn r1) Import of revision 975 of old (crashed) SVN
truelight <truelight@openttd.org>
parents:
diff changeset
50 ---- ---------------
5355
4449e5529205 (svn r7527) -Update appropiate files with release information for 0.5.0-RC1
Darkvater <Darkvater@openttd.org>
parents: 4785
diff changeset
51 To report a bug, please create a Flyspray account and follow the bugs
0
fa6ee4d75c8a (svn r1) Import of revision 975 of old (crashed) SVN
truelight <truelight@openttd.org>
parents:
diff changeset
52 link from our homepage. Please make sure the bug is reproducible and
fa6ee4d75c8a (svn r1) Import of revision 975 of old (crashed) SVN
truelight <truelight@openttd.org>
parents:
diff changeset
53 still occurs in the latest daily build or the current SVN version. Also
fa6ee4d75c8a (svn r1) Import of revision 975 of old (crashed) SVN
truelight <truelight@openttd.org>
parents:
diff changeset
54 please look through the existing bug reports briefly to see whether the bug
fa6ee4d75c8a (svn r1) Import of revision 975 of old (crashed) SVN
truelight <truelight@openttd.org>
parents:
diff changeset
55 is not already known.
fa6ee4d75c8a (svn r1) Import of revision 975 of old (crashed) SVN
truelight <truelight@openttd.org>
parents:
diff changeset
56
5355
4449e5529205 (svn r7527) -Update appropiate files with release information for 0.5.0-RC1
Darkvater <Darkvater@openttd.org>
parents: 4785
diff changeset
57 The Flyspray project page URL is: http://bugs.openttd.org/
0
fa6ee4d75c8a (svn r1) Import of revision 975 of old (crashed) SVN
truelight <truelight@openttd.org>
parents:
diff changeset
58
fa6ee4d75c8a (svn r1) Import of revision 975 of old (crashed) SVN
truelight <truelight@openttd.org>
parents:
diff changeset
59 Please include the following information in your bug report:
5404
2a651add2378 (svn r7600) -Remove: out-dated documentation about console and Mandrake Readme.
rubidium <rubidium@openttd.org>
parents: 5397
diff changeset
60 - OpenTTD version (PLEASE test the latest SVN/nightly build)
0
fa6ee4d75c8a (svn r1) Import of revision 975 of old (crashed) SVN
truelight <truelight@openttd.org>
parents:
diff changeset
61 - Bug details, including instructions how to reproduce it
fa6ee4d75c8a (svn r1) Import of revision 975 of old (crashed) SVN
truelight <truelight@openttd.org>
parents:
diff changeset
62 - Platform and compiler (Win32, Linux, FreeBSD, ...)
7908
7519c50587e5 (svn r11460) -Documentation: update some documentation to better match the current state and the state in the nearby future of OpenTTD.
rubidium <rubidium@openttd.org>
parents: 7859
diff changeset
63 - Attach a saved game *and* a screenshot if possible
0
fa6ee4d75c8a (svn r1) Import of revision 975 of old (crashed) SVN
truelight <truelight@openttd.org>
parents:
diff changeset
64 - If this bug only occurred recently please note the last
fa6ee4d75c8a (svn r1) Import of revision 975 of old (crashed) SVN
truelight <truelight@openttd.org>
parents:
diff changeset
65 version without the bug and the first version including
fa6ee4d75c8a (svn r1) Import of revision 975 of old (crashed) SVN
truelight <truelight@openttd.org>
parents:
diff changeset
66 the bug. That way we can fix it quicker by looking at the
fa6ee4d75c8a (svn r1) Import of revision 975 of old (crashed) SVN
truelight <truelight@openttd.org>
parents:
diff changeset
67 changes made.
11372
371d9d118d1d (svn r15722) -Change: add a bit more information to the readme.
rubidium <rubidium@openttd.org>
parents: 11369
diff changeset
68 - Attach crash.dmp, crash.log and crash.sav from the data
371d9d118d1d (svn r15722) -Change: add a bit more information to the readme.
rubidium <rubidium@openttd.org>
parents: 11369
diff changeset
69 directory if they exist.
0
fa6ee4d75c8a (svn r1) Import of revision 975 of old (crashed) SVN
truelight <truelight@openttd.org>
parents:
diff changeset
70
10515
7156262cf0c9 (svn r14772) -Codechange: make the "dump log of game to reproduce" desync debug stuff a runtime configurable debug option instead of a compile time option.
rubidium <rubidium@openttd.org>
parents: 10453
diff changeset
71 2.2) Reporting Desyncs:
7156262cf0c9 (svn r14772) -Codechange: make the "dump log of game to reproduce" desync debug stuff a runtime configurable debug option instead of a compile time option.
rubidium <rubidium@openttd.org>
parents: 10453
diff changeset
72 ---- ------------------
7156262cf0c9 (svn r14772) -Codechange: make the "dump log of game to reproduce" desync debug stuff a runtime configurable debug option instead of a compile time option.
rubidium <rubidium@openttd.org>
parents: 10453
diff changeset
73 As desyncs are hard to make reproducable OpenTTD has the ability to log all
7156262cf0c9 (svn r14772) -Codechange: make the "dump log of game to reproduce" desync debug stuff a runtime configurable debug option instead of a compile time option.
rubidium <rubidium@openttd.org>
parents: 10453
diff changeset
74 actions done by clients so we can replay the whole game in an effort to make
7156262cf0c9 (svn r14772) -Codechange: make the "dump log of game to reproduce" desync debug stuff a runtime configurable debug option instead of a compile time option.
rubidium <rubidium@openttd.org>
parents: 10453
diff changeset
75 desyncs better reproducable. You need to turn this ability on. When turned
7156262cf0c9 (svn r14772) -Codechange: make the "dump log of game to reproduce" desync debug stuff a runtime configurable debug option instead of a compile time option.
rubidium <rubidium@openttd.org>
parents: 10453
diff changeset
76 on an automatic savegame will be made once the map has been constructed in
7156262cf0c9 (svn r14772) -Codechange: make the "dump log of game to reproduce" desync debug stuff a runtime configurable debug option instead of a compile time option.
rubidium <rubidium@openttd.org>
parents: 10453
diff changeset
77 the 'save/autosave' directory, see OpenTTD directories to know where to find
7156262cf0c9 (svn r14772) -Codechange: make the "dump log of game to reproduce" desync debug stuff a runtime configurable debug option instead of a compile time option.
rubidium <rubidium@openttd.org>
parents: 10453
diff changeset
78 this directory. Furthermore the log file 'commands-out.log' will be created
7156262cf0c9 (svn r14772) -Codechange: make the "dump log of game to reproduce" desync debug stuff a runtime configurable debug option instead of a compile time option.
rubidium <rubidium@openttd.org>
parents: 10453
diff changeset
79 and all actions will be written to there.
7156262cf0c9 (svn r14772) -Codechange: make the "dump log of game to reproduce" desync debug stuff a runtime configurable debug option instead of a compile time option.
rubidium <rubidium@openttd.org>
parents: 10453
diff changeset
80
7156262cf0c9 (svn r14772) -Codechange: make the "dump log of game to reproduce" desync debug stuff a runtime configurable debug option instead of a compile time option.
rubidium <rubidium@openttd.org>
parents: 10453
diff changeset
81 To enable the desync debugging you need to set the debug level for 'desync'
7156262cf0c9 (svn r14772) -Codechange: make the "dump log of game to reproduce" desync debug stuff a runtime configurable debug option instead of a compile time option.
rubidium <rubidium@openttd.org>
parents: 10453
diff changeset
82 to at least 1. You do this by starting OpenTTD with '-d desync=<level>' as
7156262cf0c9 (svn r14772) -Codechange: make the "dump log of game to reproduce" desync debug stuff a runtime configurable debug option instead of a compile time option.
rubidium <rubidium@openttd.org>
parents: 10453
diff changeset
83 parameter or by typing 'debug_level desync=<level>' in OpenTTD's internal
7156262cf0c9 (svn r14772) -Codechange: make the "dump log of game to reproduce" desync debug stuff a runtime configurable debug option instead of a compile time option.
rubidium <rubidium@openttd.org>
parents: 10453
diff changeset
84 console.
7156262cf0c9 (svn r14772) -Codechange: make the "dump log of game to reproduce" desync debug stuff a runtime configurable debug option instead of a compile time option.
rubidium <rubidium@openttd.org>
parents: 10453
diff changeset
85 The desync debug levels are:
7156262cf0c9 (svn r14772) -Codechange: make the "dump log of game to reproduce" desync debug stuff a runtime configurable debug option instead of a compile time option.
rubidium <rubidium@openttd.org>
parents: 10453
diff changeset
86 0: nothing.
7156262cf0c9 (svn r14772) -Codechange: make the "dump log of game to reproduce" desync debug stuff a runtime configurable debug option instead of a compile time option.
rubidium <rubidium@openttd.org>
parents: 10453
diff changeset
87 1: dumping of commands to 'commands-out.log'.
7156262cf0c9 (svn r14772) -Codechange: make the "dump log of game to reproduce" desync debug stuff a runtime configurable debug option instead of a compile time option.
rubidium <rubidium@openttd.org>
parents: 10453
diff changeset
88 2: same as 1 plus checking vehicle caches and dumping that too.
7156262cf0c9 (svn r14772) -Codechange: make the "dump log of game to reproduce" desync debug stuff a runtime configurable debug option instead of a compile time option.
rubidium <rubidium@openttd.org>
parents: 10453
diff changeset
89 3: same as 2 plus monthly saves in autosave.
7156262cf0c9 (svn r14772) -Codechange: make the "dump log of game to reproduce" desync debug stuff a runtime configurable debug option instead of a compile time option.
rubidium <rubidium@openttd.org>
parents: 10453
diff changeset
90 4 and higher: same as 3
7156262cf0c9 (svn r14772) -Codechange: make the "dump log of game to reproduce" desync debug stuff a runtime configurable debug option instead of a compile time option.
rubidium <rubidium@openttd.org>
parents: 10453
diff changeset
91
7156262cf0c9 (svn r14772) -Codechange: make the "dump log of game to reproduce" desync debug stuff a runtime configurable debug option instead of a compile time option.
rubidium <rubidium@openttd.org>
parents: 10453
diff changeset
92 Restarting OpenTTD will overwrite 'commands-out.log'. OpenTTD will not remove
7156262cf0c9 (svn r14772) -Codechange: make the "dump log of game to reproduce" desync debug stuff a runtime configurable debug option instead of a compile time option.
rubidium <rubidium@openttd.org>
parents: 10453
diff changeset
93 the savegames (dmp_cmds_*.sav) made by the desync debugging system, so you
7156262cf0c9 (svn r14772) -Codechange: make the "dump log of game to reproduce" desync debug stuff a runtime configurable debug option instead of a compile time option.
rubidium <rubidium@openttd.org>
parents: 10453
diff changeset
94 have to occasionally remove them yourself!
7156262cf0c9 (svn r14772) -Codechange: make the "dump log of game to reproduce" desync debug stuff a runtime configurable debug option instead of a compile time option.
rubidium <rubidium@openttd.org>
parents: 10453
diff changeset
95
7156262cf0c9 (svn r14772) -Codechange: make the "dump log of game to reproduce" desync debug stuff a runtime configurable debug option instead of a compile time option.
rubidium <rubidium@openttd.org>
parents: 10453
diff changeset
96 The naming format of the desync savegames is as follows:
7156262cf0c9 (svn r14772) -Codechange: make the "dump log of game to reproduce" desync debug stuff a runtime configurable debug option instead of a compile time option.
rubidium <rubidium@openttd.org>
parents: 10453
diff changeset
97 dmp_cmds_XXXXXXXX_YYYYYYYY.sav. The XXXXXXXX is the hexadecimal representation
7156262cf0c9 (svn r14772) -Codechange: make the "dump log of game to reproduce" desync debug stuff a runtime configurable debug option instead of a compile time option.
rubidium <rubidium@openttd.org>
parents: 10453
diff changeset
98 of the generation seed of the game and YYYYYYYY is the hexadecimal
7156262cf0c9 (svn r14772) -Codechange: make the "dump log of game to reproduce" desync debug stuff a runtime configurable debug option instead of a compile time option.
rubidium <rubidium@openttd.org>
parents: 10453
diff changeset
99 representation of the date of the game. This sorts the savegames by game and
7156262cf0c9 (svn r14772) -Codechange: make the "dump log of game to reproduce" desync debug stuff a runtime configurable debug option instead of a compile time option.
rubidium <rubidium@openttd.org>
parents: 10453
diff changeset
100 then by date making it easier to find the right savegames.
7156262cf0c9 (svn r14772) -Codechange: make the "dump log of game to reproduce" desync debug stuff a runtime configurable debug option instead of a compile time option.
rubidium <rubidium@openttd.org>
parents: 10453
diff changeset
101
7156262cf0c9 (svn r14772) -Codechange: make the "dump log of game to reproduce" desync debug stuff a runtime configurable debug option instead of a compile time option.
rubidium <rubidium@openttd.org>
parents: 10453
diff changeset
102 When a desync has occurred with the desync debugging turned on you should file
7156262cf0c9 (svn r14772) -Codechange: make the "dump log of game to reproduce" desync debug stuff a runtime configurable debug option instead of a compile time option.
rubidium <rubidium@openttd.org>
parents: 10453
diff changeset
103 a bug report with the following files attached:
7156262cf0c9 (svn r14772) -Codechange: make the "dump log of game to reproduce" desync debug stuff a runtime configurable debug option instead of a compile time option.
rubidium <rubidium@openttd.org>
parents: 10453
diff changeset
104 - commands-out.log as it contains all the commands that were done
7156262cf0c9 (svn r14772) -Codechange: make the "dump log of game to reproduce" desync debug stuff a runtime configurable debug option instead of a compile time option.
rubidium <rubidium@openttd.org>
parents: 10453
diff changeset
105 - the last saved savegame (search for the last line beginning with
7156262cf0c9 (svn r14772) -Codechange: make the "dump log of game to reproduce" desync debug stuff a runtime configurable debug option instead of a compile time option.
rubidium <rubidium@openttd.org>
parents: 10453
diff changeset
106 'save: dmp_cmds_' in commands-out.log). We use this savegame to check
7156262cf0c9 (svn r14772) -Codechange: make the "dump log of game to reproduce" desync debug stuff a runtime configurable debug option instead of a compile time option.
rubidium <rubidium@openttd.org>
parents: 10453
diff changeset
107 whether we can quickly reproduce the desync. Otherwise we will need...
7156262cf0c9 (svn r14772) -Codechange: make the "dump log of game to reproduce" desync debug stuff a runtime configurable debug option instead of a compile time option.
rubidium <rubidium@openttd.org>
parents: 10453
diff changeset
108 - the first saved savegame (search for the first line beginning with 'save'
7156262cf0c9 (svn r14772) -Codechange: make the "dump log of game to reproduce" desync debug stuff a runtime configurable debug option instead of a compile time option.
rubidium <rubidium@openttd.org>
parents: 10453
diff changeset
109 where the first part, up to the last underscore '_', is the same). We need
7156262cf0c9 (svn r14772) -Codechange: make the "dump log of game to reproduce" desync debug stuff a runtime configurable debug option instead of a compile time option.
rubidium <rubidium@openttd.org>
parents: 10453
diff changeset
110 this savegame to be able to reproduce the bug when the last savegame is not
7156262cf0c9 (svn r14772) -Codechange: make the "dump log of game to reproduce" desync debug stuff a runtime configurable debug option instead of a compile time option.
rubidium <rubidium@openttd.org>
parents: 10453
diff changeset
111 old enough. If you loaded a scenario or savegame you need to attach that.
7156262cf0c9 (svn r14772) -Codechange: make the "dump log of game to reproduce" desync debug stuff a runtime configurable debug option instead of a compile time option.
rubidium <rubidium@openttd.org>
parents: 10453
diff changeset
112 - optionally you can attach the savegames from around 50%, 75%, 85%, 90% and
7156262cf0c9 (svn r14772) -Codechange: make the "dump log of game to reproduce" desync debug stuff a runtime configurable debug option instead of a compile time option.
rubidium <rubidium@openttd.org>
parents: 10453
diff changeset
113 95% of the game's progression. We can use these savegames to speed up the
7156262cf0c9 (svn r14772) -Codechange: make the "dump log of game to reproduce" desync debug stuff a runtime configurable debug option instead of a compile time option.
rubidium <rubidium@openttd.org>
parents: 10453
diff changeset
114 reproduction of the desync, but we should be able to reproduce these
7156262cf0c9 (svn r14772) -Codechange: make the "dump log of game to reproduce" desync debug stuff a runtime configurable debug option instead of a compile time option.
rubidium <rubidium@openttd.org>
parents: 10453
diff changeset
115 savegames based on the first savegame and commands-out.log.
7156262cf0c9 (svn r14772) -Codechange: make the "dump log of game to reproduce" desync debug stuff a runtime configurable debug option instead of a compile time option.
rubidium <rubidium@openttd.org>
parents: 10453
diff changeset
116 - in case you use any NewGRFs you should attach the ones you used unless
7156262cf0c9 (svn r14772) -Codechange: make the "dump log of game to reproduce" desync debug stuff a runtime configurable debug option instead of a compile time option.
rubidium <rubidium@openttd.org>
parents: 10453
diff changeset
117 we can easily find them ourselves via e.g. grfcrawler or when they are
7156262cf0c9 (svn r14772) -Codechange: make the "dump log of game to reproduce" desync debug stuff a runtime configurable debug option instead of a compile time option.
rubidium <rubidium@openttd.org>
parents: 10453
diff changeset
118 in the OpenTTDCoop pack.
7156262cf0c9 (svn r14772) -Codechange: make the "dump log of game to reproduce" desync debug stuff a runtime configurable debug option instead of a compile time option.
rubidium <rubidium@openttd.org>
parents: 10453
diff changeset
119
7156262cf0c9 (svn r14772) -Codechange: make the "dump log of game to reproduce" desync debug stuff a runtime configurable debug option instead of a compile time option.
rubidium <rubidium@openttd.org>
parents: 10453
diff changeset
120 Do NOT remove the dmp_cmds savegames of a desync you have reported until the
7156262cf0c9 (svn r14772) -Codechange: make the "dump log of game to reproduce" desync debug stuff a runtime configurable debug option instead of a compile time option.
rubidium <rubidium@openttd.org>
parents: 10453
diff changeset
121 desync has been fixed; if you, by accident, send us the wrong savegames we
7156262cf0c9 (svn r14772) -Codechange: make the "dump log of game to reproduce" desync debug stuff a runtime configurable debug option instead of a compile time option.
rubidium <rubidium@openttd.org>
parents: 10453
diff changeset
122 will not be able to reproduce the desync and thus will be unable to fix it.
0
fa6ee4d75c8a (svn r1) Import of revision 975 of old (crashed) SVN
truelight <truelight@openttd.org>
parents:
diff changeset
123
fa6ee4d75c8a (svn r1) Import of revision 975 of old (crashed) SVN
truelight <truelight@openttd.org>
parents:
diff changeset
124 3.0) Supported Platforms:
fa6ee4d75c8a (svn r1) Import of revision 975 of old (crashed) SVN
truelight <truelight@openttd.org>
parents:
diff changeset
125 ---- --------------------
fa6ee4d75c8a (svn r1) Import of revision 975 of old (crashed) SVN
truelight <truelight@openttd.org>
parents:
diff changeset
126 OpenTTD has been ported to several platforms and operating systems. It shouldn't
fa6ee4d75c8a (svn r1) Import of revision 975 of old (crashed) SVN
truelight <truelight@openttd.org>
parents:
diff changeset
127 be very difficult to port it to a new platform. The currently working platforms
fa6ee4d75c8a (svn r1) Import of revision 975 of old (crashed) SVN
truelight <truelight@openttd.org>
parents:
diff changeset
128 are:
fa6ee4d75c8a (svn r1) Import of revision 975 of old (crashed) SVN
truelight <truelight@openttd.org>
parents:
diff changeset
129
10385
9709c41adf56 (svn r14636) -Add: DOS port of OpenTTD, without network support though.
rubidium <rubidium@openttd.org>
parents: 9945
diff changeset
130 BeOS - SDL or Allegro
9709c41adf56 (svn r14636) -Add: DOS port of OpenTTD, without network support though.
rubidium <rubidium@openttd.org>
parents: 9945
diff changeset
131 DOS - Allegro
5404
2a651add2378 (svn r7600) -Remove: out-dated documentation about console and Mandrake Readme.
rubidium <rubidium@openttd.org>
parents: 5397
diff changeset
132 FreeBSD - SDL
10385
9709c41adf56 (svn r14636) -Add: DOS port of OpenTTD, without network support though.
rubidium <rubidium@openttd.org>
parents: 9945
diff changeset
133 Linux - SDL or Allegro
5404
2a651add2378 (svn r7600) -Remove: out-dated documentation about console and Mandrake Readme.
rubidium <rubidium@openttd.org>
parents: 5397
diff changeset
134 MacOS X (universal) - Cocoa video and sound drivers (SDL works too, but not 100% and not as a universal binary)
2a651add2378 (svn r7600) -Remove: out-dated documentation about console and Mandrake Readme.
rubidium <rubidium@openttd.org>
parents: 5397
diff changeset
135 MorphOS - SDL
6673
b42a1e412f8e (svn r9904) -Codechange [FS#798]: Add OpenBSD support to configure (matthias)
peter1138 <peter1138@openttd.org>
parents: 6514
diff changeset
136 OpenBSD - SDL
5404
2a651add2378 (svn r7600) -Remove: out-dated documentation about console and Mandrake Readme.
rubidium <rubidium@openttd.org>
parents: 5397
diff changeset
137 OS/2 - SDL
10385
9709c41adf56 (svn r14636) -Add: DOS port of OpenTTD, without network support though.
rubidium <rubidium@openttd.org>
parents: 9945
diff changeset
138 Windows - Win32 GDI (faster) or SDL or Allegro
0
fa6ee4d75c8a (svn r1) Import of revision 975 of old (crashed) SVN
truelight <truelight@openttd.org>
parents:
diff changeset
139
fa6ee4d75c8a (svn r1) Import of revision 975 of old (crashed) SVN
truelight <truelight@openttd.org>
parents:
diff changeset
140
7686
48c969ebb8ba (svn r11217) -Update: the readme as some things weren't quite right anymore.
rubidium <rubidium@openttd.org>
parents: 7588
diff changeset
141 4.0) Installing and running OpenTTD:
48c969ebb8ba (svn r11217) -Update: the readme as some things weren't quite right anymore.
rubidium <rubidium@openttd.org>
parents: 7588
diff changeset
142 ---- -------------------------------
48c969ebb8ba (svn r11217) -Update: the readme as some things weren't quite right anymore.
rubidium <rubidium@openttd.org>
parents: 7588
diff changeset
143
48c969ebb8ba (svn r11217) -Update: the readme as some things weren't quite right anymore.
rubidium <rubidium@openttd.org>
parents: 7588
diff changeset
144 Installing OpenTTD is fairly straightforward. Either you have downloaded an
48c969ebb8ba (svn r11217) -Update: the readme as some things weren't quite right anymore.
rubidium <rubidium@openttd.org>
parents: 7588
diff changeset
145 archive which you have to extract to a directory where you want OpenTTD to
48c969ebb8ba (svn r11217) -Update: the readme as some things weren't quite right anymore.
rubidium <rubidium@openttd.org>
parents: 7588
diff changeset
146 be installed, or you have downloaded an installer, which will automatically
48c969ebb8ba (svn r11217) -Update: the readme as some things weren't quite right anymore.
rubidium <rubidium@openttd.org>
parents: 7588
diff changeset
147 extract OpenTTD in the given directory.
0
fa6ee4d75c8a (svn r1) Import of revision 975 of old (crashed) SVN
truelight <truelight@openttd.org>
parents:
diff changeset
148
8659
8a48f9c9188e (svn r12321) -Change: update readme about where openttd looks for files (based on dih work)
glx <glx@openttd.org>
parents: 8605
diff changeset
149 OpenTTD looks in multiple locations to find the required data files (described
8a48f9c9188e (svn r12321) -Change: update readme about where openttd looks for files (based on dih work)
glx <glx@openttd.org>
parents: 8605
diff changeset
150 in section 4.2). Installing any 3rd party files into a "shared" location has
8a48f9c9188e (svn r12321) -Change: update readme about where openttd looks for files (based on dih work)
glx <glx@openttd.org>
parents: 8605
diff changeset
151 the advantage that you only need to do this step once, rather than copying the
8a48f9c9188e (svn r12321) -Change: update readme about where openttd looks for files (based on dih work)
glx <glx@openttd.org>
parents: 8605
diff changeset
152 data files into all OpenTTD versions you have.
8a48f9c9188e (svn r12321) -Change: update readme about where openttd looks for files (based on dih work)
glx <glx@openttd.org>
parents: 8605
diff changeset
153 Savegames, screenshots, etc are saved relative to the config file (openttd.cfg)
8a48f9c9188e (svn r12321) -Change: update readme about where openttd looks for files (based on dih work)
glx <glx@openttd.org>
parents: 8605
diff changeset
154 currently being used. This means that if you use a config file in one of the
8a48f9c9188e (svn r12321) -Change: update readme about where openttd looks for files (based on dih work)
glx <glx@openttd.org>
parents: 8605
diff changeset
155 shared directories, savegames will reside in the save/ directory next to the
8a48f9c9188e (svn r12321) -Change: update readme about where openttd looks for files (based on dih work)
glx <glx@openttd.org>
parents: 8605
diff changeset
156 openttd.cfg file there.
8a48f9c9188e (svn r12321) -Change: update readme about where openttd looks for files (based on dih work)
glx <glx@openttd.org>
parents: 8605
diff changeset
157 If you want savegames and screenshots in the directory where the OpenTTD binary
8a48f9c9188e (svn r12321) -Change: update readme about where openttd looks for files (based on dih work)
glx <glx@openttd.org>
parents: 8605
diff changeset
158 resides, simply have your config file in that location. But if you remove this
8a48f9c9188e (svn r12321) -Change: update readme about where openttd looks for files (based on dih work)
glx <glx@openttd.org>
parents: 8605
diff changeset
159 config file, savegames will still be in this directory (see notes in section 4.2)
8a48f9c9188e (svn r12321) -Change: update readme about where openttd looks for files (based on dih work)
glx <glx@openttd.org>
parents: 8605
diff changeset
160
8a48f9c9188e (svn r12321) -Change: update readme about where openttd looks for files (based on dih work)
glx <glx@openttd.org>
parents: 8605
diff changeset
161 4.1) (Required) 3rd party files:
8a48f9c9188e (svn r12321) -Change: update readme about where openttd looks for files (based on dih work)
glx <glx@openttd.org>
parents: 8605
diff changeset
162 ---- ---------------------------
8a48f9c9188e (svn r12321) -Change: update readme about where openttd looks for files (based on dih work)
glx <glx@openttd.org>
parents: 8605
diff changeset
163
8a48f9c9188e (svn r12321) -Change: update readme about where openttd looks for files (based on dih work)
glx <glx@openttd.org>
parents: 8605
diff changeset
164 Before you run OpenTTD, you need to put the game's datafiles into a data/
8a48f9c9188e (svn r12321) -Change: update readme about where openttd looks for files (based on dih work)
glx <glx@openttd.org>
parents: 8605
diff changeset
165 directory which can be located in various places addressed in the following
8a48f9c9188e (svn r12321) -Change: update readme about where openttd looks for files (based on dih work)
glx <glx@openttd.org>
parents: 8605
diff changeset
166 section.
8a48f9c9188e (svn r12321) -Change: update readme about where openttd looks for files (based on dih work)
glx <glx@openttd.org>
parents: 8605
diff changeset
167 As OpenTTD makes use of the original TTD artwork you will need the files listed
8a48f9c9188e (svn r12321) -Change: update readme about where openttd looks for files (based on dih work)
glx <glx@openttd.org>
parents: 8605
diff changeset
168 below, which you can find on a Transport Tycoon Deluxe CD-ROM.
8a48f9c9188e (svn r12321) -Change: update readme about where openttd looks for files (based on dih work)
glx <glx@openttd.org>
parents: 8605
diff changeset
169 The Windows installer optionally can copy these files from that CD-ROM.
0
fa6ee4d75c8a (svn r1) Import of revision 975 of old (crashed) SVN
truelight <truelight@openttd.org>
parents:
diff changeset
170
fa6ee4d75c8a (svn r1) Import of revision 975 of old (crashed) SVN
truelight <truelight@openttd.org>
parents:
diff changeset
171 List of the required files:
8659
8a48f9c9188e (svn r12321) -Change: update readme about where openttd looks for files (based on dih work)
glx <glx@openttd.org>
parents: 8605
diff changeset
172 - sample.cat
8a48f9c9188e (svn r12321) -Change: update readme about where openttd looks for files (based on dih work)
glx <glx@openttd.org>
parents: 8605
diff changeset
173 - trg1r.grf
8a48f9c9188e (svn r12321) -Change: update readme about where openttd looks for files (based on dih work)
glx <glx@openttd.org>
parents: 8605
diff changeset
174 - trgcr.grf
8a48f9c9188e (svn r12321) -Change: update readme about where openttd looks for files (based on dih work)
glx <glx@openttd.org>
parents: 8605
diff changeset
175 - trghr.grf
8a48f9c9188e (svn r12321) -Change: update readme about where openttd looks for files (based on dih work)
glx <glx@openttd.org>
parents: 8605
diff changeset
176 - trgir.grf
8a48f9c9188e (svn r12321) -Change: update readme about where openttd looks for files (based on dih work)
glx <glx@openttd.org>
parents: 8605
diff changeset
177 - trgtr.grf
8a48f9c9188e (svn r12321) -Change: update readme about where openttd looks for files (based on dih work)
glx <glx@openttd.org>
parents: 8605
diff changeset
178
8a48f9c9188e (svn r12321) -Change: update readme about where openttd looks for files (based on dih work)
glx <glx@openttd.org>
parents: 8605
diff changeset
179 Alternatively you can use the TTD GRF files from the DOS version:
8a48f9c9188e (svn r12321) -Change: update readme about where openttd looks for files (based on dih work)
glx <glx@openttd.org>
parents: 8605
diff changeset
180 - TRG1.GRF
8a48f9c9188e (svn r12321) -Change: update readme about where openttd looks for files (based on dih work)
glx <glx@openttd.org>
parents: 8605
diff changeset
181 - TRGC.GRF
8a48f9c9188e (svn r12321) -Change: update readme about where openttd looks for files (based on dih work)
glx <glx@openttd.org>
parents: 8605
diff changeset
182 - TRGH.GRF
8a48f9c9188e (svn r12321) -Change: update readme about where openttd looks for files (based on dih work)
glx <glx@openttd.org>
parents: 8605
diff changeset
183 - TRGI.GRF
8a48f9c9188e (svn r12321) -Change: update readme about where openttd looks for files (based on dih work)
glx <glx@openttd.org>
parents: 8605
diff changeset
184 - TRGT.GRF
8a48f9c9188e (svn r12321) -Change: update readme about where openttd looks for files (based on dih work)
glx <glx@openttd.org>
parents: 8605
diff changeset
185
8a48f9c9188e (svn r12321) -Change: update readme about where openttd looks for files (based on dih work)
glx <glx@openttd.org>
parents: 8605
diff changeset
186 If you want the TTD music, copy the gm/ folder from the Windows version
8a48f9c9188e (svn r12321) -Change: update readme about where openttd looks for files (based on dih work)
glx <glx@openttd.org>
parents: 8605
diff changeset
187 of TTD to your OpenTTD folder (not your data folder - also explained in
8a48f9c9188e (svn r12321) -Change: update readme about where openttd looks for files (based on dih work)
glx <glx@openttd.org>
parents: 8605
diff changeset
188 the following sections).
8a48f9c9188e (svn r12321) -Change: update readme about where openttd looks for files (based on dih work)
glx <glx@openttd.org>
parents: 8605
diff changeset
189
8a48f9c9188e (svn r12321) -Change: update readme about where openttd looks for files (based on dih work)
glx <glx@openttd.org>
parents: 8605
diff changeset
190 Do NOT copy files included with OpenTTD into "shared" directories (explained in
8a48f9c9188e (svn r12321) -Change: update readme about where openttd looks for files (based on dih work)
glx <glx@openttd.org>
parents: 8605
diff changeset
191 the following sections) as sooner or later you will run into graphical glitches
8a48f9c9188e (svn r12321) -Change: update readme about where openttd looks for files (based on dih work)
glx <glx@openttd.org>
parents: 8605
diff changeset
192 when using other versions of the game.
8a48f9c9188e (svn r12321) -Change: update readme about where openttd looks for files (based on dih work)
glx <glx@openttd.org>
parents: 8605
diff changeset
193
8a48f9c9188e (svn r12321) -Change: update readme about where openttd looks for files (based on dih work)
glx <glx@openttd.org>
parents: 8605
diff changeset
194 4.2) OpenTTD directories
8a48f9c9188e (svn r12321) -Change: update readme about where openttd looks for files (based on dih work)
glx <glx@openttd.org>
parents: 8605
diff changeset
195 ---- -------------------------------
0
fa6ee4d75c8a (svn r1) Import of revision 975 of old (crashed) SVN
truelight <truelight@openttd.org>
parents:
diff changeset
196
8659
8a48f9c9188e (svn r12321) -Change: update readme about where openttd looks for files (based on dih work)
glx <glx@openttd.org>
parents: 8605
diff changeset
197 The TTD artwork files listed in the section 4.1 "(Required) 3rd party files"
8a48f9c9188e (svn r12321) -Change: update readme about where openttd looks for files (based on dih work)
glx <glx@openttd.org>
parents: 8605
diff changeset
198 can be placed in a few different locations:
8a48f9c9188e (svn r12321) -Change: update readme about where openttd looks for files (based on dih work)
glx <glx@openttd.org>
parents: 8605
diff changeset
199 1. The current working directory (from where you started OpenTTD)
8a48f9c9188e (svn r12321) -Change: update readme about where openttd looks for files (based on dih work)
glx <glx@openttd.org>
parents: 8605
diff changeset
200 2. Your personal directory
8a48f9c9188e (svn r12321) -Change: update readme about where openttd looks for files (based on dih work)
glx <glx@openttd.org>
parents: 8605
diff changeset
201 Windows: C:\Documents and Settings\<username>\My Documents\OpenTTD
8a48f9c9188e (svn r12321) -Change: update readme about where openttd looks for files (based on dih work)
glx <glx@openttd.org>
parents: 8605
diff changeset
202 Mac OSX: ~/Documents/OpenTTD
8a48f9c9188e (svn r12321) -Change: update readme about where openttd looks for files (based on dih work)
glx <glx@openttd.org>
parents: 8605
diff changeset
203 Linux: ~/.openttd
8a48f9c9188e (svn r12321) -Change: update readme about where openttd looks for files (based on dih work)
glx <glx@openttd.org>
parents: 8605
diff changeset
204 3. The shared directory
8a48f9c9188e (svn r12321) -Change: update readme about where openttd looks for files (based on dih work)
glx <glx@openttd.org>
parents: 8605
diff changeset
205 Windows: C:\Documents and Settings\All Users\Documents\OpenTTD
8a48f9c9188e (svn r12321) -Change: update readme about where openttd looks for files (based on dih work)
glx <glx@openttd.org>
parents: 8605
diff changeset
206 Mac OSX: /Library/Application Support/OpenTTD
8a48f9c9188e (svn r12321) -Change: update readme about where openttd looks for files (based on dih work)
glx <glx@openttd.org>
parents: 8605
diff changeset
207 Linux: not available
8a48f9c9188e (svn r12321) -Change: update readme about where openttd looks for files (based on dih work)
glx <glx@openttd.org>
parents: 8605
diff changeset
208 4. The binary directory (where the OpenTTD executable is)
8a48f9c9188e (svn r12321) -Change: update readme about where openttd looks for files (based on dih work)
glx <glx@openttd.org>
parents: 8605
diff changeset
209 Windows: C:\Program Files\OpenTTD
8a48f9c9188e (svn r12321) -Change: update readme about where openttd looks for files (based on dih work)
glx <glx@openttd.org>
parents: 8605
diff changeset
210 Linux: /usr/games
8a48f9c9188e (svn r12321) -Change: update readme about where openttd looks for files (based on dih work)
glx <glx@openttd.org>
parents: 8605
diff changeset
211 5. The installation directory (Linux only)
8a48f9c9188e (svn r12321) -Change: update readme about where openttd looks for files (based on dih work)
glx <glx@openttd.org>
parents: 8605
diff changeset
212 Linux: /usr/share/games/openttd
8a48f9c9188e (svn r12321) -Change: update readme about where openttd looks for files (based on dih work)
glx <glx@openttd.org>
parents: 8605
diff changeset
213 6. The application bundle (Mac OSX only)
8a48f9c9188e (svn r12321) -Change: update readme about where openttd looks for files (based on dih work)
glx <glx@openttd.org>
parents: 8605
diff changeset
214 It includes the OTTD files (grf+lng) and it will work as long as they aren't touched
0
fa6ee4d75c8a (svn r1) Import of revision 975 of old (crashed) SVN
truelight <truelight@openttd.org>
parents:
diff changeset
215
8659
8a48f9c9188e (svn r12321) -Change: update readme about where openttd looks for files (based on dih work)
glx <glx@openttd.org>
parents: 8605
diff changeset
216 Notes:
8a48f9c9188e (svn r12321) -Change: update readme about where openttd looks for files (based on dih work)
glx <glx@openttd.org>
parents: 8605
diff changeset
217 - Linux in the previous list means .deb, but most paths should be similar for others.
8a48f9c9188e (svn r12321) -Change: update readme about where openttd looks for files (based on dih work)
glx <glx@openttd.org>
parents: 8605
diff changeset
218 - The previous search order is also used for newgrfs and openttd.cfg.
8a48f9c9188e (svn r12321) -Change: update readme about where openttd looks for files (based on dih work)
glx <glx@openttd.org>
parents: 8605
diff changeset
219 - If openttd.cfg is not found, then it will be created using the 2, 4, 1, 3, 5 order.
8a48f9c9188e (svn r12321) -Change: update readme about where openttd looks for files (based on dih work)
glx <glx@openttd.org>
parents: 8605
diff changeset
220 - Savegames will be relative to the config file only if there is no save/
8a48f9c9188e (svn r12321) -Change: update readme about where openttd looks for files (based on dih work)
glx <glx@openttd.org>
parents: 8605
diff changeset
221 directory in paths with higher priority than the config file path, but
8a48f9c9188e (svn r12321) -Change: update readme about where openttd looks for files (based on dih work)
glx <glx@openttd.org>
parents: 8605
diff changeset
222 autosaves and screenshots will always be relative to the config file.
8a48f9c9188e (svn r12321) -Change: update readme about where openttd looks for files (based on dih work)
glx <glx@openttd.org>
parents: 8605
diff changeset
223
8a48f9c9188e (svn r12321) -Change: update readme about where openttd looks for files (based on dih work)
glx <glx@openttd.org>
parents: 8605
diff changeset
224 The prefered setup:
8a48f9c9188e (svn r12321) -Change: update readme about where openttd looks for files (based on dih work)
glx <glx@openttd.org>
parents: 8605
diff changeset
225 Place 3rd party files in shared directory (or in personal directory if you don't
8a48f9c9188e (svn r12321) -Change: update readme about where openttd looks for files (based on dih work)
glx <glx@openttd.org>
parents: 8605
diff changeset
226 have write access on shared directory) and have your openttd.cfg config file in
8a48f9c9188e (svn r12321) -Change: update readme about where openttd looks for files (based on dih work)
glx <glx@openttd.org>
parents: 8605
diff changeset
227 personal directory (where the game will then also place savegames and screenshots).
8a48f9c9188e (svn r12321) -Change: update readme about where openttd looks for files (based on dih work)
glx <glx@openttd.org>
parents: 8605
diff changeset
228
8a48f9c9188e (svn r12321) -Change: update readme about where openttd looks for files (based on dih work)
glx <glx@openttd.org>
parents: 8605
diff changeset
229
8a48f9c9188e (svn r12321) -Change: update readme about where openttd looks for files (based on dih work)
glx <glx@openttd.org>
parents: 8605
diff changeset
230 4.3) Portable Installations (External Media):
8a48f9c9188e (svn r12321) -Change: update readme about where openttd looks for files (based on dih work)
glx <glx@openttd.org>
parents: 8605
diff changeset
231 ---- ----------------------------------------
8a48f9c9188e (svn r12321) -Change: update readme about where openttd looks for files (based on dih work)
glx <glx@openttd.org>
parents: 8605
diff changeset
232
8a48f9c9188e (svn r12321) -Change: update readme about where openttd looks for files (based on dih work)
glx <glx@openttd.org>
parents: 8605
diff changeset
233 You can install OpenTTD on external media so you can take it with you, i.e.
8a48f9c9188e (svn r12321) -Change: update readme about where openttd looks for files (based on dih work)
glx <glx@openttd.org>
parents: 8605
diff changeset
234 using a USB key, or a USB HDD, etc.
8a48f9c9188e (svn r12321) -Change: update readme about where openttd looks for files (based on dih work)
glx <glx@openttd.org>
parents: 8605
diff changeset
235 Create a directory where you shall store the game in (i.e. OpenTTD/).
8a48f9c9188e (svn r12321) -Change: update readme about where openttd looks for files (based on dih work)
glx <glx@openttd.org>
parents: 8605
diff changeset
236 Copy the binary (OpenTTD.exe, OpenTTD.app, openttd, etc), data/ and your
8a48f9c9188e (svn r12321) -Change: update readme about where openttd looks for files (based on dih work)
glx <glx@openttd.org>
parents: 8605
diff changeset
237 openttd.cfg to this directory.
8a48f9c9188e (svn r12321) -Change: update readme about where openttd looks for files (based on dih work)
glx <glx@openttd.org>
parents: 8605
diff changeset
238 You can copy binaries for any operating system into this directory, which will
8a48f9c9188e (svn r12321) -Change: update readme about where openttd looks for files (based on dih work)
glx <glx@openttd.org>
parents: 8605
diff changeset
239 allow you to play the game on nearly any computer you can attach the external
8a48f9c9188e (svn r12321) -Change: update readme about where openttd looks for files (based on dih work)
glx <glx@openttd.org>
parents: 8605
diff changeset
240 media to.
8a48f9c9188e (svn r12321) -Change: update readme about where openttd looks for files (based on dih work)
glx <glx@openttd.org>
parents: 8605
diff changeset
241 As always - additional grf files are stored in the data/ dir (for details,
8a48f9c9188e (svn r12321) -Change: update readme about where openttd looks for files (based on dih work)
glx <glx@openttd.org>
parents: 8605
diff changeset
242 again, see section 4.1).
614
96f116271012 (svn r1038) Feature: OpenTTD runs with the grf files of the DOS version
dominik <dominik@openttd.org>
parents: 504
diff changeset
243
0
fa6ee4d75c8a (svn r1) Import of revision 975 of old (crashed) SVN
truelight <truelight@openttd.org>
parents:
diff changeset
244
fa6ee4d75c8a (svn r1) Import of revision 975 of old (crashed) SVN
truelight <truelight@openttd.org>
parents:
diff changeset
245 5.0) OpenTTD features:
fa6ee4d75c8a (svn r1) Import of revision 975 of old (crashed) SVN
truelight <truelight@openttd.org>
parents:
diff changeset
246 ---- -----------------
fa6ee4d75c8a (svn r1) Import of revision 975 of old (crashed) SVN
truelight <truelight@openttd.org>
parents:
diff changeset
247
fa6ee4d75c8a (svn r1) Import of revision 975 of old (crashed) SVN
truelight <truelight@openttd.org>
parents:
diff changeset
248 OpenTTD has a lot of features going beyond the original TTD emulation.
2401
240a3baa3b56 (svn r2927) Fix/remove stale information, line breaks, inform FreeBSD users about the required ports
tron <tron@openttd.org>
parents: 2134
diff changeset
249 Unfortunately, there is currently no comprehensive list of features, but there
240a3baa3b56 (svn r2927) Fix/remove stale information, line breaks, inform FreeBSD users about the required ports
tron <tron@openttd.org>
parents: 2134
diff changeset
250 is a basic features list on the web, and some optional features can be
11069
36d798171bfd (svn r15410) -Cleanup: get rid of most of the references to the 'patches' except where it's used for backward compatability.
rubidium <rubidium@openttd.org>
parents: 10583
diff changeset
251 controlled through the Advanced Settings dialog. We also implement some
0
fa6ee4d75c8a (svn r1) Import of revision 975 of old (crashed) SVN
truelight <truelight@openttd.org>
parents:
diff changeset
252 features known from TTDPatch (http://www.ttdpatch.net/).
fa6ee4d75c8a (svn r1) Import of revision 975 of old (crashed) SVN
truelight <truelight@openttd.org>
parents:
diff changeset
253
fa6ee4d75c8a (svn r1) Import of revision 975 of old (crashed) SVN
truelight <truelight@openttd.org>
parents:
diff changeset
254 Several important non-standard controls:
fa6ee4d75c8a (svn r1) Import of revision 975 of old (crashed) SVN
truelight <truelight@openttd.org>
parents:
diff changeset
255
11372
371d9d118d1d (svn r15722) -Change: add a bit more information to the readme.
rubidium <rubidium@openttd.org>
parents: 11369
diff changeset
256 * Ctrl makes much commands more powerful. For example Ctrl clicking on signals
371d9d118d1d (svn r15722) -Change: add a bit more information to the readme.
rubidium <rubidium@openttd.org>
parents: 11369
diff changeset
257 with the build signal tool on signals changes their behaviour.
2401
240a3baa3b56 (svn r2927) Fix/remove stale information, line breaks, inform FreeBSD users about the required ports
tron <tron@openttd.org>
parents: 2134
diff changeset
258 * Ingame console. More information at
5404
2a651add2378 (svn r7600) -Remove: out-dated documentation about console and Mandrake Readme.
rubidium <rubidium@openttd.org>
parents: 5397
diff changeset
259 http://wiki.openttd.org/index.php/Console
11372
371d9d118d1d (svn r15722) -Change: add a bit more information to the readme.
rubidium <rubidium@openttd.org>
parents: 11369
diff changeset
260 * Right clicking shows tooltips
0
fa6ee4d75c8a (svn r1) Import of revision 975 of old (crashed) SVN
truelight <truelight@openttd.org>
parents:
diff changeset
261
fa6ee4d75c8a (svn r1) Import of revision 975 of old (crashed) SVN
truelight <truelight@openttd.org>
parents:
diff changeset
262
9457
267a95510fdf (svn r13375) -Add: logging of actions that could possibly cause desyncs and crashes to simplify debugging. See readme.txt for details
smatz <smatz@openttd.org>
parents: 8672
diff changeset
263 5.1) Logging of potentially dangerous actions:
267a95510fdf (svn r13375) -Add: logging of actions that could possibly cause desyncs and crashes to simplify debugging. See readme.txt for details
smatz <smatz@openttd.org>
parents: 8672
diff changeset
264 ---- ----------------------------------------
267a95510fdf (svn r13375) -Add: logging of actions that could possibly cause desyncs and crashes to simplify debugging. See readme.txt for details
smatz <smatz@openttd.org>
parents: 8672
diff changeset
265
267a95510fdf (svn r13375) -Add: logging of actions that could possibly cause desyncs and crashes to simplify debugging. See readme.txt for details
smatz <smatz@openttd.org>
parents: 8672
diff changeset
266 OpenTTD is a complex program, and together with NewGRF, it may show a buggy
267a95510fdf (svn r13375) -Add: logging of actions that could possibly cause desyncs and crashes to simplify debugging. See readme.txt for details
smatz <smatz@openttd.org>
parents: 8672
diff changeset
267 behaviour. But not only bugs in code can cause problems. There are several
267a95510fdf (svn r13375) -Add: logging of actions that could possibly cause desyncs and crashes to simplify debugging. See readme.txt for details
smatz <smatz@openttd.org>
parents: 8672
diff changeset
268 ways to affect game state possibly resulting in program crash or multiplayer
267a95510fdf (svn r13375) -Add: logging of actions that could possibly cause desyncs and crashes to simplify debugging. See readme.txt for details
smatz <smatz@openttd.org>
parents: 8672
diff changeset
269 desyncs.
267a95510fdf (svn r13375) -Add: logging of actions that could possibly cause desyncs and crashes to simplify debugging. See readme.txt for details
smatz <smatz@openttd.org>
parents: 8672
diff changeset
270 Easier way would be to forbid all these unsafe actions, but that would affect
267a95510fdf (svn r13375) -Add: logging of actions that could possibly cause desyncs and crashes to simplify debugging. See readme.txt for details
smatz <smatz@openttd.org>
parents: 8672
diff changeset
271 game usability for many players. We certainly do not want that.
267a95510fdf (svn r13375) -Add: logging of actions that could possibly cause desyncs and crashes to simplify debugging. See readme.txt for details
smatz <smatz@openttd.org>
parents: 8672
diff changeset
272 However, we receive bugreports because of this. To reduce time spent with
267a95510fdf (svn r13375) -Add: logging of actions that could possibly cause desyncs and crashes to simplify debugging. See readme.txt for details
smatz <smatz@openttd.org>
parents: 8672
diff changeset
273 solving these problems, these potentially unsafe actions are logged in
267a95510fdf (svn r13375) -Add: logging of actions that could possibly cause desyncs and crashes to simplify debugging. See readme.txt for details
smatz <smatz@openttd.org>
parents: 8672
diff changeset
274 the savegame (including crash.sav). Log is stored in crash logs, too.
267a95510fdf (svn r13375) -Add: logging of actions that could possibly cause desyncs and crashes to simplify debugging. See readme.txt for details
smatz <smatz@openttd.org>
parents: 8672
diff changeset
275
267a95510fdf (svn r13375) -Add: logging of actions that could possibly cause desyncs and crashes to simplify debugging. See readme.txt for details
smatz <smatz@openttd.org>
parents: 8672
diff changeset
276 Information logged:
267a95510fdf (svn r13375) -Add: logging of actions that could possibly cause desyncs and crashes to simplify debugging. See readme.txt for details
smatz <smatz@openttd.org>
parents: 8672
diff changeset
277
267a95510fdf (svn r13375) -Add: logging of actions that could possibly cause desyncs and crashes to simplify debugging. See readme.txt for details
smatz <smatz@openttd.org>
parents: 8672
diff changeset
278 * Adding / removing / changing order of NewGRFs
267a95510fdf (svn r13375) -Add: logging of actions that could possibly cause desyncs and crashes to simplify debugging. See readme.txt for details
smatz <smatz@openttd.org>
parents: 8672
diff changeset
279 * Changing NewGRF parameters, loading compatible NewGRF
267a95510fdf (svn r13375) -Add: logging of actions that could possibly cause desyncs and crashes to simplify debugging. See readme.txt for details
smatz <smatz@openttd.org>
parents: 8672
diff changeset
280 * Changing game mode (scenario editor <-> normal game)
267a95510fdf (svn r13375) -Add: logging of actions that could possibly cause desyncs and crashes to simplify debugging. See readme.txt for details
smatz <smatz@openttd.org>
parents: 8672
diff changeset
281 * Loading game saved in a different OTTD / TTDPatch / TTD version
267a95510fdf (svn r13375) -Add: logging of actions that could possibly cause desyncs and crashes to simplify debugging. See readme.txt for details
smatz <smatz@openttd.org>
parents: 8672
diff changeset
282 * Running a modified OTTD build
11069
36d798171bfd (svn r15410) -Cleanup: get rid of most of the references to the 'patches' except where it's used for backward compatability.
rubidium <rubidium@openttd.org>
parents: 10583
diff changeset
283 * Changing settings affecting NewGRF behaviour (non-networksafe settings)
9457
267a95510fdf (svn r13375) -Add: logging of actions that could possibly cause desyncs and crashes to simplify debugging. See readme.txt for details
smatz <smatz@openttd.org>
parents: 8672
diff changeset
284 * Changing landscape (by cheat)
9704
e1476334067a (svn r13816) -Fix [FS#2150]: check for vehicle length changes outside a depot (callback 0x11) and give a warning about that
smatz <smatz@openttd.org>
parents: 9558
diff changeset
285 * Triggering NewGRF bugs
9457
267a95510fdf (svn r13375) -Add: logging of actions that could possibly cause desyncs and crashes to simplify debugging. See readme.txt for details
smatz <smatz@openttd.org>
parents: 8672
diff changeset
286
267a95510fdf (svn r13375) -Add: logging of actions that could possibly cause desyncs and crashes to simplify debugging. See readme.txt for details
smatz <smatz@openttd.org>
parents: 8672
diff changeset
287 No personal information is stored.
267a95510fdf (svn r13375) -Add: logging of actions that could possibly cause desyncs and crashes to simplify debugging. See readme.txt for details
smatz <smatz@openttd.org>
parents: 8672
diff changeset
288
267a95510fdf (svn r13375) -Add: logging of actions that could possibly cause desyncs and crashes to simplify debugging. See readme.txt for details
smatz <smatz@openttd.org>
parents: 8672
diff changeset
289 You can show the gamelog by typing 'gamelog' in the console or by running
267a95510fdf (svn r13375) -Add: logging of actions that could possibly cause desyncs and crashes to simplify debugging. See readme.txt for details
smatz <smatz@openttd.org>
parents: 8672
diff changeset
290 OpenTTD in debug mode.
267a95510fdf (svn r13375) -Add: logging of actions that could possibly cause desyncs and crashes to simplify debugging. See readme.txt for details
smatz <smatz@openttd.org>
parents: 8672
diff changeset
291
267a95510fdf (svn r13375) -Add: logging of actions that could possibly cause desyncs and crashes to simplify debugging. See readme.txt for details
smatz <smatz@openttd.org>
parents: 8672
diff changeset
292
0
fa6ee4d75c8a (svn r1) Import of revision 975 of old (crashed) SVN
truelight <truelight@openttd.org>
parents:
diff changeset
293 6.0) Configuration File:
fa6ee4d75c8a (svn r1) Import of revision 975 of old (crashed) SVN
truelight <truelight@openttd.org>
parents:
diff changeset
294 ---- -------------------
1734
d37fcb08ac21 (svn r2238) - [ 1184377 ] Update to OpenTTD readme (orudge)
Darkvater <Darkvater@openttd.org>
parents: 1703
diff changeset
295 The configuration file for OpenTTD (openttd.cfg) is in a simple Windows-like
2401
240a3baa3b56 (svn r2927) Fix/remove stale information, line breaks, inform FreeBSD users about the required ports
tron <tron@openttd.org>
parents: 2134
diff changeset
296 .INI format. It's mostly undocumented. Almost all settings can be changed
11069
36d798171bfd (svn r15410) -Cleanup: get rid of most of the references to the 'patches' except where it's used for backward compatability.
rubidium <rubidium@openttd.org>
parents: 10583
diff changeset
297 ingame by using the 'Advanced Settings' window.
11372
371d9d118d1d (svn r15722) -Change: add a bit more information to the readme.
rubidium <rubidium@openttd.org>
parents: 11369
diff changeset
298 When you can not find openttd.cfg you should look in the directories as
371d9d118d1d (svn r15722) -Change: add a bit more information to the readme.
rubidium <rubidium@openttd.org>
parents: 11369
diff changeset
299 described in section 4.2. If you do not have an openttd.cfg OpenTTD will
371d9d118d1d (svn r15722) -Change: add a bit more information to the readme.
rubidium <rubidium@openttd.org>
parents: 11369
diff changeset
300 create one after closing.
0
fa6ee4d75c8a (svn r1) Import of revision 975 of old (crashed) SVN
truelight <truelight@openttd.org>
parents:
diff changeset
301
fa6ee4d75c8a (svn r1) Import of revision 975 of old (crashed) SVN
truelight <truelight@openttd.org>
parents:
diff changeset
302
fa6ee4d75c8a (svn r1) Import of revision 975 of old (crashed) SVN
truelight <truelight@openttd.org>
parents:
diff changeset
303 7.0) Compiling:
fa6ee4d75c8a (svn r1) Import of revision 975 of old (crashed) SVN
truelight <truelight@openttd.org>
parents:
diff changeset
304 ---- ----------
fa6ee4d75c8a (svn r1) Import of revision 975 of old (crashed) SVN
truelight <truelight@openttd.org>
parents:
diff changeset
305 Windows:
5355
4449e5529205 (svn r7527) -Update appropiate files with release information for 0.5.0-RC1
Darkvater <Darkvater@openttd.org>
parents: 4785
diff changeset
306 You need Microsoft Visual Studio .NET. Open the project file
1703
2bd7418694e2 (svn r2207) - Update readme.txt about some windows compilation and troubleshooting running openttd without a soundcard.
Darkvater <Darkvater@openttd.org>
parents: 1694
diff changeset
307 and it should build automatically. In case you want to build with SDL support
2bd7418694e2 (svn r2207) - Update readme.txt about some windows compilation and troubleshooting running openttd without a soundcard.
Darkvater <Darkvater@openttd.org>
parents: 1694
diff changeset
308 you need to add WITH_SDL to the project settings.
2401
240a3baa3b56 (svn r2927) Fix/remove stale information, line breaks, inform FreeBSD users about the required ports
tron <tron@openttd.org>
parents: 2134
diff changeset
309 PNG (WITH_PNG) and ZLIB (WITH_ZLIB) support is enabled by default. For these
240a3baa3b56 (svn r2927) Fix/remove stale information, line breaks, inform FreeBSD users about the required ports
tron <tron@openttd.org>
parents: 2134
diff changeset
310 to work you need their development files. For best results, download the
240a3baa3b56 (svn r2927) Fix/remove stale information, line breaks, inform FreeBSD users about the required ports
tron <tron@openttd.org>
parents: 2134
diff changeset
311 openttd-useful.zip file from SourceForge under the Files tab. Put the header
240a3baa3b56 (svn r2927) Fix/remove stale information, line breaks, inform FreeBSD users about the required ports
tron <tron@openttd.org>
parents: 2134
diff changeset
312 files into your compiler's include/ directory and the library (.lib) files
240a3baa3b56 (svn r2927) Fix/remove stale information, line breaks, inform FreeBSD users about the required ports
tron <tron@openttd.org>
parents: 2134
diff changeset
313 into the lib/ directory.
5355
4449e5529205 (svn r7527) -Update appropiate files with release information for 0.5.0-RC1
Darkvater <Darkvater@openttd.org>
parents: 4785
diff changeset
314 For more help with VS see docs/Readme_Windows_MSVC.txt.
222
d1b097f4593b (svn r223) -Fix: Const correctness and miscellaneous fixes. Thank you Tron for your diligent fixing of warnings (and some possibly bugs) (Tron)
darkvater <darkvater@openttd.org>
parents: 37
diff changeset
315
1734
d37fcb08ac21 (svn r2238) - [ 1184377 ] Update to OpenTTD readme (orudge)
Darkvater <Darkvater@openttd.org>
parents: 1703
diff changeset
316 You can also build it using the Makefile with MSYS/MinGW or Cygwin/MinGW.
0
fa6ee4d75c8a (svn r1) Import of revision 975 of old (crashed) SVN
truelight <truelight@openttd.org>
parents:
diff changeset
317 Please read the Makefile for more information.
fa6ee4d75c8a (svn r1) Import of revision 975 of old (crashed) SVN
truelight <truelight@openttd.org>
parents:
diff changeset
318
6219
246a4090287a (svn r9016) [SunOS] -Fix: Don't use a struct-member that doesn't exist.
celestar <celestar@openttd.org>
parents: 6168
diff changeset
319 Solaris 10:
246a4090287a (svn r9016) [SunOS] -Fix: Don't use a struct-member that doesn't exist.
celestar <celestar@openttd.org>
parents: 6168
diff changeset
320 You need g++ (version 3 or higher), together with SDL. Installation of
246a4090287a (svn r9016) [SunOS] -Fix: Don't use a struct-member that doesn't exist.
celestar <celestar@openttd.org>
parents: 6168
diff changeset
321 libpng and zlib is recommended. For the first build it is required
246a4090287a (svn r9016) [SunOS] -Fix: Don't use a struct-member that doesn't exist.
celestar <celestar@openttd.org>
parents: 6168
diff changeset
322 to execute "bash configure" first. Note that ./configure does not work
246a4090287a (svn r9016) [SunOS] -Fix: Don't use a struct-member that doesn't exist.
celestar <celestar@openttd.org>
parents: 6168
diff changeset
323 yet. It is likely that you don't have a strip binary, so use the
246a4090287a (svn r9016) [SunOS] -Fix: Don't use a struct-member that doesn't exist.
celestar <celestar@openttd.org>
parents: 6168
diff changeset
324 --disable-strip option in that case. Fontconfig (>2.3.0) and freetype
246a4090287a (svn r9016) [SunOS] -Fix: Don't use a struct-member that doesn't exist.
celestar <celestar@openttd.org>
parents: 6168
diff changeset
325 are optional. "make run" will then run the program.
246a4090287a (svn r9016) [SunOS] -Fix: Don't use a struct-member that doesn't exist.
celestar <celestar@openttd.org>
parents: 6168
diff changeset
326
0
fa6ee4d75c8a (svn r1) Import of revision 975 of old (crashed) SVN
truelight <truelight@openttd.org>
parents:
diff changeset
327 Unix:
1133
1f932de27169 (svn r1634) Update readme: JAM support has been removed, also be more precise which version of SDL is needed to compile
tron <tron@openttd.org>
parents: 1125
diff changeset
328 OpenTTD can be built with GNU "make". On non-GNU systems it's called "gmake".
5475
eabf4b86aed6 (svn r7759) -Merge: makefile rewrite. This merge features:
rubidium <rubidium@openttd.org>
parents: 5443
diff changeset
329 However, for the first build one has to do a "./configure" first.
1133
1f932de27169 (svn r1634) Update readme: JAM support has been removed, also be more precise which version of SDL is needed to compile
tron <tron@openttd.org>
parents: 1125
diff changeset
330 Note that you need SDL-devel 1.2.5 (or higher) to compile OpenTTD.
0
fa6ee4d75c8a (svn r1) Import of revision 975 of old (crashed) SVN
truelight <truelight@openttd.org>
parents:
diff changeset
331
2937
181d8b11070e (svn r3493) -docs: [OSX] forgot to add Cocoa drivers and universal binaries as supported (thanks to Tobin for noticing)
bjarni <bjarni@openttd.org>
parents: 2936
diff changeset
332 MacOS X:
181d8b11070e (svn r3493) -docs: [OSX] forgot to add Cocoa drivers and universal binaries as supported (thanks to Tobin for noticing)
bjarni <bjarni@openttd.org>
parents: 2936
diff changeset
333 Use "make" or Xcode (which will then call make for you)
5404
2a651add2378 (svn r7600) -Remove: out-dated documentation about console and Mandrake Readme.
rubidium <rubidium@openttd.org>
parents: 5397
diff changeset
334 This will give you a binary for your CPU type (PPC/Intel)
5475
eabf4b86aed6 (svn r7759) -Merge: makefile rewrite. This merge features:
rubidium <rubidium@openttd.org>
parents: 5443
diff changeset
335 However, for the first build one has to do a "./configure" first.
eabf4b86aed6 (svn r7759) -Merge: makefile rewrite. This merge features:
rubidium <rubidium@openttd.org>
parents: 5443
diff changeset
336 To make a universal binary type "./configure --enabled-universal"
eabf4b86aed6 (svn r7759) -Merge: makefile rewrite. This merge features:
rubidium <rubidium@openttd.org>
parents: 5443
diff changeset
337 instead of "./configure".
0
fa6ee4d75c8a (svn r1) Import of revision 975 of old (crashed) SVN
truelight <truelight@openttd.org>
parents:
diff changeset
338
fa6ee4d75c8a (svn r1) Import of revision 975 of old (crashed) SVN
truelight <truelight@openttd.org>
parents:
diff changeset
339 BeOS:
5475
eabf4b86aed6 (svn r7759) -Merge: makefile rewrite. This merge features:
rubidium <rubidium@openttd.org>
parents: 5443
diff changeset
340 Use "make", but do a "./configure" before the first build.
0
fa6ee4d75c8a (svn r1) Import of revision 975 of old (crashed) SVN
truelight <truelight@openttd.org>
parents:
diff changeset
341
1734
d37fcb08ac21 (svn r2238) - [ 1184377 ] Update to OpenTTD readme (orudge)
Darkvater <Darkvater@openttd.org>
parents: 1703
diff changeset
342 FreeBSD:
2401
240a3baa3b56 (svn r2927) Fix/remove stale information, line breaks, inform FreeBSD users about the required ports
tron <tron@openttd.org>
parents: 2134
diff changeset
343 You need the port devel/sdl12 for a non-dedicated build.
240a3baa3b56 (svn r2927) Fix/remove stale information, line breaks, inform FreeBSD users about the required ports
tron <tron@openttd.org>
parents: 2134
diff changeset
344 graphics/png is optional for screenshots in the PNG format.
5475
eabf4b86aed6 (svn r7759) -Merge: makefile rewrite. This merge features:
rubidium <rubidium@openttd.org>
parents: 5443
diff changeset
345 Use "gmake", but do a "./configure" before the first build.
0
fa6ee4d75c8a (svn r1) Import of revision 975 of old (crashed) SVN
truelight <truelight@openttd.org>
parents:
diff changeset
346
6673
b42a1e412f8e (svn r9904) -Codechange [FS#798]: Add OpenBSD support to configure (matthias)
peter1138 <peter1138@openttd.org>
parents: 6514
diff changeset
347 OpenBSD:
b42a1e412f8e (svn r9904) -Codechange [FS#798]: Add OpenBSD support to configure (matthias)
peter1138 <peter1138@openttd.org>
parents: 6514
diff changeset
348 Use "gmake", but do a "./configure" before the first build.
b42a1e412f8e (svn r9904) -Codechange [FS#798]: Add OpenBSD support to configure (matthias)
peter1138 <peter1138@openttd.org>
parents: 6514
diff changeset
349 Note that you need the port devel/sdl to compile OpenTTD.
b42a1e412f8e (svn r9904) -Codechange [FS#798]: Add OpenBSD support to configure (matthias)
peter1138 <peter1138@openttd.org>
parents: 6514
diff changeset
350
1734
d37fcb08ac21 (svn r2238) - [ 1184377 ] Update to OpenTTD readme (orudge)
Darkvater <Darkvater@openttd.org>
parents: 1703
diff changeset
351 MorphOS:
5475
eabf4b86aed6 (svn r7759) -Merge: makefile rewrite. This merge features:
rubidium <rubidium@openttd.org>
parents: 5443
diff changeset
352 Use "make". However, for the first build one has to do a "./configure" first.
eabf4b86aed6 (svn r7759) -Merge: makefile rewrite. This merge features:
rubidium <rubidium@openttd.org>
parents: 5443
diff changeset
353 Note that you need the MorphOS SDK, latest libnix updates (else C++ parts of
eabf4b86aed6 (svn r7759) -Merge: makefile rewrite. This merge features:
rubidium <rubidium@openttd.org>
parents: 5443
diff changeset
354 OpenTTD will not build) and the powersdl.library SDK. Optionally libz,
eabf4b86aed6 (svn r7759) -Merge: makefile rewrite. This merge features:
rubidium <rubidium@openttd.org>
parents: 5443
diff changeset
355 libpng and freetype2 developer files.
0
fa6ee4d75c8a (svn r1) Import of revision 975 of old (crashed) SVN
truelight <truelight@openttd.org>
parents:
diff changeset
356
1734
d37fcb08ac21 (svn r2238) - [ 1184377 ] Update to OpenTTD readme (orudge)
Darkvater <Darkvater@openttd.org>
parents: 1703
diff changeset
357 OS/2:
7045
49110cf8e2d9 (svn r10310) -Fix: Trunk can now be built on OS/2 :)
orudge <orudge@openttd.org>
parents: 6744
diff changeset
358 A comprehensive GNU build environment is required to build the OS/2 version.
49110cf8e2d9 (svn r10310) -Fix: Trunk can now be built on OS/2 :)
orudge <orudge@openttd.org>
parents: 6744
diff changeset
359 See the docs/Readme_OS2.txt file for more information.
1734
d37fcb08ac21 (svn r2238) - [ 1184377 ] Update to OpenTTD readme (orudge)
Darkvater <Darkvater@openttd.org>
parents: 1703
diff changeset
360
10385
9709c41adf56 (svn r14636) -Add: DOS port of OpenTTD, without network support though.
rubidium <rubidium@openttd.org>
parents: 9945
diff changeset
361 DOS:
9709c41adf56 (svn r14636) -Add: DOS port of OpenTTD, without network support though.
rubidium <rubidium@openttd.org>
parents: 9945
diff changeset
362 A build environment with DJGPP is needed as well as libraries such as
9709c41adf56 (svn r14636) -Add: DOS port of OpenTTD, without network support though.
rubidium <rubidium@openttd.org>
parents: 9945
diff changeset
363 Allegro, zlib and libpng, which all can be downloaded from the DJGPP
9709c41adf56 (svn r14636) -Add: DOS port of OpenTTD, without network support though.
rubidium <rubidium@openttd.org>
parents: 9945
diff changeset
364 website. Compilation is straight forward: use make, but do a "./configure"
9709c41adf56 (svn r14636) -Add: DOS port of OpenTTD, without network support though.
rubidium <rubidium@openttd.org>
parents: 9945
diff changeset
365 before the first build. The build binary will need cwsdpmi.exe to be in
9709c41adf56 (svn r14636) -Add: DOS port of OpenTTD, without network support though.
rubidium <rubidium@openttd.org>
parents: 9945
diff changeset
366 the same directory as the openttd executable. cwsdpmi.exe can be found in
9709c41adf56 (svn r14636) -Add: DOS port of OpenTTD, without network support though.
rubidium <rubidium@openttd.org>
parents: 9945
diff changeset
367 the os/dos subdirectory. If you compile with stripping turned on a binary
9709c41adf56 (svn r14636) -Add: DOS port of OpenTTD, without network support though.
rubidium <rubidium@openttd.org>
parents: 9945
diff changeset
368 will be generated that does not need cwsdpmi.exe by adding the cswdstub.exe
9709c41adf56 (svn r14636) -Add: DOS port of OpenTTD, without network support though.
rubidium <rubidium@openttd.org>
parents: 9945
diff changeset
369 to the created OpenTTD binary.
9709c41adf56 (svn r14636) -Add: DOS port of OpenTTD, without network support though.
rubidium <rubidium@openttd.org>
parents: 9945
diff changeset
370
10453
645c83f6f00c (svn r14708) -Change: update a few urls and fix some small errors/missing things in a few documents.
rubidium <rubidium@openttd.org>
parents: 10399
diff changeset
371 The following libraries are used by OpenTTD for:
645c83f6f00c (svn r14708) -Change: update a few urls and fix some small errors/missing things in a few documents.
rubidium <rubidium@openttd.org>
parents: 10399
diff changeset
372 - libSDL/liballegro: hardware access (video, sound, mouse)
645c83f6f00c (svn r14708) -Change: update a few urls and fix some small errors/missing things in a few documents.
rubidium <rubidium@openttd.org>
parents: 10399
diff changeset
373 - zlib: (de)compressing of savegames
645c83f6f00c (svn r14708) -Change: update a few urls and fix some small errors/missing things in a few documents.
rubidium <rubidium@openttd.org>
parents: 10399
diff changeset
374 - libpng: making screenshots and loading heightmaps
645c83f6f00c (svn r14708) -Change: update a few urls and fix some small errors/missing things in a few documents.
rubidium <rubidium@openttd.org>
parents: 10399
diff changeset
375 - libfreetype: loading generic fonts and rendering them
645c83f6f00c (svn r14708) -Change: update a few urls and fix some small errors/missing things in a few documents.
rubidium <rubidium@openttd.org>
parents: 10399
diff changeset
376 - libfontconfig: searching for fonts, resolving font names to actual fonts
645c83f6f00c (svn r14708) -Change: update a few urls and fix some small errors/missing things in a few documents.
rubidium <rubidium@openttd.org>
parents: 10399
diff changeset
377 - libicu: handling of right-to-left scripts (e.g. Arabic and Persian)
1734
d37fcb08ac21 (svn r2238) - [ 1184377 ] Update to OpenTTD readme (orudge)
Darkvater <Darkvater@openttd.org>
parents: 1703
diff changeset
378
0
fa6ee4d75c8a (svn r1) Import of revision 975 of old (crashed) SVN
truelight <truelight@openttd.org>
parents:
diff changeset
379 8.0) Translating:
fa6ee4d75c8a (svn r1) Import of revision 975 of old (crashed) SVN
truelight <truelight@openttd.org>
parents:
diff changeset
380 ---- -------------------
10453
645c83f6f00c (svn r14708) -Change: update a few urls and fix some small errors/missing things in a few documents.
rubidium <rubidium@openttd.org>
parents: 10399
diff changeset
381 See http://www.openttd.org/development for up-to-date information.
250
9995f44f61b7 (svn r251) -Project ready for 0.3.4 release. Updated installer, readme and fileinformation
darkvater <darkvater@openttd.org>
parents: 222
diff changeset
382
2401
240a3baa3b56 (svn r2927) Fix/remove stale information, line breaks, inform FreeBSD users about the required ports
tron <tron@openttd.org>
parents: 2134
diff changeset
383 The use of the online Translator service, located at
4785
7c3a3b9e6cb2 (svn r6699) -Fixed translator link in readme
Darkvater <Darkvater@openttd.org>
parents: 4254
diff changeset
384 http://translator2.openttd.org/, is highly encouraged. For a username/password
2401
240a3baa3b56 (svn r2927) Fix/remove stale information, line breaks, inform FreeBSD users about the required ports
tron <tron@openttd.org>
parents: 2134
diff changeset
385 combo you should contact the development team, either by mail, IRC or the
240a3baa3b56 (svn r2927) Fix/remove stale information, line breaks, inform FreeBSD users about the required ports
tron <tron@openttd.org>
parents: 2134
diff changeset
386 forums. The system is straightforward to use, and if you have any problems,
240a3baa3b56 (svn r2927) Fix/remove stale information, line breaks, inform FreeBSD users about the required ports
tron <tron@openttd.org>
parents: 2134
diff changeset
387 read the online help located there.
250
9995f44f61b7 (svn r251) -Project ready for 0.3.4 release. Updated installer, readme and fileinformation
darkvater <darkvater@openttd.org>
parents: 222
diff changeset
388
2401
240a3baa3b56 (svn r2927) Fix/remove stale information, line breaks, inform FreeBSD users about the required ports
tron <tron@openttd.org>
parents: 2134
diff changeset
389 If for some reason the website is down for a longer period of time, the
240a3baa3b56 (svn r2927) Fix/remove stale information, line breaks, inform FreeBSD users about the required ports
tron <tron@openttd.org>
parents: 2134
diff changeset
390 information below might be of help.
0
fa6ee4d75c8a (svn r1) Import of revision 975 of old (crashed) SVN
truelight <truelight@openttd.org>
parents:
diff changeset
391
fa6ee4d75c8a (svn r1) Import of revision 975 of old (crashed) SVN
truelight <truelight@openttd.org>
parents:
diff changeset
392 8.1) Guidelines:
fa6ee4d75c8a (svn r1) Import of revision 975 of old (crashed) SVN
truelight <truelight@openttd.org>
parents:
diff changeset
393 ---- -------------------
fa6ee4d75c8a (svn r1) Import of revision 975 of old (crashed) SVN
truelight <truelight@openttd.org>
parents:
diff changeset
394 Here are some translation guidelines which you should follow closely.
fa6ee4d75c8a (svn r1) Import of revision 975 of old (crashed) SVN
truelight <truelight@openttd.org>
parents:
diff changeset
395
3122
ccf65121c0c0 (svn r3727) - Fix some typos in the readme and known-bugs text files
Darkvater <Darkvater@openttd.org>
parents: 2946
diff changeset
396 * Please contact the development team before beginning the translation
2401
240a3baa3b56 (svn r2927) Fix/remove stale information, line breaks, inform FreeBSD users about the required ports
tron <tron@openttd.org>
parents: 2134
diff changeset
397 process! This avoids double work, as someone else may have already
240a3baa3b56 (svn r2927) Fix/remove stale information, line breaks, inform FreeBSD users about the required ports
tron <tron@openttd.org>
parents: 2134
diff changeset
398 started translating to the same language.
0
fa6ee4d75c8a (svn r1) Import of revision 975 of old (crashed) SVN
truelight <truelight@openttd.org>
parents:
diff changeset
399
fa6ee4d75c8a (svn r1) Import of revision 975 of old (crashed) SVN
truelight <truelight@openttd.org>
parents:
diff changeset
400 8.2) Translation:
fa6ee4d75c8a (svn r1) Import of revision 975 of old (crashed) SVN
truelight <truelight@openttd.org>
parents:
diff changeset
401 ---- -------------------
2401
240a3baa3b56 (svn r2927) Fix/remove stale information, line breaks, inform FreeBSD users about the required ports
tron <tron@openttd.org>
parents: 2134
diff changeset
402 So, now that you've notified the development team about your intention to
240a3baa3b56 (svn r2927) Fix/remove stale information, line breaks, inform FreeBSD users about the required ports
tron <tron@openttd.org>
parents: 2134
diff changeset
403 translate (You did, right? Of course you did.) you can pick up english.txt
10453
645c83f6f00c (svn r14708) -Change: update a few urls and fix some small errors/missing things in a few documents.
rubidium <rubidium@openttd.org>
parents: 10399
diff changeset
404 (found in the SVN repository under /src/lang) and translate.
0
fa6ee4d75c8a (svn r1) Import of revision 975 of old (crashed) SVN
truelight <truelight@openttd.org>
parents:
diff changeset
405
fa6ee4d75c8a (svn r1) Import of revision 975 of old (crashed) SVN
truelight <truelight@openttd.org>
parents:
diff changeset
406 You must change the first two lines of the file appropriately:
fa6ee4d75c8a (svn r1) Import of revision 975 of old (crashed) SVN
truelight <truelight@openttd.org>
parents:
diff changeset
407
fa6ee4d75c8a (svn r1) Import of revision 975 of old (crashed) SVN
truelight <truelight@openttd.org>
parents:
diff changeset
408 ##name English-Name-Of-Language
fa6ee4d75c8a (svn r1) Import of revision 975 of old (crashed) SVN
truelight <truelight@openttd.org>
parents:
diff changeset
409 ##ownname Native-Name-Of-Language
fa6ee4d75c8a (svn r1) Import of revision 975 of old (crashed) SVN
truelight <truelight@openttd.org>
parents:
diff changeset
410
fa6ee4d75c8a (svn r1) Import of revision 975 of old (crashed) SVN
truelight <truelight@openttd.org>
parents:
diff changeset
411 Note: Do not alter the following parts of the file:
fa6ee4d75c8a (svn r1) Import of revision 975 of old (crashed) SVN
truelight <truelight@openttd.org>
parents:
diff changeset
412
fa6ee4d75c8a (svn r1) Import of revision 975 of old (crashed) SVN
truelight <truelight@openttd.org>
parents:
diff changeset
413 * String identifiers (the first word on each line)
fa6ee4d75c8a (svn r1) Import of revision 975 of old (crashed) SVN
truelight <truelight@openttd.org>
parents:
diff changeset
414 * Parts of the strings which are in curly braces (such as {STRING})
2401
240a3baa3b56 (svn r2927) Fix/remove stale information, line breaks, inform FreeBSD users about the required ports
tron <tron@openttd.org>
parents: 2134
diff changeset
415 * Lines beginning with ## (such as ##id), other than the first two lines of
240a3baa3b56 (svn r2927) Fix/remove stale information, line breaks, inform FreeBSD users about the required ports
tron <tron@openttd.org>
parents: 2134
diff changeset
416 the file
0
fa6ee4d75c8a (svn r1) Import of revision 975 of old (crashed) SVN
truelight <truelight@openttd.org>
parents:
diff changeset
417
fa6ee4d75c8a (svn r1) Import of revision 975 of old (crashed) SVN
truelight <truelight@openttd.org>
parents:
diff changeset
418 8.3) Previewing:
fa6ee4d75c8a (svn r1) Import of revision 975 of old (crashed) SVN
truelight <truelight@openttd.org>
parents:
diff changeset
419 ---- -------------------
2401
240a3baa3b56 (svn r2927) Fix/remove stale information, line breaks, inform FreeBSD users about the required ports
tron <tron@openttd.org>
parents: 2134
diff changeset
420 In order to view the translation in the game, you need to compile your language
10583
119424494408 (svn r14846) -Doc: strgen hasn't been part of the trunk/release binaries for quite a while, so point to the precompiled strgen package instead.
rubidium <rubidium@openttd.org>
parents: 10515
diff changeset
421 file with the strgen utility. You can download the precompiled strgen from:
119424494408 (svn r14846) -Doc: strgen hasn't been part of the trunk/release binaries for quite a while, so point to the precompiled strgen package instead.
rubidium <rubidium@openttd.org>
parents: 10515
diff changeset
422 http://www.openttd.org/download-strgen
119424494408 (svn r14846) -Doc: strgen hasn't been part of the trunk/release binaries for quite a while, so point to the precompiled strgen package instead.
rubidium <rubidium@openttd.org>
parents: 10515
diff changeset
423 To compile it yourself just take the normal OpenTTD sources and build that.
119424494408 (svn r14846) -Doc: strgen hasn't been part of the trunk/release binaries for quite a while, so point to the precompiled strgen package instead.
rubidium <rubidium@openttd.org>
parents: 10515
diff changeset
424 During the build process the strgen utility will be made.
0
fa6ee4d75c8a (svn r1) Import of revision 975 of old (crashed) SVN
truelight <truelight@openttd.org>
parents:
diff changeset
425
fa6ee4d75c8a (svn r1) Import of revision 975 of old (crashed) SVN
truelight <truelight@openttd.org>
parents:
diff changeset
426 strgen is a command-line utility. It takes the language filename as parameter.
fa6ee4d75c8a (svn r1) Import of revision 975 of old (crashed) SVN
truelight <truelight@openttd.org>
parents:
diff changeset
427 Example:
fa6ee4d75c8a (svn r1) Import of revision 975 of old (crashed) SVN
truelight <truelight@openttd.org>
parents:
diff changeset
428
fa6ee4d75c8a (svn r1) Import of revision 975 of old (crashed) SVN
truelight <truelight@openttd.org>
parents:
diff changeset
429 strgen lang/german.txt
fa6ee4d75c8a (svn r1) Import of revision 975 of old (crashed) SVN
truelight <truelight@openttd.org>
parents:
diff changeset
430
fa6ee4d75c8a (svn r1) Import of revision 975 of old (crashed) SVN
truelight <truelight@openttd.org>
parents:
diff changeset
431 This results in compiling german.txt and produces another file named german.lng.
2401
240a3baa3b56 (svn r2927) Fix/remove stale information, line breaks, inform FreeBSD users about the required ports
tron <tron@openttd.org>
parents: 2134
diff changeset
432 Any missing strings are replaced with the English strings. Note that it looks
240a3baa3b56 (svn r2927) Fix/remove stale information, line breaks, inform FreeBSD users about the required ports
tron <tron@openttd.org>
parents: 2134
diff changeset
433 for english.txt in the lang subdirectory, which is where your language file
240a3baa3b56 (svn r2927) Fix/remove stale information, line breaks, inform FreeBSD users about the required ports
tron <tron@openttd.org>
parents: 2134
diff changeset
434 should also be.
0
fa6ee4d75c8a (svn r1) Import of revision 975 of old (crashed) SVN
truelight <truelight@openttd.org>
parents:
diff changeset
435
fa6ee4d75c8a (svn r1) Import of revision 975 of old (crashed) SVN
truelight <truelight@openttd.org>
parents:
diff changeset
436 That's all! You should now be able to select the language in the game options.
fa6ee4d75c8a (svn r1) Import of revision 975 of old (crashed) SVN
truelight <truelight@openttd.org>
parents:
diff changeset
437
1703
2bd7418694e2 (svn r2207) - Update readme.txt about some windows compilation and troubleshooting running openttd without a soundcard.
Darkvater <Darkvater@openttd.org>
parents: 1694
diff changeset
438 9.0) Troubleshooting
1734
d37fcb08ac21 (svn r2238) - [ 1184377 ] Update to OpenTTD readme (orudge)
Darkvater <Darkvater@openttd.org>
parents: 1703
diff changeset
439 ---- ---------------
d37fcb08ac21 (svn r2238) - [ 1184377 ] Update to OpenTTD readme (orudge)
Darkvater <Darkvater@openttd.org>
parents: 1703
diff changeset
440
2401
240a3baa3b56 (svn r2927) Fix/remove stale information, line breaks, inform FreeBSD users about the required ports
tron <tron@openttd.org>
parents: 2134
diff changeset
441 To see all startup options available to you, start OpenTTD with the
240a3baa3b56 (svn r2927) Fix/remove stale information, line breaks, inform FreeBSD users about the required ports
tron <tron@openttd.org>
parents: 2134
diff changeset
442 "./openttd -h" option. This might help you tweak some of the settings.
1734
d37fcb08ac21 (svn r2238) - [ 1184377 ] Update to OpenTTD readme (orudge)
Darkvater <Darkvater@openttd.org>
parents: 1703
diff changeset
443
3122
ccf65121c0c0 (svn r3727) - Fix some typos in the readme and known-bugs text files
Darkvater <Darkvater@openttd.org>
parents: 2946
diff changeset
444 If the game is acting strange and you feel adventurous you can try the
2401
240a3baa3b56 (svn r2927) Fix/remove stale information, line breaks, inform FreeBSD users about the required ports
tron <tron@openttd.org>
parents: 2134
diff changeset
445 "-d [[<name>]=[<level>]" flag, where the higher levels will give you more
240a3baa3b56 (svn r2927) Fix/remove stale information, line breaks, inform FreeBSD users about the required ports
tron <tron@openttd.org>
parents: 2134
diff changeset
446 debugging output. The "name" variable can help you to display only some type of
240a3baa3b56 (svn r2927) Fix/remove stale information, line breaks, inform FreeBSD users about the required ports
tron <tron@openttd.org>
parents: 2134
diff changeset
447 debugging messages. This is mostly undocumented so best is to look in the
240a3baa3b56 (svn r2927) Fix/remove stale information, line breaks, inform FreeBSD users about the required ports
tron <tron@openttd.org>
parents: 2134
diff changeset
448 source code file debug.c for the various debugging types. For more information
240a3baa3b56 (svn r2927) Fix/remove stale information, line breaks, inform FreeBSD users about the required ports
tron <tron@openttd.org>
parents: 2134
diff changeset
449 look at http://wiki.openttd.org/index.php/Command_line.
1734
d37fcb08ac21 (svn r2238) - [ 1184377 ] Update to OpenTTD readme (orudge)
Darkvater <Darkvater@openttd.org>
parents: 1703
diff changeset
450
2401
240a3baa3b56 (svn r2927) Fix/remove stale information, line breaks, inform FreeBSD users about the required ports
tron <tron@openttd.org>
parents: 2134
diff changeset
451 The most frequent problem is missing data files. Don't forget to put all GRF
240a3baa3b56 (svn r2927) Fix/remove stale information, line breaks, inform FreeBSD users about the required ports
tron <tron@openttd.org>
parents: 2134
diff changeset
452 files from TTD into your data/ folder including sample.cat!
1734
d37fcb08ac21 (svn r2238) - [ 1184377 ] Update to OpenTTD readme (orudge)
Darkvater <Darkvater@openttd.org>
parents: 1703
diff changeset
453
2401
240a3baa3b56 (svn r2927) Fix/remove stale information, line breaks, inform FreeBSD users about the required ports
tron <tron@openttd.org>
parents: 2134
diff changeset
454 Under Windows 98 and lower it is impossible to use a dedicated server; it will
240a3baa3b56 (svn r2927) Fix/remove stale information, line breaks, inform FreeBSD users about the required ports
tron <tron@openttd.org>
parents: 2134
diff changeset
455 fail to start. Perhaps this is for the better because those OS's are not known
240a3baa3b56 (svn r2927) Fix/remove stale information, line breaks, inform FreeBSD users about the required ports
tron <tron@openttd.org>
parents: 2134
diff changeset
456 for their stability.
0
fa6ee4d75c8a (svn r1) Import of revision 975 of old (crashed) SVN
truelight <truelight@openttd.org>
parents:
diff changeset
457
5355
4449e5529205 (svn r7527) -Update appropiate files with release information for 0.5.0-RC1
Darkvater <Darkvater@openttd.org>
parents: 4785
diff changeset
458 With the added support for font-based text selecting a non-latin language will
4449e5529205 (svn r7527) -Update appropiate files with release information for 0.5.0-RC1
Darkvater <Darkvater@openttd.org>
parents: 4785
diff changeset
459 result in garbage (lots of '?') shown on screen. Please open your configuration
4449e5529205 (svn r7527) -Update appropiate files with release information for 0.5.0-RC1
Darkvater <Darkvater@openttd.org>
parents: 4785
diff changeset
460 file and add a desired font for small/medium/-and large_font. This can be a font
4449e5529205 (svn r7527) -Update appropiate files with release information for 0.5.0-RC1
Darkvater <Darkvater@openttd.org>
parents: 4785
diff changeset
461 name like "Tahoma" or a path to a font.
4449e5529205 (svn r7527) -Update appropiate files with release information for 0.5.0-RC1
Darkvater <Darkvater@openttd.org>
parents: 4785
diff changeset
462
4449e5529205 (svn r7527) -Update appropiate files with release information for 0.5.0-RC1
Darkvater <Darkvater@openttd.org>
parents: 4785
diff changeset
463 Any NewGRF file used in a game is stored inside the savegame and will refuse
4449e5529205 (svn r7527) -Update appropiate files with release information for 0.5.0-RC1
Darkvater <Darkvater@openttd.org>
parents: 4785
diff changeset
464 to load if you don't have that grf file available. A list of missing files
4449e5529205 (svn r7527) -Update appropiate files with release information for 0.5.0-RC1
Darkvater <Darkvater@openttd.org>
parents: 4785
diff changeset
465 will be output to the console at the moment, so use the '-d' flag (on windows)
4449e5529205 (svn r7527) -Update appropiate files with release information for 0.5.0-RC1
Darkvater <Darkvater@openttd.org>
parents: 4785
diff changeset
466 to see this list. You just have to find the files (http://grfcrawler.tt-forums.net/)
4449e5529205 (svn r7527) -Update appropiate files with release information for 0.5.0-RC1
Darkvater <Darkvater@openttd.org>
parents: 4785
diff changeset
467 put them in the data/ folder and you're set to go.
4449e5529205 (svn r7527) -Update appropiate files with release information for 0.5.0-RC1
Darkvater <Darkvater@openttd.org>
parents: 4785
diff changeset
468
0
fa6ee4d75c8a (svn r1) Import of revision 975 of old (crashed) SVN
truelight <truelight@openttd.org>
parents:
diff changeset
469 X.X) Credits:
fa6ee4d75c8a (svn r1) Import of revision 975 of old (crashed) SVN
truelight <truelight@openttd.org>
parents:
diff changeset
470 ---- --------
1124
405b7f9410be (svn r1625) -Alphabetized credits list
darkvater <darkvater@openttd.org>
parents: 961
diff changeset
471 The OpenTTD team (in alphabetical order):
8059
3cb0afbc2249 (svn r11620) -Change: Some are going, some are coming, some we do not know exactly. Little update on the OpenTTD Team
belugas <belugas@openttd.org>
parents: 8052
diff changeset
472 Jean-Francois Claeys (Belugas) - GUI, newindustries and more
3cb0afbc2249 (svn r11620) -Change: Some are going, some are coming, some we do not know exactly. Little update on the OpenTTD Team
belugas <belugas@openttd.org>
parents: 8052
diff changeset
473 Bjarni Corfitzen (Bjarni) - MacOSX port, coder and vehicles
3cb0afbc2249 (svn r11620) -Change: Some are going, some are coming, some we do not know exactly. Little update on the OpenTTD Team
belugas <belugas@openttd.org>
parents: 8052
diff changeset
474 Matthijs Kooijman (blathijs) - Pathfinder-guru, pool rework
9945
538705a4c605 (svn r14100) -Fix(r14099): Who reads readme.txt files anyway?. Same work as previous commit.
belugas <belugas@openttd.org>
parents: 9704
diff changeset
475 Victor Fischer (Celestar) - Programming everywhere you need him to
538705a4c605 (svn r14100) -Fix(r14099): Who reads readme.txt files anyway?. Same work as previous commit.
belugas <belugas@openttd.org>
parents: 9704
diff changeset
476 Christoph Elsenhans (frosch) - General coding
11369
41fcb66a1256 (svn r15719) -Update: the credit section.
yexo <yexo@openttd.org>
parents: 11311
diff changeset
477 Loïc Guilloux (glx) - Windows Expert
10453
645c83f6f00c (svn r14708) -Change: update a few urls and fix some small errors/missing things in a few documents.
rubidium <rubidium@openttd.org>
parents: 10399
diff changeset
478 Michael Lutz (michi_cc) - Path based signals
8059
3cb0afbc2249 (svn r11620) -Change: Some are going, some are coming, some we do not know exactly. Little update on the OpenTTD Team
belugas <belugas@openttd.org>
parents: 8052
diff changeset
479 Owen Rudge (orudge) - Forum host, OS/2 port
8184
060e78474842 (svn r11747) -Change: Return of the prodigal son (or something). Little update (but highly noticed) on the OpenTTD Team
belugas <belugas@openttd.org>
parents: 8059
diff changeset
480 Peter Nelson (peter1138) - Spiritual descendant from newGRF gods
8059
3cb0afbc2249 (svn r11620) -Change: Some are going, some are coming, some we do not know exactly. Little update on the OpenTTD Team
belugas <belugas@openttd.org>
parents: 8052
diff changeset
481 Remko Bijker (Rubidium) - Lead coder and way more
3cb0afbc2249 (svn r11620) -Change: Some are going, some are coming, some we do not know exactly. Little update on the OpenTTD Team
belugas <belugas@openttd.org>
parents: 8052
diff changeset
482 Zdenek Sojka (SmatZ) - Bug finder and fixer
11369
41fcb66a1256 (svn r15719) -Update: the credit section.
yexo <yexo@openttd.org>
parents: 11311
diff changeset
483 Thijs Marinussen (Yexo) - AI Framework
8059
3cb0afbc2249 (svn r11620) -Change: Some are going, some are coming, some we do not know exactly. Little update on the OpenTTD Team
belugas <belugas@openttd.org>
parents: 8052
diff changeset
484
3cb0afbc2249 (svn r11620) -Change: Some are going, some are coming, some we do not know exactly. Little update on the OpenTTD Team
belugas <belugas@openttd.org>
parents: 8052
diff changeset
485 Inactive Developers:
3cb0afbc2249 (svn r11620) -Change: Some are going, some are coming, some we do not know exactly. Little update on the OpenTTD Team
belugas <belugas@openttd.org>
parents: 8052
diff changeset
486 Tamás Faragó (Darkvater) - Ex-Lead coder
11369
41fcb66a1256 (svn r15719) -Update: the credit section.
yexo <yexo@openttd.org>
parents: 11311
diff changeset
487 Jaroslav Mazanec (KUDr) - YAPG (Yet Another Pathfinder God) ;)
41fcb66a1256 (svn r15719) -Update: the credit section.
yexo <yexo@openttd.org>
parents: 11311
diff changeset
488 Jonathan Coome (Maedhros) - High priest of the NewGRF Temple
41fcb66a1256 (svn r15719) -Update: the credit section.
yexo <yexo@openttd.org>
parents: 11311
diff changeset
489 Attila Bán (MiHaMiX) - WebTranslator, Nightlies, Wiki and bugtracker host
1125
de436fc47e5f (svn r1626) -Updated readme and credits list.
darkvater <darkvater@openttd.org>
parents: 1124
diff changeset
490 Christoph Mallon (Tron) - Programmer, code correctness police
de436fc47e5f (svn r1626) -Updated readme and credits list.
darkvater <darkvater@openttd.org>
parents: 1124
diff changeset
491
de436fc47e5f (svn r1626) -Updated readme and credits list.
darkvater <darkvater@openttd.org>
parents: 1124
diff changeset
492 Retired Developers:
8059
3cb0afbc2249 (svn r11620) -Change: Some are going, some are coming, some we do not know exactly. Little update on the OpenTTD Team
belugas <belugas@openttd.org>
parents: 8052
diff changeset
493 Ludvig Strigeus (ludde) - OpenTTD author, main coder (0.1 - 0.3.3)
3cb0afbc2249 (svn r11620) -Change: Some are going, some are coming, some we do not know exactly. Little update on the OpenTTD Team
belugas <belugas@openttd.org>
parents: 8052
diff changeset
494 Serge Paquet (vurlix) - Assistant project manager, coder (0.1 - 0.3.3)
1703
2bd7418694e2 (svn r2207) - Update readme.txt about some windows compilation and troubleshooting running openttd without a soundcard.
Darkvater <Darkvater@openttd.org>
parents: 1694
diff changeset
495 Dominik Scherer (dominik81) - Lead programmer, GUI expert (0.3.0 - 0.3.6)
11369
41fcb66a1256 (svn r15719) -Update: the credit section.
yexo <yexo@openttd.org>
parents: 11311
diff changeset
496 Benedikt Brüggemeier (skidd13) - Bug fixer and code reworker
41fcb66a1256 (svn r15719) -Update: the credit section.
yexo <yexo@openttd.org>
parents: 11311
diff changeset
497 Patric Stout (TrueLight) - Programmer, webhoster (0.3 - pre0.7)
799
ca9bb7e58029 (svn r1269) - Updated changelog.txt and readme.txt for 0.3.5
truelight <truelight@openttd.org>
parents: 614
diff changeset
498
0
fa6ee4d75c8a (svn r1) Import of revision 975 of old (crashed) SVN
truelight <truelight@openttd.org>
parents:
diff changeset
499 Thanks to:
5404
2a651add2378 (svn r7600) -Remove: out-dated documentation about console and Mandrake Readme.
rubidium <rubidium@openttd.org>
parents: 5397
diff changeset
500 Josef Drexler - For his great work on TTDPatch.
2a651add2378 (svn r7600) -Remove: out-dated documentation about console and Mandrake Readme.
rubidium <rubidium@openttd.org>
parents: 5397
diff changeset
501 Marcin Grzegorczyk - For his TTDPatch work and documentation of TTD internals and graphics (signals and track foundations)
2a651add2378 (svn r7600) -Remove: out-dated documentation about console and Mandrake Readme.
rubidium <rubidium@openttd.org>
parents: 5397
diff changeset
502 Petr Baudis (pasky) - Many patches, newgrf support, etc.
8059
3cb0afbc2249 (svn r11620) -Change: Some are going, some are coming, some we do not know exactly. Little update on the OpenTTD Team
belugas <belugas@openttd.org>
parents: 8052
diff changeset
503 Simon Sasburg (HackyKid) - For the many bugfixes he has blessed us with
5404
2a651add2378 (svn r7600) -Remove: out-dated documentation about console and Mandrake Readme.
rubidium <rubidium@openttd.org>
parents: 5397
diff changeset
504 Stefan Meißner (sign_de) - For his work on the console
2a651add2378 (svn r7600) -Remove: out-dated documentation about console and Mandrake Readme.
rubidium <rubidium@openttd.org>
parents: 5397
diff changeset
505 Mike Ragsdale - OpenTTD installer
2a651add2378 (svn r7600) -Remove: out-dated documentation about console and Mandrake Readme.
rubidium <rubidium@openttd.org>
parents: 5397
diff changeset
506 Cian Duffy (MYOB) - BeOS port / manual writing
2a651add2378 (svn r7600) -Remove: out-dated documentation about console and Mandrake Readme.
rubidium <rubidium@openttd.org>
parents: 5397
diff changeset
507 Christian Rosentreter (tokai) - MorphOS / AmigaOS port
2a651add2378 (svn r7600) -Remove: out-dated documentation about console and Mandrake Readme.
rubidium <rubidium@openttd.org>
parents: 5397
diff changeset
508 Richard Kempton (RichK67) - Additional airports, initial TGP implementation
11225
b99d60de9a5d (svn r15578) -Change: unexternalise squirrel.
rubidium <rubidium@openttd.org>
parents: 11154
diff changeset
509 Alberto Demichelis - Squirrel scripting language
5404
2a651add2378 (svn r7600) -Remove: out-dated documentation about console and Mandrake Readme.
rubidium <rubidium@openttd.org>
parents: 5397
diff changeset
510 Michael Blunck - For revolutionizing TTD with awesome graphics
2a651add2378 (svn r7600) -Remove: out-dated documentation about console and Mandrake Readme.
rubidium <rubidium@openttd.org>
parents: 5397
diff changeset
511 George - Canal graphics
6691
d2fb32d942f7 (svn r9923) -Add: support for Action 0 Road vehicles, property 1C, bit 0.
rubidium <rubidium@openttd.org>
parents: 6673
diff changeset
512 David Dallaston (Pikka) - Tram tracks
5404
2a651add2378 (svn r7600) -Remove: out-dated documentation about console and Mandrake Readme.
rubidium <rubidium@openttd.org>
parents: 5397
diff changeset
513 All Translators - For their support to make OpenTTD a truly international game
2a651add2378 (svn r7600) -Remove: out-dated documentation about console and Mandrake Readme.
rubidium <rubidium@openttd.org>
parents: 5397
diff changeset
514 Bug Reporters - Thanks for all bug reports
2a651add2378 (svn r7600) -Remove: out-dated documentation about console and Mandrake Readme.
rubidium <rubidium@openttd.org>
parents: 5397
diff changeset
515 Chris Sawyer - For an amazing game!