跳到正文
本页目录

Tap 协议

为 bedboo(传输 bedd)提供的客户端游戏数据包只读流。配置 tap (配置);状态:tap 操作。

订阅与帧

{"op":"tap","action":"subscribe"} → {"ok":true},之后每帧一条二进制消息。该连接上不要再发其他内容。第二个订阅者: busy;关闭时:disabled。

字节(LE) 字段
u32 len:其后的字节数,≤ 16 MiB + 20
u8 kind
u8 flags:1 重放,2 重新序列化(Packet::write),4 本地链路,8 已抑制(保留)
u16 0
u64 seq(进程级;重放时保持不变)
u64 tUs(单调时钟 µs)
… 负载
kind 负载
1 CLIENTBOUND varint 头(id | senderSub<<10 | targetSub<<12)+ 包体(bedrock-protocol parsePacketBuffer)
2 SERVERBOUND_ECHO 同上;从不含 id 1、3、4、193(login、握手、request_network_settings)
4 MARKER UTF-8 JSON(忽略其他 kind)
标记 字段
HELLO(首个) tap:1、mod、game:"1.26.60.05"、protocol(2225)、pid、link{state, type, address}、journal{frames, bytes, complete}
LINK_UP type remote|local、address
LINK_DOWN reason
REPLAY_BEGIN frames
REPLAY_END complete(超过 tapJournalMiB 时为 false;无日志:空的一对,false)
DROPPED count;订阅者落后 > 32 MiB;随后断开(重新订阅:完整重放)

实时帧等到 REPLAY_END 之后;按 seq 跳过重复帧。

发布者共用 src/TapSink.h(代码规范);钩子只复制,由订阅者线程取走。

远程服务器(NetTap.cpp)

链路建立 NetworkSystem::send(首个数据包之前)和 runEvents(每 tick)找到打开的连接
链路断开 $onConnectionClosed、closeConnection(1.26.60 未导出 onNewOutgoingConnection、onAllConnectionsClosed、disconnect)
入 BatchedNetworkPeer::_receivePacket(其后,HasData):已解密、已解压;flags 0
出 NetworkSystem::_sendInternal;flags 0
trace 每条链路前 50 个数据包:tap trace #n in|out id len
Blob 缓存 发送前清除 client_cache_status.enabled,使服务器发送完整子区块(回显显示 false)

单人世界和局域网主机世界(TapLoopback.cpp,配置 tapLoopback)

默认 true,需要 tap。钩住 LoopbackPacketSender;数据包重新序列化(头同上,Packet::write 使用发送方 NetworkSystem 的 ReflectionCtx);flags 2 + 4。

CLIENTBOUND 服务端发送方 $sendToClient(两个)、$sendToClients、$sendBroadcast(两个)、$sendTo(自 1.26.60 起经虚表调用 $sendTo、$sendBroadcast(except));仅 Local 连接。局域网访客:计入 guest。广播在本地玩家的 start_game 之后
SERVERBOUND_ECHO 客户端发送方 $sendToServer、$send、$sendTo;从不含 id 1、3、4、193
区块 每个 subchunk_request/subchunk(一个原点,最多 highest_subchunk_count;client_cache_status.enabled:false)
链路 仅当 tap::gLinkType 为 local;由客户端发送方的首个数据包和 $onConnectionClosed 设置。链路未知前,Local 客户端连接计入(从不写 gLinkType)。远程捕获只在 Remote 时发布:不会重复
无接收端 tap::gEmit 为 null:只计数。state.stats.tapLoopback{enabled, hooks, link, clientbound, echo, bytes, unpublished, guest}
trace 记录前 50 帧(trace tap loopback: in|out id= len=);前 4000 帧写入 mods\BeDD\data\tap-loopback.bin(seq、tUs 为 0)

加入日志(TapJournal.cpp)

挂在 bedd::tap::gEmit 链上,设置 bedd::tap::gReplay(在 REPLAY 标记之间对每个订阅者调用)。

保留 仅 CLIENTBOUND。新链路和 start_game(11,首帧)时重置
每键保留最新 level_chunk(x、z、dim)、update_block(pos、layer)、set_time、set_health、network_chunk_publisher_update、current_structure_feature、inventory_content(window)、inventory_slot(window、slot)、level_event(事件 id)、update_abilities(unique id)、add_*(unique id;add_player 用 runtime id);按 runtime id:set_entity_motion、move_entity、move_player、mob_armor_equipment
按实体 + 字段 set_entity_data(键)、update_attributes(名字)、move_entity_delta(字段)、mob_effect(效果)
subchunk 更新的帧覆盖其全部子区块后丢弃;无法遍历的:保留
remove_entity(14) 删除 add 帧(add_player 按 unique id 字节)和 runtime id 键
不保留 text、animate、network_stack_latency、play_sound、stop_sound、level_sound_event(v1、v2)、spawn_particle_effect、level_event_generic
上限 tapJournalMiB(128):超出后 complete:false 直到重置(晚到的订阅者缺区块)
统计 state.stats.journal:enabled, frames, bytes, complete, seen, compacted, pruned, transient, overCap, resets, replays