Tayfunwiki: Created page with "== `onActorRoleChanged` Event in Clan Class == === Overview === The `onActorRoleChanged` event in the Clan class is triggered when there is a change in an actor's role within the clan. This event plays a critical role in tracking and responding to changes in the responsibilities and status of clan members. === Event Definition === public Action onActorRoleChanged; === Description === *..."

2024-01-05T00:42:29Z

Created page with "== <code>onActorRoleChanged</code> Event in Clan Class == === Overview === The <code>onActorRoleChanged</code> event in the Clan class is triggered when there is a change in an actor's role within the clan. This event plays a critical role in tracking and responding to changes in the responsibilities and status of clan members. === Event Definition === <syntaxhighlight lang="c#"> public Action<Actor, Role> onActorRoleChanged; </syntaxhighlight> === Description === *..."

New page

== <code>onActorRoleChanged</code> Event in Clan Class ==

=== Overview ===
The <code>onActorRoleChanged</code> event in the Clan class is triggered when there is a change in an actor's role within the clan. This event plays a critical role in tracking and responding to changes in the responsibilities and status of clan members.

=== Event Definition ===
<syntaxhighlight lang="c#">
public Action<Actor, Role> onActorRoleChanged;
</syntaxhighlight>

=== Description ===

* Delegate Type: <code>Action<Actor, Role></code>
* Purpose: Notifies when an actor's role in the clan is changed.
* Parameters:
** <code>Actor</code>: The actor whose role has changed.
** <code>Role</code>: The previous role held by the actor.

=== Functionality ===

* The <code>onActorRoleChanged</code> event is raised when there is a change in the role of an actor within the clan.
* It provides the <code>Actor</code> object and the <code>Role</code> object, representing the actor and their old role, respectively.
* This event allows for dynamic updates to game elements such as clan hierarchies, actor profiles, or triggering specific gameplay mechanics or narrative elements associated with role changes.

=== Usage ===
This event is essential for scenarios where role assignments within a clan are crucial to gameplay dynamics, resource management, or storyline progression. It ensures that any change in an actor's role is consistently reflected and acted upon throughout the game.

=== Example of Usage ===
<syntaxhighlight lang="c#">
public class ClanRoleChangeHandler : MonoBehaviour {
void Start() {
Clan playerClan = IM.Player.Clan;
if (playerClan != null) {
playerClan.onActorRoleChanged += HandleRoleChange;
}
}

private void HandleRoleChange(Actor actor, Role oldRole) {
string newRoleName = actor.Role.RoleName;
Debug.Log($"Role change in player's clan: {actor.Name} changed from {oldRole.RoleName} to {newRoleName}");
}

void OnDestroy() {
if (IM.Player.Clan != null) {
playerClan.onActorRoleChanged -= HandleRoleChange;
}
}
}
</syntaxhighlight>

==== Description ====

* This example demonstrates subscribing to the <code>onActorRoleChanged</code> event for the player's clan.
* When an actor's role changes, the <code>HandleRoleChange</code> method is called, logging the actor's name and their transition from the old role to the new role.
* It also ensures to unsubscribe from the event upon the destruction of the GameObject to prevent memory leaks or unintended behavior.

=== Remarks ===

* The <code>onActorRoleChanged</code> event is vital for maintaining a realistic portrayal of clan dynamics and hierarchy.
* It allows for a responsive and immersive gameplay experience, where role changes within a clan can have significant implications.

OnActorRoleChanged - Revision history