Player-use-ai

player-use-ai
    player-use-ai
    Causes the player's ship to be controlled by the FreeSpace AI. Takes 0 arguments. 

Comments

Locks the player's controls and places the ship under AI control, allowing issuing of orders via add-goals, including docking operations that are not normally possible for a player ship.

This SEXP is extremely useful for cutscenes since it allows to plan the player's spacecraft movements. In very complex missions featuring in-mission cutscenes, player-use-ai can be used to "freeze" the player's spacecraft during the in-mission cutscene and then "reactivate" it using Player-not-use-ai.