Packets

The packets global sends; the packet_send and packet_receive events observe. Fields mirror the wire format, so coordinates arrive as raw x, y, z scalars rather than vec3.

module:event("packet_receive", function(e)
    if e.name == "minecraft:sound" then e:cancel() end   -- mute server-played sounds
end)

Packets are matched by stable snake_case names, the same strings e.name reports and packets.send accepts. The events fire for every packet: unmapped ones arrive under their vanilla protocol id (a name with a colon, like "minecraft:set_entity_motion") carrying no decoded fields, still cancellable. The names below add decoded fields and packets.send support.

packets.send raises on an unknown name and returns false when a required game object is missing. It goes through the normal client pipeline, so it fires packet_send as well: a module that cancels its own scripted packets swallows them.

local pos = player:position()
packets.send("move_position", { x = pos.x, y = pos.y + 0.05, z = pos.z, on_ground = false })
packets.send("client_command", { mode = "start_sprinting" })
packets.send("player_action", { action = "swap_item_with_offhand", x = 0, y = 0, z = 0 })

local target = world:player("Notch")
if target then
    packets.send("attack_entity", { entity_id = target:id() })
end

For attacking, breaking blocks and clicking slots, interaction is the better tool: it gets swing timers and sequence numbers right. Raw packets are for when you want the wire format yourself.

Sendable packets

Optional fields show their defaults. hand is "main" / "off" (default "main"), side is "up" · "down" · "north" · "south" · "east" · "west" (default "up"), and sequence defaults to 0.

Decoded event fields

Both events always carry name. The packets below decode their payload too; everything else fires with name alone.

Outgoing. Most sendable packets decode with the same fields they take, except that move_* carry x/y/z only when the position changed and yaw/pitch only when the look changed. Five carry name only: interact_entity, attack_entity, interact_entity_at, pick_item_from_block, pick_item_from_entity.

Incoming.