Revision as of 13:37, 19 July 2016

Part of:
ALiVE Military
Requirements:	Synced
Military AI Commander

How It Works

The Battlefield Logistics System is responsible for maintaining operational effectiveness of all units in the Theatre of Operations, delivering resupplies and Battle Casualty Replacements to the front line. BCRs require a suitable objective held by friendly forces where they will muster before moving to join front line units. The AI Commander requests BCRs when Combat Effectiveness of existing units falls below acceptable levels. The Logistics Commander (LOGCOM) assesses the tactical situation and determines the best location to bring in BCRs and then dispatches a convoy with the required troops and vehicles. Replacements may come in by Air or Land depending on the location and availability of landing sites and the type of replacements requested. Large airfields have a higher capacity to deliver logistics than small patrol bases.

Usage: Place a Military Logistics module and Synch (F5) it to an OPCOM module to enable it to request reinforcements and supplies. Only sync one Log module to each OPCOM.

Reinforcement Type

Dynamic - LOGCOM chooses the best insertion point from available friendly held objectives. High Priority objectives such as airfields and military bases with heli pads are preferred. If there are no suitable locations, LOGCOM will look for low priority military establishments or marine civilian locations (sea ports). These have a significantly lower logistics capacity than major military bases and resupply will take longer. Location start is the closest held objective in "reserve". The state of the objective is key, you won't get reinforcement start there if the objective is under attack etc.

Fixed - Static selection of logistics insertion point. LOGCOM will find the closest High Priority Military Objective to the location of the Logistics module on the map. This must be held by Friendly Forces. If the location is lost, Logistics will cease to function until the objective is recaptured. The objective must be under side control and in "reserve".

• Tip: use Military Placement (Custom Objectives) set to very high priority (e.g. 999) to set a custom fixed insertion point.

Force Pool

Dynamic - availability of replacement forces is dependent on the number, type and size of objectives held by friendly forces. Capturing more objectives will increase the size of the pool. For example, this may be used in a Counter Insurgency scenario where insurgent forces are living off the land.

Fixed - a fixed count of available reinforcement groups. When they run out, no more replacements will come although this can be set to infinite for never ending battles.

Allowed Types - Toggle options to allow or deny logistics requests for each group types

Air Transport Assets - restricts the available air transport assets to the Side or Faction. If Faction is selected and the AI Commander's faction does not have any air units, then Logistics can only be delivered by ground convoy (useful if you want to disable the default fall back behaviour to vanilla transport helis in scenarios where helis must not be used.)

Frequency

The frequency of reinforcement requests can be set in the Military AI Commander module (Constant, Blocked or Seldom). Roughly this equates to OPCOM requesting reinforcements when it reaches 90% (a constant trickle), 75% (large blocks of reinforcements) or 50% (occasional but very large groups or replacements) of it's starting state.

Editor Notes

You can adjust the ALIVE_globalForcePool during runtime with a script. See the [Snippets Section] for an example.

APIs and Test Scripts

To test a standard logcom request:  execVM "\x\alive\addons\mil_logistics\tests\test_ML.sqf"
 
To test a airdrop logcom request:  execVM "\x\alive\addons\mil_logistics\tests\test_ML_AIRDROP.sqf"
 
To test a heli insert logcom request:  execVM "\x\alive\addons\mil_logistics\tests\test_ML_HELI_INSERT.sqf"

Dev Notes

Until BIS gives us a transport plane, players will see BCR's being parachuted in if they are near the insertion point. This is to simulate a strategic airlift and is better than units popping out of nowhere. It may seem a little odd if large vehicles are parachuted but just close your eyes and move along.

Technically speaking, Military Logistics provide replacements and not reinforcements. The AI Commander will only request replacements for units that have been destroyed since mission start. If the AI Commander starts with zero units, it will never request replacements because as far as it's concerned it will never lose any. If you set up a mission this way, the Player can still call in reinforcements using the Player Combat Logistics module.