Packet Types Catalog

Packet Types Catalog

Complete catalog of all 280 packet types in the Hytale protocol, organized by category.

New in Update 3

Update 3 added 3 new packets (BuilderToolSetEntityCollision, UpdateAnchorUI, CreateUserMarker), removed 2 packets (AssetEditorEnableAssetPack, Status), and converted AssetEditorRebuildCaches from a packet to a plain utility class. All packets now declare a direction (ToServerPacket, ToClientPacket, or both) and a NetworkChannel. See the full Update 3 changelog for all protocol changes.

New in Update 4

Update 4 adds 12 new packets across voice chat, stream management, emotes, and builder tools. The Disconnect packet was split into ClientDisconnect and ServerDisconnect, shifting Ping and Pong IDs. Two new packet categories were added: voice and stream. The total packet count increased from 268 to 280.

Package Location

com.hypixel.hytale.protocol.packets

Packet Direction Legend

Symbol	Meaning
S→C	Server to Client
C→S	Client to Server
Both	Bidirectional

Connection Packets

Package: protocol.packets.connection

ID	Name	Direction	Description
0	Connect	C→S	Initial connection with protocol hash, UUID, username
1	ClientDisconnect	C→S	Client-initiated disconnect with ClientDisconnectReason enum
2	ServerDisconnect	S→C	Server-initiated disconnect with FormattedMessage reason
3	Ping	S→C	Latency measurement request
4	Pong	C→S	Latency measurement response

Changed in Update 4

The bidirectional Disconnect (ID 1) was split into ClientDisconnect (ID 1, C→S) and ServerDisconnect (ID 2, S→C). ClientDisconnect uses a fixed-size ClientDisconnectReason enum instead of a variable-length String. ServerDisconnect uses FormattedMessage for rich disconnect reasons. Ping shifted from ID 2 to 3, and Pong from ID 3 to 4.

Authentication Packets

Package: protocol.packets.auth

ID	Name	Direction	Description

Removed in Update 3

Status (packet ID 10) was removed in Update 3. All removals are documented in the Update 3 changelog.

| 11 | AuthGrant | S→C | Server grants authentication rights | | 12 | AuthToken | C→S | Client sends access token | | 13 | ServerAuthToken | S→C | Server provides auth token | | 14 | ConnectAccept | S→C | Server accepts connection | | 15 | PasswordResponse | C→S | Password authentication response | | 16 | PasswordAccepted | S→C | Server accepts password | | 17 | PasswordRejected | S→C | Server rejects password with reason | | 18 | ClientReferral | C→S | Client referral data |

Setup Packets

Package: protocol.packets.setup

ID	Name	Direction	Description
20	WorldSettings	S→C	World name, seed, difficulty, game rules
21	WorldLoadProgress	S→C	World loading progress indicator
22	WorldLoadFinished	S→C	World fully loaded signal
23	RequestAssets	C→S	Client requests specific assets
24	AssetInitialize	S→C	Begin asset transfer
25	AssetPart	S→C	Asset data chunk
26	AssetFinalize	S→C	Asset transfer complete
27	RemoveAssets	S→C	Remove assets from client cache
28	RequestCommonAssetsRebuild	C→S	Request common assets rebuild
29	SetUpdateRate	S→C	Server update tick rate
30	SetTimeDilation	S→C	Time dilation factor
31	UpdateFeatures	S→C	Server feature capabilities
32	ViewRadius	S→C	Chunk loading radius
33	PlayerOptions	S→C	Player-specific options
34	ServerTags	S→C	Server metadata tags

Asset Packets

Package: protocol.packets.assets

ID	Name	Direction	Description
40	UpdateBlockTypes	S→C	Block definitions (compressed)
41	UpdateBlockHitboxes	S→C	Block collision hitboxes
42	UpdateBlockSoundSets	S→C	Block sound effects
43	UpdateItemSoundSets	S→C	Item sound effects
44	UpdateBlockParticleSets	S→C	Block particle effects
45	UpdateBlockBreakingDecals	S→C	Block destruction visuals
46	UpdateBlockSets	S→C	Block groupings (compressed)
47	UpdateWeathers	S→C	Weather configurations
48	UpdateTrails	S→C	Particle trail definitions
49	UpdateParticleSystems	S→C	Particle systems (compressed)
50	UpdateParticleSpawners	S→C	Particle spawners
51	UpdateEntityEffects	S→C	Entity effect definitions
52	UpdateItemPlayerAnimations	S→C	Item player animations
53	UpdateModelvfxs	S→C	Model visual effects
54	UpdateItems	S→C	Item definitions (compressed)
55	UpdateItemQualities	S→C	Item quality definitions
56	UpdateItemCategories	S→C	Item categorization
57	UpdateItemReticles	S→C	Aiming reticle definitions
58	UpdateFieldcraftCategories	S→C	Fieldcraft categories
59	UpdateResourceTypes	S→C	Resource type definitions
60	UpdateRecipes	S→C	Crafting recipes (compressed)
61	UpdateEnvironments	S→C	Environment definitions
62	UpdateAmbienceFX	S→C	Ambient effects
63	UpdateFluidFX	S→C	Fluid visual effects
64	UpdateTranslations	S→C	Localization (compressed)
65	UpdateSoundEvents	S→C	Sound event definitions
66	UpdateInteractions	S→C	Interaction definitions
67	UpdateRootInteractions	S→C	Root interaction definitions
68	UpdateUnarmedInteractions	S→C	Unarmed combat interactions
69	TrackOrUpdateObjective	S→C	Track/update quest objective
70	UntrackObjective	S→C	Stop tracking objective
71	UpdateObjectiveTask	S→C	Objective task update
72	UpdateEntityStatTypes	S→C	Entity stat types
73	UpdateEntityUIComponents	S→C	Entity UI components
74	UpdateHitboxCollisionConfig	S→C	Collision configuration
75	UpdateRepulsionConfig	S→C	Entity repulsion config
76	UpdateViewBobbing	S→C	Camera bob settings
77	UpdateCameraShake	S→C	Camera shake effects (compressed)
78	UpdateBlockGroups	S→C	Block group definitions
79	UpdateSoundSets	S→C	Sound sets (compressed)
80	UpdateAudioCategories	S→C	Audio category definitions
81	UpdateReverbEffects	S→C	Reverb effects
82	UpdateEqualizerEffects	S→C	Audio equalizer configs
83	UpdateFluids	S→C	Fluid type definitions
84	UpdateTagPatterns	S→C	Tag pattern definitions
85	UpdateProjectileConfigs	S→C	Projectile configurations
86	UpdateEmotes	S→C	Emote definitions (compressed)

New in Update 4

UpdateEmotes (ID 86) sends emote asset definitions (ProtocolEmote structs) to clients, supporting init, update, and remove operations.

Player Packets

Package: protocol.packets.player

ID	Name	Direction	Description
100	SetClientId	S→C	Assigns client ID
101	SetGameMode	S→C	Sets game mode
102	SetMovementStates	S→C	Movement state flags
103	SetBlockPlacementOverride	S→C	Block placement override
104	JoinWorld	S→C	Player joins world
105	ClientReady	C→S	Client ready for gameplay
106	LoadHotbar	S→C	Load hotbar configuration
107	SaveHotbar	C→S	Save hotbar state
108	ClientMovement	C→S	Player movement (compressed)
109	ClientTeleport	C→S	Teleportation request
110	UpdateMovementSettings	C→S	Movement settings
111	MouseInteraction	C→S	Mouse interaction event
112	DamageInfo	S→C	Player damage information
113	ReticleEvent	C→S	Reticle interaction
114	DisplayDebug	S→C	Debug information display
115	ClearDebugShapes	S→C	Clear debug shapes
116	SyncPlayerPreferences	S→C	Sync player preferences
117	ClientPlaceBlock	C→S	Block placement
118	UpdateMemoriesFeatureStatus	S→C	Memory feature status
119	RemoveMapMarker	C→S	Remove map marker

World Packets

Package: protocol.packets.world

ID	Name	Direction	Description
131	SetChunk	S→C	Chunk data with blocks/fluids
132	SetChunkHeightmap	S→C	Chunk heightmap
133	SetChunkTintmap	S→C	Chunk color tinting
134	SetChunkEnvironments	S→C	Chunk environment settings
135	UnloadChunk	S→C	Unload chunk
136	SetFluids	S→C	Fluid data
140	ServerSetBlock	S→C	Single block change
141	ServerSetBlocks	S→C	Batch block updates
142	ServerSetFluid	S→C	Single fluid change
143	ServerSetFluids	S→C	Batch fluid updates
144	UpdateBlockDamage	S→C	Block damage progress
145	UpdateTimeSettings	S→C	World time settings
146	UpdateTime	S→C	Current world time
147	UpdateEditorTimeOverride	S→C	Editor time override
148	ClearEditorTimeOverride	S→C	Clear time override
149	UpdateWeather	S→C	Weather update
150	UpdateEditorWeatherOverride	S→C	Editor weather override
151	UpdateEnvironmentMusic	S→C	Background music
152	SpawnParticleSystem	S→C	Spawn particles
153	SpawnBlockParticleSystem	S→C	Block-based particles
154	PlaySoundEvent2D	S→C	2D ambient sound
155	PlaySoundEvent3D	S→C	3D positional sound
156	PlaySoundEventEntity	S→C	Entity-attached sound
157	UpdateSleepState	S→C	Player sleep state
158	SetPaused	S→C	Client pause state
159	ServerSetPaused	S→C	Server pause state
360	UpdateSunSettings	S→C	Sun/lighting settings
361	UpdatePostFxSettings	S→C	Post-processing settings
362	PlaySoundEventLocalPlayer	S→C	Local player sound event

New in Update 4

PlaySoundEventLocalPlayer (ID 362) plays a sound event attached to the local player with volume and pitch modifiers.

Entity Packets

Package: protocol.packets.entities

ID	Name	Direction	Description
160	SetEntitySeed	S→C	Entity random seed
161	EntityUpdates	S→C	Batch entity updates
162	PlayAnimation	S→C	Entity animation
163	ChangeVelocity	S→C	Entity velocity
164	ApplyKnockback	S→C	Knockback force
165	SpawnModelParticles	S→C	Model particle effects
166	MountMovement	S→C	Mount movement updates
167	PlayEmote	C→S	Client requests to play an emote

New in Update 4

PlayEmote (ID 167) allows clients to request playing an emote by ID.

Inventory Packets

Package: protocol.packets.inventory

ID	Name	Direction	Description
170	UpdatePlayerInventory	S→C	Full inventory update (compressed)
171	SetCreativeItem	S→C	Creative inventory item
172	DropCreativeItem	C→S	Drop creative item
173	SmartGiveCreativeItem	S→C	Smart item give
174	DropItemStack	C→S	Drop item stack
175	MoveItemStack	C→S	Move item between slots
176	SmartMoveItemStack	C→S	Smart item move
177	SetActiveSlot	C→S	Set active hotbar slot
178	SwitchHotbarBlockSet	C→S	Switch hotbar block set
179	InventoryAction	C→S	Generic inventory action

Window Packets

Package: protocol.packets.window

ID	Name	Direction	Description
200	OpenWindow	S→C	Open GUI window
201	UpdateWindow	S→C	Window content update (compressed)
202	CloseWindow	Both	Close active window
203	SendWindowAction	C→S	Window interaction
204	ClientOpenWindow	C→S	Request window open

Interface Packets

Package: protocol.packets.interface_

ID	Name	Direction	Description
210	ServerMessage	S→C	Server message display
211	ChatMessage	Both	Chat message
212	Notification	S→C	UI notification
213	KillFeedMessage	S→C	Kill feed entry
214	ShowEventTitle	S→C	Display event title
215	HideEventTitle	S→C	Hide event title
216	SetPage	S→C	Set UI page
217	CustomHud	S→C	Custom HUD element
218	CustomPage	S→C	Custom page content
219	CustomPageEvent	C→S	Custom page interaction
222	EditorBlocksChange	S→C	Editor block changes
223	ServerInfo	S→C	Server info (name, MOTD)
224	AddToServerPlayerList	S→C	Add player to list
225	RemoveFromServerPlayerList	S→C	Remove player from list
226	UpdateServerPlayerList	S→C	Batch player list update
227	UpdateServerPlayerListPing	S→C	Update player pings
228	UpdateKnownRecipes	S→C	Known recipes (compressed)
229	UpdatePortal	S→C	Portal update
230	UpdateVisibleHudComponents	S→C	HUD visibility
231	ResetUserInterfaceState	S→C	Reset UI state
232	UpdateLanguage	S→C	Language update
233	WorldSavingStatus	S→C	Save progress
234	OpenChatWithCommand	S→C	Open chat with command
235	UpdateAnchorUI	S→C	Update anchor UI (compressed)

New in Update 3

UpdateAnchorUI (packet ID 235) was added in Update 3 for controlling anchor UI visibility and content. See the Update 3 changelog for other new packets.

World Map Packets

Package: protocol.packets.worldmap

New in Update 3

UpdateWorldMap and ClearWorldMap now use NetworkChannel.WorldMap instead of the default channel. UpdateWorldMapSettings gained four new boolean fields: allowShowOnMapToggle, allowCompassTrackingToggle, allowCreatingMapMarkers, and allowRemovingOtherPlayersMarkers. A polymorphic MapMarkerComponent system was added with four component types: PlayerMarkerComponent, PlacedByMarkerComponent, HeightDeltaIconComponent, and TintComponent. The Update 3 changelog has all map-related changes.

ID	Name	Direction	Description
240	UpdateWorldMapSettings	S→C	Map display settings
241	UpdateWorldMap	S→C	Map data (compressed)
242	ClearWorldMap	S→C	Clear map data
243	UpdateWorldMapVisible	S→C	Visible map regions
244	TeleportToWorldMapMarker	C→S	Teleport to marker
245	TeleportToWorldMapPosition	C→S	Teleport to coordinates
246	CreateUserMarker	C→S	Create user map marker

New in Update 3

CreateUserMarker (packet ID 246) was added in Update 3 for creating user-placed map markers with a color and position. More on new packets in the Update 3 changelog.

Server Access Packets

Package: protocol.packets.serveraccess

ID	Name	Direction	Description
250	RequestServerAccess	C→S	Request access level
251	UpdateServerAccess	S→C	Update player access
252	SetServerAccess	C→S	Set/modify access

Machinima Packets

Package: protocol.packets.machinima

ID	Name	Direction	Description
260	RequestMachinimaActorModel	C→S	Request actor model
261	SetMachinimaActorModel	S→C	Set actor model
262	UpdateMachinimaScene	S→C	Update scene config

Camera Packets

Package: protocol.packets.camera

ID	Name	Direction	Description
280	SetServerCamera	S→C	Server camera control
281	CameraShakeEffect	S→C	Camera shake effect
282	RequestFlyCameraMode	C→S	Request fly camera
283	SetFlyCameraMode	S→C	Set fly camera state

Interaction Packets

Package: protocol.packets.interaction

ID	Name	Direction	Description
290	SyncInteractionChains	S→C	Sync interaction chains
291	CancelInteractionChain	C→S	Cancel interaction
292	PlayInteractionFor	S→C	Play interaction
293	MountNPC	C→S	Mount NPC
294	DismountNPC	C→S	Dismount from NPC

Asset Editor Packets

Package: protocol.packets.asseteditor

ID	Name	Direction	Description
300	FailureReply	S→C	Operation failed
301	SuccessReply	S→C	Operation succeeded
302	AssetEditorInitialize	S→C	Initialize editor
303	AssetEditorAuthorization	S→C	Check authorization
304	AssetEditorCapabilities	S→C	Editor capabilities
305	AssetEditorSetupSchemas	S→C	Asset schemas
306	AssetEditorSetupAssetTypes	S→C	Asset types
307	AssetEditorCreateDirectory	C→S	Create directory
308	AssetEditorDeleteDirectory	C→S	Delete directory
309	AssetEditorRenameDirectory	C→S	Rename directory
310	AssetEditorFetchAsset	C→S	Fetch asset data
311	AssetEditorFetchJsonAssetWithParents	C→S	Fetch with inheritance
312	AssetEditorFetchAssetReply	S→C	Asset fetch reply
313	AssetEditorFetchJsonAssetWithParentsReply	S→C	Inheritance reply
314	AssetEditorAssetPackSetup	S→C	Asset pack info
315	AssetEditorUpdateAssetPack	C→S	Update asset pack
316	AssetEditorCreateAssetPack	C→S	Create asset pack
317	AssetEditorDeleteAssetPack	C→S	Delete asset pack

Removed in Update 3

AssetEditorEnableAssetPack (packet ID 318) was removed in Update 3. See the Update 3 changelog for all removed packets.

| 319 | AssetEditorAssetListSetup | S→C | Asset list | | 320 | AssetEditorAssetListUpdate | S→C | Update asset list | | 321 | AssetEditorRequestChildrenList | C→S | Request children | | 322 | AssetEditorRequestChildrenListReply | S→C | Children reply | | 323 | AssetEditorUpdateJsonAsset | C→S | Update JSON asset | | 324 | AssetEditorUpdateAsset | C→S | Update asset | | 325 | AssetEditorJsonAssetUpdated | S→C | JSON update notice | | 326 | AssetEditorAssetUpdated | S→C | Asset update notice | | 327 | AssetEditorCreateAsset | C→S | Create asset | | 328 | AssetEditorRenameAsset | C→S | Rename asset | | 329 | AssetEditorDeleteAsset | C→S | Delete asset | | 330 | AssetEditorDiscardChanges | C→S | Discard changes | | 331 | AssetEditorFetchAutoCompleteData | C→S | Autocomplete request | | 332 | AssetEditorFetchAutoCompleteDataReply | S→C | Autocomplete reply | | 333 | AssetEditorRequestDataset | C→S | Request dataset | | 334 | AssetEditorRequestDatasetReply | S→C | Dataset reply | | 335 | AssetEditorActivateButton | C→S | Activate button | | 336 | AssetEditorSelectAsset | C→S | Select asset | | 337 | AssetEditorPopupNotification | S→C | Popup notification | | 338 | AssetEditorFetchLastModifiedAssets | C→S | Recent assets | | 339 | AssetEditorLastModifiedAssets | S→C | Recent assets reply | | 340 | AssetEditorModifiedAssetsCount | S→C | Modified count | | 341 | AssetEditorSubscribeModifiedAssetsChanges | C→S | Subscribe changes | | 342 | AssetEditorExportAssets | C→S | Export assets | | 343 | AssetEditorExportAssetInitialize | S→C | Begin export | | 344 | AssetEditorExportAssetPart | S→C | Export chunk | | 345 | AssetEditorExportAssetFinalize | S→C | Export complete | | 346 | AssetEditorExportDeleteAssets | S→C | Remove exports | | 347 | AssetEditorExportComplete | S→C | Export finished |

Removed in Update 3

AssetEditorRebuildCaches (packet ID 348) was deregistered as a packet in Update 3 and converted to a plain utility class. Details in the Update 3 changelog.

| 349 | AssetEditorUndoChanges | C→S | Undo edit | | 350 | AssetEditorRedoChanges | C→S | Redo edit | | 351 | AssetEditorUndoRedoReply | S→C | Undo/redo reply | | 352 | AssetEditorSetGameTime | C→S | Set preview time | | 353 | AssetEditorUpdateSecondsPerGameDay | C→S | Adjust time speed | | 354 | AssetEditorUpdateWeatherPreviewLock | C→S | Lock weather | | 355 | AssetEditorUpdateModelPreview | C→S | Update model preview | | 356 | AssetEditorModsDirectories | S→C | Mod directories list |

New in Update 4

AssetEditorModsDirectories (ID 356) sends the list of available mod directories to the asset editor client.

Builder Tools Packets

Package: protocol.packets.buildertools

ID	Name	Direction	Description
400	BuilderToolArgUpdate	C→S	Tool argument update
401	BuilderToolEntityAction	C→S	Entity modification
402	BuilderToolSetEntityTransform	C→S	Entity transform
403	BuilderToolExtrudeAction	C→S	Extrude selection
404	BuilderToolStackArea	C→S	Stack/duplicate
405	BuilderToolSelectionTransform	C→S	Transform selection
406	BuilderToolRotateClipboard	C→S	Rotate clipboard
407	BuilderToolPasteClipboard	C→S	Paste clipboard
408	BuilderToolSetTransformationModeState	C→S	Transformation mode
409	BuilderToolSelectionUpdate	C→S	Update selection
410	BuilderToolSelectionToolAskForClipboard	C→S	Request clipboard
411	BuilderToolSelectionToolReplyWithClipboard	C→S	Clipboard reply
412	BuilderToolGeneralAction	C→S	Generic action
413	BuilderToolOnUseInteraction	C→S	On-use trigger
414	BuilderToolLineAction	C→S	Line creation
415	BuilderToolShowAnchor	S→C	Show anchor
416	BuilderToolHideAnchors	S→C	Hide anchors
417	PrefabUnselectPrefab	C→S	Deselect prefab
418	BuilderToolsSetSoundSet	C→S	Set sound set
419	BuilderToolLaserPointer	S→C	Laser pointer
420	BuilderToolSetEntityScale	C→S	Entity scale
421	BuilderToolSetEntityPickupEnabled	C→S	Entity pickup
422	BuilderToolSetEntityLight	C→S	Entity light
423	BuilderToolSetNPCDebug	C→S	NPC debug
425	BuilderToolSetEntityCollision	C→S	Set entity collision
426	PrefabSetAnchor	C→S	Set prefab anchor position
427	BuilderToolResetClipboardRotation	C→S	Reset clipboard rotation

New in Update 3

BuilderToolSetEntityCollision (packet ID 425) was added in Update 3 for enabling/disabling entity collision via builder tools. All new packets are listed in the Update 3 changelog.

New in Update 4

PrefabSetAnchor (ID 426) sets a prefab anchor position (x, y, z). BuilderToolResetClipboardRotation (ID 427) resets clipboard rotation state (empty packet).

Voice Chat Packets

New in Update 4

The voice chat system is entirely new in Update 4. Voice packets use the dedicated NetworkChannel.Voice(3) QUIC stream.

Package: protocol.packets.voice

ID	Name	Direction	Description
450	VoiceData	C→S	Opus-encoded voice audio (max 512 bytes opus data)
451	RelayedVoiceData	S→C	Relayed voice with speaker position and entity ID
452	VoiceConfig	S→C	Voice chat configuration (codec, distances, rate limits)

VoiceData is sent on NetworkChannel.Voice. RelayedVoiceData includes spatial information (Position speakerPosition, boolean speakerIsUnderwater) for 3D audio. VoiceConfig is sent on NetworkChannel.Default and configures codec (VoiceCodec.Opus), sample rate, max hearing distance, and rate limits.

Stream Management Packets

New in Update 4

Stream management packets support auxiliary QUIC streams beyond the main game stream. Used by the voice chat system to open dedicated voice streams.

Package: protocol.packets.stream

ID	Name	Direction	Description
460	StreamOpen	C→S	Request to open an auxiliary stream (StreamType)
461	StreamOpenResponse	S→C	Accept/reject stream open request

StreamType values: Game(0), Voice(1). Each connection supports up to 4 auxiliary streams.

Summary

Category	Count	Primary Direction
Connection	5	Mixed
Authentication	9	S→C
Setup	15	S→C
Assets	47	S→C
Player	20	Mixed
World	29	S→C
Entities	8	Mixed
Inventory	10	Mixed
Window	5	S→C
Interface	23	S→C
World Map	6	Mixed
Server Access	3	Mixed
Machinima	3	S→C
Camera	4	Mixed
Interaction	5	Mixed
Asset Editor	57	Mixed
Builder Tools	26	C→S
Voice Chat	3	Mixed
Stream	2	Mixed
Total	280

Related

• Networking Overview - Packet system architecture
• Packet Handlers - Handler types and usage
• Client Sync - Client-server synchronization