{"name":"landAt","operator":null,"title":"landAt","type":"command","url":"https://community.bistudio.com/wiki/landAt","revid":378376,"updated":"2026-04-03T17:00:56Z","groups":["Unit Control","Roads and Airports"],"status":"ok","replaced_by":[],"games":[{"game":"arma1","name":"Armed Assault","version":"1.08"},{"game":"arma2","name":"Arma 2","version":"1.00"},{"game":"arma2oa","name":"Arma 2: Operation Arrowhead","version":"1.50"},{"game":"tkoh","name":"Take On Helicopters","version":"1.00"},{"game":"arma3","name":"Arma 3","version":"0.50"}],"since":{"game":"arma1","name":"Armed Assault","version":"1.08"},"arma3_since":"0.50","branch":null,"locality":{"argument":"local","effect":"global","server_exec":false},"exec":null,"description":"Order an AI airplane to land at a given airport. **ID** is the number to identify which map airport you want the airplane to land at. See Arma: Airport IDs for more information. See also land.\n\n> [!NOTE]\n> **Arma 3:** - Arma 3 v1.68 it is possible to also make the airplane land at a dynamic airport object (e.g. aircraft carrier, makeshift runway...) – see #Example 2\n> - Arma 3 v2.18 it is also possible to make a helicopter land at a specific helipad.\n\n> [!NOTE]\n> Since Arma 3 v2.20 landAt command has been extended. Helicopter can now be landed not only on a helipad but also at arbitrary position, provided that it is empty and can accomodate the helicopter. In \"Land\" landing mode the helicopter lands permanently, while in \"GetIn\" and \"GetOut\" landing mode the helicopter performs a short touch down before going to the next waypoint. In order to make helicopter wait, the 'waitTime' param can be used. Landing mode \"None\" cancels both, the landing in progress and waiting in progress.\n>  Waiting time is available with landAt getter variant. When helicopter is landing, the time shown is the set time for wating, however when helicopter is landed, this time start counting down to 0, after which helicopter will take off if it has a waypoint to go to. The AI pilot state can be monitored with getUnitState command. The helicopter has to be local to the machine executing the command. VTOL waiting time is not supported","syntaxes":[{"syntax":"plane landAt ID","since":null,"effect":null,"exec":null,"params":[{"name":"plane","type":"Object","optional":false,"default":null,"description":"a plane","types":["Object"],"since":null,"text":"plane: Object - a plane"},{"name":"ID","type":"Number","optional":false,"default":null,"description":"Airport ID","types":["Number"],"since":null,"text":"ID: Number - Airport ID"}],"returns":{"type":"Nothing","types":["Nothing"],"description":null,"text":"Nothing"},"form":"binary","operator":null,"left":{"text":"plane","types":["Object"]},"right":{"text":"ID","types":["Number"]}},{"syntax":"plane landAt airportObject","since":"arma3 1.68","effect":null,"exec":null,"params":[{"name":"plane","type":"Object","optional":false,"default":null,"description":null,"types":["Object"],"since":null,"text":"plane: Object"},{"name":"airportObject","type":"Object","optional":false,"default":null,"description":null,"types":["Object"],"since":null,"text":"airportObject: Object"}],"returns":{"type":"Nothing","types":["Nothing"],"description":null,"text":"Nothing"},"form":"binary","operator":null,"left":{"text":"plane","types":["Object"]},"right":{"text":"airportObject","types":["Object"]}},{"syntax":"heli landAt [position, mode, waitTime, putOnSurface]","since":"arma3 2.18","effect":null,"exec":null,"params":[{"name":"heli","type":"Object","optional":false,"default":null,"description":"Helicopter/VTOL aircraft","types":["Object"],"since":null,"text":"heli: Object - Helicopter/VTOL aircraft"},{"name":"position","type":"Object or Arma 3 v2.20 PositionWorld","optional":false,"default":null,"description":"a helipad object of helipad type (can be an invisible helipad) or PositionWorld to land at.","types":["Object","PositionWorld"],"since":null,"text":"position: Object or Arma 3 v2.20 PositionWorld - a helipad object of helipad type (can be an invisible helipad) or PositionWorld to land at."},{"name":"mode","type":"String","optional":false,"default":null,"description":"one of \"None\", \"Get In\", \"Get Out\", \"Land\" and since Arma 3 v2.20 also \"GetIn\", \"GetOut\".","types":["String"],"since":null,"text":"mode: String - one of \"None\", \"Get In\", \"Get Out\", \"Land\" and since Arma 3 v2.20 also \"GetIn\", \"GetOut\"."},{"name":"waitTime","type":"Number","optional":true,"default":null,"description":"(Helicopter type only) time to wait after touch down in \"GetIn\"/\"GetOut\" mode before taking off to the next waypoint. Default: -1.","types":["Number"],"since":"arma3 2.20","text":"waitTime: Number - (Optional) (Helicopter type only) time to wait after touch down in \"GetIn\"/\"GetOut\" mode before taking off to the next waypoint. Default: -1."},{"name":"putOnSurface","type":"Boolean","optional":true,"default":null,"description":"when true, the given land position will be adjusted to the nearest surface underneath. Default: false.","types":["Boolean"],"since":"arma3 2.20","text":"putOnSurface: Boolean - (Optional) when true, the given land position will be adjusted to the nearest surface underneath. Default: false."}],"returns":{"type":"Boolean","types":["Boolean"],"description":"Returns true if landing command was processed successfully, false if failed.","text":"Boolean - Returns true if landing command was processed successfully, false if failed."},"form":"binary","operator":null,"left":{"text":"heli","types":["Object"]},"right":{"text":"[position, mode, waitTime, putOnSurface]","types":["Array"]}},{"syntax":"landAt heli","since":"arma3 2.20","effect":null,"exec":null,"params":[{"name":"heli","type":"Object","optional":false,"default":null,"description":"Helicopter/VTOL aircraft","types":["Object"],"since":null,"text":"heli: Object - Helicopter/VTOL aircraft"}],"returns":{"type":"Array with [landMode, landResult, landPosition, waitTime, autopilotState]","types":["Array"],"description":"landMode: String - one of the following: \"None\", \"Land\", \"GetIn\", \"GetOut\" or \"\". - landResult: String - one of the following: \"Found\", \"NotFound\", \"NotReady\" or \"\". - landPosition: PositionWorld - land position or [0,0,0]. - waitTime: Number - (Helicopter type only) before heli is landed - wait time set for \"GetIn\"/\"GetOut\" mode, after heli is landed - remaining time before take off to the next waypoint or -1. - autopilotState: String - one of the following: \"FAR\", \"BRAKE\", \"NEAR\", \"ALIGN\", \"REACHED\", \"LOITER\", \"FOLLOW\" or \"\".","text":"Array with [landMode, landResult, landPosition, waitTime, autopilotState]\n- landMode: String - one of the following: \"None\", \"Land\", \"GetIn\", \"GetOut\" or \"\".\n- landResult: String - one of the following: \"Found\", \"NotFound\", \"NotReady\" or \"\".\n- landPosition: PositionWorld - land position or [0,0,0].\n- waitTime: Number - (Helicopter type only) before heli is landed - wait time set for \"GetIn\"/\"GetOut\" mode, after heli is landed - remaining time before take off to the next waypoint or -1.\n- autopilotState: String - one of the following: \"FAR\", \"BRAKE\", \"NEAR\", \"ALIGN\", \"REACHED\", \"LOITER\", \"FOLLOW\" or \"\"."},"form":"unary","operator":null,"left":null,"right":{"text":"heli","types":["Object"]}}],"examples":[{"text":"```sqf\n_plane1 landAt 1;\n```","code":["_plane1 landAt 1;"]},{"text":"```sqf\n_dynamicAirport1 = \"DynamicAirport_01_F\" createVehicle position player;\n_plane1 landAt _dynamicAirport1;\n```","code":["_dynamicAirport1 = \"DynamicAirport_01_F\" createVehicle position player;\n_plane1 landAt _dynamicAirport1;"]},{"text":"```sqf\n_hpad = \"Land_HelipadEmpty_F\" createVehicle [0,0,0];\n_hpad setPosASL _pos;\nheli landAt [_hpad, \"LAND\"];\n```","code":["_hpad = \"Land_HelipadEmpty_F\" createVehicle [0,0,0];\n_hpad setPosASL _pos;\nheli landAt [_hpad, \"LAND\"];"]},{"text":"```sqf\nheli landAt [getPosWorld player vectorAdd [10,10,0], \"GetIn\", 30];\n```","code":["heli landAt [getPosWorld player vectorAdd [10,10,0], \"GetIn\", 30];"]}],"multiplayer":null,"problems":null,"aliases":[],"see_also":["Arma: Airport IDs","land","setAirportSide","assignToAirport","allAirports"],"notes":[],"categories":["ArmA: Armed Assault: New Scripting Commands","ArmA: Armed Assault: Scripting Commands","Arma 2: Operation Arrowhead: Scripting Commands","Arma 2: Scripting Commands","Arma 3: Scripting Commands","Command Group: Roads and Airports","Command Group: Unit Control","Introduced with Armed Assault version 1.08","Scripting Commands","Scripting Commands: Global Effect","Take On Helicopters: Scripting Commands"]}