{"name":"BIS_fnc_planeAiEject","operator":null,"title":"BIS fnc planeAiEject","type":"function","url":"https://community.bistudio.com/wiki/BIS_fnc_planeAiEject","revid":376187,"updated":"2025-09-13T15:54:56Z","groups":["Aircraft Functionality"],"status":"ok","replaced_by":[],"games":[{"game":"arma3","name":"Arma 3","version":"1.70"}],"since":{"game":"arma3","name":"Arma 3","version":"1.70"},"arma3_since":"1.70","branch":null,"locality":{"argument":null,"effect":null,"server_exec":false},"exec":null,"description":"- This function is designed as part of set of functions to implement semi-authenthic ejection system on fixed wing aircrfat that have such functionality enabled/configured.\n- AI behaviour handler.","syntaxes":[{"syntax":"plane call BIS_fnc_planeAiEject","since":null,"effect":null,"exec":null,"params":[{"name":"plane","type":"Object","optional":false,"default":null,"description":"living vehicle with a pilot and with ejection systems set up in its config","types":["Object"],"since":null,"text":"plane: Object - living vehicle with a pilot and with ejection systems set up in its config"}],"returns":{"type":"Nothing if plane was invalid or no ejection was needed, otherwise Script Handle","types":["Nothing","Script Handle"],"description":"script handle of spawned BIS_fnc_planeEjection","text":"Nothing if plane was invalid or no ejection was needed, otherwise Script Handle - script handle of spawned BIS_fnc_planeEjection"}}],"examples":[{"text":"```sqf\n_myPlane call BIS_fnc_planeAiEject;\n```","code":["_myPlane call BIS_fnc_planeAiEject;"]}],"multiplayer":null,"problems":null,"aliases":[],"see_also":["BIS_fnc_planeEjection","BIS_fnc_planeEjectionFX","BIS_fnc_ejectionSeatRelease"],"notes":[],"categories":["Arma 3: Functions","Arma 3: New Functions","Function Group: Aircraft Functionality","Functions","Introduced with Arma 3 version 1.70"],"docblock":{"author":"Bravo Zero One development, John_Spartan","description":"- This function is designed as part of set of functions to implement semi-authenthic ejection system on fixed wing aircrfat that have such functionality enabled/configured.\n- AI behaviour handler.","params":[{"index":0,"name":"mode","types":["Number"],"optional":false,"default":null,"description":"(Scalar)","text":"(Scalar)"},{"index":0,"name":null,"types":[],"optional":false,"default":null,"description":"plane/object","text":"plane/object"}],"returns":{"types":["Nothing"],"text":"nothing\nAI pilot will be forced to eject from aircrfat upon damage treshold reached. Semi-authenthic behaviour."},"examples":["class Eventhandlers : Eventhandlers\n{\n    Hit = \"_this call BIS_fnc_planeAiEject\";\n};"],"syntax":null,"execution":"- Call the function via attached EH to the aircrfat itself.","notes":null,"requirements":"- Compatible aircrfat must have a config definition for all subsytems that will be invoked by ejection system (see BIS_fnc_PlaneEjection).","meta":{},"text":"Author: Bravo Zero One development\n- John_Spartan\n\nDescription:\n- This function is designed as part of set of functions to implement semi-authenthic ejection system on fixed wing aircrfat that have such functionality enabled/configured.\n- AI behaviour handler.\n\nExucution:\n- Call the function via attached EH to the aircrfat itself.\n\n    Example:\n    class Eventhandlers : Eventhandlers\n    {\n        Hit = \"_this call BIS_fnc_planeAiEject\";\n    };\n\nRequirments:\n- Compatible aircrfat must have a config definition for all subsytems that will be invoked by ejection system (see BIS_fnc_PlaneEjection).\n\nParameter(s):\n    _this select 0: mode (Scalar)\n    0: plane/object\n\nReturns: nothing\nResult: AI pilot will be forced to eject from aircrfat upon damage treshold reached. Semi-authenthic behaviour."},"filled_from_docblock":["description"]}