Tayfunwiki: Created page with "== `onJoinedFamily` Event in Actor Class == === Overview === The `onJoinedFamily` event in the `Actor` class is activated when the actor becomes a member of a family. This event is crucial in games where family dynamics significantly influence character development, gameplay mechanics, and the unfolding of the narrative. === Description === * Event Type: `Action` * Functionality: The event is triggered when an actor..."

2023-12-24T20:03:17Z

Created page with "== <code>onJoinedFamily</code> Event in Actor Class == === Overview === The <code>onJoinedFamily</code> event in the <code>Actor</code> class is activated when the actor becomes a member of a family. This event is crucial in games where family dynamics significantly influence character development, gameplay mechanics, and the unfolding of the narrative. === Description === * Event Type: <code>Action<Family></code> * Functionality: The event is triggered when an actor..."

New page

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

=== Overview ===
The <code>onJoinedFamily</code> event in the <code>Actor</code> class is activated when the actor becomes a member of a family. This event is crucial in games where family dynamics significantly influence character development, gameplay mechanics, and the unfolding of the narrative.

=== Description ===

* Event Type: <code>Action<Family></code>
* Functionality: The event is triggered when an actor joins a family. It provides the <code>Family</code> object representing the family joined. This setup enables specific actions or logic to be implemented in response to the actor's new family affiliation.

=== Usage ===
The event is typically used to trigger updates or custom actions within the game when an actor's family status changes. This can involve adjusting character roles, updating story elements, or changing interaction dynamics to reflect the new family membership.

=== Subscribing to the Event ===
To handle changes in an actor's family status, a method with the signature <code>Action<Family></code> should be subscribed to the <code>onJoinedFamily</code> event. Proper unsubscribing from the event is essential for optimal game performance and to prevent memory leaks.

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

void Start() {
if (actor != null) {
actor.onJoinedFamily += OnJoinedFamily;
}
}

private void OnJoinedFamily(Family newFamily) {
Debug.Log($"{actor.FullName} has joined the family: {newFamily.FamilyName}.");
// Implement logic to handle the actor's new family affiliation
}

void OnDestroy() {
if (actor != null) {
actor.onJoinedFamily -= OnJoinedFamily;
}
}
}
</syntaxhighlight>In this Unity script example, the <code>FamilyJoinHandler</code> is attached to a GameObject and subscribes to the <code>onJoinedFamily</code> event of an <code>Actor</code>. When the actor joins a new family, the <code>OnJoinedFamily</code> method is called, enabling the game to respond appropriately to the new family connection.

=== Remarks ===

* The <code>onJoinedFamily</code> event is essential for creating dynamic and engaging gameplay experiences, particularly in titles where family relationships play a key role.
* Handling this event effectively can add depth and richness to the game narrative, offering a more immersive and contextually rich environment.
* This event is especially relevant in role-playing games, simulation games, and other narrative-driven games where family affiliations and dynamics are central to character development and story progression.

OnJoinedFamily - Revision history