Packet List

Complete list of all packets in Hytale’s network protocol, organized by category.

Summary

Category	ID Range
Connection	0-3
Auth	10-18
Setup	20-34
Assets	40-85
Player	100-119
World	131-161
Entities	160-166
Inventory	170-179
Window	200-204
Interface	210-234
World Map	240-245
Server Access	250-252
Machinima	260-262
Camera	280-283
Interaction	290-294
Asset Editor	300-355
Builder Tools	400-423

---

Connection

ID	Packet	Direction	Description
0	Connect	C->S	Initial connection with identity token
1	Disconnect	Both	Graceful disconnect with reason
2	Ping	Both	Latency measurement request
3	Pong	Both	Latency measurement response

---

Authentication

See Authentication for the full handshake flow.

ID	Packet	Direction	Description
10	Status	S->C	Server status response
11	AuthGrant	S->C	Authorization grant for client
12	AuthToken	C->S	Client’s access token
13	ServerAuthToken	S->C	Server verification + password challenge
14	ConnectAccept	S->C	Connection accepted
15	PasswordResponse	C->S	Password challenge response
16	PasswordAccepted	S->C	Password verified
17	PasswordRejected	S->C	Password failed
18	ClientReferral	S->C	Redirect to another server

See Server Transfer for ClientReferral usage.

---

Setup

ID	Packet	Direction	Description
20	WorldSettings	S->C	World configuration (compressed)
21	WorldLoadProgress	S->C	Loading progress updates
22	WorldLoadFinished	S->C	Loading complete signal
23	RequestAssets	C->S	Client requests asset data
24	AssetInitialize	S->C	Begin asset transfer
25	AssetPart	S->C	Asset data chunk (compressed)
26	AssetFinalize	S->C	Asset transfer complete
27	RemoveAssets	S->C	Remove assets from client
28	RequestCommonAssetsRebuild	C->S	Request asset rebuild
29	SetUpdateRate	S->C	Set tick rate
30	SetTimeDilation	S->C	Time dilation factor
31	UpdateFeatures	S->C	Feature flags
32	ViewRadius	Both	View distance setting
33	PlayerOptions	C->S	Client options
34	ServerTags	S->C	Server tag data

---

Assets

Asset definition packets for blocks, items, particles, and more.

ID	Packet	Description
40	UpdateBlockTypes	Block type definitions
41	UpdateBlockHitboxes	Block collision shapes
42	UpdateBlockSoundSets	Block sounds
43	UpdateItemSoundSets	Item sounds
44	UpdateBlockParticleSets	Block particles
45	UpdateBlockBreakingDecals	Break animations
46	UpdateBlockSets	Block set groups
47	UpdateWeathers	Weather definitions
48	UpdateTrails	Trail effects
49	UpdateParticleSystems	Particle systems
50	UpdateParticleSpawners	Particle spawners
51	UpdateEntityEffects	Entity visual effects
52	UpdateItemPlayerAnimations	Item animations
53	UpdateModelvfxs	Model VFX
54	UpdateItems	Item definitions
55	UpdateItemQualities	Item quality tiers
56	UpdateItemCategories	Item categories
57	UpdateItemReticles	Aim reticles
58	UpdateFieldcraftCategories	Crafting categories
59	UpdateResourceTypes	Resource types
60	UpdateRecipes	Crafting recipes
61	UpdateEnvironments	Environment settings
62	UpdateAmbienceFX	Ambience effects
63	UpdateFluidFX	Fluid effects
64	UpdateTranslations	Localization strings
65	UpdateSoundEvents	Sound events
66	UpdateInteractions	Interaction definitions
67	UpdateRootInteractions	Root interactions
68	UpdateUnarmedInteractions	Unarmed interactions
69	TrackOrUpdateObjective	Quest objectives
70	UntrackObjective	Remove objective
71	UpdateObjectiveTask	Objective tasks
72	UpdateEntityStatTypes	Entity stat types
73	UpdateEntityUIComponents	Entity UI
74	UpdateHitboxCollisionConfig	Hitbox config
75	UpdateRepulsionConfig	Entity repulsion
76	UpdateViewBobbing	View bob settings
77	UpdateCameraShake	Camera shake config
78	UpdateBlockGroups	Block groups
79	UpdateSoundSets	Sound sets
80	UpdateAudioCategories	Audio categories
81	UpdateReverbEffects	Reverb effects
82	UpdateEqualizerEffects	EQ effects
83	UpdateFluids	Fluid definitions
84	UpdateTagPatterns	Tag patterns
85	UpdateProjectileConfigs	Projectile configs

---

Player

ID	Packet	Direction	Description
100	SetClientId	S->C	Assign client entity ID
101	SetGameMode	S->C	Set game mode
102	SetMovementStates	S->C	Movement state flags
103	SetBlockPlacementOverride	S->C	Block placement mode
104	JoinWorld	S->C	World join confirmation
105	ClientReady	C->S	Client ready signal
106	LoadHotbar	S->C	Load hotbar layout
107	SaveHotbar	C->S	Save hotbar layout
108	ClientMovement	C->S	Movement input
109	ClientTeleport	S->C	Teleport player
110	UpdateMovementSettings	S->C	Movement config
111	MouseInteraction	C->S	Mouse click/action
112	DamageInfo	S->C	Damage feedback
113	ReticleEvent	S->C	Reticle state change
114	DisplayDebug	S->C	Debug display
115	ClearDebugShapes	S->C	Clear debug shapes
116	SyncPlayerPreferences	Both	Player preferences
117	ClientPlaceBlock	C->S	Block placement
118	UpdateMemoriesFeatureStatus	S->C	Memory feature
119	RemoveMapMarker	C->S	Remove map marker

---

World

See World Packets for field-level details on documented packets.

ID	Packet	Direction	Description
131	SetChunk	S->C	Chunk data (compressed)
132	SetChunkHeightmap	S->C	Chunk heightmap
133	SetChunkTintmap	S->C	Chunk tint colors
134	SetChunkEnvironments	S->C	Chunk environments
135	UnloadChunk	S->C	Unload chunk
136	SetFluids	S->C	Fluid data
140	ServerSetBlock	S->C	Single block change
141	ServerSetBlocks	S->C	Multiple block changes
142	ServerSetFluid	S->C	Single fluid change
143	ServerSetFluids	S->C	Multiple fluid changes
144	UpdateBlockDamage	S->C	Block damage state
145	UpdateTimeSettings	S->C	Time settings
146	UpdateTime	S->C	Current time
147	UpdateEditorTimeOverride	S->C	Editor time override
148	ClearEditorTimeOverride	S->C	Clear time override
149	UpdateWeather	S->C	Weather state
150	UpdateEditorWeatherOverride	S->C	Editor weather
151	UpdateEnvironmentMusic	S->C	Music state
152	SpawnParticleSystem	S->C	Spawn particles
153	SpawnBlockParticleSystem	S->C	Block particles
154	PlaySoundEvent2D	S->C	2D sound
155	PlaySoundEvent3D	S->C	3D sound
156	PlaySoundEventEntity	S->C	Entity sound
157	UpdateSleepState	S->C	Sleep state
158	SetPaused	C->S	Pause request
159	ServerSetPaused	S->C	Pause state
360	UpdateSunSettings	S->C	Sun configuration
361	UpdatePostFxSettings	S->C	Post-processing

---

Entities

See Entity Packets for field-level details on documented packets.

ID	Packet	Direction	Description
160	SetEntitySeed	S->C	Entity random seed
161	EntityUpdates	S->C	Entity state updates (compressed)
162	PlayAnimation	S->C	Play entity animation
163	ChangeVelocity	S->C	Set entity velocity
164	ApplyKnockback	S->C	Apply knockback
165	SpawnModelParticles	S->C	Model particles
166	MountMovement	C->S	Mount input

---

Inventory

ID	Packet	Direction	Description
170	UpdatePlayerInventory	S->C	Inventory contents
171	SetCreativeItem	C->S	Set creative item
172	DropCreativeItem	C->S	Drop creative item
173	SmartGiveCreativeItem	C->S	Give creative item
174	DropItemStack	C->S	Drop item
175	MoveItemStack	C->S	Move item
176	SmartMoveItemStack	C->S	Smart move item
177	SetActiveSlot	C->S	Select hotbar slot
178	SwitchHotbarBlockSet	C->S	Switch block set
179	InventoryAction	C->S	Inventory action

---

Window

ID	Packet	Direction	Description
200	OpenWindow	S->C	Open UI window
201	UpdateWindow	S->C	Update window data
202	CloseWindow	Both	Close window
203	SendWindowAction	C->S	Window action
204	ClientOpenWindow	C->S	Request open window

---

Interface

See Interface Packets for field-level details on documented packets.

ID	Packet	Direction	Description
210	ServerMessage	S->C	System message
211	ChatMessage	Both	Chat message
212	Notification	S->C	UI notification
213	KillFeedMessage	S->C	Kill feed entry
214	ShowEventTitle	S->C	Show title
215	HideEventTitle	S->C	Hide title
216	SetPage	S->C	Set UI page
217	CustomHud	S->C	Custom HUD
218	CustomPage	S->C	Custom page
219	CustomPageEvent	C->S	Page event
222	EditorBlocksChange	S->C	Editor blocks
223	ServerInfo	S->C	Server info
224	AddToServerPlayerList	S->C	Add to player list
225	RemoveFromServerPlayerList	S->C	Remove from list
226	UpdateServerPlayerList	S->C	Update player list
227	UpdateServerPlayerListPing	S->C	Update pings
228	UpdateKnownRecipes	S->C	Known recipes
229	UpdatePortal	S->C	Portal state
230	UpdateVisibleHudComponents	S->C	HUD visibility
231	ResetUserInterfaceState	S->C	Reset UI
232	UpdateLanguage	Both	Language setting
233	WorldSavingStatus	S->C	Save status
234	OpenChatWithCommand	S->C	Open chat with command

---

World Map

ID	Packet	Direction	Description
240	UpdateWorldMapSettings	S->C	Map settings
241	UpdateWorldMap	S->C	Map data
242	ClearWorldMap	S->C	Clear map
243	UpdateWorldMapVisible	S->C	Map visibility
244	TeleportToWorldMapMarker	C->S	TP to marker
245	TeleportToWorldMapPosition	C->S	TP to position

---

Server Access

ID	Packet	Direction	Description
250	RequestServerAccess	C->S	Request access
251	UpdateServerAccess	S->C	Access update
252	SetServerAccess	C->S	Set access

---

Machinima

ID	Packet	Direction	Description
260	RequestMachinimaActorModel	C->S	Request actor
261	SetMachinimaActorModel	S->C	Set actor model
262	UpdateMachinimaScene	S->C	Scene update

---

Camera

ID	Packet	Direction	Description
280	SetServerCamera	S->C	Set camera
281	CameraShakeEffect	S->C	Shake effect
282	RequestFlyCameraMode	C->S	Request fly cam
283	SetFlyCameraMode	S->C	Set fly cam

---

Interaction

ID	Packet	Direction	Description
290	SyncInteractionChains	S->C	Sync interactions
291	CancelInteractionChain	Both	Cancel interaction
292	PlayInteractionFor	S->C	Play interaction
293	MountNPC	S->C	Mount NPC
294	DismountNPC	Both	Dismount NPC

---

Asset Editor

Packets for the in-game asset editor (requires Editor client type).

ID	Packet	Description
300	FailureReply	Operation failed
301	SuccessReply	Operation succeeded
302	AssetEditorInitialize	Initialize editor
303	AssetEditorAuthorization	Editor auth
304	AssetEditorCapabilities	Editor capabilities
305	AssetEditorSetupSchemas	Schema setup
306	AssetEditorSetupAssetTypes	Asset types
307	AssetEditorCreateDirectory	Create directory
308	AssetEditorDeleteDirectory	Delete directory
309	AssetEditorRenameDirectory	Rename directory
310	AssetEditorFetchAsset	Fetch asset
311	AssetEditorFetchJsonAssetWithParents	Fetch with parents
312	AssetEditorFetchAssetReply	Fetch reply
313	AssetEditorFetchJsonAssetWithParentsReply	Fetch parents reply
314	AssetEditorAssetPackSetup	Pack setup
315	AssetEditorUpdateAssetPack	Update pack
316	AssetEditorCreateAssetPack	Create pack
317	AssetEditorDeleteAssetPack	Delete pack
318	AssetEditorEnableAssetPack	Enable pack
319	AssetEditorAssetListSetup	List setup
320	AssetEditorAssetListUpdate	List update
321	AssetEditorRequestChildrenList	Request children
322	AssetEditorRequestChildrenListReply	Children reply
323	AssetEditorUpdateJsonAsset	Update JSON asset
324	AssetEditorUpdateAsset	Update asset
325	AssetEditorJsonAssetUpdated	JSON updated
326	AssetEditorAssetUpdated	Asset updated
327	AssetEditorCreateAsset	Create asset
328	AssetEditorRenameAsset	Rename asset
329	AssetEditorDeleteAsset	Delete asset
330	AssetEditorDiscardChanges	Discard changes
331	AssetEditorFetchAutoCompleteData	Autocomplete
332	AssetEditorFetchAutoCompleteDataReply	Autocomplete reply
333	AssetEditorRequestDataset	Request dataset
334	AssetEditorRequestDatasetReply	Dataset reply
335	AssetEditorActivateButton	Activate button
336	AssetEditorSelectAsset	Select asset
337	AssetEditorPopupNotification	Popup
338	AssetEditorFetchLastModifiedAssets	Fetch modified
339	AssetEditorLastModifiedAssets	Modified list
340	AssetEditorModifiedAssetsCount	Modified count
341	AssetEditorSubscribeModifiedAssetsChanges	Subscribe
342	AssetEditorExportAssets	Export assets
343	AssetEditorExportAssetInitialize	Export init
344	AssetEditorExportAssetPart	Export part
345	AssetEditorExportAssetFinalize	Export finalize
346	AssetEditorExportDeleteAssets	Export delete
347	AssetEditorExportComplete	Export complete
348	AssetEditorRebuildCaches	Rebuild caches
349	AssetEditorUndoChanges	Undo
350	AssetEditorRedoChanges	Redo
351	AssetEditorUndoRedoReply	Undo/redo reply
352	AssetEditorSetGameTime	Set time
353	AssetEditorUpdateSecondsPerGameDay	Day length
354	AssetEditorUpdateWeatherPreviewLock	Weather lock
355	AssetEditorUpdateModelPreview	Model preview

---

Builder Tools

Packets for world editing tools.

ID	Packet	Direction	Description
400	BuilderToolArgUpdate	Both	Tool argument
401	BuilderToolEntityAction	C->S	Entity action
402	BuilderToolSetEntityTransform	C->S	Set transform
403	BuilderToolExtrudeAction	C->S	Extrude
404	BuilderToolStackArea	C->S	Stack area
405	BuilderToolSelectionTransform	C->S	Transform selection
406	BuilderToolRotateClipboard	C->S	Rotate clipboard
407	BuilderToolPasteClipboard	C->S	Paste clipboard
408	BuilderToolSetTransformationModeState	Both	Transform mode
409	BuilderToolSelectionUpdate	S->C	Selection update
410	BuilderToolSelectionToolAskForClipboard	S->C	Request clipboard
411	BuilderToolSelectionToolReplyWithClipboard	C->S	Send clipboard
412	BuilderToolGeneralAction	C->S	General action
413	BuilderToolOnUseInteraction	C->S	Use interaction
414	BuilderToolLineAction	C->S	Line action
415	BuilderToolShowAnchor	S->C	Show anchor
416	BuilderToolHideAnchors	S->C	Hide anchors
417	PrefabUnselectPrefab	C->S	Unselect prefab
418	BuilderToolsSetSoundSet	C->S	Set sound set
419	BuilderToolLaserPointer	Both	Laser pointer
420	BuilderToolSetEntityScale	C->S	Set scale
421	BuilderToolSetEntityPickupEnabled	C->S	Pickup enabled
422	BuilderToolSetEntityLight	C->S	Set light
423	BuilderToolSetNPCDebug	C->S	NPC debug