Tayfunwiki: Created page with "== `onRoleChanged` Event in Actor Class == === Overview === The `onRoleChanged` event is an integral part of the `Actor` class, activated when the actor is assigned a new role. This event plays a crucial role in games where role assignments and changes significantly impact character development, gameplay mechanics, or narrative progression. === Description === * Event Type: `Action` * Functionality: This event triggers..."

2023-12-24T19:53:11Z

Created page with "== <code>onRoleChanged</code> Event in Actor Class == === Overview === The <code>onRoleChanged</code> event is an integral part of the <code>Actor</code> class, activated when the actor is assigned a new role. This event plays a crucial role in games where role assignments and changes significantly impact character development, gameplay mechanics, or narrative progression. === Description === * Event Type: <code>Action<Role></code> * Functionality: This event triggers..."

New page

== <code>onRoleChanged</code> Event in Actor Class ==

=== Overview ===
The <code>onRoleChanged</code> event is an integral part of the <code>Actor</code> class, activated when the actor is assigned a new role. This event plays a crucial role in games where role assignments and changes significantly impact character development, gameplay mechanics, or narrative progression.

=== Description ===

* Event Type: <code>Action<Role></code>
* Functionality: This event triggers when there is a change in the actor's role. It allows for the execution of custom actions or logic in response to the new role assignment, enabling dynamic character evolution and interaction based on role-related attributes and responsibilities.

=== Usage ===
The event is used to implement specific responses or updates in the game when an actor's role changes. This can include modifying character abilities, updating narrative elements, or changing interaction options to align with the new role.

=== Subscribing to the Event ===
Subscribe to the <code>onRoleChanged</code> event within a MonoBehaviour script to handle role changes in an actor. Ensure to unsubscribe from the event when it's no longer needed or when the actor is destroyed, to maintain optimal performance and avoid memory leaks.

=== Example of Usage ===
<syntaxhighlight lang="c#">
public class RoleChangeHandler : MonoBehaviour {
public Actor actor;

void Start() {
if (actor != null) {
actor.onRoleChanged += OnRoleChanged;
}
}

private void OnRoleChanged(Role newRole) {
Debug.Log($"{actor.FullName} has been assigned a new role: {newRole.RoleName}.");
// Implement logic to handle the actor's new role
}

void OnDestroy() {
if (actor != null) {
actor.onRoleChanged -= OnRoleChanged;
}
}
}
</syntaxhighlight>In this Unity script, the <code>RoleChangeHandler</code> is attached to a GameObject and subscribes to the <code>onRoleChanged</code> event of an <code>Actor</code>. When the actor's role changes, the <code>OnRoleChanged</code> method is invoked, providing an opportunity to adapt the game to the actor's new role.

=== Remarks ===

* The <code>onRoleChanged</code> event is essential for creating responsive and adaptive gameplay experiences, particularly in games where character roles define abilities, duties, or story arcs.
* Proper handling of role changes through this event contributes to the depth and interactivity of the game, reflecting the evolving nature of characters.
* This event is highly relevant in role-playing games, strategy games, and other titles where character roles are central to gameplay dynamics and narrative development.

OnRoleChanged - Revision history