Packet Types Catalog

Packet Types Catalog

Complete catalog of all 268 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.

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	Disconnect	Both	Connection termination with reason
2	Ping	S→C	Latency measurement request
3	Pong	C→S	Latency measurement response

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

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

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

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 |

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

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.

Summary

Category	Count	Primary Direction
Connection	4	Bidirectional
Authentication	9	S→C
Setup	15	S→C
Assets	46	S→C
Player	20	Mixed
World	28	S→C
Entities	7	S→C
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	56	Mixed
Builder Tools	24	C→S
Total	268

Related

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