工程开发
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 查看