NMLTutorial/Cargotable - Revision history

FooBar: Information on the 'new' cargo_(dis)allow_refit properties

2012-05-03T16:33:52Z

Information on the 'new' cargo_(dis)allow_refit properties

← Older revision		Revision as of 16:33, 3 May 2012
Line 19:		Line 19:

	=== First 32 cargo labels ===		=== First 32 cargo labels ===
	~~The~~ first 32 cargo labels ~~however~~ should be selected with care~~, if you're making a vehicle set~~. The reasons for this is that only the first 32 cargos can be used in the <code>refittable_cargo_types</code> property for vehicles. So stick cargo labels you use in that property into the cargotable first and add other cargo labels at the end.		[[File:Ttdpatch_icon.png]] When making a vehicle set for TTDPatch, the first 32 cargo labels should be selected with care. The reasons for this is that only the first 32 cargos can be used in the <code>refittable_cargo_types</code> property for vehicles. So stick cargo labels you use in that property into the cargotable first and add other cargo labels at the end.

			[[File:Openttd_icon.png]] If you're using more advanced features of NewGRF that only work in OpenTTD anyways, the order of labels in the cargotable doesn't matter. For OpenTTD-only vehicle sets you should not use the <code>refittable_cargo_types</code> property, but the <code>cargo_allow_refit</code> and <code>cargo_disallow_refit</code> properties instead.


	== Cargo labels or cargo classes? ==		== Cargo labels or cargo classes? ==
	When it comes to allowing cargos in a vehicle, you should always use cargo classes and not only cargo labels. That way your vehicle set will be compatible with cargos that don't even exist yet. ~~Use cargo labels only to ''deny'' specific cargos in your vehicles or to provide specific graphics for a specific cargo.~~		When it comes to allowing cargos in a vehicle, you should always use cargo classes and not only cargo labels. That way your vehicle set will be compatible with cargos that don't even exist yet.

			[[File:Ttdpatch_icon.png]] Use cargo labels only to deny or allow specific cargos in your vehicles that don't match the cargo classes you have set.

			[[File:Openttd_icon.png]] For OpenTTD-only vehicle NewGRFs, define all known cargo labels in the <code>cargo_allow_refit</code> and <code>cargo_disallow_refit</code> properties and provide the cargo classes additionally to that for compatibility with future cargoes that haven't been invented yet.

	Furthermore, industries and houses don't work with cargo classes, so there you can only use the cargo labels.		Furthermore, industries and houses don't work with cargo classes, so there you can only use the cargo labels. Also if you want specific graphics for specific cargoes, you have to use cargo types and not cargo classes.

FooBar: pre class

2011-08-27T22:17:09Z

pre class

← Older revision		Revision as of 22:17, 27 August 2011
Line 10:		Line 10:
	The cargotable itself is no more than a list of cargo labels. You need to [http://newgrf-specs.tt-wiki.net/wiki/CargoTypes#Cargo_Labels look the cargo labels up] for the cargos you want to do special things with. This is what the general syntax looks like:		The cargotable itself is no more than a list of cargo labels. You need to [http://newgrf-specs.tt-wiki.net/wiki/CargoTypes#Cargo_Labels look the cargo labels up] for the cargos you want to do special things with. This is what the general syntax looks like:

	<pre>		<pre class="pseudo">
	cargotable {		cargotable {
	<cargo_label1> [, <cargo_label2> [, <cargo_label3> ... ]]		<cargo_label1> [, <cargo_label2> [, <cargo_label3> ... ]]

FooBar: you can have only one cargotable

2011-08-23T22:12:53Z

you can have only one cargotable

← Older revision		Revision as of 22:12, 23 August 2011
Line 6:		Line 6:
	== Cargotable ==		== Cargotable ==

	The cargotable is the means to let NML know about the cargo labels you want to use in your NML file. ~~Every~~ ~~NewGRF~~ can have exactly one cargotable ~~(but you may select from several using if/else statements)~~. The cargotable needs to be defined before you reference a cargo label in your NML code.		The cargotable is the means to let NML know about the cargo labels you want to use in your NML file. An NML file can have exactly one cargotable. The cargotable needs to be defined before you reference a cargo label in your NML code.

	The cargotable itself is no more than a list of cargo labels. You need to [http://newgrf-specs.tt-wiki.net/wiki/CargoTypes#Cargo_Labels look the cargo labels up] for the cargos you want to do special things with. This is what the general syntax looks like:		The cargotable itself is no more than a list of cargo labels. You need to [http://newgrf-specs.tt-wiki.net/wiki/CargoTypes#Cargo_Labels look the cargo labels up] for the cargos you want to do special things with. This is what the general syntax looks like:

FooBar: some words on the cargotable

2011-08-23T20:52:11Z

some words on the cargotable

New page

{{NMLTutorial}}

Whenever you want to work with specific cargos, you need to teach NML about those cargos. The reason for this is that new cargos can be invented at will, so NML doesn't keep a list of existing cargo labels and therefore you have to provide this list yourself. 

== Cargotable ==

The cargotable is the means to let NML know about the cargo labels you want to use in your NML file. Every NewGRF can have exactly one cargotable (but you may select from several using if/else statements). The cargotable needs to be defined before you reference a cargo label in your NML code.

The cargotable itself is no more than a list of cargo labels. You need to [http://newgrf-specs.tt-wiki.net/wiki/CargoTypes#Cargo_Labels look the cargo labels up] for the cargos you want to do special things with. This is what the general syntax looks like:

<pre>
cargotable {
<cargo_label1> [, <cargo_label2> [, <cargo_label3> ... ]]
}
</pre>

You can add as many cargo labels to the cargotable as you want/need.

=== First 32 cargo labels ===
The first 32 cargo labels however should be selected with care, if you're making a vehicle set. The reasons for this is that only the first 32 cargos can be used in the <code>refittable_cargo_types</code> property for vehicles. So stick cargo labels you use in that property into the cargotable first and add other cargo labels at the end.

== Cargo labels or cargo classes? ==
When it comes to allowing cargos in a vehicle, you should always use cargo classes and not only cargo labels. That way your vehicle set will be compatible with cargos that don't even exist yet. Use cargo labels only to ''deny'' specific cargos in your vehicles or to provide specific graphics for a specific cargo.

Furthermore, industries and houses don't work with cargo classes, so there you can only use the cargo labels.

Now that you know about the cargotable, let's add some cargo specific graphics to our example road vehicle.

{{NMLTutorialNavbar|Road vehicle graphics template|Road vehicle cargo graphics}}