Tayfunwiki: Created page with "== `onRuntimeActorCreated` Event in IM Class == === Overview === The `onRuntimeActorCreated` event in the IM (Intrigue Manager) class is triggered when a runtime actor is created within the game world. === Description === * Event Type: `Action` * Functionality: This event is activated when a new actor is instantiated at runtime. It passes two parameters upon invocation: *** An `Actor` object represen..."

2024-01-04T18:32:57Z

Created page with "== <code>onRuntimeActorCreated</code> Event in IM Class == === Overview === The <code>onRuntimeActorCreated</code> event in the IM (Intrigue Manager) class is triggered when a runtime actor is created within the game world. === Description === * Event Type: <code>Action<Actor, GameObject></code> * Functionality: ** This event is activated when a new actor is instantiated at runtime. ** It passes two parameters upon invocation: *** An <code>Actor</code> object represen..."

New page

== <code>onRuntimeActorCreated</code> Event in IM Class ==

=== Overview ===
The <code>onRuntimeActorCreated</code> event in the IM (Intrigue Manager) class is triggered when a runtime actor is created within the game world.

=== Description ===

* Event Type: <code>Action<Actor, GameObject></code>
* Functionality:
** This event is activated when a new actor is instantiated at runtime.
** It passes two parameters upon invocation:
*** An <code>Actor</code> object representing the newly created actor.
*** A <code>GameObject</code> associated with the actor, typically representing its in-game entity or avatar.

=== Usage ===
The <code>onRuntimeActorCreated</code> event is crucial for handling the creation of new actors in the game. It enables developers to execute specific actions or scripts when a new actor enters the game world, such as initializing actor-specific behaviors, updating game states, or integrating the actor into existing game systems.

=== Example of Usage ===
<syntaxhighlight lang="c#">
public class ActorCreationHandler : MonoBehaviour {
void OnEnable() {
IM.onRuntimeActorCreated += HandleNewActor;
}

void OnDisable() {
IM.onRuntimeActorCreated -= HandleNewActor;
}

private void HandleNewActor(Actor actor, GameObject actorGameObject) {
Debug.Log($"New runtime actor created: {actor.Name}");
// Additional logic to process the new actor
// This could include adding custom components, setting up interactions, or integrating the actor into game narratives
}
}
</syntaxhighlight>

==== Description: ====

* <code>HandleNewActor</code>: Subscribed to the <code>onRuntimeActorCreated</code> event, this method is called when a new runtime actor is created. It processes the actor and its associated GameObject, allowing for responses such as customization, integration into gameplay, or other actor-specific setup.

=== Remarks ===

* The <code>onRuntimeActorCreated</code> event is particularly important in games that dynamically generate characters or NPCs, allowing for seamless integration of these actors into the game world.
* Proper handling of this event contributes to a dynamic and evolving game environment, where new actors can enhance gameplay, narrative, or player interaction.
* It's especially relevant in role-playing games, simulation games, or any genre that involves dynamic character creation and management.

OnRuntimeActorCreated - Revision history