Packet Aliases for bot:send()

Use friendly names instead of raw wire IDs. Both packet names and field names auto-translate.

-- Old way (raw wire IDs)
bot:send("sMMF", { x = 15, y = 20, BlockType = 2 })

-- New way (friendly names)
bot:send("SetBlock", { x = 15, y = 20, block_type = 2 })

Block Interactions

Packet Alias Fields
SetBlock / SB Place a foreground block x, y, block_type
HitBlock / HB Punch a foreground block x, y, do_not_destroy
SetBlockBackground Place a background block x, y, block_type
HitBlockBackground Punch a background block x, y
SetBlockWater Place a water block x, y, block_type
HitBlockWater Punch a water block x, y
SetBlockWiring Place a wiring block x, y, block_type
HitBlockWiring Punch a wiring block x, y
HitAir Punch empty air x, y
HitSpirit Hit a spirit x, y
SetSeed Plant a seed x, y, block_type
-- Place dirt at (10, 20)
bot:send("SetBlock", { x = 10, y = 20, block_type = 2 })

-- Break without destroying (fist only)
bot:send("HitBlock", { x = 10, y = 20, do_not_destroy = true })

-- Place background
bot:send("SetBlockBackground", { x = 10, y = 20, block_type = 14 })

Chat

Packet Fields
SubmitWorldChat message
SubmitGlobalChat message
SubmitPrivateChat player_id, message
SubmitClanChat message
SubmitMessageAtFrequency frequency, message
bot:send("SubmitWorldChat", { message = "Hello world!" })
bot:send("SubmitPrivateChat", { player_id = "abc123", message = "Hey" })

Wearables & Weapons

Packet Fields
WearableOrWeaponChange block_type
WearableOrWeaponUndress block_type
WearableChange index, block_type
WeaponChange index, block_type
ChangePlayerCostume block_type
ChangeDefaultFace
ShowFaceAnimation
-- Equip hat at slot 0
bot:send("WearableChange", { index = 0, block_type = 362 })

-- Unequip
bot:send("WearableOrWeaponUndress", { block_type = 362 })

Combat & Damage

Packet Fields
HitAIEnemy x, y, aienemy_id, random_hit_text_index
HitOtherPlayer x, y, target_player_id, random_hit_text_index
HitDamageBlock x, y, blocktype, timestamp
DeathByCollider timestamp
Respawn to_world_entrance, timestamp
Resurrect timestamp
KillPlayer target_id
PlayerPoisonStart block_type
PlayerPoisonEnd
bot:send("HitAIEnemy", { x = 30, y = 10, aienemy_id = 42 })
bot:send("Respawn", { to_world_entrance = "", timestamp = os.time() })

World Navigation

Packet Fields
TryToJoin world, world_biome, amount
TryToJoinRandom amount
GetWorld world, entrance_id, world_biome
WorldLoadArgs world_client_special_data
LeaveWorld
ReadyToPlay
GoFromPortal

Player Data & Connection

Packet Fields
Ping
RequestServerTime timestamp
GetPlayerData
GetGameVersion os_name, device_id
DisconnectRequest
PlayerPosition
PlayerInfoUpdated gender, country_code, skin_color_index, skin_color_before_override
UpdatePlayerName

Inventory & Items

Packet Fields
GetInventoryData
BuyInventorySlots
UpdateBeltItem
DropItem x, y, dropped_item
TrashItem dropped_item
ConvertItems
RecycleBlock x, y, amount
ClaimRecyclePrize x, y
SetStatusIcon status_icon
BuyItemPack item_pack_id
CollectCollectable x, y
bot:send("SetStatusIcon", { status_icon = 3 })
bot:send("BuyItemPack", { item_pack_id = "BasicClothes" })

Friends

Packet Fields
GetFriendsList
AddFriend user_id
ConfirmFriendRequest user_id
CancelFriendRequest user_id
RemoveFriend user_id
bot:send("AddFriend", { user_id = "player123" })

World Management

Packet Fields
KickPlayer target_id
WarnPlayer target_id, reason
LockWorld x, y
UnlockWorld x, y
ChangeBackground background_type
ChangeWeather weather_type
ChangeLighting lighting_type
ChangeWorldMusic music_index
GravityModifier gravity_mode
NewWorldTag new_tag
bot:send("KickPlayer", { x = 0, y = 0, target_id = "griefer42" })
bot:send("ChangeWeather", { x = 0, y = 0, weather_type = 5 })

Familiars

Packet Fields
FamiliarChange block_type
FamiliarRename inventory_data, rename_value
FamiliarFeed inventory_key_pair, inventory_data
PlayFamiliarAnimation animation_names

Pets

Packet Fields
CreatePet block_type, inventory_data
PetFeed pet_id
PetHeal pet_id
PetClean pet_id
PetPet pet_id
PetTrain pet_id, training_type
PetStartTrain pet_id
PetEndTrain pet_id
PetStartAdventure pet_id
PetLevelUp pet_id
bot:send("PetFeed", { pet_id = 1 })

Quests

Packet Fields
QuestStarted quest_id
CompleteQuestPhase quest_id, quest_phase
QuestDiscarded quest_id
CompleteDailyQuest quest_id
GetDailyQuest quest_id

Storage & Bank

Packet Fields
GetBankItems
AddItemToBank inventory_data, amount
TakeItemsFromBank amount, index
AdjustStorageAndInventory world_item_base
AdjustMannequinAndInventory world_item_base, swap
AdjustDisplayStorage world_item_base

Potions & Consumables

Packet Fields
UsePotion block_type, health_bar_value
OpenPresent x, y
OpenTreasure x, y, remove_item

Vendor & Shop

Packet Fields
PurchaseVendorItem x, y, vendor_catalog, vendor_index
QueryByteCoinShop
BuyByteCoinShopItem

Nether / Portals

Packet Fields
RequestActivateNetherGroupPortal x, y
RequestNetherWorldExit
RequestDeepNetherExit
RequestActivateBluePortal x, y
RequestActivateJetRaceGroupPortal x, y
RequestGeneratedMineExit
PortalPasswordChanged x, y, password
PortalPasswordAttempt x, y, password
PlayerActivateOutPortal x, y
PlayerActivateInPortal x, y
Checkpoint x, y
StartPoint x, y
FinishLine x, y

Clan

Packet Fields
CreateClan clan_name, clan_tag, clan_faction, clan_info
TerminateClan
ClanMemberInvite player_id
ClanLeaveRequest
ClanMemberKick player_id
RequestMyClanData clan_id
ClanGemDonation clan_id, gem_amount

Fishing

Packet Fields
StartFishingGame x, y, block_type
FishingGameAction mini_game_data, location_status, vendor_index, index, amount
FishOnArea x, y
FishOffArea x, y, distance
FishRun x, y

Perks

Packet Fields
ActivatePerk perk, index
DeactivatePerk perk

Auction House

Packet Fields
GetAuctionHouseItemListing x, y, index, sort
SetAuctionHouseItemForSale x, y, amount, byte_coin_amount, time_in_minutes
BuyOutAuctionHouseItem x, y
CancelAuctionHouseItemSale x, y
CreateAuctionHouseOrder x, y, amount, byte_coin_amount, time_in_minutes
FulfillAuctionHouseOrder x, y
CancelAuctionHouseOrder x, y

Crafting

Packet Fields
CraftBlueprint x, y
CraftFishingGear x, y
CraftFlyingMount x, y
CraftMiningGear x, y

Wiring

Packet Fields
WiringConnect x, y
WiringDisconnect x, y

Scoreboards

Packet Fields
GetScoreBoardData x, y
WorldResetScores x, y

Trading

Packet Fields
CancelTrade trade_partner

Daily Bonus

Packet Fields
RequestDailyBonusRoll regular_roll, ad_sponsored_roll
ClaimDailyBonusGiveAway

Misc

Packet Fields
TutorialState tutorial_state
CharacterCreated gender, country_code, skin_color_index
Recall block_type, recall_block_type
Thrown x, y
DoFireworks x, y, block_type
TakePhoto x, y, block_type
DonateByteCoin byte_coin_amount
ClaimXPLevel
Detector message
RequestOtherPlayersFromWorld
ModifyBlockAnimation x, y, is_animation_on, direction
ModifyDisplayText x, y, world_item_base

Event Items

Packet Fields
HitXmasSnowflake x, y
HitValentinesFloatingHeart x, y
HitChineseNewYearLantern x, y
HitEventEasterEgg x, y