PlayerDisconnectEvent

Package: com.hypixel.hytale.server.core.event.events.player Extends: PlayerRefEvent<Void> Implements: IEvent<Void> Cancellable: No

Standard event dispatched when a fully connected player disconnects from the server. The disconnectReason field indicates why the player disconnected, derived from the player’s PacketHandler.

This event fires only for players who completed the full connection flow (i.e., a PlayerConnectEvent was previously dispatched for them). For players who disconnect during the setup phase before entity creation, see PlayerSetupDisconnectEvent.

Fields / Accessors

Field	Type	Accessor	Mutable	Nullable
playerRef	PlayerRef	getPlayerRef()	No	No
disconnectReason	PacketHandler.DisconnectReason	getDisconnectReason()	No	No

• playerRef — Reference to the disconnecting player. Inherited from PlayerRefEvent.
• disconnectReason — The reason for the disconnect.

Fired By

• Universe (line 767) via eventBus dispatch — EventBus dispatch when a connected player disconnects from the server.

Listening

getEventRegistry().register(PlayerDisconnectEvent.class, event -> {
    PlayerRef playerRef = event.getPlayerRef();
    PacketHandler.DisconnectReason reason = event.getDisconnectReason();
    // Handle player disconnect
});

Related Events

• PlayerConnectEvent — The counterpart event fired when the player initially connects.
• PlayerSetupDisconnectEvent — Fired when a player disconnects during the setup phase, before entity creation.
• DrainPlayerFromWorldEvent — Fired when the player leaves a world. May fire before this event during the disconnect sequence.