SDKBehaviorInstance interface is used as the base class for runtime behavior instances in the SDK. When a behavior is added to an object type, each of its object instances has a behavior instance created and associated with it.
SDKBehaviorInstance cannot be directly constructed; it should only be used as a base class.
- Reference to the BehaviorInstance representing this behavior instance in the runtime. This allows access to Construct's built-in runtime features for behavior instances.
- Reference to the Instance representing the associated instance in the runtime. This is the object instance that the behavior can control.
- Reference to the associated Runtime that controls execution of the project.
- Reference to the BehaviorType representing the behavior type that this instance belongs to.
- Reference to your addon's SDK behavior type class, which derives from SDKBehaviorTypeBase.
- Optional override for when a behavior instance is released.
this._inst.GetWorldInfo(), i.e. the WorldInfo for the associated object instance. Note this is only applicable when added to "world" type plugins, otherwise it returns
- Returns your addon's SDK behavior class, which derives from SDKBehaviorBase.
- Optional override called after the associated object instance has finished being created. This is useful since the behavior instance constructor is called during instance creation, so the final state is not ready yet.
- Fire a trigger condition. The condition must be declared as a trigger in aces.json. Pass a full reference to the condition method, e.g.
- Utility methods to start or stop the runtime calling the
PostTick() methods of your instance every tick, and also to check whether ticking is active. It is recommended to stop ticking whenever the tick method is no longer needed to reduce the performance overhead of ticking. Redundant calls to start or stop ticking are ignored. The first call always takes effect (i.e. calls do not stack - if you make 3 calls to start ticking then 1 call to stop ticking, ticking is stopped).
- Optional override that is called every tick just before events are run after
_StartTicking() has been called.
- Optional override that is called every tick just after events are run after
_StartTicking2() has been called.
- Optional override that is called every tick just after all other behaviors have had their
Tick() methods called. This allows behaviors to observe the state applied by other behavior's ticking. Note you should use
Tick() rather than
PostTick() where possible, since it is not possible to reliably observe the state applied by other behavior's post-ticking.
- Override to return properties to display in the debugger. For more information see runtime scripts.
- Optional override to return a JSON object that represents the state of the instance for savegames.
- Optional override accepting a JSON object returned by a prior call to
SaveToJson() that represents the state of an instance to load, for savegames.
- CallAction(actMethod, ...args)
- Convenience method to run an action method with the given parameters. For example:
this.CallAction(C3.Behaviors.MyAddon.Acts.MyAction, "foo", "bar")
- CallExpression(expMethod, ...args)
- Convenience method to run an expression method with the given parameters. Returns the value returned by the expression. For example:
const value = this.CallExpression(C3.Behaviors.MyAddon.Exps.MyExpression)
- Return a custom class to instantiate for the script interface in Construct's scripting feature. See the SDK downloads for sample usage of a custom script interface.
- Return the actual script interface used for this behavior instance in Construct's scripting feature. This is an IBehaviorInstance or derivative.
Addon SDK Manual
You are here:
Search this manual:
This manual entry was last updated on 11 Nov, 2020 at 12:06