Total Town Replacement Set 3.12 ----------------------------------- Contents: 1 About 2 Installation and Usage 3 Building the NewGRF from source 4 License and credits ------- 1 About ------- Total Town Replacement Set v3 (TTRSv3 for short) is a building set for TTDPatch and OpenTTD, for the temperate, arctic and tropic climates. It contains over 100 town buildings to break the monotony you get with default TTD town buildings. The buildings are separated into four "eras", 1920-1950, 1950-1980, 1980-2010 and 2010-forever. This means your towns will nicely evolve from old-style buildings towards modern buildings as time passes in the game. The set comes with some extras as well. The small airport, big airport and heliport graphics are replaced to make them fit to the buildings. There are two bank versions that replace the original bank and have different looks in the different eras. You also get two new road graphics, one used before 1970, and one used after that year. Town bridge graphics are also replaced. Everything except the bank can be turned off in case you want to use different graphics for these things, or simply prefer the original TTD ones. The set is compatible with the Extended Cargo Scheme project, thanks to George. When petrol is available in your game, towns will start building petrol stations that accept it. Similarly, when the "tourist" cargo is available, some of the buildings will start accepting and producing tourists. This set is, however, also fully functional without using ECS. Name of this Repo: Total Town Replacement Set 3.12 Repository version: 35 GRF_ID: "VC" 00 01 MD5 sum: c0c607fcfb3a6b8acfe088090dc213ee ttrs3w.grf ------------------------ 2 Installation and Usage ------------------------ ttFirst, copy "ttrs3w.grf" to the "newgrf" directory inside your TTD directory. Then open "newgrf.cfg" and add the following line: newgrf/ttrs3w.grf Optionally, you can add up to four numbers (parameters) to the end of the line. These parameters have the following meaning: 1st 0 - Use the new building types only, default TTD buildings are disabled 1 (default) New house types are added without modifying the old types, so towns will have both original TTD and new buildings. 2nd 0 (default) time sequence is followed 1 - Force the 1920-1950 era. This means that the graphics for this era are used no matter what year it actually is in the game. 2 - Force the 1950-1980 era. 3 - Force the 1980-2010 era. 4 - Force the 2010-forever era. 5 - Mix all eras. This means buildings from all eras can appear no matter what year it is in the game. 3rd 0 - Don't use TTRS-v3 townroads and bridges 1 - Use TTRS-v3 townroads and default TTD road bridges 2 (default) Use TTRS-v3 townroads and replace road bridge graphics 4th 0 (default for TTDPatch) Use TTRS-v3 airports. 1 (default for OpenTTD) do not use TTRS-v3 airports If you don't set these parameters in your newgrf[w].cfg file, the default settings will be used. If you're using the road bridge replacements (enabled by default), it is recommended to use the girder steel bridge (the one whose icon is a grey arch) in towns, since its graphics look the best inside towns. There is a small problem with the roads because of a limitation of TTDPatch: the roads can't change automatically in 1970. To work around this, you can do two things when you reach 1970 in your game: a) open the GRF Settings window and press Apply without changing anything; b) save the game and load it back. Any of these two will make the new roads appear. The new heliport graphics have the same limitation. They should change in 1980 and 2010, but this won't actually happen unless you do one of the above two points. 2.1 Incompatible sets --------------------- This set isn't compatible with older versions of TTRS. There are just too many changes to make it compatible, so you're better off starting a new game with the new version. You can activate the set in existing games as well, of course, but it will take some time for the new buildings to appear as towns gradually replace their existing buildings. Similarly, you can't use George's "TTRS3 alpha" set with this set. All buildings of that set is included in this set, so this shouldn't be a problem. When TTRS3 detects one of these sets below itself in the newgrfw.cfg file, it will deactivate them and notify you with a warning. If, however, this set is below those two, it will deactivate itself instead, and show an error about the incompatibility. If you disable those sets manually, everything will work fine. 2.2 Known problems ------------------ TTDPatch 2.5 beta 9 has a bug that messes up all your buildings when you enable a building set in an existing game, and this affects TTRS3 too. Until the next beta comes out, you can either use TTRS3 in new games only, or use 2.6 alpha. In 2.5 beta 9 and earlier, there is a problem that messes up the bridge graphics when you open the GRF Settings window, make some changes and then DON'T press Apply but close the window. To work around this, just open the window again and press Apply without changing anything. The buildings in this set are fully snow-aware since v3.02. This means they can change their graphics dynamically when the snow line height changes. Original arctic TTD buildings can't do this, though. Therefore, if you plan to use variable snow line height GRFs, it's best to disable all original buildings by setting parameter 1 to 0. The set uses some features that are available in 2.6 alphas only. It will work correctly in 2.5 versions as well, but these features won't be available. The differences will be very small. For example, the last remaining old water tower will be protected from destruction and becomes a historical building if you use 2.6, but this is impossible in 2.5. --------------------------------- 3 Building the NewGRF from source --------------------------------- This Makefile system is easiest to setup if you employ a certain directory structure for your NewGRF project. Clone this project and fill in your NewGRF content. Make sure to adopt Makefile.config to your needs. Requirements for running this Makefile successfully: grfcodec nforenum gcc md5sum (or md5 on Mac) make If you want to bundle the grf, you'll need additionally tar zip bzip2 Windows only: On Windows systems this means that you'll need to install MinGW and MSys in order to obtain a posix compatible environment. Then the makefile can be called the very same way as it is on linux and mac systems. MinGW/MSys contain the above mentioned programmes (except renum and grfcodec of course) and can be obtained from http://www.mingw.org/ That site also features an excellent walk-through o how to install it. If you use for OpenTTD data folder a non-default path or Windows with a non-English localization make sure to copy Makefile.local.sample to Makefile.local and edit the line with INSTALLDIR = accordingly so that it shows the full path to your OpenTTD / TTDP data directory. Before this build system can be applied to a newgrf, you have to adopt a few lines in Makefile.config, mainly you'll have to replace "mynewgrf" by the actual name of your newgrf. Also make sure to change that in the .hgignore file. The Makefile offers different targets. A brief overview is given here: all: This is the default target, if also no parameter is given to make. It will simply build the grf file, if it needs building bundle: This target will create a directory called "-nightly" and copy the grf file there and the documentation files, readme.txt, changelog.txt and license.txt bundle_zip This will zip the bundle directory into one zip for distribution bundle_tar This will tar the bundle directory into a tar archive for distribution or upload to bananas install: This will create a tar archive (like bundle_tar) and copy it into the INSTALLDIR as specified in Makefile.local (or the default dir, if that isn't defined). Don't rely on a good detection of the default installation directory. It's especially bound to fail on windows machines. release*: This target will basically do the same as the bundle* targets with one difference: They are packed in a uniquely named directory, so that all different release versions of this can be used in parallel in OpenTTD. release_source: This will create a bundle of the grf's source which can compile without the need for a version control system. Basically a Makefile.local is created which contains these information. clean: This phony target will delete all files which this Makefile will create mrproper: This phony target will delete also all directories created by different Makefile targets remake: It's a shortcut for first cleaning the dir and then making the grf anew. --------------------- 4 License and credits --------------------- The source code can be obtained from the #openttdcoop DevZone at http://dev.openttdcoop.org/projects/ttrs or via mercurial checkout hg clone http://hg.openttdcoop.org/ttrs If you enjoy TTRS-v3, think of the artists and coder who made that possible. The set was drawn by Zimmlock (most of the graphics), George, the Tycoonez.com:munity, Oz, Red*Star, Purno and Pikkabird, and was coded by Csaboka and updated by planetmaker and FooBar. TTRS-v3 has been made for the Transport Tycoon fans; you are free to use it at your disposal, as long as you give the right credits. That includes modifications and enhangements to individual drawings and code slices (see license.txt for the legal words). Translations by: Dutch: FooBar German: planetmaker Norwegian: DJNekkid Polish: voythas Spanish: Terkhen Swedish: AndersI Enjoy, Best Regards the TTRS-v3 team.