NML:Overriding vehicles in other NewGRFs

NewGRF Meta Language

Preface

Getting started

Graphics files

Blocks

Units

Expressions

Elementary values

Builtin functions

Language files

Lists of props, vars and CBs

Warnings

Additional references

NewGRF compatibility

Deprecated syntax

Changes from NML 0.2 to 0.3

Changes from NML 0.3 to 0.4

Changes from NML 0.4 to 0.5

Vehicles, Stations, Canals, Bridges, Towns, Houses, Industries (Tiles), Cargos, Airports+Tiles, Objects, Railtypes, Roadtypes, Tramtypes, Terrain

NML Tutorial

Block Syntax

GRF

• GRF parameters

Item

• Property
• Graphics
• Livery override

Realsprites

Recolour sprites

Template

Spriteset

Spritegroup

Spritelayout

Tilelayout

Switch

Produce

Random switch

Cargotable

Railtypetable / Roadtypetable / Tramtypetable

If/else

While

Error

Disable items

Deactivate other NewGRFs

Testing for other NewGRFs

Overriding vehicles in other NewGRFs

Sprite replacement

• Replace TTD sprites
• Replace new sprites
• Add font glyphs

Alternative (32bpp) sprites

Town names

• Town names parts

Snow line

Parameter assignment

Setting base costs

Sorting vehicles in the purchase list

If one wants to modify vehicles defined in another NewGRF it has to be stated explicitly by the engine_override command that this is desired. If stated, all vehicles defined within the overriding NewGRF will try to override the vehicle with the same ID within the overridden NewGRF. This can be used to modify single properties of these only. This function is intended for NewGRFs that modify parts of other NewGRFs, e.g. the ECS extension for the DBSetXL.

The syntax is as follows:

engine_override(targetID);
engine_override(sourceID, targetID);

The targetID must be the grfID of the NewGRF whose vehicles are supposed to be changed via the engine override. The sourceID is the grfID of the NewGRF defining the overriding vehicles. If not set explicitly, the grfID of the NewGRF containing this statement is used. Both grfIDs are 4-byte strings.