服務端權威
在 Java 版中,玩家身上發生的許多事由客戶端決定:它在哪裡、一次點擊對物品欄做了什麼、方塊何時被破壞。在基岩版專用服務器上,
這三件事都由服務器決定。BDS 在 start_game 中聲明瞭這一點(server_authoritative_inventory、
server_authoritative_block_breaking),而移動始終是服務端權威的。客戶端發送玩家做了什麼;服務器模擬它並回復結果。
mineflayer 的 API 是為 Java 的模型設計的:客戶端先行動,再告訴服務器。bedboo 在基岩版的模型上保留這套 API:預測服務器會做 什麼,按基岩版要求的方式發送玩家的動作,並以服務器的回覆為準。本頁解釋這個模型;具體規則見基岩版差異。
每個 tick 一個輸入
基岩版客戶端從出生起,每個服務器 tick(每 50 ms)發送一個 player_auth_input 數據包。它攜帶位置(視線高度)、移動按鍵、
朝向、潛行和疾跑等標誌,以及挖掘的方塊動作。
bedboo 的輸入隊列(bot._bedrock.input)維持這個數據流。它的時鐘以 start_game 中服務器的 tick 為基準;每個 tick 物理引擎
讓玩家移動一步,隊列把結果連同插件為該 tick 排入的內容一起發送。計時器延遲時,它會補發錯過的 tick,一次最多
maxCatchupTicks(4)個。加載畫面、死亡和維度切換會暫停這個數據流(輸入流)。
這對機器人代碼的影響是:通過數據流發送的改變要到下一個輸入才生效,而不是立即生效。look() 在帶有新朝向的輸入發出後才
resolve(視角);緊跟在 setControlState('sneak') 之後的點擊會等到潛行狀態
發出之後(點擊前的潛行 / 疾跑)。
移動:先預測,再校正
BDS 對收到的每個輸入運行與客戶端相同的移動模擬。當客戶端報告的位置比服務器自己的結果移動得更遠時,它發送
correct_player_move_prediction,其中包含服務器的狀態和被校正輸入的 tick。
bedboo 每個 tick 都用它的基岩版移動引擎進行預測,因此通常服務器與之一致,不會發送任何東西。bedboo 保存已發送的輸入;收到
校正時,它回到被校正的 tick,採用服務器的狀態,重放此後發送的輸入,併發出 forcedMove。帶有 tick 的傳送、擊退和效果也以
同樣的方式從該 tick 起應用(校正)。
物品欄:item stack request
基岩版沒有點擊數據包。客戶端通過 item_stack_request(take、place、swap、drop、craft……)請求服務器在指定的容器槽位之間
移動物品,服務器以 item_stack_response 回覆:接受(附帶結果數量),或以錯誤碼拒絕。
bedboo 保留了 mineflayer 的 Java 佈局物品欄和 clickWindow。對每次點擊,它算出 Java 點擊會產生的結果,先把這個結果作為
預測應用,再以 item stack request 發送並等待回覆。被接受的請求會確定數量和 stack id;被拒絕的請求會回滾,clickWindow
拋出 mineflayer 自己的錯誤。所有基於點擊的操作(equip、transfer、deposit、craft……)都以同樣方式工作
(clickWindow)。服務器發送其物品欄副本的數據包總是優先;當 bedboo
發現某個槽位過期時,會向服務器請求它的副本(物品欄重新同步,
bot.bedrock.resyncInventory())。
挖掘與放置:以服務器的回覆為準
在 BDS 上,方塊由服務器自己破壞。客戶端告訴服務器鼠標何時在方塊上按下(start_break);此後 BDS 每個 tick 用它自己的
手持物品副本和玩家狀態累加破壞進度,進度完成時破壞方塊。
所以 bot.dig() 不像在 Java 版上那樣由客戶端計時器結束。bedboo 發送開始動作,跟蹤服務器報告的進度,並在服務器的
update_block 表明方塊已消失時 resolve;如果服務器沒有任何破壞該方塊的跡象,挖掘會被中止
(方塊破壞、完成)。
放置同樣由服務器回覆:每次點擊都攜帶服務器的手持物品副本,因此 bedboo 在上一次放置得到回覆後(或 500 ms 後)才發送下一次
(放置)。
對機器人意味著什麼
- 等待 promise。
dig、placeBlock、clickWindow、equip等都在服務器回覆後 settle,結果和錯誤與 Java 版相同。 - 服務器擁有最終決定權。服務器拒絕的移動、點擊或挖掘都會按服務器的說法撤銷。
- 時序跟隨服務器的 tick:動作在下一個輸入生效,挖掘所需的時間就是服務器破壞該方塊所需的時間。
使用 transport: 'bedd' 時,真實客戶端自己發送輸入、請求和方塊動作,bedboo 跟隨它的行為而不是預測它
(BeDD 模式)。