Multiplayer Packet Structure

Updated as of Terraria v1.4.5.8

Table of Contents

Packet Structure
Appendix
Net Modules

Packet Structure

Offset	Size	Description	Type	Notes
0	2	Packet length in bytes	UInt16	-
2	1	Packet Type/ID	UInt8	Use TSAPI's `Packetypes.PacketName` enum for packet ID's
3	?	Data	?	See the rest of the page for data structures

Connect Request [1]

Client -> Server

Size	Description	Type	Notes
?	Version	String	"Terraria" + Main.curRelease

Disconnect [2]

Server -> Client

Size	Description	Type	Notes
?	Reason	NetworkText	-

Set User Slot [3]

Server -> Client

Size	Description	Type	Notes
1	Player ID	Byte	-
1	Server Special Flags	Bool	-

Player Info [4]

Server <-> Client (Sync)

Size	Description	Type	Notes
1	Player ID	Byte
1	Skin Variant	Byte
1	Voice Variant	Byte	1 = Male, 2 = Female, 3 = Other
4	Voice Pitch Offset	Single
1	Hair	Byte
?	Name	String
1	Hair Dye	Byte
2	Accessory Visibility	UInt16	Bitwise array for player.hideVisibileAccessory[10]
1	Hide Misc	Byte
3	Hair Color	Color
3	Skin Color	Color
3	Eye Color	Color
3	Shirt Color	Color
3	Under Shirt Color	Color
3	Pants Color	Color
3	Shoe Color	Color
1	Difficulty Flags	Byte	BitFlags: 1 = MediumCore, 2 = Hardcore, 4 = ExtraAccessory, 8 = Journey
1	Additional Flags 1	Byte	BitFlags: 1 = UsingBiomeTorches, 2 = happyFunTorchTime, 4 = unlockedBiomeTorches, 8 = unlockedSuperCart, 16 = enabledSuperCart
1	Additional Flags 2	Byte	BitFlags: 1 = usedAegisCrystal, 2 = usedAegisFruit, 4 = usedArcaneCrystal, 8 = usedGalaxyPearl, 16 = usedGummyWorm, 32 = usedAmbrosia, 64 = ateArtisanBread

Player Inventory Slot [5]

Server <-> Client (Sync)

Size	Description	Type	Notes
1	Player ID	Byte	-
2	Slot ID	Int16	0 - 58 = Inventory, 59 - 78 = Armor, 79 - 88 = Dye, 89 - 93 MiscEquips, 94 - 98 = MiscDyes, 99 - 138 = Piggy bank, 139 - 178 = Safe, 179 = Trash, 180 - 219 = Defender's Forge, 220 - 259 = Void Vault
2	Stack	Int16	-
1	Prefix	Byte	-
2	Item NetID	Int16	-
1	Favorited Flags	Byte	BitFlags: 1 = Favorited, 2 = Blocked

Request World Data [6]

Client -> Server

Size	Description	Type	Notes

World Info [7]

Server -> Client

Size	Description	Type	Notes
4	Time	Int32	-
1	Day and Moon Info	Byte	BitFlags: 1 = Day Time, 2 = Blood Moon, 4 = Eclipse
1	Moon Phase	Byte	-
2	Max Tiles X	Int16	-
2	Max Tiles Y	Int16	-
2	Spawn Tile X	Int16	-
2	Spawn Tile Y	Int16	-
2	WorldSurface	Int16	-
2	RockLayer	Int16	-
4	World ID	Int32	-
?	World Name	String	-
1	Game Mode	Byte	-
16	World Unique ID	Byte[]	-
8	World Generator Version	UInt64	-
1	Moon Type	Byte	-
1	Tree Background 1	Byte	-
1	Tree Background 2	Byte	-
1	Tree Background 3	Byte	-
1	Tree Background 4	Byte	-
1	Corruption Background	Byte	-
1	Jungle Background	Byte	-
1	Snow Background	Byte	-
1	Hallow Background	Byte	-
1	Crimson Background	Byte	-
1	Desert Background	Byte	-
1	Ocean Background	Byte	-
1	Mushroom Background	Byte	-
1	Underworld Background	Byte	-
1	Ice Back Style	Byte	-
1	Jungle Back Style	Byte	-
1	Hell Back Style	Byte	-
4	Wind Speed Set	Single	-
1	Cloud Number	Byte	-
4	Tree 1	Int32	-
4	Tree 2	Int32	-
4	Tree 3	Int32	-
1	Tree Style 1	Byte	-
1	Tree Style 2	Byte	-
1	Tree Style 3	Byte	-
1	Tree Style 4	Byte	-
4	Cave Back 1	Int32	-
4	Cave Back 2	Int32	-
4	Cave Back 3	Int32	-
1	Cave Back Style 1	Byte	-
1	Cave Back Style 2	Byte	-
1	Cave Back Style 3	Byte	-
1	Cave Back Style 4	Byte	-
1	Forest 1 Tree Top Style	Byte	-
1	Forest 2 Tree Top Style	Byte	-
1	Forest 3 Tree Top Style	Byte	-
1	Forest 4 Tree Top Style	Byte	-
1	Corruption Tree Top Style	Byte	-
1	Jungle Tree Top Style	Byte	-
1	Snow Tree Top Style	Byte	-
1	Hallow Tree Top Style	Byte	-
1	Crimson Tree Top Style	Byte	-
1	Desert Tree Top Style	Byte	-
1	Ocean Tree Top Style	Byte	-
1	Glowing Mushroom Tree Top Style	Byte	-
1	Underworld Tree Top Style	Byte	-
4	Rain	Single	-
1	Event Info	Byte	BitFlags: 1 = Shadow Orb Smashed, 2 = Downed Boss 1, 4 = Downed Boss 2, 8 = Downed Boss 3, 16 = Hard Mode, 32 = Downed Clown, 64 = Server Side Character, 128 = Downed Plant Boss
1	Event Info 2	Byte	BitFlags: 1 = Downed Mech Boss 1, 2 = Downed Mech Boss 2, 4 = Downed Mech Boss 3, 8 = Downed Mech Boss Any, 16 = Cloud BG Active, 32 = Crimson, 64 = Pumpkin Moon, 128 = Snow Moon
1	Event Info 3	Byte	BitFlags: 2 = FastForwardTimeToDawn, 4 = Slime Rain, 8 = Downed Slime King, 16 = Downed Queen Bee, 32 = Downed Fishron, 64 = Downed Martians, 128 = Downed Ancient Cultist
1	Event Info 4	Byte	BitFlags: 1 = Downed Moon Lord, 2 = Downed Pumking, 4 = Downed Mourning Wood, 8 = Downed Ice Queen, 16 = Downed Santank, 32 = Downed Everscream, 64 = Downed Golem, 128 = Birthday Party
1	Event Info 5	Byte	BitFlags: 1 = Downed Pirates, 2 = Downed Frost Legion, 4 = Downed Goblins, 8 = Sandstorm, 16 = DD2 Event, 32 = Downed DD2 Tier 1, 64 = Downed DD2 Tier 2, 128 = Downed DD2 Tier 3
1	Event Info 6	Byte	BitFlags: 1 = Combat Book Used, 2 = Manual Lanterns, 4 = Downed Solar Tower, 8 = Downed Vortex Tower, 16 = Downed Tower Nebula, 32 = Downed Stardust Tower, 64 = Force Halloween For Today, 128 = Force XMas For Today
1	Event Info 7	Byte	BitFlags: 1 = Bought Cat, 2 = Bought Dog, 4 = Bought Bunny, 8 = Free Cake, 16 = Drunk World, 32 = Downed Empress of Light, 64 = Downed Queen Slime, 128 = GetGoodWorld
1	Event Info 8	Byte	BitFlags: 1 = 10th Anniversary Worlds, 2 = Don't Starve World, 4 = Downed Deer Clops, 8 = Not The Bees World, 16 = Remix World, 32 = Unlocked Slime Blue Spawn, 64 = Combat Book Volume Two Was Used, 128 = Peddler's Satchel Was Used
1	Event Info 9	Byte	BitFlags: 1 = Unlocked Slime Green Spawn, 2 = Unlocked Slime Old Spawn, 4 = Unlocked Slime Purple Spawn, 8 = Unlocked Slime Rainbow Spawn, 16 = Unlocked Slime Red Spawn, 32 = Unlocked Slime Yellow Spawn, 64 = Unlocked Slime Copper Spawn, 128 = Fast Forward Time To Dusk
1	Event Info 10	Byte	BitFlags: 1 = No Traps World, 2 = Zenith World, 4 = Unlocked Truffle Spawn, 8 = Vampire Seed, 16 = Infected Seed, 32 = Team-Based Spawn Seed, 64 = Sky Block World, 128 = Dual Dungeons Seed
1	Event Info 11	Byte	BitFlags: 1 = Low Tiles, 2 = Force Halloween Forever, 4 = Force XMas Forever, 8 = More Lightning Seed, 16 = No Lightning Seed
1	Sundial Cooldown	Byte	-
1	Moondial Cooldown	Byte	-
2	Copper Ore Tier	Int16	Tile ID 7 or 166
2	Iron Ore Tier	Int16	Tile ID 6 or 167
2	Silver Ore Tier	Int16	Tile ID 9 or 168
2	Gold Ore Tier	Int16	Tile ID 8 or 169
2	Cobalt Ore Tier	Int16	Tile ID 107 or 221
2	Mythril Ore Tier	Int16	Tile ID 108 or 222
2	Adamantite Ore Tier	Int16	Tile ID 111 or 223
1	Invasion Type	SByte	1 = Goblins, 2 = Frostmoon, 3 = Pirates, 4 = Martians
8	Lobby ID	UInt64	-
4	Sandstorm Severity	Single	-
1	Number of Team-Based Spawn Points	Byte	Used for team-based spawn points
2	Team-Based Spawn Point X	Int16	Team-Based Spawn Points X & Y are repeated based on "Number of Team-Based Spawn Points" above, if any
2	Team-Based Spawn Point Y	Int16	Team-Based Spawn Points X & Y are repeated based on "Number of Team-Based Spawn Points" above, if any
2	Dungeon X	Int16
2	Dungeon Y	Int16

Request Essential Tiles [8]

This packet is used once in the connecting phase and does the following:

Sends you the spawn sections
Optionally, if spawn coords aren't -1 - sends you the sections of the selected position (which is the player's spawnpoint)
Synchronizes all portals and sections around them

Client -> Server

Size	Description	Type	Notes
4	X	Int32	Player Spawn X
4	Y	Int32	Player Spawn Y
1	Team-Based Spawn	Byte	-

Status [9]

Server -> Client

Size	Description	Type	Notes
4	StatusMax	Int32	Status only increases
?	Status Text	NetworkText	-
1	Status Text Flags	Byte	1 = HideStatusTextPercent, 2 = StatusTextHasShadows, 4 = ServerWantsToRunCheckBytesInClientLoopThread

Send Section [10]

Server -> Client

Size	Description	Type	Notes
4	X Start	Int32	-
4	Y Start	Int32	-
2	Width	Int16	-
2	Height	Int16	-
?	Tiles	-
2	Chest Count	Int16	-
?	Chests	-
2	Sign Count	Int16	-
?	Signs	-
2	TileEntity Count	Int16	-
?	TileEntities	-	-

Section Tile Frame [11]

Server -> Client

Size	Description	Type	Notes
2	Start X	Int16	-
2	Start Y	Int16	-
2	End X	Int16	-
2	End Y	Int16	-

Spawn Player [12]

Client -> Server

Size	Description	Type	Notes
1	Player ID	Byte
2	Spawn X	Int16
2	Spawn Y	Int16
4	Respawn Time Remaining	Int32
2	Number of PvE Deaths	Int16
2	Number of PvP Deaths	Int16
1	Team	Byte
1	Player Spawn Context	Byte	Enum: 0 = ReviveFromDeath, 1 = SpawningIntoWorld, 2 = RecallFromItem, 3 = TeamSwap

Update Player [13]

Server <-> Client (Sync)

Size	Description	Type	Notes
1	Player ID	Byte	-
1	Control	Byte	BitFlags: 1 = ControlUp, 2 = ControlDown, 4 = ControlLeft, 8 = ControlRight, 16 = ControlJump, 32 = ControlUseItem, 64 = Direction, 128 = ControlDash
1	Info 1	Byte	BitFlags: 1 = Pulley Enabled, 2 = Direction, 4 = UpdateVelocity, 8 = VortexStealthActive, 16 = GravityDirection, 32 = ShieldRaised, 64 = Ghost, 128 = SetMount
1	Info 2	Byte	BitFlags: 1 = HoveringUp, 2 = VoidVaultEnabled, 4 = Sitting, 8 = DownedDD2Event, 16 = IsPettingAnimal, 32 = IsPettingSmallAnimal, 64 = UsedPotionofReturn, 128 = HoveringDown
1	Info 3	Byte	BitFlags: 1 = PlayerSleeping, 2 = AutoReuseAllWeapons, 4 = ControlDownHold, 8 = IsOperatingAnotherEntity, 16 = ControlUseTile, 32 = NetCameraTarget, 64 = LastItemUseAttemptSuccess, 128 = AccSnappingStoneLightUp
1	Selected Item	Byte	-
4	Position X	Single	-
4	Position Y	Single	-
4	Velocity X	Single	Only sent if UpdateVelocity flag is true
4	Velocity Y	Single	Only sent if UpdateVelocity flag is true
2	Mount ID	UInt16	Only sent if SetMount flag is true
4	Original Position X	Single	Original Position for Potion of Return, only sent if UsedPotionofReturn flag is true
4	Original Position Y	Single	Original Position for Potion of Return, only sent if UsedPotionofReturn flag is true
4	Home Position X	Single	Home Position for Potion of Return, only sent if UsedPotionofReturn flag is true
4	Home Position Y	Single	Home Position for Potion of Return, only sent if UsedPotionofReturn flag is true
4	Camera Target X	Single	Only sent if NetCameraTarget flag is true
4	Camera Target Y	Single	Only sent if NetCameraTarget flag is true

Player Active [14]

Server -> Client

Size	Description	Type	Notes
1	Player ID	Byte	-
1	Active	Byte	-

Null [15]

Never sent

Size	Description	Type	Notes

Player HP [16]

Server <-> Client (Sync)

Size	Description	Type	Notes
1	Player ID	Byte	-
2	HP	Int16	-
2	Max HP	Int16	-

Modify Tile [17]

Server <-> Client (Sync)

Size	Description	Type	Notes
1	Action	Byte	Values: 0 = KillTile, 1 = PlaceTile, 2 = KillWall, 3 = PlaceWall, 4 = KillTileNoItem, 5 = PlaceWire, 6 = KillWire, 7 = PoundTile, 8 = PlaceActuator, 9 = KillActuator, 10 = PlaceWire2, 11 = KillWire2, 12 = PlaceWire3, 13 = KillWire3, 14 = SlopeTile, 15 = FrameTrack, 16 = PlaceWire4, 17 = KillWire4, 18 = PokeLogicGate, 19 = Actuate, 20 = KillTile, 21 = ReplaceTile, 22 = ReplaceWall, 23 = SlopePoundTile
2	Tile X	Int16	-
2	Tile Y	Int16	-
2	Flags1	Int16	KillTile (Fail: Bool), PlaceTile (Type: Byte), KillWall (Fail: Bool), PlaceWall (Type: Byte), KillTileNoItem (Fail: Bool), SlopeTile (Slope: Byte), ReplaceTile (Type: UInt16), ReplaceWall (Type: UInt16)
1	Flags2	Byte	PlaceTile (Style: Byte), ReplaceTile (Style: Byte)

Time [18]

Server -> Client

Size	Description	Type	Notes
1	DayTime	Boolean	-
4	TimeValue	Int32	-
2	SunModY	Int16	-
2	MoonModY	Int16	-

Door Toggle [19]

Server <-> Client (Sync)

Size	Description	Type	Notes
1	Action	Byte	0 = Open Door, 1 = Close Door, 2 = Open Trapdoor, 3 = Close Trapdoor, 4 = Open Tall Gate, 5 = Close Tall Gate
2	Tile X	Int16	-
2	Tile Y	Int16	-
1	Direction	Byte	If (Action == 0) then (if (Direction == -1) then OpenToLeft else OpenToRight) if (Action == 2) then (if (Direction == 1) then PlayerIsAboveTrapdoor) if (Action == 3) then (if (Direction == 1) then PlayerIsAboveTrapdoor)

Send Tile Square [20]

Server <-> Client (Sync)

Size	Description	Type	Notes
2	Tile X	Int16	-
2	Tile Y	Int16	-
1	Size X	Byte	-
1	Size Y	Byte	-
1	TileChangeType	Byte	Enum: 0 = None, 1 = LavaWater, 2 = HoneyWater, 3 = HoneyLava, 4 = ShimmerWater, 5 = ShimmerLava, 6 = ShimmerHoney
?	Tiles	-	-

Item Drop [21]

Server <-> Client (Sync)

Size	Description	Type	Notes
2	Item ID	Int16	If below 400 and NetID 0 Then Set NullIf ItemID is 400 Then New Item
4	Position X	Single	-
4	Position Y	Single	-
4	Velocity X	Single	-
4	Velocity Y	Single	-
2	Stack	Int16	-
1	Prefix	Byte	-
1	Flags	Byte	4 = Shimmered, 8 = Enemy Grab Delay Time
2	Item NetID	Int16	-
1	Shimmered	Boolean	Only sent if Shimmered flag is true
1	Shimmer Time	Single	Only sent if Shimmered flag is true
1	Enemy Grab Delay Time	Byte	Only sent if Enemy Grab Delay Time flag is true

Item Owner [22]

Server -> Client

Size	Description	Type	Notes
2	Item Index	Int16	-
1	Player ID	Byte	-
2	Time to Keep Reservation	Byte * 2 (7 Bit Encoded Int)	-
1	Grab Delay Player	Byte	-
2	Grab Delay Time	Byte * 2 (7 Bit Encoded Int)	-
4	Position X	Single	-
4	Position Y	Single	-

NPC Update [23]

Server -> Client

Size	Description	Type	Notes
1	NPC ID	Byte	-
1	NPC Generation	Byte	-
4	Position X	Single	-
4	Position Y	Single	-
4	Velocity X	Single	-
4	Velocity Y	Single	-
2	Target	UInt16	Player ID
1	NPC Flags 1	Byte	BitFlags: 1 = Direction, 2 = DirectionY, 4 = AI[0], 8 = AI[1], 16 = AI[2], 32 = AI[3], 64 = SpriteDirection, 128 = LifeMax
1	NPC Flags 2	Byte	BitFlags: 1 = StatsScaled, 2 = SpawnedFromStatue, 4 = StrengthMultiplier, 8 = SpawnNeedsSyncing, 16 = ShimmerTransparency
?	NPC AI	Single[]	Only sent for each true AI flag in NPC Flags 1
2	NPC NetID	Int16	-
1	playerCountForMultiplayerDifficultyOverride	Byte	Only sent if StatsScaled flag is true
4	Strength Multiplier	Single	Only sent if StrengthMultiplier flag is true
1	Life Size Flag	Byte	The size of Life (in bytes), only sent if LifeMax flag is not true
1	Life	SByte	Only sent if Life Size Flag = 1
2	Life	Int16	Only sent if Life Size Flag = 2
4	Life	Int32	Only sent if Life Size Flag = 4
1	ReleaseOwner	Byte	Only present if NPC is catchable

Strike NPC with Held Item [24]

Never sent

Size	Description	Type	Notes

Null [25]

Never sent

Size	Description	Type	Notes

Null [26]

Never sent

Size	Description	Type	Notes

Projectile Update [27]

Server <-> Client (Sync)

Size	Description	Type	Notes
4	ProjectileKey	Int32	(Spawner, Index, Generation)
4	Position X	Single	-
4	Position Y	Single	-
4	Velocity X	Single	-
4	Velocity Y	Single	-
2	Type	Int16	-
1	ProjFlags1	Byte	BitFlags: 1 = AI[0], 2 = AI[1], 4 = ProjFlags2, 8 = BannerIdToRespondTo, 16 = Damage, 32 = Knockback, 64 = OriginalDamage
1	ProjFlags2	Byte	BitFlags: 1 = AI[2], Only sent if ProjFlags2 flag is true
4	AI 0	Single	Only sent if AI[0] flag is true
4	AI 1	Single	Only sent if AI[1] flag is true
2	BannerIdToRespondTo	UInt16	Only sent if BannerIdToRespondTo flag is true
2	Damage	Int16	Only sent if Damage flag is true
4	Knockback	Single	Only sent if Knockback flag is true
2	Original Damage	Int16	Only sent if OriginalDamage flag is true
4	AI 2	Single	Only sent if AI[2] flag is true

NPC Strike [28]

Server <-> Client (Sync)

Size	Description	Type	Notes
1	NPC ID	Byte	-
1	NPC Generation	Byte	-
2	Damage	Int16	-1 = Kill
4	Knockback	Single	-
1	Hit Direction	Byte	-
1	Crit	Byte	-

Destroy Projectile [29]

Server <-> Client (Sync)

Size	Description	Type	Notes
2	Projectile ID	Int16	-
1	Owner	Byte	Player ID

Toggle P V P [30]

Server <-> Client (Sync)

Size	Description	Type	Notes
1	Player ID	Byte	-
1	PVP Enabled	Boolean	-

Open Chest [31]

Client -> Server

Size	Description	Type	Notes
2	Tile X	Int16	-
2	Tile Y	Int16	-

Packet [31] is always used to "open" a world chest (that is, an item container placed in the world). When this packet is received the server will send the chest's contents, and sync the active chest ID to the player using packet [33].

Update Chest Item [32]

Server <-> Client (Sync)

Size	Description	Type	Notes
2	Chest ID	Int16	-
1	Item Slot	Byte	-
2	Stack	Int16	-
1	Prefix	Byte	-
2	Item Net ID	Int16	-

Sync Active Chest [33]

Server <-> Client (Sync)

Size	Description	Type	Notes
2	Chest ID	Int16	-
2	Chest X	Int16	-
2	Chest Y	Int16	-
1	Name Length	Byte	-
?	Chest Name	String	Only if length > 0 && <= 20

This packet is used to tell the server that you've exited the chest view (sending ID -1), that you're looking at your piggy bank (sending ID -2), that you're looking at your safe (sending ID -3) and that you're looking at your defender's forge (sending ID -4). Those are sent at every chest interaction. Packet [33]'s main function is to synchronize the sending client's active chest to the server, and its side function is to rename the chest.
It should be noted that this packet is not sent when you open a regular chest. The server knows which chest you opened when you send [31], so the [33] is only sent upon exit to unblock the chest (as opposed to both open & exit for banks like piggy, safe & defender forge)

PlaceChest [34]

Server <-> Client

Size	Description	Type	Notes
1	Action	Byte	BitFlags: 0 = Place Chest, 1 = Kill Chest, 2 = Place Dresser, 3 = Kill Dresser. 4 = Place Containers2, 5 = Kill Containers2
2	Tile X	Int16	-
2	Tile Y	Int16	-
2	Style	Int16	FrameX(Chest type)
2	Chest ID to destroy	Int16	ID if client is receiving packet, else 0

Heal Effect [35]

Server <-> Client (Sync)

Size	Description	Type	Notes
1	Player ID	Byte	-
2	Heal Amount	Int16	-

Player Zone [36]

Server <-> Client (Sync)

Size	Description	Type	Notes
1	Player ID	Byte	-
1	ZoneFlags1	Byte	1 = Dungeon, 2 = Corruption, 4 =Holy, 8 = Meteor, 16 = Jungle, 32 = Snow, 64 = Crimson, 128 = Water Candle
1	ZoneFlags2	Byte	1 = Peace Candle, 2 = Solar Tower, 4 = Vortex Tower, 8 = Nebula Tower, 16 = Stardust Tower, 32 = Desert, 64 = Glowshroom, 128 = Underground Desert
1	ZoneFlags3	Byte	1 = Sky, 2 = Overworld, 4 = Dirt Layer, 8 = Rock Layer, 16 = Underworld, 32 = Beach, 64 = Rain, 128 = Sandstorm
1	ZoneFlags4	Byte	1 = Old One's Army, 2 = Granite, 4 = Marble, 8 = Hive, 16 = Gem Cave, 32 = Lihzhard Temple, 64 = Graveyard, 128 = Shadow Candle
1	ZoneFlags5	Byte	1 = Shimmer
1	Town NPCs Count	Byte	-

Request Password [37]

Server -> Client

Size	Description	Type	Notes

Send Password [38]

Client -> Server

Size	Description	Type	Notes
?	Password	String	-

Remove Item Owner [39]

Server -> Client

Size	Description	Type	Notes
2	Item Index	Int16	-
1	Force Assign to Server	Boolean	-

Set Active NPC [40]

Server <-> Client (Sync)

Size	Description	Type	Notes
1	Player ID	Byte	-
2	NPC Talk Target	Int16	-

Player Item Animation [41]

Server <-> Client (Sync)

Size	Description	Type	Notes
1	Player ID	Byte	-
4	Item Rotation	Single	-
2	Item Animation	Int16	-

Player Mana [42]

Server <-> Client (Sync)

Size	Description	Type	Notes
1	Player ID	Byte	-
2	Mana	Int16	-
2	Max Mana	Int16	-

Mana Effect [43]

Server <-> Client (Sync)

Size	Description	Type	Notes
1	Player ID	Byte	-
2	Mana Amount	Int16	-

Null [44]

Never sent

Size	Description	Type	Notes

Player Team [45]

Server <-> Client (Sync)

Size	Description	Type	Notes
1	Player ID	Byte	-
1	Team	Byte	-

Request Sign [46]

Client -> Server

Size	Description	Type	Notes
2	X	Int16	-
2	Y	Int16	-

Update Sign [47]

Updates sign if sent from client otherwise displays sign to client.

Size	Description	Type	Notes
2	Sign ID	Int16	-
2	X	Int16	-
2	Y	Int16	-
?	Text	String	-
1	Player ID	Byte	-
1	SignFlags	Byte	BitFlags: 1 = Tombstone

Set Liquid [48]

Server <-> Client (Sync)

Size	Description	Type	Notes
2	X	Int16	-
2	Y	Int16	-
1	Liquid	Byte	-
1	Liquid Type	Byte	-

Complete Connection and Spawn [49]

Server -> Client

Size	Description	Type	Notes
-	-	-	-

Update Player Buff [50]

Server <-> Client (Sync)

Size	Description	Type	Notes
1	Player ID	Byte	-
2	BuffType	UInt16	Sender loops through Player.maxBuffs[44] and sends if player.buffType[i] > 0
2	End	UInt16	Sends a "0" value for receiver to stop reading

Special NPC Effect [51]

Server <-> Client (Sync)

Size	Description	Type	Notes
1	Player ID	Byte	-
1	Type	Byte	Values: 1 = Spawn Skeletron, 2 = Cause sound at player, 3 = Start Sundialing (if server is receiving), 4 = BigMimcSpawnSmoke, 5 = Register Torch God in Bestiary (from client when they use the item), 6 = Start Moondialing (if server is receiving)

Unlock [52]

Server <-> Client (Sync)

Size	Description	Type	Notes
1	Type	Byte	Values: 1 = Chest Unlock, 2 = Door Unlock
2	X	Int16	-
2	Y	Int16	-

Add NPC Buff [53]

Server <-> Client (Sync)

Size	Description	Type	Notes
2	NPC ID	Int16	-
2	Buff	UInt16	-
2	Time	Int16	-

Update NPC Buff [54]

Server -> Client

Size	Description	Type	Notes
2	NPC ID	Int16	-
2	Buff Type	UInt16	Server loops through NPC.maxBuffs[20] and only sends if Buff Type > 0 and Buff Time > 0
2	Buff Time	UInt16	Server loops through NPC.maxBuffs[20] and only sends if Buff Type > 0 and Buff Time > 0
2	End	UInt16	Sends a "0" value for client to stop reading

Add Player Buff [55]

Server <-> Client (Sync)

Size	Description	Type	Notes
1	Player ID	Byte	-
2	Buff	UInt16	-
4	Time	Int32	-

Update NPC Name [56]

Server <-> Client (Sync)

Size	Description	Type	Notes
2	NPC ID	Int16	-
?	Name	String	Only if client is receiving packet
4	TownNpcVariationIndex	Int32	Only if client is receiving packet

Update Good Evil [57]

Server -> Client

Size	Description	Type	Notes
1	Good	Byte	-
1	Evil	Byte	-
1	Crimson	Byte	-

Play Music Item [58]

Server <-> Client (Sync)

Size	Description	Type	Notes
1	Player ID	Byte	-
4	Note	Single	-

Hit Switch [59]

Server <-> Client (Sync)

Size	Description	Type	Notes
2	X	Int16	-
2	Y	Int16	-

NPC Home Update [60]

Server <-> Client (Sync)

Size	Description	Type	Notes
2	NPC ID	Int16	-
2	Home Tile X	Int16	-
2	Home Tile Y	Int16	-
1	Status	Byte	1 = Remove Home, 2 = Set Home

Spawn Boss Invasion [61]

Client -> Server

Size	Description	Type	Notes
2	Player ID	Int16	-
2	Type	Int16	Negative Values: -1 = GoblinInvasion, -2 = FrostInvasion, -3 = PirateInvasion, -4 = PumpkinMoon, -5 = SnowMoon, -6 = Eclipse, -7 = Martian Moon, -8 = Impending Doom, -10 = Blood Moon, -11 = Combat Book Used, -12 = Bought Cat, -13 = Bought Dog, -14 = Bought Bunny, -15 = Bought Blue Slime, -16 = MechQueen, -17 = Combat Book Volume Two Used, -18 = Peddler's Satchel Used, -19 = Slime Rain, Positive Values: Spawns any of these NPCs: 4, 13, 50, 126, 125, 134, 127, 128, 131, 129, 130, 222, 245, 266, 370, 657, 668

Player Dodge [62]

Server <-> Client (Sync)

Size	Description	Type	Notes
1	Player ID	Byte	-
1	Dodge Type	Byte	1 = Ninja Dodge 2 = Shadow Dodge, 4 = Brain of Confusion Dodge

Paint Tile [63]

Server <-> Client (Sync)

Size	Description	Type	Notes
2	X	Int16	-
2	Y	Int16	-
1	Color	Byte	-
1	Coating	Byte	0 = Neither, 1 = Full Bright, 2 = Invisible

Paint Wall [64]

Server <-> Client (Sync)

Size	Description	Type	Notes
2	X	Int16	-
2	Y	Int16	-
1	Color	Byte	-
1	Coating	Byte	0 = Neither, 1 = Full Bright, 2 = Invisible

Player NPC Teleport [65]

Server <-> Client (Sync)

Size	Description	Type	Notes
1	Flags	Byte	BitFlags: 0 = Player Teleport (Neither 1 or 2), 1 = NPC Teleport, 2 = Player Teleport to Other Player, 4 = GetPositionFromTarget, 8 = HasExtraInfo
2	Target ID	Int16	-
4	X	Single	-
4	Y	Single	-
1	Style	Byte	-
4	ExtraInfo	Int32	Only sent if HasExtraInfo flag is true

Heal Other Player [66]

Server <-> Client (Sync)

Size	Description	Type	Notes
1	Player ID	Byte	-
2	Heal Amount	Int16	-

Null [67]

Never sent

Size	Description	Type	Notes

Client UUID [68]

Client -> Server

Size	Description	Type	Notes
?	UUID	String	-

Get Chest Name [69]

Server <-> Client (Sync)

Size	Description	Type	Notes
2	Chest ID	Int16	-
2	Chest X	Int16	-
2	Chest Y	Int16	-
?	Name	String	-

Catch NPC [70]

Client -> Server

Size	Description	Type	Notes
2	NPC ID	Int16	-
1	Player ID	Byte	-

Release NPC [71]

Client -> Server

Size	Description	Type	Notes
4	X	Int32	-
4	Y	Int32	-
2	NPC Type	Int16	-
1	Style	Byte	Sent to NPC AI[2]

Travelling Merchant Inventory [72]

Server -> Client

Size	Description	Type	Notes
2*40	Items	Int16[40]	Each short related to an item type NetID.

Teleportation Potion [73]

Server <-> Client

Size	Description	Type	Notes
1	Type	By 0 = Teleportation Potion, 1 = Magic Conch, 2 = Demon Conch, 3 = Shellphone, 4 = Teleportation due to no space at destination = =

Angler Quest [74]

Server -> Client

Size	Description	Type	Notes
1	Quest	Byte	-
1	Completed	Boolean	-

Complete Angler Quest Today [75]

Client -> Server

Size	Description	Type	Notes

Number Of Angler Quests Completed [76]

Client -> Server

Size	Description	Type	Notes
1	Player ID	Byte	-
4	Angler Quests Completed	Int32	-
4	Golfer Score	Int32	-

Create Temporary Animation [77]

Server -> Client

Size	Description	Type	Notes
2	Animation Type	Int16	-
2	Tile Type	UInt16	-
2	X	Int16	-
2	Y	Int16	-

Report Invasion Progress [78]

Server -> Client

Size	Description	Type	Notes
4	Progress	Int32	-
4	Max Progress	Int32	-
1	Icon	SByte	-
1	Wave	SByte	-

Place Object [79]

Server <-> Client

Size	Description	Type	Notes
2	X	Int16	-
2	Y	Int16	-
2	Type	Int16	-
2	Style	Int16	-
1	Alternate	Byte	-
1	Random	SByte	-
1	Direction	Boolean	-

Sync Player Chest Index [80]

Server -> Client

Size	Description	Type	Notes
1	Player	Byte	-
2	Chest	Int16	-

Create Combat Text [81]

Server -> Client

Size	Description	Type	Notes
4	X	Single	-
4	Y	Single	-
3	Color	Color	-
4	Heal Amount	Int32	-

Load Net Module [82]

Server <-> Client

Offset	Size	Description	Type	Notes
3	2	Net Module ID/Type	UInt16	Net Modules
5	?	Net Module Data	?	-

Note: 82 is sent prior to chat packets in 1.3.5.x. Instructs the server to load a net module.

NPC Kill Count [83]

Never sent

Size	Description	Type	Notes

Set Player Stealth [84]

Server <-> Client (Sync)

Size	Description	Type	Notes
1	Player	Byte	-
4	Stealth	Single	-

Force Item Into Nearest Chest [85]

Client -> Server

Size	Description	Type	Notes
4	Number of Items	Int32	-
2 * numItems	Slot ID	Int16 * numItems	-
1	Smart Stack	Boolean	-

Server -> Client

Size	Description	Type	Notes
4	Number of Items	Int32	-
2 * numItems	Blocked Chests	UInt16 * numItems	-

Update Tile Entity [86]

Server -> Client

Size	Description	Type	Notes
4	TileEntityId	Int32	-
1	UpdateTileFlag	Boolean	If UpdateTileFlag is false, TileEntity is removed
1	TileEntity Type	Byte	Only sent if UpdateTileFlag is false
2	X	Int16	Only sent if UpdateTileFlag is false
2	Y	Int16	Only sent if UpdateTileFlag is false

Place Tile Entity [87]

Client -> Server

Size	Description	Type	Notes
2	X	Int16	-
2	Y	Int16	-
1	TileEntityType	Byte	-

Tweak Item [88]

Server -> Client

Size	Description	Type	Notes
2	Item Index	Int16	-
1	Flags1	Byte	BitFlags: 1 = Color, 2 = Damage, 4 = Knockback, 8 = UseAnimation, 16 = UseTime, 32 = Shoot, 64 = ShootSpeed, 128 = NextFlags
4	Packed Color Value	UInt32	if Flags1.Color
2	Damage	UInt16	if Flags1.Damage
4	Knockback	Single	if Flags1.Knockback
2	Use Animation	UInt16	if Flags1.UseAnimation
2	Use Time	UInt16	if Flags1.UseTime
2	Shoot	Int16	if Flags1.Shoot
4	ShootSpeed	Float	if Flags1.ShootSpeed
1	Flags2	Byte	if Flags1.NextFlags, BitFlags: 1 = Width, 2 = Height, 4 = Scale, 8 = Ammo, 16 = UseAmmo, 32 = NotAmmo
2	Width	Int16	if Flags2.Width
2	Height	Int16	if Flags2.Height
4	Scale	Float	if Flags2.Scale
2	Ammo	Int16	If Flags2.Ammo
2	UseAmmo	Int16	If Flags2.UseAmmo
1	NotAmmo	Bool	If Flags2.NotAmmo

Place Item Frame [89]

Client -> Server

Size	Description	Type	Notes
2	X	Int16	-
2	Y	Int16	-
2	ItemId	Int16	-
1	Prefix	Byte	-
2	Stack	Int16	-

Update Item Drop [90]

Server <-> Client (Sync)

Size	Description	Type	Notes
2	Item ID	Int16	If below 400 and NetID 0 Then Set NullIf ItemID is 400 Then New Item
4	Position X	Single	-
4	Position Y	Single	-
4	Velocity X	Single	-
4	Velocity Y	Single	-
2	Stack	Int16	-
1	Prefix	Byte	-
1	Flags	Byte	4 = Shimmered, 8 = Enemy Grab Delay Time
2	Item NetID	Int16	-
1	Shimmered	Boolean	Only sent if Shimmered flag is true
1	Shimmer Time	Single	Only sent if Shimmered flag is true
1	Enemy Grab Delay Time	Byte	Only sent if Enemy Grab Delay Time flag is true

Sync Emote Bubble [91]

Server -> Client

Size	Description	Type	Notes
4	Emote ID	Int32	-
1	Anchor Type	Byte	-
2	Player ID	UInt16	Only sent if AnchorType != 255
2	Emote LifeTime	UInt16	Only sent if AnchorType != 255
1	Emote	Byte	Only sent if AnchorType != 255
2	Emote MetaData	Int16	Only sent if AnchorType != 255 and Emote < 0

Sync Extra Value [92]

Server <-> Client (Sync)

Size	Description	Type	Notes
2	NPC Index	Int16	-
4	Extra Value	Int32	-
4	X	Single	-
4	Y	Single	-

Social Handshake [93]

Never sent

Size	Description	Type	Notes

Debug Commands [94]

Not sent

Size	Description	Type	Notes
?	Command	String	"/showdebug", "/raindomizeprojslots", "/setserverping", "/quickload-clientprobe", "/quickload-clientresp [...]"
4	Remote Client	Int32
4	Command Data	Single	Sets debug options
4	-	Single	-

Kill Portal [95]

Client -> Server

Size	Description	Type	Notes
2	Projectile Owner	UInt16	-
1	Projectile AI	Byte	-

Player Teleport Portal [96]

Server <-> Client

Size	Description	Type	Notes
1	Player ID	Byte	-
2	Portal Color Index	Int16	-
4	New Position X	Single	-
4	New Position Y	Single	-
4	Velocity X	Single	-
4	Velocity Y	Single	-

Notify Player NPC Killed [97]

Server -> Client

Size	Description	Type	Notes
2	NPC ID	Int16	-

Notify Player Of Event [98]

Server -> Client

Size	Description	Type	Notes
2	Event ID	Int16	-

Update Minion Target [99]

Server <-> Client (Sync)

Size	Description	Type	Notes
1	Player ID	Byte	-
4	Target X	Single	-
4	Target Y	Single	-

NPC Teleport Portal [100]

Server <-> Client

Size	Description	Type	Notes
2	NPC ID	UInt16	-
2	Portal Color Index	Int16	-
4	New Position X	Single	-
4	New Position Y	Single	-
4	Velocity X	Single	-
4	Velocity Y	Single	-

Update Shield Strengths [101]

Server -> Client

Size	Description	Type	Notes
2	Solar Tower Shield Strength	UInt16	-
2	Vortex Tower Shield Strength	UInt16	-
2	Nebula Tower Shield Strength	UInt16	-
2	Stardust Tower Shield Strength	UInt16	-

Nebula Level Up [102]

Server <-> Client (Sync)

Size	Description	Type	Notes
1	Player ID	Byte	-
2	Level Up Type	UInt16	-
4	Origin X	Single	In world coordinate pixels.
4	Origin Y	Single	In world coordinate pixels.

Moon Lord Countdown [103]

Server -> Client

Size	Description	Type	Notes
4	Moon Lord Countdown Max	Int32	-
4	Moon Lord Countdown	Int32	-

NPC Shop Item [104]

Server -> Client

Size	Description	Type	Notes
1	Slot	Byte	-
2	Item Type	Int16	-
2	Stack	Int16	-
1	Prefix	Byte	-
4	Value	Int32	-
1	Flags	Byte	BitFlags: 1 = BuyOnce

Gem Lock Toggle [105]

Client -> Server

Size	Description	Type	Notes
2	X	Int16	-
2	Y	Int16	-
1	On	Boolean	-

Poof of Smoke [106]

Server -> Client

Size	Description	Type	Notes
4	PackedVector	UInt32	Two Int16's packed into 4 bytes.

Smart Text Message [107]

Server -> Client

Size	Description	Type	Notes
3	Message Color	Color	Client cannot change colors
?	Message	NetworkText	-
2	Message Length	Int16	-

Wired Cannon Shot [108]

Server -> Client

Size	Description	Type	Notes
2	Damage	Int16	-
4	Knockback	Single	-
2	X	Int16	-
2	Y	Int16	-
2	Angle	Int16	-
2	Ammo	Int16	-
1	Player ID	Byte	Shooter's Player ID

Mass Wire Operation [109]

Client -> Server

Size	Description	Type	Notes
2	Start X	Int16	-
2	Start Y	Int16	-
2	End X	Int16	-
2	End Y	Int16	-
1	ToolMode	Byte	BitFlags: 1 = Red, 2 = Green, 4 = Blue, 8 = Yellow, 16 = Actuator, 32 = Cutter

Mass Wire Operation Consume [110]

Server -> Client

Size	Description	Type	Notes
2	Item Type	Int16	-
2	Quantity	Int16	-
1	Player ID	Byte	-

Toggle Birthday Party [111]

Client -> Server

Size	Description	Type	Notes

GrowFX [112]

Server <-> Client (Sync)

Size	Description	Type	Notes
1	EffectFlags	Byte	1 = Tree Growth Effects, 2 = Fairy Effects
4	X	Int32	-
4	Y	Int32	-
1	Data	Byte	if EffectFlag is TreeGrowth, data is Height; if EffectFlag is Fairy Effects, data is effect Type
2	Tree Gore	Int16	Always 0 unless it is TreeGrowth
1	Hit Tree	Byte	-

CrystalInvasionStart [113]

Client -> Server

Size	Description	Type	Notes
2	X	Int16	-
2	Y	Int16	-

CrystalInvasionWipeAll [114]

Server -> Client

Size	Description	Type	Notes

MinionAttackTargetUpdate [115]

Client -> Server

Size	Description	Type	Notes
1	Player ID	Byte	-
2	Minion Attack Target	Int16	-

CrystalInvasionSendWaitTime [116]

Server -> Client

Size	Description	Type	Notes
4	Time Until Next Wave	Int32	1800 (30s) between waves, 30 (5s) when starting

PlayerHurtV2 [117]

Client -> Server

Size	Description	Type	Notes
1	Player ID	Byte	-
?	Player Death Reason	PlayerDeathReason	-
2	Damage	Int16	-
1	Hit Direction	Byte	-
1	Flags	Byte	BitFlags: 1 = Crit, 2 = PvP
1	Cooldown Counter	SByte	-

PlayerDeathV2 [118]

Client -> Server

Size	Description	Type	Notes
1	Player ID	Byte	-
?	Player Death Reason	PlayerDeathReason	-
2	Damage	Int16	-
1	Hit Direction	Byte	-
1	Flags	Byte	BitFlags: 1 = PvP

CombatTextString [119]

Server -> Client

Size	Description	Type	Notes
4	X	Single	-
4	Y	Single	-
3	Color	Color	-
?	Combat Text	NetworkText	-

Emoji [120]

Client -> Server

Size	Description	Type	Notes
1	Player Index	Byte	-
1	Emoticon ID	Byte	-

TileEntity Display Doll Item Sync [121]

Client <-> Server

Size	Description	Type	Notes
1	Player ID	Byte	-
4	TileEntity ID	Int32	-
1	Item Index	Byte	-
1	Command	Byte	1 = Dyes, 2 = Pose, 3 = Misc
1	Pose	Byte	Only sent if Command = Pose
2	Item ID	UInt16	-
2	Stack	UInt16	-
1	Prefix	Byte	-

Request TileEntity Interaction [122]

Client <-> Server

Size	Description	Type	Notes
4	TileEntityID	Int32	-
1	Player ID	Byte	-

Weapons Rack Try Placing [123]

Client -> Server

Size	Description	Type	Notes
2	X	Int16	-
2	Y	Int16	-
2	Net ID	Int16	-
1	Prefix	Byte	-
2	Stack	Int16	-

TileEntity Hat Rack Item Sync [124]

Client <-> Server

Size	Description	Type	Notes
1	Player ID	Byte	-
4	TileEntityID	Int32	-
1	Item Index	Byte	-
2	Item ID	UInt16	-
2	Stack	UInt16	-
1	Prefix	Byte	-

Sync Tile Picking [125]

Client <-> Server

Size	Description	Type	Notes
1	Player ID	Byte	-
2	X	Int16	-
2	Y	Int16	-
1	Pick Damage	Byte	-

Sync Revenge Marker [126]

Server -> Client

Size	Description	Type	Notes
4	Unique ID	Int32	-
4	X	Single	-
4	Y	Single	-
4	NPC ID	Int32	-
4	NPC HP Percent	Single	-
4	NPC Type	Int32	-
4	NPC AI Style	Int32	-
4	Coin Value	Int32	-
4	Base Value	Single	-
1	SpawnedFromStatue	Boolean	-

Remove Revenge Marker [127]

Server -> Client

Size	Description	Type	Notes
4	Unique ID	Int32	-

Land Golf Ball In Cup [128]

Client <-> Server

Size	Description	Type	Notes
1	Player ID	Byte	-
2	X	UInt16	-
2	Y	UInt16	-
2	Number of Hits	UInt16	-
2	Proj ID	UInt16	-

Finished Connecting To Server [129]

Server -> Client

Size	Description	Type	Notes

Fish Out NPC [130]

Client -> Server

Size	Description	Type	Notes
2	X	UInt16	-
2	Y	UInt16	-
2	NPC ID	Int16	-

Tamper With NPC [131]

Server -> Client

Size	Description	Type	Notes
2	NPC ID	UInt16	-
1	SetNPCImmunity	Byte	-
4	Immunity Time	Int32	Only sent if SetNPCImmunity flag is true
2	Immunity Player ID	Int16	Set to -1 for immunity from all players

Play Legacy Sound [132]

Server -> Client

Size	Description	Type	Notes
4	X	Single	-
4	Y	Single	-
2	Legacy Sound ID	UInt16	-
1	Sound Flags	Byte	BitFlags: 1 = New Sound Style, 2 = New Sound Volume, 3 = New Sound Pitch Offset
4	Sound Style	Int32	Only sent if New Sound Style is true
4	Sound Volume	Single	Only sent if New Sound Volume is true
4	Sound Pitch Offset	Single	Only sent if New Sound Pitch Offset is true

Food Platter Try Placing [133]

Client -> Server

Size	Description	Type	Notes
2	X	Int16	-
2	Y	Int16	-
2	Item ID	Int16	-
1	Prefix	Byte	-
2	Stack	Int16	-

Update Player Luck Factors [134]

Client <-> Server

Size	Description	Type	Notes
1	Player ID	Byte	-
4	Ladybug Luck Time Remaining	Int32	-
4	Torch Luck	Single	-
1	Luck Potion	Byte	-
1	Has Garden Gnome Nearby	Boolean	-
1	Broken Mirror Bad Luck	Boolean	-
4	Equipment-Based Luck Bonus	Single	-
4	Coin Luck	Single	-
1	Kite Luck Level	Byte	-

Dead Player [135]

Server -> Client

Size	Description	Type	Notes
1	Player ID	Byte	-

Sync Cavern Monster Type [136]

Client <-> Server

Size	Description	Type	Notes
2	Net ID	UInt16	NPC.cavernMonsterType[0,0]
2	Net ID	UInt16	NPC.cavernMonsterType[0,1]
2	Net ID	UInt16	NPC.cavernMonsterType[0,2]
2	Net ID	UInt16	NPC.cavernMonsterType[1,0]
2	Net ID	UInt16	NPC.cavernMonsterType[1,1]
2	Net ID	UInt16	NPC.cavernMonsterType[1,2]

Request NPC Buff Removal [137]

Client -> Server

Size	Description	Type	Notes
2	NPC ID	Int16	-
2	Buff ID	UInt16	-

Client Finished Inventory Changes On This Tick [138]

Client -> Server

Size	Description	Type	Notes

Sent by the client code in TrySyncingMyPlayer twice when a player moves an item around in their inventory. Packet actually has no data. Total payload size is 2 packets per inventory item drag, with 3 bytes each (2 for length, 1 for packet ID). This is a functionally useless packet.

Set CountsAsHostForGameplay [139]

Server -> Client

Size	Description	Type	Notes
1	Player ID	Byte	-
1	countsAsHostForGameplay	Boolean	-

Set Misc Event Values [140]

Server -> Client

Size	Description	Type	Notes
1	Event Type	Byte	0 = Credits Roll Event, 1 = Transform Copper Slime, 2 = Transform Elder Slime
4	Event Data	Int32	Remaining time for Credits Roll Event; NPC ID for Transform Copper/Elder Slime events

Request Lucy Popup [141]

Client <-> Server

Size	Description	Type	Notes
1	Message Source	Byte	0 = Idle, 1 = Storage, 2 = ThrownAway, 3 = PixedUp, 4 = ChoppedTree, 5 = ChoppedGemTree, 6 = ChoppedCactus, 7 = Count
1	Variation	Byte	-
4	Velocity X	Single	-
4	Velocity Y	Single	-
4	Position X	Int32	-
4	Position Y	Int32	-

Sync Projectile Trackers [142]

Client <-> Server

Size	Description	Type	Notes
1	Player ID	Byte	-
2	Flying Piggy Bank Owner ID	Int16	-
2	Flying Piggy Bank Expected Identity	Int16	Only if Owner ID != -1
2	Flying Piggy Bank Expected Type	Int16	Only if Owner ID != -1
2	Void Lens Owner ID	Int16	-
2	Void Lens Expected Identity	Int16	Only if Owner ID != -1
2	Void Lens Expected Type	Int16	Only if Owner ID != -1

Crystal Invasion Requested To Skip Wait Time [143]

Client -> Server

Size	Description	Type	Notes

Request Quest Effect [144]

Client -> Server

Size	Description	Type	Notes

Sync Items With Shimmer [145]

Not Sent

Size	Description	Type	Notes

Shimmer Actions [146]

Server <-> Client (Sync)

Size	Description	Type	Notes
1	Action Type	Byte	0 = Shimmer, 1 = Coin Luck
4	Shimmer Position X	Single	Only sent if Action Type = Shimmer
4	Shimmer Position Y	Single	Only sent if Action Type = Shimmer
4	Coin Position X	Single	Only sent if Action Type = Coin Luck
4	Coin Position Y	Single	Only sent if Action Type = Coin Luck
4	Coin Amount	Int32	Only sent if Action Type = Coin Luck

Sync Loadout [147]

Server <-> Client (Sync)

Size	Description	Type	Notes
1	Player ID	Byte	-
1	Loadout Index	Byte	-
2	Accessory Visibility	UInt16	Bitwise array for player.hideVisibileAccessory[10]

Sync Item Cannot Be Taken By Enemies [148]

Not Sent

Size	Description	Type	Notes

TE Dead Cells Display Jar [149]

Client -> Server

Size	Description	Type	Notes
2	X	Int16	-
2	Y	Int16	-
2	Type	Int16	-
1	Prefix	Byte	-
2	Stack	Int16	-

Spectate Player [150]

Server <-> Client (Sync)

Size	Description	Type	Notes
1	Player ID	Byte	-
2	Target Player ID	Int16	-

Sync Item Despawn [151]

Server <-> Client (Sync)

Size	Description	Type	Notes
2	Item Index	Int16	-

Item Use Sound [152]

Server <-> Client

Size	Description	Type	Notes
1	Player ID	Byte	-

NPC Hurt By Debuff [153]

Server <-> Client (Sync)

Size	Description	Type	Notes
1	NPC ID	Byte	-
2	Amount	Int16	-

Ping [154]

Server <-> Client

Size	Description	Type	Notes

Sync Chest Size [155]

Server <-> Client (Sync)

Size	Description	Type	Notes
2	Chest ID	Int16	-
2	New Size	Int16	0 < New Size < 8000

TE Leashed Entity Anchor Place Item [156]

Client -> Server

Size	Description	Type	Notes
2	Point X	Int16	-
2	Point Y	Int16	-
2	Item Type	Int16	-

Team Change From UI [157]

Server <-> Client (Sync)

Size	Description	Type	Notes
1	Player ID	Byte	-
1	Team	Byte	-

Extra Spawn Section Loaded [158]

Server -> Client

Size	Description	Type	Notes
1	Player ID	Byte	-

Request Section [159]

Client -> Server

Size	Description	Type	Notes
2	Section X	UInt16	-
2	Section Y	UInt16	-

Sync Item Position [160]

Server -> Client

Size	Description	Type	Notes
2	Item Index	Int16	-
4	Position X	Single	-
4	Position Y	Single	-

Host Token [161]

Client -> Server

Size	Description	Type	Notes
?	Host Token	String	-

Damage NPC Ack [162]

Server -> Client

Size	Description	Type	Notes

Appendix

Color Structure

Size	Description	Type	Notes
1	Red	Byte	-
1	Green	Byte	-
1	Blue	Byte	-

Tile Structure

Size	Description	Type	Notes
1	Tile Flags 1	Byte	BitFlags: 1= Active, 4 = HasWall, 8 = HasLiquid, 16 = Wire1, 32 = HalfBrick, 64 = Actuator, 128 = Inactive
1	Tile Flags 2	Byte	BitFlags: 1 = Wire2, 2 = Wire3, 4 = HasColor, 8 = HasWallColor, 16 = Slope1, 32 = Slope2, 64 = Slope3, 128 = Wire4
1	Tile Flags 3	Byte	BitFlags: 1 = Fullbright Block, 2 = Fullbright Wall, 4 = Invisible Block, 8 = Invisible Wall
1	Color	Byte	Only if HasColor
1	Wall Color	Byte	Only if HasWallColor
2	Type	UInt16	Only if Active
2	FrameX	Int16	Only if Active && tileFrameImportant
2	FrameY	Int16	Only if Active && tileFrameImportant
1	Wall	UInt16	Only if HasWall
1	Liquid	Byte	Only if HasLiquid
1	LiquidType	Byte	Only if HasLiquid

Chest Structure

Size	Description	Type	Notes
2	Index	Int16	-
2	X	Int16	-
2	Y	Int16	-
?	Chest Name	String	-

Sign Structure

Size	Description	Type	Notes
2	Index	Int16	-
2	X	Int16	-
2	Y	Int16	-
?	Sign Text	String	-

TileEntity Structure

Size	Description	Type	Notes
1	Type	Byte	0 = Training Dummy, 1 = Item Frame, 2 = Logic Sensor, 3 = Display Doll, 4 = Weapons Rack, 5 = Hat Rack, 6 = Food Platter, 7 = Teleportation Pylon
4	ID	Int32	-
2	X	Int16	-
2	Y	Int16	-
?	ExtraData	Variable	See TE types below.

TrainingDummy ExtraData

Size	Description	Type	Notes
2	NPC Index	Int16	-

ItemFrame ExtraData

Size	Description	Type	Notes
2	Item Type	Int16	-
1	Item Prefix	Byte	-
2	Item Stack	Int16	-

LogicSensor ExtraData

Size	Description	Type	Notes
1	LogicCheckType	Byte	-
1	On	Bool	-

DisplayDoll ExtraData

Size	Description	Type	Notes
1	Item Flags 1	Byte	BitFlags: 0-8 items in "equip" category
1	Item Flags 2	Byte	BitFlags: 0-8 items in "dyes" category
1	Pose	Byte	-
1	Item Flags 3	Byte	BitFlags: 1 = "misc" item, 2 = 9th item in "equip" category, 4 = 9th item in "dyes" category
2	Item Type	Int16	See note
1	Item Prefix	Byte	See note
2	Item Stack	Int16	See note
2	Dye Type	Int16	See note
1	Dye Prefix	Byte	See note
2	Dye Stack	Int16	See note
2	Misc Item Type	Int16	See note
1	Misc Item Prefix	Byte	See note
2	Misc Item Stack	Int16	See note

Note: Each bit in Item Flags represents the presence of one item on the doll. It will loop through each item in the "equip" category, then the "dyes" category, then the "misc" category, reading the type, prefix, and stack for each corresponding item.

WeaponsRack ExtraData

Size	Description	Type	Notes
2	Item Type	Int16	-
1	Item Prefix	Byte	-
2	Item Stack	Int16	-

HatRack ExtraData

Size	Description	Type	Notes
1	HatFlags	Byte	BitFlags: 0-2 items
2	Item Type	Int16	See note
1	Item Prefix	Byte	See note
2	Item Stack	Int16	See note
2	Dye Type	Int16	See note
1	Dye Prefix	Byte	See note
2	Dye Stack	Int16	See note

Note: Each bit in HatFlags represents the presence of one item on the hat rack. For each item, it will loop through and read the item type, prefix, and stack. Then it will move on to the dyes and read the type, prefix, and stack for the dye items.

FoodPlatter ExtraData

Size	Description	Type	Notes
2	Item Type	Int16	-
1	Item Prefix	Byte	-
2	Item Stack	Int16	-

TeleportationPylon ExtraData

No extra data for TeleportationPylon.

Size	Description	Type	Notes

DeadCellsDisplayJar ExtraData

Size	Description	Type	Notes
2	Item Type	Int16	-
1	Item Prefix	Byte	-
2	Item Stack	Int16	-

KiteAnchor ExtraData

No extra data for KiteAnchor.

Size	Description	Type	Notes

CrittorAnchor ExtraData

No extra data for CrittorAnchor.

Size	Description	Type	Notes

PlayerDeathReason

Size	Description	Type	Notes
1	Player Death Reason	Byte	BitFlags: 1 = Killed via PvP, 2 = Killed via NPC, 4 = Killed via Projectile, 8 = Killed via Other, 16 = Killed via Projectile, 32 = Killed via PvP, 64 = Killed via PvP, 128 = Killed via Custom Modification
2	Killer's Player ID	Int16	Only if BitFlags[0] is true
2	Killing NPC's Index	Int16	Only if BitFlags[1] is true
2	Projectile Index	Int16	Only if BitFlags[2] is true
1	Type of Death (Other)	Byte	Only if BitFlags[3] is true: 0 = Fall Damage, 1 = Drowning, 2 = Lava Damage, 3 = Fall Damage, 4 = Demon Altar, 6 = Companion Cube, 7 = Suffocation, 8 = Burning, 9 = Poison/Venom, 10 = Electrified, 11 = WoF (Escape), 12 = WoF (Licked), 13 = Chaos State, 14 = Chaos State v2 (Male), 15 = Chaos State v2 (Female)
2	Projectile Type	Int16	Only if BitFlags[4] is true
2	Item Type	Int16	Only if BitFlags[5] is true
1	Item Prefix	Byte	Only if BitFlags[6] is true
?	Death Reason	String	Only if BitFlags[7] is true

NetworkText

Size	Description	Type	Notes
1	Mode	Byte	Enum: 0 = Literal, 1 = Formattable, 2 = LocalizationKey
?	Text	String	-
1	SubstitutionList Length	Byte	Only if Mode != Literal
?	SubstitutionList	NetworkText[]	Only if Mode != Literal

ParticleOrchestraSettings

Size	Description	Type	Notes
8	Position	Vector2	-
8	Movement Vector	Vector2	-
4	Unique Info Piece	Int32	Data varies based on type of particle spawn
1	Invoking Player ID	Byte	-

Net Modules

Net Module Format (packet within a packet)

Offset	Size	Description	Type	Notes
0	2	Packet length in bytes	UInt16	-
2	1	Packet Type/ID	UInt8	Use TSAPI's `Packetypes.PacketName` enum for packet ID's
3	2	Net Module ID/Type	UInt16	-
5	?	Net Module Data	?	-

Liquid [0]

Server -> Client

Size	Description	Type	Notes
2	Total changes	UInt16	Number of times the following has been repeated.
4	Position	Int32	Y is the first 2 bytes, X is the last 2 bytes.
1	Liquid Amount	Byte	0-255
1	Liquid Type	Byte	0 = Water, 1 = Lava, 2 = Honey

Text [1]

Client -> Server

Size	Description	Type	Notes
?	Chat Command ID	String	-
?	Chat Message	String	-

Server -> Client

Size	Description	Type	Notes
1	Author Index	Byte	Only 0-254 shows chat above heads. Not sent by client, client's index is used for id.
?	Message Text	NetworkText	-
3	Color	Color	-

Ping [2]

Server <-> Client (Sync)

Size	Description	Type	Notes
8	Position	Vector2	-

Ambience [3]

Server -> Client

Size	Description	Type	Notes
1	Player ID	Byte	Player the effect centers around
4	Seed	Int32	Seed for FastRandom
1	SkyEntity Type	Byte	0 = BirdsV, 1 = Wyvern, 2 = Airship, 3 = AirBalloon, 4 = Eyeball, 5 = Meteor, 6 = BoneSerpent, 7 = Bats, 8 = Butterflies, 9 = LostKite, 10 = Vulture, 11 = PixiePosse, 12 = Seagulls, 13 = SlimeBalloons, 14 = Gastropods, 15 = Pegasus, 16 = EaterOfSouls, 17 = Crimera, 18 = Hellbats

Bestiary [4]

Server -> Client

Size	Description	Type	Notes
1	BestiaryUnlockType	Byte	0 = Kill, 1 = Sight, 2 = Chat
2	NPC NetID	Int16	-
2	Kill Count	Byte * 2 (7 Bit Encoded Int)	Only included if BestiaryUnlockType is Kill

CreativePowers [5]

Server <-> Client (Sync)

Size	Description	Type	Notes
2	Power Type	UInt16	0 = FreezeTime, 1 = StartDayImmediately, 2 = StartNoonImmediately, 3 = StartNightImmediately, 4 = StartMidnightImmediately, 5 = GodmodePower, 6 = ModifyWindDirectionAndStrength, 7 = ModifyRainPower, 8 = ModifyTimeRate, 9 = FreezeRainPower, 10 = FreezeWindDirectionAndStrength, 11 = FarPlacementRangePower, 12 = DifficultySliderPower, 13 = StopBiomeSpreadPower, 14 = SpawnRateSliderPerPlayerPower

Note: There are permission checks in place, but all powers only use CanBeChangedByEveryone so they all pass unless a plugin changes this.

namespace Terraria.GameContent.Creative
{
	public enum PowerPermissionLevel
	{
		LockedForEveryone,       //0 Will always reject
		CanBeChangedByHostAlone, //1 Will only accept if on singleplayer (Main.netMode = 0)
		CanBeChangedByEveryone   //2 Default value for all
	}
}

CreativeUnlocksPlayerReport [6]

Client -> Server

Size	Description	Type	Notes
1	Player ID	Byte	-
2	Item ID	UInt16	-
2	Sacrificed/Researched Item Amount	UInt16	-

TeleportPylon [7]

Server <-> Client (Sync)

Size	Description	Type	Notes
1	Pylon Packet Type	Byte	0 = PylonWasAdded, 1 = PylonWasRemoved, 2 = PlayerRequestsTeleport
2	Position X	Int16	-
2	Position Y	Int16	-
1	Pylon Type	Byte	0 = SurfacePurity, 1 = Jungle, 2 = Hallow, 3 = Underground, 4 = Beach, 5 = Desert, 6 = Snow, 7 = GlowingMushroom, 8 = Victory (Universal Pylon), 9 = Underworld, 10 = Shimmer

Particles [8]

Server <-> Client (Sync)

Size	Description	Type	Notes
1	Particle Type	Byte	69 Types Available
21	ParticleOrchestraSettings	ParticleOrchestraSettings	-

CreativePowerPermissions [9]

Server -> Client

Size	Description	Type	Notes
1	0	Byte	Always zero, value here maybe intended for other potential unlock reports. Within NetCreativePowerPermissionsModule, private const _setPermissionLevelId = 0
2	Power Type	UInt16	0 = FreezeTime, 1 = StartDayImmediately, 2 = StartNoonImmediately, 3 = StartNightImmediately, 4 = StartMidnightImmediately, 5 = GodmodePower, 6 = ModifyWindDirectionAndStrength, 7 = ModifyRainPower, 8 = ModifyTimeRate, 9 = FreezeRainPower, 10 = FreezeWindDirectionAndStrength, 11 = FarPlacementRangePower, 12 = DifficultySliderPower, 13 = StopBiomeSpreadPower, 14 = SpawnRateSliderPerPlayerPower
1	Power Level	Byte	0 = LockedForEveryone, 1 = CanBeChangedByHostAlone, 2 = CanBeChangedByEveryone

Note: All powers use only CanBeChangedByEveryone. If the server tells the client a power has a permission other than default, it will be stopped client-side and notified in the client's localization.

Banners [10]

Size	Description	Type	Notes
1	Message Type	Byte	0 = FullState, 1 = KillCountUpdate, 2 = ClaimCountUpdate, 3 = ClaimRequest, 4 = ClaimResponse
2	Kill Count Length	Int16	Only sent if MessageType = FullState
4 * KillCountLength	Kill Count Amount	Int32 * KillCountLength	Only sent if MessageType = FullState; loops through KillCountLength times to get Kill Count Amount for each position
2	Claimable Banners Length	Int16	Only sent if MessageType = FullState
2 * Claimable Banners Length	Claimable Banners Amount	UInt16 * Claimable Banners Length	Only sent if MessageType = FullState; loops through Claimable Banners Length times to get Claimable Banners Amount for each position
2	Kill Count Index	Int16	Only sent if MessageType = KillCountUpdate
4	Kill Count Amount	Int32	Only sent if MessageType = KillCountUpdate
2	Claimable Banners Index	Int16	Only sent if MessageType = ClaimCountUpdate, ClaimRequest, or ClaimResponse
2	Claimable Banners Amount	UInt16	Only sent if MessageType = ClaimCountUpdate, ClaimRequest, or ClaimResponse
1	Claim Granted	Boolean	Only sent if MessageType = ClaimResponse

Note: FullState, KillCountUpdate, ClaimCountUpdate, and ClaimResponse are Server -> Client only.

Crafting Requests [11]

Client -> Server (Request)

Size	Description	Type	Notes
2	Number of Required Items	Byte * 2 (7 Bit Encoded Int)	-
4	Item ID or Recipe Group	Int32	Loops through Number of Required Items
2	Stack	Byte * 2 (7 Bit Encoded Int)	Loops through Number of Required Items
2	Number of Chests	Byte * 2 (7 Bit Encoded Int)	-
2	Chest Index	Byte * 2 (7 Bit Encoded Int)	Loops through Number of Chests

Server -> Client (Response)

Size	Description	Type	Notes
1	Approval	Boolean	-

Tag Effect State [12]

Server <-> Client (Sync)

Size	Description	Type	Notes
1	Player ID	Byte	-
1	Message Type	Byte	0 = FullState, 1 = ChangeActiveEffect, 2 = ApplyTagToNPC, 3 = EnableProcOnNPC, 4 = ClearProcOnNPC
2	Active Effect Type	Int16	Only sent if MessgeType = FullState or ChangeActiveEffect
1	NPC Time Index	Byte	Only sent if MessgeType = FullState; Loops through TimeLeftOnNPC array
4	Time Left On NPC	Int32	Only sent if MessgeType = FullState; Loops through TimeLeftOnNPC array
1	Proc Time Left on NPC Index	Byte	Only sent if MessgeType = FullState and effect includes SyncProcs; Loops through ProcTimeLeftOnNPC array
4	Proc Time Left on NPC	Int32	Only sent if MessgeType = FullState and effect includes SyncProcs; Loops through ProcTimeLeftOnNPC array
1	NPC Index	Byte	Only sent if MessageType = ApplyTagToNPC, EnableProcOnNPC, or ClearProcOnNPC

Leashed Entity Module [13]

Server <-> Client (Sync)

Size	Description	Type	Notes
1	Message Type	Byte	0 = Remove, 1 = FullSync, 2 = PartialSync
2	Slot	Byte * 2 (7 Bit Encoded Int)	-
2	Type	Byte * 2 (7 Bit Encoded Int)	Only sent if MessageType = FullSync
2	Anchor POS X	Int16	Only sent if MessageType = FullSync
2	Anchor POS Y	Int16	Only sent if MessageType = FullSync
?	Leashed Entity Data	Variable	See below.

Leashed Kite

Size	Description	Type	Notes
2	Proj Type	Byte * 2 (7 Bit Encoded Int)	Only sent if Module Message Type = FullSync
4	Position X	Single	-
4	Position Y	Single	-
4		UInt32 (PackedVector)	Two Int16's packed into 4 bytes.
1	Rotation	Byte	-
4	Wind Target	Single	-
4	Cloud Alpha	Single	-
4	Time Counter	Single	-

Leashed Critter

Walker, Crawler, Snail, Runner, Flyer, Normal Butterfly, Empress Butterfly, Hell Butterfly, Firefly, Shimmer Fly, Dragonfly, Crawling Fly, Bird, Waterfowl, Fish, Fairy, Jumper, Water Strider

Size	Description	Type	Notes
2	NPC Type	Byte * 2 (7 Bit Encoded Int)	Only sent if Module Message Type = FullSync
4	Size X	Single	Only sent if Module Message Type = FullSync
4	Size Y	Single	Only sent if Module Message Type = FullSync
4	Position Offset	UInt32 (PackedVector)	Two Int16's packed into 4 bytes.
1	Direction	Boolean	-1 or 1
4	Rand State	UInt32	-
2	Wait Time	Int16	-
1	State	Byte	-
1	Target Position Offset X	SByte	-
1	Target Position Offset Y	SByte	-

Unbreakable Wall Scan [14]

Server -> Client

Size	Description	Type	Notes
1	Player ID	Byte	-
1	Inside Unbreakable Walls	Boolean	-

Home
Changelog
Command line parameters
Language
- Developer: i18n
Plugins
- Manager
Docker
Subsystem
- ssc
- tile providers
- motd
Definition documents
Spanish / español
- Descripción del archivo de configuración
- Parámetros de la línea de comandos
Chinese / 中文
- 主页
- 命令行参数
- 语言
  - 开发者: i18n
- 插件
  - 管理
- Docker容器
- 子系统
- 文档