Ozdeadmeat: FindNearbyClearPosition – created via PowerShell script (2025-11-11T21:12:36Z)

2025-11-11T10:12:37Z

FindNearbyClearPosition – created via PowerShell script (2025-11-11T21:12:36Z)

New page

{{Template:FunctionInfo|fName= FindNearbyClearPosition|fDescription= Finds a clear position within a specified radius and minimum spacing from existing objects, using random direction and distance sampling. It checks terrain surface type and height difference to ensure valid placement, returning a position vector or the original input if no suitable location is found.|parentFile= cmm.positionFunctions.lua|syntax= CMM.FindNearbyClearPosition(vec3 <TBL>, radius <number>, spacing <number>)|return= table|returnDesc= Returns a position table (vec3) with x, y, z coordinates of a valid clear location; if no valid location is found, returns the original input position.|example= CMM.FindNearbyClearPosition({x=100, y=50, z=10}, 150, 20)|exampleDesc= Searches for a clear position within 150 meters of the base location, ensuring at least 20 meters of clearance from all objects, returning a valid position or the original if none found.|related= |note= |envType= CMM|par1= table vec3|reqType1= table|reqName1= vec3|desc1= Position table with x, y, z coordinates representing the base position for searching clear space.|par2= number radius|reqType2= number|reqName2= radius|desc2= Maximum distance in meters from the base position to search for a valid location (defaults to 100 if not provided).|par3= number spacing|reqType3= number|reqName3= spacing|desc3= Minimum distance in meters from any object to ensure clear space (defaults to 10 if not provided or invalid).}}

FindNearbyClearPosition - Revision history

Ozdeadmeat: FindNearbyClearPosition – created via PowerShell script (2025-11-11T21:12:36Z)