PossessableExtensions

Static extension methods for IPossessable that delegate possession state queries to the underlying Possessable component.

Definition

Namespace: Paragon.Townskeep.PossessionSystem Assembly: Townskeep.dll

public static class PossessableExtensions

Remarks

All methods delegate to IPossessable.Possessable, providing a clean API for game code that works with the IPossessable interface rather than the concrete Possessable MonoBehaviour.

Quick Lookup

Goal	How
Check if possessed	possessable.IsPossessed()
Check possessor type	possessable.IsPossessedBy<Player>()
Get current possessor	possessable.GetPossessor()
Safely get typed possessor	possessable.TryGetPossessor<Player>(out var player)

Methods

IsPossessed

Returns true if the possessable is currently possessed by any possessor.

public static bool IsPossessed(this IPossessable possessable)

Returns: true if a possessor currently controls this entity.

IsPossessedBy<TPossessor>

Returns true if the possessable is possessed by a possessor whose owner is of type TPossessor.

public static bool IsPossessedBy<TPossessor>(this IPossessable possessable)
    where TPossessor : class, IPossessor

Returns: true if the current possessor's owner implements TPossessor.

GetPossessor

Returns the Possessor component currently controlling this possessable.

public static Possessor GetPossessor(this IPossessable possessable)

Returns: The Possessor instance, or null if not possessed.

TryGetPossessor<TPossessor>

Attempts to get the possessor's owner cast to a specific type.

public static bool TryGetPossessor<TPossessor>(this IPossessable possessable, out TPossessor possessor)
    where TPossessor : class, IPossessor

Parameter	Type	Description
possessor	out TPossessor	The typed possessor owner, or null

Returns: true if the possessor's owner is of type TPossessor.

Common Pitfalls

GetPossessor returns Possessor, not IPossessor GetPossessor() returns the Possessor MonoBehaviour, not the IPossessor interface. Use TryGetPossessor<T>() to get the high-level interface type.

NullReferenceException on unpossessed entity TryGetPossessor<T>() accesses this.possessor.Owner internally. If the entity is not possessed, the underlying Possessor reference is null and the call may throw. Always check IsPossessed() first, or use TryGetPossessor<T>() which handles this safely.

Examples

Checking Possession State

IPossessable npc = GetComponent<IPossessable>();

if (npc.IsPossessedBy<Player>())
{
    Debug.Log("NPC is player-controlled");
}

if (npc.TryGetPossessor<Player>(out var player))
{
    Debug.Log($"Controlled by: {player}");
}

See Also

• IPossessable — interface these methods extend

• Possessable — underlying component

• PossessorExtensions — companion extensions for possessors