Ozdeadmeat: BuildRoadRoute – created via PowerShell script (2025-11-11T21:12:41Z)

2025-11-11T10:12:42Z

BuildRoadRoute – created via PowerShell script (2025-11-11T21:12:41Z)

New page

{{Template:FunctionInfo|fName= BuildRoadRoute|fDescription= Constructs a road-based route between two points by finding the closest road points and generating waypoints along the path. If the initial or destination points are not on roads, it projects them to the nearest road segment. The function returns a list of waypoints spaced at a given distance, with optional debug visualization.|parentFile= cmm.spawnFunctions.lua|syntax= CMM.BuildRoadRoute(InitVec3 <TBL>, DestVec3 <TBL>, distance <number>, debug <boolean>)|return= table or nil|returnDesc= returns a table of waypoints, each containing x, y, z coordinates; returns nil if input validation fails.|example= CMM.BuildRoadRoute({x=100,y=200,z=300},{x=500,y=600,z=700},3000,true)|exampleDesc= Builds a route from (100,200,300) to (500,600,700) with 3000-unit spacing and enables debug visualization, showing both the path and waypoints on the map.|related= |note= -- TODO BuildRoadRoute is in progress. If Init and Dest are not on roads it needs to add those points as offroad points at the start and end of the route|envType= CMM|par1= table InitVec3|reqType1= table|reqName1= InitVec3|desc1= {x <number>, y <number>, z <number>} – starting position as a vec3 table; if z is nil, an error is thrown.|par2= table DestVec3|reqType2= table|reqName2= DestVec3|desc2= {x <number>, y <number>, z <number>} – destination position as a vec3 table; if z is nil, an error is thrown.|par3= number distance|reqType3= number|reqName3= distance|desc3= distance in units between waypoints (defaults to 3000 if not specified).|par4= boolean debug|reqType4= boolean|reqName4= debug|desc4= if true, visualizes the route and waypoints using red and black circles on the map.}}

BuildRoadRoute - Revision history

Ozdeadmeat: BuildRoadRoute – created via PowerShell script (2025-11-11T21:12:41Z)