m: 数据包监听更新文档

Author: SuperScript-PRC

docs/plugin-dev/api/数据包监听.md

@@ -12,10 +12,10 @@ class MyPlugin(Plugin):
     ...
     def __init__(self, frame):
         super().__init__(frame)
-        self.ListenPacket(PacketIDS.Text, self.OnPacket)
+        self.ListenPacket(PacketIDS.Text, self.on_packet)
 
-    def OnPacket(self, packet):
-        print(packet)
+    def on_packet(self, packet):
+        self.print(packet["SourceName"], packet["Message"])
 ```
 - 关于 `ListenPacket`：
     | 参数 | 类型 | 说明 |
@@ -24,6 +24,13 @@ class MyPlugin(Plugin):
     | callback | (dict) -> bool | 监听回调函数，返回表示是否拦截数据包 |
 
 
+::: info 提示
+数据包格式可参考 https://prismarinejs.github.io/minecraft-data/protocol/bedrock/1.21.50
+ToolDelta 会将数据包中的类型全部转换为 Python 基本类型
+对于详细的属性名和属性类型，可参考 Golang 实现 (https://github.com/Sandertv/gophertunnel/tree/master/minecraft/protocol/packet) 中各个数据包的结构体，它们会被直接序列化为 msgpack（一般情况下） 或 json 格式（备用）供 Python 读取。
+:::
+
+
 
 ::: warning 警告
 由于 Python 的 json 模块性能羸弱，在监听所有数据包时，很可能导致 ToolDelta 严重卡顿。