vasenanetwork/bedrock-protocol

PHP 实现的 Minecraft: Bedrock Edition 协议

dev-main 2024-04-29 14:12 UTC

README

CI

PHP 实现的 Minecraft: Bedrock Edition 协议

这个库实现了 Minecraft: Bedrock Edition 协议中的所有数据包,以及一些支持它们所需的额外功能。然而,在撰写本文时,它不包括以下内容:

  • 与 JWT 处理/验证相关的内容
  • 与加密相关的内容
  • 与压缩相关的内容

解码数据包

假设您已成功解密并解压了一个 Minecraft 数据包,您接下来想要对其进行解码。使用这个库,目前是通过 PacketBatch 实现的,如下所示:

foreach(PacketBatchUtils::decodePackets(new BinaryStream($payload), $protocolContext, PacketPool::getInstance()) as $packetObject){
    var_dump($packetObject); //tada
}

编码数据包

这很简单

/** @var Packet[] $packets */
$stream = new BinaryStream();
PacketBatchUtils::encodePackets($stream, $protocolContext, $packets);
$batchPayload = $stream->getBuffer();

脚注

由于这个库最初仅打算用于 PocketMine-MP 的使用,因此它边缘的处理有些粗糙。最近,这些混乱已经被从核心中分离出来,以便其他东西可以使用。这意味着可能需要进行 API 变更,您的反馈将有助于推动这些变更。如果您想改进 BedrockProtocol,请提出建议,或者更好的是,提交 pull request。