工程開發
create-analyzer avatar

create-analyzer

為自訂 Minecraft Bedrock 封包分析器產生結構程式碼。包含模板程式碼、註冊指南與封包擷取工作流程。

簡介

create-analyzer 技能為開發 mineflayer-bedrock 的工程師提供了一套強大的架構,用於建立自訂領域的封包分析器。透過簡化新分析模組的建立流程,它使研究人員和自動化工程師能夠解碼複雜的遊戲互動,例如庫存管理、玩家移動、實體同步和合成順序。此工具專為需要將原始二進位封包記錄轉換為可執行狀態表示的開發者所設計。

此技能作為生成器運作,負責建立繼承自集中式 BaseAnalyzer 的模組化 TypeScript 類別。它強制執行嚴格的工作流程:從透過協定定義識別封包開始,經由結構化程式碼產生,最後使用擷取的記錄進行實務驗證。透過標準化分析器的生命週期,確保從 Bedrock 伺服器提取的遙測數據保持一致、可偵錯且可擴充,以適應未來的協定更新或新的遊戲功能。

  • 自動為封包分析產生 TypeScript 模板程式碼,並使用領域特定的範本。

  • 提供與 protocol.d.ts 中定義的專案標準協定深度整合。

  • 包含常見領域的預製邏輯:庫存、移動、實體、聊天、區塊和戰鬥。

  • 支援完整的開發生命週期,從原始 .bin 擷取、.jsonl 過濾到使用 jq 進行輸出驗證。

  • 促進使用重放客戶端 (Replay Clients) 來模擬網路流量,以便對分析器進行單元測試。

  • 使用者應先識別特定的封包領域,並在編寫邏輯前使用整合的錄製器進行封包擷取。

  • 建議在 shouldLog 覆寫中使用「先記錄所有內容」的方法,以確保在初步除錯期間不會丟失關鍵的邊緣情況數據。

  • 所需輸入包括目標領域名稱與要監控的相關封包,輸出則是結構化的 TypeScript 檔案與 JSONL 遙測記錄。

  • 請務必參考提供的文件對應表,以查找 packages/mineflayer/lib/bedrockPlugins/ 中的現有外掛程式,從而了解當前的處理器實作。

  • 限制包括需要手動在主要的 index.ts 檔案中註冊,以及需要可運作的 Minecraft Bedrock 環境來產生真實的封包樣本。

倉庫統計

Star 數
6
Fork 數
3
Open Issue 數
1
主要語言
TypeScript
預設分支
main
同步狀態
閒置
最近同步時間
2026年5月1日 上午08:09
在 GitHub 查看