Changes between Initial Version and Version 1 of ScriptableController

Timestamp:

Dec 14, 2017, 4:51:51 PM (6 years ago)

Author:

kohlia

Comment:

—

ScriptableController

@@ +1 @@
+= 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)
+