Modding tutorial

Most of the settings for the campaign are in the game/db.py file. There's lots of comments and you should really read them before changing anything.

Change default load out for the aircraft

Find variable PLANE_PAYLOAD_OVERRIDES and add/change a section for the aircraft. Syntax goes as follows:

`AircraftIdentifier`: {
    "Category": "PayloadName",
},

where:

• AircraftIdentifier: identifier of aircraft (the same that is used troughout the file)
• "Category": (in double quotes) is one of the tasks: CAS, CAP, Intercept, Escort or "*"
• "PayloadName": payload as found in resources/payloads/UNIT_TYPE.lua file. Sometimes this will match payload names in the mission editor, sometimes it doesn't. You can find exact name of the payloads under resources/payloads folder in a lua file named by aircraft.

Change default livery for the aircraft

Find PLANE_LIVERY_OVERRIDES and add a section to that. Syntax as follows:

`Identifier`: "LiveryName",

Identifier is aircraft identifier (as used troughout the file) and "LiveryName" (with double quotes) is livery name as found in mission editor.

Add a unit to the campaign

1. First of all, find out the correct identifier for the unit by scooping trough pydcs database:

• https://github.com/pydcs/dcs/blob/master/dcs/planes.py - for planes
• https://github.com/pydcs/dcs/blob/master/dcs/helicopters.py - for helicopters
• https://github.com/pydcs/dcs/blob/master/dcs/vehicles.py - for vehicles (this include all of the ground vehicles)

2. Add it to the PRICES variable with price of your choice (it also prioritizes unit commissions to the enemy)

3. Add it to the appropriate category for UNIT_BY_TASK. Aircraft should be applicable for the following tasks based on UNIT_BY_TASK categories:

Aircraft:

• CAP - should be applicable for CAP, Intercept and Escort (meaning that you can select the aircraft in the editor and find those tasks in the dropdown Main task menu)
• CAS - CAS and AntiShipStrike
• Transport - the same, Transport
• AWACS - the same, AWACS
• Embarking - infantry transport aircraft (task Transport)

Ground units:

• PinpointStrike - could be any ground vehicle
• AirDefense - Anti Aircraft units
• Reconnaissance - any ground vehicle
• Nothing - infantry

Ships:

• Carriage - aircraft carriers. Only first one for the country will be used
• CargoTransportation - transport ships

4. Put it in the appropriate UNIT_BY_COUNTRY list. This only affects the campaign, if the unit is not available for the country in the editor putting it here will still won't work.

5. Generate a mission with the aircraft and verify that correct load out is loaded for it. If it's not - use Change default load out for the aircraft section of this guide to fix that.

6. Delete save file to restart the campaign. Aircraft should be fully integrated into the campaign now.