Difference between revisions of "CQB"

From ALiVE Wiki
Jump to: navigation, search
 
(37 intermediate revisions by 4 users not shown)
Line 1: Line 1:
[[File:Icon_sys_rwg.png|50px]]
+
{| class="wikitable"
[[ALiVE Military|ALiVE Military]]
+
! style="text-align:left;" scope="row" colspan="2"|Part of:
 +
|-
 +
| scope="row" colspan="2" |{{Partof_Military}}
 +
|-
 +
! style="text-align:left;"|Optional
 +
!Synced
 +
|-
 +
|{{Module_MilPlacement}}
 +
|Optional
 +
|-
 +
|{{Module_MilCivPlacement}}
 +
|Optional
 +
|-
 +
|}
  
 +
 +
{{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!
 +
 
 +
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
  
You can also just place the module without  syncing it to anything and all the towns on map will be populated with enemies!
+
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.
  
Note you only need one CQB module as it autodetects the dominant faction in towns.
 
  
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.
+
'''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.
  
'''CQB Locations Parameter'''
+
''AI Amount'' - set the max size of each spawned CQB group
  
  
''Complete Map'' - this will spawn units over the entire map
+
'''Placement Parameters'''
  
 +
''Static'' - will always spawn units from the faction specified in the module
  
''Towns Only'' - this will spawn units in areas on the map that ALiVE detects as a village\town/city
+
''Dominant'' - will spawn units from the dominant faction in the area
  
 +
''Factions'' - Enter the faction to be spawned in ''Static'' mode.
  
If the CQB module is synced to a placement module it will limit the spawning of CQB units to the military/civilian installations recognised by that module - this overrides the "Complete Map\Towns Only" setting
 
  
 +
'''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).
  
'''Density Parameter (1st one)'''
+
==Custom Unit Blacklists==
  
This is the percentage of occupied houses overall - note that this does NOT scale per client as was the option in MSO for A2
+
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''
  
 +
<syntaxhighlight lang="php">
 +
ALiVE_MIL_CQB_CUSTOM_UNITBLACKLIST = ["unitType_1","unitType_2","unitType_3"];
 +
</syntaxhighlight>
  
'''Density Parameter (2nd one)'''
 
  
This adds houses with a minimum distance of x metres to each other, resulting in a "grid" of cqb positions
+
[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>
  
'''Placement'''
 
  
Static will always spawn units from the faction specified in the module
+
[[Category:ALiVE Modules]] [[Category:War Room]]
Dominant spawns units from the dominant faction at the time of spawn
+

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"];