Cargo redefinitions

proposal for changing the default cargos, based on [1]

Import from Eddi 11:43, 10 November 2011 (UTC)

Cargo Classes

bit	value	class name	wagon type	usage	vehicle tips	industry tips
0	1	Passenger	passenger wagon	OR	never exclude	do not combine with other flags
1	2	Mail	closed or mail wagon	OR	never exclude	do not combine with other flags
2	4	Air Freight	closed or mail wagon	OR	never exclude, suitable for airplane or maglev	also set at least one of Piece Goods / Bulk / Liquid
3	8	Armored	armored or mail wagon	OR	never exclude	do not combine with other flags
4	10	Bulk (Uncountable)	open or hopper wagon	OR	never exclude	may be combined with Piece Goods or Liquid to simulate multiple modes of transport
5	20	Piece Goods (Countable)	closed or open wagon	OR	never exclude	may be combined with Bulk or Liquid to simulate multiple modes of transport
6	40	Liquid	tank wagon	OR	never exclude	may be combined with Piece Goods or Bulk to simulate multiple modes of transport
7	80	Refrigerated	refrigerated wagon	OR/AND NOT	only exclude, when Piece Goods included	also set Piece Goods
8	100	Hazardous	unknown	OR/AND NOT	only exclude, when special wagons are provided.	no set defines this (yet)
9	200	Covered (weather protected)	closed wagon, open wagon with tarpaulin	OR/AND NOT	do not exclude for Liquid	combine with Piece Goods or Bulk
10	400	Oversized	stake/flatbed wagon	OR/AND NOT	only exclude, when Piece Goods included	combine with Piece Goods
11	800	Powderized (moist protected)	powder/silo wagon	OR/AND NOT	only exclude, when Bulk included	combine with Bulk
12	1000	Not Pourable	open wagon, but not hopper wagon	AND NOT	only exclude, when Bulk included	combine with Bulk
13	2000	-	-	-	-	-
14	4000	-	-	-	-	-
15	8000	special	and not	none	special use	do not set

Wagon Sets

There are many ways how a set of wagons can be designed. Here we show several ways how it can be achieved that all current and future cargos can be transported with at least one wagon. We will attempt this with as few exceptions from the class system as possible.

There are certain situations where you can decide whether a cargo should be transportable in multiple wagons (in following called "permissive") or in only one wagon (in following called "restrictive") at the same time.

A rule of thumb is: Every class should appear at least once in the OR mask, and use the AND NOT mask sparsely. If a class appears in the AND NOT mask, then it should appear once in an OR mask with an empty AND NOT mask, otherwise you risk circular exclusions.

For example, if one wagon has an OR mask of "Liquid", and an AND NOT mask of "Air Freight", and another wagon has an OR mask of "Air Freight", and an AND NOT mask of "Liquid", then neither of the wagons is refittable to BEER.

Small Set

The small set contains only 5 different wagons, and is especially representative for early railways (before 1900), when the development of specialised wagons was not necessary or possible yet.

Wagon	Permissive			Restrictive
	OR Mask	AND NOT Mask	Exceptions	OR Mask	AND NOT Mask	Exceptions
Passenger	0001 Passengers	0000	-	0001 Passengers	0000	-
Mail	000E Mail, Air Freight, Armored	0000	-	000A Mail, Armored	0000	-
Open	1C34 Air Freight, Piece Goods, Bulk, Oversized, Powderized, Not Pourable	0080 Refrigerated	-	1C10 Bulk, Oversized, Powderized, Not Pourable	0000	+WOOD, +STEL
Closed	0036 Mail, Air Freight, Piece Goods, Refrigerated	0400 Oversized	-WOOD, -STEL	000E Air Freight, Piece Goods, Refrigerated	0400 Oversized	-WOOD, -STEL
Tank	0040 Liquid	0000	-	0040 Liquid	0000	-

Large Set

The large set contains all wagons of the small set, plus some specialized wagons for some cargos/classes.

Wagon	Permissive			Restrictive
	OR Mask	AND NOT Mask	Exceptions	OR Mask	AND NOT Mask	Exceptions
Passenger	0001 Passengers	0000	-	0001 Passengers	0000	-
Mail	000E Mail, Air Freight, Armored	0000	-	000A Mail, Armored	0000	-
Open	1034 Air Freight, Piece Goods, Bulk, Not Pourable	0C80 Refrigerated, Oversized, Powderized	-	1010 Bulk, Not Pourable	0800 Powderized	-
Hopper	0010 Bulk	1800 Not Pourable, Powderized	-	0010 Bulk	1800 Not Pourable, Powderized	-
Silo	0800 Powderized	0000	-	0800 Powderized	0000	-
Stake	0424 Air Freight, Piece Goods, Oversized	0080 Refrigerated	-	0400 Oversized	0000	+WOOD, +STEL
Closed	0036 Mail, Air Freight, Piece Goods	0480 Oversized, Refrigerated	-WOOD, -STEL	0024 Air Freight, Piece Goods	0480 Oversized, Refrigerated	-WOOD, -STEL
Refrigerated	0080 Refrigerated	0000	-	0080 Refrigerated	0000	-
Tank	0040 Liquid	0000	-	0040 Liquid	0000	-

A scheme like this can easily be extended by other specialized wagons, e.g. for livestock (LVST) or car (VEHI) transport. For this, just leave the classes empty, and add the cargo via the refit mask.

Cargo Labels

Label	Cargo Description	Cargo classes	proposed addition	Notes
TTD Default Cargos		These cargos are present when no NewGRF is used
PASS	Passengers	0001 Passengers		ECS	FIRS
COAL	Coal	0010 Bulk		ECS	FIRS
MAIL	Mail	0002 Mail		ECS	FIRS
OIL_	Oil	0040 Liquid		ECS	FIRS
LVST	Livestock	0020 Piece Goods		ECS	FIRS
GOOD	Goods	0004 Air Freight	Piece Goods	ECS	FIRS	rename to GODS?
GRAI	Grain	0010 Bulk			FIRS	Temperate; see also WHEA, MAIZ, CERE
WOOD	Wood	0020 Piece Goods	Oversized	ECS	FIRS	rename to LOGS?
IORE	Iron Ore	0010 Bulk		ECS	FIRS
STEL	Steel	0020 Piece goods	Oversized	ECS	FIRS	rename to STEE? Renamed "Metal" in FIRS.
VALU	Valuables	0008 Armored		ECS		Temperate; see also GOLD, DIAM
PAPR	Paper	0020 Piece Goods		ECS
WHEA	Wheat	0010 Bulk				Arctic; see also GRAI, MAIZ, CERE
FOOD	Food	0084 Air Freight, Refrigerated	Piece Goods	ECS	FIRS	rename to FOO_? (needs better idea)
GOLD	Gold	0008 Armored		ECS		Arctic; see also VALU, DIAM
RUBR	Rubber	0040 Liquid		ECS
FRUT	Fruit	0090 Bulk, Refrigerated	Piece Goods	ECS		rename to FRUI?
MAIZ	Maize	0010 Bulk				Tropic; see also GRAI, WHEA, CERE
CORE	Copper Ore	0010 Bulk		ECS
WATR	Water	0040 Liquid		ECS
DIAM	Diamonds	0008 Armored		ECS		Tropic; see also VALU, GOLD
TTD Toyland Cargos		These cargos are present in toyland climate when no NewGRF is used
SUGR	Sugar	0010 Bulk				Toyland
TOYS	Toys	0020 Piece Goods				Toyland
BATT	Batteries	0020 Piece Goods				Toyland
SWET	Sweets (Candy)	0004 Air Freight				Toyland
TOFF	Toffee	0010 Bulk				Toyland
COLA	Cola	0040 Liquid				Toyland
CTCD	Cotton Candy (Candyfloss)	0010 Bulk				Toyland
BUBL	Bubbles	0020 Piece Goods				Toyland
PLST	Plastic	0040 Liquid				Toyland; see also PLAS
FZDR	Fizzy Drinks	0020 Piece Goods				Toyland
New Cargos		these cargos are only present when NewGRF industry sets are used
AORE	Bauxite (Aluminium ore)	0010 Bulk		ECS	FIRS
BEER	Alcohol	0064 Air Freight, Piece Goods, Liquid			FIRS
BDMT	Building Materials	0220 Piece Goods, Covered	Bulk, Powderized (Cement)	ECS	FIRS	Cement has its own cargo label
BRCK	Bricks	0020 Piece Goods		ECS
CERA	Ceramics	0020 Piece Goods		ECS
CERE	Cereals	0210 Bulk, Covered		ECS
CLAY	Clay	0210 Bulk, Covered	Not Pourable		FIRS
CMNT	Cement	0210 Bulk, Covered	Powderized	ECS
COPR	Copper	0020 Piece Goods	Oversized
DYES	Dyes	0060 Piece Goods, Liquid		ECS
ENSP	Engineering Supplies	0024 Air Freight, Piece Goods	Oversized		FIRS
FERT	Fertiliser	0030 Bulk, Piece Goods	Powderized	ECS
FICR	Fibre crops	0030 Bulk, piece goods	Not Pourable	ECS	FIRS
FISH	Fish	0084 Air Freight, Refrigerated	Piece Goods, remove Air Freight	ECS	FIRS
FMSP	Farm Supplies	0024 Air Freight, Piece Goods	Bulk, Powderized (Fertiliser), Oversized (Machines)		FIRS
FRVG	Fruit (and optionally Vegetables)	00A4 Air Freight, Piece Goods, Refrigerated	Bulk		FIRS
GLAS	Glass	0420 Piece Goods, Oversized		ECS
GRVL	Gravel / Ballast	0010 Bulk			FIRS
LIME	Lime stone	0010 Bulk	Powderized	ECS
MILK	Milk	00C4 Air Freight, Liquid, Refrigerated	Piece Goods		FIRS
MNSP	Manufacturing Supplies	0024 Piece Goods, Air Freight	remove Air Freight		FIRS
OLSD	Oil seed	0210 Bulk, Covered	Not Pourable	ECS	Oil seeds are well pourable
PETR	Petrol / Fuel Oil	0040 Liquid		ECS	FIRS
PLAS	Plastic	0060 Piece Goods, Liquid		ECS
POTA	Potash	0210 Bulk, Covered	Powderized	ECS
RCYC	Recyclables	0220 Piece Goods, Covered	Bulk		FIRS
RFPR	Refined products	0040 Liquid	Hazardous	ECS	FIRS
SAND	Sand	0010 Bulk		ECS	FIRS
SCMT	Scrap Metal	0010 Bulk	Not Pourable		FIRS
SGBT	Sugar beet	0010 Bulk			FIRS	not in tropical
SGCN	Sugarcane	0010 Bulk	Not Pourable		FIRS	only tropical. Imagry suggests it's cut down sufficiently to pour
SULP	Sulphur	0210 Bulk, Covered	Not Pourable, Powderized	ECS
TOUR	Tourists	0005 Passengers, Air Freight	remove Air Freight	ECS
VEHI	Vehicles	0420 Piece Goods, Oversized		ECS
WDPR	Wood Products	0030 Bulk, Piece Goods		ECS	FIRS
WOOL	Wool	0220 Piece Goods, Covered		ECS	FIRS
WSTE	Waste	0010 Bulk	Not Pourable		FIRS
Special Cargos		these cargos are for use outside industry sets and do not represent transporting anything
GEAR	Locomotive regearing	8000 Special				Using this cargo may make your vehicle set incompatible with some industry sets use CB36 instead to set capacity to 0
Deprecated Cargos		these cargos are not used by any current industry set, and are listed here for backwards compatibility
FUEL	Fuel	0040 Liquid				Use PETR for refined-oil fuel
RSGR	Raw Sugar	0010 Bulk				Deprecated in FIRS. See SGBT and SGCN
SCRP	Scrap Metal	0010 Piece Goods				Deprecated in FIRS, use SCMT instead
TWOD	Tropic Wood	0020 Piece Goods				formerly intended as a default cargo