Tayfunwiki: Created page with "== `onPlayerDeath` Event in Actor Class == === Overview === The `onPlayerDeath` event in the `Actor` class is a critical feature designed to handle the death of the player-character within a game. This event plays a significant role in scenarios where the player's death impacts gameplay, narrative, or triggers specific in-game responses. === Description === * Event Type: `Action` * Functionality: This event triggers when the..."

2023-12-24T19:47:55Z

Created page with "== <code>onPlayerDeath</code> Event in Actor Class == === Overview === The <code>onPlayerDeath</code> event in the <code>Actor</code> class is a critical feature designed to handle the death of the player-character within a game. This event plays a significant role in scenarios where the player's death impacts gameplay, narrative, or triggers specific in-game responses. === Description === * Event Type: <code>Action</code> * Functionality: This event triggers when the..."

New page

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

=== Overview ===
The <code>onPlayerDeath</code> event in the <code>Actor</code> class is a critical feature designed to handle the death of the player-character within a game. This event plays a significant role in scenarios where the player's death impacts gameplay, narrative, or triggers specific in-game responses.

=== Description ===

* Event Type: <code>Action</code>
* Functionality: This event triggers when the player-character, represented by the <code>Actor</code> class, dies. It provides a mechanism for implementing reactions or logic specific to this event, such as game-over sequences, narrative progression, or changes in game state.

=== Usage ===
The event is utilized to trigger various actions upon the player-character's death, including updating the game state, altering narrative elements, or executing specific gameplay mechanics.

=== Subscribing to the Event ===
Subscribe to the <code>onPlayerDeath</code> event within a MonoBehaviour script to implement custom responses to the player-character's death. Unsubscribing from the event is crucial to prevent memory leaks and unwanted behavior, particularly when the scene changes or the actor instance is destroyed.

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

void Start() {
if (actor != null) {
actor.onPlayerDeath += OnPlayerDeath;
}
}

private void OnPlayerDeath() {
Debug.Log($"{actor.FullName} has died.");
// Additional logic to handle the actor's death
}

void OnDestroy() {
if (actor != null) {
actor.onPlayerDeath -= OnPlayerDeath;
}
}
}
</syntaxhighlight>In this Unity script, the <code>ActorDeathHandler</code> is attached to a GameObject and subscribes to the <code>onPlayerDeath</code> event of an <code>Actor</code>. When the player-character dies, the <code>OnPlayerDeath</code> method logs the death, and additional actions can be implemented as needed.

=== Remarks ===

* The <code>onPlayerDeath</code> event is essential in creating dynamic and engaging gameplay experiences, particularly in titles where the player's survival is a key element.
* Handling this event effectively can significantly contribute to the narrative and emotional depth of the game, providing a poignant response to the player-character's demise.
* This event is relevant across various genres, especially in adventure, survival, role-playing, and action games, where the life and death of the player-character are central to the game's progression.

OnPlayerDeath - Revision history