Skip to content

Core Server Events

Package: com.hypixel.hytale.server.core.event.events

These are the fundamental server lifecycle events.


Fired when the server has finished booting and is ready to accept connections.

Class: com.hypixel.hytale.server.core.event.events.BootEvent

PropertyValue
ImplementsIEvent<Void>
AsyncNo
CancellableNo
KeyTypeVoid

None - this is a simple marker event.

Fired once during server startup, after all systems are initialized but before accepting player connections.


Fired when the server is shutting down. Handlers should clean up resources.

Class: com.hypixel.hytale.server.core.event.events.ShutdownEvent

PropertyValue
ImplementsIEvent<Void>
AsyncNo
CancellableNo
KeyTypeVoid

None - this is a simple marker event.

The ShutdownEvent class defines priority constants for ordered shutdown:

ConstantValuePurpose
DISCONNECT_PLAYERS-48Disconnect players first
UNBIND_LISTENERS-40Unbind network listeners
SHUTDOWN_WORLDS-32Shutdown world processing

Fired when the server receives a shutdown signal (command, SIGTERM, etc.).

// handle shutdown before worlds are stopped
events.register(ShutdownEvent.SHUTDOWN_WORLDS + 1, ShutdownEvent.class, event -> {
saveAllPlayerData();
});
// handle shutdown after worlds are stopped
events.register(ShutdownEvent.SHUTDOWN_WORLDS - 1, ShutdownEvent.class, event -> {
closeConnections();
releaseResources();
});

Deprecated: This event is deprecated and may be removed in future versions.

Fired during the universe preparation phase, before worlds are loaded.

Class: com.hypixel.hytale.server.core.event.events.PrepareUniverseEvent

PropertyValue
ImplementsIEvent<Void>
AsyncNo
CancellableNo
KeyTypeVoid
FieldTypeDescription
worldConfigProviderWorldConfigProviderProvider for world configuration
MethodReturn TypeDescription
getWorldConfigProvider()WorldConfigProviderGets the world configuration provider
setWorldConfigProvider(WorldConfigProvider)voidSets the world configuration provider

Fired during server startup, after basic initialization but before worlds are created/loaded.