Difference between revisions of "DCS func removeJunk"

From DCS World Wiki - Hoggitworld.com
(Created page with "{{Template:dcs_funcs |fName= removeJunk |vNum= 2.8.4 |par1= world |par2= |par3= |par4= |desc= Searches the defined area passed to the function...")
 
Line 13: Line 13:
 
|par4=
 
|par4=
  
|desc= Searches the defined area passed to the function to remove craters, object wreckage and any other debris within the search volume. Will not remove wreckage of scenery objects.  
+
|desc= Searches the defined area passed to the function to remove craters, object wreckage, and any other debris within the search volume. Will not remove wreckage of scenery objects.  
 +
 
 +
See pages for the correct format of each volume type:
 +
{{listOfVolumes}}
  
 
|rtnType= number
 
|rtnType= number

Revision as of 23:40, 21 April 2023

Scripting Root

Envrioment: Mission Scripting
Function: removeJunk Added with: 2.8.4
Member Of: world
Syntax: number world.removeJunk(volume searchVolume )
Description: Searches the defined area passed to the function to remove craters, object wreckage, and any other debris within the search volume. Will not remove wreckage of scenery objects.

See pages for the correct format of each volume type: Volumes: segment, box, sphere, pyramid


Return Value: number
Return Example: 420
Examples: The following will remove wreckage, craters, and debris in the zone "trainingAirbase" where there surely will be wreckage, craters, and debris due to skill issues.
 local sphere = trigger.misc.getZone('trainingAirbase')
 sphere.point.y = land.getHeight({x = spehere.point.x, y = sphere.point.z})
 local volS = {
   id = world.VolumeType.SPHERE,
   params = {
     point = sphere.point,
     radius = sphere.radius
   }
 }
 world.removeJunk(sphere)
Related Functions: World Functions: addEventHandler, removeEventHandler, getPlayer, getAirbases, searchObjects, getMarkPanels, removeJunk
Notes: At the time of implementation the AI DO NOT react to craters being removed from an airbase by this function. They still wait the 1 hour after a crater was generated for it to be "repaired" and will resume using an airbase once all craters are repaired.