Guide for Industry Authors

Sections:

Guide
Example Cargos - Table
Example Cargos - Details

Heads up! Cargo classes are matched individually, so cargos with multiple classes refit into any vehicle matching one of the classes, not all.

Guide

There are three categories of cargo: passenger, mail, and freight.

Passenger Cargo

1 Simply Passengers

Set CC_PASSENGERS. No other classes needed. Done.

Mail Cargo

1 Just Mail

Set CC_MAIL. No other classes needed. Done.

Freight Cargo

1 Potable Status

Set potable status

CC_POTABLE
CC_NON_POTABLE

This is a boolean flag (true / false), and one of these classes should be set appropriately for all freight cargos.

Do not set both of these classes on a cargo. They are mutually exclusive.

2 Basic Handling

Set any basic handling classes that apply.

CC_PIECE_GOODS
CC_OPEN_BULK
CC_COVERED_BULK
CC_POWDER_BULK
CC_LIQUID_BULK
CC_GAS_BULK

Most cargos should include at least one basic handling class.

You can assign multiple basic handling classes if the cargo is transported in different forms. Be sure to include all applicable classes.

For better compatibility with vehicle GRFs, consider adding CC_PIECE_GOODS, as many cargos can be transported this way. Refer to the CC_PIECE_GOODS section for detailed guidance.

Some unique or non-standard cargos may not use any basic handling classes and instead rely solely on special handling classes.

3 Special Handling

Set any special handling classes that apply.

CC_FLATBED
CC_EXPRESS
CC_ARMOURED
CC_REFRIGERATED
CC_WEIRD

These classes are designed for less common, specialized vehicles and highlight which cargos are best suited to them. They represent a recommendation—'should use' rather than 'can use.' For example, while steel could technically be transported in a refrigerated vehicle, it doesn’t need refrigeration. Similarly, diamonds should be marked as armoured because they require secure transport. However, marking diamonds as flatbed cargo would be inappropriate and unhelpful.

Assign as many special handling classes as genuinely necessary for the cargo.

Example Cargos - Table

Example Cargo	Recommended Classes
Ammonia	CC_NON_POTABLE CC_GAS_BULK
Beans	CC_POTABLE CC_PIECE_GOODS CC_COVERED_BULK
Cement	CC_NON_POTABLE CC_PIECE_GOODS CC_POWDER_BULK
Chlorine	CC_NON_POTABLE CC_GAS_BULK
Coal	CC_NON_POTABLE CC_OPEN_BULK
Diamonds	CC_NON_POTABLE CC_ARMOURED
Explosives	CC_NON_POTABLE CC_PIECE_GOODS CC_EXPRESS CC_ARMOURED
Fish	CC_POTABLE CC_PIECE_GOODS CC_EXPRESS CC_REFRIGERATED
Flour	CC_POTABLE CC_PIECE_GOODS CC_COVERED_BULK CC_POWDER_BULK
Food	CC_POTABLE CC_PIECE_GOODS CC_LIQUID_BULK CC_EXPRESS CC_REFRIGERATED
Goods	CC_NON_POTABLE CC_PIECE_GOODS CC_FLATBED
Grain	CC_POTABLE CC_PIECE_GOODS CC_COVERED_BULK
Iron Ore	CC_NON_POTABLE CC_OPEN_BULK
Livestock	CC_NON_POTABLE CC_PIECE_GOODS CC_WEIRD
Mail	CC_MAIL
Milk	CC_POTABLE CC_PIECE_GOODS CC_LIQUID_BULK CC_EXPRESS CC_REFRIGERATED
Nuclear fuel	CC_ARMOURED CC_WEIRD
Oil	CC_NON_POTABLE CC_LIQUID_BULK
Oxygen	CC_GAS_BULK
Paper	CC_NON_POTABLE CC_PIECE_GOODS CC_FLATBED
Passengers	CC_PASSENGERS
Pipe	CC_NON_POTABLE CC_PIECE_GOODS CC_FLATBED
Quicklime	CC_NON_POTABLE CC_PIECE_GOODS CC_COVERED_BULK CC_POWDER_BULK
Sand	CC_NON_POTABLE CC_OPEN_BULK CC_COVERED_BULK CC_POWDER_BULK
Scrap Metal	CC_NON_POTABLE CC_OPEN_BULK
Sodium Hydroxide	CC_NON_POTABLE CC_PIECE_GOODS CC_LIQUID_BULK
Steel	CC_NON_POTABLE CC_PIECE_GOODS CC_FLATBED
Sulphur	CC_NON_POTABLE CC_OPEN_BULK CC_COVERED_BULK
Timber	CC_NON_POTABLE CC_PIECE_GOODS CC_FLATBED
YETI Dudes (Workers)	CC_EXPRESS CC_WEIRD

Example Cargos - Details

Ammonia Example

Cargo description	Ammonia CABBAGE. Ammonia is strictly transported as liquid, but uses gas-type tankers, so CC_GAS_BULK is set.
Cargo classes	CC_NON_POTABLE CC_GAS_BULK
Example vehicles	Box Van (more permissive), Intermodal Container Vehicle, Open Cargo Vehicle (more permissive), Pressure Tanker

Beans Example

Cargo description	Beans CABBAGE
Cargo classes	CC_POTABLE CC_PIECE_GOODS CC_COVERED_BULK
Example vehicles	Box Van (less permissive), Box Van (more permissive), Covered Hopper, Food Grade Covered Hopper, Intermodal Container Vehicle, Open Cargo Vehicle (less permissive), Open Cargo Vehicle (more permissive)

Cement Example

Cargo description	Cement CABBAGE
Cargo classes	CC_NON_POTABLE CC_PIECE_GOODS CC_POWDER_BULK
Example vehicles	Box Van (less permissive), Box Van (more permissive), Intermodal Container Vehicle, Open Cargo Vehicle (less permissive), Open Cargo Vehicle (more permissive), Powder Tanker

Chlorine Example

Cargo description	Chlorine CABBAGE (note that non-food-grade is set).
Cargo classes	CC_NON_POTABLE CC_GAS_BULK
Example vehicles	Box Van (more permissive), Intermodal Container Vehicle, Open Cargo Vehicle (more permissive), Pressure Tanker

Coal Example

Cargo description	Coal CABBAGE
Cargo classes	CC_NON_POTABLE CC_OPEN_BULK
Example vehicles	Box Van (more permissive), Hopper, Intermodal Container Vehicle, Open Cargo Vehicle (less permissive), Open Cargo Vehicle (more permissive), Ore Dump Vehicle

Diamonds Example

Cargo description	Diamonds CABBAGE
Cargo classes	CC_NON_POTABLE CC_ARMOURED
Example vehicles	Armoured Van

Explosives Example

Cargo description	Explosives CABBAGE
Cargo classes	CC_NON_POTABLE CC_PIECE_GOODS CC_EXPRESS CC_ARMOURED
Example vehicles	Armoured Van, Box Van (less permissive), Box Van (more permissive), Intermodal Container Vehicle, Open Cargo Vehicle (less permissive), Open Cargo Vehicle (more permissive)

Fish Example

Cargo description	Fish CABBAGE
Cargo classes	CC_POTABLE CC_PIECE_GOODS CC_EXPRESS CC_REFRIGERATED
Example vehicles	Box Van (less permissive), Box Van (more permissive), Intermodal Container Vehicle, Open Cargo Vehicle (less permissive), Open Cargo Vehicle (more permissive), Refrigerated Vehicle

Flour Example

Cargo description	Flour CABBAGE
Cargo classes	CC_POTABLE CC_PIECE_GOODS CC_COVERED_BULK CC_POWDER_BULK
Example vehicles	Box Van (less permissive), Box Van (more permissive), Covered Hopper, Food Grade Covered Hopper, Intermodal Container Vehicle, Open Cargo Vehicle (less permissive), Open Cargo Vehicle (more permissive), Powder Tanker

Food Example

Cargo description	Food CABBAGE
Cargo classes	CC_POTABLE CC_PIECE_GOODS CC_LIQUID_BULK CC_EXPRESS CC_REFRIGERATED
Example vehicles	Box Van (less permissive), Box Van (more permissive), Food Tanker, Intermodal Container Vehicle, Open Cargo Vehicle (less permissive), Open Cargo Vehicle (more permissive), Refrigerated Vehicle, Tanker Vehicle (more permissive)

Goods Example

Cargo description	Goods CABBAGE
Cargo classes	CC_NON_POTABLE CC_PIECE_GOODS CC_FLATBED
Example vehicles	Box Van (less permissive), Box Van (more permissive), Flatbed Vehicle, Intermodal Container Vehicle, Open Cargo Vehicle (less permissive), Open Cargo Vehicle (more permissive)

Grain Example

Cargo description	Grain CABBAGE - different classes to base game grain, have to handle with label
Cargo classes	CC_POTABLE CC_PIECE_GOODS CC_COVERED_BULK
Example vehicles	Box Van (less permissive), Box Van (more permissive), Covered Hopper, Food Grade Covered Hopper, Intermodal Container Vehicle, Open Cargo Vehicle (less permissive), Open Cargo Vehicle (more permissive)

Iron Ore Example

Cargo description	Iron Ore CABBAGE
Cargo classes	CC_NON_POTABLE CC_OPEN_BULK
Example vehicles	Box Van (more permissive), Hopper, Intermodal Container Vehicle, Open Cargo Vehicle (less permissive), Open Cargo Vehicle (more permissive), Ore Dump Vehicle

Livestock Example

Cargo description	Livestock CABBAGE - piece goods for legacy base game reasons - use label LVST for accurate control. CC_WEIRD also set to flag that this cargo is non-standard and would be better handled on labels.
Cargo classes	CC_NON_POTABLE CC_PIECE_GOODS CC_WEIRD
Example vehicles	Box Van (more permissive), Flatbed Vehicle, Intermodal Container Vehicle, Open Cargo Vehicle (less permissive), Open Cargo Vehicle (more permissive)

Mail Example

Cargo description	Mail CABBAGE
Cargo classes	CC_MAIL
Example vehicles	Mail Van

Milk Example

Cargo description	Milk CABBAGE
Cargo classes	CC_POTABLE CC_PIECE_GOODS CC_LIQUID_BULK CC_EXPRESS CC_REFRIGERATED
Example vehicles	Box Van (less permissive), Box Van (more permissive), Food Tanker, Intermodal Container Vehicle, Open Cargo Vehicle (less permissive), Open Cargo Vehicle (more permissive), Refrigerated Vehicle, Tanker Vehicle (more permissive)

Nuclear fuel Example

Cargo description	Nuclear fuel, typically transported as high-risk cargo in suitable shielded containers. Sets CC_WEIRD to indicate that dedicated vehicles are preferred, handling the cargo directly by label. Sets CC_ARMOURED as fallback for GRFS that do not offer the label or CC_WEIRD. CABBAGE - RUKTS NUKF doesn't actually set this class, because it predates the idea!
Cargo classes	CC_ARMOURED CC_WEIRD
Example vehicles	Armoured Van, Flatbed Vehicle, Intermodal Container Vehicle, Open Cargo Vehicle (less permissive), Open Cargo Vehicle (more permissive)

Oil Example

Cargo description	Oil CABBAGE
Cargo classes	CC_NON_POTABLE CC_LIQUID_BULK
Example vehicles	Box Van (more permissive), Intermodal Container Vehicle, Open Cargo Vehicle (more permissive), Tanker Vehicle (less permissive), Tanker Vehicle (more permissive)

Oxygen Example

Cargo description	Oxygen CABBAGE.
Cargo classes	CC_GAS_BULK
Example vehicles	Box Van (more permissive), Intermodal Container Vehicle, Open Cargo Vehicle (more permissive), Pressure Tanker

Paper Example

Cargo description	Paper CABBAGE
Cargo classes	CC_NON_POTABLE CC_PIECE_GOODS CC_FLATBED
Example vehicles	Box Van (less permissive), Box Van (more permissive), Flatbed Vehicle, Intermodal Container Vehicle, Open Cargo Vehicle (less permissive), Open Cargo Vehicle (more permissive)

Passengers Example

Cargo description	Passengers CABBAGE
Cargo classes	CC_PASSENGERS
Example vehicles	Passenger Vehicle

Pipe Example

Cargo description	Pipe CABBAGE
Cargo classes	CC_NON_POTABLE CC_PIECE_GOODS CC_FLATBED
Example vehicles	Box Van (less permissive), Box Van (more permissive), Flatbed Vehicle, Intermodal Container Vehicle, Open Cargo Vehicle (less permissive), Open Cargo Vehicle (more permissive)

Quicklime Example

Cargo description	Quicklime CABBAGE
Cargo classes	CC_NON_POTABLE CC_PIECE_GOODS CC_COVERED_BULK CC_POWDER_BULK
Example vehicles	Box Van (less permissive), Box Van (more permissive), Covered Hopper, Industrial Covered Hopper, Intermodal Container Vehicle, Open Cargo Vehicle (less permissive), Open Cargo Vehicle (more permissive), Powder Tanker

Sand Example

Cargo description	Sand CABBAGE
Cargo classes	CC_NON_POTABLE CC_OPEN_BULK CC_COVERED_BULK CC_POWDER_BULK
Example vehicles	Box Van (more permissive), Covered Hopper, Industrial Covered Hopper, Hopper, Intermodal Container Vehicle, Open Cargo Vehicle (less permissive), Open Cargo Vehicle (more permissive), Ore Dump Vehicle, Powder Tanker

Scrap Metal Example

Cargo description	Scrap Metal CABBAGE
Cargo classes	CC_NON_POTABLE CC_OPEN_BULK
Example vehicles	Box Van (more permissive), Hopper, Intermodal Container Vehicle, Open Cargo Vehicle (less permissive), Open Cargo Vehicle (more permissive), Ore Dump Vehicle

Sodium Hydroxide Example

Cargo description	Sodium Hydroxide CABBAGE
Cargo classes	CC_NON_POTABLE CC_PIECE_GOODS CC_LIQUID_BULK
Example vehicles	Box Van (less permissive), Box Van (more permissive), Intermodal Container Vehicle, Open Cargo Vehicle (less permissive), Open Cargo Vehicle (more permissive), Tanker Vehicle (less permissive), Tanker Vehicle (more permissive)

Steel Example

Cargo description	Steel CABBAGE
Cargo classes	CC_NON_POTABLE CC_PIECE_GOODS CC_FLATBED
Example vehicles	Box Van (less permissive), Box Van (more permissive), Flatbed Vehicle, Intermodal Container Vehicle, Open Cargo Vehicle (less permissive), Open Cargo Vehicle (more permissive)

Sulphur Example

Cargo description	Sulphur CABBAGE
Cargo classes	CC_NON_POTABLE CC_OPEN_BULK CC_COVERED_BULK
Example vehicles	Box Van (more permissive), Covered Hopper, Industrial Covered Hopper, Hopper, Intermodal Container Vehicle, Open Cargo Vehicle (less permissive), Open Cargo Vehicle (more permissive), Ore Dump Vehicle

Timber Example

Cargo description	Timber CABBAGE
Cargo classes	CC_NON_POTABLE CC_PIECE_GOODS CC_FLATBED
Example vehicles	Box Van (less permissive), Box Van (more permissive), Flatbed Vehicle, Intermodal Container Vehicle, Open Cargo Vehicle (less permissive), Open Cargo Vehicle (more permissive)

YETI Dudes (Workers) Example

Cargo description	Oversized 'workers' cargo from the YETI industry GRF
Cargo classes	CC_EXPRESS CC_WEIRD
Example vehicles	Box Van (more permissive), Flatbed Vehicle, Intermodal Container Vehicle, Open Cargo Vehicle (less permissive), Open Cargo Vehicle (more permissive), Refrigerated Vehicle

FRAX Cargo Class Scheme