Skip to main content

Setup Packets

Packets in the com.hypixel.hytale.protocol.packets.setup package (IDs 20-34).

WorldSettings (20)

Bound: Clientbound | Compressed: Yes

Configures the game world constraints and required assets.

FieldTypeNotes
nullBitsByteBitmask.
worldHeightIntVertical map height.
requiredAssetsList<Asset>Optional (Mask 0x1). List of assets client must have.

WorldLoadProgress (21)

Bound: Clientbound

Updates the loading bar on the client.

FieldTypeNotes
progressFloat0.0 to 1.0.
messageStringLoading status text (e.g., "Loading Chunks").

WorldLoadFinished (22)

Bound: Clientbound

Payload is empty. Tells the client to hide the loading screen.

RequestAssets (23)

Bound: Serverbound | Compressed: Yes

Client asking for asset data it is missing.

FieldTypeNotes
assetsList<String>List of Asset hashes/names requested.

AssetInitialize (24)

Bound: Clientbound

Header for an incoming asset file transfer.

FieldTypeNotes
nameStringAsset name.
sizeIntTotal size in bytes.
checksumIntCRC/Hash of the file.

AssetPart (25)

Bound: Clientbound | Compressed: Yes

A chunk of binary data for the file currently being transferred.

FieldTypeNotes
dataByte[]The binary payload.

AssetFinalize (26)

Bound: Clientbound

Payload is empty. Marks the end of the current asset transfer.

RemoveAssets (27)

Bound: Clientbound

Instructs the client to remove specific assets from its cache.

FieldTypeNotes
assetNamesList<String>The list of asset names to delete.

RequestCommonAssetsRebuild (28)

Bound: Serverbound

Debug Packet. Requests the server to rebuild common assets.

SetUpdateRate (29)

Bound: Clientbound

Sets the client's logic tick rate.

FieldTypeNotes
rateIntTicks per second (usually 20).

SetTimeDilation (30)

Bound: Clientbound

Controls the speed of the game simulation (slow motion or speed up).

FieldTypeNotes
dilationDouble1.0 is normal speed.

UpdateFeatures (31)

Bound: Clientbound

Enables or disables client-side features (UI elements, controls).

FieldTypeNotes
featuresMap<String, Boolean>Map of feature IDs to enabled state.

ViewRadius (32)

Bound: Serverbound

Sent by the client when the user changes their render distance settings.

FieldTypeNotes
radiusIntThe new view radius in chunks.

PlayerOptions (33)

Bound: Serverbound

Syncs client settings to the server.

FieldTypeNotes
viewDistanceIntRender distance.
skinStringPlayer skin texture ID.
leftHandedBooleanMain hand preference.

ServerTags (34)

Bound: Clientbound | Compressed: Yes

Synchronizes registry tags (groups of items/blocks).

FieldTypeNotes
tagsMap<String, List<String>>Map of Tag Names (e.g. #logs) to entry lists.