= ScriptableController =

With the ScriptableController you can easily make scripts to control various things in orxonox and react to certain events. To do that, add a script to your level:

{{{ <Level script="scripts/myLevelScript.lua" ...> ... </Level> }}}

The script has to be written in lua and will be executed as soon as the player spawns. The path to the script is relative to {{{data/levels}}} and you preferably put your scripts in the {{{scripts}}} folder with the same name as your level. You can find a list of all functions that are available in lua in the documentation of {{{ScriptableControllerAPI}}} in {{{src/orxonox/scriptablecontroller/scriptable_controller_api.h}}}. If you call a function, make sure it has the correct number of arguments, there are no optional arguments at the moment! Also keep the type of the arguments in mind, if the function expects a string, pass it a string and not a number.

Things that could be implemented next in the ScriptableController:
 - Fix the spawning of new objects
 - Notify the scripts when the player respawns
 - Waypoints
 - Firing weapons
 - Setting the orientation with {{{lookAt}}}
 - Cutscene tools
   - Hide/unhide the HUD
   - Enable/disable user controls
   - Move the camera around
 - Register to pickup events
 - Integration of the quest system

Things that need basic knowledge of the lua stack and advanced knowledge of C++ templates:
 - Make it possible to return values from C++ functions to lua or the other way around
 - Make optional arguments possible
 - Add a 'state' argument that can be passed to {{{register*}}} functions and that will be passed back again to lua when the callback gets called (like a 'this', makes it a bit more object oriented and reduces the number of global variables in lua)