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...")
 
(swap to correct variable for example's arg)
 
(3 intermediate revisions by one other user not shown)
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
Line 38: Line 42:
  
 
   local sphere = trigger.misc.getZone('trainingAirbase')
 
   local sphere = trigger.misc.getZone('trainingAirbase')
   sphere.point.y = land.getHeight({x = spehere.point.x, y = sphere.point.z})
+
   sphere.point.y = land.getHeight({x = sphere.point.x, y = sphere.point.z})
 
   local volS = {
 
   local volS = {
 
     id = world.VolumeType.SPHERE,
 
     id = world.VolumeType.SPHERE,
Line 46: Line 50:
 
     }
 
     }
 
   }
 
   }
   world.removeJunk(sphere)
+
   world.removeJunk(volS)
  
  

Latest revision as of 16:14, 9 June 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 = sphere.point.x, y = sphere.point.z})
 local volS = {
   id = world.VolumeType.SPHERE,
   params = {
     point = sphere.point,
     radius = sphere.radius
   }
 }
 world.removeJunk(volS)
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.