Server guide
Weapon settings
RotorCraft_Weapons.json controls the AH-6 minigun and grenade launcher, the Gazelle 20 mm cannon and the Black Hawk door guns. No other server setting or engine patch is needed for weapons.
The armed aircraft
RotorCraft_AH6 | M134 minigun and 40 mm HE launcher (pilot). Containers: RotorCraft_GunAmmoCan, RotorCraft_GrenadeCanister. |
RotorCraft_GazelleCannon | 20 mm cannon under the nose (pilot). Container: RotorCraft_CannonAmmoBox. |
RotorCraft_BlackHawkArmed | Two M240H door guns (gunner-window seats). Containers: two RotorCraft_DoorGunAmmoCan. |
The armed aircraft fly, repair and use settings like the MH-6, Gazelle and Black Hawk they're based on. Spawn and place them like any other aircraft (see Aircraft spawns). A fresh one gets its normal electrical parts but no ammunition containers.
The containers are native magazines. Players fill them with vanilla .308 (minigun drum and door gun cans), vanilla 40 mm HE (grenade canister) or the mod's 20 mm rounds (cannon box), then attach them in the aircraft's ENGINE inventory with the engine stopped. Ammunition in cargo never feeds the guns. For loot counts, see Loot and economy.
The settings file
The server writes RotorCraft_Weapons.json to the profile folder when an AH-6 or an ammo container first loads. The defaults:
"enabled": true | Master switch for every weapon family. |
"rate": 30 | Combined gun fire rate, 1 to 50 rounds per second. |
"damageScale": 1.0 | Gun damage, 0 to 10. 1 is vanilla .308 damage. Doesn't affect grenades. |
"spread": 0.003 | Gun spread as a half-angle in radians, 0 to 0.05. |
"grenadeRate": 2 | Maximum grenade launch rate, 0.1 to 5 per second. |
"gunCapacity": 500 | Gun container capacity, 1 to 750 rounds. |
"grenadeCapacity": 24 | Grenade canister capacity, 1 to 24. |
"gunEffectiveRange": 800 | Metres; where the gun sight turns from green to orange, 1 to 1200. |
"grenadeEffectiveRange": 350 | Same for grenades, 1 to 600. |
"consumeAmmo": true | false gives unlimited firing. |
Two more switches turn off a single weapon family under the master switch: doorGunsEnabled for the Black Hawk door guns and cannonEnabled for the Gazelle cannon.
What the settings do
"enabled": falsemakes every weapon safe, hides the sights and shows WEAPONS OFF in the weapon seats. The family switches do the same for just their weapon.- Capacities are sent to clients so the normal fill actions respect them. Lowering a limit keeps rounds already loaded but blocks further loading until the container drops below the new limit.
- Effective ranges only change where the sight changes colour. The maximum projectile path stays 1200 m for guns and 600 m for grenades.
"consumeAmmo": falsestill needs a loaded, non-ruined container attached; it just never takes rounds out. The HUD marks this mode. Handy for event servers.- Gun hits use vanilla .308 bullet damage and respect objects that can't be damaged. 40 mm HE always uses its own vanilla explosion.
Rules that aren't settings
- Only an awake, living player in a weapon seat can fire. The engine doesn't need to be running.
- The server checks the seat, the player's state and that arm is held before accepting each shot, and handles ammunition, fire rate and hits itself.
- The sight's prediction and the server's projectile simulation both ignore wind and air drag.
Editing
Stop the server, edit, save, restart. A restart is the only way to reload it. Missing fields keep their defaults and invalid values use the defaults. Malformed JSON logs [RCEWPN] and the server uses the defaults without overwriting your file.
Something missing or wrong? Ask in the Discord.