Skip to main content

ModInstanceScript

See the code at resources/mod_instance_script.gd

Description

Inherits Resource

The ModInstanceScript is a script associated with a mod instance in the Mod System. It contains various virtual methods that can be overridden to customize the behavior of the mod when granted to an owner object.


Signals

None


Constants

ButtonBase

const ButtonBase = preload("mod_instance_script/button.gd")

A subclass that contains virtual functions specific to Button. Extend ModInstanceScript.ButtonBase when creating a script for a mod that will be granted to a Button.


ControlBase

const ControlBase = preload("mod_instance_script/control.gd")

A subclass that contains virtual functions specific to Control. Extend ModInstanceScript.ControlBase when creating a script for a mod that will be granted to a Control.


NodeBase

const NodeBase = preload("mod_instance_script/node.gd")

A subclass that contains virtual functions specific to Node. Extend ModInstanceScript.NodeBase when creating a script for a mod that will be granted to a Node.


ObjectBase

const ObjectBase = preload("mod_instance_script/object.gd")

A subclass that contains virtual functions specific to Object. Extend ModInstanceScript.ObjectBase when creating a script for a mod that will be granted to a Object.


ResourceBase

const ResourceBase = preload("mod_instance_script/resource.gd")

A subclass that contains virtual functions specific to Resource. Extend ModInstanceScript.ResourceBase when creating a script for a mod that will be granted to a Resource.


Properties

instance

var instance: ModInstance

The mod instance associated with this script.

Type

ModInstance


Methods

_init

func _init(instance_value: ModInstance) -> void

Initializes the script with the associated mod instance.

Parameters

NameTypeDescription
instance_valueModInstanceThe mod instance associated with this script.

Returns

void


logs

func logs(message: String) -> void

Prints the specified message to the terminal if logging is enabled (see ModSettings/enable_logging). This method can be used to log messages with contextual information about the current mod instance.

Parameters

NameTypeDescription
messageStringThe message to log.

Returns

void


_on_granted

func _on_granted() -> void

Called when the mod is granted to the owner object.

Note: This method is a virtual method that can be overridden in subclasses to perform custom actions when the mod is revoked.

Returns

void


_on_revoked

func _on_revoked() -> void

Called when the mod is revoked from the owner object.

Note: This method is a virtual method that can be overridden in subclasses to perform custom actions when the mod is revoked.

Returns

void