跳到正文
本頁目錄

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