NewGRF stands for New Graphics Resource File which provide a general interface to mod(ify) the game. This is not to be confused with the 32bpp replacement graphics which just override existing 8bpp graphics with different graphics.
NewGRF is the way to add new or modify existing graphics, vehicles, buildings, cargos, railtypes, objects and industries within OpenTTD. NewGRF files may be downloaded and selected for activation prior to creation of a new game in order to introduce these features. Unlike Advanced Settings which may be changed part way through a game, NewGRF should be installed prior to starting a new game in order to ensure correct operation. The name "NewGRF" refers to the new features added to GRF files (Transport Tycoon graphics resource files) which can be exploited to change graphics and the behaviour of the game. NewGRF is a shared format between OpenTTD and TTDPatch, and is almost fully compatible with both.
For common issues with GRF files in OpenTTD, visit the NewGRF FAQ.
The most common and convenient way to obtain NewGRFs is by using the ingame online content download feature. Most NewGRF can be found there. There exists also a NewGRF forum where you may find development versions of some newgrfs.
If you want to use NewGRFs obtained from other locations, which are not available from the online content download, you need to manually install them into the correct place. A NewGRF is a single file (with the extension .grf) for example: "grvts.grf". To install a NewGRF:
- Download the NewGRF (.grf) file.
- Move the NewGRF file to the data directory of your OpenTTD installation.
- This will often be:
- C:\My Documents\data (Windows 95, 98, ME)
- C:\Documents and Settings\<username>\My Documents\OpenTTD\data (Windows 2000, XP)
- C:\Users\<username>\Documents\OpenTTD\data (Windows Vista, 7)
- ~/.openttd/data (Linux, BSD)
- ~/Documents/OpenTTD/data (OSX)
1. In the main menu, click "NewGRF Settings".
The interface changed between OpenTTD 1.0 and 1.1, thus both will be presented here after one another:
Version 1.0 and earlier
2. Click "Add".
3. Select the NewGRF file you want to use, then click "Add To Selection".
4. Click "Add" to add more NewGRFs, then "Apply Changes" when you are done.
2. Select a NewGRF from the 'inactive NewGRFs files' and press "Add" or simply double click on it. On small screens it looks like
and on big screens it more conveniently expands to:
3. Configure an active newgrf's parameter, if needed: Select it from the 'active newgrf files' list and choose the 'parameter' button. The result may look similar to
4. Optionally you may choose to save the selection of newgrfs (along with their configuration parameters) or load such list by making use of the NewGRF presets:
Now, whenever you start a new game, the choice of NewGRFs will become active, and whatever changes they make to the game will become effective. However changing these settings will have no effect on existing savegames as newgrfs are an integral part of a savegame and the list of used newgrfs is stored within it.
The order of (active) NewGRFs is important in determining how different NewGRFs interact. A NewGRF lower in the list overrides the effects of a NewGRF further up in the list.
- GRFCrawler A non-comprehensive database of available NewGRFs
- NewGraphicSpecs Specs of the GRF Format
- 'NewGRF forum.