🎓 Packet API

The following objects and APIs provide the basic BDS packet interface for scripts.

(Please refer to Nukkit, PokcetMine, BDS Reverse to know the packet structure) If the client crashes, it is a packet structure error, not a bug.

The documentation does not list the packet ID and its structure, please check it yourself.

目录

• 🔉 Packet Object API
• 🔌 Binary stream object API

🔉 Packet Object API

In LSE, 「Packet Object」 is used to get information about packets.

Get a packet object

Get from API

Call some return packet object function to get to the packet object given by BDS
See Binary Stream Objects for details

Create from packet ID

Packet.createPacket(pktid[,raw])

• Parameters：
• pktid : Integer Packet ID
• raw : Boolean (Optional parameter) Create raw network packet. The default value is false
• Return value：Packet object
• Return value type： Packet

Packet Objects - Functions

Every packet object contains some member functions (member methods) that can be executed. For a particular entity object pkt, some operations can be performed on this packet by these functions

Get packet name

pkt.getName()

• Return value：packet name
• Return value type： String

Get packet ID

pkt.getId()

• Return value：packet id
• Return value type： Integer

Read binary stream data into packet

pkt.read(bs)

• Parameters：
• bs : BinaryStream Source binary stream
• Return value：success or not
• Return value type： Boolean

Write packet data into binary stream

pkt.write(bs)

• Parameters：
• bs : BinaryStream Target binary stream
• Return value：success or not
• Return value type： Boolean

Send packet to specified target

pkt.sendTo(pos)
pkt.sendTo(x,y,z,dimid)
pkt.sendTo(target)

• Parameters：

• pos : IntPos / FloatPos
  The coordinates of the packet send target (or use x, y, z, dimid to determine the target position)

• target : Player / Entity
  Packet send target

• Return value：success or not

• Return value type： Boolean

If target is Player, the packet will be sent to the specified player.
If target is Entity, the packet will be sent to players around the specified entity.

Send packet to all clients

pkt.sendToClients()

• Return value：success or not
• Return value type： Boolean

Send packet to server

pkt.sendToServer()

• Return value：success or not
• Return value type： Boolean

🔌 Binary Stream Object API

Create a binary stream object

[JavaScript] new BinaryStream()

[Lua] BinaryStream()

• Return value: Binary stream object
• Return value type： BinaryStream

Binary Stream Object - Functions

Every binary stream object contains some member functions (member methods) that can be executed. For a particular entity object bs, some operations can be performed on this binary stream by these functions

Resetting binary streams

bs.reset()

• Return value: success or not
• Return value type： Boolean

Get binary stream read pointer

bs.getReadPointer()

• Return value: current read pointer
• Return value type： Integer

Set binary stream read pointer

bs.setReadPointer(pos)

• Parameters：

• pos : Integer
  New read pointer

• Return value: success or not

• Return value type： Boolean

Get binary stream data

bs.getData([release])

• Parameters：

• release : Boolean (Optional parameter)
  Whether to clear stream data after reading. The default value is false

• Return value: binary stream data

• Return value type： ByteBuffer

Before 0.19.1, this function can only be used as bs.getData().
At that time, it always cleared the stream data after reading, and the return value type was String.

Because the old return value was String, in JavaScript it may be forcibly encoded as UTF-8, causing binary data corruption and incorrect data content.

Set binary stream data

bs.setData(data)

• Parameters：

• data : ByteBuffer
  Binary stream data

• Return value: success or not

• Return value type： Boolean

Write to binary stream

bs.writexxxx(value)

• Parameters：

• value : Null
  Refer to the table below For some numeric write functions, String is also accepted

• Return value：success or not

• Return value type： Boolean

Read from binary stream

bs.readxxxx([asString])
bs.readBytes(length)

• Parameters:

• asString : Boolean (Optional parameter) Only available for numeric read functions. When set to true, the return value is converted to String

• length : Integer Only available for readBytes. Number of bytes to read. Must be greater than 0

• Return value:

• Read result

When asString is true, scalar read* functions return String.

Building packet from binary stream

bs.createPacket(pktid[,raw])

• Parameters：

• pktid : Integer
  Packet ID

• raw : Boolean (Optional parameter)
  Create raw network packet from current binary stream data. The default value is false

• Return value：Packet object

• Return value type： Packet

Before 0.19.1, this function can only be used as bs.createPacket(pktid).

Dome Code

Send TextPacket packets to a player

mc.listen("onChat", (player, message) => {
  const text = "LLSE Packet Test";
  const bs = new BinaryStream();
  bs.reserve(text.length + 8);
  bs.writeBool(false);
  bs.writeByte(/* TextPacketPayload::mBody::MessageOnly (Variant Index) */0);
  bs.writeByte(/* TextPacketType::Raw (Enum) */0);
  bs.writeString(text);
  bs.writeString(""); // xuid
  bs.writeString(""); // platformId
  bs.writeString(""); // filtered message
  bs.createPacket(9).sendTo(player);
});