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 |