NML:Main

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, Roadstops, Canals, Towns, Houses, Industries (Tiles), Cargos, Airports+Tiles, Objects, Railtypes, Roadtypes, Tramtypes, Bridges, Badges, Terrain

NML Tutorial

Preface

Changes between NML 0.2 and head / 0.3

Getting started

Graphics files

Language structure and block syntax

• GRF and its parameters
• Item (Properties, graphics, livery overrides)

• Defining sprites

  • Realsprites
  • Template
  • Base Graphics
  • Spriteset

    Replacing sprites

    • Replace TTD sprites
    • Replace new sprites
    • Add font glpyhs
    • Alternative sprites (32bpp, zoom levels)

    Aranging and grouping sprites

    • Spritegroup (Vehicles)
    • Spritelayout (Houses, industries, stations, airports)
    • Recolour sprites

• Flow control

  • Tilelayout
  • Switch
  • Produce
  • Random switch

• Global scope

  • Cargotable
  • Railtypetable
  • Snow line
  • Setting base costs
  • Parameter assignment
  • If/else
  • While

• Interaction with other grfs

  • Error
  • Disable items
  • Deactivate other NewGRFs
  • Testing for other NewGRFs
  • Overriding vehicles in other NewGRFs

• Misc

  • Town names
  • Town names parts

Units

Expressions

• Elementary values
• Builtin functions

Language files

Lists of properties, variables and callbacks

General		variables
Vehicles	common properties	variables	callbacks
	train properties
	road vehicle properties
	ship properties
	aircraft properties
Stations	properties	variables	callbacks
Canals	properties	variables	callbacks
Bridges	properties	variables	callbacks
Towns
Houses	properties	variables	callbacks
Industries		common variables
	industry properties	industry variables	industry callbacks
	tile properties	tile variables	tile callbacks
Cargos	properties	variables	callbacks
Airports	properties	variables	callbacks
	tile properties	tile variables	tile callbacks
Objects	properties	variables	callbacks
Railtypes	properties	variables	callbacks

Compiler Warnings

Additional references

• Animation speed
• Default industries
• Default industry tiles
• Base cost table
• List of sound effects
• List of default vehicle IDs
• List of default house properties
• List of town zones
• List of tile classes
• List of default colour translation palettes
• List of direction constants
• List of tile slopes
• Default TTD strings
• Deprecated syntax

NewGRF compatibility

Old-style callbacks

Manual of style