NML:Cargos - Revision history

Andythenorth: /* Cargo classes */

2026-01-17T18:49:40Z

Cargo classes

← Older revision		Revision as of 18:49, 17 January 2026
Line 113:		Line 113:
	The history of cargo classes is complex, and the meanings here may not be consistent with how classes are actually used by some grfs.		The history of cargo classes is complex, and the meanings here may not be consistent with how classes are actually used by some grfs.

	FIRS and Iron Horse do not conform to the classes here, and use the FRAX Cargo Class Scheme, please see: https://grf.farm/~~polar_fox~~/frax_latest.html		FIRS and Iron Horse do not conform to the classes here, and use the FRAX Cargo Class Scheme, please see: https://grf.farm/polar-fox/frax_latest.html

	{\| class="wikitable sortable"		{\| class="wikitable sortable"

Frosch: update ALL_NORMAL_CARGO_CLASSES

2025-03-14T14:29:34Z

update ALL_NORMAL_CARGO_CLASSES

← Older revision		Revision as of 14:29, 14 March 2025
Line 171:		Line 171:
	\|-		\|-
	\| ALL_NORMAL_CARGO_CLASSES		\| ALL_NORMAL_CARGO_CLASSES
	\| Bitmask of all cargo classes except CC_SPECIAL. This is the same as <code style="color:darkgreen">bitmask(CC_PASSENGERS, CC_MAIL, ..., ~~CC_OVERSIZED~~)</code>. Note: This is already a bitmask, don't use the <code style="color:darkgreen">bitmask(..)</code> function with this.		\| Bitmask of all cargo classes except CC_SPECIAL. This is the same as <code style="color:darkgreen">bitmask(CC_PASSENGERS, CC_MAIL, ..., CC_NON_POTABLE)</code>. Note: This is already a bitmask, don't use the <code style="color:darkgreen">bitmask(..)</code> function with this.
	\|-		\|-
	\| ALL_CARGO_CLASSES		\| ALL_CARGO_CLASSES

Andythenorth: /* Cargo classes */ - don't imply that bitmask(CC_EXPRESS, CC_REFRIGERATED) can be assumed to be food, that just adds to existing confusions.

2025-01-05T20:01:42Z

Cargo classes: - don't imply that bitmask(CC_EXPRESS, CC_REFRIGERATED) can be assumed to be food, that just adds to existing confusions.

← Older revision		Revision as of 20:01, 5 January 2025
Line 109:		Line 109:
	===Cargo classes===		===Cargo classes===

	Available cargo classes are listed in the following table. Cargos may be in more than one class. Cargo classes are always used as a bitmask, use the built-in function <code>bitmask()</code>. For example, <code style="color:darkgreen">bitmask(CC_EXPRESS, CC_REFRIGERATED)</code> ~~is used for food~~.		Available cargo classes are listed in the following table. Cargos may be in more than one class. Cargo classes are always used as a bitmask, use the built-in function <code>bitmask()</code>. For example, <code style="color:darkgreen">bitmask(CC_EXPRESS, CC_REFRIGERATED)</code>.

	The history of cargo classes is complex, and the meanings here may not be consistent with how classes are actually used by some grfs.		The history of cargo classes is complex, and the meanings here may not be consistent with how classes are actually used by some grfs.

Brickblock1: /* Cargo properties */

2024-12-28T11:29:57Z

Cargo properties

← Older revision		Revision as of 11:29, 28 December 2024
Line 98:		Line 98:
	\| town_production_effect		\| town_production_effect
	\| TOWNPRODUCTION_XXX		\| TOWNPRODUCTION_XXX
	\| Effect for town production, see [[#Town production effect\|Town production effect]]		\| {{ottdp\|14.0\|no}} Effect for town production, see [[#Town production effect\|Town production effect]]
	\|-		\|-
	\| town_production_multiplier		\| town_production_multiplier
	\| float 0..255		\| float 0..255
	\| {{~~ottd~~\|no}} Multiplier for town production, to be used in conjunction with town_production_effect, when that is not TOWNPRODUCTION_NONE. For example, a value of 4 makes a town produce 4 times as much cargo as normal.		\| {{ottdp\|14.0\|no}} Multiplier for town production, to be used in conjunction with town_production_effect, when that is not TOWNPRODUCTION_NONE. For example, a value of 4 makes a town produce 4 times as much cargo as normal.
	\|}		\|}

Andythenorth: /* Cargo classes */ add CC_POTABLE and CC_NON_POTABLE

2024-12-08T18:01:08Z

Cargo classes: add CC_POTABLE and CC_NON_POTABLE

← Older revision		Revision as of 18:01, 8 December 2024
Line 157:		Line 157:
	\| CC_NON_POURABLE<br>CC_NEO_BULK		\| CC_NON_POURABLE<br>CC_NEO_BULK
	\| sugar cane, wool or straw bales, ... (these are synonyms for cargos that are bulk, but can't be handled in e.g. hoppers)		\| sugar cane, wool or straw bales, ... (these are synonyms for cargos that are bulk, but can't be handled in e.g. hoppers)
			\|-
			\| CC_POTABLE
			\| exclude from non-food-grade vehicles
			\|-
			\| CC_NON_POTABLE
			\| exclude from food-grade vehicles
	\|-		\|-
	\| CC_SPECIAL		\| CC_SPECIAL

Andythenorth: /* Cargo classes */ link to FRAX Cargo Class Scheme

2024-11-23T19:53:16Z

Cargo classes: link to FRAX Cargo Class Scheme

← Older revision		Revision as of 19:53, 23 November 2024
Line 110:		Line 110:

	Available cargo classes are listed in the following table. Cargos may be in more than one class. Cargo classes are always used as a bitmask, use the built-in function <code>bitmask()</code>. For example, <code style="color:darkgreen">bitmask(CC_EXPRESS, CC_REFRIGERATED)</code> is used for food.		Available cargo classes are listed in the following table. Cargos may be in more than one class. Cargo classes are always used as a bitmask, use the built-in function <code>bitmask()</code>. For example, <code style="color:darkgreen">bitmask(CC_EXPRESS, CC_REFRIGERATED)</code> is used for food.

			The history of cargo classes is complex, and the meanings here may not be consistent with how classes are actually used by some grfs.

			FIRS and Iron Horse do not conform to the classes here, and use the FRAX Cargo Class Scheme, please see: https://grf.farm/polar_fox/frax_latest.html

	{\| class="wikitable sortable"		{\| class="wikitable sortable"

Andythenorth: /* Cargo classes */ Cargo class bit 15 (CC_SPECIAL) has been deprecated for years in nfo spec with 'do not set' in docs

2024-11-17T16:24:02Z

Cargo classes: Cargo class bit 15 (CC_SPECIAL) has been deprecated for years in nfo spec with 'do not set' in docs

← Older revision		Revision as of 16:24, 17 November 2024
Line 155:		Line 155:
	\|-		\|-
	\| CC_SPECIAL		\| CC_SPECIAL
			\| Deprecated, do not set.
	\| Special cargo, used for refit tricks. (e.g. regearing in NARS)
	\|-		\|-
	\| NO_CARGO_CLASS		\| NO_CARGO_CLASS

Andythenorth: /* Cargo classes */ - note about CC_NON_POURABLE and CC_NEO_BULK

2024-10-06T09:51:56Z

Cargo classes: - note about CC_NON_POURABLE and CC_NEO_BULK

← Older revision		Revision as of 09:51, 6 October 2024
Line 152:		Line 152:
	\|-		\|-
	\| CC_NON_POURABLE<br>CC_NEO_BULK		\| CC_NON_POURABLE<br>CC_NEO_BULK
	\| sugar cane, wool or straw bales, ...		\| sugar cane, wool or straw bales, ... (these are synonyms for cargos that are bulk, but can't be handled in e.g. hoppers)
	\|-		\|-
	\| CC_SPECIAL		\| CC_SPECIAL

Peter1138: /* Cargo properties */

2024-02-03T13:57:27Z

Cargo properties

@@ Line 95: / Line 95: @@
 | float 0 .. 255
 | {{ottd|1.2|r22860}} This defines the capacity of vehicles carrying this cargo type, if the vehicle sets no specific capacity to this specific cargo type. Set this property to the amount of cargo a vehicle shall carry, which can carry 1 ton of coal or 1000 thousand litres of water (whatever comparison is more suitable for your cargotype). Depending on whether your cargo type is light or heavy you should set this property either comparing the weight or the volume. Default values are 4 for passengers, 2 for mail, goods and sweets and 1 for all other cargos.
 |}
@@ Line 187: / Line 195: @@
 There are some additional effects of these flags on subsidies and town cargo transport statistics.  See the nfo docs for details: https://newgrf-specs.tt-wiki.net/wiki/Action0/Cargos#Substitute_type_and_multiplier_for_town_growth_.2818.2C_19.29
 ==Cargo variables==

Heresy: Changed the appropriate tables from t to sortable.

2022-08-30T21:42:51Z

Changed the appropriate tables from t to sortable.

← Older revision		Revision as of 21:42, 30 August 2022
Line 6:		Line 6:
	==Cargo properties==		==Cargo properties==

	{\| class="t"		{\| class="wikitable sortable"
	! name		! name
	! value range		! value range
Line 103:		Line 103:
	Available cargo classes are listed in the following table. Cargos may be in more than one class. Cargo classes are always used as a bitmask, use the built-in function <code>bitmask()</code>. For example, <code style="color:darkgreen">bitmask(CC_EXPRESS, CC_REFRIGERATED)</code> is used for food.		Available cargo classes are listed in the following table. Cargos may be in more than one class. Cargo classes are always used as a bitmask, use the built-in function <code>bitmask()</code>. For example, <code style="color:darkgreen">bitmask(CC_EXPRESS, CC_REFRIGERATED)</code> is used for food.

	{\| class="t"		{\| class="wikitable sortable"
	! name		! name
	! type of cargo		! type of cargo
Line 161:		Line 161:
	===Cargo effects on town growth===		===Cargo effects on town growth===

	{\| class="t"		{\| class="wikitable sortable"
	! value		! value
	! effect		! effect
Line 194:		Line 194:
	==Cargo callbacks==		==Cargo callbacks==

	{\| class="t"		{\| class="wikitable sortable"
	! callback		! callback
	! return value		! return value
Line 224:		Line 224:
	====Time since the cargo was last picked up====		====Time since the cargo was last picked up====

	{\| class="t"		{\| class="wikitable sortable"
	! Time units (days)		! Time units (days)
	! Score (%, rounded)		! Score (%, rounded)
Line 248:		Line 248:
	====Amount of cargo waiting====		====Amount of cargo waiting====

	{\| class="t"		{\| class="wikitable sortable"
	! Amount of cargo		! Amount of cargo
	! Score (%, rounded)		! Score (%, rounded)
Line 277:		Line 277:
	====Age of the last carrier picking up the cargo====		====Age of the last carrier picking up the cargo====

	{\| class="t"		{\| class="wikitable sortable"
	! Age of vehicle (years)		! Age of vehicle (years)
	! Score (%, rounded)		! Score (%, rounded)