Difference between revisions of "CQB"

From ALiVE Wiki
Jump to: navigation, search
 
(20 intermediate revisions by one user not shown)
Line 15: Line 15:
 
|}
 
|}
  
 +
 +
{{note}} CQB Density Settings of over 10% may cause very long load times, especially on large heavily urbanised maps with enterable buildings such as Altis!
 +
 +
==How It Works==
 
Based on the original Urban Ops enemy generator by Highhead, Ambient CQB automatically populates a built up area with dismounted infantry units when a player moves within range.  The groups occupy buildings, patrol the streets and react to enemy presence.  CQB  detects the dominant AI faction in the area (ignoring players) and spawns the appropriate units accordingly.
 
Based on the original Urban Ops enemy generator by Highhead, Ambient CQB automatically populates a built up area with dismounted infantry units when a player moves within range.  The groups occupy buildings, patrol the streets and react to enemy presence.  CQB  detects the dominant AI faction in the area (ignoring players) and spawns the appropriate units accordingly.
  
''Usage'':  Place one CQB module and select the preferred intensity.  Optionally, CQB can be synchronised (F5) to a Mil_MP or CIV_CO module.
 
  
For example, it is simple to quickly set up a scenario with a town populated by generic infantry by placing a Civ_CO module with a TAOR marker covering the town and synching a CQB module to it.
+
''Usage'':  Place one or more CQB modules and configure options as desired.  Optionally, CQB can be synchronised (F5) to a Mil_MP or Mil_CP module to define specific objectives and TAORs. 
 +
 
 +
 
 +
For example, it is simple to quickly set up a scenario with a town populated by generic infantry by placing a MCP module with a TAOR marker covering the town and synching a CQB module to it. You can also just place a single module without  syncing it to anything and all the towns on map will be populated with enemies!
  
You can also just place the module without  syncing it to anything and all the towns on map will be populated with enemies!
+
By default, CQB modules will autodetect the dominant faction in towns.  You can place multiple modules down and define factions explicitly if you want more control over what spawns.
  
Note you only need one CQB module as it autodetects the dominant faction in towns.
+
CQB AIs are not counted by Military Placement spawn limiters.  Adding a high percentage CQB module to an area already covered by a Placement Module could create a very large number of AI.  In this event, you can manually limit the number of AI that CQB creates at each spawn point using the Solo, Pair, Fire Team option.
  
Note 2: CQB AIs are not counted into any Placement Module numbers so adding a CQB module to an area with Placement Module AIs can potentially push the numbers too far.
 
  
Note 3: Strategic CQB units spawn in at (1.4 x Regular CQB spawn distance) and despawn at ?
+
==Parameters==
  
 +
'''Locations Parameter'''
  
 +
''Complete Map'' - Will spawn units over the entire map
  
'''CQB Locations Parameter'''
+
''Towns Only'' - Will spawn units in areas on the map that ALiVE detects as a village/town/city
  
 +
If the CQB module is synced to a Placement Module (MP/MCP) it will limit the spawning of CQB units to the military/civilian installations recognised by that module.  This overrides the "Complete Map\Towns Only" settings as well as any TAOR/Blacklists included in the module parameters.
  
''Complete Map'' - this will spawn units over the entire map
 
  
 +
'''Density Parameter'''
  
''Towns Only'' - this will spawn units in areas on the map that ALiVE detects as a village/town/city
+
''Probability'' - this is the percentage of total houses that will be occupied.  Note that this does NOT automatically scale per client.
  
 +
''Density'' - this adds more house locations with a minimum distance of X metres to each other, resulting in a tight "grid" of CQB positions.
  
If the CQB module is synced to a Placement Module (MP/MCP) it will limit the spawning of CQB units to the military/civilian installations recognised by that module.  This overrides the "Complete Map\Towns Only" settings.
+
''AI Amount'' - set the max size of each spawned CQB group
  
  
'''Density Parameter (1st one)'''
+
'''Placement Parameters'''
  
This is the percentage of occupied houses overall - note that this does NOT scale per client as was the option in MSO for A2
+
''Static'' - will always spawn units from the faction specified in the module
  
 +
''Dominant'' - will spawn units from the dominant faction in the area
  
'''Density Parameter (2nd one)'''
+
''Factions'' - Enter the faction to be spawned in ''Static'' mode.
  
This adds houses with a minimum distance of x metres to each other, resulting in a "grid" of cqb positions
 
  
 +
'''Static Weapons:''' sets the probability that static weapons will spawn (0 to disable; 0.5 for 50%; 2 or more will spawn that number of weapons on every available surface).
  
'''Placement'''
+
==Custom Unit Blacklists==
  
Static will always spawn units from the faction specified in the module
+
Advanced uses can customise the force compositions by blacklisting certain units, groups or vehicles.  For example, you can prevent CQB from spawning AA units.  To do so, add the following variable to the sys_Profile module init field, where ''type'' is the vehicleClass ''C_man_1''
Dominant spawns units from the dominant faction at the time of spawn
+
  
 +
<syntaxhighlight lang="php">
 +
ALiVE_MIL_CQB_CUSTOM_UNITBLACKLIST = ["unitType_1","unitType_2","unitType_3"];
 +
</syntaxhighlight>
  
'''Faction (1st one)'''
 
  
Factions entered here will spawn units at military structures
+
[Dev Branch Only] ''ALIVE_Building_Blacklist'' can be set by script to prevent CQB spawns in certain building types.  To find the building name enter ''typeOf nearestBuilding position player'' as a watch variable in the Debug Console and stand near the building.
  
 +
<syntaxhighlight lang="php">
 +
ALIVE_Building_Blacklist = ["some_archway","some_building_1","some_building_2"];
 +
</syntaxhighlight>
  
'''Faction (2nd one)'''
 
  
Factions entered here will spawn units at civilian structures
+
[[Category:ALiVE Modules]] [[Category:War Room]]

Latest revision as of 12:59, 30 October 2019

Part of:
Icon mil opcom.png ALiVE Military
Optional Synced
Module milplacement.png Military Placement (Mil Obj)
Optional
Icon civ CO.png Military Placement (Civ Obj)
Optional


Onebit note.png Note: CQB Density Settings of over 10% may cause very long load times, especially on large heavily urbanised maps with enterable buildings such as Altis!

How It Works

Based on the original Urban Ops enemy generator by Highhead, Ambient CQB automatically populates a built up area with dismounted infantry units when a player moves within range. The groups occupy buildings, patrol the streets and react to enemy presence. CQB detects the dominant AI faction in the area (ignoring players) and spawns the appropriate units accordingly.


Usage: Place one or more CQB modules and configure options as desired. Optionally, CQB can be synchronised (F5) to a Mil_MP or Mil_CP module to define specific objectives and TAORs.


For example, it is simple to quickly set up a scenario with a town populated by generic infantry by placing a MCP module with a TAOR marker covering the town and synching a CQB module to it. You can also just place a single module without syncing it to anything and all the towns on map will be populated with enemies!

By default, CQB modules will autodetect the dominant faction in towns. You can place multiple modules down and define factions explicitly if you want more control over what spawns.

CQB AIs are not counted by Military Placement spawn limiters. Adding a high percentage CQB module to an area already covered by a Placement Module could create a very large number of AI. In this event, you can manually limit the number of AI that CQB creates at each spawn point using the Solo, Pair, Fire Team option.


Parameters

Locations Parameter

Complete Map - Will spawn units over the entire map

Towns Only - Will spawn units in areas on the map that ALiVE detects as a village/town/city

If the CQB module is synced to a Placement Module (MP/MCP) it will limit the spawning of CQB units to the military/civilian installations recognised by that module. This overrides the "Complete Map\Towns Only" settings as well as any TAOR/Blacklists included in the module parameters.


Density Parameter

Probability - this is the percentage of total houses that will be occupied. Note that this does NOT automatically scale per client.

Density - this adds more house locations with a minimum distance of X metres to each other, resulting in a tight "grid" of CQB positions.

AI Amount - set the max size of each spawned CQB group


Placement Parameters

Static - will always spawn units from the faction specified in the module

Dominant - will spawn units from the dominant faction in the area

Factions - Enter the faction to be spawned in Static mode.


Static Weapons: sets the probability that static weapons will spawn (0 to disable; 0.5 for 50%; 2 or more will spawn that number of weapons on every available surface).

Custom Unit Blacklists

Advanced uses can customise the force compositions by blacklisting certain units, groups or vehicles. For example, you can prevent CQB from spawning AA units. To do so, add the following variable to the sys_Profile module init field, where type is the vehicleClass C_man_1

ALiVE_MIL_CQB_CUSTOM_UNITBLACKLIST = ["unitType_1","unitType_2","unitType_3"];


[Dev Branch Only] ALIVE_Building_Blacklist can be set by script to prevent CQB spawns in certain building types. To find the building name enter typeOf nearestBuilding position player as a watch variable in the Debug Console and stand near the building.

ALIVE_Building_Blacklist = ["some_archway","some_building_1","some_building_2"];