Tayfunwiki: Created page with "== `onPlayerIsChanged` Event in IM Class == === Overview === The `onPlayerIsChanged` event in the IM (Intrigue Manager) class is a significant event handler that is triggered when there is a change in the player's character within the game. === Description === * Event Type: `Action` * Functionality: This event is activated when the current player character is changed. It passes two `Actor` objects as para..."

2024-01-04T18:27:58Z

Created page with "== <code>onPlayerIsChanged</code> Event in IM Class == === Overview === The <code>onPlayerIsChanged</code> event in the IM (Intrigue Manager) class is a significant event handler that is triggered when there is a change in the player's character within the game. === Description === * Event Type: <code>Action<Actor, Actor></code> * Functionality: ** This event is activated when the current player character is changed. ** It passes two <code>Actor</code> objects as para..."

New page

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

=== Overview ===
The <code>onPlayerIsChanged</code> event in the IM (Intrigue Manager) class is a significant event handler that is triggered when there is a change in the player's character within the game.

=== Description ===

* Event Type: <code>Action<Actor, Actor></code>
* Functionality:
** This event is activated when the current player character is changed.
** It passes two <code>Actor</code> objects as parameters: the previous player character and the new player character.

=== Usage ===
The <code>onPlayerIsChanged</code> event is essential for handling transitions between player characters. It enables the game to adapt its state and behavior based on the change in the player's character, which can be crucial for gameplay mechanics, narrative progression, and maintaining player context.

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

void OnDisable() {
IM.onPlayerIsChanged -= HandlePlayerChange;
}

private void HandlePlayerChange(Actor oldPlayer, Actor newPlayer) {
Debug.Log($"Player character changed from {oldPlayer.Name} to {newPlayer.Name}");
// Additional logic to handle the change in player character
// This might include updating UI elements, resetting game states, or adapting game mechanics
}
}
</syntaxhighlight>

==== Description: ====

* <code>HandlePlayerChange</code>: Subscribed to the <code>onPlayerIsChanged</code> event, this method is called when the player's character changes. It processes the information about both the old and new player characters, allowing for appropriate responses to the change.

=== Remarks ===

* The <code>onPlayerIsChanged</code> event is critical in games where players can switch between different characters, affecting gameplay and narrative.
* Properly handling this event ensures a seamless transition for the player, preserving game continuity and player immersion.
* It's particularly relevant in role-playing games, adventure games, or any genre that involves multiple playable characters or avatars.

OnPlayerIsChanged - Revision history