Per-Contract Overrides

A Per-Contract override, named this way to avoid confusion with the vanilla BT ContractOverride (contract json), is an MC setting override file for individual contracts. This allows you to override specific MC settings for special procedural or flashpoint contracts.

The per-contrat overrides are stored in MissionControl/config/Contracts and MissionControl/config/Flashpoints. These folders are effectively the same and are both supported purely for an organisational reason. You could just have the Contracts folder if that better fits your needs.

If specific property is not defined, the usual settings will take effect.

Settings Breakdown

NOTE: Filename of the per-contract override is very important. It must match the ID of the ContactOverride (contract json) you wish to override. For the example below the filename would be My_Contract_ID_Example.json to override the contract with ID My_Contract_ID_Example.

{
"ID": "My_Contract_ID_Example",
"RandomSpawns": {
"Enable": true
},
"HotDropProtection": {
"Enable": true
},
"AdditionalLances": {
"Enable": true,
"EnemyLanceCount": 2,
"EnemyLances": [
"Damaged_Assault_Battle_Lance",
"lancedef_vehicle_d10_dynamic_convoy"
],
"AllyLanceCount": 1,
"AllyLances": ["Generic_Light_Battle_Lance"]
},
"ExtendedLances": {
"Enable": true,
"TargetLanceSize": 6,
"EmployerLanceSize": 5,
"TargetAllyLanceSize": 5,
"EmployerAllyLanceSize": 5,
"HostileToAllLanceSize": 5,
"NeutralToAllLanceSize": 5
},
"ExtendedBoundaries": {
"Enable": true,
"IncreaseBoundarySizeByPercentage": 0.5
},
"DynamicWithdraw": {
"Enable": true
},
"AdditionalPlayerMechs": {
"Enable": true
}
}

General

PropertyRequired?ExampleDetails
IDOptionalMy_Contract_ID_ExampleMust be the same ID as the contract you want to override. The filename should also be the same name.
RandomSpawns/EnableOptionaltrue or falseOverride Random Spawns feature to be on or off on a contract.
HotDropProtection/EnableOptionaltrue or falseOverride Hot Drop Protection feature to be on or off on a contract.
Additional LancesOptionalSee Table Below-
Extended LancesOptionalSee Table Below-
Extended BoundariesOptionalSee Table Below-
DynamicWithdraw/EnableOptionaltrue or falseOverride Dynamic Withdraw feature to be on or off on a contract.
AdditionalPlayerMechs/EnableOptionaltrue or falseOverride Additional Player Mechs to be on or off on a contract. This is what allows Bigger Drops mod to work.

Additional Lances

PropertyRequired?ExampleDetails
EnableRequiredtrue or falseIf AL config is provided then Enable is required.
UseDialogueOptionaltrue or falseOverrides if Ally AL dialogue should appear
DialogueCastDefIdOptionalcastDef_DariusDefault, castDef_Commander, castDef_TeamPilot_Random_1Sets the CastDef of the speaker. Can be a real CastDef or MC Dynamic CastDef (see Dialogue System).
DialogueOptionalHello, this is what you'd see being spoken by the Ally AL lanceOverrides the actual dialogue spoken by the Ally AL lance
EnemyLanceCountOptional2Overrides the number of enemy/target AL lances that will spawn.
EnemyLancesOptional["Damaged_Assault_Battle_Lance",
"lancedef_vehicle_d10_dynamic_convoy"]
Manually specifies the exact MC lance or LanceDef you want to spawn for the enemy/target AL lances that spawn.
EnemyLanceObjectiveNamesOptional["Destroy Traitors Lance 1", "Destroy Traitors Lance 2"]Overrides the Enemy AL lance objective names. Taken on a first come basis.

If fewer names are provided then it will assign the custom names then return to the default names.
AllyLanceCountOptional1Overrides the number of ally/employer AL lances that will spawn.
AllyLancesOptional["Generic_Light_Battle_Lance"]Manually specifies the exact MC lance or LanceDef you want to spawn for the ally/employer AL lances that spawn.

Extended Lances

PropertyRequired?ExampleDetails
EnableRequiredtrue or falseIf EL config is provided then Enable is required.
TargetLanceSizeOptional6Overrides the number of enemy/target units in a lance.

DEPRECATION: Previously EnemyLanceSize. Still works but is deprecated.
EmployerLanceSizeOptional5Overrides the number of ally/employer units in a lance.

DEPRECATION: Previously AllyLanceSize. Still works but is deprecated.
TargetAllyLanceSizeOptional5Overrides the number of target ally units in a lance.
EmployerAllyLanceSizeOptional5Overrides the number of employer ally units in a lance.
HostileToAllLanceSizeOptional5Overrides the number of hostile to all units in a lance.
NeutralToAllLanceSizeOptional5Overrides the number of neutral to all units in a lance.

Extended Boundaries

PropertyRequired?ExampleDetails
EnableRequiredtrue or falseIf EB config is provided then Enable is required.
IncreaseBoundarySizeByPercentageOptional0.5Overrides the percentrage to increase the boundary size for this contract. Supports values 0 to 1.