View source

class Script<T>

package defold.support

Base class for all scripts.

Subclasses of this class will be available as .script files in the Defold project. See ScriptMacro for more details.

Methods

private@:dox(show)final_(self:T):Void

Called when a script component is finalized.

This is a callback-function, which is called by the engine when a script component is finalized (destroyed). It can be used to e.g. take some last action, report the finalization to other game object instances, delete spawned objects or release user input focus (see release_input_focus).

Parameters:

self

reference to the script state to be used for storing data

private@:dox(show)init(self:T):Void

Called when a script component is initialized.

This is a callback-function, which is called by the engine when a script component is initialized. It can be used to set the initial state of the script.

Parameters:

self

reference to the script state to be used for storing data

private@:dox(show)on_input(self:T, action_id:Hash, action:ScriptOnInputAction):Bool

Called when user input is received.

This is a callback-function, which is called by the engine when user input is sent to the game object instance of the script. It can be used to take action on the input, e.g. move the instance according to the input.

For an instance to obtain user input, it must first acquire input focuse through the message acquire_input_focus. See the documentation of that message for more information.

The action parameter is a table containing data about the input mapped to the action_id. For mapped actions it specifies the value of the input and if it was just pressed or released. Actions are mapped to input in an input_binding-file.

Mouse movement is specifically handled and uses nil as its action_id. The action only contains positional parameters in this case, such as x and y of the pointer.

Parameters:

self

reference to the script state to be used for storing data

action_id

id of the received input action, as mapped in the input_binding-file

action

a table containing the input data, see above for a description

Returns:

optional boolean to signal if the input should be consumed (not passed on to others) or not, default is false

private@:dox(show)on_message<TMessage>(self:T, message_id:Message<TMessage>, message:TMessage, sender:Url):Void

Called when a message has been sent to the script component.

This is a callback-function, which is called by the engine whenever a message has been sent to the script component. It can be used to take action on the message, e.g. send a response back to the sender of the message.

The message parameter is a table containing the message data. If the message is sent from the engine, the documentation of the message specifies which data is supplied.

Parameters:

self

reference to the script state to be used for storing data

message_id

id of the received message

message

a table containing the message data

sender

address of the sender

private@:dox(show)on_reload(self:T):Void

Called when the script component is reloaded.

This is a callback-function, which is called by the engine when the script component is reloaded, e.g. from the editor. It can be used for live development, e.g. to tweak constants or set up the state properly for the instance.

Parameters:

self

reference to the script state to be used for storing data

private@:dox(show)update(self:T, dt:Float):Void

Called every frame to update the script component.

This is a callback-function, which is called by the engine every frame to update the state of a script component. It can be used to perform any kind of game related tasks, e.g. moving the game object instance.

Parameters:

self

reference to the script state to be used for storing data

dt

the time-step of the frame update