From Starbounder - Starbound Wiki
Jump to: navigation, search


These object hooks are stubs for global functions that object scripts can define, which will be called by C++. Documentation for it was removed from the assets, but an old and outdated (2015) version can be found here:



Called (once) after the object is added to the world, and when the world containing that object is loaded.


Update loop handler.
Called once every scriptDelta (defined in *.object) ticks


Called when the object is about to be removed from the world.


Called when the object is removed from the world, and when the world (containing the object) is unloaded.


Called when the container contents have been changed or interacted with in a GUI Pane.

To have the callback use a different name, add the parameter "containerCallback" : "[function name]" to your object's config file.


Called when the object is interacted with.

'args' - Map of interaction event arguments:

     sourceId = <Entity id of the entity interacting with this object>
     sourcePosition = <The {x,y} position of the interacting entity>


 nil (no interaction response)
 or a table -- see sbvnobject and challengedoor examples in
            -- the link for code examples below.
 	  <string "interactAction", --see above
 	  <map {<interactData>}>

If interactData is malformed in the returned value, the object will not be interactable in game, even with object.setInteractive(true). The same applies if onInteracion() throws a lua exception at runtime.

Objects that only need to rely on a GUI Pane doesn't need to specify a "scripts" variable in their .object file, just provide values for "interactAction" and "interactData"/"uiConfig".

Available interaction responses ("interactActions") are:

    "OpenCraftingInterface"               --used 36 times in vanilla
    "OpenTeleportDialog"                  --used 29 times in vanilla
    "ScriptPane" - For widget-based panes --used 26 times in vanilla
    "OpenMerchantInterface"               --used 14 times in vanilla
    "ShowPopup"                           --used  6 times in vanilla
    "OpenCockpitInterface"                --not used in vanilla
    "SitDown"                             --not used in vanilla
    "OpenCookingInterface"                --not used in vanilla
    "OpenTechInterface"                   --not used in vanilla
    "Teleport"                            --not used in vanilla
    "OpenSongbookInterface"               --not used in vanilla
    "OpenNpcCraftingInterface"            --not used in vanilla
    "OpenTech3DPrinterDialog"             --not used in vanilla
    "ScriptConsole" - For ScriptCanvases  --not used in vanilla

See Modding:Lua/onInteraction for some code examples.


Called when the level of an inbound connected node changes
'args' - Map of:

     node = <(int) index of the node that is changing>
     level = <new level of the node>


Called when a node is connected or disconnected


Called when the object is interacted with, by an NPC.

Quick Navigation