Server guide

Loot and economy

Rotor blades, the Mosquito drive belt, model keys, spray cans and ammunition containers are ordinary Central Economy loot. They come from two files shipped in the mod's release folder. Without them, players can't find replacement parts or ammunition.

Installing the loot files

Register them as their own mission folder, as described in Server setup, step 3: put types_custom_items.xml and cfgspawnabletypes_custom_items.xml in mpmissions/<mission>/rotorcraft/ and add the one <ce folder="rotorcraft"> line to cfgeconomycore.xml.

You can merge the entries into db/types.xml and cfgspawnabletypes.xml instead. Do one or the other, never both.

About 15 seconds after mission start, the log shows [RotorCraft] Loot entries OK or [RotorCraft] Loot entries missing for: .... These files only create loot; they don't attach anything to aircraft.

Keep the blade loot even if you don't require blades to start. A destroyed rotor can only be fixed with a matching blade set, so without blade loot a destroyed rotor means a wrecked aircraft.

Default counts

All items use a four-hour lifetime. Items carried by players or stored count towards the totals, which keeps spares scarce. The one exception is the Chinook blade set, which only counts while it's lying in the world.

Parts and keys

Named blade sets: `RotorCraft_RotorBlades_Mosquito`, `_MH6`, `_Gazelle`, `_BlackHawk`	Nominal 3, min 1 each. Military and Industrial.
`RotorCraft_RotorBlades_Chinook`	Nominal 2, min 1. Military and Industrial.
`RotorCraft_DriveBelt`	Nominal 6, min 2. Military and Industrial.
`RotorCraft_Key_Mosquito`, `RotorCraft_Key_MH6`	Nominal 3, min 1 each. Military and Industrial.
`RotorCraft_Key_AH6`	Nominal 1, min 0. Military only.
`RotorCraft_RotorBlades` (universal)	Nominal 0, min 0: off.
`RotorCraft_AircraftKey` (old ignition key)	Nominal 0, min 0: off.

Blade sets, the belt and spray cans spawn with 0 to 20% damage.

Ammunition

`RotorCraft_GunAmmoCan` (AH-6 M134 drum)	Nominal 4, min 2. Military, Tier3.
`RotorCraft_GrenadeCanister` (AH-6 40 mm)	Nominal 3, min 1. Military, Tier3.
`RotorCraft_DoorGunAmmoCan` (Black Hawk)	Nominal 4, min 2. Military, Tier3.
`RotorCraft_CannonAmmoBox` (Gazelle 20 mm)	Nominal 2, min 1. Military, Tier4.
`RotorCraft_AmmoBox_20mm_20Rnd`	Nominal 2, min 1. Military, Tier4.
`RotorCraft_Ammo_20mm`	Nominal 1, min 0, 25 to 50 rounds. Military, Tier4.

Ammunition containers spawn empty. The .308 and 40 mm HE rounds they take are vanilla loot.

Spray cans

Ten cans, one per finish: RotorCraft_SprayCan_Stock, _Olive, _Tan, _Grey, _Black, _White, _Woodland, _Desert, _Urban and _Winter. Each is nominal 2, min 1, Military and Industrial. They spawn 50 to 100% full; a full can paints two aircraft. Set a can's nominal to 0 to turn that finish off.

Where items spawn

The usage tags (Military, Industrial) and tier values in the types file decide which of your map's loot points can hold each item. The map's own loot points decide where that actually is.

Common changes

More or fewer spares: change nominal and min for the item.
Universal blades only: set "partsUniversalBlades": 1 in RotorCraft_Aircraft.json, set the universal set to nominal 3 / min 1, and set each named set to 0 / 0. The setting doesn't edit the economy files for you.
No drive belts: the belt only matters if you set "partsBeltRequired": 1. You can leave its loot as is either way.

Restart the server after editing loot files.

Aircraft in the economy

Aircraft themselves are not loot. They are placed by RotorCraft_Spawns.json (see Aircraft spawns) or by Central Economy vehicle events if you set those up. You don't need aircraft types.xml entries for the mod's own spawning. If you add them, the shipped examples use nominal and min 0, lifetime 3888000 (45 days), restock 0 and count only on the map.

Healthy aircraft renew their own 45-day lifetime every 10 minutes, so they don't vanish from simple inactivity. Ruined aircraft use wreckLifetime (default 1800 seconds) from RotorCraft_Damage.json.

Something missing or wrong? Ask in the Discord.