{"name":"setWaypointPosition","title":"setWaypointPosition","type":"command","url":"https://community.bistudio.com/wiki/setWaypointPosition","revid":377573,"updated":"2026-01-02T06:56:26Z","groups":["Waypoints"],"status":"ok","games":{"ofpe":"1.00","arma1":"1.00","arma2":"1.00","arma2oa":"1.50","tkoh":"1.00","arma3":"0.50"},"since":"ofpe 1.00","arma3_since":"0.50","description":"Attempts to move given waypoint to a random position inside a circle with the given center and radius.\nThe waypoint will be placed similar to `\"NONE\"` attribute in setVehiclePosition, even if the radius is 0, which means it could still be off center. In order to force waypoint to the exact position, similar to `\"CAN_COLLIDE\"` attribute, use a negative radius (see Example 2).","syntaxes":[{"syntax":"waypoint setWaypointPosition [center, radius]","params":[{"name":"waypoint","type":"Waypoint","type_expr":"Waypoint"},{"name":"center","type":"Object or PositionAGL or PositionASL if radius is negative","type_expr":"Object | PositionAGL | PositionASL","text":"center: Object or PositionAGL or PositionASL if *radius* is negative"},{"name":"radius","type":"Number","description":"random placement radius in meters. Set it to -1 and convert center to PositionASL for the exact center placement","type_expr":"Number"}],"returns":{"type":"Nothing","type_expr":"Nothing"},"form":"binary","left":{"text":"waypoint"},"right":{"text":"[center, radius]"}}],"examples":[{"code":["[_grp, 2] setWaypointPosition [position player, 0];"]},{"text":"Exact placement using a negative *radius* and PositionASL:\n\n```sqf\n_wp setWaypointPosition [getPosASL player, -1];\n```","code":["_wp setWaypointPosition [getPosASL player, -1];"]}],"see_also":["waypointPosition","setWPPos","waypoints","deleteWaypoint","copyWaypoints","setCurrentWaypoint","setWaypointBehaviour","setWaypointCombatMode","setWaypointCompletionRadius","setWaypointDescription","setWaypointFormation","setWaypointHousePosition","setWaypointScript","setWaypointSpeed","setWaypointStatements","setWaypointTimeout","setWaypointType","setWaypointVisible","waypointAttachVehicle","waypointAttachedVehicle","setWaypointLoiterRadius","waypointLoiterRadius","addWaypoint","setWaypointLoiterType","waypointSpeed"],"notes":[{"user":"Killzone_Kid","date":"2018-11-14T22:52:00Z","text":"If you want AI to understand height of the waypoint, for example set waypoint at the top of Military Cargo Tower, use Example 2 with position in ASL format and -1 radius."}]}