Package nl.pim16aap2.lightkeeper.framework

Class PlayerUnavailableException

java.lang.Object

java.lang.Throwable

java.lang.Exception

java.lang.RuntimeException

java.lang.IllegalStateException

nl.pim16aap2.lightkeeper.framework.PlayerUnavailableException

All Implemented Interfaces:

Serializable

public class PlayerUnavailableException
extends IllegalStateException

Thrown when a synthetic player cannot perform an action because its server-side lifecycle state is no longer active.

The PlayerUnavailableException.Reason is stable for programmatic assertions; the exception message retains the agent's contextual diagnostics, such as the attempted action and recorded death details.

See Also:

• Serialized Form

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static enum	PlayerUnavailableException.Reason	Machine-readable synthetic-player availability failures.

Constructor Summary

Constructors

Constructor	Description
PlayerUnavailableException(PlayerUnavailableException.Reason reason, String message)	Creates a player-availability exception.

Method Summary

Modifier and Type	Method	Description
PlayerUnavailableException.Reason	reason()	Returns why the synthetic player was unavailable.

Methods inherited from class java.lang.Throwable

addSuppressed, fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Details

PlayerUnavailableException

public PlayerUnavailableException(PlayerUnavailableException.Reason reason,
 String message)

Creates a player-availability exception.

Parameters:

reason - Machine-readable reason the player is unavailable.

message - Human-readable lifecycle and action diagnostics from the agent.

Method Details

reason

public PlayerUnavailableException.Reason reason()

Returns why the synthetic player was unavailable.

Returns:

Machine-readable availability reason.