协议

Note: 本文是关于Minecraft Java版本(1.15.2, protocol578)最新稳定版本的协议。有关Java版本的预发行版，请参阅预发行协议。对于不完整的基岩版文档，请参见基岩协议。有关旧版Pocket Edition，请参阅Pocket Edition协议文档。

本页提供了对于当前Minecraft协议的分析。 如果您遇到问题，请查看协议常见问题解答或在IRC频道#mcdevs on irc.freenode.net上寻求帮助(更多信息)。

虽然您可以不受限制地使用此页面的内容来创建服务器、客户机、机器人程序等，但如果您将此页面的任何内容复制到其他地方发布，则仍需要为#mcdevs提供归属。

版本之间的更改可以在协议历史记录中查看。

目录

• 描述
  • 数据类型
  • 标识符
  • VarInt 与 VarLong
  • 位置
  • 定点数字
  • 粒子
  • 其他定义
• 数据包格式
  • 无压缩
  • 有压缩
• 握手
  • 客户端
  • 服务端
    • 握手
    • 旧服务器列表Ping
• 状态
  • 客户端
    • 应答
    • Pong
  • 服务端
    • 请求
    • Ping
• 登录
  • 客户端
    • 登录时断开连接
    • 加密请求
    • 登录成功
    • 设置压缩
    • 登录插件请求
  • 服务端
    • 开始登录
    • 加密应答
    • 登录插件应答
• 游玩
  • 客户端
    • 生成实体
    • 生成经验球
    • 生成天气实体
    • 生成生物实体
    • 生成画
    • 生成玩家
    • 实体动画 (客户端)
    • 统计
    • 确认玩家挖掘
    • 方块挖掘动画
    • 方块实体数据
    • 方块行为
    • 方块改变
    • Boss 血条
    • 服务器难度
    • 聊天消息(客户端)
    • 多方块改变
    • Tab完成 (客户端)
    • 定义命令
    • 窗口确认 (客户端)
    • 关闭窗口 (客户端)
    • 更新窗口物品
    • 窗口属性
    • 设置槽位
    • 设置冷却时间
    • 插件消息 (客户端)
    • 命名音效
    • 断开连接 (游玩中)
    • 实体状态
    • 爆炸
    • 卸载区块
    • 切换游戏状态
    • 打开马窗口
    • 保持活动 (客户端)
    • 区块数据
    • 效果
    • 粒子
    • 更新光源
    • 加入游戏
    • 地图数据
    • 交易列表
    • 实体位置
    • 实体位置与旋转
    • 实体旋转
    • 实体运动
    • 车辆移动 (客户端)
    • 打开书
    • 打开窗口
    • 打开签名编辑器
    • 工艺配方应答
    • 玩家能力 (客户端)
    • 战斗事件
    • 玩家信息
    • 旋转玩家
    • 玩家位置与朝向 (客户端)
    • 解锁配方
    • 销毁实体
    • 移除实体效果
    • 发送资源包
    • 重生
    • 实体头朝向
    • 选择高级选项卡
    • 世界边界
    • Camera

描述

Minecraft服务器接受来自TCP客户端的连接，并使用数据包与它们通信。数据包是通过TCP连接发送的字节序列。数据包的含义取决于它的数据包标识和当前连接状态。每个连接的初始状态是握手，使用数据包握手和登录成功来切换状态。

数据类型

所有通过网络发送的数据(除了VarInt和VarLong)都是大端模式的，即字节从最高有效字节发送到最低有效字节。大多数日常计算机都是小端模式的，因此在通过网络发送数据之前，可能需要进行转换。

标识符

标识符是一个命名空间的位置，其形式为 minecraft:thing. 如果未提供命名空间，则默认为 minecraft (也就是说 thing 代表 minecraft:thing )。 自定义内容应始终位于其自己的命名空间中，而不是默认命名空间中。命名空间应仅使用字符 0123456789abcdefghijklmnopqrstuvwxyz-_ ；实际名称应包含更多意义。 命名约定是 lower_case_with_underscores.

VarInt 与 VarLong

可变长度格式，使较小的数字使用较少的字节。它们非常类似于协议缓冲区变量：用7个最低有效位对值进行编码，最高有效位表示数字的下一部分是否有另一个字节。首先写入最低有效组，然后写入每个更高的组；因此，变量实际上是小端（但是，组是7位，而不是8位）。

VarInts变量永远不会超过5个字节，VarLongs变量永远不会超过10个字节。

读写VarInts类型和VarLongs类型变量的伪代码:

public static int readVarInt() {
    int numRead = 0;
    int result = 0;
    byte read;
    do {
        read = readByte();
        int value = (read & 0b01111111);
        result |= (value << (7 * numRead));
        numRead++;
        if (numRead > 5) {
            throw new RuntimeException("VarInt is too big");
        }
    } while ((read & 0b10000000) != 0);
    return result;
}

public static long readVarLong() {
    int numRead = 0;
    long result = 0;
    byte read;
    do {
        read = readByte();
        long value = (read & 0b01111111);
        result |= (value << (7 * numRead));
        numRead++;
        if (numRead > 10) {
            throw new RuntimeException("VarLong is too big");
        }
    } while ((read & 0b10000000) != 0);
    return result;
}

public static void writeVarInt(int value) {
    do {
        byte temp = (byte)(value & 0b01111111);
        // Note: >>> 意味着符号位与数字的其余部分一起移位，而不是单独保留
        value >>>= 7;
        if (value != 0) {
            temp |= 0b10000000;
        }
        writeByte(temp);
    } while (value != 0);
}

public static void writeVarLong(long value) {
    do {
        byte temp = (byte)(value & 0b01111111);
        // Note: >>> 意味着符号位与数字的其余部分一起移位，而不是单独保留
        value >>>= 7;
        if (value != 0) {
            temp |= 0b10000000;
        }
        writeByte(temp);
    } while (value != 0);
}

Warning: 请注意，Minecraft的VarInts不是使用协议缓冲区编码的；它只是类似的。如果你尝试使用协议缓冲区来编码VarInts，在某些情况下会得到错误的结果。主要区别在于:
1. Minecraft 的 VarInts 都是有符号的，但是并不使用 ZigZag 编码。协议缓冲区有 3 种 Varints 的类型: uint32 (正常编码，无符号)、 sint32 (ZigZag 编码，有符号) 与 int32 (正常编码，有符号). Minecraft 是 int32 的变种。因为Minecraft使用普通编码而不是 ZigZag 编码，负值总是使用最大字节数。
2. Minecraft 的 VarInts 永远不会超过5个字节，其 VarLongs 永远不会超过10个字节，而协议缓冲区变量在编码负数时总是使用10个字节，即使它是 int32 类型的。

VarInts样例:

VarLongs样例:

位置

Note: 您在这里看到的是最新版本的位置类型，但是位置类型不同于 1.14之前的位置类型 。

64位的值被分割为下面三部分:

• x: 26 最高有效位
• z: 26 中间有效位
• y: 12 最低有效位

编码如下:

((x & 0x3FFFFFF) << 38) | ((z & 0x3FFFFFF) << 12) | (y & 0xFFF)

解码如下:

val = read_unsigned_long();
x = val >> 38;
y = val & 0xFFF;
z = (val << 26 >> 38);

Note: 位移位的细节与语言有很大的依赖性；上面的方法在Java中可能有效，但在其他语言中可能不需要做一些调整。特别地，即使实际坐标是负数，通常也会得到正数。可以通过添加以下内容来解决此问题:

if x >= 2^25 { x -= 2^26 }
if y >= 2^11 { y -= 2^12 }
if z >= 2^25 { z -= 2^26 }

定点数字

有些字段可以存储为定点数字，其中一定数量的位表示有符号整数部分（小数点左侧的数字），其余部分表示小数部分（右侧）。相反，浮点（float和double）将数字本身（尾数）保存在一个块中，而小数点（指数）的位置存储在它旁边。

本质上，虽然定点数的范围比浮点小，但对于较高的值，它们的分数精度更高。这使得它们非常适合于在Minecraft中表示实体的全局坐标，因为准确地存储整数部分比在单个块（或米）中更精确地定位它们更重要。

坐标通常表示为32位整数，其中5位最低有效位专用于小数部分，其余部分存储整数部分。

Java缺乏对分数整数的直接支持，但可以将它们表示为整数。要从双精度转换为此整数表示，请使用以下公式：

 abs_int = (int) (double * 32.0D);

逆运算:

 double = (double) (abs_int / 32.0D);

粒子

其他定义

数据包格式

无压缩

有压缩

一旦具有非负阈值的 Set Compression 包被发送, zlib 压缩将在之后所有数据包中启用。数据包的格式会有微小变化，以兼容未压缩数据包的大小。

数据包长度字段给出的长度是该数据包中剩余的字节数，包括数据长度字段。

如果数据长度设置为零，则数据包未压缩；否则为未压缩数据包的大小。

如果压缩了，(数据包ID+数据)的未压缩长度必须等于或超过数据包 设置压缩 中设置的阈值,，否则接收方将断开连接。

通过发送数据包可以禁用压缩，通过 设置压缩 设置为负阈值，或者根本不发送设置压缩的压缩包。

握手

客户端

没有处于握手状态的客户端数据包，因为在客户端发送第一个数据包后，协议立即切换到另一个状态。

服务端

握手

这将导致服务器切换到目标状态。

旧服务器列表Ping

此数据包使用非标准格式。它从来没有长度前缀，包ID是无符号字节而不是变量。虽然在技术上不是当前协议的一部分，但旧客户端可以发送此数据包以启动 服务器列表Ping ，新版服务端应该能够正确处理它。

参见 服务器列表Ping#1.6 以获取更多有关细节。

状态

客户端

应答

Pong

服务端

请求

Ping

登录

登录过程如下:

1. C→S: 握手 并且设置 Next State 为 2
2. C→S: 开始登录
3. S→C: 加密请求
4. 客户端身份验证
5. C→S: 加密应答
6. 服务器身份验证，两者都启用加密
7. S→C: 设置压缩 (可选)
8. S→C: 登录成功

设置压缩，如果启用，必须在登录成功之前发送。 请注意，在设置压缩之后发送的任何内容都必须使用 有压缩

对于未经身份验证的（“破解版”/离线模式）和本地主机连接（这两个条件中的任何一个都足以用于未加密的连接），没有加密。在这种情况下 开始登录 后直接 登录成功 。

参见 协议加密 以获取更多细节

客户端

登录时断开连接

加密请求

参见 Protocol Encryption 以获取更多细节

登录成功

此数据包将连接状态切换到 游玩 。

Warning: 服务器可能需要一点时间才能完全转换到游玩状态，因此建议在发送游玩数据包之前等待，方法是设置超时，或者等待来自服务器的游玩数据包(通常是 玩家信息 )。Notchian客户端在下一个时钟的 time update 包之前不发送任何心跳包 ( 保持活动 ) 。

设置压缩

启用压缩。如果启用压缩，则以下所有数据包都以compressed packet format编码。负值或零值将禁用压缩，这意味着数据包格式应保持为uncompressed packet format 但是，这个包是完全可选的，如果不发送，压缩也不会被启用（当压缩被禁用时，Notchian服务器不发送数据包）。

登录插件请求

用于与 登录插件应答 一起实现自定义握手流。

与游玩模式下的插件消息不同，这些消息遵循锁步请求/响应方案，其中客户机将响应一个指示其是否理解的请求。Notchian客户端总是响应它不理解，并发送一个空的有效载荷。

服务端

开始登录

加密应答

参见 Protocol Encryption 以获取更多细节

登录插件应答

游玩

客户端

生成实体

在创建车辆或其他非生命实体时由服务器发送。

生成经验球

生成一个或多个经验球。

生成天气实体

通过这个包，服务器通知客户端在玩家周围512个街区半径范围内发生雷击。坐标指定了雷电袭击的确切位置。

生成生物实体

在生成生物实体时由服务器发送。

生成画

这个包显示了位置、名称和画的类型。

计算图像的中心：给定一个 (宽度 × 高度) 单元格网格，其中 (0,0) 为左上角，则中心为 (max(0, 宽度 / 2 - 1), 高度 / 2) 。例如， (1, 0) 表示 2×1 的画， (1, 2) 表示 4×4 的画。

按坐标排列的绘画列表 paintings_kristoffer_zetterstrand.png （其中x和y从左上角以像素为单位，宽度和高度以像素或方块的十六分之一为单位）

关于画的文章 Minecraft绘制和画布 中还提供了实际图像的画的名称列表。

生成玩家

当玩家进入可视范围时，服务器会发送这个包，而不是当玩家加入时。

必须在 玩家信息 之后发送，用于添加客户端在生成玩家时使用的玩家数据。如果此数据包到达时，此数据包生成的玩家的玩家信息不存在，则Notchian客户端将不会生成玩家实体。玩家信息包括皮肤/披肩数据。

但是，服务器可以为不在可见范围内的玩家安全地生成玩家实体。客户端似乎正确地处理了它。

处于 联机模式 时，UUID必须有效并且具有有效的皮肤。

在离线模式下， UUID v3 与字符串 OfflinePlayer:<player name> 一起使用，并使用UTF-8编码 (大小写敏感).

对于NPC，应使用UUID v2。

<+Grum> 我永远不会把这当做一个特性，你懂得 :)

一个合法的UUID应该像 xxxxxxxx-xxxx-Yxxx-xxxx-xxxxxxxxxxxx 这样，UUID的版本由 Y 指定。所以，对于UUID v3，Y 总为 3，而对于UUID v2, Y 总为 2 。

实体动画 (客户端)

每当实体需要更改时的动画（Animation）。

Animation 可以是以下值之一：

统计

作为对 客户端状态 的应答(id 1).

类别(这些是以名称空间命名的，但把 : 替换为 . ):

类别(这些是名称空间设置的，但是使用 : 替换为 . ):

方块 、 物品和 实体 使用方块(不是方块状态)、物品和实体的ID。

自定义 具有以下内容(客户端只关注单元):

单元:

• 无: 仅自然数 (格式化为0位小数)
• 伤害: 值是正常值的10倍
• 距离: 以厘米为单位的距离(方块的百分之一)
• 时间: 以tick为单位的时间跨度

确认玩家挖掘

方块挖掘动画

0~9是可显示的挖掘阶段，每个数字表示此坐标上没有动画。

挖掘动画仍然可以应用于空中；动画将保持可见，尽管没有挖掘。但是，如果将其应用于透明方块，可能会出现奇怪的图形效果，包括水失去透明度。（在正常的游戏中可以看到类似的效果，比如破冰的时候）

如果需要同时显示多个挖掘动画，则必须为每个动画指定一个唯一的实体ID。实体ID不需要与客户端上的实际实体相对应，随机生成的数字就行。

方块实体数据

与方块关联的给定实体集。

Action 字段:

• 1: 设置一个刷怪笼的数据（除产生潜力外的所有东西：当前延迟、最小/最大延迟、要刷的怪物、刷怪数量、刷怪范围等）
• 2: 设置命令方块文本（命令和上次执行状态）
• 3: 设置信标的级别、主、次影响
• 4: 设置怪物头部的旋转和皮肤
• 5: 设置一个潮涌核心
• 6: 在横幅上设置底色和图案
• 7: 设置结构瓦实体的数据
• 8: 设置 末地折跃门 的目的地
• 9: 设置告示牌的文字
• 10: 未使用
• 11: 设置一个床
• 12: 设置拼图方块的数据
• 13: 在篝火旁放置物品
• 14: 蜂巢信息

方块行为

这个包用于由方块执行的许多操作和动画，通常是非持久的。

参见 Block Actions 以获取值列表。

Warning: 本数据包使用方块ID，而不是方块状态。不幸的是，方块ID没有直接包含在 Data Generators 的输出中，但可以手动计算。

方块改变

每当在渲染距离内改变方块时激发。

Warning: 更改未加载的方块不是稳定的操作。Notchian客户机当前使用一个shared空方块，该方块针对已卸载方块中的所有方块更改进行了修改；而在1.9中，此方块从不在旧版本中呈现更改后的方块将出现在空方块的所有副本中。服务器应避免在未加载的方块中发送方块更改，而客户端应忽略此类包。

Boss 血条

服务器难度

更改客户端选项菜单中的难度设置

聊天消息(客户端)

识别聊天/系统消息之间的区别很重要，因为这有助于尊重用户的聊天消息。参见 processing chat 以获取更多信息。

Warning: 游戏信息 接受JSON格式，但不显示它，尽管不推荐使用的基于§的格式。使用 标题 数据包时，这不是问题，因此最好使用该数据包在该槽位中显示信息。参见 MC-119145 了解更多信息。

多方块改变

每当在同一tick的同一方块中更改2个或更多块时，就会触发。

Warning: 更改客户端未加载的方块是不安全的，详见 方块改变 。

要将位置解码为世界位置:

//其中horizPos表示水平位置，vertPos表示垂直位置
worldX = (horizPos >> 4 & 15) + (chunkX * 16);
worldY = vertPos;
worldZ = (horizPos & 15) + (chunkZ * 16);

Tab完成 (客户端)

服务器以发送给它的最后一个单词的自动完成列表作为响应。在常规聊天的情况下，这是一个玩家用户名。也支持命令名和参数。客户端在列出它们之前按字母顺序对它们进行排序。

定义命令

列出服务器上的所有命令及其解析方式。

这是一个有向图，有一个根节点。每个重定向或子节点必须仅引用已声明的节点。

有关此数据包的详细信息，请参阅 Command Data 文章。

窗口确认 (客户端)

来自服务器的一个数据包，指示来自客户端的请求是否被接受，或者是否存在冲突(由于延迟)。如果数据包未被接受，客户端必须用 serverbound window confirmation 进行响应

关闭窗口 (客户端)

当一个窗口被强行关闭时，例如当一个箱子在打开的时候被摧毁，这个包就会从服务器发送到客户端。

更新窗口物品

当添加/删除多个槽位(在一个窗口中)中的项目时，由服务器发送。这包括主要背包、盔甲和制作槽。

参见 inventory windows 了解如何索引槽位的详细信息。

窗口属性

这个包用于通知客户机GUI窗口的一部分应该被更新。

属性字段的含义取决于窗口的类型。下表显示窗口类型和属性的已知组合，以及如何解释该值。

对于附魔表，使用以下数字标识:

设置槽位

添加/删除槽位(窗口中)中的项目时由服务器发送。

要设置光标（当前用鼠标拖动的项目），请使用 -1 作为 Window ID 和 Slot 的值。

如果窗口ID设置为 0 (槽位36到44)，则此数据包只能用于编辑玩家背包的手持物品。如果窗口ID设置为-2，则可以使用背包中的任何插槽，但不会播放添加物品动画。

设置冷却时间

对具有给定类型的所有物品应用冷却时间，由末影珍珠版的Notchian服务器使用。这个包应该在冷却开始和冷却结束时发送(以补偿延迟)，尽管客户端将自动结束冷却。可以应用于任何物品，请注意，交互仍然会与物品一起发送到服务器，但客户端不会播放动画，也不会尝试预测结果(即块放置)。

插件消息 (客户端)

mod和插件可以使用它来发送他们的数据。Minecraft本身使用几个 插件通道 。 这些内部通道位于 minecraft 命名空间中。

更多的信息请参见 http://dinnerbone.com/blog/2012/01/13/minecraft-plugin-channels-messaging/

命名音效

参见: 音效

用于在客户端上播放声音效果。自定义声音可以由资源包添加。

断开连接 (游玩中)

由服务器在断开客户端连接之前发送。客户机假设在数据包到达时服务器已经关闭了连接。

实体状态

实体状态通常触发实体的动画。可用状态随实体的类型而变化（也可用于该类型的子类）。

参见 实体状态 以获取对于每种类型的实体有效的状态列表。

爆炸

当爆炸发生时发送（爬行者、TNT和恶魂火球）。

记录中的每一方块都将被设置为空气。Records 中每个轴的坐标是 int(X) + record.x 。

卸载区块

告诉客户端卸载区块列。

即使当前未加载给定区块，发送此数据包也是合法的。

切换游戏状态

用于各种各样的游戏状态，从是否上床使用到游戏模式到演示消息。

Reason的可能值列表:

打开马窗口

此包专门用于打开马窗口。打开窗口用于所有其他GUI。

保持活动 (客户端)

服务器会频繁地发送一个keep-alive，每个都包含一个随机的ID。客户端必须用相同的包响应。如果客户端在超过30秒的时间内没有响应，则服务器将启动客户端。反之亦然，如果服务器在20秒内未发送任何保持有效，则客户端将断开连接并产生“超时”异常。

Notchian服务器使用依赖于系统的时间（毫秒）来生成keep-alive ID值。

区块数据

主要文章: Chunk Format

参见: #Unload Chunk

Warning: 此页需要添加以下信息：现在生物群落是如何运作的？生物群落的变化是在种子发生变化的同时发生的，但不清楚如何/是否可以计算生物群落，因为它不是实际的种子（/r/mojira讨论，指出这似乎是某种插值，而三维生物群落只在地下使用）

服务器只发送超世界中方块柱的天光信息，由客户端知道玩家当前所在的维度。您还可以从主位掩码和发送的未压缩字节数推断此信息。此数据包还发送块中的所有块实体（尽管不需要发送它们；稍后使用更新块实体发送它们仍然是合法的）。

请注意，Notchian客户端在跨越块边界时需要一个更新视图位置包，否则它将只在它生成的块周围显示呈现距离+2个块。

效果

当客户端要播放声音或粒子效果时发送。

默认情况下，Minecraft客户端根据距离调整声音效果的音量。最后一个布尔字段用于禁用此功能，而是在2个街区外以正确的方向播放效果。目前这只用于效果1023（枯萎繁殖），效果1028（末影龙死亡），和效果1038（末地折跃门打开）；它在其他效果被忽略。

Effect ID 的可能取值:

方向指示:

游玩记录：这实际上是这个包中的一个特殊情况。您可以在特定位置启动/停止记录。使用有效的记录ID启动一个记录（或覆盖当前正在游玩的记录），任何其他值都将停止该记录。参见数据生成器有关项目ID的信息。

粒子

显示命名粒子

更新光源

更新区块的灯光等级。

对于x坐标增加的每个块，在z坐标增加的行内，在y坐标增加的层内，为每个块指定单独的块或天光阵列。偶数索引项（具有偶数x坐标的项，从0开始）压缩到低位，奇数索引到高位。

加入游戏

参见 协议加密 以获取更多信息。

地图数据

更新 地图 上的矩形区域。

对于图标，方向0表示垂直图标，并以22.5°（360/16）递增。

类型基于 map_icons.png 中的行和列:

交易列表

村民NPC提供的交易清单。

实体位置

当实体移动少于8个块时，服务器发送该数据包；如果实体移动超过8个块应该改为发送Entity Teleport。

这个包允许最多8个块向任何方向移动，因为短区域是从-32768到32767，所以 32768 / (128 * 32) = 8。

实体位置与旋转

当一个实体旋转和移动时，这个包由服务器发送。由于短区域被限制在-32768到32767之间，并且移动是固定点的偏移，因此该分组允许在任何方向上最多8个块移动。(-32768 / (32 * 128) == -8)

实体旋转

此数据包由服务器在实体旋转时发送。

实体运动

此数据包可用于初始化实体。

对于玩家实体，这个包或任何移动/查看包都会在每个游戏tick中发送。所以这个包的意思是，从上一个包开始，实体就没有移动/查看。

车辆移动 (客户端)

请注意，所有字段都使用绝对位置，不允许使用相对位置。

打开书

当玩家右击已签名的书时发送，这告诉客户机打开书的GUI。

打开窗口

当客户机应该打开一个窗口时，它被发送给客户机，比如箱子、工作台或熔炉。客户打开自己的背包时，不会向任何地方发送此消息。对于马，使用打开马窗口。

打开签名编辑器

当客户端放置了签名并且允许发送时发送 Update Sign 。在给定的位置必须已经有一个签名（客户机不会自动这样做）-首先发送一个 Block Change 。

工艺配方应答

对服务端 工艺配方请求 包的应答，具有相同的配方ID。似乎用于通知UI。

玩家能力 (客户端)

后两个浮点数分别表示视场和飞行速度，第一个字节用于确定4个布尔值。

关于 Flags 字段:

战斗事件

在1.8版本以前用于twitch流媒体的元数据，现在只用于在屏幕上显示游戏（进入战斗和结束战斗被Notchain客户端完全忽略）

玩家信息

由服务端发送以更新用户列表（在客户端中按 <tab> 键可显示用户列表）。

Property字段类似于Mojang API#UUID -> 个人资料 + 皮肤/斗篷的响应，只是在这里使用的是协议格式而不是JSON。也就是说，每个玩家通常都有一个名为 textures 的属性，值是base64编码的JSON字符串，如Mojang API#UUID -> 个人资料 + 皮肤/斗篷中所述。空的 properties 数组也是可以接受的，它将导致客户端根据UUID使用两个默认皮肤之一显示玩家。

Ping值与图标的对应方式如下:

• 如果ping为负（即服务器还不知道），则会导致“无连接”图标。

• 低于150毫秒的ping将显示5个条

• 低于300毫秒的ping将显示4个条

• 低于600毫秒的ping将显示3个条

• 低于1000毫秒（1秒）的ping将显示2个条

• 大于或等于1秒的ping将显示1个条。

旋转玩家

用于旋转玩家，使其面向给定的位置或实体（命令 /teleport [<targets>] <x> <y> <z> facing）

如果找不到实体ID给定的实体，则应将此数据包视为 Is entity 为假

玩家位置与朝向 (客户端)

更新玩家在服务器上的位置。当加入/重生时，该数据包还将导致“下载地形”屏幕的关闭。

如果玩家在服务器上的最后一个已知位置与此数据包设置的新位置之间的距离大于100米，客户端将以 You moved too quickly :( (Hacking?) 的原因被踢出。

此外，如果X或Z的定点数设置大于 3.2E7D ，客户将以 Illegal position 的原因被踢出。

偏航是以度数来衡量的，不遵循经典的三角法则。XZ平面上的单位偏航圆从(0，1)开始逆时针旋转，在(-1，0)处为90度，在(0，-1)处为180度，在(1，0)处为270度。此外，偏航不固定在0到360度之间；任何数字都有效，包括负数和大于360度的数字。

俯仰也是用度数来衡量的，其中0表示直视前方，-90读表示直视上方，+90度表示直视下方。

关于 Flags 字段:

<Dinnerbone> 这是一个位域，X/Y/Z/Y_ROT/X_ROT。如果设置了X，则X值是相对的而不是绝对的。

解锁配方

关于 Action 字段:

• 0 (init) = 列表2中的所有配方都将添加到配方书中。列表1中的所有配方将被标记为已显示，未标记的配方将显示在通知中。
• 1 (add) = 列表中的所有配方都将被添加，它们的图标将显示在通知中。
• 2 (remove) = 删除列表中的所有配方，这允许它们在重新读取时重新显示。

销毁实体

当要在客户端上销毁实体列表时由服务器发送。

移除实体效果

发送资源包

重生

要更改玩家的维度（主世界/下界/末地），向他们发送一个具有适当维度的重生包，然后是新维度的预加载区块/区块，最后是一个位置和外观包。你不需要卸载区块，客户端会自动卸载。

Warning: 除非玩家死了，否则避免将玩家的维度更改为原来的维度。如果你将维度更改为他们已经在的维度，就会出现奇怪的错误，比如玩家无法攻击新世界中的其他玩家（直到他们死亡并重生）。如果你必须在同一维度重生一个玩家而不杀死他们，发送两个重生包，一个到另一个世界，然后另一个到你想要的世界。你不需要完成第一次重生，只需要发送两个包。

实体头朝向

更改实体头部朝向的方向。

当发送实体外观包改变头部的垂直旋转时，发送该包似乎是水平旋转头部所必需的。

选择高级选项卡

由服务器发送，指示客户端应切换“高级”选项卡。在GUI中的客户端切换选项卡或在另一个选项卡中进行升级时发送。

字段 Optional Identifier 可以是下列值之一:

如果没有发送标识符或标识符无效，客户端将切换到GUI中的第一个选项卡。

世界边界

Notchian客户端通过比较较高的、警告距离或较低的值、当前直径到目标直径的距离或警告时间秒后边框所在的位置来确定显示警告的坚固程度。在伪代码中实现如下:

distance = max(min(resizeSpeed * 1000 * warningTime, abs(targetDiameter - currentDiameter)), warningDistance);
if (playerDistance < distance) {
    warning = 1.0 - playerDistance / distance;
} else {
    warning = 0.0;
}

设置玩家从中渲染的实体。当玩家在旁观者模式下左键单击实体时，通常使用此选项。

Camera

Sets the entity that the player renders from. This is normally used when the player left-clicks an entity while in spectator mode.

The player’s camera will move with the entity and look where it is looking. The entity is often another player, but can be any type of entity. The player is unable to move this entity (move packets will act as if they are coming from the other entity).

If the given entity is not loaded by the player, this packet is ignored. To return control to the player, send this packet with their entity ID.

The Notchian server resets this (sends it back to the default entity) whenever the spectated entity is killed or the player sneaks, but only if they were spectating an entity. It also sends this packet whenever the player switches out of spectator mode (even if they weren’t spectating an entity).

The notchian also loads certain shaders for given entities:

• Creeper → shaders/post/creeper.json
• Spider (and cave spider) → shaders/post/spider.json
• Enderman → shaders/post/invert.json
• Anything else → the current shader is unloaded

未完待续

From https://wiki.vg/Protocol