https://mineplugin.org/api.php?action=feedcontributions&feedformat=atom&user=%E6%A2%A6%E5%BD%97%E6%A5%AD
Minecraft插件百科 - 用户贡献 [zh-cn]
2026-05-04T15:41:42Z
用户贡献
MediaWiki 1.41.1
https://mineplugin.org/index.php?title=Protocol&diff=5416
Protocol
2017-09-02T14:46:45Z
<p>梦彗業：翻译</p>
<hr />
<div>{{待翻译}}<br />
{{待更新|url=http://wiki.vg/Protocol}}<br />
<br />
这里剖析了最近的 '''[http://wiki.vg/Protocol_Encryption Minecraft协议]'''.<br />
<br />
如果你有疑问, 请查阅下文或在IRC请求帮助 ([irc://irc.freenode.net/mcdevs #mcdevs on irc.freenode.net]).<br />
<br />
'''注意:''' 你可以不受限制地使用这个页面的内容来创建服务端, 客户端, 机器人…… 诸如此类的任何东西…<br />
<br />
== 定义 ==<br />
<br />
Minecraft服务器是基于TCP通讯的。它和客户端使用所谓的 ''数据包''交流. 一个包被通过字节编码后从TCP连接中发送. 数据包的含义取决于其包标识和连接的当前状态. 每个链接从 '''[http://wiki.vg/Handshaking 握手]'''开始, 使用包切换状态 '''[http://wiki.vg/Handshaking 握手]''',( 0x00, serverbound) 和 [[#Login Success|成功登陆]] ([[#Login|登陆]], 0x02, clientbound).<br />
<br />
=== 数据类型 ===<br />
<br />
<!-- Transcluded contents of Data Types article in here - go to that page if you want to edit it --><br />
<br />
{{:Data Types}}<br />
<br />
=== 其他定义 ===<br />
<br />
{| class="wikitable"<br />
|-<br />
! 术语<br />
! 定义<br />
|-<br />
| Player——玩家<br />
| 使用时, 玩家通常使用它来链接到服务端.<br />
|-<br />
| Entity——实体<br />
| 实体相当于玩家、物品、怪物、船和矿车等. 查看 {{Minecraft Wiki|Entity|the Minecraft Wiki article}} 来寻找一个完整的表单.<br />
|-<br />
| EID——实体ID<br />
| An EID — 或者说是实体ID — 是一个用来识别特定实体的4字节序列. 在同一个服务器,没有相同的实体编号.<br />
|-<br />
| XYZ坐标<br />
| 游戏时，可以使用按钮“F3”来在屏幕上查看坐标位置 Y代表高度, X代表东西, Z代表南北.<br />
|-<br />
| 单位“Meter”<br />
| Meter是Minecraft的基本长度单位, 相当于一个方块的长度. “block”一词也许意味着 “meter”或者“cubic meter”.<br />
|}<br />
<br />
== 数据包的格式 ==<br />
<br />
=== 无压缩 ===<br />
<br />
{| class="wikitable"<br />
! 域名称<br />
! 域类型<br />
! 注释<br />
|-<br />
| 长度<br />
| VarInt<br />
| 包数据的长度 + 包序号的长度<br />
|-<br />
| 包序号<br />
| VarInt<br />
| <br />
|-<br />
| 数据<br />
| Byte Array<br />
| 依赖于连接状态和包序号，详见下面的部分。<br />
|}<br />
<br />
=== 压缩 ===<br />
<br />
当一个 [[#Set Compression|设置压缩]] 包被发送，[[wikipedia:Zlib|zlib]] 压缩将会对之后的所有包开启。 包的格式略微改变以包含未压缩前的包的长度。<br />
''译注：注意区分包长度和数据长度，关系：“包”包含“数据”''<br />
{| class=wikitable<br />
! 是否压缩<br />
! 域名称<br />
! 域类型<br />
! 注释<br />
|-<br />
| 否<br />
| 包长度<br />
| VarInt<br />
| 数据长度的长度 + 压缩后的 (包序号 + 数据) 的长度<br />
|-<br />
| 否<br />
| 数据长度<br />
| VarInt<br />
| 未压缩前的 (包序号 + 数据) 的长度 或 0<br />
|-<br />
|rowspan="2"| 是<br />
| 包序号<br />
| Varint<br />
| zlib 压缩后的包序号（详见下面的部分）<br />
|-<br />
| 数据<br />
| Byte Array<br />
| zlib 压缩后的包数据（详见下面的部分）<br />
|}<br />
<br />
包长度域提供的是包中存在的字节的数量，包括数据长度域。<br />
<br />
如果数据长度被设置为 0，则这个包没有被压缩；否则它表示已压缩的包未压缩前的包长度。<br />
<br />
如果包被压缩，压缩前的 (包序号 + 数据) 的长度必须等于或大于 [[#Set Compression|设置压缩]] 包中设置的最小值，否则客户端/服务端将会断开连接。<br />
<br />
压缩能通过发送一个最小值设定为 -1 的 [[#Set Compression|设置压缩]] 包来关闭。<br />
<br />
== 握手协议 ==<br />
<br />
=== 客户端绑定 ===<br />
<br />
因为协议在客户端发送第一个数据包后会立刻切换到另一个阶段，所以握手阶段没有客户端绑定的数据包。<br />
<br />
=== 服务端绑定 ===<br />
<br />
==== 握手协议 ====<br />
<br />
这将使得服务器切换至目标阶段。<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="4"| 0x00<br />
|rowspan="4"| Handshaking<br />
|rowspan="4"| Server<br />
| 协议版本<br />
| VarInt<br />
| See [[protocol version numbers]] (currently 47)<br />
|-<br />
| 服务器地址<br />
| String<br />
| 域名或是IP, 例如： localhost 或是 127.0.0.1<!-- does this support IPv6? --><br />
|- <br />
| 服务器端口<br />
| Unsigned Short<br />
| 默认值为25565<br />
|-<br />
| 下一阶段<br />
| VarInt<br />
| 1 for [[#Status|status]], 2 for [[#Login|login]]<br />
|}<br />
<br />
==== 传统的服务器列表Ping ====<br />
<br />
严格来说这不是当前协议的一部分，传统客户端可能会发送这一数据包来发起（initiate） [[Server List Ping]], 现代服务器也应当能够适当地处理这一数据包。<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
| 0xFE<br />
| Handshaking<br />
| Server<br />
| Payload<br />
| Unsigned Byte<br />
| always 1 (<code>0x01</code>)<br />
|}<br />
<br />
See [[Server List Ping#1.6]] for the details of the protocol that follows this packet.<br />
<br />
== 开始游戏 ==<br />
<br />
=== 发送到客户端 ===<br />
<br />
==== 心跳包 ====<br />
<br />
The server will frequently send out a keep-alive, each containing a random ID. The client must respond with the same packet. If the client does not respond to them for over 30 seconds, the server kicks the client. Vice versa, if the server does not send any keep-alives for 20 seconds, the client will disconnect and yields a "Timed out" exception.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="1"| 0x00<br />
|rowspan="1"| Play<br />
|rowspan="1"| Client<br />
| Keep Alive ID<br />
| VarInt<br />
| <br />
|}<br />
<br />
==== 加入游戏 ====<br />
<br />
See [[Protocol Encryption]] for information on logging in.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="7"| 0x01<br />
|rowspan="7"| Play<br />
|rowspan="7"| Client<br />
| Entity ID<br />
| Int<br />
| The player's Entity ID (EID)<br />
|-<br />
| Gamemode<br />
| Unsigned Byte<br />
| 0: Survival, 1: Creative, 2: Adventure, 3: Spectator. Bit 3 (0x8) is the hardcore flag.<br />
|-<br />
| Dimension<br />
| Byte<br />
| -1: Nether, 0: Overworld, 1: End<br />
|-<br />
| Difficulty<br />
| Unsigned Byte<br />
| 0: peaceful, 1: easy, 2: normal, 3: hard<br />
|-<br />
| Max Players<br />
| Unsigned Byte<br />
| Used by the client to draw the player list<br />
|-<br />
| Level Type<br />
| String<br />
| default, flat, largeBiomes, amplified, default_1_1<br />
|-<br />
| Reduced Debug Info<br />
| Boolean<br />
| If true, a Notchian client shows reduced information on the {{Minecraft Wiki|debug screen}}.<br />
|}<br />
<br />
{{Warning|如果位置无效，服务端将崩溃}}<br />
<br />
==== 聊天内容 ==== <br />
<br />
Identifying the difference between Chat/System Message is important as it helps respect the user's chat visibility options. While Position 2 accepts json formatting it will not display, old style formatting works<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="2"| 0x02<br />
|rowspan="2"| Play<br />
|rowspan="2"| Client<br />
| JSON Data<br />
| [[Chat]]<br />
| Limited to 32767 bytes<br />
|-<br />
| Position<br />
| Byte<br />
| 0: chat (chat box), 1: system message (chat box), 2: above action bar<br />
|}<br />
<br />
{{Warning|错误的JSON将断开连接}}<br />
<br />
==== 时间更新 ====<br />
<br />
MineCraft中的时间以 ticks 为基础, 现实中1秒为 20 ticks。游戏中一天有 24000 ticks，也就是现实中20分钟。<br />
<br />
游戏中每天的时间是以 24000 ticks为标准的，0 ticks 为日出, 6000 ticks 为晌午, 12000 为日落, 因而 18000 为午夜。<br />
<br />
默认情况下，双路处理器的服务器也遵循以上规则。<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="2"| 0x03<br />
|rowspan="2"| Play<br />
|rowspan="2"| Client<br />
| World Age<br />
| Long<br />
| 基于 ticks 计算; 不因外部命令而改变<br />
|-<br />
| Time of day<br />
| Long<br />
| 世界(或地区)时间以ticks为单位。异常情况下太阳将会在 Math.abs 的时间停止运动<br />
|}<br />
<br />
==== 持有的物品 ====<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="3"| 0x04<br />
|rowspan="3"| Play<br />
|rowspan="3"| Client<br />
| Entity ID<br />
| VarInt<br />
| Entity's EID<br />
|-<br />
| Slot<br />
| Short<br />
| Equipment slot. 0: held, 1–4: armor slot (1: boots, 2: leggings, 3: chestplate, 4: helmet)<br />
|-<br />
| Item<br />
| [[Slot Data|Slot]]<br />
| Item in slot format<br />
|}<br />
<br />
==== 出生姿势 ====<br />
<br />
Sent by the server after login to specify the coordinates of the spawn point (the point at which players spawn at, and which the compass points to). It can be sent at any time to update the point compasses point at.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="1"| 0x05<br />
|rowspan="1"| Play<br />
|rowspan="1"| Client<br />
| Location<br />
| Position<br />
| Spawn location<br />
|}<br />
<br />
==== 更新生命值 ====<br />
<br />
Sent by the server to update/set the health of the player it is sent to.<br />
<br />
Food {{Minecraft Wiki|Food#Hunger vs. Saturation|saturation}} acts as a food “overcharge”. Food values will not decrease while the saturation is over zero. Players logging in automatically get a saturation of 5.0. Eating food increases the saturation as well as the food bar.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="3"| 0x06<br />
|rowspan="3"| Play<br />
|rowspan="3"| Client<br />
| Health<br />
| Float<br />
| 0 or less = dead, 20 = full HP<br />
|-<br />
| Food<br />
| VarInt<br />
| 0–20<br />
|- <br />
| Food Saturation<br />
| Float<br />
| Seems to vary from 0.0 to 5.0 in integer increments<br />
|}<br />
<br />
==== 重生 ====<br />
<br />
来改变玩家的位置(主世界/地狱/末地), 发送给他们一个重生指令, 其次是prechunks或chunks的新位置, and finally a position and look packet. You do not need to unload chunks, the client will do it automatically.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="4"| 0x07<br />
|rowspan="4"| Play<br />
|rowspan="4"| Client<br />
| Dimension<br />
| Int<br />
| -1: The Nether, 0: The Overworld, 1: The End<br />
|-<br />
| Difficulty<br />
| Unsigned Byte<br />
| 0: Peaceful, 1: Easy, 2: Normal, 3: Hard<br />
|-<br />
| Gamemode<br />
| Unsigned Byte<br />
| 0: survival, 1: creative, 2: adventure. The hardcore flag is not included<br />
|-<br />
| Level Type<br />
| String<br />
| Same as [[#Join Game|Join Game]]<br />
|}<br />
<br />
{{Warning|如果位置无效，服务端将崩溃 }}<br />
<br />
{{Warning|如果玩家出现在了相同的位置, weird bugs can occur i.e. such player will be unable to attack other players in new world (修复后他们将重生)}}<br />
<br />
==== 玩家姿势以及看的方向 ==== <br />
<br />
Updates the player's position on the server.<br />
<br />
If the distance between the last known position of the player on the server and the new position set by this packet is greater than 100 meters, the client will be kicked for “You moved too quickly :( (Hacking?)”.<br />
<br />
Also if the fixed-point number of X or Z is set greater than <code>3.2E7D</code> the client will be kicked for “Illegal position”.<br />
<br />
Yaw is measured in degrees, and does not follow classical trigonometry rules. The unit circle of yaw on the XZ-plane starts at (0, 1) and turns counterclockwise, with 90 at (-1, 0), 180 at (0, -1) and 270 at (1, 0). Additionally, yaw is not clamped to between 0 and 360 degrees; any number is valid, including negative numbers and numbers greater than 360.<br />
<br />
Pitch is measured in degrees, where 0 is looking straight ahead, -90 is looking straight up, and 90 is looking straight down.<br />
<br />
The yaw in degrees of a player standing at point (x0, z0) and looking towards point (x, z) can be calculated with:<br />
<br />
l = x-x0<br />
w = z-z0<br />
c = sqrt( l*l + w*w )<br />
alpha1 = -arcsin(l/c)/PI*180<br />
alpha2 = arccos(w/c)/PI*180<br />
if alpha2 > 90 then<br />
yaw = 180 - alpha1<br />
else<br />
yaw = alpha1<br />
<br />
You can get a unit vector from a given yaw/pitch via:<br />
<br />
x = -cos(pitch) * sin(yaw)<br />
y = -sin(pitch)<br />
z = cos(pitch) * cos(yaw)<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="6"| 0x08<br />
|rowspan="6"| Play<br />
|rowspan="6"| Client<br />
| X<br />
| Double<br />
| Absolute or relative position, depending on Flags<br />
|-<br />
| Y<br />
| Double<br />
| Absolute or relative position, depending on Flags<br />
|-<br />
| Z<br />
| Double<br />
| Absolute or relative position, depending on Flags<br />
|-<br />
| Yaw<br />
| Float<br />
| Absolute or relative rotation on the X Axis, in degrees<br />
|-<br />
| Pitch<br />
| Float<br />
| Absolute or relative rotation on the Y Axis, in degrees<br />
|-<br />
| Flags<br />
| Byte<br />
| Bit field, see below<br />
|}<br />
<br />
About the Flags field:<br />
<br />
<Dinnerbone> It's a bitfield, X/Y/Z/Y_ROT/X_ROT. If X is set, the x value is relative and not absolute.<br />
<br />
{| class="wikitable"<br />
|-<br />
! Field<br />
! Bit<br />
|-<br />
| X<br />
| 0x01<br />
|-<br />
| Y<br />
| 0x02<br />
|-<br />
| Z<br />
| 0x04<br />
|-<br />
| Y_ROT<br />
| 0x08<br />
|-<br />
| X_ROT<br />
| 0x10<br />
|}<br />
<br />
==== 持有物品变更 ====<br />
<br />
Sent to change the player's slot selection.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="1"| 0x09<br />
|rowspan="1"| Play<br />
|rowspan="1"| Client<br />
| Slot<br />
| Byte<br />
| The slot which the player has selected (0–8)<br />
|}<br />
<br />
==== 使用床 ==== <br />
<br />
This packet tells that a player goes to bed.<br />
<br />
The client with the matching Entity ID will go into bed mode.<br />
<br />
This Packet is sent to all nearby players including the one sent to bed.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="2"| 0x0A<br />
|rowspan="2"| Play<br />
|rowspan="2"| Client<br />
| Entity ID<br />
| VarInt<br />
| Sleeping player's EID<br />
|-<br />
| Location<br />
| Position<br />
| Block location of the head part of the bed<br />
|}<br />
<br />
==== 动画 ====<br />
<br />
Sent whenever an entity should change animation.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="2"| 0x0B<br />
|rowspan="2"| Play<br />
|rowspan="2"| Client<br />
| Entity ID<br />
| VarInt<br />
| Player ID<br />
|-<br />
| Animation<br />
| Unsigned Byte<br />
| Animation ID (see below)<br />
|}<br />
<br />
Animation can be one of the following values:<br />
<br />
{| class="wikitable"<br />
! ID<br />
! Animation<br />
|-<br />
| 0<br />
| Swing arm<br />
|-<br />
| 1<br />
| Take damage<br />
|-<br />
| 2<br />
| Leave bed<br />
|-<br />
| 3<br />
| Eat food<br />
|-<br />
| 4<br />
| Critical effect<br />
|-<br />
| 5<br />
| Magic critical effect<br />
|}<br />
<br />
==== 生成玩家 ====<br />
<br />
This packet is sent by the server when a player comes into visible range, ''not'' when a player joins.<br />
<br />
This packet must be sent after the [[#Player List Item|Player List Item]] ([[#Play|Play]], 0x38, clientbound) packet that adds the player data for the client to use when spawning a player. If the tab list entry for the UUID included in this packet is not present when this packet arrives, the entity will not be spawned. The tab includes skin/cape data.<br />
<br />
Servers can, however, safely spawn player entities for players not in visible range. The client appears to handle it correctly.<br />
<br />
When in online-mode the UUIDs must be valid and have valid skin blobs, in offline-mode UUID v3 is used.<br />
<br />
For NPCs UUID v2 should be used. Note:<br />
<br />
<+Grum> i will never confirm this as a feature you know that :)<br />
<br />
In an example UUID, <code>xxxxxxxx-xxxx-Yxxx-xxxx-xxxxxxxxxxxx</code>, the UUID version is specified by <code>Y</code>. So, for UUID v3, <code>Y</code> will always be <code>3</code>, and for UUID v2, <code>Y</code> will always be <code>2</code>.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="9"| 0x0C<br />
|rowspan="9"| Play<br />
|rowspan="9"| Client<br />
| Entity ID<br />
| VarInt<br />
| Player's EID<br />
|-<br />
| Player UUID<br />
| UUID<br />
| <br />
|-<br />
| X<br />
| Int<br />
| Player X as a [[Data Types#Fixed-point numbers|Fixed-Point number]]<br />
|-<br />
| Y<br />
| Int<br />
| Player Y as a [[Data Types#Fixed-point numbers|Fixed-Point number]]<br />
|-<br />
| Z<br />
| Int<br />
| Player Z as a [[Data Types#Fixed-point numbers|Fixed-Point number]]<br />
|-<br />
| Yaw<br />
| Angle<br />
| <br />
|-<br />
| Pitch<br />
| Angle<br />
| <br />
|-<br />
| Current Item<br />
| Short<br />
| The item the player is currently holding. Note that this should be 0 for “no item”, unlike -1 used in other packets.<br />
|-<br />
| Metadata<br />
| [[Entities#Entity Metadata Format|Metadata]]<br />
| <br />
|}<br />
<br />
{{Warning|A negative Current Item crashes clients}}<br />
<br />
{{Warning|The client will crash if no Metadata is sent}}<br />
<br />
==== 拾起物品 ====<br />
<br />
Sent by the server when someone picks up an item lying on the ground — its sole purpose appears to be the animation of the item flying towards you. It doesn't destroy the entity in the client memory, and it doesn't add it to your inventory. The server only checks for items to be picked up after each [[#Player Position|Player Position]] (and [[#Player Position And Look|Player Position And Look]]) packet sent by the client.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="2"| 0x0D<br />
|rowspan="2"| Play<br />
|rowspan="2"| Client<br />
| Collected Entity ID<br />
| VarInt<br />
| <br />
|- <br />
| Collector Entity ID<br />
| VarInt<br />
| <br />
|}<br />
<br />
==== 生成对象 ====<br />
<br />
Sent by the server when an Object/Vehicle is created.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="8"| 0x0E<br />
|rowspan="8"| Play<br />
|rowspan="8"| Client<br />
| Entity ID <br />
| VarInt<br />
| EID of the object<br />
|-<br />
| Type<br />
| Byte<br />
| The type of object (See [[Entities#Objects|Objects]])<br />
|-<br />
| X<br />
| Int<br />
| X position as a [[Data Types#Fixed-point numbers|Fixed-Point number]]<br />
|-<br />
| Y<br />
| Int<br />
| Y position as a [[Data Types#Fixed-point numbers|Fixed-Point number]]<br />
|-<br />
| Z<br />
| Int<br />
| Z position as a [[Data Types#Fixed-point numbers|Fixed-Point number]]<br />
|-<br />
| Pitch<br />
| Angle<br />
| <br />
|-<br />
| Yaw<br />
| Angle<br />
| <br />
|-<br />
| Data<br />
| [[Object Data]]<br />
| <br />
|}<br />
<br />
==== 生成怪物 ====<br />
<br />
Sent by the server when a Mob Entity is Spawned<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="12"| 0x0F<br />
|rowspan="12"| Play<br />
|rowspan="12"| Client<br />
| Entity ID<br />
| VarInt<br />
| <br />
|-<br />
| Type<br />
| Unsigned Byte<br />
| The type of mob. See [[Entities#Mobs|Mobs]]<br />
|-<br />
| X<br />
| Int<br />
| X position as a [[Data Types#Fixed-point numbers|Fixed-Point number]] <br />
|-<br />
| Y<br />
| Int<br />
| Y position as a [[Data Types#Fixed-point numbers|Fixed-Point number]] <br />
|-<br />
| Z<br />
| Int<br />
| Z position as a [[Data Types#Fixed-point numbers|Fixed-Point number]] <br />
|-<br />
| Yaw<br />
| Angle<br />
| <br />
|-<br />
| Pitch<br />
| Angle<br />
| <br />
|-<br />
| Head Pitch<br />
| Angle<br />
| <br />
|-<br />
| Velocity X<br />
| Short<br />
| Same units as [[#Entity Velocity|Entity Velocity]]<br />
|-<br />
| Velocity Y<br />
| Short<br />
| Same units as [[#Entity Velocity|Entity Velocity]]<br />
|-<br />
| Velocity Z<br />
| Short<br />
| Same units as [[#Entity Velocity|Entity Velocity]]<br />
|-<br />
| Metadata<br />
| [[Entities#Entity Metadata Format|Metadata]]<br />
| <br />
|}<br />
<br />
==== 重生绘图 ====<br />
<br />
This packet shows location, name, and type of painting.<br />
<br />
Calculating the center of an image: given a (width x height) grid of cells, with (0, 0) being the top left corner, the center is (max(0, width / 2 - 1), height / 2). E.g.<br />
<br />
2x1 (1, 0)<br />
4x4 (1, 2)<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="4"| 0x10<br />
|rowspan="4"| Play<br />
|rowspan="4"| Client<br />
| Entity ID<br />
| VarInt<br />
| <br />
|-<br />
| Title<br />
| String<br />
| Name of the painting. Max length 13<br />
|-<br />
| Location<br />
| Position<br />
| Center coordinates<br />
|-<br />
| Direction<br />
| Unsigned Byte<br />
| Direction the painting faces. 0: north (-z), 1: west (-x), 2: south (+z), 3: east (+x)<br />
|}<br />
<br />
==== 重生掉落经验 ====<br />
<br />
Spawns one or more experience orbs.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="5"| 0x11<br />
|rowspan="5"| Play<br />
|rowspan="5"| Client<br />
| Entity ID<br />
| VarInt<br />
| Entity's ID<br />
|-<br />
| X<br />
| Int<br />
| X position as a [[Data Types#Fixed-point numbers|Fixed-Point number]]<br />
|-<br />
| Y<br />
| Int<br />
| Y position as a [[Data Types#Fixed-point numbers|Fixed-Point number]]<br />
|-<br />
| Z<br />
| Int<br />
| Z position as a [[Data Types#Fixed-point numbers|Fixed-Point number]]<br />
|-<br />
| Count<br />
| Short<br />
| The amount of experience this orb will reward once collected<br />
|}<br />
<br />
==== 实体速率 ====<br />
<br />
Velocity is believed to be in units of 1/8000 of a block per server tick (50ms); for example, -1343 would move (-1343 / 8000) = −0.167875 blocks per tick (or −3,3575 blocks per second).<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="4"| 0x12<br />
|rowspan="4"| Play<br />
|rowspan="4"| Client<br />
| Entity ID<br />
| VarInt<br />
| <br />
|-<br />
| Velocity X<br />
| Short<br />
| Velocity on the X axis<br />
|-<br />
| Velocity Y<br />
| Short<br />
| Velocity on the Y axis<br />
|-<br />
| Velocity Z<br />
| Short<br />
| Velocity on the Z axis<br />
|}<br />
<br />
==== 销毁实体 ====<br />
<br />
Sent by the server when a list of entities is to be destroyed on the client.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="2"| 0x13<br />
|rowspan="2"| Play<br />
|rowspan="2"| Client<br />
| Count<br />
| VarInt<br />
| Number of elements in the following array<br />
|-<br />
| Entity IDs<br />
| Array of VarInt<br />
| The list of entities of destroy<br />
|}<br />
<br />
==== 实体 ====<br />
<br />
This packet may be used to initialize an entity.<br />
<br />
For player entities, either this packet or any move/look packet is sent every game tick. So the meaning of this packet is basically that the entity did not move/look since the last such packet.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="1"| 0x14<br />
|rowspan="1"| Play<br />
|rowspan="1"| Client<br />
| Entity ID<br />
| VarInt<br />
| <br />
|}<br />
<br />
==== 实体相对移动 ====<br />
<br />
This packet is sent by the server when an entity moves less then 4 blocks; if an entity moves more than 4 blocks [[#Entity Teleport|Entity Teleport]] should be sent instead.<br />
<br />
This packet allows at most four blocks movement in any direction, because byte range is from -128 to 127.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="5"| 0x15<br />
|rowspan="5"| Play<br />
|rowspan="5"| Client<br />
| Entity ID<br />
| VarInt<br />
| <br />
|-<br />
| Delta X<br />
| Byte<br />
| Change in X position as a [[Data Types#Fixed-point numbers|Fixed-Point number]]<br />
|-<br />
| Delta Y<br />
| Byte<br />
| Change in Y position as a [[Data Types#Fixed-point numbers|Fixed-Point number]]<br />
|-<br />
| Delta Z<br />
| Byte<br />
| Change in Z position as a [[Data Types#Fixed-point numbers|Fixed-Point number]]<br />
|-<br />
| On Ground<br />
| Boolean<br />
| <br />
|}<br />
<br />
==== 实体朝向 ====<br />
<br />
This packet is sent by the server when an entity rotates.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="5"| 0x16<br />
|rowspan="5"| Play<br />
|rowspan="5"| Client<br />
| Entity ID<br />
| VarInt<br />
| <br />
|-<br />
| Yaw<br />
| Angle<br />
| New angle, not a delta<br />
|-<br />
| Pitch<br />
| Angle<br />
| New angle, not a delta<br />
|-<br />
| On Ground<br />
| Boolean<br />
| <br />
|}<br />
<br />
==== 实体朝向与相对移动 ====<br />
<br />
This packet is sent by the server when an entity rotates and moves. Since a byte range is limited from -128 to 127, and movement is offset of fixed-point numbers, this packet allows at most four blocks movement in any direction. (-128/32 == -4)<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="7"| 0x17<br />
|rowspan="7"| Play<br />
|rowspan="7"| Client<br />
| Entity ID<br />
| VarInt<br />
| <br />
|-<br />
| Delta X<br />
| Byte<br />
| Change in X position as a [[Data Types#Fixed-point numbers|Fixed-Point number]]<br />
|-<br />
| Delta Y<br />
| Byte<br />
| Change in Y position as a [[Data Types#Fixed-point numbers|Fixed-Point number]]<br />
|-<br />
| Delta Z<br />
| Byte<br />
| Change in Z position as a [[Data Types#Fixed-point numbers|Fixed-Point number]]<br />
|-<br />
| Yaw<br />
| Angle<br />
| New angle, not a delta<br />
|-<br />
| Pitch<br />
| Angle<br />
| New angle, not a delta<br />
|-<br />
| On Ground<br />
| Boolean<br />
| <br />
|}<br />
<br />
==== 实体传送 ====<br />
<br />
This packet is sent by the server when an entity moves more than 4 blocks.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="7"| 0x18<br />
|rowspan="7"| Play<br />
|rowspan="7"| Client<br />
| Entity ID<br />
| VarInt<br />
| <br />
|-<br />
| X<br />
| Int<br />
| X position as a [[Data Types#Fixed-point numbers|Fixed-Point number]]<br />
|-<br />
| Y<br />
| Int<br />
| Y position as a [[Data Types#Fixed-point numbers|Fixed-Point number]]<br />
|-<br />
| Z<br />
| Int<br />
| Z position as a [[Data Types#Fixed-point numbers|Fixed-Point number]]<br />
|-<br />
| Yaw<br />
| Angle<br />
| New angle, not a delta<br />
|-<br />
| Pitch<br />
| Angle<br />
| New angle, not a delta<br />
|-<br />
| On Ground<br />
| Boolean<br />
| <br />
|}<br />
<br />
==== 实体手朝向 ====<br />
<br />
Changes the direction an entity's head is facing.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="2"| 0x19<br />
|rowspan="2"| Play<br />
|rowspan="2"| Client<br />
| Entity ID<br />
| VarInt<br />
| <br />
|-<br />
| Head Yaw<br />
| Angle<br />
| New angle, not a delta<br />
|}<br />
<br />
==== 实体状态 ====<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="2"| 0x1A<br />
|rowspan="2"| Play<br />
|rowspan="2"| Client<br />
| Entity ID<br />
| Int<br />
| <br />
|-<br />
| Entity Status<br />
| Byte<br />
| See below<br />
|}<br />
<br />
{| class="wikitable"<br />
|-<br />
! Entity Status<br />
! Meaning<br />
|-<br />
| 1<br />
| Sent when resetting a mob spawn minecart's timer - appears to be unused by the client<br />
|-<br />
| 2<br />
| Living Entity hurt <br />
|-<br />
| 3<br />
| Living Entity dead<br />
|-<br />
| 4<br />
| Iron Golem throwing up arms<br />
|-<br />
| 6<br />
| Wolf/Ocelot/Horse taming — Spawn “heart” particles<br />
|-<br />
| 7<br />
| Wolf/Ocelot/Horse tamed — Spawn “smoke” particles<br />
|-<br />
| 8<br />
| Wolf shaking water — Trigger the shaking animation<br />
|-<br />
| 9<br />
| (of self) Eating accepted by server<br />
|-<br />
| 10<br />
| Sheep eating grass<br />
|-<br />
| 10<br />
| Play TNT ignite sound<br />
|-<br />
| 11<br />
| Iron Golem handing over a rose<br />
|-<br />
| 12<br />
| Villager mating — Spawn “heart” particles<br />
|-<br />
| 13<br />
| Spawn particles indicating that a villager is angry and seeking revenge<br />
|-<br />
| 14<br />
| Spawn happy particles near a villager<br />
|-<br />
| 15<br />
| Witch animation — Spawn “magic” particles<br />
|-<br />
| 16<br />
| Play zombie converting into a villager sound<br />
|-<br />
| 17<br />
| Firework exploding<br />
|-<br />
| 18<br />
| Animal in love (ready to mate) — Spawn “heart” particles<br />
|-<br />
| 19<br />
| Reset squid rotation<br />
|-<br />
| 20<br />
| Spawn explosion particle — works for some living entities<br />
|-<br />
| 21<br />
| Play guardian sound — works for every entity<br />
|-<br />
| 22<br />
| Enables reduced debug for players<br />
|-<br />
| 23<br />
| Disables reduced debug for players<br />
|}<br />
<br />
==== 附加实体 ====<br />
<br />
This packet is sent when a player has been attached to an entity (e.g. Minecart).<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="3"| 0x1B<br />
|rowspan="3"| Play<br />
|rowspan="3"| Client<br />
| Entity ID<br />
| Int<br />
| Attached entity's EID. Set to -1 to detach.<br />
|-<br />
| Vehicle ID<br />
| Int<br />
| Vechicle's Entity ID<br />
|-<br />
| Leash<br />
| Boolean<br />
| If true leashes the entity to the vehicle<br />
|}<br />
<br />
==== 实体数据值 ====<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="2"| 0x1C<br />
|rowspan="2"| Play<br />
|rowspan="2"| Client<br />
| Entity ID<br />
| VarInt<br />
| <br />
|-<br />
| Metadata<br />
| [[Entities#Entity Metadata Format|Metadata]]<br />
| <br />
|}<br />
<br />
==== 实体属性 ====<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="5"| 0x1D<br />
|rowspan="5"| Play<br />
|rowspan="5"| Client<br />
| Entity ID<br />
| VarInt<br />
| <br />
|-<br />
| Effect ID<br />
| Byte<br />
| See {{Minecraft Wiki|Status effect#List of effects|this table}}<br />
|-<br />
| Amplifier<br />
| Byte<br />
| Notchian client displays effect level as Amplifier + 1<br />
|-<br />
| Duration<br />
| VarInt<br />
| Seconds<br />
|-<br />
| Hide Particles<br />
| Boolean<br />
| <br />
|}<br />
<br />
==== 移除实体属性 ====<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="2"| 0x1E<br />
|rowspan="2"| Play<br />
|rowspan="2"| Client<br />
| Entity ID<br />
| VarInt<br />
| <br />
|-<br />
| Effect ID<br />
| Byte<br />
| See {{Minecraft Wiki|Status effect#List of effects|this table}}<br />
|}<br />
<br />
==== 设置经验值 ====<br />
<br />
Sent by the server when the client should change experience levels.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="3"| 0x1F<br />
|rowspan="3"| Play<br />
|rowspan="3"| Client<br />
| Experience bar<br />
| Float<br />
| Between 0 and 1<br />
|-<br />
| Level<br />
| VarInt<br />
| <br />
|-<br />
| Total Experience<br />
| VarInt<br />
| See {{Minecraft Wiki|Experience#Leveling up}} on the Minecraft Wiki for Total Experience to Level conversion<br />
|}<br />
<br />
==== 实体配置 ====<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
!colspan="2"| Field Name<br />
!colspan="2"| Field Type<br />
! Notes<br />
|-<br />
|rowspan="6"| 0x20<br />
|rowspan="6"| Play<br />
|rowspan="6"| Client<br />
|colspan="2"| Entity ID<br />
|colspan="2"| VarInt<br />
| <br />
|-<br />
|colspan="2"| Number Of Properties<br />
|colspan="2"| Int<br />
| Number of elements in the following array<br />
|-<br />
|rowspan="4"| Property<br />
| Key<br />
|rowspan="4"| Array<br />
| String<br />
| See below<br />
|-<br />
| Value<br />
| Double<br />
| See below<br />
|-<br />
| Number Of Modifiers<br />
| VarInt<br />
| Number of elements in the following array<br />
|-<br />
| Modifiers<br />
| Array of Modifier Data<br />
| See {{Minecraft Wiki|Attribute#Modifiers}}<br />
|}<br />
<br />
Known Key values:<br />
<br />
{| class="wikitable"<br />
|-<br />
! Key<br />
! Default<br />
! Min<br />
! Max<br />
! Label<br />
|-<br />
| generic.maxHealth<br />
| 20.0<br />
| 0.0<br />
| Double.MaxValue<br />
| Max Health<br />
|-<br />
| generic.followRange<br />
| 32.0<br />
| 0.0<br />
| 2048.0<br />
| Follow Range<br />
|-<br />
| generic.knockbackResistance<br />
| 0.0 <br />
| 0.0<br />
| 1.0<br />
| Knockback Resistance<br />
|-<br />
| generic.movementSpeed<br />
| 0.699999988079071<br />
| 0.0<br />
| Double.MaxValue<br />
| Movement Speed<br />
|-<br />
| generic.attackDamage<br />
| 2.0<br />
| 0.0<br />
| Double.MaxValue<br />
| <br />
|-<br />
| horse.jumpStrength<br />
| 0.7<br />
| 0.0<br />
| 2.0<br />
| Jump Strength<br />
|-<br />
| zombie.spawnReinforcements<br />
| 0.0<br />
| 0.0<br />
| 1.0<br />
| Spawn Reinforcements Chance<br />
|}<br />
<br />
''Modifier Data'' structure:<br />
<br />
{| class="wikitable"<br />
|-<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
| UUID<br />
| UUID<br />
| <br />
|-<br />
| Amount<br />
| Double<br />
| <br />
|-<br />
| Operation<br />
| Byte<br />
| <br />
|}<br />
<br />
==== 区块数据 ====<br />
<br />
Chunks are not unloaded by the client automatically. To unload chunks, send this packet with Ground-Up Continuous=true and no 16^3 chunks (eg. Primary Bit Mask=0). The server does not send skylight information for nether-chunks, it's up to the client to know if the player is currently in the nether. You can also infer this information from the primary bitmask and the amount of uncompressed bytes sent.<br />
<br />
See also: [[SMP Map Format]]<br />
<br />
Changes in 1.8:<br />
<br />
* Data value section removed<br />
* Extended id section removed<br />
* Block id section is now a unsigned short (little endian) per a block<br />
* The block id is equal to <code>(id << 4) | data</code><br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="6"| 0x21<br />
|rowspan="6"| Play<br />
|rowspan="6"| Client<br />
| Chunk X<br />
| Int<br />
| Chunk X coordinate<br />
|-<br />
| Chunk Z<br />
| Int<br />
| Chunk Z coordinate<br />
|-<br />
| Ground-Up Continuous<br />
| Boolean<br />
| This is true if the packet represents all sections in this vertical column, where the Primary Bit Mask specifies exactly which sections are included, and which are air<br />
|-<br />
| Primary Bit Mask<br />
| Unsigned Short<br />
| Bitmask with 1 for every 16x16x16 section whose data follows in the compressed data<br />
|- <br />
| Size<br />
| VarInt<br />
| Size of Data<br />
|-<br />
| Data<br />
| [[SMP Map Format#Data|Chunk]]<br />
| <br />
|}<br />
<br />
==== 多个方块改变 ====<br />
Fired whenever 2 or more blocks are changed within the render distance.<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
!colspan="2"| Field Name<br />
!colspan="2"| Field Type<br />
! Notes<br />
|-<br />
|rowspan="6"| 0x22<br />
|rowspan="6"| Play<br />
|rowspan="6"| Client<br />
|colspan="2"| Chunk X<br />
|colspan="2"| Int<br />
| Chunk X coordinate<br />
|-<br />
|colspan="2"| Chunk Z<br />
|colspan="2"| Int<br />
| Chunk Z coordinate<br />
|-<br />
|colspan="2"| Record Count<br />
|colspan="2"| VarInt<br />
| Number of elements in the following array, a.k.a. the number of blocks affected<br />
|-<br />
|rowspan="3"| Record<br />
| Horizontal Position<br />
|rowspan="3"| Array<br />
| Unsigned Byte<br />
| The 4 most significant bits (<code>0xF0</code>) encode the X coordinate, relative to the chunk. The 4 least significant bits (<code>0x0F</code>) encode the Z coordinate, relative to the chunk.<br />
|-<br />
| Y Coordinate<br />
| Unsigned Byte<br />
| <br />
|-<br />
| Block ID<br />
| VarInt<br />
| The new block ID for the block. <code><nowiki>id &lt;&lt; 4 | data</nowiki></code><br />
|}<br />
<br />
==== 方块改变 ====<br />
Fired whenever a block is changed within the render distance.<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="2"| 0x23<br />
|rowspan="2"| Play<br />
|rowspan="2"| Client<br />
| Location<br />
| Position<br />
| Block Coordinates<br />
|-<br />
| Block ID<br />
| VarInt<br />
| The new block ID for the block. <code><nowiki>id &lt;&lt; 4 | data</nowiki></code><br />
|}<br />
<br />
==== 方块功能 ====<br />
<br />
This packet is used for a number of things:<br />
<br />
* Chests opening and closing<br />
* Pistons pushing and pulling<br />
* Note blocks playing<br />
* Updating beacons<br />
<br />
See Also: [[Block Actions]] <br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="4"| 0x24<br />
|rowspan="4"| Play<br />
|rowspan="4"| Client<br />
| Location<br />
| Position<br />
| Block Coordinates<br />
|-<br />
| Byte 1<br />
| Unsigned Byte<br />
| Varies depending on block — see [[Block Actions]]<br />
|-<br />
| Byte 2<br />
| Unsigned Byte<br />
| Varies depending on block — see [[Block Actions]]<br />
|-<br />
| Block Type<br />
| VarInt<br />
| The block type for the block<br />
|}<br />
<br />
==== 方块破坏动画 ====<br />
<br />
0–9 are the displayable destroy stages and each other number means that there is no animation on this coordinate.<br />
<br />
You can also set an animation to air! The animation will still be visible.<br />
<br />
If you need to display several break animations at the same time you have to give each of them a unique Entity ID.<br />
<br />
Also if you set the coordinates to a special block like water etc. it won't show the actual break animation but some other interesting effects. (Water will lose it's transparency)<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="3"| 0x25<br />
|rowspan="3"| Play<br />
|rowspan="3"| Client<br />
| Entity ID<br />
| VarInt<br />
| EID for the animation<br />
|-<br />
| Location<br />
| Position<br />
| Block Position<br />
|-<br />
| Destroy Stage<br />
| Byte<br />
| 0–9 to set it, any other value to remove it<br />
|}<br />
<br />
==== 地图区块 ====<br />
<br />
1.8 changes at [[#Chunk Data|Chunk Data]]<br />
<br />
To reduce the number of bytes, this packet is used to send chunks together for better compression results.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
!colspan="2"| Field Name<br />
!colspan="2"| Field Type<br />
! Notes<br />
|-<br />
|rowspan="7"| 0x26<br />
|rowspan="7"| Play<br />
|rowspan="7"| Client<br />
|colspan="2"| Sky Light Sent<br />
|colspan="2"| Boolean<br />
| Whether or not Chunk Data contains light nibble arrays. This is true in the Overworld, false in the End + Nether<br />
|-<br />
|colspan="2"| Chunk Column Count<br />
|colspan="2"| VarInt<br />
| Number of elements in each of the following arrays<br />
|-<br />
|rowspan="3"| Chunk Meta<br />
| Chunk X<br />
|rowspan="3"| Array<br />
| Int<br />
| The X coordinate of the chunk<br />
|-<br />
| Chunk Z<br />
| Int<br />
| The Z coordinate of the chunk<br />
|-<br />
| Primary Bit Mask<br />
| Unsigned Short<br />
| A bit mask which specifies which sections are not empty in this chunk<br />
|-<br />
|colspan="2"| Chunk Data<br />
|colspan="2"| Array of [[SMP Map Format#Data|Chunk]]<br />
| Each chunk in this array corresponds to the data at the same position in Chunk Meta<br />
|}<br />
<br />
==== 爆炸 ====<br />
<br />
Sent when an explosion occurs (creepers, TNT, and ghast fireballs).<br />
<br />
Each block in Records is set to air. Coordinates for each axis in record is int(X) + record.x<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="9"| 0x27<br />
|rowspan="9"| Play<br />
|rowspan="9"| Client<br />
| X<br />
| Float<br />
| <br />
|-<br />
| Y<br />
| Float<br />
| <br />
|-<br />
| Z<br />
| Float<br />
| <br />
|-<br />
| Radius<br />
| Float<br />
| Currently unused in the client<br />
|-<br />
| Record Count<br />
| Int<br />
| Number of elements in the following array<br />
|-<br />
| Records<br />
| Array of (Byte, Byte, Byte)<br />
| Each record is 3 signed bytes long, each bytes are the XYZ (respectively) offsets of affected blocks.<br />
|-<br />
| Player Motion X<br />
| Float<br />
| X velocity of the player being pushed by the explosion<br />
|-<br />
| Player Motion Y<br />
| Float<br />
| Y velocity of the player being pushed by the explosion<br />
|-<br />
| Player Motion Z<br />
| Float<br />
| Z velocity of the player being pushed by the explosion<br />
|}<br />
<br />
==== 属性 ====<br />
<br />
Sent when a client is to play a sound or particle effect.<br />
<br />
By default, the Minecraft client adjusts the volume of sound effects based on distance. The final boolean field is used to disable this, and instead the effect is played from 2 blocks away in the correct direction. Currently this is only used for effect 1013 (mob.wither.spawn), and is ignored for any other value by the client.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="4"| 0x28<br />
|rowspan="4"| Play<br />
|rowspan="4"| Client<br />
| Effect ID<br />
| Int<br />
| The ID of the effect, see below<br />
|-<br />
| Location<br />
| Position<br />
| The location of the effect<br />
|-<br />
| Data<br />
| Int<br />
| Extra data for certain effects, see below<br />
|-<br />
| Disable Relative Volume<br />
| Boolean<br />
| See above<br />
|}<br />
<br />
Effect IDs:<br />
<br />
{| class="wikitable"<br />
! ID<br />
! Name<br />
! Data<br />
|-<br />
!colspan="3"| Sound<br />
|-<br />
| 1000<br />
| <code>random.click</code><br />
| <br />
|-<br />
| 1001<br />
| <code>random.click</code><br />
| <br />
|-<br />
| 1002<br />
| <code>random.bow</code><br />
| <br />
|-<br />
| 1003<br />
| <code>random.door_open</code> or <code>random.door_close</code> (50/50 chance)<br />
| <br />
|-<br />
| 1004<br />
| <code>random.fizz</code><br />
| <br />
|-<br />
| 1005<br />
| Play a music disc.<br />
| {{Minecraft Wiki|Music Discs|Record ID}}<br />
|-<br />
| 1006<br />
| ''not assigned''<br />
| <br />
|-<br />
| 1007<br />
| <code>mob.ghast.charge</code><br />
| <br />
|-<br />
| 1008<br />
| <code>mob.ghast.fireball</code><br />
| <br />
|-<br />
| 1009<br />
| <code>mob.ghast.fireball</code>, but with a lower volume<br />
| <br />
|-<br />
| 1010<br />
| <code>mob.zombie.wood</code><br />
| <br />
|-<br />
| 1011<br />
| <code>mob.zombie.metal</code><br />
| <br />
|-<br />
| 1012<br />
| <code>mob.zombie.woodbreak</code><br />
| <br />
|-<br />
| 1013<br />
| <code>mob.wither.spawn</code><br />
| <br />
|-<br />
| 1014<br />
| <code>mob.wither.shoot</code><br />
| <br />
|-<br />
| 1015<br />
| <code>mob.bat.takeoff</code><br />
| <br />
|-<br />
| 1016<br />
| <code>mob.zombie.infect</code><br />
| <br />
|-<br />
| 1017<br />
| <code>mob.zombie.unfect</code><br />
| <br />
|-<br />
| 1018<br />
| <code>mob.enderdragon.end</code><br />
| <br />
|-<br />
| 1020<br />
| <code>random.anvil_break</code><br />
| <br />
|-<br />
| 1021<br />
| <code>random.anvil_use</code><br />
| <br />
|-<br />
| 1022<br />
| <code>random.anvil_land</code><br />
| <br />
|-<br />
!colspan="3"| Particle<br />
|-<br />
| 2000<br />
| Spawns 10 smoke particles, e.g. from a fire<br />
| Direction, see below<br />
|-<br />
| 2001<br />
| Block break<br />
| {{Minecraft Wiki|Data values|Block ID}}<br />
|-<br />
| 2002<br />
| Splash potion. Particle effect + glass break sound.<br />
| [http://www.lb-stuff.com/Minecraft/PotionDataValues1.9pre3.txt Potion ID]<br />
|-<br />
| 2003<br />
| Eye of Ender entity break animation — particles and sound<br />
| <br />
|-<br />
| 2004<br />
| Mob spawn particle effect: smoke + flames<br />
| <br />
|-<br />
| 2005<br />
| Spawn “happy villager” effect (green crosses), used for bonemealing vegetation<br />
| <br />
|}<br />
<br />
Smoke directions:<br />
<br />
{| class="wikitable"<br />
! ID<br />
! Direction<br />
|-<br />
| 0<br />
| South-East<br />
|-<br />
| 1<br />
| South<br />
|-<br />
| 2<br />
| South-West<br />
|-<br />
| 3<br />
| East<br />
|-<br />
| 4<br />
| (Up or middle ?)<br />
|-<br />
| 5<br />
| West<br />
|-<br />
| 6<br />
| North-East<br />
|-<br />
| 7<br />
| North<br />
|-<br />
| 8<br />
| North-West<br />
|}<br />
<br />
==== 声音特效 ====<br />
<br />
Used to play a sound effect on the client.<br />
<br />
Custom sounds may be added by resource packs.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="6"| 0x29<br />
|rowspan="6"| Play<br />
|rowspan="6"| Client<br />
| Sound name<br />
| String<br />
| All known sound effect names can be seen [https://github.com/SirCmpwn/Craft.Net/blob/master/source/Craft.Net.Common/SoundEffect.cs here]<br />
|-<br />
| Effect position X<br />
| Int<br />
| Effect X multiplied by 8<br />
|-<br />
| Effect position Y<br />
| Int<br />
| Effect Y multiplied by 8<br />
|-<br />
| Effect position Z<br />
| Int<br />
| Effect Z multiplied by 8<br />
|-<br />
| Volume<br />
| Float<br />
| 1 is 100%, can be more<br />
|-<br />
| Pitch<br />
| Unsigned Byte<br />
| 63 is 100%, can be more<br />
|}<br />
<br />
==== 粒子效果 ====<br />
<br />
Displays the named particle<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="11"| 0x2A<br />
|rowspan="11"| Play<br />
|rowspan="11"| Client<br />
| Particle ID<br />
| Int<br />
| See below<br />
|-<br />
| Long Distance<br />
| Boolean<br />
| If true, particle distance increases from 256 to 65536<br />
|-<br />
| X<br />
| Float<br />
| X position of the particle<br />
|-<br />
| Y<br />
| Float<br />
| Y position of the particle<br />
|-<br />
| Z<br />
| Float<br />
| Z position of the particle<br />
|-<br />
| Offset X<br />
| Float<br />
| This is added to the X position after being multiplied by random.nextGaussian()<br />
|-<br />
| Offset Y<br />
| Float<br />
| This is added to the Y position after being multiplied by random.nextGaussian()<br />
|-<br />
| Offset Z<br />
| Float<br />
| This is added to the Z position after being multiplied by random.nextGaussian()<br />
|-<br />
| Particle Data<br />
| Float<br />
| The data of each particle<br />
|-<br />
| Particle Count<br />
| Int<br />
| The number of particles to create<br />
|-<br />
| Data<br />
| Array of VarInt<br />
| Length depends on particle. "iconcrack" has length of 2, "blockcrack", and "blockdust" have lengths of 1, the rest have 0.<br />
|}<br />
<br />
Particle IDs:<br />
<br />
{| class="wikitable"<br />
|-<br />
! Particle Name<br />
! Particle ID<br />
|-<br />
| explode<br />
| 0<br />
|-<br />
| largeexplosion<br />
| 1<br />
|-<br />
| hugeexplosion<br />
| 2<br />
|-<br />
| fireworksSpark<br />
| 3<br />
|-<br />
| bubble<br />
| 4<br />
|-<br />
| splash<br />
| 5<br />
|-<br />
| wake<br />
| 6<br />
|-<br />
| suspended<br />
| 7<br />
|-<br />
| depthsuspend<br />
| 8<br />
|-<br />
| crit<br />
| 9<br />
|-<br />
| magicCrit<br />
| 10<br />
|-<br />
| smoke<br />
| 11<br />
|-<br />
| largesmoke<br />
| 12<br />
|-<br />
| spell<br />
| 13<br />
|-<br />
| instantSpell<br />
| 14<br />
|-<br />
| mobSpell<br />
| 15<br />
|-<br />
| mobSpellAmbient<br />
| 16<br />
|-<br />
| witchMagic<br />
| 17<br />
|-<br />
| dripWater<br />
| 18<br />
|-<br />
| dripLava<br />
| 19<br />
|-<br />
| angryVillager<br />
| 20<br />
|-<br />
| happyVillager<br />
| 21<br />
|-<br />
| townaura<br />
| 22<br />
|-<br />
| note<br />
| 23<br />
|-<br />
| portal<br />
| 24<br />
|-<br />
| enchantmenttable<br />
| 25<br />
|-<br />
| flame<br />
| 26<br />
|-<br />
| lava<br />
| 27<br />
|-<br />
| footstep<br />
| 28<br />
|-<br />
| cloud<br />
| 29<br />
|-<br />
| reddust<br />
| 30<br />
|-<br />
| snowballpoof<br />
| 31<br />
|-<br />
| snowshovel<br />
| 32<br />
|-<br />
| slime<br />
| 33<br />
|-<br />
| heart<br />
| 34<br />
|-<br />
| barrier<br />
| 35<br />
|-<br />
| iconcrack_(id)_(data)<br />
| 36<br />
|-<br />
| blockcrack_(id+(data<<12))<br />
| 37<br />
|-<br />
| blockdust_(id)<br />
| 38<br />
|-<br />
| droplet<br />
| 39<br />
|-<br />
| take<br />
| 40<br />
|-<br />
| mobappearance<br />
| 41<br />
|}<br />
<br />
==== 改变游戏状态 ====<br />
<br />
It appears when a bed can't be used as a spawn point and when the rain state changes.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="2"| 0x2B<br />
|rowspan="2"| Play<br />
|rowspan="2"| Client<br />
| Reason<br />
| Unsigned Byte<br />
| See below<br />
|-<br />
| Value<br />
| Float<br />
| Depends on Reason<br />
|}<br />
<br />
''Reason codes'':<br />
<br />
{| class="wikitable"<br />
! Reason<br />
! Effect<br />
! Value<br />
|-<br />
| 0<br />
| Invalid Bed<br />
| <br />
|-<br />
| 1<br />
| End raining<br />
| <br />
|-<br />
| 2<br />
| Begin raining<br />
| <br />
|-<br />
| 3<br />
| Change game mode<br />
| 0: Survival, 1: Creative, 2: Adventure, 3: Spectator<br />
|-<br />
| 4<br />
| Enter credits<br />
| <br />
|-<br />
| 5<br />
| Demo message<br />
| 0: Show welcome to demo screen, 101: Tell movement controls, 102: Tell jump control, 103: Tell inventory control<br />
|- <br />
| 6<br />
| Arrow hitting player<br />
| Appears to be played when an arrow strikes another player in Multiplayer<br />
|-<br />
| 7<br />
| Fade value<br />
| The current darkness value. 1 = Dark, 0 = Bright, Setting the value higher causes the game to change color and freeze<br />
|-<br />
| 8<br />
| Fade time<br />
| Time in ticks for the sky to fade<br />
|-<br />
| 10<br />
| Play mob appearance (effect and sound)<br />
| Unknown<br />
|}<br />
<br />
==== 生存全局实体 ====<br />
<br />
With this packet, the server notifies the client of thunderbolts striking within a 512 block radius around the player. The coordinates specify where exactly the thunderbolt strikes.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="5"| 0x2C<br />
|rowspan="5"| Play<br />
|rowspan="5"| Client<br />
| Entity ID<br />
| VarInt<br />
| The EID of the thunderbolt<br />
|-<br />
| Type<br />
| Byte<br />
| The global entity type, currently always 1 for thunderbolt<br />
|-<br />
| X<br />
| Int<br />
| Thunderbolt X, a [[Data Types#Fixed-point numbers|fixed-point number]]<br />
|-<br />
| Y<br />
| Int<br />
| Thunderbolt Y, a [[Data Types#Fixed-point numbers|fixed-point number]]<br />
|-<br />
| Z<br />
| Int<br />
| Thunderbolt Z, a [[Data Types#Fixed-point numbers|fixed-point number]]<br />
|}<br />
<br />
==== 打开窗户 ====<br />
<br />
This is sent to the client when it should open an inventory, such as a chest, workbench, or furnace. This message is not sent anywhere for clients opening their own inventory.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="5"| 0x2D<br />
|rowspan="5"| Play<br />
|rowspan="5"| Client<br />
| Window ID<br />
| Unsigned Byte<br />
| A unique id number for the window to be displayed. Notchian server implementation is a counter, starting at 1.<br />
|-<br />
| Window Type<br />
| String<br />
| The window type to use for display. See [[Inventory]] for a list.<br />
|-<br />
| Window Title<br />
| [[Chat]]<br />
| The title of the window<br />
|-<br />
| Number Of Slots<br />
| Unsigned Byte<br />
| Number of slots in the window (excluding the number of slots in the player inventory)<br />
|-<br />
| Entity ID<br />
| Optional Int<br />
| EntityHorse's EID. Only sent when Window Type is “EntityHorse”<br />
|}<br />
<br />
See [[Inventory]] for further information.<br />
<br />
==== 关闭窗户 ====<br />
<br />
This packet is sent from the server to the client when a window is forcibly closed, such as when a chest is destroyed while it's open.<br />
<br />
Note, notchian clients send a close window packet with Window ID 0 to close their inventory even though there is never an [[#Open Window|Open Window]] packet for inventory. <br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
| 0x2E<br />
|rowspan="1"| Play<br />
|rowspan="1"| Client<br />
| Window ID<br />
| Unsigned Byte<br />
| This is the ID of the window that was closed. 0 for inventory.<br />
|}<br />
<br />
==== 设置位置 ====<br />
<br />
Sent by the server when an item in a slot (in a window) is added/removed.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="3"| 0x2F<br />
|rowspan="3"| Play<br />
|rowspan="3"| Client<br />
| Window ID<br />
| Byte<br />
| The window which is being updated. 0 for player inventory. Note that all known window types include the player inventory. This packet will only be sent for the currently opened window while the player is performing actions, even if it affects the player inventory. After the window is closed, a number of these packets are sent to update the player's inventory window (0).<br />
|-<br />
| Slot<br />
| Short<br />
| The slot that should be updated<br />
|-<br />
| Slot Data<br />
| [[Slot Data|Slot]]<br />
| <br />
|}<br />
<br />
==== 窗口物品 ====<br />
<br />
[[File:Inventory-slots.png|thumb|The inventory slots]]<br />
<br />
Sent by the server when items in multiple slots (in a window) are added/removed. This includes the main inventory, equipped armour and crafting slots.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="3"| 0x30<br />
|rowspan="3"| Play<br />
|rowspan="3"| Client<br />
| Window ID<br />
| Unsigned Byte<br />
| The ID of window which items are being sent for. 0 for player inventory.<br />
|-<br />
| Count<br />
| Short<br />
| Number of elements in the following array<br />
|-<br />
| Slot Data<br />
| Array of [[Slot Data|Slot]]<br />
| <br />
|}<br />
<br />
See [[Inventory#Windows|inventory windows]] for further information about how slots are indexed.<br />
<br />
==== 窗体属性 ====<br />
<br />
此包是用于与客户端交流更新GUI窗体的部分。<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="3"| 0x31<br />
|rowspan="3"| Play<br />
|rowspan="3"| Client<br />
| Window ID<br />
| Unsigned Byte<br />
| <br />
|-<br />
| Property<br />
| Short<br />
| 要更新的属性，见下文<br />
|-<br />
| Value<br />
| Short<br />
| 属性的新值，见下文<br />
|}<br />
<br />
属性字段的含义取决于窗体的类型。下表显示了窗体类型和属性的已知组合和价值的定义范围。<br />
<br />
{| class="wikitable"<br />
|-<br />
! Window type<br />
! Property<br />
! Value<br />
|-<br />
|rowspan="2"| Furnace<br />
| 0: Progress arrow<br />
| 0–200 (presumably in in-game ticks)<br />
|-<br />
| 1: Fire icon (fuel)<br />
| 0–200 (presumably in in-game ticks)<br />
|-<br />
|rowspan="7"| Enchantment Table<br />
| 0: Level requirement for top enchantment slot<br />
|rowspan="3"| The enchantment's xp level requirement<br />
|-<br />
| 1: Level requirement for middle enchantment slot<br />
|-<br />
| 2: Level requirement for bottom enchantment slot<br />
|-<br />
| 3: The seed for generating the enchantments view for the client<br />
| Unknown<br />
|-<br />
| 4: tooltip shown on mouse hover over top enchantment slot<br />
|rowspan="3"| Unknown (set to -1 to hide it)<br />
|-<br />
| 5: tooltip shown on mouse hover over middle enchantment slot<br />
|-<br />
| 6: tooltip shown on mouse hover over bottom enchantment slot<br />
|-<br />
|rowspan="3"| Beacon<br />
| 0: Power level<br />
| Unknown<br />
|-<br />
| 1: First potion effect<br />
| Unknown<br />
|-<br />
| 2: Second potion effect<br />
| Unknown<br />
|-<br />
| Anvil<br />
| 0: Repair cost<br />
| The repair's cost in xp levels<br />
|-<br />
| Brewing Stand<br />
| 0: Brew time<br />
| 0–400, with 400 making the arrow empty, and 0 making the arrow full<br />
|}<br />
<br />
==== 确认事物 ====<br />
<br />
A packet from the server indicating whether a request from the client was accepted, or whether there was a conflict (due to lag).<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="3"| 0x32<br />
|rowspan="3"| Play<br />
|rowspan="3"| Client<br />
| Window ID<br />
| Byte<br />
| The ID of the window that the action occurred in<br />
|-<br />
| Action Number<br />
| Short<br />
| Every action that is to be accepted has a unique number. This field corresponds to that number.<br />
|-<br />
| Accepted<br />
| Boolean<br />
| Whether the action was accepted<br />
|}<br />
<br />
==== 更新标志 ====<br />
<br />
This message is sent from the server to the client whenever a sign is discovered or created. This message is NOT sent when a sign is destroyed or unloaded.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="5"| 0x33<br />
|rowspan="5"| Play<br />
|rowspan="5"| Client<br />
| Location<br />
| Position<br />
| <br />
|-<br />
| Line 1<br />
| [[Chat]]<br />
| First line of text in the sign<br />
|-<br />
| Line 2<br />
| [[Chat]]<br />
| Second line of text in the sign<br />
|-<br />
| Line 3<br />
| [[Chat]]<br />
| Third line of text in the sign<br />
|-<br />
| Line 4<br />
| [[Chat]]<br />
| Fourth line of text in the sign<br />
|}<br />
<br />
==== 地图 ====<br />
<br />
Updates a rectangular area on a map.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
!colspan="2"| Field Name<br />
!colspan="2"| Field Type<br />
! Notes<br />
|-<br />
|rowspan="12"| 0x34<br />
|rowspan="12"| Play<br />
|rowspan="12"| Client<br />
|colspan="2"| Item Damage<br />
|colspan="2"| VarInt<br />
| The damage value (map ID) of the map being modified<br />
|-<br />
|colspan="2"| Scale<br />
|colspan="2"| Byte<br />
| <br />
|- <br />
|colspan="2"| Icon Count<br />
|colspan="2"| VarInt<br />
| Number of elements in the following array<br />
|-<br />
|rowspan="3"| Icon<br />
| Direction And Type<br />
|rowspan="3"| Array<br />
| Byte<br />
| 0xF0 = Direction, 0x0F = Type<br />
|-<br />
| X<br />
| Byte<br />
| <br />
|-<br />
| Z<br />
| Byte<br />
| <br />
|- <br />
|colspan="2"| Columns<br />
|colspan="2"| Byte<br />
| Number of columns updated<br />
|-<br />
|colspan="2"| Rows<br />
|colspan="2"| Optional Byte<br />
| Only if Columns is more than 0; number of rows updated<br />
|-<br />
|colspan="2"| X<br />
|colspan="2"| Optional Byte<br />
| Only if Columns is more than 0; x offset of the westernmost column<br />
|-<br />
|colspan="2"| Z<br />
|colspan="2"| Optional Byte<br />
| Only if Columns is more than 0; z offset of the northernmost row<br />
|-<br />
|colspan="2"| Length<br />
|colspan="2"| Optional VarInt<br />
| Only if Columns is more than 0; length of the following array<br />
|-<br />
|colspan="2"| Data<br />
|colspan="2"| Optional Array of Unsigned Byte<br />
| Only if Columns is more than 0; see {{Minecraft Wiki|Map item format}}<br />
|}<br />
<br />
==== 更新方块实体 ====<br />
<br />
Essentially a block update on a block entity.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="3"| 0x35<br />
|rowspan="3"| Play<br />
|rowspan="3"| Client<br />
| Location<br />
| Position<br />
| <br />
|-<br />
| Action<br />
| Unsigned Byte<br />
| The type of update to perform, see below<br />
|-<br />
| NBT Data<br />
| Optional [[NBT|NBT Tag]]<br />
| If not present then it's a TAG_END (0)<br />
|}<br />
<br />
''Action'' field:<br />
<br />
* '''1''': Set SpawnPotentials of a mob spawner<br />
* '''2''': Set command block text (command and last execution status)<br />
* '''3''': Set the level, primary, and secondary powers of a beacon<br />
* '''4''': Set rotation and skin of mob head<br />
* '''5''': Set type of flower in flower pot<br />
* '''6''': Set base color and patterns on a banner<br />
<br />
==== 打开标志牌编辑器 ====<br />
<br />
Sent on placement of sign.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="1"| 0x36<br />
|rowspan="1"| Play<br />
|rowspan="1"| Client<br />
| Location<br />
| Position<br />
| <br />
|}<br />
<br />
==== 统计数据 ====<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To <br />
!colspan="2"| Field Name<br />
!colspan="2"| Field Type<br />
! Notes<br />
|-<br />
|rowspan="3"| 0x37<br />
|rowspan="3"| Play<br />
|rowspan="3"| Client<br />
|colspan="2"| Count<br />
|colspan="2"| VarInt<br />
| Number of elements in the following array<br />
|-<br />
|rowspan="2"| Statistic<br />
| Name<br />
|rowspan="2"| Array<br />
| String<br />
| [https://gist.github.com/thinkofdeath/a1842c21a0cf2e1fb5e0 https://gist.github.com/thinkofdeath/a1842c21a0cf2e1fb5e0]<br />
|-<br />
| Value<br />
| VarInt<br />
| The amount to set it to<br />
|}<br />
<br />
==== 玩家列表项 ====<br />
<br />
Sent by the notchian server to update the user list (<tab> in the client).<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
!colspan="4"| Field Name<br />
!colspan="3"| Field Type<br />
! Notes<br />
|-<br />
|rowspan="19"| 0x38<br />
|rowspan="19"| Play<br />
|rowspan="19"| Client<br />
|colspan="4"| Action<br />
|colspan="3"| VarInt<br />
| Determines the rest of the Player format after the UUID<br />
|-<br />
|colspan="4"| Number Of Players<br />
|colspan="3"| VarInt<br />
| Number of elements in the following array<br />
|-<br />
|rowspan="17"| Player<br />
|colspan="3"| UUID<br />
|rowspan="17"| Array<br />
|colspan="2"| UUID<br />
| <br />
|-<br />
! Action<br />
!colspan="2"| Field Name<br />
!colspan="2"| <br />
! <br />
|-<br />
|rowspan="10"| 0: add player<br />
|colspan="2"| Name<br />
|colspan="2"| String<br />
| <br />
|-<br />
|colspan="2"| Number Of Properties<br />
|colspan="2"| VarInt<br />
| Number of elements in the following array<br />
|-<br />
|rowspan="4"| Property<br />
| Name<br />
|rowspan="4"| Array<br />
| String<br />
| <br />
|-<br />
| Value<br />
| String<br />
| <br />
|- <br />
| Is Signed<br />
| Boolean<br />
| <br />
|-<br />
| Signature<br />
| Optional String<br />
| Only if Is Signed is true<br />
|-<br />
|colspan="2"| Gamemode<br />
|colspan="2"| VarInt<br />
| <br />
|-<br />
|colspan="2"| Ping<br />
|colspan="2"| VarInt<br />
| <br />
|-<br />
|colspan="2"| Has Display Name<br />
|colspan="2"| Boolean<br />
| <br />
|-<br />
|colspan="2"| Display Name<br />
|colspan="2"| Optional [[Chat]]<br />
| Only if Has Display Name is true<br />
|-<br />
| 1: update gamemode<br />
|colspan="2"| Gamemode<br />
|colspan="2"| VarInt<br />
| <br />
|- <br />
| 2: update latency<br />
|colspan="2"| Ping<br />
|colspan="2"| VarInt<br />
| <br />
|-<br />
|rowspan="2"| 3: update display name<br />
|colspan="2"| Has Display Name<br />
|colspan="2"| Boolean<br />
| <br />
|-<br />
|colspan="2"| Display Name<br />
|colspan="2"| Optional [[Chat]]<br />
| Only send if Has Display Name is true<br />
|-<br />
| 4: remove player<br />
|colspan="2"| ''no fields''<br />
|colspan="2"| ''no fields''<br />
| <br />
|}<br />
<br />
==== 玩家能力 ====<br />
<br />
The latter 2 floats are used to indicate the walking and flying speeds respectively, while the first byte is used to determine the value of 4 booleans.<br />
<br />
The flags are whether damage is disabled (god mode, 8, bit 3), whether the player can fly (4, bit 2), whether the player is flying (2, bit 1), and whether the player is in creative mode (1, bit 0).<br />
<br />
To get the values of these booleans, simply AND (&) the byte with 1,2,4 and 8 respectively, to get the 0 or 1 bitwise value. To set them OR (|) them with their repspective masks.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="3"| 0x39<br />
|rowspan="3"| Play<br />
|rowspan="3"| Client<br />
| Flags<br />
| Byte<br />
| Bit mask, see above<br />
|-<br />
| Flying Speed<br />
| Float<br />
| <br />
|-<br />
| Walking Speed<br />
| Float<br />
| <br />
|}<br />
<br />
==== Tab补全 ====<br />
<br />
The server responds with a list of auto-completions of the last word sent to it. In the case of regular chat, this is a player username. Command names and parameters are also supported.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="2"| 0x3A<br />
|rowspan="2"| Play<br />
|rowspan="2"| Client<br />
| Count<br />
| VarInt<br />
| Number of elements in the following array<br />
|-<br />
| Matches<br />
| Array of String<br />
| One eligible command, note that each command is sent separately instead of in a single string, hence the need for Count<br />
|}<br />
<br />
==== 计分板目标 ====<br />
<br />
This is sent to the client when it should create a new {{Minecraft Wiki|scoreboard}} objective or remove one.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="4"| 0x3B<br />
|rowspan="4"| Play<br />
|rowspan="4"| Client<br />
| Objective Name<br />
| String<br />
| An unique name for the objective<br />
|-<br />
| Mode<br />
| Byte<br />
| 0 to create the scoreboard. 1 to remove the scoreboard. 2 to update the display text. <br />
|-<br />
| Objective Value<br />
| Optional String<br />
| Only if mode is 0 or 2. The text to be displayed for the score<br />
|-<br />
| Type<br />
| Optional String<br />
| Only if mode is 0 or 2. “integer” or “hearts”<br />
|}<br />
<br />
==== 更新分数 ====<br />
<br />
This is sent to the client when it should update a scoreboard item. <br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="4"| 0x3C<br />
|rowspan="4"| Play<br />
|rowspan="4"| Client<br />
| Score Name<br />
| String<br />
| The name of the score to be updated or removed<br />
|-<br />
| Action<br />
| Byte<br />
| 0 to create/update an item. 1 to remove an item.<br />
|-<br />
| Objective Name<br />
| String<br />
| The name of the objective the score belongs to<br />
|-<br />
| Value<br />
| Optional VarInt<br />
| The score to be displayed next to the entry. Only sent when Action does not equal 1.<br />
|}<br />
<br />
==== 显示计分板 ====<br />
<br />
This is sent to the client when it should display a scoreboard.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="2"| 0x3D<br />
|rowspan="2"| Play<br />
|rowspan="2"| Client<br />
| Position<br />
| Byte<br />
| The position of the scoreboard. 0: list, 1: sidebar, 2: below name.<br />
|-<br />
| Score Name<br />
| String<br />
| The unique name for the scoreboard to be displayed.<br />
|}<br />
<br />
==== 团队 ====<br />
<br />
Creates and updates teams.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="10"| 0x3E<br />
|rowspan="10"| Play<br />
|rowspan="10"| Client<br />
| Team Name<br />
| String<br />
| A unique name for the team. (Shared with scoreboard).<br />
|-<br />
| Mode<br />
| Byte<br />
| If 0 then the team is created.<br />
<br />
If 1 then the team is removed. <br />
<br />
If 2 the team team information is updated. <br />
<br />
If 3 then new players are added to the team. <br />
<br />
If 4 then players are removed from the team.<br />
|-<br />
| Team Display Name<br />
| Optional String<br />
| Only if Mode = 0 or 2.<br />
|-<br />
| Team Prefix<br />
| Optional String<br />
| Only if Mode = 0 or 2. Displayed before the players' name that are part of this team<br />
|-<br />
| Team Suffix<br />
| Optional String<br />
| Only if Mode = 0 or 2. Displayed after the players' name that are part of this team<br />
|-<br />
| Friendly Fire<br />
| Optional Byte<br />
| Only if Mode = 0 or 2. 0 for off, 1 for on, 3 for seeing friendly invisibles<br />
|-<br />
| Name Tag Visibility<br />
| Optional String<br />
| Only if Mode = 0 or 2. always, hideForOtherTeams, hideForOwnTeam, never<br />
|-<br />
| Color<br />
| Optional Byte<br />
| Only if Mode = 0 or 2. Same as [[Chat]] colors<br />
|-<br />
| Player Count<br />
| Optional VarInt<br />
| Only if Mode = 0 or 3 or 4. Number of players in the array<br />
|-<br />
| Players<br />
| Optional Array of String<br />
| Only if Mode = 0 or 3 or 4. Players to be added/remove from the team. Max 40 characters so may be uuid's later<br />
|}<br />
<br />
==== 插件信息 ====<br />
<br />
Mods and plugins can use this to send their data. Minecraft itself uses a number of [[plugin channel]]s. These internal channels are prefixed with <code>MC|</code>.<br />
<br />
More documentation on this: [http://dinnerbone.com/blog/2012/01/13/minecraft-plugin-channels-messaging/ http://dinnerbone.com/blog/2012/01/13/minecraft-plugin-channels-messaging/]<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="2"| 0x3F<br />
|rowspan="2"| Play<br />
|rowspan="2"| Client<br />
| Channel<br />
| String<br />
| Name of the [[plugin channel]] used to send the data<br />
|-<br />
| Data<br />
| Byte Array<br />
| Any data, depending on the channel. <code><nowiki>MC|</nowiki></code> channels are documented [[plugin channel|here]].<br />
|}<br />
<br />
==== 断开连接 ====<br />
<br />
Sent by the server before it disconnects a client. The server assumes that the sender has already closed the connection by the time the packet arrives.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
| 0x40<br />
|rowspan="1"| Play<br />
|rowspan="1"| Client<br />
| Reason<br />
| [[Chat]]<br />
| Displayed to the client when the connection terminates.<br />
|}<br />
<br />
==== 服务器难度 ====<br />
<br />
Changes the difficulty setting in the client's option menu<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="1"| 0x41<br />
|rowspan="1"| Play<br />
|rowspan="1"| Client<br />
| Difficulty<br />
| Unsigned Byte<br />
| 0: peaceful, 1: easy, 2: normal, 3: hard<br />
|}<br />
<br />
==== 战斗事件 ====<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="6"| 0x42<br />
|rowspan="6"| Play<br />
|rowspan="6"| Client<br />
| Event<br />
| VarInt<br />
| 0: enter combat, 1: end combat, 2: entity dead<br />
|-<br />
| Duration<br />
| Optional VarInt<br />
| Only for end combat<br />
|-<br />
| Player ID<br />
| Optional VarInt<br />
| Only for entity dead<br />
|-<br />
| Entity ID<br />
| Optional Int<br />
| Only for end combat and entity dead<br />
|-<br />
| Message<br />
| String<br />
| Only for entity dead<br />
|}<br />
<br />
==== 摄像机 ====<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="1"| 0x43<br />
|rowspan="1"| Play<br />
|rowspan="1"| Client<br />
| Camera ID<br />
| VarInt<br />
| <br />
|}<br />
<br />
==== 世界边界 ==== <br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
!colspan="2"| Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="18"| 0x44<br />
|rowspan="18"| Play<br />
|rowspan="18"| Client<br />
|colspan="2"| Action<br />
| VarInt<br />
| Determines the format of the rest of the packet<br />
|-<br />
! Action<br />
! Field Name<br />
! <br />
! <br />
|-<br />
| 0: set size<br />
| Radius<br />
| Double<br />
| meters<br />
|-<br />
|rowspan="3"| 1: lerp size<br />
| Old Radius<br />
| Double<br />
| meters<br />
|-<br />
| New Radius<br />
| Double<br />
| meters<br />
|-<br />
| Speed<br />
| VarLong<br />
| number of real-time ticks/seconds (?) until New Radius is reached. From experiments, it appears that Notchian server does not sync world border speed to game ticks, so it gets out of sync with server lag<br />
|-<br />
|rowspan="2"| 2: set center<br />
| X<br />
| Double<br />
| <br />
|-<br />
| Z<br />
| Double<br />
| <br />
|-<br />
|rowspan="8"| 3: initialize<br />
| X<br />
| Double<br />
| <br />
|-<br />
| Z<br />
| Double<br />
| <br />
|-<br />
| Old Radius<br />
| Double<br />
| <br />
|-<br />
| New Radius<br />
| Double<br />
| <br />
|-<br />
| Speed<br />
| VarLong<br />
| <br />
|-<br />
| Portal Teleport Boundary<br />
| VarInt<br />
| Resulting coordinates from a portal teleport are limited to +-value. Usually 29999984.<br />
|-<br />
| Warning Time<br />
| VarInt<br />
| <br />
|-<br />
| Warning Blocks<br />
| VarInt<br />
| <br />
|-<br />
|rowspan="1"| 4: set warning time<br />
| Warning Time<br />
| VarInt<br />
| unit?<br />
|-<br />
|rowspan="1"| 5: set warning blocks<br />
| Warning Blocks<br />
| VarInt<br />
| <br />
|}<br />
<br />
==== 显示标题 ==== <br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
!colspan="2"| Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="9"| 0x45<br />
|rowspan="9"| Play<br />
|rowspan="9"| Client<br />
|colspan="2"| Action<br />
| VarInt<br />
| <br />
|-<br />
! Action<br />
! Field Name<br />
! <br />
! <br />
|-<br />
| 0: set title<br />
| Title Text<br />
| [[Chat]]<br />
| <br />
|-<br />
| 1: set subtitle<br />
| Subtitle Text<br />
| [[Chat]]<br />
| <br />
|-<br />
|rowspan="3"| 2: set times and display<br />
| Fade In<br />
| Int<br />
| ticks<br />
|-<br />
| Stay<br />
| Int<br />
| ticks<br />
|-<br />
| Fade Out<br />
| Int<br />
| ticks<br />
|-<br />
| 3: hide<br />
| ''no fields''<br />
| ''no fields''<br />
| <br />
|-<br />
| 4: reset<br />
| ''no fields''<br />
| ''no fields''<br />
| <br />
|}<br />
<br />
“Hide” makes the title disappear, but if you run times again the same title will appear. “Reset” erases the text.<br />
<br />
==== 设置压缩 ====<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="1"| 0x46<br />
|rowspan="1"| Play<br />
|rowspan="1"| Client<br />
| Threshold<br />
| VarInt<br />
| 这种大小或更高的包可以被压缩。<br />
|}<br />
<br />
==== 玩家列表页眉与页脚 ====<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="2"| 0x47<br />
|rowspan="2"| Play<br />
|rowspan="2"| Client<br />
| Header<br />
| [[Chat]]<br />
| <br />
|-<br />
| Footer<br />
| [[Chat]]<br />
| <br />
|}<br />
<br />
==== 发送资源包 ==== <br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="2"| 0x48<br />
|rowspan="2"| Play<br />
|rowspan="2"| Client<br />
| URL<br />
| String<br />
| 资源包的 URL 地址<br />
|-<br />
| Hash<br />
| String<br />
| 一个40个字符的十六进制和小写的[[wikipedia:SHA-1|SHA-1]]哈希的资源包文件。（必须小写）<br />如果不符合上一行的标准， 客户端将不会验证它哈希值及浪费不必要的带宽 — 但仍将把它作为唯一的标识符处理<br />
|}<br />
<br />
==== 更新实体 NBT ==== <br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="2"| 0x49<br />
|rowspan="2"| Play<br />
|rowspan="2"| Client<br />
| Entity ID<br />
| VarInt<br />
| <br />
|-<br />
| Tag<br />
| [[NBT|NBT Tag]]<br />
| <br />
|}<br />
<br />
=== 发送到服务器 ===<br />
<br />
==== 保持连接 ====<br />
<br />
服务器会经常发送一个保持连接包，内含一个随机的ID。客户端必须回应同样的包。<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="1"| 0x00<br />
|rowspan="1"| Play<br />
|rowspan="1"| Server<br />
| Keep Alive ID<br />
| VarInt<br />
| <br />
|}<br />
<br />
==== 聊天信息 ====<br />
<br />
默认服务端会检查信息是否以 '/' 开头。如果不是是，发送者的用户名将被放在消息前并且发送到所有其他客户端（包括原始的发送者）。如果是，服务端认为它是一个命令并尝试处理它。一个长度大于 100 的信息会导致服务端踢出该客户端。这个行为一开始是在不修改服务端的前提下不允许客户端不分段发送长度超过 119（以前的限制）的信息。因为这个原因，原始的服务端保留了在 119 处将消息切片的代码，但是这不是一个协议限制并且可以被跳过。<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="1"| 0x01<br />
|rowspan="1"| Play<br />
|rowspan="1"| Server<br />
| Message<br />
| String<br />
| The client sends the raw input, not [[Chat]]<br />
|}<br />
<br />
==== 使用实体 ====<br />
<br />
这个包在玩家攻击或者右键点击其他实体（一个玩家、矿车等）时从客户端发往服务器。<br />
<br />
一个官方服务端只在被攻击或使用的实体是可视的、在以玩家为中心 4单位 的范围内且与玩家之间没有阻碍时才接受这个包。<br />
<br />
注意：创造模式的中键点击会被客户端解析且被发送为 [[#Creative Inventory Action|创造背包动作]] 包。<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="5"| 0x02<br />
|rowspan="5"| Play<br />
|rowspan="5"| Server<br />
| Target<br />
| VarInt<br />
| <br />
|-<br />
| Type<br />
| VarInt<br />
| 0: interact, 1: attack, 2: interact at<br />
|-<br />
| Target X<br />
| Optional Float<br />
| 只有当类型为 interact at 时<br />
|-<br />
| Target Y<br />
| Optional Float<br />
| 只有当类型为 interact at 时<br />
|-<br />
| Target Z<br />
| Optional Float<br />
| 只有当类型为 interact at 时<br />
|}<br />
<br />
==== 玩家状态 ====<br />
<br />
这个包用于表明玩家正在陆地上（行走/游泳）还是在空中（跳跃/掉落）。<br />
<br />
当从足够高的高度掉落，这个状态从 false 设置为 true 时会受到掉落伤害。受到伤害的数值基于最后状态从 true 设置为 false。 注意有一些运动相关的包包含了这个包。<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="1"| 0x03<br />
|rowspan="1"| Play<br />
|rowspan="1"| Server<br />
| On Ground<br />
| Boolean<br />
| 当对象站在地上时为 true , 反之则为 false<br />
|}<br />
<br />
==== 玩家坐标 ====<br />
<br />
更新玩家在服务器上的 XYZ 坐标。<br />
<br />
如果在服务器上最后记录的位置和这个包设置的新位置之间的距离大于 100 单位，将会导致客户端因为 “You moved too quickly :( (Hacking?)” 而被踢出服务器。<br />
<br />
如果之间的距离大于 10 单位，服务器会在日志中写下警告信息 “<name> moved too quickly!” 和两个三元坐标（可能是运动增量？），但不会踢出客户端。<br />
<br />
如果 X 或 Z 的定点数被设置大于 3.2×10<sup>7</sup> 客户端会因为 “Illegal position” 而被踢出服务器。<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="4"| 0x04<br />
|rowspan="4"| Play<br />
|rowspan="4"| Server<br />
| X<br />
| Double<br />
| 绝对位置<br />
|-<br />
| Feet Y<br />
| Double<br />
| 绝对位置，史蒂夫头部一般在 Y - 1.62<br />
|-<br />
| Z<br />
| Double<br />
| 绝对位置<br />
|-<br />
| On Ground<br />
| Boolean<br />
| 当对象站在地上时为 true , 反之则为 false<br />
|}<br />
<br />
==== 玩家观察 ====<br />
[[File:Minecraft-trig-yaw.png|thumb|The unit circle for yaw]]<br />
[[File:Yaw.png|thumb|The unit circle of yaw, redrawn]]<br />
<br />
更新玩家目前所看的方向。<br />
<br />
偏航（Yaw）以度为单位，并且不遵循经典的三角规则。</div>
梦彗業
https://mineplugin.org/index.php?title=Protocol&diff=5415
Protocol
2017-09-02T14:35:32Z
<p>梦彗業：翻译订正</p>
<hr />
<div>{{待翻译}}<br />
{{待更新|url=http://wiki.vg/Protocol}}<br />
<br />
这里剖析了最近的 '''[http://wiki.vg/Protocol_Encryption Minecraft协议]'''.<br />
<br />
如果你有疑问, 请查阅下文或在IRC请求帮助 ([irc://irc.freenode.net/mcdevs #mcdevs on irc.freenode.net]).<br />
<br />
'''注意:''' 你可以不受限制地使用这个页面的内容来创建服务端, 客户端, 机器人…… 诸如此类的任何东西…<br />
<br />
== 定义 ==<br />
<br />
Minecraft服务器是基于TCP通讯的。它和客户端使用所谓的 ''数据包''交流. 一个包被通过字节编码后从TCP连接中发送. 数据包的含义取决于其包标识和连接的当前状态. 每个链接从 '''[http://wiki.vg/Handshaking 握手]'''开始, 使用包切换状态 '''[http://wiki.vg/Handshaking 握手]''',( 0x00, serverbound) 和 [[#Login Success|成功登陆]] ([[#Login|登陆]], 0x02, clientbound).<br />
<br />
=== 数据类型 ===<br />
<br />
<!-- Transcluded contents of Data Types article in here - go to that page if you want to edit it --><br />
<br />
{{:Data Types}}<br />
<br />
=== 其他定义 ===<br />
<br />
{| class="wikitable"<br />
|-<br />
! 术语<br />
! 定义<br />
|-<br />
| Player——玩家<br />
| 使用时, 玩家通常使用它来链接到服务端.<br />
|-<br />
| Entity——实体<br />
| 实体相当于玩家、物品、怪物、船和矿车等. 查看 {{Minecraft Wiki|Entity|the Minecraft Wiki article}} 来寻找一个完整的表单.<br />
|-<br />
| EID——实体ID<br />
| An EID — 或者说是实体ID — 是一个用来识别特定实体的4字节序列. 在同一个服务器,没有相同的实体编号.<br />
|-<br />
| XYZ坐标<br />
| 游戏时，可以使用按钮“F3”来在屏幕上查看坐标位置 Y代表高度, X代表东西, Z代表南北.<br />
|-<br />
| 单位“Meter”<br />
| Meter是Minecraft的基本长度单位, 相当于一个方块的长度. “block”一词也许意味着 “meter”或者“cubic meter”.<br />
|}<br />
<br />
== 数据包的格式 ==<br />
<br />
=== 无压缩 ===<br />
<br />
{| class="wikitable"<br />
! 域名称<br />
! 域类型<br />
! 注释<br />
|-<br />
| 长度<br />
| VarInt<br />
| 包数据的长度 + 包序号的长度<br />
|-<br />
| 包序号<br />
| VarInt<br />
| <br />
|-<br />
| 数据<br />
| Byte Array<br />
| 依赖于连接状态和包序号，详见下面的部分。<br />
|}<br />
<br />
=== 压缩 ===<br />
<br />
当一个 [[#Set Compression|设置压缩]] 包被发送，[[wikipedia:Zlib|zlib]] 压缩将会对之后的所有包开启。 包的格式略微改变以包含未压缩前的包的长度。<br />
''译注：注意区分包长度和数据长度，关系：“包”包含“数据”''<br />
{| class=wikitable<br />
! 是否压缩<br />
! 域名称<br />
! 域类型<br />
! 注释<br />
|-<br />
| 否<br />
| 包长度<br />
| VarInt<br />
| 数据长度的长度 + 压缩后的 (包序号 + 数据) 的长度<br />
|-<br />
| 否<br />
| 数据长度<br />
| VarInt<br />
| 未压缩前的 (包序号 + 数据) 的长度 或 0<br />
|-<br />
|rowspan="2"| 是<br />
| 包序号<br />
| Varint<br />
| zlib 压缩后的包序号（详见下面的部分）<br />
|-<br />
| 数据<br />
| Byte Array<br />
| zlib 压缩后的包数据（详见下面的部分）<br />
|}<br />
<br />
包长度域提供的是包中存在的字节的数量，包括数据长度域。<br />
<br />
如果数据长度被设置为 0，则这个包没有被压缩；否则它表示已压缩的包未压缩前的包长度。<br />
<br />
如果包被压缩，压缩前的 (包序号 + 数据) 的长度必须等于或大于 [[#Set Compression|设置压缩]] 包中设置的最小值，否则客户端/服务端将会断开连接。<br />
<br />
压缩能通过发送一个最小值设定为 -1 的 [[#Set Compression|设置压缩]] 包来关闭。<br />
<br />
== 握手协议 ==<br />
<br />
=== 客户端绑定 ===<br />
<br />
因为协议在客户端发送第一个数据包后会立刻切换到另一个阶段，所以握手阶段没有客户端绑定的数据包。<br />
<br />
=== 服务端绑定 ===<br />
<br />
==== 握手协议 ====<br />
<br />
这将使得服务器切换至目标阶段。<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="4"| 0x00<br />
|rowspan="4"| Handshaking<br />
|rowspan="4"| Server<br />
| 协议版本<br />
| VarInt<br />
| See [[protocol version numbers]] (currently 47)<br />
|-<br />
| 服务器地址<br />
| String<br />
| 域名或是IP, 例如： localhost 或是 127.0.0.1<!-- does this support IPv6? --><br />
|- <br />
| 服务器端口<br />
| Unsigned Short<br />
| 默认值为25565<br />
|-<br />
| 下一阶段<br />
| VarInt<br />
| 1 for [[#Status|status]], 2 for [[#Login|login]]<br />
|}<br />
<br />
==== 传统的服务器列表Ping ====<br />
<br />
严格来说这不是当前协议的一部分，传统客户端可能会发送这一数据包来发起（initiate） [[Server List Ping]], 现代服务器也应当能够适当地处理这一数据包。<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
| 0xFE<br />
| Handshaking<br />
| Server<br />
| Payload<br />
| Unsigned Byte<br />
| always 1 (<code>0x01</code>)<br />
|}<br />
<br />
See [[Server List Ping#1.6]] for the details of the protocol that follows this packet.<br />
<br />
== 开始游戏 ==<br />
<br />
=== 发送到客户端 ===<br />
<br />
==== 心跳包 ====<br />
<br />
The server will frequently send out a keep-alive, each containing a random ID. The client must respond with the same packet. If the client does not respond to them for over 30 seconds, the server kicks the client. Vice versa, if the server does not send any keep-alives for 20 seconds, the client will disconnect and yields a "Timed out" exception.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="1"| 0x00<br />
|rowspan="1"| Play<br />
|rowspan="1"| Client<br />
| Keep Alive ID<br />
| VarInt<br />
| <br />
|}<br />
<br />
==== 加入游戏 ====<br />
<br />
See [[Protocol Encryption]] for information on logging in.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="7"| 0x01<br />
|rowspan="7"| Play<br />
|rowspan="7"| Client<br />
| Entity ID<br />
| Int<br />
| The player's Entity ID (EID)<br />
|-<br />
| Gamemode<br />
| Unsigned Byte<br />
| 0: Survival, 1: Creative, 2: Adventure, 3: Spectator. Bit 3 (0x8) is the hardcore flag.<br />
|-<br />
| Dimension<br />
| Byte<br />
| -1: Nether, 0: Overworld, 1: End<br />
|-<br />
| Difficulty<br />
| Unsigned Byte<br />
| 0: peaceful, 1: easy, 2: normal, 3: hard<br />
|-<br />
| Max Players<br />
| Unsigned Byte<br />
| Used by the client to draw the player list<br />
|-<br />
| Level Type<br />
| String<br />
| default, flat, largeBiomes, amplified, default_1_1<br />
|-<br />
| Reduced Debug Info<br />
| Boolean<br />
| If true, a Notchian client shows reduced information on the {{Minecraft Wiki|debug screen}}.<br />
|}<br />
<br />
{{Warning|如果位置无效，服务端将崩溃}}<br />
<br />
==== 聊天内容 ==== <br />
<br />
Identifying the difference between Chat/System Message is important as it helps respect the user's chat visibility options. While Position 2 accepts json formatting it will not display, old style formatting works<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="2"| 0x02<br />
|rowspan="2"| Play<br />
|rowspan="2"| Client<br />
| JSON Data<br />
| [[Chat]]<br />
| Limited to 32767 bytes<br />
|-<br />
| Position<br />
| Byte<br />
| 0: chat (chat box), 1: system message (chat box), 2: above action bar<br />
|}<br />
<br />
{{Warning|错误的JSON将断开连接}}<br />
<br />
==== 时间更新 ====<br />
<br />
Time is based on ticks, where 20 ticks happen every second. There are 24000 ticks in a day, making Minecraft days exactly 20 minutes long.<br />
<br />
The time of day is based on the timestamp modulo 24000. 0 is sunrise, 6000 is noon, 12000 is sunset, and 18000 is midnight.<br />
<br />
The default SMP server increments the time by <code>20</code> every second.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="2"| 0x03<br />
|rowspan="2"| Play<br />
|rowspan="2"| Client<br />
| World Age<br />
| Long<br />
| In ticks; not changed by server commands<br />
|-<br />
| Time of day<br />
| Long<br />
| The world (or region) time, in ticks. If negative the sun will stop moving at the Math.abs of the time<br />
|}<br />
<br />
==== 持有的物品 ====<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="3"| 0x04<br />
|rowspan="3"| Play<br />
|rowspan="3"| Client<br />
| Entity ID<br />
| VarInt<br />
| Entity's EID<br />
|-<br />
| Slot<br />
| Short<br />
| Equipment slot. 0: held, 1–4: armor slot (1: boots, 2: leggings, 3: chestplate, 4: helmet)<br />
|-<br />
| Item<br />
| [[Slot Data|Slot]]<br />
| Item in slot format<br />
|}<br />
<br />
==== 出生姿势 ====<br />
<br />
Sent by the server after login to specify the coordinates of the spawn point (the point at which players spawn at, and which the compass points to). It can be sent at any time to update the point compasses point at.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="1"| 0x05<br />
|rowspan="1"| Play<br />
|rowspan="1"| Client<br />
| Location<br />
| Position<br />
| Spawn location<br />
|}<br />
<br />
==== 更新生命值 ====<br />
<br />
Sent by the server to update/set the health of the player it is sent to.<br />
<br />
Food {{Minecraft Wiki|Food#Hunger vs. Saturation|saturation}} acts as a food “overcharge”. Food values will not decrease while the saturation is over zero. Players logging in automatically get a saturation of 5.0. Eating food increases the saturation as well as the food bar.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="3"| 0x06<br />
|rowspan="3"| Play<br />
|rowspan="3"| Client<br />
| Health<br />
| Float<br />
| 0 or less = dead, 20 = full HP<br />
|-<br />
| Food<br />
| VarInt<br />
| 0–20<br />
|- <br />
| Food Saturation<br />
| Float<br />
| Seems to vary from 0.0 to 5.0 in integer increments<br />
|}<br />
<br />
==== 重生 ====<br />
<br />
来改变玩家的位置(主世界/地狱/末地), 发送给他们一个重生指令, 其次是prechunks或chunks的新位置, and finally a position and look packet. You do not need to unload chunks, the client will do it automatically.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="4"| 0x07<br />
|rowspan="4"| Play<br />
|rowspan="4"| Client<br />
| Dimension<br />
| Int<br />
| -1: The Nether, 0: The Overworld, 1: The End<br />
|-<br />
| Difficulty<br />
| Unsigned Byte<br />
| 0: Peaceful, 1: Easy, 2: Normal, 3: Hard<br />
|-<br />
| Gamemode<br />
| Unsigned Byte<br />
| 0: survival, 1: creative, 2: adventure. The hardcore flag is not included<br />
|-<br />
| Level Type<br />
| String<br />
| Same as [[#Join Game|Join Game]]<br />
|}<br />
<br />
{{Warning|如果位置无效，服务端将崩溃 }}<br />
<br />
{{Warning|如果玩家出现在了相同的位置, weird bugs can occur i.e. such player will be unable to attack other players in new world (修复后他们将重生)}}<br />
<br />
==== 玩家姿势以及看的方向 ==== <br />
<br />
Updates the player's position on the server.<br />
<br />
If the distance between the last known position of the player on the server and the new position set by this packet is greater than 100 meters, the client will be kicked for “You moved too quickly :( (Hacking?)”.<br />
<br />
Also if the fixed-point number of X or Z is set greater than <code>3.2E7D</code> the client will be kicked for “Illegal position”.<br />
<br />
Yaw is measured in degrees, and does not follow classical trigonometry rules. The unit circle of yaw on the XZ-plane starts at (0, 1) and turns counterclockwise, with 90 at (-1, 0), 180 at (0, -1) and 270 at (1, 0). Additionally, yaw is not clamped to between 0 and 360 degrees; any number is valid, including negative numbers and numbers greater than 360.<br />
<br />
Pitch is measured in degrees, where 0 is looking straight ahead, -90 is looking straight up, and 90 is looking straight down.<br />
<br />
The yaw in degrees of a player standing at point (x0, z0) and looking towards point (x, z) can be calculated with:<br />
<br />
l = x-x0<br />
w = z-z0<br />
c = sqrt( l*l + w*w )<br />
alpha1 = -arcsin(l/c)/PI*180<br />
alpha2 = arccos(w/c)/PI*180<br />
if alpha2 > 90 then<br />
yaw = 180 - alpha1<br />
else<br />
yaw = alpha1<br />
<br />
You can get a unit vector from a given yaw/pitch via:<br />
<br />
x = -cos(pitch) * sin(yaw)<br />
y = -sin(pitch)<br />
z = cos(pitch) * cos(yaw)<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="6"| 0x08<br />
|rowspan="6"| Play<br />
|rowspan="6"| Client<br />
| X<br />
| Double<br />
| Absolute or relative position, depending on Flags<br />
|-<br />
| Y<br />
| Double<br />
| Absolute or relative position, depending on Flags<br />
|-<br />
| Z<br />
| Double<br />
| Absolute or relative position, depending on Flags<br />
|-<br />
| Yaw<br />
| Float<br />
| Absolute or relative rotation on the X Axis, in degrees<br />
|-<br />
| Pitch<br />
| Float<br />
| Absolute or relative rotation on the Y Axis, in degrees<br />
|-<br />
| Flags<br />
| Byte<br />
| Bit field, see below<br />
|}<br />
<br />
About the Flags field:<br />
<br />
<Dinnerbone> It's a bitfield, X/Y/Z/Y_ROT/X_ROT. If X is set, the x value is relative and not absolute.<br />
<br />
{| class="wikitable"<br />
|-<br />
! Field<br />
! Bit<br />
|-<br />
| X<br />
| 0x01<br />
|-<br />
| Y<br />
| 0x02<br />
|-<br />
| Z<br />
| 0x04<br />
|-<br />
| Y_ROT<br />
| 0x08<br />
|-<br />
| X_ROT<br />
| 0x10<br />
|}<br />
<br />
==== 持有物品变更 ====<br />
<br />
Sent to change the player's slot selection.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="1"| 0x09<br />
|rowspan="1"| Play<br />
|rowspan="1"| Client<br />
| Slot<br />
| Byte<br />
| The slot which the player has selected (0–8)<br />
|}<br />
<br />
==== 使用床 ==== <br />
<br />
This packet tells that a player goes to bed.<br />
<br />
The client with the matching Entity ID will go into bed mode.<br />
<br />
This Packet is sent to all nearby players including the one sent to bed.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="2"| 0x0A<br />
|rowspan="2"| Play<br />
|rowspan="2"| Client<br />
| Entity ID<br />
| VarInt<br />
| Sleeping player's EID<br />
|-<br />
| Location<br />
| Position<br />
| Block location of the head part of the bed<br />
|}<br />
<br />
==== 动画 ====<br />
<br />
Sent whenever an entity should change animation.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="2"| 0x0B<br />
|rowspan="2"| Play<br />
|rowspan="2"| Client<br />
| Entity ID<br />
| VarInt<br />
| Player ID<br />
|-<br />
| Animation<br />
| Unsigned Byte<br />
| Animation ID (see below)<br />
|}<br />
<br />
Animation can be one of the following values:<br />
<br />
{| class="wikitable"<br />
! ID<br />
! Animation<br />
|-<br />
| 0<br />
| Swing arm<br />
|-<br />
| 1<br />
| Take damage<br />
|-<br />
| 2<br />
| Leave bed<br />
|-<br />
| 3<br />
| Eat food<br />
|-<br />
| 4<br />
| Critical effect<br />
|-<br />
| 5<br />
| Magic critical effect<br />
|}<br />
<br />
==== 生成玩家 ====<br />
<br />
This packet is sent by the server when a player comes into visible range, ''not'' when a player joins.<br />
<br />
This packet must be sent after the [[#Player List Item|Player List Item]] ([[#Play|Play]], 0x38, clientbound) packet that adds the player data for the client to use when spawning a player. If the tab list entry for the UUID included in this packet is not present when this packet arrives, the entity will not be spawned. The tab includes skin/cape data.<br />
<br />
Servers can, however, safely spawn player entities for players not in visible range. The client appears to handle it correctly.<br />
<br />
When in online-mode the UUIDs must be valid and have valid skin blobs, in offline-mode UUID v3 is used.<br />
<br />
For NPCs UUID v2 should be used. Note:<br />
<br />
<+Grum> i will never confirm this as a feature you know that :)<br />
<br />
In an example UUID, <code>xxxxxxxx-xxxx-Yxxx-xxxx-xxxxxxxxxxxx</code>, the UUID version is specified by <code>Y</code>. So, for UUID v3, <code>Y</code> will always be <code>3</code>, and for UUID v2, <code>Y</code> will always be <code>2</code>.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="9"| 0x0C<br />
|rowspan="9"| Play<br />
|rowspan="9"| Client<br />
| Entity ID<br />
| VarInt<br />
| Player's EID<br />
|-<br />
| Player UUID<br />
| UUID<br />
| <br />
|-<br />
| X<br />
| Int<br />
| Player X as a [[Data Types#Fixed-point numbers|Fixed-Point number]]<br />
|-<br />
| Y<br />
| Int<br />
| Player Y as a [[Data Types#Fixed-point numbers|Fixed-Point number]]<br />
|-<br />
| Z<br />
| Int<br />
| Player Z as a [[Data Types#Fixed-point numbers|Fixed-Point number]]<br />
|-<br />
| Yaw<br />
| Angle<br />
| <br />
|-<br />
| Pitch<br />
| Angle<br />
| <br />
|-<br />
| Current Item<br />
| Short<br />
| The item the player is currently holding. Note that this should be 0 for “no item”, unlike -1 used in other packets.<br />
|-<br />
| Metadata<br />
| [[Entities#Entity Metadata Format|Metadata]]<br />
| <br />
|}<br />
<br />
{{Warning|A negative Current Item crashes clients}}<br />
<br />
{{Warning|The client will crash if no Metadata is sent}}<br />
<br />
==== 拾起物品 ====<br />
<br />
Sent by the server when someone picks up an item lying on the ground — its sole purpose appears to be the animation of the item flying towards you. It doesn't destroy the entity in the client memory, and it doesn't add it to your inventory. The server only checks for items to be picked up after each [[#Player Position|Player Position]] (and [[#Player Position And Look|Player Position And Look]]) packet sent by the client.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="2"| 0x0D<br />
|rowspan="2"| Play<br />
|rowspan="2"| Client<br />
| Collected Entity ID<br />
| VarInt<br />
| <br />
|- <br />
| Collector Entity ID<br />
| VarInt<br />
| <br />
|}<br />
<br />
==== 生成对象 ====<br />
<br />
Sent by the server when an Object/Vehicle is created.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="8"| 0x0E<br />
|rowspan="8"| Play<br />
|rowspan="8"| Client<br />
| Entity ID <br />
| VarInt<br />
| EID of the object<br />
|-<br />
| Type<br />
| Byte<br />
| The type of object (See [[Entities#Objects|Objects]])<br />
|-<br />
| X<br />
| Int<br />
| X position as a [[Data Types#Fixed-point numbers|Fixed-Point number]]<br />
|-<br />
| Y<br />
| Int<br />
| Y position as a [[Data Types#Fixed-point numbers|Fixed-Point number]]<br />
|-<br />
| Z<br />
| Int<br />
| Z position as a [[Data Types#Fixed-point numbers|Fixed-Point number]]<br />
|-<br />
| Pitch<br />
| Angle<br />
| <br />
|-<br />
| Yaw<br />
| Angle<br />
| <br />
|-<br />
| Data<br />
| [[Object Data]]<br />
| <br />
|}<br />
<br />
==== 生成怪物 ====<br />
<br />
Sent by the server when a Mob Entity is Spawned<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="12"| 0x0F<br />
|rowspan="12"| Play<br />
|rowspan="12"| Client<br />
| Entity ID<br />
| VarInt<br />
| <br />
|-<br />
| Type<br />
| Unsigned Byte<br />
| The type of mob. See [[Entities#Mobs|Mobs]]<br />
|-<br />
| X<br />
| Int<br />
| X position as a [[Data Types#Fixed-point numbers|Fixed-Point number]] <br />
|-<br />
| Y<br />
| Int<br />
| Y position as a [[Data Types#Fixed-point numbers|Fixed-Point number]] <br />
|-<br />
| Z<br />
| Int<br />
| Z position as a [[Data Types#Fixed-point numbers|Fixed-Point number]] <br />
|-<br />
| Yaw<br />
| Angle<br />
| <br />
|-<br />
| Pitch<br />
| Angle<br />
| <br />
|-<br />
| Head Pitch<br />
| Angle<br />
| <br />
|-<br />
| Velocity X<br />
| Short<br />
| Same units as [[#Entity Velocity|Entity Velocity]]<br />
|-<br />
| Velocity Y<br />
| Short<br />
| Same units as [[#Entity Velocity|Entity Velocity]]<br />
|-<br />
| Velocity Z<br />
| Short<br />
| Same units as [[#Entity Velocity|Entity Velocity]]<br />
|-<br />
| Metadata<br />
| [[Entities#Entity Metadata Format|Metadata]]<br />
| <br />
|}<br />
<br />
==== 重生绘图 ====<br />
<br />
This packet shows location, name, and type of painting.<br />
<br />
Calculating the center of an image: given a (width x height) grid of cells, with (0, 0) being the top left corner, the center is (max(0, width / 2 - 1), height / 2). E.g.<br />
<br />
2x1 (1, 0)<br />
4x4 (1, 2)<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="4"| 0x10<br />
|rowspan="4"| Play<br />
|rowspan="4"| Client<br />
| Entity ID<br />
| VarInt<br />
| <br />
|-<br />
| Title<br />
| String<br />
| Name of the painting. Max length 13<br />
|-<br />
| Location<br />
| Position<br />
| Center coordinates<br />
|-<br />
| Direction<br />
| Unsigned Byte<br />
| Direction the painting faces. 0: north (-z), 1: west (-x), 2: south (+z), 3: east (+x)<br />
|}<br />
<br />
==== 重生掉落经验 ====<br />
<br />
Spawns one or more experience orbs.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="5"| 0x11<br />
|rowspan="5"| Play<br />
|rowspan="5"| Client<br />
| Entity ID<br />
| VarInt<br />
| Entity's ID<br />
|-<br />
| X<br />
| Int<br />
| X position as a [[Data Types#Fixed-point numbers|Fixed-Point number]]<br />
|-<br />
| Y<br />
| Int<br />
| Y position as a [[Data Types#Fixed-point numbers|Fixed-Point number]]<br />
|-<br />
| Z<br />
| Int<br />
| Z position as a [[Data Types#Fixed-point numbers|Fixed-Point number]]<br />
|-<br />
| Count<br />
| Short<br />
| The amount of experience this orb will reward once collected<br />
|}<br />
<br />
==== 实体速率 ====<br />
<br />
Velocity is believed to be in units of 1/8000 of a block per server tick (50ms); for example, -1343 would move (-1343 / 8000) = −0.167875 blocks per tick (or −3,3575 blocks per second).<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="4"| 0x12<br />
|rowspan="4"| Play<br />
|rowspan="4"| Client<br />
| Entity ID<br />
| VarInt<br />
| <br />
|-<br />
| Velocity X<br />
| Short<br />
| Velocity on the X axis<br />
|-<br />
| Velocity Y<br />
| Short<br />
| Velocity on the Y axis<br />
|-<br />
| Velocity Z<br />
| Short<br />
| Velocity on the Z axis<br />
|}<br />
<br />
==== 销毁实体 ====<br />
<br />
Sent by the server when a list of entities is to be destroyed on the client.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="2"| 0x13<br />
|rowspan="2"| Play<br />
|rowspan="2"| Client<br />
| Count<br />
| VarInt<br />
| Number of elements in the following array<br />
|-<br />
| Entity IDs<br />
| Array of VarInt<br />
| The list of entities of destroy<br />
|}<br />
<br />
==== 实体 ====<br />
<br />
This packet may be used to initialize an entity.<br />
<br />
For player entities, either this packet or any move/look packet is sent every game tick. So the meaning of this packet is basically that the entity did not move/look since the last such packet.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="1"| 0x14<br />
|rowspan="1"| Play<br />
|rowspan="1"| Client<br />
| Entity ID<br />
| VarInt<br />
| <br />
|}<br />
<br />
==== 实体相对移动 ====<br />
<br />
This packet is sent by the server when an entity moves less then 4 blocks; if an entity moves more than 4 blocks [[#Entity Teleport|Entity Teleport]] should be sent instead.<br />
<br />
This packet allows at most four blocks movement in any direction, because byte range is from -128 to 127.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="5"| 0x15<br />
|rowspan="5"| Play<br />
|rowspan="5"| Client<br />
| Entity ID<br />
| VarInt<br />
| <br />
|-<br />
| Delta X<br />
| Byte<br />
| Change in X position as a [[Data Types#Fixed-point numbers|Fixed-Point number]]<br />
|-<br />
| Delta Y<br />
| Byte<br />
| Change in Y position as a [[Data Types#Fixed-point numbers|Fixed-Point number]]<br />
|-<br />
| Delta Z<br />
| Byte<br />
| Change in Z position as a [[Data Types#Fixed-point numbers|Fixed-Point number]]<br />
|-<br />
| On Ground<br />
| Boolean<br />
| <br />
|}<br />
<br />
==== 实体朝向 ====<br />
<br />
This packet is sent by the server when an entity rotates.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="5"| 0x16<br />
|rowspan="5"| Play<br />
|rowspan="5"| Client<br />
| Entity ID<br />
| VarInt<br />
| <br />
|-<br />
| Yaw<br />
| Angle<br />
| New angle, not a delta<br />
|-<br />
| Pitch<br />
| Angle<br />
| New angle, not a delta<br />
|-<br />
| On Ground<br />
| Boolean<br />
| <br />
|}<br />
<br />
==== 实体朝向与相对移动 ====<br />
<br />
This packet is sent by the server when an entity rotates and moves. Since a byte range is limited from -128 to 127, and movement is offset of fixed-point numbers, this packet allows at most four blocks movement in any direction. (-128/32 == -4)<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="7"| 0x17<br />
|rowspan="7"| Play<br />
|rowspan="7"| Client<br />
| Entity ID<br />
| VarInt<br />
| <br />
|-<br />
| Delta X<br />
| Byte<br />
| Change in X position as a [[Data Types#Fixed-point numbers|Fixed-Point number]]<br />
|-<br />
| Delta Y<br />
| Byte<br />
| Change in Y position as a [[Data Types#Fixed-point numbers|Fixed-Point number]]<br />
|-<br />
| Delta Z<br />
| Byte<br />
| Change in Z position as a [[Data Types#Fixed-point numbers|Fixed-Point number]]<br />
|-<br />
| Yaw<br />
| Angle<br />
| New angle, not a delta<br />
|-<br />
| Pitch<br />
| Angle<br />
| New angle, not a delta<br />
|-<br />
| On Ground<br />
| Boolean<br />
| <br />
|}<br />
<br />
==== 实体传送 ====<br />
<br />
This packet is sent by the server when an entity moves more than 4 blocks.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="7"| 0x18<br />
|rowspan="7"| Play<br />
|rowspan="7"| Client<br />
| Entity ID<br />
| VarInt<br />
| <br />
|-<br />
| X<br />
| Int<br />
| X position as a [[Data Types#Fixed-point numbers|Fixed-Point number]]<br />
|-<br />
| Y<br />
| Int<br />
| Y position as a [[Data Types#Fixed-point numbers|Fixed-Point number]]<br />
|-<br />
| Z<br />
| Int<br />
| Z position as a [[Data Types#Fixed-point numbers|Fixed-Point number]]<br />
|-<br />
| Yaw<br />
| Angle<br />
| New angle, not a delta<br />
|-<br />
| Pitch<br />
| Angle<br />
| New angle, not a delta<br />
|-<br />
| On Ground<br />
| Boolean<br />
| <br />
|}<br />
<br />
==== 实体手朝向 ====<br />
<br />
Changes the direction an entity's head is facing.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="2"| 0x19<br />
|rowspan="2"| Play<br />
|rowspan="2"| Client<br />
| Entity ID<br />
| VarInt<br />
| <br />
|-<br />
| Head Yaw<br />
| Angle<br />
| New angle, not a delta<br />
|}<br />
<br />
==== 实体状态 ====<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="2"| 0x1A<br />
|rowspan="2"| Play<br />
|rowspan="2"| Client<br />
| Entity ID<br />
| Int<br />
| <br />
|-<br />
| Entity Status<br />
| Byte<br />
| See below<br />
|}<br />
<br />
{| class="wikitable"<br />
|-<br />
! Entity Status<br />
! Meaning<br />
|-<br />
| 1<br />
| Sent when resetting a mob spawn minecart's timer - appears to be unused by the client<br />
|-<br />
| 2<br />
| Living Entity hurt <br />
|-<br />
| 3<br />
| Living Entity dead<br />
|-<br />
| 4<br />
| Iron Golem throwing up arms<br />
|-<br />
| 6<br />
| Wolf/Ocelot/Horse taming — Spawn “heart” particles<br />
|-<br />
| 7<br />
| Wolf/Ocelot/Horse tamed — Spawn “smoke” particles<br />
|-<br />
| 8<br />
| Wolf shaking water — Trigger the shaking animation<br />
|-<br />
| 9<br />
| (of self) Eating accepted by server<br />
|-<br />
| 10<br />
| Sheep eating grass<br />
|-<br />
| 10<br />
| Play TNT ignite sound<br />
|-<br />
| 11<br />
| Iron Golem handing over a rose<br />
|-<br />
| 12<br />
| Villager mating — Spawn “heart” particles<br />
|-<br />
| 13<br />
| Spawn particles indicating that a villager is angry and seeking revenge<br />
|-<br />
| 14<br />
| Spawn happy particles near a villager<br />
|-<br />
| 15<br />
| Witch animation — Spawn “magic” particles<br />
|-<br />
| 16<br />
| Play zombie converting into a villager sound<br />
|-<br />
| 17<br />
| Firework exploding<br />
|-<br />
| 18<br />
| Animal in love (ready to mate) — Spawn “heart” particles<br />
|-<br />
| 19<br />
| Reset squid rotation<br />
|-<br />
| 20<br />
| Spawn explosion particle — works for some living entities<br />
|-<br />
| 21<br />
| Play guardian sound — works for every entity<br />
|-<br />
| 22<br />
| Enables reduced debug for players<br />
|-<br />
| 23<br />
| Disables reduced debug for players<br />
|}<br />
<br />
==== 附加实体 ====<br />
<br />
This packet is sent when a player has been attached to an entity (e.g. Minecart).<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="3"| 0x1B<br />
|rowspan="3"| Play<br />
|rowspan="3"| Client<br />
| Entity ID<br />
| Int<br />
| Attached entity's EID. Set to -1 to detach.<br />
|-<br />
| Vehicle ID<br />
| Int<br />
| Vechicle's Entity ID<br />
|-<br />
| Leash<br />
| Boolean<br />
| If true leashes the entity to the vehicle<br />
|}<br />
<br />
==== 实体数据值 ====<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="2"| 0x1C<br />
|rowspan="2"| Play<br />
|rowspan="2"| Client<br />
| Entity ID<br />
| VarInt<br />
| <br />
|-<br />
| Metadata<br />
| [[Entities#Entity Metadata Format|Metadata]]<br />
| <br />
|}<br />
<br />
==== 实体属性 ====<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="5"| 0x1D<br />
|rowspan="5"| Play<br />
|rowspan="5"| Client<br />
| Entity ID<br />
| VarInt<br />
| <br />
|-<br />
| Effect ID<br />
| Byte<br />
| See {{Minecraft Wiki|Status effect#List of effects|this table}}<br />
|-<br />
| Amplifier<br />
| Byte<br />
| Notchian client displays effect level as Amplifier + 1<br />
|-<br />
| Duration<br />
| VarInt<br />
| Seconds<br />
|-<br />
| Hide Particles<br />
| Boolean<br />
| <br />
|}<br />
<br />
==== 移除实体属性 ====<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="2"| 0x1E<br />
|rowspan="2"| Play<br />
|rowspan="2"| Client<br />
| Entity ID<br />
| VarInt<br />
| <br />
|-<br />
| Effect ID<br />
| Byte<br />
| See {{Minecraft Wiki|Status effect#List of effects|this table}}<br />
|}<br />
<br />
==== 设置经验值 ====<br />
<br />
Sent by the server when the client should change experience levels.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="3"| 0x1F<br />
|rowspan="3"| Play<br />
|rowspan="3"| Client<br />
| Experience bar<br />
| Float<br />
| Between 0 and 1<br />
|-<br />
| Level<br />
| VarInt<br />
| <br />
|-<br />
| Total Experience<br />
| VarInt<br />
| See {{Minecraft Wiki|Experience#Leveling up}} on the Minecraft Wiki for Total Experience to Level conversion<br />
|}<br />
<br />
==== 实体配置 ====<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
!colspan="2"| Field Name<br />
!colspan="2"| Field Type<br />
! Notes<br />
|-<br />
|rowspan="6"| 0x20<br />
|rowspan="6"| Play<br />
|rowspan="6"| Client<br />
|colspan="2"| Entity ID<br />
|colspan="2"| VarInt<br />
| <br />
|-<br />
|colspan="2"| Number Of Properties<br />
|colspan="2"| Int<br />
| Number of elements in the following array<br />
|-<br />
|rowspan="4"| Property<br />
| Key<br />
|rowspan="4"| Array<br />
| String<br />
| See below<br />
|-<br />
| Value<br />
| Double<br />
| See below<br />
|-<br />
| Number Of Modifiers<br />
| VarInt<br />
| Number of elements in the following array<br />
|-<br />
| Modifiers<br />
| Array of Modifier Data<br />
| See {{Minecraft Wiki|Attribute#Modifiers}}<br />
|}<br />
<br />
Known Key values:<br />
<br />
{| class="wikitable"<br />
|-<br />
! Key<br />
! Default<br />
! Min<br />
! Max<br />
! Label<br />
|-<br />
| generic.maxHealth<br />
| 20.0<br />
| 0.0<br />
| Double.MaxValue<br />
| Max Health<br />
|-<br />
| generic.followRange<br />
| 32.0<br />
| 0.0<br />
| 2048.0<br />
| Follow Range<br />
|-<br />
| generic.knockbackResistance<br />
| 0.0 <br />
| 0.0<br />
| 1.0<br />
| Knockback Resistance<br />
|-<br />
| generic.movementSpeed<br />
| 0.699999988079071<br />
| 0.0<br />
| Double.MaxValue<br />
| Movement Speed<br />
|-<br />
| generic.attackDamage<br />
| 2.0<br />
| 0.0<br />
| Double.MaxValue<br />
| <br />
|-<br />
| horse.jumpStrength<br />
| 0.7<br />
| 0.0<br />
| 2.0<br />
| Jump Strength<br />
|-<br />
| zombie.spawnReinforcements<br />
| 0.0<br />
| 0.0<br />
| 1.0<br />
| Spawn Reinforcements Chance<br />
|}<br />
<br />
''Modifier Data'' structure:<br />
<br />
{| class="wikitable"<br />
|-<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
| UUID<br />
| UUID<br />
| <br />
|-<br />
| Amount<br />
| Double<br />
| <br />
|-<br />
| Operation<br />
| Byte<br />
| <br />
|}<br />
<br />
==== 区块数据 ====<br />
<br />
Chunks are not unloaded by the client automatically. To unload chunks, send this packet with Ground-Up Continuous=true and no 16^3 chunks (eg. Primary Bit Mask=0). The server does not send skylight information for nether-chunks, it's up to the client to know if the player is currently in the nether. You can also infer this information from the primary bitmask and the amount of uncompressed bytes sent.<br />
<br />
See also: [[SMP Map Format]]<br />
<br />
Changes in 1.8:<br />
<br />
* Data value section removed<br />
* Extended id section removed<br />
* Block id section is now a unsigned short (little endian) per a block<br />
* The block id is equal to <code>(id << 4) | data</code><br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="6"| 0x21<br />
|rowspan="6"| Play<br />
|rowspan="6"| Client<br />
| Chunk X<br />
| Int<br />
| Chunk X coordinate<br />
|-<br />
| Chunk Z<br />
| Int<br />
| Chunk Z coordinate<br />
|-<br />
| Ground-Up Continuous<br />
| Boolean<br />
| This is true if the packet represents all sections in this vertical column, where the Primary Bit Mask specifies exactly which sections are included, and which are air<br />
|-<br />
| Primary Bit Mask<br />
| Unsigned Short<br />
| Bitmask with 1 for every 16x16x16 section whose data follows in the compressed data<br />
|- <br />
| Size<br />
| VarInt<br />
| Size of Data<br />
|-<br />
| Data<br />
| [[SMP Map Format#Data|Chunk]]<br />
| <br />
|}<br />
<br />
==== 多个方块改变 ====<br />
Fired whenever 2 or more blocks are changed within the render distance.<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
!colspan="2"| Field Name<br />
!colspan="2"| Field Type<br />
! Notes<br />
|-<br />
|rowspan="6"| 0x22<br />
|rowspan="6"| Play<br />
|rowspan="6"| Client<br />
|colspan="2"| Chunk X<br />
|colspan="2"| Int<br />
| Chunk X coordinate<br />
|-<br />
|colspan="2"| Chunk Z<br />
|colspan="2"| Int<br />
| Chunk Z coordinate<br />
|-<br />
|colspan="2"| Record Count<br />
|colspan="2"| VarInt<br />
| Number of elements in the following array, a.k.a. the number of blocks affected<br />
|-<br />
|rowspan="3"| Record<br />
| Horizontal Position<br />
|rowspan="3"| Array<br />
| Unsigned Byte<br />
| The 4 most significant bits (<code>0xF0</code>) encode the X coordinate, relative to the chunk. The 4 least significant bits (<code>0x0F</code>) encode the Z coordinate, relative to the chunk.<br />
|-<br />
| Y Coordinate<br />
| Unsigned Byte<br />
| <br />
|-<br />
| Block ID<br />
| VarInt<br />
| The new block ID for the block. <code><nowiki>id &lt;&lt; 4 | data</nowiki></code><br />
|}<br />
<br />
==== 方块改变 ====<br />
Fired whenever a block is changed within the render distance.<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="2"| 0x23<br />
|rowspan="2"| Play<br />
|rowspan="2"| Client<br />
| Location<br />
| Position<br />
| Block Coordinates<br />
|-<br />
| Block ID<br />
| VarInt<br />
| The new block ID for the block. <code><nowiki>id &lt;&lt; 4 | data</nowiki></code><br />
|}<br />
<br />
==== 方块功能 ====<br />
<br />
This packet is used for a number of things:<br />
<br />
* Chests opening and closing<br />
* Pistons pushing and pulling<br />
* Note blocks playing<br />
* Updating beacons<br />
<br />
See Also: [[Block Actions]] <br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="4"| 0x24<br />
|rowspan="4"| Play<br />
|rowspan="4"| Client<br />
| Location<br />
| Position<br />
| Block Coordinates<br />
|-<br />
| Byte 1<br />
| Unsigned Byte<br />
| Varies depending on block — see [[Block Actions]]<br />
|-<br />
| Byte 2<br />
| Unsigned Byte<br />
| Varies depending on block — see [[Block Actions]]<br />
|-<br />
| Block Type<br />
| VarInt<br />
| The block type for the block<br />
|}<br />
<br />
==== 方块破坏动画 ====<br />
<br />
0–9 are the displayable destroy stages and each other number means that there is no animation on this coordinate.<br />
<br />
You can also set an animation to air! The animation will still be visible.<br />
<br />
If you need to display several break animations at the same time you have to give each of them a unique Entity ID.<br />
<br />
Also if you set the coordinates to a special block like water etc. it won't show the actual break animation but some other interesting effects. (Water will lose it's transparency)<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="3"| 0x25<br />
|rowspan="3"| Play<br />
|rowspan="3"| Client<br />
| Entity ID<br />
| VarInt<br />
| EID for the animation<br />
|-<br />
| Location<br />
| Position<br />
| Block Position<br />
|-<br />
| Destroy Stage<br />
| Byte<br />
| 0–9 to set it, any other value to remove it<br />
|}<br />
<br />
==== 地图区块 ====<br />
<br />
1.8 changes at [[#Chunk Data|Chunk Data]]<br />
<br />
To reduce the number of bytes, this packet is used to send chunks together for better compression results.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
!colspan="2"| Field Name<br />
!colspan="2"| Field Type<br />
! Notes<br />
|-<br />
|rowspan="7"| 0x26<br />
|rowspan="7"| Play<br />
|rowspan="7"| Client<br />
|colspan="2"| Sky Light Sent<br />
|colspan="2"| Boolean<br />
| Whether or not Chunk Data contains light nibble arrays. This is true in the Overworld, false in the End + Nether<br />
|-<br />
|colspan="2"| Chunk Column Count<br />
|colspan="2"| VarInt<br />
| Number of elements in each of the following arrays<br />
|-<br />
|rowspan="3"| Chunk Meta<br />
| Chunk X<br />
|rowspan="3"| Array<br />
| Int<br />
| The X coordinate of the chunk<br />
|-<br />
| Chunk Z<br />
| Int<br />
| The Z coordinate of the chunk<br />
|-<br />
| Primary Bit Mask<br />
| Unsigned Short<br />
| A bit mask which specifies which sections are not empty in this chunk<br />
|-<br />
|colspan="2"| Chunk Data<br />
|colspan="2"| Array of [[SMP Map Format#Data|Chunk]]<br />
| Each chunk in this array corresponds to the data at the same position in Chunk Meta<br />
|}<br />
<br />
==== 爆炸 ====<br />
<br />
Sent when an explosion occurs (creepers, TNT, and ghast fireballs).<br />
<br />
Each block in Records is set to air. Coordinates for each axis in record is int(X) + record.x<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="9"| 0x27<br />
|rowspan="9"| Play<br />
|rowspan="9"| Client<br />
| X<br />
| Float<br />
| <br />
|-<br />
| Y<br />
| Float<br />
| <br />
|-<br />
| Z<br />
| Float<br />
| <br />
|-<br />
| Radius<br />
| Float<br />
| Currently unused in the client<br />
|-<br />
| Record Count<br />
| Int<br />
| Number of elements in the following array<br />
|-<br />
| Records<br />
| Array of (Byte, Byte, Byte)<br />
| Each record is 3 signed bytes long, each bytes are the XYZ (respectively) offsets of affected blocks.<br />
|-<br />
| Player Motion X<br />
| Float<br />
| X velocity of the player being pushed by the explosion<br />
|-<br />
| Player Motion Y<br />
| Float<br />
| Y velocity of the player being pushed by the explosion<br />
|-<br />
| Player Motion Z<br />
| Float<br />
| Z velocity of the player being pushed by the explosion<br />
|}<br />
<br />
==== 属性 ====<br />
<br />
Sent when a client is to play a sound or particle effect.<br />
<br />
By default, the Minecraft client adjusts the volume of sound effects based on distance. The final boolean field is used to disable this, and instead the effect is played from 2 blocks away in the correct direction. Currently this is only used for effect 1013 (mob.wither.spawn), and is ignored for any other value by the client.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="4"| 0x28<br />
|rowspan="4"| Play<br />
|rowspan="4"| Client<br />
| Effect ID<br />
| Int<br />
| The ID of the effect, see below<br />
|-<br />
| Location<br />
| Position<br />
| The location of the effect<br />
|-<br />
| Data<br />
| Int<br />
| Extra data for certain effects, see below<br />
|-<br />
| Disable Relative Volume<br />
| Boolean<br />
| See above<br />
|}<br />
<br />
Effect IDs:<br />
<br />
{| class="wikitable"<br />
! ID<br />
! Name<br />
! Data<br />
|-<br />
!colspan="3"| Sound<br />
|-<br />
| 1000<br />
| <code>random.click</code><br />
| <br />
|-<br />
| 1001<br />
| <code>random.click</code><br />
| <br />
|-<br />
| 1002<br />
| <code>random.bow</code><br />
| <br />
|-<br />
| 1003<br />
| <code>random.door_open</code> or <code>random.door_close</code> (50/50 chance)<br />
| <br />
|-<br />
| 1004<br />
| <code>random.fizz</code><br />
| <br />
|-<br />
| 1005<br />
| Play a music disc.<br />
| {{Minecraft Wiki|Music Discs|Record ID}}<br />
|-<br />
| 1006<br />
| ''not assigned''<br />
| <br />
|-<br />
| 1007<br />
| <code>mob.ghast.charge</code><br />
| <br />
|-<br />
| 1008<br />
| <code>mob.ghast.fireball</code><br />
| <br />
|-<br />
| 1009<br />
| <code>mob.ghast.fireball</code>, but with a lower volume<br />
| <br />
|-<br />
| 1010<br />
| <code>mob.zombie.wood</code><br />
| <br />
|-<br />
| 1011<br />
| <code>mob.zombie.metal</code><br />
| <br />
|-<br />
| 1012<br />
| <code>mob.zombie.woodbreak</code><br />
| <br />
|-<br />
| 1013<br />
| <code>mob.wither.spawn</code><br />
| <br />
|-<br />
| 1014<br />
| <code>mob.wither.shoot</code><br />
| <br />
|-<br />
| 1015<br />
| <code>mob.bat.takeoff</code><br />
| <br />
|-<br />
| 1016<br />
| <code>mob.zombie.infect</code><br />
| <br />
|-<br />
| 1017<br />
| <code>mob.zombie.unfect</code><br />
| <br />
|-<br />
| 1018<br />
| <code>mob.enderdragon.end</code><br />
| <br />
|-<br />
| 1020<br />
| <code>random.anvil_break</code><br />
| <br />
|-<br />
| 1021<br />
| <code>random.anvil_use</code><br />
| <br />
|-<br />
| 1022<br />
| <code>random.anvil_land</code><br />
| <br />
|-<br />
!colspan="3"| Particle<br />
|-<br />
| 2000<br />
| Spawns 10 smoke particles, e.g. from a fire<br />
| Direction, see below<br />
|-<br />
| 2001<br />
| Block break<br />
| {{Minecraft Wiki|Data values|Block ID}}<br />
|-<br />
| 2002<br />
| Splash potion. Particle effect + glass break sound.<br />
| [http://www.lb-stuff.com/Minecraft/PotionDataValues1.9pre3.txt Potion ID]<br />
|-<br />
| 2003<br />
| Eye of Ender entity break animation — particles and sound<br />
| <br />
|-<br />
| 2004<br />
| Mob spawn particle effect: smoke + flames<br />
| <br />
|-<br />
| 2005<br />
| Spawn “happy villager” effect (green crosses), used for bonemealing vegetation<br />
| <br />
|}<br />
<br />
Smoke directions:<br />
<br />
{| class="wikitable"<br />
! ID<br />
! Direction<br />
|-<br />
| 0<br />
| South-East<br />
|-<br />
| 1<br />
| South<br />
|-<br />
| 2<br />
| South-West<br />
|-<br />
| 3<br />
| East<br />
|-<br />
| 4<br />
| (Up or middle ?)<br />
|-<br />
| 5<br />
| West<br />
|-<br />
| 6<br />
| North-East<br />
|-<br />
| 7<br />
| North<br />
|-<br />
| 8<br />
| North-West<br />
|}<br />
<br />
==== 声音特效 ====<br />
<br />
Used to play a sound effect on the client.<br />
<br />
Custom sounds may be added by resource packs.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="6"| 0x29<br />
|rowspan="6"| Play<br />
|rowspan="6"| Client<br />
| Sound name<br />
| String<br />
| All known sound effect names can be seen [https://github.com/SirCmpwn/Craft.Net/blob/master/source/Craft.Net.Common/SoundEffect.cs here]<br />
|-<br />
| Effect position X<br />
| Int<br />
| Effect X multiplied by 8<br />
|-<br />
| Effect position Y<br />
| Int<br />
| Effect Y multiplied by 8<br />
|-<br />
| Effect position Z<br />
| Int<br />
| Effect Z multiplied by 8<br />
|-<br />
| Volume<br />
| Float<br />
| 1 is 100%, can be more<br />
|-<br />
| Pitch<br />
| Unsigned Byte<br />
| 63 is 100%, can be more<br />
|}<br />
<br />
==== 粒子效果 ====<br />
<br />
Displays the named particle<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="11"| 0x2A<br />
|rowspan="11"| Play<br />
|rowspan="11"| Client<br />
| Particle ID<br />
| Int<br />
| See below<br />
|-<br />
| Long Distance<br />
| Boolean<br />
| If true, particle distance increases from 256 to 65536<br />
|-<br />
| X<br />
| Float<br />
| X position of the particle<br />
|-<br />
| Y<br />
| Float<br />
| Y position of the particle<br />
|-<br />
| Z<br />
| Float<br />
| Z position of the particle<br />
|-<br />
| Offset X<br />
| Float<br />
| This is added to the X position after being multiplied by random.nextGaussian()<br />
|-<br />
| Offset Y<br />
| Float<br />
| This is added to the Y position after being multiplied by random.nextGaussian()<br />
|-<br />
| Offset Z<br />
| Float<br />
| This is added to the Z position after being multiplied by random.nextGaussian()<br />
|-<br />
| Particle Data<br />
| Float<br />
| The data of each particle<br />
|-<br />
| Particle Count<br />
| Int<br />
| The number of particles to create<br />
|-<br />
| Data<br />
| Array of VarInt<br />
| Length depends on particle. "iconcrack" has length of 2, "blockcrack", and "blockdust" have lengths of 1, the rest have 0.<br />
|}<br />
<br />
Particle IDs:<br />
<br />
{| class="wikitable"<br />
|-<br />
! Particle Name<br />
! Particle ID<br />
|-<br />
| explode<br />
| 0<br />
|-<br />
| largeexplosion<br />
| 1<br />
|-<br />
| hugeexplosion<br />
| 2<br />
|-<br />
| fireworksSpark<br />
| 3<br />
|-<br />
| bubble<br />
| 4<br />
|-<br />
| splash<br />
| 5<br />
|-<br />
| wake<br />
| 6<br />
|-<br />
| suspended<br />
| 7<br />
|-<br />
| depthsuspend<br />
| 8<br />
|-<br />
| crit<br />
| 9<br />
|-<br />
| magicCrit<br />
| 10<br />
|-<br />
| smoke<br />
| 11<br />
|-<br />
| largesmoke<br />
| 12<br />
|-<br />
| spell<br />
| 13<br />
|-<br />
| instantSpell<br />
| 14<br />
|-<br />
| mobSpell<br />
| 15<br />
|-<br />
| mobSpellAmbient<br />
| 16<br />
|-<br />
| witchMagic<br />
| 17<br />
|-<br />
| dripWater<br />
| 18<br />
|-<br />
| dripLava<br />
| 19<br />
|-<br />
| angryVillager<br />
| 20<br />
|-<br />
| happyVillager<br />
| 21<br />
|-<br />
| townaura<br />
| 22<br />
|-<br />
| note<br />
| 23<br />
|-<br />
| portal<br />
| 24<br />
|-<br />
| enchantmenttable<br />
| 25<br />
|-<br />
| flame<br />
| 26<br />
|-<br />
| lava<br />
| 27<br />
|-<br />
| footstep<br />
| 28<br />
|-<br />
| cloud<br />
| 29<br />
|-<br />
| reddust<br />
| 30<br />
|-<br />
| snowballpoof<br />
| 31<br />
|-<br />
| snowshovel<br />
| 32<br />
|-<br />
| slime<br />
| 33<br />
|-<br />
| heart<br />
| 34<br />
|-<br />
| barrier<br />
| 35<br />
|-<br />
| iconcrack_(id)_(data)<br />
| 36<br />
|-<br />
| blockcrack_(id+(data<<12))<br />
| 37<br />
|-<br />
| blockdust_(id)<br />
| 38<br />
|-<br />
| droplet<br />
| 39<br />
|-<br />
| take<br />
| 40<br />
|-<br />
| mobappearance<br />
| 41<br />
|}<br />
<br />
==== 改变游戏状态 ====<br />
<br />
It appears when a bed can't be used as a spawn point and when the rain state changes.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="2"| 0x2B<br />
|rowspan="2"| Play<br />
|rowspan="2"| Client<br />
| Reason<br />
| Unsigned Byte<br />
| See below<br />
|-<br />
| Value<br />
| Float<br />
| Depends on Reason<br />
|}<br />
<br />
''Reason codes'':<br />
<br />
{| class="wikitable"<br />
! Reason<br />
! Effect<br />
! Value<br />
|-<br />
| 0<br />
| Invalid Bed<br />
| <br />
|-<br />
| 1<br />
| End raining<br />
| <br />
|-<br />
| 2<br />
| Begin raining<br />
| <br />
|-<br />
| 3<br />
| Change game mode<br />
| 0: Survival, 1: Creative, 2: Adventure, 3: Spectator<br />
|-<br />
| 4<br />
| Enter credits<br />
| <br />
|-<br />
| 5<br />
| Demo message<br />
| 0: Show welcome to demo screen, 101: Tell movement controls, 102: Tell jump control, 103: Tell inventory control<br />
|- <br />
| 6<br />
| Arrow hitting player<br />
| Appears to be played when an arrow strikes another player in Multiplayer<br />
|-<br />
| 7<br />
| Fade value<br />
| The current darkness value. 1 = Dark, 0 = Bright, Setting the value higher causes the game to change color and freeze<br />
|-<br />
| 8<br />
| Fade time<br />
| Time in ticks for the sky to fade<br />
|-<br />
| 10<br />
| Play mob appearance (effect and sound)<br />
| Unknown<br />
|}<br />
<br />
==== 生存全局实体 ====<br />
<br />
With this packet, the server notifies the client of thunderbolts striking within a 512 block radius around the player. The coordinates specify where exactly the thunderbolt strikes.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="5"| 0x2C<br />
|rowspan="5"| Play<br />
|rowspan="5"| Client<br />
| Entity ID<br />
| VarInt<br />
| The EID of the thunderbolt<br />
|-<br />
| Type<br />
| Byte<br />
| The global entity type, currently always 1 for thunderbolt<br />
|-<br />
| X<br />
| Int<br />
| Thunderbolt X, a [[Data Types#Fixed-point numbers|fixed-point number]]<br />
|-<br />
| Y<br />
| Int<br />
| Thunderbolt Y, a [[Data Types#Fixed-point numbers|fixed-point number]]<br />
|-<br />
| Z<br />
| Int<br />
| Thunderbolt Z, a [[Data Types#Fixed-point numbers|fixed-point number]]<br />
|}<br />
<br />
==== 打开窗户 ====<br />
<br />
This is sent to the client when it should open an inventory, such as a chest, workbench, or furnace. This message is not sent anywhere for clients opening their own inventory.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="5"| 0x2D<br />
|rowspan="5"| Play<br />
|rowspan="5"| Client<br />
| Window ID<br />
| Unsigned Byte<br />
| A unique id number for the window to be displayed. Notchian server implementation is a counter, starting at 1.<br />
|-<br />
| Window Type<br />
| String<br />
| The window type to use for display. See [[Inventory]] for a list.<br />
|-<br />
| Window Title<br />
| [[Chat]]<br />
| The title of the window<br />
|-<br />
| Number Of Slots<br />
| Unsigned Byte<br />
| Number of slots in the window (excluding the number of slots in the player inventory)<br />
|-<br />
| Entity ID<br />
| Optional Int<br />
| EntityHorse's EID. Only sent when Window Type is “EntityHorse”<br />
|}<br />
<br />
See [[Inventory]] for further information.<br />
<br />
==== 关闭窗户 ====<br />
<br />
This packet is sent from the server to the client when a window is forcibly closed, such as when a chest is destroyed while it's open.<br />
<br />
Note, notchian clients send a close window packet with Window ID 0 to close their inventory even though there is never an [[#Open Window|Open Window]] packet for inventory. <br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
| 0x2E<br />
|rowspan="1"| Play<br />
|rowspan="1"| Client<br />
| Window ID<br />
| Unsigned Byte<br />
| This is the ID of the window that was closed. 0 for inventory.<br />
|}<br />
<br />
==== 设置位置 ====<br />
<br />
Sent by the server when an item in a slot (in a window) is added/removed.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="3"| 0x2F<br />
|rowspan="3"| Play<br />
|rowspan="3"| Client<br />
| Window ID<br />
| Byte<br />
| The window which is being updated. 0 for player inventory. Note that all known window types include the player inventory. This packet will only be sent for the currently opened window while the player is performing actions, even if it affects the player inventory. After the window is closed, a number of these packets are sent to update the player's inventory window (0).<br />
|-<br />
| Slot<br />
| Short<br />
| The slot that should be updated<br />
|-<br />
| Slot Data<br />
| [[Slot Data|Slot]]<br />
| <br />
|}<br />
<br />
==== 窗口物品 ====<br />
<br />
[[File:Inventory-slots.png|thumb|The inventory slots]]<br />
<br />
Sent by the server when items in multiple slots (in a window) are added/removed. This includes the main inventory, equipped armour and crafting slots.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="3"| 0x30<br />
|rowspan="3"| Play<br />
|rowspan="3"| Client<br />
| Window ID<br />
| Unsigned Byte<br />
| The ID of window which items are being sent for. 0 for player inventory.<br />
|-<br />
| Count<br />
| Short<br />
| Number of elements in the following array<br />
|-<br />
| Slot Data<br />
| Array of [[Slot Data|Slot]]<br />
| <br />
|}<br />
<br />
See [[Inventory#Windows|inventory windows]] for further information about how slots are indexed.<br />
<br />
==== 窗体属性 ====<br />
<br />
此包是用于与客户端交流更新GUI窗体的部分。<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="3"| 0x31<br />
|rowspan="3"| Play<br />
|rowspan="3"| Client<br />
| Window ID<br />
| Unsigned Byte<br />
| <br />
|-<br />
| Property<br />
| Short<br />
| 要更新的属性，见下文<br />
|-<br />
| Value<br />
| Short<br />
| 属性的新值，见下文<br />
|}<br />
<br />
属性字段的含义取决于窗体的类型。下表显示了窗体类型和属性的已知组合和价值的定义范围。<br />
<br />
{| class="wikitable"<br />
|-<br />
! Window type<br />
! Property<br />
! Value<br />
|-<br />
|rowspan="2"| Furnace<br />
| 0: Progress arrow<br />
| 0–200 (presumably in in-game ticks)<br />
|-<br />
| 1: Fire icon (fuel)<br />
| 0–200 (presumably in in-game ticks)<br />
|-<br />
|rowspan="7"| Enchantment Table<br />
| 0: Level requirement for top enchantment slot<br />
|rowspan="3"| The enchantment's xp level requirement<br />
|-<br />
| 1: Level requirement for middle enchantment slot<br />
|-<br />
| 2: Level requirement for bottom enchantment slot<br />
|-<br />
| 3: The seed for generating the enchantments view for the client<br />
| Unknown<br />
|-<br />
| 4: tooltip shown on mouse hover over top enchantment slot<br />
|rowspan="3"| Unknown (set to -1 to hide it)<br />
|-<br />
| 5: tooltip shown on mouse hover over middle enchantment slot<br />
|-<br />
| 6: tooltip shown on mouse hover over bottom enchantment slot<br />
|-<br />
|rowspan="3"| Beacon<br />
| 0: Power level<br />
| Unknown<br />
|-<br />
| 1: First potion effect<br />
| Unknown<br />
|-<br />
| 2: Second potion effect<br />
| Unknown<br />
|-<br />
| Anvil<br />
| 0: Repair cost<br />
| The repair's cost in xp levels<br />
|-<br />
| Brewing Stand<br />
| 0: Brew time<br />
| 0–400, with 400 making the arrow empty, and 0 making the arrow full<br />
|}<br />
<br />
==== 确认事物 ====<br />
<br />
A packet from the server indicating whether a request from the client was accepted, or whether there was a conflict (due to lag).<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="3"| 0x32<br />
|rowspan="3"| Play<br />
|rowspan="3"| Client<br />
| Window ID<br />
| Byte<br />
| The ID of the window that the action occurred in<br />
|-<br />
| Action Number<br />
| Short<br />
| Every action that is to be accepted has a unique number. This field corresponds to that number.<br />
|-<br />
| Accepted<br />
| Boolean<br />
| Whether the action was accepted<br />
|}<br />
<br />
==== 更新标志 ====<br />
<br />
This message is sent from the server to the client whenever a sign is discovered or created. This message is NOT sent when a sign is destroyed or unloaded.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="5"| 0x33<br />
|rowspan="5"| Play<br />
|rowspan="5"| Client<br />
| Location<br />
| Position<br />
| <br />
|-<br />
| Line 1<br />
| [[Chat]]<br />
| First line of text in the sign<br />
|-<br />
| Line 2<br />
| [[Chat]]<br />
| Second line of text in the sign<br />
|-<br />
| Line 3<br />
| [[Chat]]<br />
| Third line of text in the sign<br />
|-<br />
| Line 4<br />
| [[Chat]]<br />
| Fourth line of text in the sign<br />
|}<br />
<br />
==== 地图 ====<br />
<br />
Updates a rectangular area on a map.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
!colspan="2"| Field Name<br />
!colspan="2"| Field Type<br />
! Notes<br />
|-<br />
|rowspan="12"| 0x34<br />
|rowspan="12"| Play<br />
|rowspan="12"| Client<br />
|colspan="2"| Item Damage<br />
|colspan="2"| VarInt<br />
| The damage value (map ID) of the map being modified<br />
|-<br />
|colspan="2"| Scale<br />
|colspan="2"| Byte<br />
| <br />
|- <br />
|colspan="2"| Icon Count<br />
|colspan="2"| VarInt<br />
| Number of elements in the following array<br />
|-<br />
|rowspan="3"| Icon<br />
| Direction And Type<br />
|rowspan="3"| Array<br />
| Byte<br />
| 0xF0 = Direction, 0x0F = Type<br />
|-<br />
| X<br />
| Byte<br />
| <br />
|-<br />
| Z<br />
| Byte<br />
| <br />
|- <br />
|colspan="2"| Columns<br />
|colspan="2"| Byte<br />
| Number of columns updated<br />
|-<br />
|colspan="2"| Rows<br />
|colspan="2"| Optional Byte<br />
| Only if Columns is more than 0; number of rows updated<br />
|-<br />
|colspan="2"| X<br />
|colspan="2"| Optional Byte<br />
| Only if Columns is more than 0; x offset of the westernmost column<br />
|-<br />
|colspan="2"| Z<br />
|colspan="2"| Optional Byte<br />
| Only if Columns is more than 0; z offset of the northernmost row<br />
|-<br />
|colspan="2"| Length<br />
|colspan="2"| Optional VarInt<br />
| Only if Columns is more than 0; length of the following array<br />
|-<br />
|colspan="2"| Data<br />
|colspan="2"| Optional Array of Unsigned Byte<br />
| Only if Columns is more than 0; see {{Minecraft Wiki|Map item format}}<br />
|}<br />
<br />
==== 更新方块实体 ====<br />
<br />
Essentially a block update on a block entity.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="3"| 0x35<br />
|rowspan="3"| Play<br />
|rowspan="3"| Client<br />
| Location<br />
| Position<br />
| <br />
|-<br />
| Action<br />
| Unsigned Byte<br />
| The type of update to perform, see below<br />
|-<br />
| NBT Data<br />
| Optional [[NBT|NBT Tag]]<br />
| If not present then it's a TAG_END (0)<br />
|}<br />
<br />
''Action'' field:<br />
<br />
* '''1''': Set SpawnPotentials of a mob spawner<br />
* '''2''': Set command block text (command and last execution status)<br />
* '''3''': Set the level, primary, and secondary powers of a beacon<br />
* '''4''': Set rotation and skin of mob head<br />
* '''5''': Set type of flower in flower pot<br />
* '''6''': Set base color and patterns on a banner<br />
<br />
==== 打开标志牌编辑器 ====<br />
<br />
Sent on placement of sign.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="1"| 0x36<br />
|rowspan="1"| Play<br />
|rowspan="1"| Client<br />
| Location<br />
| Position<br />
| <br />
|}<br />
<br />
==== 统计数据 ====<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To <br />
!colspan="2"| Field Name<br />
!colspan="2"| Field Type<br />
! Notes<br />
|-<br />
|rowspan="3"| 0x37<br />
|rowspan="3"| Play<br />
|rowspan="3"| Client<br />
|colspan="2"| Count<br />
|colspan="2"| VarInt<br />
| Number of elements in the following array<br />
|-<br />
|rowspan="2"| Statistic<br />
| Name<br />
|rowspan="2"| Array<br />
| String<br />
| [https://gist.github.com/thinkofdeath/a1842c21a0cf2e1fb5e0 https://gist.github.com/thinkofdeath/a1842c21a0cf2e1fb5e0]<br />
|-<br />
| Value<br />
| VarInt<br />
| The amount to set it to<br />
|}<br />
<br />
==== 玩家列表项 ====<br />
<br />
Sent by the notchian server to update the user list (<tab> in the client).<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
!colspan="4"| Field Name<br />
!colspan="3"| Field Type<br />
! Notes<br />
|-<br />
|rowspan="19"| 0x38<br />
|rowspan="19"| Play<br />
|rowspan="19"| Client<br />
|colspan="4"| Action<br />
|colspan="3"| VarInt<br />
| Determines the rest of the Player format after the UUID<br />
|-<br />
|colspan="4"| Number Of Players<br />
|colspan="3"| VarInt<br />
| Number of elements in the following array<br />
|-<br />
|rowspan="17"| Player<br />
|colspan="3"| UUID<br />
|rowspan="17"| Array<br />
|colspan="2"| UUID<br />
| <br />
|-<br />
! Action<br />
!colspan="2"| Field Name<br />
!colspan="2"| <br />
! <br />
|-<br />
|rowspan="10"| 0: add player<br />
|colspan="2"| Name<br />
|colspan="2"| String<br />
| <br />
|-<br />
|colspan="2"| Number Of Properties<br />
|colspan="2"| VarInt<br />
| Number of elements in the following array<br />
|-<br />
|rowspan="4"| Property<br />
| Name<br />
|rowspan="4"| Array<br />
| String<br />
| <br />
|-<br />
| Value<br />
| String<br />
| <br />
|- <br />
| Is Signed<br />
| Boolean<br />
| <br />
|-<br />
| Signature<br />
| Optional String<br />
| Only if Is Signed is true<br />
|-<br />
|colspan="2"| Gamemode<br />
|colspan="2"| VarInt<br />
| <br />
|-<br />
|colspan="2"| Ping<br />
|colspan="2"| VarInt<br />
| <br />
|-<br />
|colspan="2"| Has Display Name<br />
|colspan="2"| Boolean<br />
| <br />
|-<br />
|colspan="2"| Display Name<br />
|colspan="2"| Optional [[Chat]]<br />
| Only if Has Display Name is true<br />
|-<br />
| 1: update gamemode<br />
|colspan="2"| Gamemode<br />
|colspan="2"| VarInt<br />
| <br />
|- <br />
| 2: update latency<br />
|colspan="2"| Ping<br />
|colspan="2"| VarInt<br />
| <br />
|-<br />
|rowspan="2"| 3: update display name<br />
|colspan="2"| Has Display Name<br />
|colspan="2"| Boolean<br />
| <br />
|-<br />
|colspan="2"| Display Name<br />
|colspan="2"| Optional [[Chat]]<br />
| Only send if Has Display Name is true<br />
|-<br />
| 4: remove player<br />
|colspan="2"| ''no fields''<br />
|colspan="2"| ''no fields''<br />
| <br />
|}<br />
<br />
==== 玩家能力 ====<br />
<br />
The latter 2 floats are used to indicate the walking and flying speeds respectively, while the first byte is used to determine the value of 4 booleans.<br />
<br />
The flags are whether damage is disabled (god mode, 8, bit 3), whether the player can fly (4, bit 2), whether the player is flying (2, bit 1), and whether the player is in creative mode (1, bit 0).<br />
<br />
To get the values of these booleans, simply AND (&) the byte with 1,2,4 and 8 respectively, to get the 0 or 1 bitwise value. To set them OR (|) them with their repspective masks.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="3"| 0x39<br />
|rowspan="3"| Play<br />
|rowspan="3"| Client<br />
| Flags<br />
| Byte<br />
| Bit mask, see above<br />
|-<br />
| Flying Speed<br />
| Float<br />
| <br />
|-<br />
| Walking Speed<br />
| Float<br />
| <br />
|}<br />
<br />
==== Tab补全 ====<br />
<br />
The server responds with a list of auto-completions of the last word sent to it. In the case of regular chat, this is a player username. Command names and parameters are also supported.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="2"| 0x3A<br />
|rowspan="2"| Play<br />
|rowspan="2"| Client<br />
| Count<br />
| VarInt<br />
| Number of elements in the following array<br />
|-<br />
| Matches<br />
| Array of String<br />
| One eligible command, note that each command is sent separately instead of in a single string, hence the need for Count<br />
|}<br />
<br />
==== 计分板目标 ====<br />
<br />
This is sent to the client when it should create a new {{Minecraft Wiki|scoreboard}} objective or remove one.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="4"| 0x3B<br />
|rowspan="4"| Play<br />
|rowspan="4"| Client<br />
| Objective Name<br />
| String<br />
| An unique name for the objective<br />
|-<br />
| Mode<br />
| Byte<br />
| 0 to create the scoreboard. 1 to remove the scoreboard. 2 to update the display text. <br />
|-<br />
| Objective Value<br />
| Optional String<br />
| Only if mode is 0 or 2. The text to be displayed for the score<br />
|-<br />
| Type<br />
| Optional String<br />
| Only if mode is 0 or 2. “integer” or “hearts”<br />
|}<br />
<br />
==== 更新分数 ====<br />
<br />
This is sent to the client when it should update a scoreboard item. <br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="4"| 0x3C<br />
|rowspan="4"| Play<br />
|rowspan="4"| Client<br />
| Score Name<br />
| String<br />
| The name of the score to be updated or removed<br />
|-<br />
| Action<br />
| Byte<br />
| 0 to create/update an item. 1 to remove an item.<br />
|-<br />
| Objective Name<br />
| String<br />
| The name of the objective the score belongs to<br />
|-<br />
| Value<br />
| Optional VarInt<br />
| The score to be displayed next to the entry. Only sent when Action does not equal 1.<br />
|}<br />
<br />
==== 显示计分板 ====<br />
<br />
This is sent to the client when it should display a scoreboard.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="2"| 0x3D<br />
|rowspan="2"| Play<br />
|rowspan="2"| Client<br />
| Position<br />
| Byte<br />
| The position of the scoreboard. 0: list, 1: sidebar, 2: below name.<br />
|-<br />
| Score Name<br />
| String<br />
| The unique name for the scoreboard to be displayed.<br />
|}<br />
<br />
==== 团队 ====<br />
<br />
Creates and updates teams.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="10"| 0x3E<br />
|rowspan="10"| Play<br />
|rowspan="10"| Client<br />
| Team Name<br />
| String<br />
| A unique name for the team. (Shared with scoreboard).<br />
|-<br />
| Mode<br />
| Byte<br />
| If 0 then the team is created.<br />
<br />
If 1 then the team is removed. <br />
<br />
If 2 the team team information is updated. <br />
<br />
If 3 then new players are added to the team. <br />
<br />
If 4 then players are removed from the team.<br />
|-<br />
| Team Display Name<br />
| Optional String<br />
| Only if Mode = 0 or 2.<br />
|-<br />
| Team Prefix<br />
| Optional String<br />
| Only if Mode = 0 or 2. Displayed before the players' name that are part of this team<br />
|-<br />
| Team Suffix<br />
| Optional String<br />
| Only if Mode = 0 or 2. Displayed after the players' name that are part of this team<br />
|-<br />
| Friendly Fire<br />
| Optional Byte<br />
| Only if Mode = 0 or 2. 0 for off, 1 for on, 3 for seeing friendly invisibles<br />
|-<br />
| Name Tag Visibility<br />
| Optional String<br />
| Only if Mode = 0 or 2. always, hideForOtherTeams, hideForOwnTeam, never<br />
|-<br />
| Color<br />
| Optional Byte<br />
| Only if Mode = 0 or 2. Same as [[Chat]] colors<br />
|-<br />
| Player Count<br />
| Optional VarInt<br />
| Only if Mode = 0 or 3 or 4. Number of players in the array<br />
|-<br />
| Players<br />
| Optional Array of String<br />
| Only if Mode = 0 or 3 or 4. Players to be added/remove from the team. Max 40 characters so may be uuid's later<br />
|}<br />
<br />
==== 插件信息 ====<br />
<br />
Mods and plugins can use this to send their data. Minecraft itself uses a number of [[plugin channel]]s. These internal channels are prefixed with <code>MC|</code>.<br />
<br />
More documentation on this: [http://dinnerbone.com/blog/2012/01/13/minecraft-plugin-channels-messaging/ http://dinnerbone.com/blog/2012/01/13/minecraft-plugin-channels-messaging/]<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="2"| 0x3F<br />
|rowspan="2"| Play<br />
|rowspan="2"| Client<br />
| Channel<br />
| String<br />
| Name of the [[plugin channel]] used to send the data<br />
|-<br />
| Data<br />
| Byte Array<br />
| Any data, depending on the channel. <code><nowiki>MC|</nowiki></code> channels are documented [[plugin channel|here]].<br />
|}<br />
<br />
==== 断开连接 ====<br />
<br />
Sent by the server before it disconnects a client. The server assumes that the sender has already closed the connection by the time the packet arrives.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
| 0x40<br />
|rowspan="1"| Play<br />
|rowspan="1"| Client<br />
| Reason<br />
| [[Chat]]<br />
| Displayed to the client when the connection terminates.<br />
|}<br />
<br />
==== 服务器难度 ====<br />
<br />
Changes the difficulty setting in the client's option menu<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="1"| 0x41<br />
|rowspan="1"| Play<br />
|rowspan="1"| Client<br />
| Difficulty<br />
| Unsigned Byte<br />
| 0: peaceful, 1: easy, 2: normal, 3: hard<br />
|}<br />
<br />
==== 战斗事件 ====<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="6"| 0x42<br />
|rowspan="6"| Play<br />
|rowspan="6"| Client<br />
| Event<br />
| VarInt<br />
| 0: enter combat, 1: end combat, 2: entity dead<br />
|-<br />
| Duration<br />
| Optional VarInt<br />
| Only for end combat<br />
|-<br />
| Player ID<br />
| Optional VarInt<br />
| Only for entity dead<br />
|-<br />
| Entity ID<br />
| Optional Int<br />
| Only for end combat and entity dead<br />
|-<br />
| Message<br />
| String<br />
| Only for entity dead<br />
|}<br />
<br />
==== 摄像机 ====<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="1"| 0x43<br />
|rowspan="1"| Play<br />
|rowspan="1"| Client<br />
| Camera ID<br />
| VarInt<br />
| <br />
|}<br />
<br />
==== 世界边界 ==== <br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
!colspan="2"| Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="18"| 0x44<br />
|rowspan="18"| Play<br />
|rowspan="18"| Client<br />
|colspan="2"| Action<br />
| VarInt<br />
| Determines the format of the rest of the packet<br />
|-<br />
! Action<br />
! Field Name<br />
! <br />
! <br />
|-<br />
| 0: set size<br />
| Radius<br />
| Double<br />
| meters<br />
|-<br />
|rowspan="3"| 1: lerp size<br />
| Old Radius<br />
| Double<br />
| meters<br />
|-<br />
| New Radius<br />
| Double<br />
| meters<br />
|-<br />
| Speed<br />
| VarLong<br />
| number of real-time ticks/seconds (?) until New Radius is reached. From experiments, it appears that Notchian server does not sync world border speed to game ticks, so it gets out of sync with server lag<br />
|-<br />
|rowspan="2"| 2: set center<br />
| X<br />
| Double<br />
| <br />
|-<br />
| Z<br />
| Double<br />
| <br />
|-<br />
|rowspan="8"| 3: initialize<br />
| X<br />
| Double<br />
| <br />
|-<br />
| Z<br />
| Double<br />
| <br />
|-<br />
| Old Radius<br />
| Double<br />
| <br />
|-<br />
| New Radius<br />
| Double<br />
| <br />
|-<br />
| Speed<br />
| VarLong<br />
| <br />
|-<br />
| Portal Teleport Boundary<br />
| VarInt<br />
| Resulting coordinates from a portal teleport are limited to +-value. Usually 29999984.<br />
|-<br />
| Warning Time<br />
| VarInt<br />
| <br />
|-<br />
| Warning Blocks<br />
| VarInt<br />
| <br />
|-<br />
|rowspan="1"| 4: set warning time<br />
| Warning Time<br />
| VarInt<br />
| unit?<br />
|-<br />
|rowspan="1"| 5: set warning blocks<br />
| Warning Blocks<br />
| VarInt<br />
| <br />
|}<br />
<br />
==== 显示标题 ==== <br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
!colspan="2"| Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="9"| 0x45<br />
|rowspan="9"| Play<br />
|rowspan="9"| Client<br />
|colspan="2"| Action<br />
| VarInt<br />
| <br />
|-<br />
! Action<br />
! Field Name<br />
! <br />
! <br />
|-<br />
| 0: set title<br />
| Title Text<br />
| [[Chat]]<br />
| <br />
|-<br />
| 1: set subtitle<br />
| Subtitle Text<br />
| [[Chat]]<br />
| <br />
|-<br />
|rowspan="3"| 2: set times and display<br />
| Fade In<br />
| Int<br />
| ticks<br />
|-<br />
| Stay<br />
| Int<br />
| ticks<br />
|-<br />
| Fade Out<br />
| Int<br />
| ticks<br />
|-<br />
| 3: hide<br />
| ''no fields''<br />
| ''no fields''<br />
| <br />
|-<br />
| 4: reset<br />
| ''no fields''<br />
| ''no fields''<br />
| <br />
|}<br />
<br />
“Hide” makes the title disappear, but if you run times again the same title will appear. “Reset” erases the text.<br />
<br />
==== 设置压缩 ====<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="1"| 0x46<br />
|rowspan="1"| Play<br />
|rowspan="1"| Client<br />
| Threshold<br />
| VarInt<br />
| 这种大小或更高的包可以被压缩。<br />
|}<br />
<br />
==== 玩家列表页眉与页脚 ====<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="2"| 0x47<br />
|rowspan="2"| Play<br />
|rowspan="2"| Client<br />
| Header<br />
| [[Chat]]<br />
| <br />
|-<br />
| Footer<br />
| [[Chat]]<br />
| <br />
|}<br />
<br />
==== 发送资源包 ==== <br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="2"| 0x48<br />
|rowspan="2"| Play<br />
|rowspan="2"| Client<br />
| URL<br />
| String<br />
| 资源包的 URL 地址<br />
|-<br />
| Hash<br />
| String<br />
| 一个40个字符的十六进制和小写的[[wikipedia:SHA-1|SHA-1]]哈希的资源包文件。（必须小写）<br />如果不符合上一行的标准， 客户端将不会验证它哈希值及浪费不必要的带宽 — 但仍将把它作为唯一的标识符处理<br />
|}<br />
<br />
==== 更新实体 NBT ==== <br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="2"| 0x49<br />
|rowspan="2"| Play<br />
|rowspan="2"| Client<br />
| Entity ID<br />
| VarInt<br />
| <br />
|-<br />
| Tag<br />
| [[NBT|NBT Tag]]<br />
| <br />
|}<br />
<br />
=== 发送到服务器 ===<br />
<br />
==== 保持连接 ====<br />
<br />
服务器会经常发送一个保持连接包，内含一个随机的ID。客户端必须回应同样的包。<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="1"| 0x00<br />
|rowspan="1"| Play<br />
|rowspan="1"| Server<br />
| Keep Alive ID<br />
| VarInt<br />
| <br />
|}<br />
<br />
==== 聊天信息 ====<br />
<br />
默认服务端会检查信息是否以 '/' 开头。如果不是是，发送者的用户名将被放在消息前并且发送到所有其他客户端（包括原始的发送者）。如果是，服务端认为它是一个命令并尝试处理它。一个长度大于 100 的信息会导致服务端踢出该客户端。这个行为一开始是在不修改服务端的前提下不允许客户端不分段发送长度超过 119（以前的限制）的信息。因为这个原因，原始的服务端保留了在 119 处将消息切片的代码，但是这不是一个协议限制并且可以被跳过。<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="1"| 0x01<br />
|rowspan="1"| Play<br />
|rowspan="1"| Server<br />
| Message<br />
| String<br />
| The client sends the raw input, not [[Chat]]<br />
|}<br />
<br />
==== 使用实体 ====<br />
<br />
这个包在玩家攻击或者右键点击其他实体（一个玩家、矿车等）时从客户端发往服务器。<br />
<br />
一个官方服务端只在被攻击或使用的实体是可视的、在以玩家为中心 4单位 的范围内且与玩家之间没有阻碍时才接受这个包。<br />
<br />
注意：创造模式的中键点击会被客户端解析且被发送为 [[#Creative Inventory Action|创造背包动作]] 包。<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="5"| 0x02<br />
|rowspan="5"| Play<br />
|rowspan="5"| Server<br />
| Target<br />
| VarInt<br />
| <br />
|-<br />
| Type<br />
| VarInt<br />
| 0: interact, 1: attack, 2: interact at<br />
|-<br />
| Target X<br />
| Optional Float<br />
| 只有当类型为 interact at 时<br />
|-<br />
| Target Y<br />
| Optional Float<br />
| 只有当类型为 interact at 时<br />
|-<br />
| Target Z<br />
| Optional Float<br />
| 只有当类型为 interact at 时<br />
|}<br />
<br />
==== 玩家状态 ====<br />
<br />
这个包用于表明玩家正在陆地上（行走/游泳）还是在空中（跳跃/掉落）。<br />
<br />
当从足够高的高度掉落，这个状态从 false 设置为 true 时会受到掉落伤害。受到伤害的数值基于最后状态从 true 设置为 false。 注意有一些运动相关的包包含了这个包。<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="1"| 0x03<br />
|rowspan="1"| Play<br />
|rowspan="1"| Server<br />
| On Ground<br />
| Boolean<br />
| 当对象站在地上时为 true , 反之则为 false<br />
|}<br />
<br />
==== 玩家坐标 ====<br />
<br />
更新玩家在服务器上的 XYZ 坐标。<br />
<br />
如果在服务器上最后记录的位置和这个包设置的新位置之间的距离大于 100 单位，将会导致客户端因为 “You moved too quickly :( (Hacking?)” 而被踢出服务器。<br />
<br />
如果之间的距离大于 10 单位，服务器会在日志中写下警告信息 “<name> moved too quickly!” 和两个三元坐标（可能是运动增量？），但不会踢出客户端。<br />
<br />
如果 X 或 Z 的定点数被设置大于 3.2×10<sup>7</sup> 客户端会因为 “Illegal position” 而被踢出服务器。<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="4"| 0x04<br />
|rowspan="4"| Play<br />
|rowspan="4"| Server<br />
| X<br />
| Double<br />
| 绝对位置<br />
|-<br />
| Feet Y<br />
| Double<br />
| 绝对位置，史蒂夫头部一般在 Y - 1.62<br />
|-<br />
| Z<br />
| Double<br />
| 绝对位置<br />
|-<br />
| On Ground<br />
| Boolean<br />
| 当对象站在地上时为 true , 反之则为 false<br />
|}<br />
<br />
==== 玩家观察 ====<br />
[[File:Minecraft-trig-yaw.png|thumb|The unit circle for yaw]]<br />
[[File:Yaw.png|thumb|The unit circle of yaw, redrawn]]<br />
<br />
更新玩家目前所看的方向。<br />
<br />
偏航（Yaw）以度为单位，并且不遵循经典的三角规则。</div>
梦彗業
https://mineplugin.org/index.php?title=Protocol&diff=5414
Protocol
2017-09-02T14:34:11Z
<p>梦彗業：翻译</p>
<hr />
<div>{{待翻译}}<br />
{{待更新|url=http://wiki.vg/Protocol}}<br />
<br />
这里剖析了最近的 '''[http://wiki.vg/Protocol_Encryption Minecraft协议]'''.<br />
<br />
如果你有疑问, 请查阅下文或在IRC请求帮助 ([irc://irc.freenode.net/mcdevs #mcdevs on irc.freenode.net]).<br />
<br />
'''注意:''' 你可以不受限制地使用这个页面的内容来创建服务端, 客户端, 机器人…… 诸如此类的任何东西…<br />
<br />
== 定义 ==<br />
<br />
Minecraft服务器是基于TCP通讯的。它和客户端使用所谓的 ''数据包''交流. 一个包被通过字节编码后从TCP连接中发送. 数据包的含义取决于其包标识和连接的当前状态. 每个链接从 '''[http://wiki.vg/Handshaking 握手]'''开始, 使用包切换状态 '''[http://wiki.vg/Handshaking 握手]''',( 0x00, serverbound) 和 [[#Login Success|成功登陆]] ([[#Login|登陆]], 0x02, clientbound).<br />
<br />
=== 数据类型 ===<br />
<br />
<!-- Transcluded contents of Data Types article in here - go to that page if you want to edit it --><br />
<br />
{{:Data Types}}<br />
<br />
=== 其他定义 ===<br />
<br />
{| class="wikitable"<br />
|-<br />
! 术语<br />
! 定义<br />
|-<br />
| Player——玩家<br />
| 使用时, 玩家通常使用它来链接到服务端.<br />
|-<br />
| Entity——实体<br />
| 实体相当于玩家、物品、怪物、船和矿车等. 查看 {{Minecraft Wiki|Entity|the Minecraft Wiki article}} 来寻找一个完整的表单.<br />
|-<br />
| EID——实体ID<br />
| An EID — 或者说是实体ID — 是一个用来识别特定实体的4字节序列. 在同一个服务器,没有相同的实体编号.<br />
|-<br />
| XYZ坐标<br />
| 游戏时，可以使用按钮“F3”来在屏幕上查看坐标位置 Y代表高度, X代表东西, Z代表南北.<br />
|-<br />
| 单位“Meter”<br />
| Meter是Minecraft的基本长度单位, 相当于一个方块的长度. “block”一词也许意味着 “meter”或者“cubic meter”.<br />
|}<br />
<br />
== 数据包的格式 ==<br />
<br />
=== 无压缩 ===<br />
<br />
{| class="wikitable"<br />
! 域名称<br />
! 域类型<br />
! 注释<br />
|-<br />
| 长度<br />
| VarInt<br />
| 包数据的长度 + 包序号的长度<br />
|-<br />
| 包序号<br />
| VarInt<br />
| <br />
|-<br />
| 数据<br />
| Byte Array<br />
| 依赖于连接状态和包序号，详见下面的部分。<br />
|}<br />
<br />
=== 压缩 ===<br />
<br />
当一个 [[#Set Compression|设置压缩]] 包被发送，[[wikipedia:Zlib|zlib]] 压缩将会对之后的所有包开启。 包的格式略微改变以包含未压缩前的包的长度。<br />
''译注：注意区分包长度和数据长度，关系：“包”包含“数据”''<br />
{| class=wikitable<br />
! 是否压缩<br />
! 域名称<br />
! 域类型<br />
! 注释<br />
|-<br />
| 否<br />
| 包长度<br />
| VarInt<br />
| 数据长度的长度 + 压缩后的 (包序号 + 数据) 的长度<br />
|-<br />
| 否<br />
| 数据长度<br />
| VarInt<br />
| 未压缩前的 (包序号 + 数据) 的长度 或 0<br />
|-<br />
|rowspan="2"| 是<br />
| 包序号<br />
| Varint<br />
| zlib 压缩后的包序号（详见下面的部分）<br />
|-<br />
| 数据<br />
| Byte Array<br />
| zlib 压缩后的包数据（详见下面的部分）<br />
|}<br />
<br />
包长度域提供的是包中存在的字节的数量，包括数据长度域。<br />
<br />
如果数据长度被设置为 0，则这个包没有被压缩；否则它表示已压缩的包未压缩前的包长度。<br />
<br />
如果包被压缩，压缩前的 (包序号 + 数据) 的长度必须等于或大于 [[#Set Compression|设置压缩]] 包中设置的最小值，否则客户端/服务端将会断开连接。<br />
<br />
压缩能通过发送一个最小值设定为 -1 的 [[#Set Compression|设置压缩]] 包来关闭。<br />
<br />
== 握手协议 ==<br />
<br />
=== 客户端绑定 ===<br />
<br />
因为协议在客户端发送第一个数据包后会立刻切换到另一个阶段，所以握手阶段没有客户端绑定的数据包。<br />
<br />
=== 服务端绑定 ===<br />
<br />
==== 握手协议 ====<br />
<br />
这将使得服务器切换至目标阶段。<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="4"| 0x00<br />
|rowspan="4"| Handshaking<br />
|rowspan="4"| Server<br />
| 协议版本<br />
| VarInt<br />
| See [[protocol version numbers]] (currently 47)<br />
|-<br />
| 服务器地址<br />
| String<br />
| 域名或是IP, 例如： localhost 或是 127.0.0.1<!-- does this support IPv6? --><br />
|- <br />
| 服务器端口<br />
| Unsigned Short<br />
| 默认值为25565<br />
|-<br />
| 下一阶段<br />
| VarInt<br />
| 1 for [[#Status|status]], 2 for [[#Login|login]]<br />
|}<br />
<br />
==== 传统的服务器列表Ping ====<br />
<br />
严格来说这不是当前协议的一部分，传统客户端可能会发送这一数据包来发起（initiate） [[Server List Ping]], 现代服务器也应当能够适当地处理这一数据包。<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
| 0xFE<br />
| Handshaking<br />
| Server<br />
| Payload<br />
| Unsigned Byte<br />
| always 1 (<code>0x01</code>)<br />
|}<br />
<br />
See [[Server List Ping#1.6]] for the details of the protocol that follows this packet.<br />
<br />
== 开始游戏 ==<br />
<br />
=== 发送到客户端 ===<br />
<br />
==== 心跳包 ====<br />
<br />
The server will frequently send out a keep-alive, each containing a random ID. The client must respond with the same packet. If the client does not respond to them for over 30 seconds, the server kicks the client. Vice versa, if the server does not send any keep-alives for 20 seconds, the client will disconnect and yields a "Timed out" exception.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="1"| 0x00<br />
|rowspan="1"| Play<br />
|rowspan="1"| Client<br />
| Keep Alive ID<br />
| VarInt<br />
| <br />
|}<br />
<br />
==== 加入游戏 ====<br />
<br />
See [[Protocol Encryption]] for information on logging in.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="7"| 0x01<br />
|rowspan="7"| Play<br />
|rowspan="7"| Client<br />
| Entity ID<br />
| Int<br />
| The player's Entity ID (EID)<br />
|-<br />
| Gamemode<br />
| Unsigned Byte<br />
| 0: Survival, 1: Creative, 2: Adventure, 3: Spectator. Bit 3 (0x8) is the hardcore flag.<br />
|-<br />
| Dimension<br />
| Byte<br />
| -1: Nether, 0: Overworld, 1: End<br />
|-<br />
| Difficulty<br />
| Unsigned Byte<br />
| 0: peaceful, 1: easy, 2: normal, 3: hard<br />
|-<br />
| Max Players<br />
| Unsigned Byte<br />
| Used by the client to draw the player list<br />
|-<br />
| Level Type<br />
| String<br />
| default, flat, largeBiomes, amplified, default_1_1<br />
|-<br />
| Reduced Debug Info<br />
| Boolean<br />
| If true, a Notchian client shows reduced information on the {{Minecraft Wiki|debug screen}}.<br />
|}<br />
<br />
{{Warning|如果位置无效，服务端将崩溃}}<br />
<br />
==== 聊天内容 ==== <br />
<br />
Identifying the difference between Chat/System Message is important as it helps respect the user's chat visibility options. While Position 2 accepts json formatting it will not display, old style formatting works<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="2"| 0x02<br />
|rowspan="2"| Play<br />
|rowspan="2"| Client<br />
| JSON Data<br />
| [[Chat]]<br />
| Limited to 32767 bytes<br />
|-<br />
| Position<br />
| Byte<br />
| 0: chat (chat box), 1: system message (chat box), 2: above action bar<br />
|}<br />
<br />
{{Warning|错误的JSON将断开连接}}<br />
<br />
==== 时间更新 ====<br />
<br />
Time is based on ticks, where 20 ticks happen every second. There are 24000 ticks in a day, making Minecraft days exactly 20 minutes long.<br />
<br />
The time of day is based on the timestamp modulo 24000. 0 is sunrise, 6000 is noon, 12000 is sunset, and 18000 is midnight.<br />
<br />
The default SMP server increments the time by <code>20</code> every second.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="2"| 0x03<br />
|rowspan="2"| Play<br />
|rowspan="2"| Client<br />
| World Age<br />
| Long<br />
| In ticks; not changed by server commands<br />
|-<br />
| Time of day<br />
| Long<br />
| The world (or region) time, in ticks. If negative the sun will stop moving at the Math.abs of the time<br />
|}<br />
<br />
==== 持有的物品 ====<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="3"| 0x04<br />
|rowspan="3"| Play<br />
|rowspan="3"| Client<br />
| Entity ID<br />
| VarInt<br />
| Entity's EID<br />
|-<br />
| Slot<br />
| Short<br />
| Equipment slot. 0: held, 1–4: armor slot (1: boots, 2: leggings, 3: chestplate, 4: helmet)<br />
|-<br />
| Item<br />
| [[Slot Data|Slot]]<br />
| Item in slot format<br />
|}<br />
<br />
==== 出生姿势 ====<br />
<br />
Sent by the server after login to specify the coordinates of the spawn point (the point at which players spawn at, and which the compass points to). It can be sent at any time to update the point compasses point at.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="1"| 0x05<br />
|rowspan="1"| Play<br />
|rowspan="1"| Client<br />
| Location<br />
| Position<br />
| Spawn location<br />
|}<br />
<br />
==== 更新生命值 ====<br />
<br />
Sent by the server to update/set the health of the player it is sent to.<br />
<br />
Food {{Minecraft Wiki|Food#Hunger vs. Saturation|saturation}} acts as a food “overcharge”. Food values will not decrease while the saturation is over zero. Players logging in automatically get a saturation of 5.0. Eating food increases the saturation as well as the food bar.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="3"| 0x06<br />
|rowspan="3"| Play<br />
|rowspan="3"| Client<br />
| Health<br />
| Float<br />
| 0 or less = dead, 20 = full HP<br />
|-<br />
| Food<br />
| VarInt<br />
| 0–20<br />
|- <br />
| Food Saturation<br />
| Float<br />
| Seems to vary from 0.0 to 5.0 in integer increments<br />
|}<br />
<br />
==== 重生 ====<br />
<br />
来改变玩家的位置(主世界/地狱/末地), 发送给他们一个重生指令, 其次是prechunks或chunks的新位置, and finally a position and look packet. You do not need to unload chunks, the client will do it automatically.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="4"| 0x07<br />
|rowspan="4"| Play<br />
|rowspan="4"| Client<br />
| Dimension<br />
| Int<br />
| -1: The Nether, 0: The Overworld, 1: The End<br />
|-<br />
| Difficulty<br />
| Unsigned Byte<br />
| 0: Peaceful, 1: Easy, 2: Normal, 3: Hard<br />
|-<br />
| Gamemode<br />
| Unsigned Byte<br />
| 0: survival, 1: creative, 2: adventure. The hardcore flag is not included<br />
|-<br />
| Level Type<br />
| String<br />
| Same as [[#Join Game|Join Game]]<br />
|}<br />
<br />
{{Warning|如果位置无效，服务端将崩溃 }}<br />
<br />
{{Warning|如果玩家出现在了相同的位置, weird bugs can occur i.e. such player will be unable to attack other players in new world (修复后他们将重生)}}<br />
<br />
==== 玩家姿势以及看的方向 ==== <br />
<br />
Updates the player's position on the server.<br />
<br />
If the distance between the last known position of the player on the server and the new position set by this packet is greater than 100 meters, the client will be kicked for “You moved too quickly :( (Hacking?)”.<br />
<br />
Also if the fixed-point number of X or Z is set greater than <code>3.2E7D</code> the client will be kicked for “Illegal position”.<br />
<br />
Yaw is measured in degrees, and does not follow classical trigonometry rules. The unit circle of yaw on the XZ-plane starts at (0, 1) and turns counterclockwise, with 90 at (-1, 0), 180 at (0, -1) and 270 at (1, 0). Additionally, yaw is not clamped to between 0 and 360 degrees; any number is valid, including negative numbers and numbers greater than 360.<br />
<br />
Pitch is measured in degrees, where 0 is looking straight ahead, -90 is looking straight up, and 90 is looking straight down.<br />
<br />
The yaw in degrees of a player standing at point (x0, z0) and looking towards point (x, z) can be calculated with:<br />
<br />
l = x-x0<br />
w = z-z0<br />
c = sqrt( l*l + w*w )<br />
alpha1 = -arcsin(l/c)/PI*180<br />
alpha2 = arccos(w/c)/PI*180<br />
if alpha2 > 90 then<br />
yaw = 180 - alpha1<br />
else<br />
yaw = alpha1<br />
<br />
You can get a unit vector from a given yaw/pitch via:<br />
<br />
x = -cos(pitch) * sin(yaw)<br />
y = -sin(pitch)<br />
z = cos(pitch) * cos(yaw)<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="6"| 0x08<br />
|rowspan="6"| Play<br />
|rowspan="6"| Client<br />
| X<br />
| Double<br />
| Absolute or relative position, depending on Flags<br />
|-<br />
| Y<br />
| Double<br />
| Absolute or relative position, depending on Flags<br />
|-<br />
| Z<br />
| Double<br />
| Absolute or relative position, depending on Flags<br />
|-<br />
| Yaw<br />
| Float<br />
| Absolute or relative rotation on the X Axis, in degrees<br />
|-<br />
| Pitch<br />
| Float<br />
| Absolute or relative rotation on the Y Axis, in degrees<br />
|-<br />
| Flags<br />
| Byte<br />
| Bit field, see below<br />
|}<br />
<br />
About the Flags field:<br />
<br />
<Dinnerbone> It's a bitfield, X/Y/Z/Y_ROT/X_ROT. If X is set, the x value is relative and not absolute.<br />
<br />
{| class="wikitable"<br />
|-<br />
! Field<br />
! Bit<br />
|-<br />
| X<br />
| 0x01<br />
|-<br />
| Y<br />
| 0x02<br />
|-<br />
| Z<br />
| 0x04<br />
|-<br />
| Y_ROT<br />
| 0x08<br />
|-<br />
| X_ROT<br />
| 0x10<br />
|}<br />
<br />
==== 持有物品变更 ====<br />
<br />
Sent to change the player's slot selection.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="1"| 0x09<br />
|rowspan="1"| Play<br />
|rowspan="1"| Client<br />
| Slot<br />
| Byte<br />
| The slot which the player has selected (0–8)<br />
|}<br />
<br />
==== 使用床 ==== <br />
<br />
This packet tells that a player goes to bed.<br />
<br />
The client with the matching Entity ID will go into bed mode.<br />
<br />
This Packet is sent to all nearby players including the one sent to bed.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="2"| 0x0A<br />
|rowspan="2"| Play<br />
|rowspan="2"| Client<br />
| Entity ID<br />
| VarInt<br />
| Sleeping player's EID<br />
|-<br />
| Location<br />
| Position<br />
| Block location of the head part of the bed<br />
|}<br />
<br />
==== 动画 ====<br />
<br />
Sent whenever an entity should change animation.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="2"| 0x0B<br />
|rowspan="2"| Play<br />
|rowspan="2"| Client<br />
| Entity ID<br />
| VarInt<br />
| Player ID<br />
|-<br />
| Animation<br />
| Unsigned Byte<br />
| Animation ID (see below)<br />
|}<br />
<br />
Animation can be one of the following values:<br />
<br />
{| class="wikitable"<br />
! ID<br />
! Animation<br />
|-<br />
| 0<br />
| Swing arm<br />
|-<br />
| 1<br />
| Take damage<br />
|-<br />
| 2<br />
| Leave bed<br />
|-<br />
| 3<br />
| Eat food<br />
|-<br />
| 4<br />
| Critical effect<br />
|-<br />
| 5<br />
| Magic critical effect<br />
|}<br />
<br />
==== 生成玩家 ====<br />
<br />
This packet is sent by the server when a player comes into visible range, ''not'' when a player joins.<br />
<br />
This packet must be sent after the [[#Player List Item|Player List Item]] ([[#Play|Play]], 0x38, clientbound) packet that adds the player data for the client to use when spawning a player. If the tab list entry for the UUID included in this packet is not present when this packet arrives, the entity will not be spawned. The tab includes skin/cape data.<br />
<br />
Servers can, however, safely spawn player entities for players not in visible range. The client appears to handle it correctly.<br />
<br />
When in online-mode the UUIDs must be valid and have valid skin blobs, in offline-mode UUID v3 is used.<br />
<br />
For NPCs UUID v2 should be used. Note:<br />
<br />
<+Grum> i will never confirm this as a feature you know that :)<br />
<br />
In an example UUID, <code>xxxxxxxx-xxxx-Yxxx-xxxx-xxxxxxxxxxxx</code>, the UUID version is specified by <code>Y</code>. So, for UUID v3, <code>Y</code> will always be <code>3</code>, and for UUID v2, <code>Y</code> will always be <code>2</code>.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="9"| 0x0C<br />
|rowspan="9"| Play<br />
|rowspan="9"| Client<br />
| Entity ID<br />
| VarInt<br />
| Player's EID<br />
|-<br />
| Player UUID<br />
| UUID<br />
| <br />
|-<br />
| X<br />
| Int<br />
| Player X as a [[Data Types#Fixed-point numbers|Fixed-Point number]]<br />
|-<br />
| Y<br />
| Int<br />
| Player Y as a [[Data Types#Fixed-point numbers|Fixed-Point number]]<br />
|-<br />
| Z<br />
| Int<br />
| Player Z as a [[Data Types#Fixed-point numbers|Fixed-Point number]]<br />
|-<br />
| Yaw<br />
| Angle<br />
| <br />
|-<br />
| Pitch<br />
| Angle<br />
| <br />
|-<br />
| Current Item<br />
| Short<br />
| The item the player is currently holding. Note that this should be 0 for “no item”, unlike -1 used in other packets.<br />
|-<br />
| Metadata<br />
| [[Entities#Entity Metadata Format|Metadata]]<br />
| <br />
|}<br />
<br />
{{Warning|A negative Current Item crashes clients}}<br />
<br />
{{Warning|The client will crash if no Metadata is sent}}<br />
<br />
==== 拾起物品 ====<br />
<br />
Sent by the server when someone picks up an item lying on the ground — its sole purpose appears to be the animation of the item flying towards you. It doesn't destroy the entity in the client memory, and it doesn't add it to your inventory. The server only checks for items to be picked up after each [[#Player Position|Player Position]] (and [[#Player Position And Look|Player Position And Look]]) packet sent by the client.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="2"| 0x0D<br />
|rowspan="2"| Play<br />
|rowspan="2"| Client<br />
| Collected Entity ID<br />
| VarInt<br />
| <br />
|- <br />
| Collector Entity ID<br />
| VarInt<br />
| <br />
|}<br />
<br />
==== 生成对象 ====<br />
<br />
Sent by the server when an Object/Vehicle is created.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="8"| 0x0E<br />
|rowspan="8"| Play<br />
|rowspan="8"| Client<br />
| Entity ID <br />
| VarInt<br />
| EID of the object<br />
|-<br />
| Type<br />
| Byte<br />
| The type of object (See [[Entities#Objects|Objects]])<br />
|-<br />
| X<br />
| Int<br />
| X position as a [[Data Types#Fixed-point numbers|Fixed-Point number]]<br />
|-<br />
| Y<br />
| Int<br />
| Y position as a [[Data Types#Fixed-point numbers|Fixed-Point number]]<br />
|-<br />
| Z<br />
| Int<br />
| Z position as a [[Data Types#Fixed-point numbers|Fixed-Point number]]<br />
|-<br />
| Pitch<br />
| Angle<br />
| <br />
|-<br />
| Yaw<br />
| Angle<br />
| <br />
|-<br />
| Data<br />
| [[Object Data]]<br />
| <br />
|}<br />
<br />
==== 生成怪物 ====<br />
<br />
Sent by the server when a Mob Entity is Spawned<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="12"| 0x0F<br />
|rowspan="12"| Play<br />
|rowspan="12"| Client<br />
| Entity ID<br />
| VarInt<br />
| <br />
|-<br />
| Type<br />
| Unsigned Byte<br />
| The type of mob. See [[Entities#Mobs|Mobs]]<br />
|-<br />
| X<br />
| Int<br />
| X position as a [[Data Types#Fixed-point numbers|Fixed-Point number]] <br />
|-<br />
| Y<br />
| Int<br />
| Y position as a [[Data Types#Fixed-point numbers|Fixed-Point number]] <br />
|-<br />
| Z<br />
| Int<br />
| Z position as a [[Data Types#Fixed-point numbers|Fixed-Point number]] <br />
|-<br />
| Yaw<br />
| Angle<br />
| <br />
|-<br />
| Pitch<br />
| Angle<br />
| <br />
|-<br />
| Head Pitch<br />
| Angle<br />
| <br />
|-<br />
| Velocity X<br />
| Short<br />
| Same units as [[#Entity Velocity|Entity Velocity]]<br />
|-<br />
| Velocity Y<br />
| Short<br />
| Same units as [[#Entity Velocity|Entity Velocity]]<br />
|-<br />
| Velocity Z<br />
| Short<br />
| Same units as [[#Entity Velocity|Entity Velocity]]<br />
|-<br />
| Metadata<br />
| [[Entities#Entity Metadata Format|Metadata]]<br />
| <br />
|}<br />
<br />
==== 重生绘图 ====<br />
<br />
This packet shows location, name, and type of painting.<br />
<br />
Calculating the center of an image: given a (width x height) grid of cells, with (0, 0) being the top left corner, the center is (max(0, width / 2 - 1), height / 2). E.g.<br />
<br />
2x1 (1, 0)<br />
4x4 (1, 2)<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="4"| 0x10<br />
|rowspan="4"| Play<br />
|rowspan="4"| Client<br />
| Entity ID<br />
| VarInt<br />
| <br />
|-<br />
| Title<br />
| String<br />
| Name of the painting. Max length 13<br />
|-<br />
| Location<br />
| Position<br />
| Center coordinates<br />
|-<br />
| Direction<br />
| Unsigned Byte<br />
| Direction the painting faces. 0: north (-z), 1: west (-x), 2: south (+z), 3: east (+x)<br />
|}<br />
<br />
==== 重生掉落经验 ====<br />
<br />
Spawns one or more experience orbs.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="5"| 0x11<br />
|rowspan="5"| Play<br />
|rowspan="5"| Client<br />
| Entity ID<br />
| VarInt<br />
| Entity's ID<br />
|-<br />
| X<br />
| Int<br />
| X position as a [[Data Types#Fixed-point numbers|Fixed-Point number]]<br />
|-<br />
| Y<br />
| Int<br />
| Y position as a [[Data Types#Fixed-point numbers|Fixed-Point number]]<br />
|-<br />
| Z<br />
| Int<br />
| Z position as a [[Data Types#Fixed-point numbers|Fixed-Point number]]<br />
|-<br />
| Count<br />
| Short<br />
| The amount of experience this orb will reward once collected<br />
|}<br />
<br />
==== 实体速率 ====<br />
<br />
Velocity is believed to be in units of 1/8000 of a block per server tick (50ms); for example, -1343 would move (-1343 / 8000) = −0.167875 blocks per tick (or −3,3575 blocks per second).<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="4"| 0x12<br />
|rowspan="4"| Play<br />
|rowspan="4"| Client<br />
| Entity ID<br />
| VarInt<br />
| <br />
|-<br />
| Velocity X<br />
| Short<br />
| Velocity on the X axis<br />
|-<br />
| Velocity Y<br />
| Short<br />
| Velocity on the Y axis<br />
|-<br />
| Velocity Z<br />
| Short<br />
| Velocity on the Z axis<br />
|}<br />
<br />
==== 销毁实体 ====<br />
<br />
Sent by the server when a list of entities is to be destroyed on the client.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="2"| 0x13<br />
|rowspan="2"| Play<br />
|rowspan="2"| Client<br />
| Count<br />
| VarInt<br />
| Number of elements in the following array<br />
|-<br />
| Entity IDs<br />
| Array of VarInt<br />
| The list of entities of destroy<br />
|}<br />
<br />
==== 实体 ====<br />
<br />
This packet may be used to initialize an entity.<br />
<br />
For player entities, either this packet or any move/look packet is sent every game tick. So the meaning of this packet is basically that the entity did not move/look since the last such packet.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="1"| 0x14<br />
|rowspan="1"| Play<br />
|rowspan="1"| Client<br />
| Entity ID<br />
| VarInt<br />
| <br />
|}<br />
<br />
==== 实体相对移动 ====<br />
<br />
This packet is sent by the server when an entity moves less then 4 blocks; if an entity moves more than 4 blocks [[#Entity Teleport|Entity Teleport]] should be sent instead.<br />
<br />
This packet allows at most four blocks movement in any direction, because byte range is from -128 to 127.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="5"| 0x15<br />
|rowspan="5"| Play<br />
|rowspan="5"| Client<br />
| Entity ID<br />
| VarInt<br />
| <br />
|-<br />
| Delta X<br />
| Byte<br />
| Change in X position as a [[Data Types#Fixed-point numbers|Fixed-Point number]]<br />
|-<br />
| Delta Y<br />
| Byte<br />
| Change in Y position as a [[Data Types#Fixed-point numbers|Fixed-Point number]]<br />
|-<br />
| Delta Z<br />
| Byte<br />
| Change in Z position as a [[Data Types#Fixed-point numbers|Fixed-Point number]]<br />
|-<br />
| On Ground<br />
| Boolean<br />
| <br />
|}<br />
<br />
==== 实体朝向 ====<br />
<br />
This packet is sent by the server when an entity rotates.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="5"| 0x16<br />
|rowspan="5"| Play<br />
|rowspan="5"| Client<br />
| Entity ID<br />
| VarInt<br />
| <br />
|-<br />
| Yaw<br />
| Angle<br />
| New angle, not a delta<br />
|-<br />
| Pitch<br />
| Angle<br />
| New angle, not a delta<br />
|-<br />
| On Ground<br />
| Boolean<br />
| <br />
|}<br />
<br />
==== 实体朝向与相对移动 ====<br />
<br />
This packet is sent by the server when an entity rotates and moves. Since a byte range is limited from -128 to 127, and movement is offset of fixed-point numbers, this packet allows at most four blocks movement in any direction. (-128/32 == -4)<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="7"| 0x17<br />
|rowspan="7"| Play<br />
|rowspan="7"| Client<br />
| Entity ID<br />
| VarInt<br />
| <br />
|-<br />
| Delta X<br />
| Byte<br />
| Change in X position as a [[Data Types#Fixed-point numbers|Fixed-Point number]]<br />
|-<br />
| Delta Y<br />
| Byte<br />
| Change in Y position as a [[Data Types#Fixed-point numbers|Fixed-Point number]]<br />
|-<br />
| Delta Z<br />
| Byte<br />
| Change in Z position as a [[Data Types#Fixed-point numbers|Fixed-Point number]]<br />
|-<br />
| Yaw<br />
| Angle<br />
| New angle, not a delta<br />
|-<br />
| Pitch<br />
| Angle<br />
| New angle, not a delta<br />
|-<br />
| On Ground<br />
| Boolean<br />
| <br />
|}<br />
<br />
==== 实体传送 ====<br />
<br />
This packet is sent by the server when an entity moves more than 4 blocks.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="7"| 0x18<br />
|rowspan="7"| Play<br />
|rowspan="7"| Client<br />
| Entity ID<br />
| VarInt<br />
| <br />
|-<br />
| X<br />
| Int<br />
| X position as a [[Data Types#Fixed-point numbers|Fixed-Point number]]<br />
|-<br />
| Y<br />
| Int<br />
| Y position as a [[Data Types#Fixed-point numbers|Fixed-Point number]]<br />
|-<br />
| Z<br />
| Int<br />
| Z position as a [[Data Types#Fixed-point numbers|Fixed-Point number]]<br />
|-<br />
| Yaw<br />
| Angle<br />
| New angle, not a delta<br />
|-<br />
| Pitch<br />
| Angle<br />
| New angle, not a delta<br />
|-<br />
| On Ground<br />
| Boolean<br />
| <br />
|}<br />
<br />
==== 实体手朝向 ====<br />
<br />
Changes the direction an entity's head is facing.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="2"| 0x19<br />
|rowspan="2"| Play<br />
|rowspan="2"| Client<br />
| Entity ID<br />
| VarInt<br />
| <br />
|-<br />
| Head Yaw<br />
| Angle<br />
| New angle, not a delta<br />
|}<br />
<br />
==== 实体状态 ====<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="2"| 0x1A<br />
|rowspan="2"| Play<br />
|rowspan="2"| Client<br />
| Entity ID<br />
| Int<br />
| <br />
|-<br />
| Entity Status<br />
| Byte<br />
| See below<br />
|}<br />
<br />
{| class="wikitable"<br />
|-<br />
! Entity Status<br />
! Meaning<br />
|-<br />
| 1<br />
| Sent when resetting a mob spawn minecart's timer - appears to be unused by the client<br />
|-<br />
| 2<br />
| Living Entity hurt <br />
|-<br />
| 3<br />
| Living Entity dead<br />
|-<br />
| 4<br />
| Iron Golem throwing up arms<br />
|-<br />
| 6<br />
| Wolf/Ocelot/Horse taming — Spawn “heart” particles<br />
|-<br />
| 7<br />
| Wolf/Ocelot/Horse tamed — Spawn “smoke” particles<br />
|-<br />
| 8<br />
| Wolf shaking water — Trigger the shaking animation<br />
|-<br />
| 9<br />
| (of self) Eating accepted by server<br />
|-<br />
| 10<br />
| Sheep eating grass<br />
|-<br />
| 10<br />
| Play TNT ignite sound<br />
|-<br />
| 11<br />
| Iron Golem handing over a rose<br />
|-<br />
| 12<br />
| Villager mating — Spawn “heart” particles<br />
|-<br />
| 13<br />
| Spawn particles indicating that a villager is angry and seeking revenge<br />
|-<br />
| 14<br />
| Spawn happy particles near a villager<br />
|-<br />
| 15<br />
| Witch animation — Spawn “magic” particles<br />
|-<br />
| 16<br />
| Play zombie converting into a villager sound<br />
|-<br />
| 17<br />
| Firework exploding<br />
|-<br />
| 18<br />
| Animal in love (ready to mate) — Spawn “heart” particles<br />
|-<br />
| 19<br />
| Reset squid rotation<br />
|-<br />
| 20<br />
| Spawn explosion particle — works for some living entities<br />
|-<br />
| 21<br />
| Play guardian sound — works for every entity<br />
|-<br />
| 22<br />
| Enables reduced debug for players<br />
|-<br />
| 23<br />
| Disables reduced debug for players<br />
|}<br />
<br />
==== 附加实体 ====<br />
<br />
This packet is sent when a player has been attached to an entity (e.g. Minecart).<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="3"| 0x1B<br />
|rowspan="3"| Play<br />
|rowspan="3"| Client<br />
| Entity ID<br />
| Int<br />
| Attached entity's EID. Set to -1 to detach.<br />
|-<br />
| Vehicle ID<br />
| Int<br />
| Vechicle's Entity ID<br />
|-<br />
| Leash<br />
| Boolean<br />
| If true leashes the entity to the vehicle<br />
|}<br />
<br />
==== 实体数据值 ====<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="2"| 0x1C<br />
|rowspan="2"| Play<br />
|rowspan="2"| Client<br />
| Entity ID<br />
| VarInt<br />
| <br />
|-<br />
| Metadata<br />
| [[Entities#Entity Metadata Format|Metadata]]<br />
| <br />
|}<br />
<br />
==== 实体属性 ====<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="5"| 0x1D<br />
|rowspan="5"| Play<br />
|rowspan="5"| Client<br />
| Entity ID<br />
| VarInt<br />
| <br />
|-<br />
| Effect ID<br />
| Byte<br />
| See {{Minecraft Wiki|Status effect#List of effects|this table}}<br />
|-<br />
| Amplifier<br />
| Byte<br />
| Notchian client displays effect level as Amplifier + 1<br />
|-<br />
| Duration<br />
| VarInt<br />
| Seconds<br />
|-<br />
| Hide Particles<br />
| Boolean<br />
| <br />
|}<br />
<br />
==== 移除实体属性 ====<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="2"| 0x1E<br />
|rowspan="2"| Play<br />
|rowspan="2"| Client<br />
| Entity ID<br />
| VarInt<br />
| <br />
|-<br />
| Effect ID<br />
| Byte<br />
| See {{Minecraft Wiki|Status effect#List of effects|this table}}<br />
|}<br />
<br />
==== 设置经验值 ====<br />
<br />
Sent by the server when the client should change experience levels.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="3"| 0x1F<br />
|rowspan="3"| Play<br />
|rowspan="3"| Client<br />
| Experience bar<br />
| Float<br />
| Between 0 and 1<br />
|-<br />
| Level<br />
| VarInt<br />
| <br />
|-<br />
| Total Experience<br />
| VarInt<br />
| See {{Minecraft Wiki|Experience#Leveling up}} on the Minecraft Wiki for Total Experience to Level conversion<br />
|}<br />
<br />
==== 实体配置 ====<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
!colspan="2"| Field Name<br />
!colspan="2"| Field Type<br />
! Notes<br />
|-<br />
|rowspan="6"| 0x20<br />
|rowspan="6"| Play<br />
|rowspan="6"| Client<br />
|colspan="2"| Entity ID<br />
|colspan="2"| VarInt<br />
| <br />
|-<br />
|colspan="2"| Number Of Properties<br />
|colspan="2"| Int<br />
| Number of elements in the following array<br />
|-<br />
|rowspan="4"| Property<br />
| Key<br />
|rowspan="4"| Array<br />
| String<br />
| See below<br />
|-<br />
| Value<br />
| Double<br />
| See below<br />
|-<br />
| Number Of Modifiers<br />
| VarInt<br />
| Number of elements in the following array<br />
|-<br />
| Modifiers<br />
| Array of Modifier Data<br />
| See {{Minecraft Wiki|Attribute#Modifiers}}<br />
|}<br />
<br />
Known Key values:<br />
<br />
{| class="wikitable"<br />
|-<br />
! Key<br />
! Default<br />
! Min<br />
! Max<br />
! Label<br />
|-<br />
| generic.maxHealth<br />
| 20.0<br />
| 0.0<br />
| Double.MaxValue<br />
| Max Health<br />
|-<br />
| generic.followRange<br />
| 32.0<br />
| 0.0<br />
| 2048.0<br />
| Follow Range<br />
|-<br />
| generic.knockbackResistance<br />
| 0.0 <br />
| 0.0<br />
| 1.0<br />
| Knockback Resistance<br />
|-<br />
| generic.movementSpeed<br />
| 0.699999988079071<br />
| 0.0<br />
| Double.MaxValue<br />
| Movement Speed<br />
|-<br />
| generic.attackDamage<br />
| 2.0<br />
| 0.0<br />
| Double.MaxValue<br />
| <br />
|-<br />
| horse.jumpStrength<br />
| 0.7<br />
| 0.0<br />
| 2.0<br />
| Jump Strength<br />
|-<br />
| zombie.spawnReinforcements<br />
| 0.0<br />
| 0.0<br />
| 1.0<br />
| Spawn Reinforcements Chance<br />
|}<br />
<br />
''Modifier Data'' structure:<br />
<br />
{| class="wikitable"<br />
|-<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
| UUID<br />
| UUID<br />
| <br />
|-<br />
| Amount<br />
| Double<br />
| <br />
|-<br />
| Operation<br />
| Byte<br />
| <br />
|}<br />
<br />
==== 区块数据 ====<br />
<br />
Chunks are not unloaded by the client automatically. To unload chunks, send this packet with Ground-Up Continuous=true and no 16^3 chunks (eg. Primary Bit Mask=0). The server does not send skylight information for nether-chunks, it's up to the client to know if the player is currently in the nether. You can also infer this information from the primary bitmask and the amount of uncompressed bytes sent.<br />
<br />
See also: [[SMP Map Format]]<br />
<br />
Changes in 1.8:<br />
<br />
* Data value section removed<br />
* Extended id section removed<br />
* Block id section is now a unsigned short (little endian) per a block<br />
* The block id is equal to <code>(id << 4) | data</code><br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="6"| 0x21<br />
|rowspan="6"| Play<br />
|rowspan="6"| Client<br />
| Chunk X<br />
| Int<br />
| Chunk X coordinate<br />
|-<br />
| Chunk Z<br />
| Int<br />
| Chunk Z coordinate<br />
|-<br />
| Ground-Up Continuous<br />
| Boolean<br />
| This is true if the packet represents all sections in this vertical column, where the Primary Bit Mask specifies exactly which sections are included, and which are air<br />
|-<br />
| Primary Bit Mask<br />
| Unsigned Short<br />
| Bitmask with 1 for every 16x16x16 section whose data follows in the compressed data<br />
|- <br />
| Size<br />
| VarInt<br />
| Size of Data<br />
|-<br />
| Data<br />
| [[SMP Map Format#Data|Chunk]]<br />
| <br />
|}<br />
<br />
==== 多个方块改变 ====<br />
Fired whenever 2 or more blocks are changed within the render distance.<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
!colspan="2"| Field Name<br />
!colspan="2"| Field Type<br />
! Notes<br />
|-<br />
|rowspan="6"| 0x22<br />
|rowspan="6"| Play<br />
|rowspan="6"| Client<br />
|colspan="2"| Chunk X<br />
|colspan="2"| Int<br />
| Chunk X coordinate<br />
|-<br />
|colspan="2"| Chunk Z<br />
|colspan="2"| Int<br />
| Chunk Z coordinate<br />
|-<br />
|colspan="2"| Record Count<br />
|colspan="2"| VarInt<br />
| Number of elements in the following array, a.k.a. the number of blocks affected<br />
|-<br />
|rowspan="3"| Record<br />
| Horizontal Position<br />
|rowspan="3"| Array<br />
| Unsigned Byte<br />
| The 4 most significant bits (<code>0xF0</code>) encode the X coordinate, relative to the chunk. The 4 least significant bits (<code>0x0F</code>) encode the Z coordinate, relative to the chunk.<br />
|-<br />
| Y Coordinate<br />
| Unsigned Byte<br />
| <br />
|-<br />
| Block ID<br />
| VarInt<br />
| The new block ID for the block. <code><nowiki>id &lt;&lt; 4 | data</nowiki></code><br />
|}<br />
<br />
==== 方块改变 ====<br />
Fired whenever a block is changed within the render distance.<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="2"| 0x23<br />
|rowspan="2"| Play<br />
|rowspan="2"| Client<br />
| Location<br />
| Position<br />
| Block Coordinates<br />
|-<br />
| Block ID<br />
| VarInt<br />
| The new block ID for the block. <code><nowiki>id &lt;&lt; 4 | data</nowiki></code><br />
|}<br />
<br />
==== 方块功能 ====<br />
<br />
This packet is used for a number of things:<br />
<br />
* Chests opening and closing<br />
* Pistons pushing and pulling<br />
* Note blocks playing<br />
* Updating beacons<br />
<br />
See Also: [[Block Actions]] <br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="4"| 0x24<br />
|rowspan="4"| Play<br />
|rowspan="4"| Client<br />
| Location<br />
| Position<br />
| Block Coordinates<br />
|-<br />
| Byte 1<br />
| Unsigned Byte<br />
| Varies depending on block — see [[Block Actions]]<br />
|-<br />
| Byte 2<br />
| Unsigned Byte<br />
| Varies depending on block — see [[Block Actions]]<br />
|-<br />
| Block Type<br />
| VarInt<br />
| The block type for the block<br />
|}<br />
<br />
==== 方块破坏动画 ====<br />
<br />
0–9 are the displayable destroy stages and each other number means that there is no animation on this coordinate.<br />
<br />
You can also set an animation to air! The animation will still be visible.<br />
<br />
If you need to display several break animations at the same time you have to give each of them a unique Entity ID.<br />
<br />
Also if you set the coordinates to a special block like water etc. it won't show the actual break animation but some other interesting effects. (Water will lose it's transparency)<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="3"| 0x25<br />
|rowspan="3"| Play<br />
|rowspan="3"| Client<br />
| Entity ID<br />
| VarInt<br />
| EID for the animation<br />
|-<br />
| Location<br />
| Position<br />
| Block Position<br />
|-<br />
| Destroy Stage<br />
| Byte<br />
| 0–9 to set it, any other value to remove it<br />
|}<br />
<br />
==== 地图区块 ====<br />
<br />
1.8 changes at [[#Chunk Data|Chunk Data]]<br />
<br />
To reduce the number of bytes, this packet is used to send chunks together for better compression results.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
!colspan="2"| Field Name<br />
!colspan="2"| Field Type<br />
! Notes<br />
|-<br />
|rowspan="7"| 0x26<br />
|rowspan="7"| Play<br />
|rowspan="7"| Client<br />
|colspan="2"| Sky Light Sent<br />
|colspan="2"| Boolean<br />
| Whether or not Chunk Data contains light nibble arrays. This is true in the Overworld, false in the End + Nether<br />
|-<br />
|colspan="2"| Chunk Column Count<br />
|colspan="2"| VarInt<br />
| Number of elements in each of the following arrays<br />
|-<br />
|rowspan="3"| Chunk Meta<br />
| Chunk X<br />
|rowspan="3"| Array<br />
| Int<br />
| The X coordinate of the chunk<br />
|-<br />
| Chunk Z<br />
| Int<br />
| The Z coordinate of the chunk<br />
|-<br />
| Primary Bit Mask<br />
| Unsigned Short<br />
| A bit mask which specifies which sections are not empty in this chunk<br />
|-<br />
|colspan="2"| Chunk Data<br />
|colspan="2"| Array of [[SMP Map Format#Data|Chunk]]<br />
| Each chunk in this array corresponds to the data at the same position in Chunk Meta<br />
|}<br />
<br />
==== 爆炸 ====<br />
<br />
Sent when an explosion occurs (creepers, TNT, and ghast fireballs).<br />
<br />
Each block in Records is set to air. Coordinates for each axis in record is int(X) + record.x<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="9"| 0x27<br />
|rowspan="9"| Play<br />
|rowspan="9"| Client<br />
| X<br />
| Float<br />
| <br />
|-<br />
| Y<br />
| Float<br />
| <br />
|-<br />
| Z<br />
| Float<br />
| <br />
|-<br />
| Radius<br />
| Float<br />
| Currently unused in the client<br />
|-<br />
| Record Count<br />
| Int<br />
| Number of elements in the following array<br />
|-<br />
| Records<br />
| Array of (Byte, Byte, Byte)<br />
| Each record is 3 signed bytes long, each bytes are the XYZ (respectively) offsets of affected blocks.<br />
|-<br />
| Player Motion X<br />
| Float<br />
| X velocity of the player being pushed by the explosion<br />
|-<br />
| Player Motion Y<br />
| Float<br />
| Y velocity of the player being pushed by the explosion<br />
|-<br />
| Player Motion Z<br />
| Float<br />
| Z velocity of the player being pushed by the explosion<br />
|}<br />
<br />
==== 属性 ====<br />
<br />
Sent when a client is to play a sound or particle effect.<br />
<br />
By default, the Minecraft client adjusts the volume of sound effects based on distance. The final boolean field is used to disable this, and instead the effect is played from 2 blocks away in the correct direction. Currently this is only used for effect 1013 (mob.wither.spawn), and is ignored for any other value by the client.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="4"| 0x28<br />
|rowspan="4"| Play<br />
|rowspan="4"| Client<br />
| Effect ID<br />
| Int<br />
| The ID of the effect, see below<br />
|-<br />
| Location<br />
| Position<br />
| The location of the effect<br />
|-<br />
| Data<br />
| Int<br />
| Extra data for certain effects, see below<br />
|-<br />
| Disable Relative Volume<br />
| Boolean<br />
| See above<br />
|}<br />
<br />
Effect IDs:<br />
<br />
{| class="wikitable"<br />
! ID<br />
! Name<br />
! Data<br />
|-<br />
!colspan="3"| Sound<br />
|-<br />
| 1000<br />
| <code>random.click</code><br />
| <br />
|-<br />
| 1001<br />
| <code>random.click</code><br />
| <br />
|-<br />
| 1002<br />
| <code>random.bow</code><br />
| <br />
|-<br />
| 1003<br />
| <code>random.door_open</code> or <code>random.door_close</code> (50/50 chance)<br />
| <br />
|-<br />
| 1004<br />
| <code>random.fizz</code><br />
| <br />
|-<br />
| 1005<br />
| Play a music disc.<br />
| {{Minecraft Wiki|Music Discs|Record ID}}<br />
|-<br />
| 1006<br />
| ''not assigned''<br />
| <br />
|-<br />
| 1007<br />
| <code>mob.ghast.charge</code><br />
| <br />
|-<br />
| 1008<br />
| <code>mob.ghast.fireball</code><br />
| <br />
|-<br />
| 1009<br />
| <code>mob.ghast.fireball</code>, but with a lower volume<br />
| <br />
|-<br />
| 1010<br />
| <code>mob.zombie.wood</code><br />
| <br />
|-<br />
| 1011<br />
| <code>mob.zombie.metal</code><br />
| <br />
|-<br />
| 1012<br />
| <code>mob.zombie.woodbreak</code><br />
| <br />
|-<br />
| 1013<br />
| <code>mob.wither.spawn</code><br />
| <br />
|-<br />
| 1014<br />
| <code>mob.wither.shoot</code><br />
| <br />
|-<br />
| 1015<br />
| <code>mob.bat.takeoff</code><br />
| <br />
|-<br />
| 1016<br />
| <code>mob.zombie.infect</code><br />
| <br />
|-<br />
| 1017<br />
| <code>mob.zombie.unfect</code><br />
| <br />
|-<br />
| 1018<br />
| <code>mob.enderdragon.end</code><br />
| <br />
|-<br />
| 1020<br />
| <code>random.anvil_break</code><br />
| <br />
|-<br />
| 1021<br />
| <code>random.anvil_use</code><br />
| <br />
|-<br />
| 1022<br />
| <code>random.anvil_land</code><br />
| <br />
|-<br />
!colspan="3"| Particle<br />
|-<br />
| 2000<br />
| Spawns 10 smoke particles, e.g. from a fire<br />
| Direction, see below<br />
|-<br />
| 2001<br />
| Block break<br />
| {{Minecraft Wiki|Data values|Block ID}}<br />
|-<br />
| 2002<br />
| Splash potion. Particle effect + glass break sound.<br />
| [http://www.lb-stuff.com/Minecraft/PotionDataValues1.9pre3.txt Potion ID]<br />
|-<br />
| 2003<br />
| Eye of Ender entity break animation — particles and sound<br />
| <br />
|-<br />
| 2004<br />
| Mob spawn particle effect: smoke + flames<br />
| <br />
|-<br />
| 2005<br />
| Spawn “happy villager” effect (green crosses), used for bonemealing vegetation<br />
| <br />
|}<br />
<br />
Smoke directions:<br />
<br />
{| class="wikitable"<br />
! ID<br />
! Direction<br />
|-<br />
| 0<br />
| South-East<br />
|-<br />
| 1<br />
| South<br />
|-<br />
| 2<br />
| South-West<br />
|-<br />
| 3<br />
| East<br />
|-<br />
| 4<br />
| (Up or middle ?)<br />
|-<br />
| 5<br />
| West<br />
|-<br />
| 6<br />
| North-East<br />
|-<br />
| 7<br />
| North<br />
|-<br />
| 8<br />
| North-West<br />
|}<br />
<br />
==== 声音特效 ====<br />
<br />
Used to play a sound effect on the client.<br />
<br />
Custom sounds may be added by resource packs.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="6"| 0x29<br />
|rowspan="6"| Play<br />
|rowspan="6"| Client<br />
| Sound name<br />
| String<br />
| All known sound effect names can be seen [https://github.com/SirCmpwn/Craft.Net/blob/master/source/Craft.Net.Common/SoundEffect.cs here]<br />
|-<br />
| Effect position X<br />
| Int<br />
| Effect X multiplied by 8<br />
|-<br />
| Effect position Y<br />
| Int<br />
| Effect Y multiplied by 8<br />
|-<br />
| Effect position Z<br />
| Int<br />
| Effect Z multiplied by 8<br />
|-<br />
| Volume<br />
| Float<br />
| 1 is 100%, can be more<br />
|-<br />
| Pitch<br />
| Unsigned Byte<br />
| 63 is 100%, can be more<br />
|}<br />
<br />
==== 粒子效果 ====<br />
<br />
Displays the named particle<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="11"| 0x2A<br />
|rowspan="11"| Play<br />
|rowspan="11"| Client<br />
| Particle ID<br />
| Int<br />
| See below<br />
|-<br />
| Long Distance<br />
| Boolean<br />
| If true, particle distance increases from 256 to 65536<br />
|-<br />
| X<br />
| Float<br />
| X position of the particle<br />
|-<br />
| Y<br />
| Float<br />
| Y position of the particle<br />
|-<br />
| Z<br />
| Float<br />
| Z position of the particle<br />
|-<br />
| Offset X<br />
| Float<br />
| This is added to the X position after being multiplied by random.nextGaussian()<br />
|-<br />
| Offset Y<br />
| Float<br />
| This is added to the Y position after being multiplied by random.nextGaussian()<br />
|-<br />
| Offset Z<br />
| Float<br />
| This is added to the Z position after being multiplied by random.nextGaussian()<br />
|-<br />
| Particle Data<br />
| Float<br />
| The data of each particle<br />
|-<br />
| Particle Count<br />
| Int<br />
| The number of particles to create<br />
|-<br />
| Data<br />
| Array of VarInt<br />
| Length depends on particle. "iconcrack" has length of 2, "blockcrack", and "blockdust" have lengths of 1, the rest have 0.<br />
|}<br />
<br />
Particle IDs:<br />
<br />
{| class="wikitable"<br />
|-<br />
! Particle Name<br />
! Particle ID<br />
|-<br />
| explode<br />
| 0<br />
|-<br />
| largeexplosion<br />
| 1<br />
|-<br />
| hugeexplosion<br />
| 2<br />
|-<br />
| fireworksSpark<br />
| 3<br />
|-<br />
| bubble<br />
| 4<br />
|-<br />
| splash<br />
| 5<br />
|-<br />
| wake<br />
| 6<br />
|-<br />
| suspended<br />
| 7<br />
|-<br />
| depthsuspend<br />
| 8<br />
|-<br />
| crit<br />
| 9<br />
|-<br />
| magicCrit<br />
| 10<br />
|-<br />
| smoke<br />
| 11<br />
|-<br />
| largesmoke<br />
| 12<br />
|-<br />
| spell<br />
| 13<br />
|-<br />
| instantSpell<br />
| 14<br />
|-<br />
| mobSpell<br />
| 15<br />
|-<br />
| mobSpellAmbient<br />
| 16<br />
|-<br />
| witchMagic<br />
| 17<br />
|-<br />
| dripWater<br />
| 18<br />
|-<br />
| dripLava<br />
| 19<br />
|-<br />
| angryVillager<br />
| 20<br />
|-<br />
| happyVillager<br />
| 21<br />
|-<br />
| townaura<br />
| 22<br />
|-<br />
| note<br />
| 23<br />
|-<br />
| portal<br />
| 24<br />
|-<br />
| enchantmenttable<br />
| 25<br />
|-<br />
| flame<br />
| 26<br />
|-<br />
| lava<br />
| 27<br />
|-<br />
| footstep<br />
| 28<br />
|-<br />
| cloud<br />
| 29<br />
|-<br />
| reddust<br />
| 30<br />
|-<br />
| snowballpoof<br />
| 31<br />
|-<br />
| snowshovel<br />
| 32<br />
|-<br />
| slime<br />
| 33<br />
|-<br />
| heart<br />
| 34<br />
|-<br />
| barrier<br />
| 35<br />
|-<br />
| iconcrack_(id)_(data)<br />
| 36<br />
|-<br />
| blockcrack_(id+(data<<12))<br />
| 37<br />
|-<br />
| blockdust_(id)<br />
| 38<br />
|-<br />
| droplet<br />
| 39<br />
|-<br />
| take<br />
| 40<br />
|-<br />
| mobappearance<br />
| 41<br />
|}<br />
<br />
==== 改变游戏状态 ====<br />
<br />
It appears when a bed can't be used as a spawn point and when the rain state changes.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="2"| 0x2B<br />
|rowspan="2"| Play<br />
|rowspan="2"| Client<br />
| Reason<br />
| Unsigned Byte<br />
| See below<br />
|-<br />
| Value<br />
| Float<br />
| Depends on Reason<br />
|}<br />
<br />
''Reason codes'':<br />
<br />
{| class="wikitable"<br />
! Reason<br />
! Effect<br />
! Value<br />
|-<br />
| 0<br />
| Invalid Bed<br />
| <br />
|-<br />
| 1<br />
| End raining<br />
| <br />
|-<br />
| 2<br />
| Begin raining<br />
| <br />
|-<br />
| 3<br />
| Change game mode<br />
| 0: Survival, 1: Creative, 2: Adventure, 3: Spectator<br />
|-<br />
| 4<br />
| Enter credits<br />
| <br />
|-<br />
| 5<br />
| Demo message<br />
| 0: Show welcome to demo screen, 101: Tell movement controls, 102: Tell jump control, 103: Tell inventory control<br />
|- <br />
| 6<br />
| Arrow hitting player<br />
| Appears to be played when an arrow strikes another player in Multiplayer<br />
|-<br />
| 7<br />
| Fade value<br />
| The current darkness value. 1 = Dark, 0 = Bright, Setting the value higher causes the game to change color and freeze<br />
|-<br />
| 8<br />
| Fade time<br />
| Time in ticks for the sky to fade<br />
|-<br />
| 10<br />
| Play mob appearance (effect and sound)<br />
| Unknown<br />
|}<br />
<br />
==== 生存全局实体 ====<br />
<br />
With this packet, the server notifies the client of thunderbolts striking within a 512 block radius around the player. The coordinates specify where exactly the thunderbolt strikes.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="5"| 0x2C<br />
|rowspan="5"| Play<br />
|rowspan="5"| Client<br />
| Entity ID<br />
| VarInt<br />
| The EID of the thunderbolt<br />
|-<br />
| Type<br />
| Byte<br />
| The global entity type, currently always 1 for thunderbolt<br />
|-<br />
| X<br />
| Int<br />
| Thunderbolt X, a [[Data Types#Fixed-point numbers|fixed-point number]]<br />
|-<br />
| Y<br />
| Int<br />
| Thunderbolt Y, a [[Data Types#Fixed-point numbers|fixed-point number]]<br />
|-<br />
| Z<br />
| Int<br />
| Thunderbolt Z, a [[Data Types#Fixed-point numbers|fixed-point number]]<br />
|}<br />
<br />
==== 打开窗户 ====<br />
<br />
This is sent to the client when it should open an inventory, such as a chest, workbench, or furnace. This message is not sent anywhere for clients opening their own inventory.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="5"| 0x2D<br />
|rowspan="5"| Play<br />
|rowspan="5"| Client<br />
| Window ID<br />
| Unsigned Byte<br />
| A unique id number for the window to be displayed. Notchian server implementation is a counter, starting at 1.<br />
|-<br />
| Window Type<br />
| String<br />
| The window type to use for display. See [[Inventory]] for a list.<br />
|-<br />
| Window Title<br />
| [[Chat]]<br />
| The title of the window<br />
|-<br />
| Number Of Slots<br />
| Unsigned Byte<br />
| Number of slots in the window (excluding the number of slots in the player inventory)<br />
|-<br />
| Entity ID<br />
| Optional Int<br />
| EntityHorse's EID. Only sent when Window Type is “EntityHorse”<br />
|}<br />
<br />
See [[Inventory]] for further information.<br />
<br />
==== 关闭窗户 ====<br />
<br />
This packet is sent from the server to the client when a window is forcibly closed, such as when a chest is destroyed while it's open.<br />
<br />
Note, notchian clients send a close window packet with Window ID 0 to close their inventory even though there is never an [[#Open Window|Open Window]] packet for inventory. <br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
| 0x2E<br />
|rowspan="1"| Play<br />
|rowspan="1"| Client<br />
| Window ID<br />
| Unsigned Byte<br />
| This is the ID of the window that was closed. 0 for inventory.<br />
|}<br />
<br />
==== 设置位置 ====<br />
<br />
Sent by the server when an item in a slot (in a window) is added/removed.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="3"| 0x2F<br />
|rowspan="3"| Play<br />
|rowspan="3"| Client<br />
| Window ID<br />
| Byte<br />
| The window which is being updated. 0 for player inventory. Note that all known window types include the player inventory. This packet will only be sent for the currently opened window while the player is performing actions, even if it affects the player inventory. After the window is closed, a number of these packets are sent to update the player's inventory window (0).<br />
|-<br />
| Slot<br />
| Short<br />
| The slot that should be updated<br />
|-<br />
| Slot Data<br />
| [[Slot Data|Slot]]<br />
| <br />
|}<br />
<br />
==== 窗口物品 ====<br />
<br />
[[File:Inventory-slots.png|thumb|The inventory slots]]<br />
<br />
Sent by the server when items in multiple slots (in a window) are added/removed. This includes the main inventory, equipped armour and crafting slots.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="3"| 0x30<br />
|rowspan="3"| Play<br />
|rowspan="3"| Client<br />
| Window ID<br />
| Unsigned Byte<br />
| The ID of window which items are being sent for. 0 for player inventory.<br />
|-<br />
| Count<br />
| Short<br />
| Number of elements in the following array<br />
|-<br />
| Slot Data<br />
| Array of [[Slot Data|Slot]]<br />
| <br />
|}<br />
<br />
See [[Inventory#Windows|inventory windows]] for further information about how slots are indexed.<br />
<br />
==== 窗体属性 ====<br />
<br />
此包是用于与客户端交流更新GUI窗体的部分。<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="3"| 0x31<br />
|rowspan="3"| Play<br />
|rowspan="3"| Client<br />
| Window ID<br />
| Unsigned Byte<br />
| <br />
|-<br />
| Property<br />
| Short<br />
| 要更新的属性，见下文<br />
|-<br />
| Value<br />
| Short<br />
| 属性的新值，见下文<br />
|}<br />
<br />
属性字段的含义取决于窗口的类型。下表显示了窗口类型和属性的已知组合和价值的定义范围。<br />
<br />
{| class="wikitable"<br />
|-<br />
! Window type<br />
! Property<br />
! Value<br />
|-<br />
|rowspan="2"| Furnace<br />
| 0: Progress arrow<br />
| 0–200 (presumably in in-game ticks)<br />
|-<br />
| 1: Fire icon (fuel)<br />
| 0–200 (presumably in in-game ticks)<br />
|-<br />
|rowspan="7"| Enchantment Table<br />
| 0: Level requirement for top enchantment slot<br />
|rowspan="3"| The enchantment's xp level requirement<br />
|-<br />
| 1: Level requirement for middle enchantment slot<br />
|-<br />
| 2: Level requirement for bottom enchantment slot<br />
|-<br />
| 3: The seed for generating the enchantments view for the client<br />
| Unknown<br />
|-<br />
| 4: tooltip shown on mouse hover over top enchantment slot<br />
|rowspan="3"| Unknown (set to -1 to hide it)<br />
|-<br />
| 5: tooltip shown on mouse hover over middle enchantment slot<br />
|-<br />
| 6: tooltip shown on mouse hover over bottom enchantment slot<br />
|-<br />
|rowspan="3"| Beacon<br />
| 0: Power level<br />
| Unknown<br />
|-<br />
| 1: First potion effect<br />
| Unknown<br />
|-<br />
| 2: Second potion effect<br />
| Unknown<br />
|-<br />
| Anvil<br />
| 0: Repair cost<br />
| The repair's cost in xp levels<br />
|-<br />
| Brewing Stand<br />
| 0: Brew time<br />
| 0–400, with 400 making the arrow empty, and 0 making the arrow full<br />
|}<br />
<br />
==== 确认事物 ====<br />
<br />
A packet from the server indicating whether a request from the client was accepted, or whether there was a conflict (due to lag).<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="3"| 0x32<br />
|rowspan="3"| Play<br />
|rowspan="3"| Client<br />
| Window ID<br />
| Byte<br />
| The ID of the window that the action occurred in<br />
|-<br />
| Action Number<br />
| Short<br />
| Every action that is to be accepted has a unique number. This field corresponds to that number.<br />
|-<br />
| Accepted<br />
| Boolean<br />
| Whether the action was accepted<br />
|}<br />
<br />
==== 更新标志 ====<br />
<br />
This message is sent from the server to the client whenever a sign is discovered or created. This message is NOT sent when a sign is destroyed or unloaded.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="5"| 0x33<br />
|rowspan="5"| Play<br />
|rowspan="5"| Client<br />
| Location<br />
| Position<br />
| <br />
|-<br />
| Line 1<br />
| [[Chat]]<br />
| First line of text in the sign<br />
|-<br />
| Line 2<br />
| [[Chat]]<br />
| Second line of text in the sign<br />
|-<br />
| Line 3<br />
| [[Chat]]<br />
| Third line of text in the sign<br />
|-<br />
| Line 4<br />
| [[Chat]]<br />
| Fourth line of text in the sign<br />
|}<br />
<br />
==== 地图 ====<br />
<br />
Updates a rectangular area on a map.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
!colspan="2"| Field Name<br />
!colspan="2"| Field Type<br />
! Notes<br />
|-<br />
|rowspan="12"| 0x34<br />
|rowspan="12"| Play<br />
|rowspan="12"| Client<br />
|colspan="2"| Item Damage<br />
|colspan="2"| VarInt<br />
| The damage value (map ID) of the map being modified<br />
|-<br />
|colspan="2"| Scale<br />
|colspan="2"| Byte<br />
| <br />
|- <br />
|colspan="2"| Icon Count<br />
|colspan="2"| VarInt<br />
| Number of elements in the following array<br />
|-<br />
|rowspan="3"| Icon<br />
| Direction And Type<br />
|rowspan="3"| Array<br />
| Byte<br />
| 0xF0 = Direction, 0x0F = Type<br />
|-<br />
| X<br />
| Byte<br />
| <br />
|-<br />
| Z<br />
| Byte<br />
| <br />
|- <br />
|colspan="2"| Columns<br />
|colspan="2"| Byte<br />
| Number of columns updated<br />
|-<br />
|colspan="2"| Rows<br />
|colspan="2"| Optional Byte<br />
| Only if Columns is more than 0; number of rows updated<br />
|-<br />
|colspan="2"| X<br />
|colspan="2"| Optional Byte<br />
| Only if Columns is more than 0; x offset of the westernmost column<br />
|-<br />
|colspan="2"| Z<br />
|colspan="2"| Optional Byte<br />
| Only if Columns is more than 0; z offset of the northernmost row<br />
|-<br />
|colspan="2"| Length<br />
|colspan="2"| Optional VarInt<br />
| Only if Columns is more than 0; length of the following array<br />
|-<br />
|colspan="2"| Data<br />
|colspan="2"| Optional Array of Unsigned Byte<br />
| Only if Columns is more than 0; see {{Minecraft Wiki|Map item format}}<br />
|}<br />
<br />
==== 更新方块实体 ====<br />
<br />
Essentially a block update on a block entity.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="3"| 0x35<br />
|rowspan="3"| Play<br />
|rowspan="3"| Client<br />
| Location<br />
| Position<br />
| <br />
|-<br />
| Action<br />
| Unsigned Byte<br />
| The type of update to perform, see below<br />
|-<br />
| NBT Data<br />
| Optional [[NBT|NBT Tag]]<br />
| If not present then it's a TAG_END (0)<br />
|}<br />
<br />
''Action'' field:<br />
<br />
* '''1''': Set SpawnPotentials of a mob spawner<br />
* '''2''': Set command block text (command and last execution status)<br />
* '''3''': Set the level, primary, and secondary powers of a beacon<br />
* '''4''': Set rotation and skin of mob head<br />
* '''5''': Set type of flower in flower pot<br />
* '''6''': Set base color and patterns on a banner<br />
<br />
==== 打开标志牌编辑器 ====<br />
<br />
Sent on placement of sign.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="1"| 0x36<br />
|rowspan="1"| Play<br />
|rowspan="1"| Client<br />
| Location<br />
| Position<br />
| <br />
|}<br />
<br />
==== 统计数据 ====<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To <br />
!colspan="2"| Field Name<br />
!colspan="2"| Field Type<br />
! Notes<br />
|-<br />
|rowspan="3"| 0x37<br />
|rowspan="3"| Play<br />
|rowspan="3"| Client<br />
|colspan="2"| Count<br />
|colspan="2"| VarInt<br />
| Number of elements in the following array<br />
|-<br />
|rowspan="2"| Statistic<br />
| Name<br />
|rowspan="2"| Array<br />
| String<br />
| [https://gist.github.com/thinkofdeath/a1842c21a0cf2e1fb5e0 https://gist.github.com/thinkofdeath/a1842c21a0cf2e1fb5e0]<br />
|-<br />
| Value<br />
| VarInt<br />
| The amount to set it to<br />
|}<br />
<br />
==== 玩家列表项 ====<br />
<br />
Sent by the notchian server to update the user list (<tab> in the client).<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
!colspan="4"| Field Name<br />
!colspan="3"| Field Type<br />
! Notes<br />
|-<br />
|rowspan="19"| 0x38<br />
|rowspan="19"| Play<br />
|rowspan="19"| Client<br />
|colspan="4"| Action<br />
|colspan="3"| VarInt<br />
| Determines the rest of the Player format after the UUID<br />
|-<br />
|colspan="4"| Number Of Players<br />
|colspan="3"| VarInt<br />
| Number of elements in the following array<br />
|-<br />
|rowspan="17"| Player<br />
|colspan="3"| UUID<br />
|rowspan="17"| Array<br />
|colspan="2"| UUID<br />
| <br />
|-<br />
! Action<br />
!colspan="2"| Field Name<br />
!colspan="2"| <br />
! <br />
|-<br />
|rowspan="10"| 0: add player<br />
|colspan="2"| Name<br />
|colspan="2"| String<br />
| <br />
|-<br />
|colspan="2"| Number Of Properties<br />
|colspan="2"| VarInt<br />
| Number of elements in the following array<br />
|-<br />
|rowspan="4"| Property<br />
| Name<br />
|rowspan="4"| Array<br />
| String<br />
| <br />
|-<br />
| Value<br />
| String<br />
| <br />
|- <br />
| Is Signed<br />
| Boolean<br />
| <br />
|-<br />
| Signature<br />
| Optional String<br />
| Only if Is Signed is true<br />
|-<br />
|colspan="2"| Gamemode<br />
|colspan="2"| VarInt<br />
| <br />
|-<br />
|colspan="2"| Ping<br />
|colspan="2"| VarInt<br />
| <br />
|-<br />
|colspan="2"| Has Display Name<br />
|colspan="2"| Boolean<br />
| <br />
|-<br />
|colspan="2"| Display Name<br />
|colspan="2"| Optional [[Chat]]<br />
| Only if Has Display Name is true<br />
|-<br />
| 1: update gamemode<br />
|colspan="2"| Gamemode<br />
|colspan="2"| VarInt<br />
| <br />
|- <br />
| 2: update latency<br />
|colspan="2"| Ping<br />
|colspan="2"| VarInt<br />
| <br />
|-<br />
|rowspan="2"| 3: update display name<br />
|colspan="2"| Has Display Name<br />
|colspan="2"| Boolean<br />
| <br />
|-<br />
|colspan="2"| Display Name<br />
|colspan="2"| Optional [[Chat]]<br />
| Only send if Has Display Name is true<br />
|-<br />
| 4: remove player<br />
|colspan="2"| ''no fields''<br />
|colspan="2"| ''no fields''<br />
| <br />
|}<br />
<br />
==== 玩家能力 ====<br />
<br />
The latter 2 floats are used to indicate the walking and flying speeds respectively, while the first byte is used to determine the value of 4 booleans.<br />
<br />
The flags are whether damage is disabled (god mode, 8, bit 3), whether the player can fly (4, bit 2), whether the player is flying (2, bit 1), and whether the player is in creative mode (1, bit 0).<br />
<br />
To get the values of these booleans, simply AND (&) the byte with 1,2,4 and 8 respectively, to get the 0 or 1 bitwise value. To set them OR (|) them with their repspective masks.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="3"| 0x39<br />
|rowspan="3"| Play<br />
|rowspan="3"| Client<br />
| Flags<br />
| Byte<br />
| Bit mask, see above<br />
|-<br />
| Flying Speed<br />
| Float<br />
| <br />
|-<br />
| Walking Speed<br />
| Float<br />
| <br />
|}<br />
<br />
==== Tab补全 ====<br />
<br />
The server responds with a list of auto-completions of the last word sent to it. In the case of regular chat, this is a player username. Command names and parameters are also supported.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="2"| 0x3A<br />
|rowspan="2"| Play<br />
|rowspan="2"| Client<br />
| Count<br />
| VarInt<br />
| Number of elements in the following array<br />
|-<br />
| Matches<br />
| Array of String<br />
| One eligible command, note that each command is sent separately instead of in a single string, hence the need for Count<br />
|}<br />
<br />
==== 计分板目标 ====<br />
<br />
This is sent to the client when it should create a new {{Minecraft Wiki|scoreboard}} objective or remove one.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="4"| 0x3B<br />
|rowspan="4"| Play<br />
|rowspan="4"| Client<br />
| Objective Name<br />
| String<br />
| An unique name for the objective<br />
|-<br />
| Mode<br />
| Byte<br />
| 0 to create the scoreboard. 1 to remove the scoreboard. 2 to update the display text. <br />
|-<br />
| Objective Value<br />
| Optional String<br />
| Only if mode is 0 or 2. The text to be displayed for the score<br />
|-<br />
| Type<br />
| Optional String<br />
| Only if mode is 0 or 2. “integer” or “hearts”<br />
|}<br />
<br />
==== 更新分数 ====<br />
<br />
This is sent to the client when it should update a scoreboard item. <br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="4"| 0x3C<br />
|rowspan="4"| Play<br />
|rowspan="4"| Client<br />
| Score Name<br />
| String<br />
| The name of the score to be updated or removed<br />
|-<br />
| Action<br />
| Byte<br />
| 0 to create/update an item. 1 to remove an item.<br />
|-<br />
| Objective Name<br />
| String<br />
| The name of the objective the score belongs to<br />
|-<br />
| Value<br />
| Optional VarInt<br />
| The score to be displayed next to the entry. Only sent when Action does not equal 1.<br />
|}<br />
<br />
==== 显示计分板 ====<br />
<br />
This is sent to the client when it should display a scoreboard.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="2"| 0x3D<br />
|rowspan="2"| Play<br />
|rowspan="2"| Client<br />
| Position<br />
| Byte<br />
| The position of the scoreboard. 0: list, 1: sidebar, 2: below name.<br />
|-<br />
| Score Name<br />
| String<br />
| The unique name for the scoreboard to be displayed.<br />
|}<br />
<br />
==== 团队 ====<br />
<br />
Creates and updates teams.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="10"| 0x3E<br />
|rowspan="10"| Play<br />
|rowspan="10"| Client<br />
| Team Name<br />
| String<br />
| A unique name for the team. (Shared with scoreboard).<br />
|-<br />
| Mode<br />
| Byte<br />
| If 0 then the team is created.<br />
<br />
If 1 then the team is removed. <br />
<br />
If 2 the team team information is updated. <br />
<br />
If 3 then new players are added to the team. <br />
<br />
If 4 then players are removed from the team.<br />
|-<br />
| Team Display Name<br />
| Optional String<br />
| Only if Mode = 0 or 2.<br />
|-<br />
| Team Prefix<br />
| Optional String<br />
| Only if Mode = 0 or 2. Displayed before the players' name that are part of this team<br />
|-<br />
| Team Suffix<br />
| Optional String<br />
| Only if Mode = 0 or 2. Displayed after the players' name that are part of this team<br />
|-<br />
| Friendly Fire<br />
| Optional Byte<br />
| Only if Mode = 0 or 2. 0 for off, 1 for on, 3 for seeing friendly invisibles<br />
|-<br />
| Name Tag Visibility<br />
| Optional String<br />
| Only if Mode = 0 or 2. always, hideForOtherTeams, hideForOwnTeam, never<br />
|-<br />
| Color<br />
| Optional Byte<br />
| Only if Mode = 0 or 2. Same as [[Chat]] colors<br />
|-<br />
| Player Count<br />
| Optional VarInt<br />
| Only if Mode = 0 or 3 or 4. Number of players in the array<br />
|-<br />
| Players<br />
| Optional Array of String<br />
| Only if Mode = 0 or 3 or 4. Players to be added/remove from the team. Max 40 characters so may be uuid's later<br />
|}<br />
<br />
==== 插件信息 ====<br />
<br />
Mods and plugins can use this to send their data. Minecraft itself uses a number of [[plugin channel]]s. These internal channels are prefixed with <code>MC|</code>.<br />
<br />
More documentation on this: [http://dinnerbone.com/blog/2012/01/13/minecraft-plugin-channels-messaging/ http://dinnerbone.com/blog/2012/01/13/minecraft-plugin-channels-messaging/]<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="2"| 0x3F<br />
|rowspan="2"| Play<br />
|rowspan="2"| Client<br />
| Channel<br />
| String<br />
| Name of the [[plugin channel]] used to send the data<br />
|-<br />
| Data<br />
| Byte Array<br />
| Any data, depending on the channel. <code><nowiki>MC|</nowiki></code> channels are documented [[plugin channel|here]].<br />
|}<br />
<br />
==== 断开连接 ====<br />
<br />
Sent by the server before it disconnects a client. The server assumes that the sender has already closed the connection by the time the packet arrives.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
| 0x40<br />
|rowspan="1"| Play<br />
|rowspan="1"| Client<br />
| Reason<br />
| [[Chat]]<br />
| Displayed to the client when the connection terminates.<br />
|}<br />
<br />
==== 服务器难度 ====<br />
<br />
Changes the difficulty setting in the client's option menu<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="1"| 0x41<br />
|rowspan="1"| Play<br />
|rowspan="1"| Client<br />
| Difficulty<br />
| Unsigned Byte<br />
| 0: peaceful, 1: easy, 2: normal, 3: hard<br />
|}<br />
<br />
==== 战斗事件 ====<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="6"| 0x42<br />
|rowspan="6"| Play<br />
|rowspan="6"| Client<br />
| Event<br />
| VarInt<br />
| 0: enter combat, 1: end combat, 2: entity dead<br />
|-<br />
| Duration<br />
| Optional VarInt<br />
| Only for end combat<br />
|-<br />
| Player ID<br />
| Optional VarInt<br />
| Only for entity dead<br />
|-<br />
| Entity ID<br />
| Optional Int<br />
| Only for end combat and entity dead<br />
|-<br />
| Message<br />
| String<br />
| Only for entity dead<br />
|}<br />
<br />
==== 摄像机 ====<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="1"| 0x43<br />
|rowspan="1"| Play<br />
|rowspan="1"| Client<br />
| Camera ID<br />
| VarInt<br />
| <br />
|}<br />
<br />
==== 世界边界 ==== <br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
!colspan="2"| Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="18"| 0x44<br />
|rowspan="18"| Play<br />
|rowspan="18"| Client<br />
|colspan="2"| Action<br />
| VarInt<br />
| Determines the format of the rest of the packet<br />
|-<br />
! Action<br />
! Field Name<br />
! <br />
! <br />
|-<br />
| 0: set size<br />
| Radius<br />
| Double<br />
| meters<br />
|-<br />
|rowspan="3"| 1: lerp size<br />
| Old Radius<br />
| Double<br />
| meters<br />
|-<br />
| New Radius<br />
| Double<br />
| meters<br />
|-<br />
| Speed<br />
| VarLong<br />
| number of real-time ticks/seconds (?) until New Radius is reached. From experiments, it appears that Notchian server does not sync world border speed to game ticks, so it gets out of sync with server lag<br />
|-<br />
|rowspan="2"| 2: set center<br />
| X<br />
| Double<br />
| <br />
|-<br />
| Z<br />
| Double<br />
| <br />
|-<br />
|rowspan="8"| 3: initialize<br />
| X<br />
| Double<br />
| <br />
|-<br />
| Z<br />
| Double<br />
| <br />
|-<br />
| Old Radius<br />
| Double<br />
| <br />
|-<br />
| New Radius<br />
| Double<br />
| <br />
|-<br />
| Speed<br />
| VarLong<br />
| <br />
|-<br />
| Portal Teleport Boundary<br />
| VarInt<br />
| Resulting coordinates from a portal teleport are limited to +-value. Usually 29999984.<br />
|-<br />
| Warning Time<br />
| VarInt<br />
| <br />
|-<br />
| Warning Blocks<br />
| VarInt<br />
| <br />
|-<br />
|rowspan="1"| 4: set warning time<br />
| Warning Time<br />
| VarInt<br />
| unit?<br />
|-<br />
|rowspan="1"| 5: set warning blocks<br />
| Warning Blocks<br />
| VarInt<br />
| <br />
|}<br />
<br />
==== 显示标题 ==== <br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
!colspan="2"| Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="9"| 0x45<br />
|rowspan="9"| Play<br />
|rowspan="9"| Client<br />
|colspan="2"| Action<br />
| VarInt<br />
| <br />
|-<br />
! Action<br />
! Field Name<br />
! <br />
! <br />
|-<br />
| 0: set title<br />
| Title Text<br />
| [[Chat]]<br />
| <br />
|-<br />
| 1: set subtitle<br />
| Subtitle Text<br />
| [[Chat]]<br />
| <br />
|-<br />
|rowspan="3"| 2: set times and display<br />
| Fade In<br />
| Int<br />
| ticks<br />
|-<br />
| Stay<br />
| Int<br />
| ticks<br />
|-<br />
| Fade Out<br />
| Int<br />
| ticks<br />
|-<br />
| 3: hide<br />
| ''no fields''<br />
| ''no fields''<br />
| <br />
|-<br />
| 4: reset<br />
| ''no fields''<br />
| ''no fields''<br />
| <br />
|}<br />
<br />
“Hide” makes the title disappear, but if you run times again the same title will appear. “Reset” erases the text.<br />
<br />
==== 设置压缩 ====<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="1"| 0x46<br />
|rowspan="1"| Play<br />
|rowspan="1"| Client<br />
| Threshold<br />
| VarInt<br />
| 这种大小或更高的包可以被压缩。<br />
|}<br />
<br />
==== 玩家列表页眉与页脚 ====<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="2"| 0x47<br />
|rowspan="2"| Play<br />
|rowspan="2"| Client<br />
| Header<br />
| [[Chat]]<br />
| <br />
|-<br />
| Footer<br />
| [[Chat]]<br />
| <br />
|}<br />
<br />
==== 发送资源包 ==== <br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="2"| 0x48<br />
|rowspan="2"| Play<br />
|rowspan="2"| Client<br />
| URL<br />
| String<br />
| 资源包的 URL 地址<br />
|-<br />
| Hash<br />
| String<br />
| 一个40个字符的十六进制和小写的[[wikipedia:SHA-1|SHA-1]]哈希的资源包文件。（必须小写）<br />如果不符合上一行的标准， 客户端将不会验证它哈希值及浪费不必要的带宽 — 但仍将把它作为唯一的标识符处理<br />
|}<br />
<br />
==== 更新实体 NBT ==== <br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="2"| 0x49<br />
|rowspan="2"| Play<br />
|rowspan="2"| Client<br />
| Entity ID<br />
| VarInt<br />
| <br />
|-<br />
| Tag<br />
| [[NBT|NBT Tag]]<br />
| <br />
|}<br />
<br />
=== 发送到服务器 ===<br />
<br />
==== 保持连接 ====<br />
<br />
服务器会经常发送一个保持连接包，内含一个随机的ID。客户端必须回应同样的包。<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="1"| 0x00<br />
|rowspan="1"| Play<br />
|rowspan="1"| Server<br />
| Keep Alive ID<br />
| VarInt<br />
| <br />
|}<br />
<br />
==== 聊天信息 ====<br />
<br />
默认服务端会检查信息是否以 '/' 开头。如果不是是，发送者的用户名将被放在消息前并且发送到所有其他客户端（包括原始的发送者）。如果是，服务端认为它是一个命令并尝试处理它。一个长度大于 100 的信息会导致服务端踢出该客户端。这个行为一开始是在不修改服务端的前提下不允许客户端不分段发送长度超过 119（以前的限制）的信息。因为这个原因，原始的服务端保留了在 119 处将消息切片的代码，但是这不是一个协议限制并且可以被跳过。<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="1"| 0x01<br />
|rowspan="1"| Play<br />
|rowspan="1"| Server<br />
| Message<br />
| String<br />
| The client sends the raw input, not [[Chat]]<br />
|}<br />
<br />
==== 使用实体 ====<br />
<br />
这个包在玩家攻击或者右键点击其他实体（一个玩家、矿车等）时从客户端发往服务器。<br />
<br />
一个官方服务端只在被攻击或使用的实体是可视的、在以玩家为中心 4单位 的范围内且与玩家之间没有阻碍时才接受这个包。<br />
<br />
注意：创造模式的中键点击会被客户端解析且被发送为 [[#Creative Inventory Action|创造背包动作]] 包。<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="5"| 0x02<br />
|rowspan="5"| Play<br />
|rowspan="5"| Server<br />
| Target<br />
| VarInt<br />
| <br />
|-<br />
| Type<br />
| VarInt<br />
| 0: interact, 1: attack, 2: interact at<br />
|-<br />
| Target X<br />
| Optional Float<br />
| 只有当类型为 interact at 时<br />
|-<br />
| Target Y<br />
| Optional Float<br />
| 只有当类型为 interact at 时<br />
|-<br />
| Target Z<br />
| Optional Float<br />
| 只有当类型为 interact at 时<br />
|}<br />
<br />
==== 玩家状态 ====<br />
<br />
这个包用于表明玩家正在陆地上（行走/游泳）还是在空中（跳跃/掉落）。<br />
<br />
当从足够高的高度掉落，这个状态从 false 设置为 true 时会受到掉落伤害。受到伤害的数值基于最后状态从 true 设置为 false。 注意有一些运动相关的包包含了这个包。<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="1"| 0x03<br />
|rowspan="1"| Play<br />
|rowspan="1"| Server<br />
| On Ground<br />
| Boolean<br />
| 当对象站在地上时为 true , 反之则为 false<br />
|}<br />
<br />
==== 玩家坐标 ====<br />
<br />
更新玩家在服务器上的 XYZ 坐标。<br />
<br />
如果在服务器上最后记录的位置和这个包设置的新位置之间的距离大于 100 单位，将会导致客户端因为 “You moved too quickly :( (Hacking?)” 而被踢出服务器。<br />
<br />
如果之间的距离大于 10 单位，服务器会在日志中写下警告信息 “<name> moved too quickly!” 和两个三元坐标（可能是运动增量？），但不会踢出客户端。<br />
<br />
如果 X 或 Z 的定点数被设置大于 3.2×10<sup>7</sup> 客户端会因为 “Illegal position” 而被踢出服务器。<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="4"| 0x04<br />
|rowspan="4"| Play<br />
|rowspan="4"| Server<br />
| X<br />
| Double<br />
| 绝对位置<br />
|-<br />
| Feet Y<br />
| Double<br />
| 绝对位置，史蒂夫头部一般在 Y - 1.62<br />
|-<br />
| Z<br />
| Double<br />
| 绝对位置<br />
|-<br />
| On Ground<br />
| Boolean<br />
| 当对象站在地上时为 true , 反之则为 false<br />
|}<br />
<br />
==== 玩家观察 ====<br />
[[File:Minecraft-trig-yaw.png|thumb|The unit circle for yaw]]<br />
[[File:Yaw.png|thumb|The unit circle of yaw, redrawn]]<br />
<br />
更新玩家目前所看的方向。<br />
<br />
偏航（Yaw）以度为单位，并且不遵循经典的三角规则。</div>
梦彗業
https://mineplugin.org/index.php?title=Protocol&diff=5413
Protocol
2017-09-02T14:21:12Z
<p>梦彗業：翻译</p>
<hr />
<div>{{待翻译}}<br />
{{待更新|url=http://wiki.vg/Protocol}}<br />
<br />
这里剖析了最近的 '''[http://wiki.vg/Protocol_Encryption Minecraft协议]'''.<br />
<br />
如果你有疑问, 请查阅下文或在IRC请求帮助 ([irc://irc.freenode.net/mcdevs #mcdevs on irc.freenode.net]).<br />
<br />
'''注意:''' 你可以不受限制地使用这个页面的内容来创建服务端, 客户端, 机器人…… 诸如此类的任何东西…<br />
<br />
== 定义 ==<br />
<br />
Minecraft服务器是基于TCP通讯的。它和客户端使用所谓的 ''数据包''交流. 一个包被通过字节编码后从TCP连接中发送. 数据包的含义取决于其包标识和连接的当前状态. 每个链接从 '''[http://wiki.vg/Handshaking 握手]'''开始, 使用包切换状态 '''[http://wiki.vg/Handshaking 握手]''',( 0x00, serverbound) 和 [[#Login Success|成功登陆]] ([[#Login|登陆]], 0x02, clientbound).<br />
<br />
=== 数据类型 ===<br />
<br />
<!-- Transcluded contents of Data Types article in here - go to that page if you want to edit it --><br />
<br />
{{:Data Types}}<br />
<br />
=== 其他定义 ===<br />
<br />
{| class="wikitable"<br />
|-<br />
! 术语<br />
! 定义<br />
|-<br />
| Player——玩家<br />
| 使用时, 玩家通常使用它来链接到服务端.<br />
|-<br />
| Entity——实体<br />
| 实体相当于玩家、物品、怪物、船和矿车等. 查看 {{Minecraft Wiki|Entity|the Minecraft Wiki article}} 来寻找一个完整的表单.<br />
|-<br />
| EID——实体ID<br />
| An EID — 或者说是实体ID — 是一个用来识别特定实体的4字节序列. 在同一个服务器,没有相同的实体编号.<br />
|-<br />
| XYZ坐标<br />
| 游戏时，可以使用按钮“F3”来在屏幕上查看坐标位置 Y代表高度, X代表东西, Z代表南北.<br />
|-<br />
| 单位“Meter”<br />
| Meter是Minecraft的基本长度单位, 相当于一个方块的长度. “block”一词也许意味着 “meter”或者“cubic meter”.<br />
|}<br />
<br />
== 数据包的格式 ==<br />
<br />
=== 无压缩 ===<br />
<br />
{| class="wikitable"<br />
! 域名称<br />
! 域类型<br />
! 注释<br />
|-<br />
| 长度<br />
| VarInt<br />
| 包数据的长度 + 包序号的长度<br />
|-<br />
| 包序号<br />
| VarInt<br />
| <br />
|-<br />
| 数据<br />
| Byte Array<br />
| 依赖于连接状态和包序号，详见下面的部分。<br />
|}<br />
<br />
=== 压缩 ===<br />
<br />
当一个 [[#Set Compression|设置压缩]] 包被发送，[[wikipedia:Zlib|zlib]] 压缩将会对之后的所有包开启。 包的格式略微改变以包含未压缩前的包的长度。<br />
''译注：注意区分包长度和数据长度，关系：“包”包含“数据”''<br />
{| class=wikitable<br />
! 是否压缩<br />
! 域名称<br />
! 域类型<br />
! 注释<br />
|-<br />
| 否<br />
| 包长度<br />
| VarInt<br />
| 数据长度的长度 + 压缩后的 (包序号 + 数据) 的长度<br />
|-<br />
| 否<br />
| 数据长度<br />
| VarInt<br />
| 未压缩前的 (包序号 + 数据) 的长度 或 0<br />
|-<br />
|rowspan="2"| 是<br />
| 包序号<br />
| Varint<br />
| zlib 压缩后的包序号（详见下面的部分）<br />
|-<br />
| 数据<br />
| Byte Array<br />
| zlib 压缩后的包数据（详见下面的部分）<br />
|}<br />
<br />
包长度域提供的是包中存在的字节的数量，包括数据长度域。<br />
<br />
如果数据长度被设置为 0，则这个包没有被压缩；否则它表示已压缩的包未压缩前的包长度。<br />
<br />
如果包被压缩，压缩前的 (包序号 + 数据) 的长度必须等于或大于 [[#Set Compression|设置压缩]] 包中设置的最小值，否则客户端/服务端将会断开连接。<br />
<br />
压缩能通过发送一个最小值设定为 -1 的 [[#Set Compression|设置压缩]] 包来关闭。<br />
<br />
== 握手协议 ==<br />
<br />
=== 客户端绑定 ===<br />
<br />
因为协议在客户端发送第一个数据包后会立刻切换到另一个阶段，所以握手阶段没有客户端绑定的数据包。<br />
<br />
=== 服务端绑定 ===<br />
<br />
==== 握手协议 ====<br />
<br />
这将使得服务器切换至目标阶段。<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="4"| 0x00<br />
|rowspan="4"| Handshaking<br />
|rowspan="4"| Server<br />
| 协议版本<br />
| VarInt<br />
| See [[protocol version numbers]] (currently 47)<br />
|-<br />
| 服务器地址<br />
| String<br />
| 域名或是IP, 例如： localhost 或是 127.0.0.1<!-- does this support IPv6? --><br />
|- <br />
| 服务器端口<br />
| Unsigned Short<br />
| 默认值为25565<br />
|-<br />
| 下一阶段<br />
| VarInt<br />
| 1 for [[#Status|status]], 2 for [[#Login|login]]<br />
|}<br />
<br />
==== 传统的服务器列表Ping ====<br />
<br />
严格来说这不是当前协议的一部分，传统客户端可能会发送这一数据包来发起（initiate） [[Server List Ping]], 现代服务器也应当能够适当地处理这一数据包。<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
| 0xFE<br />
| Handshaking<br />
| Server<br />
| Payload<br />
| Unsigned Byte<br />
| always 1 (<code>0x01</code>)<br />
|}<br />
<br />
See [[Server List Ping#1.6]] for the details of the protocol that follows this packet.<br />
<br />
== 开始游戏 ==<br />
<br />
=== 发送到客户端 ===<br />
<br />
==== 心跳包 ====<br />
<br />
The server will frequently send out a keep-alive, each containing a random ID. The client must respond with the same packet. If the client does not respond to them for over 30 seconds, the server kicks the client. Vice versa, if the server does not send any keep-alives for 20 seconds, the client will disconnect and yields a "Timed out" exception.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="1"| 0x00<br />
|rowspan="1"| Play<br />
|rowspan="1"| Client<br />
| Keep Alive ID<br />
| VarInt<br />
| <br />
|}<br />
<br />
==== 加入游戏 ====<br />
<br />
See [[Protocol Encryption]] for information on logging in.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="7"| 0x01<br />
|rowspan="7"| Play<br />
|rowspan="7"| Client<br />
| Entity ID<br />
| Int<br />
| The player's Entity ID (EID)<br />
|-<br />
| Gamemode<br />
| Unsigned Byte<br />
| 0: Survival, 1: Creative, 2: Adventure, 3: Spectator. Bit 3 (0x8) is the hardcore flag.<br />
|-<br />
| Dimension<br />
| Byte<br />
| -1: Nether, 0: Overworld, 1: End<br />
|-<br />
| Difficulty<br />
| Unsigned Byte<br />
| 0: peaceful, 1: easy, 2: normal, 3: hard<br />
|-<br />
| Max Players<br />
| Unsigned Byte<br />
| Used by the client to draw the player list<br />
|-<br />
| Level Type<br />
| String<br />
| default, flat, largeBiomes, amplified, default_1_1<br />
|-<br />
| Reduced Debug Info<br />
| Boolean<br />
| If true, a Notchian client shows reduced information on the {{Minecraft Wiki|debug screen}}.<br />
|}<br />
<br />
{{Warning|如果位置无效，服务端将崩溃}}<br />
<br />
==== 聊天内容 ==== <br />
<br />
Identifying the difference between Chat/System Message is important as it helps respect the user's chat visibility options. While Position 2 accepts json formatting it will not display, old style formatting works<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="2"| 0x02<br />
|rowspan="2"| Play<br />
|rowspan="2"| Client<br />
| JSON Data<br />
| [[Chat]]<br />
| Limited to 32767 bytes<br />
|-<br />
| Position<br />
| Byte<br />
| 0: chat (chat box), 1: system message (chat box), 2: above action bar<br />
|}<br />
<br />
{{Warning|错误的JSON将断开连接}}<br />
<br />
==== 时间更新 ====<br />
<br />
Time is based on ticks, where 20 ticks happen every second. There are 24000 ticks in a day, making Minecraft days exactly 20 minutes long.<br />
<br />
The time of day is based on the timestamp modulo 24000. 0 is sunrise, 6000 is noon, 12000 is sunset, and 18000 is midnight.<br />
<br />
The default SMP server increments the time by <code>20</code> every second.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="2"| 0x03<br />
|rowspan="2"| Play<br />
|rowspan="2"| Client<br />
| World Age<br />
| Long<br />
| In ticks; not changed by server commands<br />
|-<br />
| Time of day<br />
| Long<br />
| The world (or region) time, in ticks. If negative the sun will stop moving at the Math.abs of the time<br />
|}<br />
<br />
==== 持有的物品 ====<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="3"| 0x04<br />
|rowspan="3"| Play<br />
|rowspan="3"| Client<br />
| Entity ID<br />
| VarInt<br />
| Entity's EID<br />
|-<br />
| Slot<br />
| Short<br />
| Equipment slot. 0: held, 1–4: armor slot (1: boots, 2: leggings, 3: chestplate, 4: helmet)<br />
|-<br />
| Item<br />
| [[Slot Data|Slot]]<br />
| Item in slot format<br />
|}<br />
<br />
==== 出生姿势 ====<br />
<br />
Sent by the server after login to specify the coordinates of the spawn point (the point at which players spawn at, and which the compass points to). It can be sent at any time to update the point compasses point at.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="1"| 0x05<br />
|rowspan="1"| Play<br />
|rowspan="1"| Client<br />
| Location<br />
| Position<br />
| Spawn location<br />
|}<br />
<br />
==== 更新生命值 ====<br />
<br />
Sent by the server to update/set the health of the player it is sent to.<br />
<br />
Food {{Minecraft Wiki|Food#Hunger vs. Saturation|saturation}} acts as a food “overcharge”. Food values will not decrease while the saturation is over zero. Players logging in automatically get a saturation of 5.0. Eating food increases the saturation as well as the food bar.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="3"| 0x06<br />
|rowspan="3"| Play<br />
|rowspan="3"| Client<br />
| Health<br />
| Float<br />
| 0 or less = dead, 20 = full HP<br />
|-<br />
| Food<br />
| VarInt<br />
| 0–20<br />
|- <br />
| Food Saturation<br />
| Float<br />
| Seems to vary from 0.0 to 5.0 in integer increments<br />
|}<br />
<br />
==== 重生 ====<br />
<br />
来改变玩家的位置(主世界/地狱/末地), 发送给他们一个重生指令, 其次是prechunks或chunks的新位置, and finally a position and look packet. You do not need to unload chunks, the client will do it automatically.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="4"| 0x07<br />
|rowspan="4"| Play<br />
|rowspan="4"| Client<br />
| Dimension<br />
| Int<br />
| -1: The Nether, 0: The Overworld, 1: The End<br />
|-<br />
| Difficulty<br />
| Unsigned Byte<br />
| 0: Peaceful, 1: Easy, 2: Normal, 3: Hard<br />
|-<br />
| Gamemode<br />
| Unsigned Byte<br />
| 0: survival, 1: creative, 2: adventure. The hardcore flag is not included<br />
|-<br />
| Level Type<br />
| String<br />
| Same as [[#Join Game|Join Game]]<br />
|}<br />
<br />
{{Warning|如果位置无效，服务端将崩溃 }}<br />
<br />
{{Warning|如果玩家出现在了相同的位置, weird bugs can occur i.e. such player will be unable to attack other players in new world (修复后他们将重生)}}<br />
<br />
==== 玩家姿势以及看的方向 ==== <br />
<br />
Updates the player's position on the server.<br />
<br />
If the distance between the last known position of the player on the server and the new position set by this packet is greater than 100 meters, the client will be kicked for “You moved too quickly :( (Hacking?)”.<br />
<br />
Also if the fixed-point number of X or Z is set greater than <code>3.2E7D</code> the client will be kicked for “Illegal position”.<br />
<br />
Yaw is measured in degrees, and does not follow classical trigonometry rules. The unit circle of yaw on the XZ-plane starts at (0, 1) and turns counterclockwise, with 90 at (-1, 0), 180 at (0, -1) and 270 at (1, 0). Additionally, yaw is not clamped to between 0 and 360 degrees; any number is valid, including negative numbers and numbers greater than 360.<br />
<br />
Pitch is measured in degrees, where 0 is looking straight ahead, -90 is looking straight up, and 90 is looking straight down.<br />
<br />
The yaw in degrees of a player standing at point (x0, z0) and looking towards point (x, z) can be calculated with:<br />
<br />
l = x-x0<br />
w = z-z0<br />
c = sqrt( l*l + w*w )<br />
alpha1 = -arcsin(l/c)/PI*180<br />
alpha2 = arccos(w/c)/PI*180<br />
if alpha2 > 90 then<br />
yaw = 180 - alpha1<br />
else<br />
yaw = alpha1<br />
<br />
You can get a unit vector from a given yaw/pitch via:<br />
<br />
x = -cos(pitch) * sin(yaw)<br />
y = -sin(pitch)<br />
z = cos(pitch) * cos(yaw)<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="6"| 0x08<br />
|rowspan="6"| Play<br />
|rowspan="6"| Client<br />
| X<br />
| Double<br />
| Absolute or relative position, depending on Flags<br />
|-<br />
| Y<br />
| Double<br />
| Absolute or relative position, depending on Flags<br />
|-<br />
| Z<br />
| Double<br />
| Absolute or relative position, depending on Flags<br />
|-<br />
| Yaw<br />
| Float<br />
| Absolute or relative rotation on the X Axis, in degrees<br />
|-<br />
| Pitch<br />
| Float<br />
| Absolute or relative rotation on the Y Axis, in degrees<br />
|-<br />
| Flags<br />
| Byte<br />
| Bit field, see below<br />
|}<br />
<br />
About the Flags field:<br />
<br />
<Dinnerbone> It's a bitfield, X/Y/Z/Y_ROT/X_ROT. If X is set, the x value is relative and not absolute.<br />
<br />
{| class="wikitable"<br />
|-<br />
! Field<br />
! Bit<br />
|-<br />
| X<br />
| 0x01<br />
|-<br />
| Y<br />
| 0x02<br />
|-<br />
| Z<br />
| 0x04<br />
|-<br />
| Y_ROT<br />
| 0x08<br />
|-<br />
| X_ROT<br />
| 0x10<br />
|}<br />
<br />
==== 持有物品变更 ====<br />
<br />
Sent to change the player's slot selection.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="1"| 0x09<br />
|rowspan="1"| Play<br />
|rowspan="1"| Client<br />
| Slot<br />
| Byte<br />
| The slot which the player has selected (0–8)<br />
|}<br />
<br />
==== 使用床 ==== <br />
<br />
This packet tells that a player goes to bed.<br />
<br />
The client with the matching Entity ID will go into bed mode.<br />
<br />
This Packet is sent to all nearby players including the one sent to bed.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="2"| 0x0A<br />
|rowspan="2"| Play<br />
|rowspan="2"| Client<br />
| Entity ID<br />
| VarInt<br />
| Sleeping player's EID<br />
|-<br />
| Location<br />
| Position<br />
| Block location of the head part of the bed<br />
|}<br />
<br />
==== 动画 ====<br />
<br />
Sent whenever an entity should change animation.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="2"| 0x0B<br />
|rowspan="2"| Play<br />
|rowspan="2"| Client<br />
| Entity ID<br />
| VarInt<br />
| Player ID<br />
|-<br />
| Animation<br />
| Unsigned Byte<br />
| Animation ID (see below)<br />
|}<br />
<br />
Animation can be one of the following values:<br />
<br />
{| class="wikitable"<br />
! ID<br />
! Animation<br />
|-<br />
| 0<br />
| Swing arm<br />
|-<br />
| 1<br />
| Take damage<br />
|-<br />
| 2<br />
| Leave bed<br />
|-<br />
| 3<br />
| Eat food<br />
|-<br />
| 4<br />
| Critical effect<br />
|-<br />
| 5<br />
| Magic critical effect<br />
|}<br />
<br />
==== 生成玩家 ====<br />
<br />
This packet is sent by the server when a player comes into visible range, ''not'' when a player joins.<br />
<br />
This packet must be sent after the [[#Player List Item|Player List Item]] ([[#Play|Play]], 0x38, clientbound) packet that adds the player data for the client to use when spawning a player. If the tab list entry for the UUID included in this packet is not present when this packet arrives, the entity will not be spawned. The tab includes skin/cape data.<br />
<br />
Servers can, however, safely spawn player entities for players not in visible range. The client appears to handle it correctly.<br />
<br />
When in online-mode the UUIDs must be valid and have valid skin blobs, in offline-mode UUID v3 is used.<br />
<br />
For NPCs UUID v2 should be used. Note:<br />
<br />
<+Grum> i will never confirm this as a feature you know that :)<br />
<br />
In an example UUID, <code>xxxxxxxx-xxxx-Yxxx-xxxx-xxxxxxxxxxxx</code>, the UUID version is specified by <code>Y</code>. So, for UUID v3, <code>Y</code> will always be <code>3</code>, and for UUID v2, <code>Y</code> will always be <code>2</code>.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="9"| 0x0C<br />
|rowspan="9"| Play<br />
|rowspan="9"| Client<br />
| Entity ID<br />
| VarInt<br />
| Player's EID<br />
|-<br />
| Player UUID<br />
| UUID<br />
| <br />
|-<br />
| X<br />
| Int<br />
| Player X as a [[Data Types#Fixed-point numbers|Fixed-Point number]]<br />
|-<br />
| Y<br />
| Int<br />
| Player Y as a [[Data Types#Fixed-point numbers|Fixed-Point number]]<br />
|-<br />
| Z<br />
| Int<br />
| Player Z as a [[Data Types#Fixed-point numbers|Fixed-Point number]]<br />
|-<br />
| Yaw<br />
| Angle<br />
| <br />
|-<br />
| Pitch<br />
| Angle<br />
| <br />
|-<br />
| Current Item<br />
| Short<br />
| The item the player is currently holding. Note that this should be 0 for “no item”, unlike -1 used in other packets.<br />
|-<br />
| Metadata<br />
| [[Entities#Entity Metadata Format|Metadata]]<br />
| <br />
|}<br />
<br />
{{Warning|A negative Current Item crashes clients}}<br />
<br />
{{Warning|The client will crash if no Metadata is sent}}<br />
<br />
==== 拾起物品 ====<br />
<br />
Sent by the server when someone picks up an item lying on the ground — its sole purpose appears to be the animation of the item flying towards you. It doesn't destroy the entity in the client memory, and it doesn't add it to your inventory. The server only checks for items to be picked up after each [[#Player Position|Player Position]] (and [[#Player Position And Look|Player Position And Look]]) packet sent by the client.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="2"| 0x0D<br />
|rowspan="2"| Play<br />
|rowspan="2"| Client<br />
| Collected Entity ID<br />
| VarInt<br />
| <br />
|- <br />
| Collector Entity ID<br />
| VarInt<br />
| <br />
|}<br />
<br />
==== 生成对象 ====<br />
<br />
Sent by the server when an Object/Vehicle is created.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="8"| 0x0E<br />
|rowspan="8"| Play<br />
|rowspan="8"| Client<br />
| Entity ID <br />
| VarInt<br />
| EID of the object<br />
|-<br />
| Type<br />
| Byte<br />
| The type of object (See [[Entities#Objects|Objects]])<br />
|-<br />
| X<br />
| Int<br />
| X position as a [[Data Types#Fixed-point numbers|Fixed-Point number]]<br />
|-<br />
| Y<br />
| Int<br />
| Y position as a [[Data Types#Fixed-point numbers|Fixed-Point number]]<br />
|-<br />
| Z<br />
| Int<br />
| Z position as a [[Data Types#Fixed-point numbers|Fixed-Point number]]<br />
|-<br />
| Pitch<br />
| Angle<br />
| <br />
|-<br />
| Yaw<br />
| Angle<br />
| <br />
|-<br />
| Data<br />
| [[Object Data]]<br />
| <br />
|}<br />
<br />
==== 生成怪物 ====<br />
<br />
Sent by the server when a Mob Entity is Spawned<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="12"| 0x0F<br />
|rowspan="12"| Play<br />
|rowspan="12"| Client<br />
| Entity ID<br />
| VarInt<br />
| <br />
|-<br />
| Type<br />
| Unsigned Byte<br />
| The type of mob. See [[Entities#Mobs|Mobs]]<br />
|-<br />
| X<br />
| Int<br />
| X position as a [[Data Types#Fixed-point numbers|Fixed-Point number]] <br />
|-<br />
| Y<br />
| Int<br />
| Y position as a [[Data Types#Fixed-point numbers|Fixed-Point number]] <br />
|-<br />
| Z<br />
| Int<br />
| Z position as a [[Data Types#Fixed-point numbers|Fixed-Point number]] <br />
|-<br />
| Yaw<br />
| Angle<br />
| <br />
|-<br />
| Pitch<br />
| Angle<br />
| <br />
|-<br />
| Head Pitch<br />
| Angle<br />
| <br />
|-<br />
| Velocity X<br />
| Short<br />
| Same units as [[#Entity Velocity|Entity Velocity]]<br />
|-<br />
| Velocity Y<br />
| Short<br />
| Same units as [[#Entity Velocity|Entity Velocity]]<br />
|-<br />
| Velocity Z<br />
| Short<br />
| Same units as [[#Entity Velocity|Entity Velocity]]<br />
|-<br />
| Metadata<br />
| [[Entities#Entity Metadata Format|Metadata]]<br />
| <br />
|}<br />
<br />
==== 重生绘图 ====<br />
<br />
This packet shows location, name, and type of painting.<br />
<br />
Calculating the center of an image: given a (width x height) grid of cells, with (0, 0) being the top left corner, the center is (max(0, width / 2 - 1), height / 2). E.g.<br />
<br />
2x1 (1, 0)<br />
4x4 (1, 2)<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="4"| 0x10<br />
|rowspan="4"| Play<br />
|rowspan="4"| Client<br />
| Entity ID<br />
| VarInt<br />
| <br />
|-<br />
| Title<br />
| String<br />
| Name of the painting. Max length 13<br />
|-<br />
| Location<br />
| Position<br />
| Center coordinates<br />
|-<br />
| Direction<br />
| Unsigned Byte<br />
| Direction the painting faces. 0: north (-z), 1: west (-x), 2: south (+z), 3: east (+x)<br />
|}<br />
<br />
==== 重生掉落经验 ====<br />
<br />
Spawns one or more experience orbs.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="5"| 0x11<br />
|rowspan="5"| Play<br />
|rowspan="5"| Client<br />
| Entity ID<br />
| VarInt<br />
| Entity's ID<br />
|-<br />
| X<br />
| Int<br />
| X position as a [[Data Types#Fixed-point numbers|Fixed-Point number]]<br />
|-<br />
| Y<br />
| Int<br />
| Y position as a [[Data Types#Fixed-point numbers|Fixed-Point number]]<br />
|-<br />
| Z<br />
| Int<br />
| Z position as a [[Data Types#Fixed-point numbers|Fixed-Point number]]<br />
|-<br />
| Count<br />
| Short<br />
| The amount of experience this orb will reward once collected<br />
|}<br />
<br />
==== 实体速率 ====<br />
<br />
Velocity is believed to be in units of 1/8000 of a block per server tick (50ms); for example, -1343 would move (-1343 / 8000) = −0.167875 blocks per tick (or −3,3575 blocks per second).<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="4"| 0x12<br />
|rowspan="4"| Play<br />
|rowspan="4"| Client<br />
| Entity ID<br />
| VarInt<br />
| <br />
|-<br />
| Velocity X<br />
| Short<br />
| Velocity on the X axis<br />
|-<br />
| Velocity Y<br />
| Short<br />
| Velocity on the Y axis<br />
|-<br />
| Velocity Z<br />
| Short<br />
| Velocity on the Z axis<br />
|}<br />
<br />
==== 销毁实体 ====<br />
<br />
Sent by the server when a list of entities is to be destroyed on the client.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="2"| 0x13<br />
|rowspan="2"| Play<br />
|rowspan="2"| Client<br />
| Count<br />
| VarInt<br />
| Number of elements in the following array<br />
|-<br />
| Entity IDs<br />
| Array of VarInt<br />
| The list of entities of destroy<br />
|}<br />
<br />
==== 实体 ====<br />
<br />
This packet may be used to initialize an entity.<br />
<br />
For player entities, either this packet or any move/look packet is sent every game tick. So the meaning of this packet is basically that the entity did not move/look since the last such packet.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="1"| 0x14<br />
|rowspan="1"| Play<br />
|rowspan="1"| Client<br />
| Entity ID<br />
| VarInt<br />
| <br />
|}<br />
<br />
==== 实体相对移动 ====<br />
<br />
This packet is sent by the server when an entity moves less then 4 blocks; if an entity moves more than 4 blocks [[#Entity Teleport|Entity Teleport]] should be sent instead.<br />
<br />
This packet allows at most four blocks movement in any direction, because byte range is from -128 to 127.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="5"| 0x15<br />
|rowspan="5"| Play<br />
|rowspan="5"| Client<br />
| Entity ID<br />
| VarInt<br />
| <br />
|-<br />
| Delta X<br />
| Byte<br />
| Change in X position as a [[Data Types#Fixed-point numbers|Fixed-Point number]]<br />
|-<br />
| Delta Y<br />
| Byte<br />
| Change in Y position as a [[Data Types#Fixed-point numbers|Fixed-Point number]]<br />
|-<br />
| Delta Z<br />
| Byte<br />
| Change in Z position as a [[Data Types#Fixed-point numbers|Fixed-Point number]]<br />
|-<br />
| On Ground<br />
| Boolean<br />
| <br />
|}<br />
<br />
==== 实体朝向 ====<br />
<br />
This packet is sent by the server when an entity rotates.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="5"| 0x16<br />
|rowspan="5"| Play<br />
|rowspan="5"| Client<br />
| Entity ID<br />
| VarInt<br />
| <br />
|-<br />
| Yaw<br />
| Angle<br />
| New angle, not a delta<br />
|-<br />
| Pitch<br />
| Angle<br />
| New angle, not a delta<br />
|-<br />
| On Ground<br />
| Boolean<br />
| <br />
|}<br />
<br />
==== 实体朝向与相对移动 ====<br />
<br />
This packet is sent by the server when an entity rotates and moves. Since a byte range is limited from -128 to 127, and movement is offset of fixed-point numbers, this packet allows at most four blocks movement in any direction. (-128/32 == -4)<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="7"| 0x17<br />
|rowspan="7"| Play<br />
|rowspan="7"| Client<br />
| Entity ID<br />
| VarInt<br />
| <br />
|-<br />
| Delta X<br />
| Byte<br />
| Change in X position as a [[Data Types#Fixed-point numbers|Fixed-Point number]]<br />
|-<br />
| Delta Y<br />
| Byte<br />
| Change in Y position as a [[Data Types#Fixed-point numbers|Fixed-Point number]]<br />
|-<br />
| Delta Z<br />
| Byte<br />
| Change in Z position as a [[Data Types#Fixed-point numbers|Fixed-Point number]]<br />
|-<br />
| Yaw<br />
| Angle<br />
| New angle, not a delta<br />
|-<br />
| Pitch<br />
| Angle<br />
| New angle, not a delta<br />
|-<br />
| On Ground<br />
| Boolean<br />
| <br />
|}<br />
<br />
==== 实体传送 ====<br />
<br />
This packet is sent by the server when an entity moves more than 4 blocks.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="7"| 0x18<br />
|rowspan="7"| Play<br />
|rowspan="7"| Client<br />
| Entity ID<br />
| VarInt<br />
| <br />
|-<br />
| X<br />
| Int<br />
| X position as a [[Data Types#Fixed-point numbers|Fixed-Point number]]<br />
|-<br />
| Y<br />
| Int<br />
| Y position as a [[Data Types#Fixed-point numbers|Fixed-Point number]]<br />
|-<br />
| Z<br />
| Int<br />
| Z position as a [[Data Types#Fixed-point numbers|Fixed-Point number]]<br />
|-<br />
| Yaw<br />
| Angle<br />
| New angle, not a delta<br />
|-<br />
| Pitch<br />
| Angle<br />
| New angle, not a delta<br />
|-<br />
| On Ground<br />
| Boolean<br />
| <br />
|}<br />
<br />
==== 实体手朝向 ====<br />
<br />
Changes the direction an entity's head is facing.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="2"| 0x19<br />
|rowspan="2"| Play<br />
|rowspan="2"| Client<br />
| Entity ID<br />
| VarInt<br />
| <br />
|-<br />
| Head Yaw<br />
| Angle<br />
| New angle, not a delta<br />
|}<br />
<br />
==== 实体状态 ====<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="2"| 0x1A<br />
|rowspan="2"| Play<br />
|rowspan="2"| Client<br />
| Entity ID<br />
| Int<br />
| <br />
|-<br />
| Entity Status<br />
| Byte<br />
| See below<br />
|}<br />
<br />
{| class="wikitable"<br />
|-<br />
! Entity Status<br />
! Meaning<br />
|-<br />
| 1<br />
| Sent when resetting a mob spawn minecart's timer - appears to be unused by the client<br />
|-<br />
| 2<br />
| Living Entity hurt <br />
|-<br />
| 3<br />
| Living Entity dead<br />
|-<br />
| 4<br />
| Iron Golem throwing up arms<br />
|-<br />
| 6<br />
| Wolf/Ocelot/Horse taming — Spawn “heart” particles<br />
|-<br />
| 7<br />
| Wolf/Ocelot/Horse tamed — Spawn “smoke” particles<br />
|-<br />
| 8<br />
| Wolf shaking water — Trigger the shaking animation<br />
|-<br />
| 9<br />
| (of self) Eating accepted by server<br />
|-<br />
| 10<br />
| Sheep eating grass<br />
|-<br />
| 10<br />
| Play TNT ignite sound<br />
|-<br />
| 11<br />
| Iron Golem handing over a rose<br />
|-<br />
| 12<br />
| Villager mating — Spawn “heart” particles<br />
|-<br />
| 13<br />
| Spawn particles indicating that a villager is angry and seeking revenge<br />
|-<br />
| 14<br />
| Spawn happy particles near a villager<br />
|-<br />
| 15<br />
| Witch animation — Spawn “magic” particles<br />
|-<br />
| 16<br />
| Play zombie converting into a villager sound<br />
|-<br />
| 17<br />
| Firework exploding<br />
|-<br />
| 18<br />
| Animal in love (ready to mate) — Spawn “heart” particles<br />
|-<br />
| 19<br />
| Reset squid rotation<br />
|-<br />
| 20<br />
| Spawn explosion particle — works for some living entities<br />
|-<br />
| 21<br />
| Play guardian sound — works for every entity<br />
|-<br />
| 22<br />
| Enables reduced debug for players<br />
|-<br />
| 23<br />
| Disables reduced debug for players<br />
|}<br />
<br />
==== 附加实体 ====<br />
<br />
This packet is sent when a player has been attached to an entity (e.g. Minecart).<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="3"| 0x1B<br />
|rowspan="3"| Play<br />
|rowspan="3"| Client<br />
| Entity ID<br />
| Int<br />
| Attached entity's EID. Set to -1 to detach.<br />
|-<br />
| Vehicle ID<br />
| Int<br />
| Vechicle's Entity ID<br />
|-<br />
| Leash<br />
| Boolean<br />
| If true leashes the entity to the vehicle<br />
|}<br />
<br />
==== 实体数据值 ====<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="2"| 0x1C<br />
|rowspan="2"| Play<br />
|rowspan="2"| Client<br />
| Entity ID<br />
| VarInt<br />
| <br />
|-<br />
| Metadata<br />
| [[Entities#Entity Metadata Format|Metadata]]<br />
| <br />
|}<br />
<br />
==== 实体属性 ====<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="5"| 0x1D<br />
|rowspan="5"| Play<br />
|rowspan="5"| Client<br />
| Entity ID<br />
| VarInt<br />
| <br />
|-<br />
| Effect ID<br />
| Byte<br />
| See {{Minecraft Wiki|Status effect#List of effects|this table}}<br />
|-<br />
| Amplifier<br />
| Byte<br />
| Notchian client displays effect level as Amplifier + 1<br />
|-<br />
| Duration<br />
| VarInt<br />
| Seconds<br />
|-<br />
| Hide Particles<br />
| Boolean<br />
| <br />
|}<br />
<br />
==== 移除实体属性 ====<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="2"| 0x1E<br />
|rowspan="2"| Play<br />
|rowspan="2"| Client<br />
| Entity ID<br />
| VarInt<br />
| <br />
|-<br />
| Effect ID<br />
| Byte<br />
| See {{Minecraft Wiki|Status effect#List of effects|this table}}<br />
|}<br />
<br />
==== 设置经验值 ====<br />
<br />
Sent by the server when the client should change experience levels.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="3"| 0x1F<br />
|rowspan="3"| Play<br />
|rowspan="3"| Client<br />
| Experience bar<br />
| Float<br />
| Between 0 and 1<br />
|-<br />
| Level<br />
| VarInt<br />
| <br />
|-<br />
| Total Experience<br />
| VarInt<br />
| See {{Minecraft Wiki|Experience#Leveling up}} on the Minecraft Wiki for Total Experience to Level conversion<br />
|}<br />
<br />
==== 实体配置 ====<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
!colspan="2"| Field Name<br />
!colspan="2"| Field Type<br />
! Notes<br />
|-<br />
|rowspan="6"| 0x20<br />
|rowspan="6"| Play<br />
|rowspan="6"| Client<br />
|colspan="2"| Entity ID<br />
|colspan="2"| VarInt<br />
| <br />
|-<br />
|colspan="2"| Number Of Properties<br />
|colspan="2"| Int<br />
| Number of elements in the following array<br />
|-<br />
|rowspan="4"| Property<br />
| Key<br />
|rowspan="4"| Array<br />
| String<br />
| See below<br />
|-<br />
| Value<br />
| Double<br />
| See below<br />
|-<br />
| Number Of Modifiers<br />
| VarInt<br />
| Number of elements in the following array<br />
|-<br />
| Modifiers<br />
| Array of Modifier Data<br />
| See {{Minecraft Wiki|Attribute#Modifiers}}<br />
|}<br />
<br />
Known Key values:<br />
<br />
{| class="wikitable"<br />
|-<br />
! Key<br />
! Default<br />
! Min<br />
! Max<br />
! Label<br />
|-<br />
| generic.maxHealth<br />
| 20.0<br />
| 0.0<br />
| Double.MaxValue<br />
| Max Health<br />
|-<br />
| generic.followRange<br />
| 32.0<br />
| 0.0<br />
| 2048.0<br />
| Follow Range<br />
|-<br />
| generic.knockbackResistance<br />
| 0.0 <br />
| 0.0<br />
| 1.0<br />
| Knockback Resistance<br />
|-<br />
| generic.movementSpeed<br />
| 0.699999988079071<br />
| 0.0<br />
| Double.MaxValue<br />
| Movement Speed<br />
|-<br />
| generic.attackDamage<br />
| 2.0<br />
| 0.0<br />
| Double.MaxValue<br />
| <br />
|-<br />
| horse.jumpStrength<br />
| 0.7<br />
| 0.0<br />
| 2.0<br />
| Jump Strength<br />
|-<br />
| zombie.spawnReinforcements<br />
| 0.0<br />
| 0.0<br />
| 1.0<br />
| Spawn Reinforcements Chance<br />
|}<br />
<br />
''Modifier Data'' structure:<br />
<br />
{| class="wikitable"<br />
|-<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
| UUID<br />
| UUID<br />
| <br />
|-<br />
| Amount<br />
| Double<br />
| <br />
|-<br />
| Operation<br />
| Byte<br />
| <br />
|}<br />
<br />
==== 区块数据 ====<br />
<br />
Chunks are not unloaded by the client automatically. To unload chunks, send this packet with Ground-Up Continuous=true and no 16^3 chunks (eg. Primary Bit Mask=0). The server does not send skylight information for nether-chunks, it's up to the client to know if the player is currently in the nether. You can also infer this information from the primary bitmask and the amount of uncompressed bytes sent.<br />
<br />
See also: [[SMP Map Format]]<br />
<br />
Changes in 1.8:<br />
<br />
* Data value section removed<br />
* Extended id section removed<br />
* Block id section is now a unsigned short (little endian) per a block<br />
* The block id is equal to <code>(id << 4) | data</code><br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="6"| 0x21<br />
|rowspan="6"| Play<br />
|rowspan="6"| Client<br />
| Chunk X<br />
| Int<br />
| Chunk X coordinate<br />
|-<br />
| Chunk Z<br />
| Int<br />
| Chunk Z coordinate<br />
|-<br />
| Ground-Up Continuous<br />
| Boolean<br />
| This is true if the packet represents all sections in this vertical column, where the Primary Bit Mask specifies exactly which sections are included, and which are air<br />
|-<br />
| Primary Bit Mask<br />
| Unsigned Short<br />
| Bitmask with 1 for every 16x16x16 section whose data follows in the compressed data<br />
|- <br />
| Size<br />
| VarInt<br />
| Size of Data<br />
|-<br />
| Data<br />
| [[SMP Map Format#Data|Chunk]]<br />
| <br />
|}<br />
<br />
==== 多个方块改变 ====<br />
Fired whenever 2 or more blocks are changed within the render distance.<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
!colspan="2"| Field Name<br />
!colspan="2"| Field Type<br />
! Notes<br />
|-<br />
|rowspan="6"| 0x22<br />
|rowspan="6"| Play<br />
|rowspan="6"| Client<br />
|colspan="2"| Chunk X<br />
|colspan="2"| Int<br />
| Chunk X coordinate<br />
|-<br />
|colspan="2"| Chunk Z<br />
|colspan="2"| Int<br />
| Chunk Z coordinate<br />
|-<br />
|colspan="2"| Record Count<br />
|colspan="2"| VarInt<br />
| Number of elements in the following array, a.k.a. the number of blocks affected<br />
|-<br />
|rowspan="3"| Record<br />
| Horizontal Position<br />
|rowspan="3"| Array<br />
| Unsigned Byte<br />
| The 4 most significant bits (<code>0xF0</code>) encode the X coordinate, relative to the chunk. The 4 least significant bits (<code>0x0F</code>) encode the Z coordinate, relative to the chunk.<br />
|-<br />
| Y Coordinate<br />
| Unsigned Byte<br />
| <br />
|-<br />
| Block ID<br />
| VarInt<br />
| The new block ID for the block. <code><nowiki>id &lt;&lt; 4 | data</nowiki></code><br />
|}<br />
<br />
==== 方块改变 ====<br />
Fired whenever a block is changed within the render distance.<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="2"| 0x23<br />
|rowspan="2"| Play<br />
|rowspan="2"| Client<br />
| Location<br />
| Position<br />
| Block Coordinates<br />
|-<br />
| Block ID<br />
| VarInt<br />
| The new block ID for the block. <code><nowiki>id &lt;&lt; 4 | data</nowiki></code><br />
|}<br />
<br />
==== 方块功能 ====<br />
<br />
This packet is used for a number of things:<br />
<br />
* Chests opening and closing<br />
* Pistons pushing and pulling<br />
* Note blocks playing<br />
* Updating beacons<br />
<br />
See Also: [[Block Actions]] <br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="4"| 0x24<br />
|rowspan="4"| Play<br />
|rowspan="4"| Client<br />
| Location<br />
| Position<br />
| Block Coordinates<br />
|-<br />
| Byte 1<br />
| Unsigned Byte<br />
| Varies depending on block — see [[Block Actions]]<br />
|-<br />
| Byte 2<br />
| Unsigned Byte<br />
| Varies depending on block — see [[Block Actions]]<br />
|-<br />
| Block Type<br />
| VarInt<br />
| The block type for the block<br />
|}<br />
<br />
==== 方块破坏动画 ====<br />
<br />
0–9 are the displayable destroy stages and each other number means that there is no animation on this coordinate.<br />
<br />
You can also set an animation to air! The animation will still be visible.<br />
<br />
If you need to display several break animations at the same time you have to give each of them a unique Entity ID.<br />
<br />
Also if you set the coordinates to a special block like water etc. it won't show the actual break animation but some other interesting effects. (Water will lose it's transparency)<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="3"| 0x25<br />
|rowspan="3"| Play<br />
|rowspan="3"| Client<br />
| Entity ID<br />
| VarInt<br />
| EID for the animation<br />
|-<br />
| Location<br />
| Position<br />
| Block Position<br />
|-<br />
| Destroy Stage<br />
| Byte<br />
| 0–9 to set it, any other value to remove it<br />
|}<br />
<br />
==== 地图区块 ====<br />
<br />
1.8 changes at [[#Chunk Data|Chunk Data]]<br />
<br />
To reduce the number of bytes, this packet is used to send chunks together for better compression results.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
!colspan="2"| Field Name<br />
!colspan="2"| Field Type<br />
! Notes<br />
|-<br />
|rowspan="7"| 0x26<br />
|rowspan="7"| Play<br />
|rowspan="7"| Client<br />
|colspan="2"| Sky Light Sent<br />
|colspan="2"| Boolean<br />
| Whether or not Chunk Data contains light nibble arrays. This is true in the Overworld, false in the End + Nether<br />
|-<br />
|colspan="2"| Chunk Column Count<br />
|colspan="2"| VarInt<br />
| Number of elements in each of the following arrays<br />
|-<br />
|rowspan="3"| Chunk Meta<br />
| Chunk X<br />
|rowspan="3"| Array<br />
| Int<br />
| The X coordinate of the chunk<br />
|-<br />
| Chunk Z<br />
| Int<br />
| The Z coordinate of the chunk<br />
|-<br />
| Primary Bit Mask<br />
| Unsigned Short<br />
| A bit mask which specifies which sections are not empty in this chunk<br />
|-<br />
|colspan="2"| Chunk Data<br />
|colspan="2"| Array of [[SMP Map Format#Data|Chunk]]<br />
| Each chunk in this array corresponds to the data at the same position in Chunk Meta<br />
|}<br />
<br />
==== 爆炸 ====<br />
<br />
Sent when an explosion occurs (creepers, TNT, and ghast fireballs).<br />
<br />
Each block in Records is set to air. Coordinates for each axis in record is int(X) + record.x<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="9"| 0x27<br />
|rowspan="9"| Play<br />
|rowspan="9"| Client<br />
| X<br />
| Float<br />
| <br />
|-<br />
| Y<br />
| Float<br />
| <br />
|-<br />
| Z<br />
| Float<br />
| <br />
|-<br />
| Radius<br />
| Float<br />
| Currently unused in the client<br />
|-<br />
| Record Count<br />
| Int<br />
| Number of elements in the following array<br />
|-<br />
| Records<br />
| Array of (Byte, Byte, Byte)<br />
| Each record is 3 signed bytes long, each bytes are the XYZ (respectively) offsets of affected blocks.<br />
|-<br />
| Player Motion X<br />
| Float<br />
| X velocity of the player being pushed by the explosion<br />
|-<br />
| Player Motion Y<br />
| Float<br />
| Y velocity of the player being pushed by the explosion<br />
|-<br />
| Player Motion Z<br />
| Float<br />
| Z velocity of the player being pushed by the explosion<br />
|}<br />
<br />
==== 属性 ====<br />
<br />
Sent when a client is to play a sound or particle effect.<br />
<br />
By default, the Minecraft client adjusts the volume of sound effects based on distance. The final boolean field is used to disable this, and instead the effect is played from 2 blocks away in the correct direction. Currently this is only used for effect 1013 (mob.wither.spawn), and is ignored for any other value by the client.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="4"| 0x28<br />
|rowspan="4"| Play<br />
|rowspan="4"| Client<br />
| Effect ID<br />
| Int<br />
| The ID of the effect, see below<br />
|-<br />
| Location<br />
| Position<br />
| The location of the effect<br />
|-<br />
| Data<br />
| Int<br />
| Extra data for certain effects, see below<br />
|-<br />
| Disable Relative Volume<br />
| Boolean<br />
| See above<br />
|}<br />
<br />
Effect IDs:<br />
<br />
{| class="wikitable"<br />
! ID<br />
! Name<br />
! Data<br />
|-<br />
!colspan="3"| Sound<br />
|-<br />
| 1000<br />
| <code>random.click</code><br />
| <br />
|-<br />
| 1001<br />
| <code>random.click</code><br />
| <br />
|-<br />
| 1002<br />
| <code>random.bow</code><br />
| <br />
|-<br />
| 1003<br />
| <code>random.door_open</code> or <code>random.door_close</code> (50/50 chance)<br />
| <br />
|-<br />
| 1004<br />
| <code>random.fizz</code><br />
| <br />
|-<br />
| 1005<br />
| Play a music disc.<br />
| {{Minecraft Wiki|Music Discs|Record ID}}<br />
|-<br />
| 1006<br />
| ''not assigned''<br />
| <br />
|-<br />
| 1007<br />
| <code>mob.ghast.charge</code><br />
| <br />
|-<br />
| 1008<br />
| <code>mob.ghast.fireball</code><br />
| <br />
|-<br />
| 1009<br />
| <code>mob.ghast.fireball</code>, but with a lower volume<br />
| <br />
|-<br />
| 1010<br />
| <code>mob.zombie.wood</code><br />
| <br />
|-<br />
| 1011<br />
| <code>mob.zombie.metal</code><br />
| <br />
|-<br />
| 1012<br />
| <code>mob.zombie.woodbreak</code><br />
| <br />
|-<br />
| 1013<br />
| <code>mob.wither.spawn</code><br />
| <br />
|-<br />
| 1014<br />
| <code>mob.wither.shoot</code><br />
| <br />
|-<br />
| 1015<br />
| <code>mob.bat.takeoff</code><br />
| <br />
|-<br />
| 1016<br />
| <code>mob.zombie.infect</code><br />
| <br />
|-<br />
| 1017<br />
| <code>mob.zombie.unfect</code><br />
| <br />
|-<br />
| 1018<br />
| <code>mob.enderdragon.end</code><br />
| <br />
|-<br />
| 1020<br />
| <code>random.anvil_break</code><br />
| <br />
|-<br />
| 1021<br />
| <code>random.anvil_use</code><br />
| <br />
|-<br />
| 1022<br />
| <code>random.anvil_land</code><br />
| <br />
|-<br />
!colspan="3"| Particle<br />
|-<br />
| 2000<br />
| Spawns 10 smoke particles, e.g. from a fire<br />
| Direction, see below<br />
|-<br />
| 2001<br />
| Block break<br />
| {{Minecraft Wiki|Data values|Block ID}}<br />
|-<br />
| 2002<br />
| Splash potion. Particle effect + glass break sound.<br />
| [http://www.lb-stuff.com/Minecraft/PotionDataValues1.9pre3.txt Potion ID]<br />
|-<br />
| 2003<br />
| Eye of Ender entity break animation — particles and sound<br />
| <br />
|-<br />
| 2004<br />
| Mob spawn particle effect: smoke + flames<br />
| <br />
|-<br />
| 2005<br />
| Spawn “happy villager” effect (green crosses), used for bonemealing vegetation<br />
| <br />
|}<br />
<br />
Smoke directions:<br />
<br />
{| class="wikitable"<br />
! ID<br />
! Direction<br />
|-<br />
| 0<br />
| South-East<br />
|-<br />
| 1<br />
| South<br />
|-<br />
| 2<br />
| South-West<br />
|-<br />
| 3<br />
| East<br />
|-<br />
| 4<br />
| (Up or middle ?)<br />
|-<br />
| 5<br />
| West<br />
|-<br />
| 6<br />
| North-East<br />
|-<br />
| 7<br />
| North<br />
|-<br />
| 8<br />
| North-West<br />
|}<br />
<br />
==== 声音特效 ====<br />
<br />
Used to play a sound effect on the client.<br />
<br />
Custom sounds may be added by resource packs.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="6"| 0x29<br />
|rowspan="6"| Play<br />
|rowspan="6"| Client<br />
| Sound name<br />
| String<br />
| All known sound effect names can be seen [https://github.com/SirCmpwn/Craft.Net/blob/master/source/Craft.Net.Common/SoundEffect.cs here]<br />
|-<br />
| Effect position X<br />
| Int<br />
| Effect X multiplied by 8<br />
|-<br />
| Effect position Y<br />
| Int<br />
| Effect Y multiplied by 8<br />
|-<br />
| Effect position Z<br />
| Int<br />
| Effect Z multiplied by 8<br />
|-<br />
| Volume<br />
| Float<br />
| 1 is 100%, can be more<br />
|-<br />
| Pitch<br />
| Unsigned Byte<br />
| 63 is 100%, can be more<br />
|}<br />
<br />
==== 粒子效果 ====<br />
<br />
Displays the named particle<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="11"| 0x2A<br />
|rowspan="11"| Play<br />
|rowspan="11"| Client<br />
| Particle ID<br />
| Int<br />
| See below<br />
|-<br />
| Long Distance<br />
| Boolean<br />
| If true, particle distance increases from 256 to 65536<br />
|-<br />
| X<br />
| Float<br />
| X position of the particle<br />
|-<br />
| Y<br />
| Float<br />
| Y position of the particle<br />
|-<br />
| Z<br />
| Float<br />
| Z position of the particle<br />
|-<br />
| Offset X<br />
| Float<br />
| This is added to the X position after being multiplied by random.nextGaussian()<br />
|-<br />
| Offset Y<br />
| Float<br />
| This is added to the Y position after being multiplied by random.nextGaussian()<br />
|-<br />
| Offset Z<br />
| Float<br />
| This is added to the Z position after being multiplied by random.nextGaussian()<br />
|-<br />
| Particle Data<br />
| Float<br />
| The data of each particle<br />
|-<br />
| Particle Count<br />
| Int<br />
| The number of particles to create<br />
|-<br />
| Data<br />
| Array of VarInt<br />
| Length depends on particle. "iconcrack" has length of 2, "blockcrack", and "blockdust" have lengths of 1, the rest have 0.<br />
|}<br />
<br />
Particle IDs:<br />
<br />
{| class="wikitable"<br />
|-<br />
! Particle Name<br />
! Particle ID<br />
|-<br />
| explode<br />
| 0<br />
|-<br />
| largeexplosion<br />
| 1<br />
|-<br />
| hugeexplosion<br />
| 2<br />
|-<br />
| fireworksSpark<br />
| 3<br />
|-<br />
| bubble<br />
| 4<br />
|-<br />
| splash<br />
| 5<br />
|-<br />
| wake<br />
| 6<br />
|-<br />
| suspended<br />
| 7<br />
|-<br />
| depthsuspend<br />
| 8<br />
|-<br />
| crit<br />
| 9<br />
|-<br />
| magicCrit<br />
| 10<br />
|-<br />
| smoke<br />
| 11<br />
|-<br />
| largesmoke<br />
| 12<br />
|-<br />
| spell<br />
| 13<br />
|-<br />
| instantSpell<br />
| 14<br />
|-<br />
| mobSpell<br />
| 15<br />
|-<br />
| mobSpellAmbient<br />
| 16<br />
|-<br />
| witchMagic<br />
| 17<br />
|-<br />
| dripWater<br />
| 18<br />
|-<br />
| dripLava<br />
| 19<br />
|-<br />
| angryVillager<br />
| 20<br />
|-<br />
| happyVillager<br />
| 21<br />
|-<br />
| townaura<br />
| 22<br />
|-<br />
| note<br />
| 23<br />
|-<br />
| portal<br />
| 24<br />
|-<br />
| enchantmenttable<br />
| 25<br />
|-<br />
| flame<br />
| 26<br />
|-<br />
| lava<br />
| 27<br />
|-<br />
| footstep<br />
| 28<br />
|-<br />
| cloud<br />
| 29<br />
|-<br />
| reddust<br />
| 30<br />
|-<br />
| snowballpoof<br />
| 31<br />
|-<br />
| snowshovel<br />
| 32<br />
|-<br />
| slime<br />
| 33<br />
|-<br />
| heart<br />
| 34<br />
|-<br />
| barrier<br />
| 35<br />
|-<br />
| iconcrack_(id)_(data)<br />
| 36<br />
|-<br />
| blockcrack_(id+(data<<12))<br />
| 37<br />
|-<br />
| blockdust_(id)<br />
| 38<br />
|-<br />
| droplet<br />
| 39<br />
|-<br />
| take<br />
| 40<br />
|-<br />
| mobappearance<br />
| 41<br />
|}<br />
<br />
==== 改变游戏状态 ====<br />
<br />
It appears when a bed can't be used as a spawn point and when the rain state changes.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="2"| 0x2B<br />
|rowspan="2"| Play<br />
|rowspan="2"| Client<br />
| Reason<br />
| Unsigned Byte<br />
| See below<br />
|-<br />
| Value<br />
| Float<br />
| Depends on Reason<br />
|}<br />
<br />
''Reason codes'':<br />
<br />
{| class="wikitable"<br />
! Reason<br />
! Effect<br />
! Value<br />
|-<br />
| 0<br />
| Invalid Bed<br />
| <br />
|-<br />
| 1<br />
| End raining<br />
| <br />
|-<br />
| 2<br />
| Begin raining<br />
| <br />
|-<br />
| 3<br />
| Change game mode<br />
| 0: Survival, 1: Creative, 2: Adventure, 3: Spectator<br />
|-<br />
| 4<br />
| Enter credits<br />
| <br />
|-<br />
| 5<br />
| Demo message<br />
| 0: Show welcome to demo screen, 101: Tell movement controls, 102: Tell jump control, 103: Tell inventory control<br />
|- <br />
| 6<br />
| Arrow hitting player<br />
| Appears to be played when an arrow strikes another player in Multiplayer<br />
|-<br />
| 7<br />
| Fade value<br />
| The current darkness value. 1 = Dark, 0 = Bright, Setting the value higher causes the game to change color and freeze<br />
|-<br />
| 8<br />
| Fade time<br />
| Time in ticks for the sky to fade<br />
|-<br />
| 10<br />
| Play mob appearance (effect and sound)<br />
| Unknown<br />
|}<br />
<br />
==== 生存全局实体 ====<br />
<br />
With this packet, the server notifies the client of thunderbolts striking within a 512 block radius around the player. The coordinates specify where exactly the thunderbolt strikes.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="5"| 0x2C<br />
|rowspan="5"| Play<br />
|rowspan="5"| Client<br />
| Entity ID<br />
| VarInt<br />
| The EID of the thunderbolt<br />
|-<br />
| Type<br />
| Byte<br />
| The global entity type, currently always 1 for thunderbolt<br />
|-<br />
| X<br />
| Int<br />
| Thunderbolt X, a [[Data Types#Fixed-point numbers|fixed-point number]]<br />
|-<br />
| Y<br />
| Int<br />
| Thunderbolt Y, a [[Data Types#Fixed-point numbers|fixed-point number]]<br />
|-<br />
| Z<br />
| Int<br />
| Thunderbolt Z, a [[Data Types#Fixed-point numbers|fixed-point number]]<br />
|}<br />
<br />
==== 打开窗户 ====<br />
<br />
This is sent to the client when it should open an inventory, such as a chest, workbench, or furnace. This message is not sent anywhere for clients opening their own inventory.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="5"| 0x2D<br />
|rowspan="5"| Play<br />
|rowspan="5"| Client<br />
| Window ID<br />
| Unsigned Byte<br />
| A unique id number for the window to be displayed. Notchian server implementation is a counter, starting at 1.<br />
|-<br />
| Window Type<br />
| String<br />
| The window type to use for display. See [[Inventory]] for a list.<br />
|-<br />
| Window Title<br />
| [[Chat]]<br />
| The title of the window<br />
|-<br />
| Number Of Slots<br />
| Unsigned Byte<br />
| Number of slots in the window (excluding the number of slots in the player inventory)<br />
|-<br />
| Entity ID<br />
| Optional Int<br />
| EntityHorse's EID. Only sent when Window Type is “EntityHorse”<br />
|}<br />
<br />
See [[Inventory]] for further information.<br />
<br />
==== 关闭窗户 ====<br />
<br />
This packet is sent from the server to the client when a window is forcibly closed, such as when a chest is destroyed while it's open.<br />
<br />
Note, notchian clients send a close window packet with Window ID 0 to close their inventory even though there is never an [[#Open Window|Open Window]] packet for inventory. <br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
| 0x2E<br />
|rowspan="1"| Play<br />
|rowspan="1"| Client<br />
| Window ID<br />
| Unsigned Byte<br />
| This is the ID of the window that was closed. 0 for inventory.<br />
|}<br />
<br />
==== 设置位置 ====<br />
<br />
Sent by the server when an item in a slot (in a window) is added/removed.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="3"| 0x2F<br />
|rowspan="3"| Play<br />
|rowspan="3"| Client<br />
| Window ID<br />
| Byte<br />
| The window which is being updated. 0 for player inventory. Note that all known window types include the player inventory. This packet will only be sent for the currently opened window while the player is performing actions, even if it affects the player inventory. After the window is closed, a number of these packets are sent to update the player's inventory window (0).<br />
|-<br />
| Slot<br />
| Short<br />
| The slot that should be updated<br />
|-<br />
| Slot Data<br />
| [[Slot Data|Slot]]<br />
| <br />
|}<br />
<br />
==== 窗口物品 ====<br />
<br />
[[File:Inventory-slots.png|thumb|The inventory slots]]<br />
<br />
Sent by the server when items in multiple slots (in a window) are added/removed. This includes the main inventory, equipped armour and crafting slots.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="3"| 0x30<br />
|rowspan="3"| Play<br />
|rowspan="3"| Client<br />
| Window ID<br />
| Unsigned Byte<br />
| The ID of window which items are being sent for. 0 for player inventory.<br />
|-<br />
| Count<br />
| Short<br />
| Number of elements in the following array<br />
|-<br />
| Slot Data<br />
| Array of [[Slot Data|Slot]]<br />
| <br />
|}<br />
<br />
See [[Inventory#Windows|inventory windows]] for further information about how slots are indexed.<br />
<br />
==== Window Property ====<br />
<br />
This packet is used to inform the client that part of a GUI window should be updated.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="3"| 0x31<br />
|rowspan="3"| Play<br />
|rowspan="3"| Client<br />
| Window ID<br />
| Unsigned Byte<br />
| <br />
|-<br />
| Property<br />
| Short<br />
| The property to be updated, see below<br />
|-<br />
| Value<br />
| Short<br />
| The new value for the property, see below<br />
|}<br />
<br />
The meaning of the Property field depends on the type of the window. The following table shows the known combinations of window type and property, and how the value is to be interpreted.<br />
<br />
{| class="wikitable"<br />
|-<br />
! Window type<br />
! Property<br />
! Value<br />
|-<br />
|rowspan="2"| Furnace<br />
| 0: Progress arrow<br />
| 0–200 (presumably in in-game ticks)<br />
|-<br />
| 1: Fire icon (fuel)<br />
| 0–200 (presumably in in-game ticks)<br />
|-<br />
|rowspan="7"| Enchantment Table<br />
| 0: Level requirement for top enchantment slot<br />
|rowspan="3"| The enchantment's xp level requirement<br />
|-<br />
| 1: Level requirement for middle enchantment slot<br />
|-<br />
| 2: Level requirement for bottom enchantment slot<br />
|-<br />
| 3: The seed for generating the enchantments view for the client<br />
| Unknown<br />
|-<br />
| 4: tooltip shown on mouse hover over top enchantment slot<br />
|rowspan="3"| Unknown (set to -1 to hide it)<br />
|-<br />
| 5: tooltip shown on mouse hover over middle enchantment slot<br />
|-<br />
| 6: tooltip shown on mouse hover over bottom enchantment slot<br />
|-<br />
|rowspan="3"| Beacon<br />
| 0: Power level<br />
| Unknown<br />
|-<br />
| 1: First potion effect<br />
| Unknown<br />
|-<br />
| 2: Second potion effect<br />
| Unknown<br />
|-<br />
| Anvil<br />
| 0: Repair cost<br />
| The repair's cost in xp levels<br />
|-<br />
| Brewing Stand<br />
| 0: Brew time<br />
| 0–400, with 400 making the arrow empty, and 0 making the arrow full<br />
|}<br />
<br />
==== 确认事物 ====<br />
<br />
A packet from the server indicating whether a request from the client was accepted, or whether there was a conflict (due to lag).<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="3"| 0x32<br />
|rowspan="3"| Play<br />
|rowspan="3"| Client<br />
| Window ID<br />
| Byte<br />
| The ID of the window that the action occurred in<br />
|-<br />
| Action Number<br />
| Short<br />
| Every action that is to be accepted has a unique number. This field corresponds to that number.<br />
|-<br />
| Accepted<br />
| Boolean<br />
| Whether the action was accepted<br />
|}<br />
<br />
==== 更新标志 ====<br />
<br />
This message is sent from the server to the client whenever a sign is discovered or created. This message is NOT sent when a sign is destroyed or unloaded.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="5"| 0x33<br />
|rowspan="5"| Play<br />
|rowspan="5"| Client<br />
| Location<br />
| Position<br />
| <br />
|-<br />
| Line 1<br />
| [[Chat]]<br />
| First line of text in the sign<br />
|-<br />
| Line 2<br />
| [[Chat]]<br />
| Second line of text in the sign<br />
|-<br />
| Line 3<br />
| [[Chat]]<br />
| Third line of text in the sign<br />
|-<br />
| Line 4<br />
| [[Chat]]<br />
| Fourth line of text in the sign<br />
|}<br />
<br />
==== 地图 ====<br />
<br />
Updates a rectangular area on a map.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
!colspan="2"| Field Name<br />
!colspan="2"| Field Type<br />
! Notes<br />
|-<br />
|rowspan="12"| 0x34<br />
|rowspan="12"| Play<br />
|rowspan="12"| Client<br />
|colspan="2"| Item Damage<br />
|colspan="2"| VarInt<br />
| The damage value (map ID) of the map being modified<br />
|-<br />
|colspan="2"| Scale<br />
|colspan="2"| Byte<br />
| <br />
|- <br />
|colspan="2"| Icon Count<br />
|colspan="2"| VarInt<br />
| Number of elements in the following array<br />
|-<br />
|rowspan="3"| Icon<br />
| Direction And Type<br />
|rowspan="3"| Array<br />
| Byte<br />
| 0xF0 = Direction, 0x0F = Type<br />
|-<br />
| X<br />
| Byte<br />
| <br />
|-<br />
| Z<br />
| Byte<br />
| <br />
|- <br />
|colspan="2"| Columns<br />
|colspan="2"| Byte<br />
| Number of columns updated<br />
|-<br />
|colspan="2"| Rows<br />
|colspan="2"| Optional Byte<br />
| Only if Columns is more than 0; number of rows updated<br />
|-<br />
|colspan="2"| X<br />
|colspan="2"| Optional Byte<br />
| Only if Columns is more than 0; x offset of the westernmost column<br />
|-<br />
|colspan="2"| Z<br />
|colspan="2"| Optional Byte<br />
| Only if Columns is more than 0; z offset of the northernmost row<br />
|-<br />
|colspan="2"| Length<br />
|colspan="2"| Optional VarInt<br />
| Only if Columns is more than 0; length of the following array<br />
|-<br />
|colspan="2"| Data<br />
|colspan="2"| Optional Array of Unsigned Byte<br />
| Only if Columns is more than 0; see {{Minecraft Wiki|Map item format}}<br />
|}<br />
<br />
==== 更新方块实体 ====<br />
<br />
Essentially a block update on a block entity.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="3"| 0x35<br />
|rowspan="3"| Play<br />
|rowspan="3"| Client<br />
| Location<br />
| Position<br />
| <br />
|-<br />
| Action<br />
| Unsigned Byte<br />
| The type of update to perform, see below<br />
|-<br />
| NBT Data<br />
| Optional [[NBT|NBT Tag]]<br />
| If not present then it's a TAG_END (0)<br />
|}<br />
<br />
''Action'' field:<br />
<br />
* '''1''': Set SpawnPotentials of a mob spawner<br />
* '''2''': Set command block text (command and last execution status)<br />
* '''3''': Set the level, primary, and secondary powers of a beacon<br />
* '''4''': Set rotation and skin of mob head<br />
* '''5''': Set type of flower in flower pot<br />
* '''6''': Set base color and patterns on a banner<br />
<br />
==== 打开标志牌编辑器 ====<br />
<br />
Sent on placement of sign.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="1"| 0x36<br />
|rowspan="1"| Play<br />
|rowspan="1"| Client<br />
| Location<br />
| Position<br />
| <br />
|}<br />
<br />
==== 统计数据 ====<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To <br />
!colspan="2"| Field Name<br />
!colspan="2"| Field Type<br />
! Notes<br />
|-<br />
|rowspan="3"| 0x37<br />
|rowspan="3"| Play<br />
|rowspan="3"| Client<br />
|colspan="2"| Count<br />
|colspan="2"| VarInt<br />
| Number of elements in the following array<br />
|-<br />
|rowspan="2"| Statistic<br />
| Name<br />
|rowspan="2"| Array<br />
| String<br />
| [https://gist.github.com/thinkofdeath/a1842c21a0cf2e1fb5e0 https://gist.github.com/thinkofdeath/a1842c21a0cf2e1fb5e0]<br />
|-<br />
| Value<br />
| VarInt<br />
| The amount to set it to<br />
|}<br />
<br />
==== 玩家列表项 ====<br />
<br />
Sent by the notchian server to update the user list (<tab> in the client).<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
!colspan="4"| Field Name<br />
!colspan="3"| Field Type<br />
! Notes<br />
|-<br />
|rowspan="19"| 0x38<br />
|rowspan="19"| Play<br />
|rowspan="19"| Client<br />
|colspan="4"| Action<br />
|colspan="3"| VarInt<br />
| Determines the rest of the Player format after the UUID<br />
|-<br />
|colspan="4"| Number Of Players<br />
|colspan="3"| VarInt<br />
| Number of elements in the following array<br />
|-<br />
|rowspan="17"| Player<br />
|colspan="3"| UUID<br />
|rowspan="17"| Array<br />
|colspan="2"| UUID<br />
| <br />
|-<br />
! Action<br />
!colspan="2"| Field Name<br />
!colspan="2"| <br />
! <br />
|-<br />
|rowspan="10"| 0: add player<br />
|colspan="2"| Name<br />
|colspan="2"| String<br />
| <br />
|-<br />
|colspan="2"| Number Of Properties<br />
|colspan="2"| VarInt<br />
| Number of elements in the following array<br />
|-<br />
|rowspan="4"| Property<br />
| Name<br />
|rowspan="4"| Array<br />
| String<br />
| <br />
|-<br />
| Value<br />
| String<br />
| <br />
|- <br />
| Is Signed<br />
| Boolean<br />
| <br />
|-<br />
| Signature<br />
| Optional String<br />
| Only if Is Signed is true<br />
|-<br />
|colspan="2"| Gamemode<br />
|colspan="2"| VarInt<br />
| <br />
|-<br />
|colspan="2"| Ping<br />
|colspan="2"| VarInt<br />
| <br />
|-<br />
|colspan="2"| Has Display Name<br />
|colspan="2"| Boolean<br />
| <br />
|-<br />
|colspan="2"| Display Name<br />
|colspan="2"| Optional [[Chat]]<br />
| Only if Has Display Name is true<br />
|-<br />
| 1: update gamemode<br />
|colspan="2"| Gamemode<br />
|colspan="2"| VarInt<br />
| <br />
|- <br />
| 2: update latency<br />
|colspan="2"| Ping<br />
|colspan="2"| VarInt<br />
| <br />
|-<br />
|rowspan="2"| 3: update display name<br />
|colspan="2"| Has Display Name<br />
|colspan="2"| Boolean<br />
| <br />
|-<br />
|colspan="2"| Display Name<br />
|colspan="2"| Optional [[Chat]]<br />
| Only send if Has Display Name is true<br />
|-<br />
| 4: remove player<br />
|colspan="2"| ''no fields''<br />
|colspan="2"| ''no fields''<br />
| <br />
|}<br />
<br />
==== 玩家能力 ====<br />
<br />
The latter 2 floats are used to indicate the walking and flying speeds respectively, while the first byte is used to determine the value of 4 booleans.<br />
<br />
The flags are whether damage is disabled (god mode, 8, bit 3), whether the player can fly (4, bit 2), whether the player is flying (2, bit 1), and whether the player is in creative mode (1, bit 0).<br />
<br />
To get the values of these booleans, simply AND (&) the byte with 1,2,4 and 8 respectively, to get the 0 or 1 bitwise value. To set them OR (|) them with their repspective masks.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="3"| 0x39<br />
|rowspan="3"| Play<br />
|rowspan="3"| Client<br />
| Flags<br />
| Byte<br />
| Bit mask, see above<br />
|-<br />
| Flying Speed<br />
| Float<br />
| <br />
|-<br />
| Walking Speed<br />
| Float<br />
| <br />
|}<br />
<br />
==== Tab补全 ====<br />
<br />
The server responds with a list of auto-completions of the last word sent to it. In the case of regular chat, this is a player username. Command names and parameters are also supported.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="2"| 0x3A<br />
|rowspan="2"| Play<br />
|rowspan="2"| Client<br />
| Count<br />
| VarInt<br />
| Number of elements in the following array<br />
|-<br />
| Matches<br />
| Array of String<br />
| One eligible command, note that each command is sent separately instead of in a single string, hence the need for Count<br />
|}<br />
<br />
==== 计分板目标 ====<br />
<br />
This is sent to the client when it should create a new {{Minecraft Wiki|scoreboard}} objective or remove one.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="4"| 0x3B<br />
|rowspan="4"| Play<br />
|rowspan="4"| Client<br />
| Objective Name<br />
| String<br />
| An unique name for the objective<br />
|-<br />
| Mode<br />
| Byte<br />
| 0 to create the scoreboard. 1 to remove the scoreboard. 2 to update the display text. <br />
|-<br />
| Objective Value<br />
| Optional String<br />
| Only if mode is 0 or 2. The text to be displayed for the score<br />
|-<br />
| Type<br />
| Optional String<br />
| Only if mode is 0 or 2. “integer” or “hearts”<br />
|}<br />
<br />
==== 更新分数 ====<br />
<br />
This is sent to the client when it should update a scoreboard item. <br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="4"| 0x3C<br />
|rowspan="4"| Play<br />
|rowspan="4"| Client<br />
| Score Name<br />
| String<br />
| The name of the score to be updated or removed<br />
|-<br />
| Action<br />
| Byte<br />
| 0 to create/update an item. 1 to remove an item.<br />
|-<br />
| Objective Name<br />
| String<br />
| The name of the objective the score belongs to<br />
|-<br />
| Value<br />
| Optional VarInt<br />
| The score to be displayed next to the entry. Only sent when Action does not equal 1.<br />
|}<br />
<br />
==== 显示计分板 ====<br />
<br />
This is sent to the client when it should display a scoreboard.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="2"| 0x3D<br />
|rowspan="2"| Play<br />
|rowspan="2"| Client<br />
| Position<br />
| Byte<br />
| The position of the scoreboard. 0: list, 1: sidebar, 2: below name.<br />
|-<br />
| Score Name<br />
| String<br />
| The unique name for the scoreboard to be displayed.<br />
|}<br />
<br />
==== 团队 ====<br />
<br />
Creates and updates teams.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="10"| 0x3E<br />
|rowspan="10"| Play<br />
|rowspan="10"| Client<br />
| Team Name<br />
| String<br />
| A unique name for the team. (Shared with scoreboard).<br />
|-<br />
| Mode<br />
| Byte<br />
| If 0 then the team is created.<br />
<br />
If 1 then the team is removed. <br />
<br />
If 2 the team team information is updated. <br />
<br />
If 3 then new players are added to the team. <br />
<br />
If 4 then players are removed from the team.<br />
|-<br />
| Team Display Name<br />
| Optional String<br />
| Only if Mode = 0 or 2.<br />
|-<br />
| Team Prefix<br />
| Optional String<br />
| Only if Mode = 0 or 2. Displayed before the players' name that are part of this team<br />
|-<br />
| Team Suffix<br />
| Optional String<br />
| Only if Mode = 0 or 2. Displayed after the players' name that are part of this team<br />
|-<br />
| Friendly Fire<br />
| Optional Byte<br />
| Only if Mode = 0 or 2. 0 for off, 1 for on, 3 for seeing friendly invisibles<br />
|-<br />
| Name Tag Visibility<br />
| Optional String<br />
| Only if Mode = 0 or 2. always, hideForOtherTeams, hideForOwnTeam, never<br />
|-<br />
| Color<br />
| Optional Byte<br />
| Only if Mode = 0 or 2. Same as [[Chat]] colors<br />
|-<br />
| Player Count<br />
| Optional VarInt<br />
| Only if Mode = 0 or 3 or 4. Number of players in the array<br />
|-<br />
| Players<br />
| Optional Array of String<br />
| Only if Mode = 0 or 3 or 4. Players to be added/remove from the team. Max 40 characters so may be uuid's later<br />
|}<br />
<br />
==== 插件信息 ====<br />
<br />
Mods and plugins can use this to send their data. Minecraft itself uses a number of [[plugin channel]]s. These internal channels are prefixed with <code>MC|</code>.<br />
<br />
More documentation on this: [http://dinnerbone.com/blog/2012/01/13/minecraft-plugin-channels-messaging/ http://dinnerbone.com/blog/2012/01/13/minecraft-plugin-channels-messaging/]<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="2"| 0x3F<br />
|rowspan="2"| Play<br />
|rowspan="2"| Client<br />
| Channel<br />
| String<br />
| Name of the [[plugin channel]] used to send the data<br />
|-<br />
| Data<br />
| Byte Array<br />
| Any data, depending on the channel. <code><nowiki>MC|</nowiki></code> channels are documented [[plugin channel|here]].<br />
|}<br />
<br />
==== 断开连接 ====<br />
<br />
Sent by the server before it disconnects a client. The server assumes that the sender has already closed the connection by the time the packet arrives.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
| 0x40<br />
|rowspan="1"| Play<br />
|rowspan="1"| Client<br />
| Reason<br />
| [[Chat]]<br />
| Displayed to the client when the connection terminates.<br />
|}<br />
<br />
==== 服务器难度 ====<br />
<br />
Changes the difficulty setting in the client's option menu<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="1"| 0x41<br />
|rowspan="1"| Play<br />
|rowspan="1"| Client<br />
| Difficulty<br />
| Unsigned Byte<br />
| 0: peaceful, 1: easy, 2: normal, 3: hard<br />
|}<br />
<br />
==== 战斗事件 ====<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="6"| 0x42<br />
|rowspan="6"| Play<br />
|rowspan="6"| Client<br />
| Event<br />
| VarInt<br />
| 0: enter combat, 1: end combat, 2: entity dead<br />
|-<br />
| Duration<br />
| Optional VarInt<br />
| Only for end combat<br />
|-<br />
| Player ID<br />
| Optional VarInt<br />
| Only for entity dead<br />
|-<br />
| Entity ID<br />
| Optional Int<br />
| Only for end combat and entity dead<br />
|-<br />
| Message<br />
| String<br />
| Only for entity dead<br />
|}<br />
<br />
==== 摄像机 ====<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="1"| 0x43<br />
|rowspan="1"| Play<br />
|rowspan="1"| Client<br />
| Camera ID<br />
| VarInt<br />
| <br />
|}<br />
<br />
==== 世界边界 ==== <br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
!colspan="2"| Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="18"| 0x44<br />
|rowspan="18"| Play<br />
|rowspan="18"| Client<br />
|colspan="2"| Action<br />
| VarInt<br />
| Determines the format of the rest of the packet<br />
|-<br />
! Action<br />
! Field Name<br />
! <br />
! <br />
|-<br />
| 0: set size<br />
| Radius<br />
| Double<br />
| meters<br />
|-<br />
|rowspan="3"| 1: lerp size<br />
| Old Radius<br />
| Double<br />
| meters<br />
|-<br />
| New Radius<br />
| Double<br />
| meters<br />
|-<br />
| Speed<br />
| VarLong<br />
| number of real-time ticks/seconds (?) until New Radius is reached. From experiments, it appears that Notchian server does not sync world border speed to game ticks, so it gets out of sync with server lag<br />
|-<br />
|rowspan="2"| 2: set center<br />
| X<br />
| Double<br />
| <br />
|-<br />
| Z<br />
| Double<br />
| <br />
|-<br />
|rowspan="8"| 3: initialize<br />
| X<br />
| Double<br />
| <br />
|-<br />
| Z<br />
| Double<br />
| <br />
|-<br />
| Old Radius<br />
| Double<br />
| <br />
|-<br />
| New Radius<br />
| Double<br />
| <br />
|-<br />
| Speed<br />
| VarLong<br />
| <br />
|-<br />
| Portal Teleport Boundary<br />
| VarInt<br />
| Resulting coordinates from a portal teleport are limited to +-value. Usually 29999984.<br />
|-<br />
| Warning Time<br />
| VarInt<br />
| <br />
|-<br />
| Warning Blocks<br />
| VarInt<br />
| <br />
|-<br />
|rowspan="1"| 4: set warning time<br />
| Warning Time<br />
| VarInt<br />
| unit?<br />
|-<br />
|rowspan="1"| 5: set warning blocks<br />
| Warning Blocks<br />
| VarInt<br />
| <br />
|}<br />
<br />
==== 显示标题 ==== <br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
!colspan="2"| Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="9"| 0x45<br />
|rowspan="9"| Play<br />
|rowspan="9"| Client<br />
|colspan="2"| Action<br />
| VarInt<br />
| <br />
|-<br />
! Action<br />
! Field Name<br />
! <br />
! <br />
|-<br />
| 0: set title<br />
| Title Text<br />
| [[Chat]]<br />
| <br />
|-<br />
| 1: set subtitle<br />
| Subtitle Text<br />
| [[Chat]]<br />
| <br />
|-<br />
|rowspan="3"| 2: set times and display<br />
| Fade In<br />
| Int<br />
| ticks<br />
|-<br />
| Stay<br />
| Int<br />
| ticks<br />
|-<br />
| Fade Out<br />
| Int<br />
| ticks<br />
|-<br />
| 3: hide<br />
| ''no fields''<br />
| ''no fields''<br />
| <br />
|-<br />
| 4: reset<br />
| ''no fields''<br />
| ''no fields''<br />
| <br />
|}<br />
<br />
“Hide” makes the title disappear, but if you run times again the same title will appear. “Reset” erases the text.<br />
<br />
==== 设置压缩 ====<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="1"| 0x46<br />
|rowspan="1"| Play<br />
|rowspan="1"| Client<br />
| Threshold<br />
| VarInt<br />
| 这种大小或更高的包可以被压缩。<br />
|}<br />
<br />
==== 玩家列表页眉与页脚 ====<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="2"| 0x47<br />
|rowspan="2"| Play<br />
|rowspan="2"| Client<br />
| Header<br />
| [[Chat]]<br />
| <br />
|-<br />
| Footer<br />
| [[Chat]]<br />
| <br />
|}<br />
<br />
==== 发送资源包 ==== <br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="2"| 0x48<br />
|rowspan="2"| Play<br />
|rowspan="2"| Client<br />
| URL<br />
| String<br />
| 资源包的 URL 地址<br />
|-<br />
| Hash<br />
| String<br />
| 一个40个字符的十六进制和小写的[[wikipedia:SHA-1|SHA-1]]哈希的资源包文件。（必须小写）<br />如果不符合上一行的标准， 客户端将不会验证它哈希值及浪费不必要的带宽 — 但仍将把它作为唯一的标识符处理<br />
|}<br />
<br />
==== 更新实体 NBT ==== <br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="2"| 0x49<br />
|rowspan="2"| Play<br />
|rowspan="2"| Client<br />
| Entity ID<br />
| VarInt<br />
| <br />
|-<br />
| Tag<br />
| [[NBT|NBT Tag]]<br />
| <br />
|}<br />
<br />
=== 发送到服务器 ===<br />
<br />
==== 保持连接 ====<br />
<br />
服务器会经常发送一个保持连接包，内含一个随机的ID。客户端必须回应同样的包。<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="1"| 0x00<br />
|rowspan="1"| Play<br />
|rowspan="1"| Server<br />
| Keep Alive ID<br />
| VarInt<br />
| <br />
|}<br />
<br />
==== 聊天信息 ====<br />
<br />
默认服务端会检查信息是否以 '/' 开头。如果不是是，发送者的用户名将被放在消息前并且发送到所有其他客户端（包括原始的发送者）。如果是，服务端认为它是一个命令并尝试处理它。一个长度大于 100 的信息会导致服务端踢出该客户端。这个行为一开始是在不修改服务端的前提下不允许客户端不分段发送长度超过 119（以前的限制）的信息。因为这个原因，原始的服务端保留了在 119 处将消息切片的代码，但是这不是一个协议限制并且可以被跳过。<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="1"| 0x01<br />
|rowspan="1"| Play<br />
|rowspan="1"| Server<br />
| Message<br />
| String<br />
| The client sends the raw input, not [[Chat]]<br />
|}<br />
<br />
==== 使用实体 ====<br />
<br />
这个包在玩家攻击或者右键点击其他实体（一个玩家、矿车等）时从客户端发往服务器。<br />
<br />
一个官方服务端只在被攻击或使用的实体是可视的、在以玩家为中心 4单位 的范围内且与玩家之间没有阻碍时才接受这个包。<br />
<br />
注意：创造模式的中键点击会被客户端解析且被发送为 [[#Creative Inventory Action|创造背包动作]] 包。<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="5"| 0x02<br />
|rowspan="5"| Play<br />
|rowspan="5"| Server<br />
| Target<br />
| VarInt<br />
| <br />
|-<br />
| Type<br />
| VarInt<br />
| 0: interact, 1: attack, 2: interact at<br />
|-<br />
| Target X<br />
| Optional Float<br />
| 只有当类型为 interact at 时<br />
|-<br />
| Target Y<br />
| Optional Float<br />
| 只有当类型为 interact at 时<br />
|-<br />
| Target Z<br />
| Optional Float<br />
| 只有当类型为 interact at 时<br />
|}<br />
<br />
==== 玩家状态 ====<br />
<br />
这个包用于表明玩家正在陆地上（行走/游泳）还是在空中（跳跃/掉落）。<br />
<br />
当从足够高的高度掉落，这个状态从 false 设置为 true 时会受到掉落伤害。受到伤害的数值基于最后状态从 true 设置为 false。 注意有一些运动相关的包包含了这个包。<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="1"| 0x03<br />
|rowspan="1"| Play<br />
|rowspan="1"| Server<br />
| On Ground<br />
| Boolean<br />
| 当对象站在地上时为 true , 反之则为 false<br />
|}<br />
<br />
==== 玩家坐标 ====<br />
<br />
更新玩家在服务器上的 XYZ 坐标。<br />
<br />
如果在服务器上最后记录的位置和这个包设置的新位置之间的距离大于 100 单位，将会导致客户端因为 “You moved too quickly :( (Hacking?)” 而被踢出服务器。<br />
<br />
如果之间的距离大于 10 单位，服务器会在日志中写下警告信息 “<name> moved too quickly!” 和两个三元坐标（可能是运动增量？），但不会踢出客户端。<br />
<br />
如果 X 或 Z 的定点数被设置大于 3.2×10<sup>7</sup> 客户端会因为 “Illegal position” 而被踢出服务器。<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="4"| 0x04<br />
|rowspan="4"| Play<br />
|rowspan="4"| Server<br />
| X<br />
| Double<br />
| 绝对位置<br />
|-<br />
| Feet Y<br />
| Double<br />
| 绝对位置，史蒂夫头部一般在 Y - 1.62<br />
|-<br />
| Z<br />
| Double<br />
| 绝对位置<br />
|-<br />
| On Ground<br />
| Boolean<br />
| 当对象站在地上时为 true , 反之则为 false<br />
|}<br />
<br />
==== 玩家观察 ====<br />
[[File:Minecraft-trig-yaw.png|thumb|The unit circle for yaw]]<br />
[[File:Yaw.png|thumb|The unit circle of yaw, redrawn]]<br />
<br />
更新玩家目前所看的方向。<br />
<br />
偏航（Yaw）以度为单位，并且不遵循经典的三角规则。</div>
梦彗業
https://mineplugin.org/index.php?title=Protocol&diff=5412
Protocol
2017-09-02T14:19:50Z
<p>梦彗業：翻译</p>
<hr />
<div>{{待翻译}}<br />
{{待更新|url=http://wiki.vg/Protocol}}<br />
<br />
这里剖析了最近的 '''[http://wiki.vg/Protocol_Encryption Minecraft协议]'''.<br />
<br />
如果你有疑问, 请查阅下文或在IRC请求帮助 ([irc://irc.freenode.net/mcdevs #mcdevs on irc.freenode.net]).<br />
<br />
'''注意:''' 你可以不受限制地使用这个页面的内容来创建服务端, 客户端, 机器人…… 诸如此类的任何东西…<br />
<br />
== 定义 ==<br />
<br />
Minecraft服务器是基于TCP通讯的。它和客户端使用所谓的 ''数据包''交流. 一个包被通过字节编码后从TCP连接中发送. 数据包的含义取决于其包标识和连接的当前状态. 每个链接从 '''[http://wiki.vg/Handshaking 握手]'''开始, 使用包切换状态 '''[http://wiki.vg/Handshaking 握手]''',( 0x00, serverbound) 和 [[#Login Success|成功登陆]] ([[#Login|登陆]], 0x02, clientbound).<br />
<br />
=== 数据类型 ===<br />
<br />
<!-- Transcluded contents of Data Types article in here - go to that page if you want to edit it --><br />
<br />
{{:Data Types}}<br />
<br />
=== 其他定义 ===<br />
<br />
{| class="wikitable"<br />
|-<br />
! 术语<br />
! 定义<br />
|-<br />
| Player——玩家<br />
| 使用时, 玩家通常使用它来链接到服务端.<br />
|-<br />
| Entity——实体<br />
| 实体相当于玩家、物品、怪物、船和矿车等. 查看 {{Minecraft Wiki|Entity|the Minecraft Wiki article}} 来寻找一个完整的表单.<br />
|-<br />
| EID——实体ID<br />
| An EID — 或者说是实体ID — 是一个用来识别特定实体的4字节序列. 在同一个服务器,没有相同的实体编号.<br />
|-<br />
| XYZ坐标<br />
| 游戏时，可以使用按钮“F3”来在屏幕上查看坐标位置 Y代表高度, X代表东西, Z代表南北.<br />
|-<br />
| 单位“Meter”<br />
| Meter是Minecraft的基本长度单位, 相当于一个方块的长度. “block”一词也许意味着 “meter”或者“cubic meter”.<br />
|}<br />
<br />
== 数据包的格式 ==<br />
<br />
=== 无压缩 ===<br />
<br />
{| class="wikitable"<br />
! 域名称<br />
! 域类型<br />
! 注释<br />
|-<br />
| 长度<br />
| VarInt<br />
| 包数据的长度 + 包序号的长度<br />
|-<br />
| 包序号<br />
| VarInt<br />
| <br />
|-<br />
| 数据<br />
| Byte Array<br />
| 依赖于连接状态和包序号，详见下面的部分。<br />
|}<br />
<br />
=== 压缩 ===<br />
<br />
当一个 [[#Set Compression|设置压缩]] 包被发送，[[wikipedia:Zlib|zlib]] 压缩将会对之后的所有包开启。 包的格式略微改变以包含未压缩前的包的长度。<br />
''译注：注意区分包长度和数据长度，关系：“包”包含“数据”''<br />
{| class=wikitable<br />
! 是否压缩<br />
! 域名称<br />
! 域类型<br />
! 注释<br />
|-<br />
| 否<br />
| 包长度<br />
| VarInt<br />
| 数据长度的长度 + 压缩后的 (包序号 + 数据) 的长度<br />
|-<br />
| 否<br />
| 数据长度<br />
| VarInt<br />
| 未压缩前的 (包序号 + 数据) 的长度 或 0<br />
|-<br />
|rowspan="2"| 是<br />
| 包序号<br />
| Varint<br />
| zlib 压缩后的包序号（详见下面的部分）<br />
|-<br />
| 数据<br />
| Byte Array<br />
| zlib 压缩后的包数据（详见下面的部分）<br />
|}<br />
<br />
包长度域提供的是包中存在的字节的数量，包括数据长度域。<br />
<br />
如果数据长度被设置为 0，则这个包没有被压缩；否则它表示已压缩的包未压缩前的包长度。<br />
<br />
如果包被压缩，压缩前的 (包序号 + 数据) 的长度必须等于或大于 [[#Set Compression|设置压缩]] 包中设置的最小值，否则客户端/服务端将会断开连接。<br />
<br />
压缩能通过发送一个最小值设定为 -1 的 [[#Set Compression|设置压缩]] 包来关闭。<br />
<br />
== 握手协议 ==<br />
<br />
=== 客户端绑定 ===<br />
<br />
因为协议在客户端发送第一个数据包后会立刻切换到另一个阶段，所以握手阶段没有客户端绑定的数据包。<br />
<br />
=== 服务端绑定 ===<br />
<br />
==== 握手协议 ====<br />
<br />
这将使得服务器切换至目标阶段。<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="4"| 0x00<br />
|rowspan="4"| Handshaking<br />
|rowspan="4"| Server<br />
| 协议版本<br />
| VarInt<br />
| See [[protocol version numbers]] (currently 47)<br />
|-<br />
| 服务器地址<br />
| String<br />
| 域名或是IP, 例如： localhost 或是 127.0.0.1<!-- does this support IPv6? --><br />
|- <br />
| 服务器端口<br />
| Unsigned Short<br />
| 默认值为25565<br />
|-<br />
| 下一阶段<br />
| VarInt<br />
| 1 for [[#Status|status]], 2 for [[#Login|login]]<br />
|}<br />
<br />
==== 传统的服务器列表Ping ====<br />
<br />
严格来说这不是当前协议的一部分，传统客户端可能会发送这一数据包来发起（initiate） [[Server List Ping]], 现代服务器也应当能够适当地处理这一数据包。<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
| 0xFE<br />
| Handshaking<br />
| Server<br />
| Payload<br />
| Unsigned Byte<br />
| always 1 (<code>0x01</code>)<br />
|}<br />
<br />
See [[Server List Ping#1.6]] for the details of the protocol that follows this packet.<br />
<br />
== 开始游戏 ==<br />
<br />
=== 发送到客户端 ===<br />
<br />
==== 心跳包 ====<br />
<br />
The server will frequently send out a keep-alive, each containing a random ID. The client must respond with the same packet. If the client does not respond to them for over 30 seconds, the server kicks the client. Vice versa, if the server does not send any keep-alives for 20 seconds, the client will disconnect and yields a "Timed out" exception.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="1"| 0x00<br />
|rowspan="1"| Play<br />
|rowspan="1"| Client<br />
| Keep Alive ID<br />
| VarInt<br />
| <br />
|}<br />
<br />
==== 加入游戏 ====<br />
<br />
See [[Protocol Encryption]] for information on logging in.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="7"| 0x01<br />
|rowspan="7"| Play<br />
|rowspan="7"| Client<br />
| Entity ID<br />
| Int<br />
| The player's Entity ID (EID)<br />
|-<br />
| Gamemode<br />
| Unsigned Byte<br />
| 0: Survival, 1: Creative, 2: Adventure, 3: Spectator. Bit 3 (0x8) is the hardcore flag.<br />
|-<br />
| Dimension<br />
| Byte<br />
| -1: Nether, 0: Overworld, 1: End<br />
|-<br />
| Difficulty<br />
| Unsigned Byte<br />
| 0: peaceful, 1: easy, 2: normal, 3: hard<br />
|-<br />
| Max Players<br />
| Unsigned Byte<br />
| Used by the client to draw the player list<br />
|-<br />
| Level Type<br />
| String<br />
| default, flat, largeBiomes, amplified, default_1_1<br />
|-<br />
| Reduced Debug Info<br />
| Boolean<br />
| If true, a Notchian client shows reduced information on the {{Minecraft Wiki|debug screen}}.<br />
|}<br />
<br />
{{Warning|如果位置无效，服务端将崩溃}}<br />
<br />
==== 聊天内容 ==== <br />
<br />
Identifying the difference between Chat/System Message is important as it helps respect the user's chat visibility options. While Position 2 accepts json formatting it will not display, old style formatting works<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="2"| 0x02<br />
|rowspan="2"| Play<br />
|rowspan="2"| Client<br />
| JSON Data<br />
| [[Chat]]<br />
| Limited to 32767 bytes<br />
|-<br />
| Position<br />
| Byte<br />
| 0: chat (chat box), 1: system message (chat box), 2: above action bar<br />
|}<br />
<br />
{{Warning|错误的JSON将断开连接}}<br />
<br />
==== 时间更新 ====<br />
<br />
Time is based on ticks, where 20 ticks happen every second. There are 24000 ticks in a day, making Minecraft days exactly 20 minutes long.<br />
<br />
The time of day is based on the timestamp modulo 24000. 0 is sunrise, 6000 is noon, 12000 is sunset, and 18000 is midnight.<br />
<br />
The default SMP server increments the time by <code>20</code> every second.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="2"| 0x03<br />
|rowspan="2"| Play<br />
|rowspan="2"| Client<br />
| World Age<br />
| Long<br />
| In ticks; not changed by server commands<br />
|-<br />
| Time of day<br />
| Long<br />
| The world (or region) time, in ticks. If negative the sun will stop moving at the Math.abs of the time<br />
|}<br />
<br />
==== 持有的物品 ====<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="3"| 0x04<br />
|rowspan="3"| Play<br />
|rowspan="3"| Client<br />
| Entity ID<br />
| VarInt<br />
| Entity's EID<br />
|-<br />
| Slot<br />
| Short<br />
| Equipment slot. 0: held, 1–4: armor slot (1: boots, 2: leggings, 3: chestplate, 4: helmet)<br />
|-<br />
| Item<br />
| [[Slot Data|Slot]]<br />
| Item in slot format<br />
|}<br />
<br />
==== 出生姿势 ====<br />
<br />
Sent by the server after login to specify the coordinates of the spawn point (the point at which players spawn at, and which the compass points to). It can be sent at any time to update the point compasses point at.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="1"| 0x05<br />
|rowspan="1"| Play<br />
|rowspan="1"| Client<br />
| Location<br />
| Position<br />
| Spawn location<br />
|}<br />
<br />
==== 更新生命值 ====<br />
<br />
Sent by the server to update/set the health of the player it is sent to.<br />
<br />
Food {{Minecraft Wiki|Food#Hunger vs. Saturation|saturation}} acts as a food “overcharge”. Food values will not decrease while the saturation is over zero. Players logging in automatically get a saturation of 5.0. Eating food increases the saturation as well as the food bar.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="3"| 0x06<br />
|rowspan="3"| Play<br />
|rowspan="3"| Client<br />
| Health<br />
| Float<br />
| 0 or less = dead, 20 = full HP<br />
|-<br />
| Food<br />
| VarInt<br />
| 0–20<br />
|- <br />
| Food Saturation<br />
| Float<br />
| Seems to vary from 0.0 to 5.0 in integer increments<br />
|}<br />
<br />
==== 重生 ====<br />
<br />
来改变玩家的位置(主世界/地狱/末地), 发送给他们一个重生指令, 其次是prechunks或chunks的新位置, and finally a position and look packet. You do not need to unload chunks, the client will do it automatically.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="4"| 0x07<br />
|rowspan="4"| Play<br />
|rowspan="4"| Client<br />
| Dimension<br />
| Int<br />
| -1: The Nether, 0: The Overworld, 1: The End<br />
|-<br />
| Difficulty<br />
| Unsigned Byte<br />
| 0: Peaceful, 1: Easy, 2: Normal, 3: Hard<br />
|-<br />
| Gamemode<br />
| Unsigned Byte<br />
| 0: survival, 1: creative, 2: adventure. The hardcore flag is not included<br />
|-<br />
| Level Type<br />
| String<br />
| Same as [[#Join Game|Join Game]]<br />
|}<br />
<br />
{{Warning|如果位置无效，服务端将崩溃 }}<br />
<br />
{{Warning|如果玩家出现在了相同的位置, weird bugs can occur i.e. such player will be unable to attack other players in new world (修复后他们将重生)}}<br />
<br />
==== 玩家姿势以及看的方向 ==== <br />
<br />
Updates the player's position on the server.<br />
<br />
If the distance between the last known position of the player on the server and the new position set by this packet is greater than 100 meters, the client will be kicked for “You moved too quickly :( (Hacking?)”.<br />
<br />
Also if the fixed-point number of X or Z is set greater than <code>3.2E7D</code> the client will be kicked for “Illegal position”.<br />
<br />
Yaw is measured in degrees, and does not follow classical trigonometry rules. The unit circle of yaw on the XZ-plane starts at (0, 1) and turns counterclockwise, with 90 at (-1, 0), 180 at (0, -1) and 270 at (1, 0). Additionally, yaw is not clamped to between 0 and 360 degrees; any number is valid, including negative numbers and numbers greater than 360.<br />
<br />
Pitch is measured in degrees, where 0 is looking straight ahead, -90 is looking straight up, and 90 is looking straight down.<br />
<br />
The yaw in degrees of a player standing at point (x0, z0) and looking towards point (x, z) can be calculated with:<br />
<br />
l = x-x0<br />
w = z-z0<br />
c = sqrt( l*l + w*w )<br />
alpha1 = -arcsin(l/c)/PI*180<br />
alpha2 = arccos(w/c)/PI*180<br />
if alpha2 > 90 then<br />
yaw = 180 - alpha1<br />
else<br />
yaw = alpha1<br />
<br />
You can get a unit vector from a given yaw/pitch via:<br />
<br />
x = -cos(pitch) * sin(yaw)<br />
y = -sin(pitch)<br />
z = cos(pitch) * cos(yaw)<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="6"| 0x08<br />
|rowspan="6"| Play<br />
|rowspan="6"| Client<br />
| X<br />
| Double<br />
| Absolute or relative position, depending on Flags<br />
|-<br />
| Y<br />
| Double<br />
| Absolute or relative position, depending on Flags<br />
|-<br />
| Z<br />
| Double<br />
| Absolute or relative position, depending on Flags<br />
|-<br />
| Yaw<br />
| Float<br />
| Absolute or relative rotation on the X Axis, in degrees<br />
|-<br />
| Pitch<br />
| Float<br />
| Absolute or relative rotation on the Y Axis, in degrees<br />
|-<br />
| Flags<br />
| Byte<br />
| Bit field, see below<br />
|}<br />
<br />
About the Flags field:<br />
<br />
<Dinnerbone> It's a bitfield, X/Y/Z/Y_ROT/X_ROT. If X is set, the x value is relative and not absolute.<br />
<br />
{| class="wikitable"<br />
|-<br />
! Field<br />
! Bit<br />
|-<br />
| X<br />
| 0x01<br />
|-<br />
| Y<br />
| 0x02<br />
|-<br />
| Z<br />
| 0x04<br />
|-<br />
| Y_ROT<br />
| 0x08<br />
|-<br />
| X_ROT<br />
| 0x10<br />
|}<br />
<br />
==== 持有物品变更 ====<br />
<br />
Sent to change the player's slot selection.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="1"| 0x09<br />
|rowspan="1"| Play<br />
|rowspan="1"| Client<br />
| Slot<br />
| Byte<br />
| The slot which the player has selected (0–8)<br />
|}<br />
<br />
==== 使用床 ==== <br />
<br />
This packet tells that a player goes to bed.<br />
<br />
The client with the matching Entity ID will go into bed mode.<br />
<br />
This Packet is sent to all nearby players including the one sent to bed.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="2"| 0x0A<br />
|rowspan="2"| Play<br />
|rowspan="2"| Client<br />
| Entity ID<br />
| VarInt<br />
| Sleeping player's EID<br />
|-<br />
| Location<br />
| Position<br />
| Block location of the head part of the bed<br />
|}<br />
<br />
==== 动画 ====<br />
<br />
Sent whenever an entity should change animation.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="2"| 0x0B<br />
|rowspan="2"| Play<br />
|rowspan="2"| Client<br />
| Entity ID<br />
| VarInt<br />
| Player ID<br />
|-<br />
| Animation<br />
| Unsigned Byte<br />
| Animation ID (see below)<br />
|}<br />
<br />
Animation can be one of the following values:<br />
<br />
{| class="wikitable"<br />
! ID<br />
! Animation<br />
|-<br />
| 0<br />
| Swing arm<br />
|-<br />
| 1<br />
| Take damage<br />
|-<br />
| 2<br />
| Leave bed<br />
|-<br />
| 3<br />
| Eat food<br />
|-<br />
| 4<br />
| Critical effect<br />
|-<br />
| 5<br />
| Magic critical effect<br />
|}<br />
<br />
==== 生成玩家 ====<br />
<br />
This packet is sent by the server when a player comes into visible range, ''not'' when a player joins.<br />
<br />
This packet must be sent after the [[#Player List Item|Player List Item]] ([[#Play|Play]], 0x38, clientbound) packet that adds the player data for the client to use when spawning a player. If the tab list entry for the UUID included in this packet is not present when this packet arrives, the entity will not be spawned. The tab includes skin/cape data.<br />
<br />
Servers can, however, safely spawn player entities for players not in visible range. The client appears to handle it correctly.<br />
<br />
When in online-mode the UUIDs must be valid and have valid skin blobs, in offline-mode UUID v3 is used.<br />
<br />
For NPCs UUID v2 should be used. Note:<br />
<br />
<+Grum> i will never confirm this as a feature you know that :)<br />
<br />
In an example UUID, <code>xxxxxxxx-xxxx-Yxxx-xxxx-xxxxxxxxxxxx</code>, the UUID version is specified by <code>Y</code>. So, for UUID v3, <code>Y</code> will always be <code>3</code>, and for UUID v2, <code>Y</code> will always be <code>2</code>.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="9"| 0x0C<br />
|rowspan="9"| Play<br />
|rowspan="9"| Client<br />
| Entity ID<br />
| VarInt<br />
| Player's EID<br />
|-<br />
| Player UUID<br />
| UUID<br />
| <br />
|-<br />
| X<br />
| Int<br />
| Player X as a [[Data Types#Fixed-point numbers|Fixed-Point number]]<br />
|-<br />
| Y<br />
| Int<br />
| Player Y as a [[Data Types#Fixed-point numbers|Fixed-Point number]]<br />
|-<br />
| Z<br />
| Int<br />
| Player Z as a [[Data Types#Fixed-point numbers|Fixed-Point number]]<br />
|-<br />
| Yaw<br />
| Angle<br />
| <br />
|-<br />
| Pitch<br />
| Angle<br />
| <br />
|-<br />
| Current Item<br />
| Short<br />
| The item the player is currently holding. Note that this should be 0 for “no item”, unlike -1 used in other packets.<br />
|-<br />
| Metadata<br />
| [[Entities#Entity Metadata Format|Metadata]]<br />
| <br />
|}<br />
<br />
{{Warning|A negative Current Item crashes clients}}<br />
<br />
{{Warning|The client will crash if no Metadata is sent}}<br />
<br />
==== 拾起物品 ====<br />
<br />
Sent by the server when someone picks up an item lying on the ground — its sole purpose appears to be the animation of the item flying towards you. It doesn't destroy the entity in the client memory, and it doesn't add it to your inventory. The server only checks for items to be picked up after each [[#Player Position|Player Position]] (and [[#Player Position And Look|Player Position And Look]]) packet sent by the client.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="2"| 0x0D<br />
|rowspan="2"| Play<br />
|rowspan="2"| Client<br />
| Collected Entity ID<br />
| VarInt<br />
| <br />
|- <br />
| Collector Entity ID<br />
| VarInt<br />
| <br />
|}<br />
<br />
==== 生成对象 ====<br />
<br />
Sent by the server when an Object/Vehicle is created.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="8"| 0x0E<br />
|rowspan="8"| Play<br />
|rowspan="8"| Client<br />
| Entity ID <br />
| VarInt<br />
| EID of the object<br />
|-<br />
| Type<br />
| Byte<br />
| The type of object (See [[Entities#Objects|Objects]])<br />
|-<br />
| X<br />
| Int<br />
| X position as a [[Data Types#Fixed-point numbers|Fixed-Point number]]<br />
|-<br />
| Y<br />
| Int<br />
| Y position as a [[Data Types#Fixed-point numbers|Fixed-Point number]]<br />
|-<br />
| Z<br />
| Int<br />
| Z position as a [[Data Types#Fixed-point numbers|Fixed-Point number]]<br />
|-<br />
| Pitch<br />
| Angle<br />
| <br />
|-<br />
| Yaw<br />
| Angle<br />
| <br />
|-<br />
| Data<br />
| [[Object Data]]<br />
| <br />
|}<br />
<br />
==== 生成怪物 ====<br />
<br />
Sent by the server when a Mob Entity is Spawned<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="12"| 0x0F<br />
|rowspan="12"| Play<br />
|rowspan="12"| Client<br />
| Entity ID<br />
| VarInt<br />
| <br />
|-<br />
| Type<br />
| Unsigned Byte<br />
| The type of mob. See [[Entities#Mobs|Mobs]]<br />
|-<br />
| X<br />
| Int<br />
| X position as a [[Data Types#Fixed-point numbers|Fixed-Point number]] <br />
|-<br />
| Y<br />
| Int<br />
| Y position as a [[Data Types#Fixed-point numbers|Fixed-Point number]] <br />
|-<br />
| Z<br />
| Int<br />
| Z position as a [[Data Types#Fixed-point numbers|Fixed-Point number]] <br />
|-<br />
| Yaw<br />
| Angle<br />
| <br />
|-<br />
| Pitch<br />
| Angle<br />
| <br />
|-<br />
| Head Pitch<br />
| Angle<br />
| <br />
|-<br />
| Velocity X<br />
| Short<br />
| Same units as [[#Entity Velocity|Entity Velocity]]<br />
|-<br />
| Velocity Y<br />
| Short<br />
| Same units as [[#Entity Velocity|Entity Velocity]]<br />
|-<br />
| Velocity Z<br />
| Short<br />
| Same units as [[#Entity Velocity|Entity Velocity]]<br />
|-<br />
| Metadata<br />
| [[Entities#Entity Metadata Format|Metadata]]<br />
| <br />
|}<br />
<br />
==== 重生绘图 ====<br />
<br />
This packet shows location, name, and type of painting.<br />
<br />
Calculating the center of an image: given a (width x height) grid of cells, with (0, 0) being the top left corner, the center is (max(0, width / 2 - 1), height / 2). E.g.<br />
<br />
2x1 (1, 0)<br />
4x4 (1, 2)<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="4"| 0x10<br />
|rowspan="4"| Play<br />
|rowspan="4"| Client<br />
| Entity ID<br />
| VarInt<br />
| <br />
|-<br />
| Title<br />
| String<br />
| Name of the painting. Max length 13<br />
|-<br />
| Location<br />
| Position<br />
| Center coordinates<br />
|-<br />
| Direction<br />
| Unsigned Byte<br />
| Direction the painting faces. 0: north (-z), 1: west (-x), 2: south (+z), 3: east (+x)<br />
|}<br />
<br />
==== 重生掉落经验 ====<br />
<br />
Spawns one or more experience orbs.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="5"| 0x11<br />
|rowspan="5"| Play<br />
|rowspan="5"| Client<br />
| Entity ID<br />
| VarInt<br />
| Entity's ID<br />
|-<br />
| X<br />
| Int<br />
| X position as a [[Data Types#Fixed-point numbers|Fixed-Point number]]<br />
|-<br />
| Y<br />
| Int<br />
| Y position as a [[Data Types#Fixed-point numbers|Fixed-Point number]]<br />
|-<br />
| Z<br />
| Int<br />
| Z position as a [[Data Types#Fixed-point numbers|Fixed-Point number]]<br />
|-<br />
| Count<br />
| Short<br />
| The amount of experience this orb will reward once collected<br />
|}<br />
<br />
==== 实体速率 ====<br />
<br />
Velocity is believed to be in units of 1/8000 of a block per server tick (50ms); for example, -1343 would move (-1343 / 8000) = −0.167875 blocks per tick (or −3,3575 blocks per second).<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="4"| 0x12<br />
|rowspan="4"| Play<br />
|rowspan="4"| Client<br />
| Entity ID<br />
| VarInt<br />
| <br />
|-<br />
| Velocity X<br />
| Short<br />
| Velocity on the X axis<br />
|-<br />
| Velocity Y<br />
| Short<br />
| Velocity on the Y axis<br />
|-<br />
| Velocity Z<br />
| Short<br />
| Velocity on the Z axis<br />
|}<br />
<br />
==== 销毁实体 ====<br />
<br />
Sent by the server when a list of entities is to be destroyed on the client.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="2"| 0x13<br />
|rowspan="2"| Play<br />
|rowspan="2"| Client<br />
| Count<br />
| VarInt<br />
| Number of elements in the following array<br />
|-<br />
| Entity IDs<br />
| Array of VarInt<br />
| The list of entities of destroy<br />
|}<br />
<br />
==== 实体 ====<br />
<br />
This packet may be used to initialize an entity.<br />
<br />
For player entities, either this packet or any move/look packet is sent every game tick. So the meaning of this packet is basically that the entity did not move/look since the last such packet.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="1"| 0x14<br />
|rowspan="1"| Play<br />
|rowspan="1"| Client<br />
| Entity ID<br />
| VarInt<br />
| <br />
|}<br />
<br />
==== 实体相对移动 ====<br />
<br />
This packet is sent by the server when an entity moves less then 4 blocks; if an entity moves more than 4 blocks [[#Entity Teleport|Entity Teleport]] should be sent instead.<br />
<br />
This packet allows at most four blocks movement in any direction, because byte range is from -128 to 127.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="5"| 0x15<br />
|rowspan="5"| Play<br />
|rowspan="5"| Client<br />
| Entity ID<br />
| VarInt<br />
| <br />
|-<br />
| Delta X<br />
| Byte<br />
| Change in X position as a [[Data Types#Fixed-point numbers|Fixed-Point number]]<br />
|-<br />
| Delta Y<br />
| Byte<br />
| Change in Y position as a [[Data Types#Fixed-point numbers|Fixed-Point number]]<br />
|-<br />
| Delta Z<br />
| Byte<br />
| Change in Z position as a [[Data Types#Fixed-point numbers|Fixed-Point number]]<br />
|-<br />
| On Ground<br />
| Boolean<br />
| <br />
|}<br />
<br />
==== 实体朝向 ====<br />
<br />
This packet is sent by the server when an entity rotates.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="5"| 0x16<br />
|rowspan="5"| Play<br />
|rowspan="5"| Client<br />
| Entity ID<br />
| VarInt<br />
| <br />
|-<br />
| Yaw<br />
| Angle<br />
| New angle, not a delta<br />
|-<br />
| Pitch<br />
| Angle<br />
| New angle, not a delta<br />
|-<br />
| On Ground<br />
| Boolean<br />
| <br />
|}<br />
<br />
==== 实体朝向与相对移动 ====<br />
<br />
This packet is sent by the server when an entity rotates and moves. Since a byte range is limited from -128 to 127, and movement is offset of fixed-point numbers, this packet allows at most four blocks movement in any direction. (-128/32 == -4)<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="7"| 0x17<br />
|rowspan="7"| Play<br />
|rowspan="7"| Client<br />
| Entity ID<br />
| VarInt<br />
| <br />
|-<br />
| Delta X<br />
| Byte<br />
| Change in X position as a [[Data Types#Fixed-point numbers|Fixed-Point number]]<br />
|-<br />
| Delta Y<br />
| Byte<br />
| Change in Y position as a [[Data Types#Fixed-point numbers|Fixed-Point number]]<br />
|-<br />
| Delta Z<br />
| Byte<br />
| Change in Z position as a [[Data Types#Fixed-point numbers|Fixed-Point number]]<br />
|-<br />
| Yaw<br />
| Angle<br />
| New angle, not a delta<br />
|-<br />
| Pitch<br />
| Angle<br />
| New angle, not a delta<br />
|-<br />
| On Ground<br />
| Boolean<br />
| <br />
|}<br />
<br />
==== 实体传送 ====<br />
<br />
This packet is sent by the server when an entity moves more than 4 blocks.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="7"| 0x18<br />
|rowspan="7"| Play<br />
|rowspan="7"| Client<br />
| Entity ID<br />
| VarInt<br />
| <br />
|-<br />
| X<br />
| Int<br />
| X position as a [[Data Types#Fixed-point numbers|Fixed-Point number]]<br />
|-<br />
| Y<br />
| Int<br />
| Y position as a [[Data Types#Fixed-point numbers|Fixed-Point number]]<br />
|-<br />
| Z<br />
| Int<br />
| Z position as a [[Data Types#Fixed-point numbers|Fixed-Point number]]<br />
|-<br />
| Yaw<br />
| Angle<br />
| New angle, not a delta<br />
|-<br />
| Pitch<br />
| Angle<br />
| New angle, not a delta<br />
|-<br />
| On Ground<br />
| Boolean<br />
| <br />
|}<br />
<br />
==== 实体手朝向 ====<br />
<br />
Changes the direction an entity's head is facing.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="2"| 0x19<br />
|rowspan="2"| Play<br />
|rowspan="2"| Client<br />
| Entity ID<br />
| VarInt<br />
| <br />
|-<br />
| Head Yaw<br />
| Angle<br />
| New angle, not a delta<br />
|}<br />
<br />
==== 实体状态 ====<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="2"| 0x1A<br />
|rowspan="2"| Play<br />
|rowspan="2"| Client<br />
| Entity ID<br />
| Int<br />
| <br />
|-<br />
| Entity Status<br />
| Byte<br />
| See below<br />
|}<br />
<br />
{| class="wikitable"<br />
|-<br />
! Entity Status<br />
! Meaning<br />
|-<br />
| 1<br />
| Sent when resetting a mob spawn minecart's timer - appears to be unused by the client<br />
|-<br />
| 2<br />
| Living Entity hurt <br />
|-<br />
| 3<br />
| Living Entity dead<br />
|-<br />
| 4<br />
| Iron Golem throwing up arms<br />
|-<br />
| 6<br />
| Wolf/Ocelot/Horse taming — Spawn “heart” particles<br />
|-<br />
| 7<br />
| Wolf/Ocelot/Horse tamed — Spawn “smoke” particles<br />
|-<br />
| 8<br />
| Wolf shaking water — Trigger the shaking animation<br />
|-<br />
| 9<br />
| (of self) Eating accepted by server<br />
|-<br />
| 10<br />
| Sheep eating grass<br />
|-<br />
| 10<br />
| Play TNT ignite sound<br />
|-<br />
| 11<br />
| Iron Golem handing over a rose<br />
|-<br />
| 12<br />
| Villager mating — Spawn “heart” particles<br />
|-<br />
| 13<br />
| Spawn particles indicating that a villager is angry and seeking revenge<br />
|-<br />
| 14<br />
| Spawn happy particles near a villager<br />
|-<br />
| 15<br />
| Witch animation — Spawn “magic” particles<br />
|-<br />
| 16<br />
| Play zombie converting into a villager sound<br />
|-<br />
| 17<br />
| Firework exploding<br />
|-<br />
| 18<br />
| Animal in love (ready to mate) — Spawn “heart” particles<br />
|-<br />
| 19<br />
| Reset squid rotation<br />
|-<br />
| 20<br />
| Spawn explosion particle — works for some living entities<br />
|-<br />
| 21<br />
| Play guardian sound — works for every entity<br />
|-<br />
| 22<br />
| Enables reduced debug for players<br />
|-<br />
| 23<br />
| Disables reduced debug for players<br />
|}<br />
<br />
==== 附加实体 ====<br />
<br />
This packet is sent when a player has been attached to an entity (e.g. Minecart).<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="3"| 0x1B<br />
|rowspan="3"| Play<br />
|rowspan="3"| Client<br />
| Entity ID<br />
| Int<br />
| Attached entity's EID. Set to -1 to detach.<br />
|-<br />
| Vehicle ID<br />
| Int<br />
| Vechicle's Entity ID<br />
|-<br />
| Leash<br />
| Boolean<br />
| If true leashes the entity to the vehicle<br />
|}<br />
<br />
==== 实体数据值 ====<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="2"| 0x1C<br />
|rowspan="2"| Play<br />
|rowspan="2"| Client<br />
| Entity ID<br />
| VarInt<br />
| <br />
|-<br />
| Metadata<br />
| [[Entities#Entity Metadata Format|Metadata]]<br />
| <br />
|}<br />
<br />
==== 实体属性 ====<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="5"| 0x1D<br />
|rowspan="5"| Play<br />
|rowspan="5"| Client<br />
| Entity ID<br />
| VarInt<br />
| <br />
|-<br />
| Effect ID<br />
| Byte<br />
| See {{Minecraft Wiki|Status effect#List of effects|this table}}<br />
|-<br />
| Amplifier<br />
| Byte<br />
| Notchian client displays effect level as Amplifier + 1<br />
|-<br />
| Duration<br />
| VarInt<br />
| Seconds<br />
|-<br />
| Hide Particles<br />
| Boolean<br />
| <br />
|}<br />
<br />
==== 移除实体属性 ====<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="2"| 0x1E<br />
|rowspan="2"| Play<br />
|rowspan="2"| Client<br />
| Entity ID<br />
| VarInt<br />
| <br />
|-<br />
| Effect ID<br />
| Byte<br />
| See {{Minecraft Wiki|Status effect#List of effects|this table}}<br />
|}<br />
<br />
==== 设置经验值 ====<br />
<br />
Sent by the server when the client should change experience levels.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="3"| 0x1F<br />
|rowspan="3"| Play<br />
|rowspan="3"| Client<br />
| Experience bar<br />
| Float<br />
| Between 0 and 1<br />
|-<br />
| Level<br />
| VarInt<br />
| <br />
|-<br />
| Total Experience<br />
| VarInt<br />
| See {{Minecraft Wiki|Experience#Leveling up}} on the Minecraft Wiki for Total Experience to Level conversion<br />
|}<br />
<br />
==== 实体配置 ====<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
!colspan="2"| Field Name<br />
!colspan="2"| Field Type<br />
! Notes<br />
|-<br />
|rowspan="6"| 0x20<br />
|rowspan="6"| Play<br />
|rowspan="6"| Client<br />
|colspan="2"| Entity ID<br />
|colspan="2"| VarInt<br />
| <br />
|-<br />
|colspan="2"| Number Of Properties<br />
|colspan="2"| Int<br />
| Number of elements in the following array<br />
|-<br />
|rowspan="4"| Property<br />
| Key<br />
|rowspan="4"| Array<br />
| String<br />
| See below<br />
|-<br />
| Value<br />
| Double<br />
| See below<br />
|-<br />
| Number Of Modifiers<br />
| VarInt<br />
| Number of elements in the following array<br />
|-<br />
| Modifiers<br />
| Array of Modifier Data<br />
| See {{Minecraft Wiki|Attribute#Modifiers}}<br />
|}<br />
<br />
Known Key values:<br />
<br />
{| class="wikitable"<br />
|-<br />
! Key<br />
! Default<br />
! Min<br />
! Max<br />
! Label<br />
|-<br />
| generic.maxHealth<br />
| 20.0<br />
| 0.0<br />
| Double.MaxValue<br />
| Max Health<br />
|-<br />
| generic.followRange<br />
| 32.0<br />
| 0.0<br />
| 2048.0<br />
| Follow Range<br />
|-<br />
| generic.knockbackResistance<br />
| 0.0 <br />
| 0.0<br />
| 1.0<br />
| Knockback Resistance<br />
|-<br />
| generic.movementSpeed<br />
| 0.699999988079071<br />
| 0.0<br />
| Double.MaxValue<br />
| Movement Speed<br />
|-<br />
| generic.attackDamage<br />
| 2.0<br />
| 0.0<br />
| Double.MaxValue<br />
| <br />
|-<br />
| horse.jumpStrength<br />
| 0.7<br />
| 0.0<br />
| 2.0<br />
| Jump Strength<br />
|-<br />
| zombie.spawnReinforcements<br />
| 0.0<br />
| 0.0<br />
| 1.0<br />
| Spawn Reinforcements Chance<br />
|}<br />
<br />
''Modifier Data'' structure:<br />
<br />
{| class="wikitable"<br />
|-<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
| UUID<br />
| UUID<br />
| <br />
|-<br />
| Amount<br />
| Double<br />
| <br />
|-<br />
| Operation<br />
| Byte<br />
| <br />
|}<br />
<br />
==== 区块数据 ====<br />
<br />
Chunks are not unloaded by the client automatically. To unload chunks, send this packet with Ground-Up Continuous=true and no 16^3 chunks (eg. Primary Bit Mask=0). The server does not send skylight information for nether-chunks, it's up to the client to know if the player is currently in the nether. You can also infer this information from the primary bitmask and the amount of uncompressed bytes sent.<br />
<br />
See also: [[SMP Map Format]]<br />
<br />
Changes in 1.8:<br />
<br />
* Data value section removed<br />
* Extended id section removed<br />
* Block id section is now a unsigned short (little endian) per a block<br />
* The block id is equal to <code>(id << 4) | data</code><br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="6"| 0x21<br />
|rowspan="6"| Play<br />
|rowspan="6"| Client<br />
| Chunk X<br />
| Int<br />
| Chunk X coordinate<br />
|-<br />
| Chunk Z<br />
| Int<br />
| Chunk Z coordinate<br />
|-<br />
| Ground-Up Continuous<br />
| Boolean<br />
| This is true if the packet represents all sections in this vertical column, where the Primary Bit Mask specifies exactly which sections are included, and which are air<br />
|-<br />
| Primary Bit Mask<br />
| Unsigned Short<br />
| Bitmask with 1 for every 16x16x16 section whose data follows in the compressed data<br />
|- <br />
| Size<br />
| VarInt<br />
| Size of Data<br />
|-<br />
| Data<br />
| [[SMP Map Format#Data|Chunk]]<br />
| <br />
|}<br />
<br />
==== 多个方块改变 ====<br />
Fired whenever 2 or more blocks are changed within the render distance.<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
!colspan="2"| Field Name<br />
!colspan="2"| Field Type<br />
! Notes<br />
|-<br />
|rowspan="6"| 0x22<br />
|rowspan="6"| Play<br />
|rowspan="6"| Client<br />
|colspan="2"| Chunk X<br />
|colspan="2"| Int<br />
| Chunk X coordinate<br />
|-<br />
|colspan="2"| Chunk Z<br />
|colspan="2"| Int<br />
| Chunk Z coordinate<br />
|-<br />
|colspan="2"| Record Count<br />
|colspan="2"| VarInt<br />
| Number of elements in the following array, a.k.a. the number of blocks affected<br />
|-<br />
|rowspan="3"| Record<br />
| Horizontal Position<br />
|rowspan="3"| Array<br />
| Unsigned Byte<br />
| The 4 most significant bits (<code>0xF0</code>) encode the X coordinate, relative to the chunk. The 4 least significant bits (<code>0x0F</code>) encode the Z coordinate, relative to the chunk.<br />
|-<br />
| Y Coordinate<br />
| Unsigned Byte<br />
| <br />
|-<br />
| Block ID<br />
| VarInt<br />
| The new block ID for the block. <code><nowiki>id &lt;&lt; 4 | data</nowiki></code><br />
|}<br />
<br />
==== 方块改变 ====<br />
Fired whenever a block is changed within the render distance.<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="2"| 0x23<br />
|rowspan="2"| Play<br />
|rowspan="2"| Client<br />
| Location<br />
| Position<br />
| Block Coordinates<br />
|-<br />
| Block ID<br />
| VarInt<br />
| The new block ID for the block. <code><nowiki>id &lt;&lt; 4 | data</nowiki></code><br />
|}<br />
<br />
==== 方块功能 ====<br />
<br />
This packet is used for a number of things:<br />
<br />
* Chests opening and closing<br />
* Pistons pushing and pulling<br />
* Note blocks playing<br />
* Updating beacons<br />
<br />
See Also: [[Block Actions]] <br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="4"| 0x24<br />
|rowspan="4"| Play<br />
|rowspan="4"| Client<br />
| Location<br />
| Position<br />
| Block Coordinates<br />
|-<br />
| Byte 1<br />
| Unsigned Byte<br />
| Varies depending on block — see [[Block Actions]]<br />
|-<br />
| Byte 2<br />
| Unsigned Byte<br />
| Varies depending on block — see [[Block Actions]]<br />
|-<br />
| Block Type<br />
| VarInt<br />
| The block type for the block<br />
|}<br />
<br />
==== 方块破坏动画 ====<br />
<br />
0–9 are the displayable destroy stages and each other number means that there is no animation on this coordinate.<br />
<br />
You can also set an animation to air! The animation will still be visible.<br />
<br />
If you need to display several break animations at the same time you have to give each of them a unique Entity ID.<br />
<br />
Also if you set the coordinates to a special block like water etc. it won't show the actual break animation but some other interesting effects. (Water will lose it's transparency)<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="3"| 0x25<br />
|rowspan="3"| Play<br />
|rowspan="3"| Client<br />
| Entity ID<br />
| VarInt<br />
| EID for the animation<br />
|-<br />
| Location<br />
| Position<br />
| Block Position<br />
|-<br />
| Destroy Stage<br />
| Byte<br />
| 0–9 to set it, any other value to remove it<br />
|}<br />
<br />
==== 地图区块 ====<br />
<br />
1.8 changes at [[#Chunk Data|Chunk Data]]<br />
<br />
To reduce the number of bytes, this packet is used to send chunks together for better compression results.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
!colspan="2"| Field Name<br />
!colspan="2"| Field Type<br />
! Notes<br />
|-<br />
|rowspan="7"| 0x26<br />
|rowspan="7"| Play<br />
|rowspan="7"| Client<br />
|colspan="2"| Sky Light Sent<br />
|colspan="2"| Boolean<br />
| Whether or not Chunk Data contains light nibble arrays. This is true in the Overworld, false in the End + Nether<br />
|-<br />
|colspan="2"| Chunk Column Count<br />
|colspan="2"| VarInt<br />
| Number of elements in each of the following arrays<br />
|-<br />
|rowspan="3"| Chunk Meta<br />
| Chunk X<br />
|rowspan="3"| Array<br />
| Int<br />
| The X coordinate of the chunk<br />
|-<br />
| Chunk Z<br />
| Int<br />
| The Z coordinate of the chunk<br />
|-<br />
| Primary Bit Mask<br />
| Unsigned Short<br />
| A bit mask which specifies which sections are not empty in this chunk<br />
|-<br />
|colspan="2"| Chunk Data<br />
|colspan="2"| Array of [[SMP Map Format#Data|Chunk]]<br />
| Each chunk in this array corresponds to the data at the same position in Chunk Meta<br />
|}<br />
<br />
==== 爆炸 ====<br />
<br />
Sent when an explosion occurs (creepers, TNT, and ghast fireballs).<br />
<br />
Each block in Records is set to air. Coordinates for each axis in record is int(X) + record.x<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="9"| 0x27<br />
|rowspan="9"| Play<br />
|rowspan="9"| Client<br />
| X<br />
| Float<br />
| <br />
|-<br />
| Y<br />
| Float<br />
| <br />
|-<br />
| Z<br />
| Float<br />
| <br />
|-<br />
| Radius<br />
| Float<br />
| Currently unused in the client<br />
|-<br />
| Record Count<br />
| Int<br />
| Number of elements in the following array<br />
|-<br />
| Records<br />
| Array of (Byte, Byte, Byte)<br />
| Each record is 3 signed bytes long, each bytes are the XYZ (respectively) offsets of affected blocks.<br />
|-<br />
| Player Motion X<br />
| Float<br />
| X velocity of the player being pushed by the explosion<br />
|-<br />
| Player Motion Y<br />
| Float<br />
| Y velocity of the player being pushed by the explosion<br />
|-<br />
| Player Motion Z<br />
| Float<br />
| Z velocity of the player being pushed by the explosion<br />
|}<br />
<br />
==== 属性 ====<br />
<br />
Sent when a client is to play a sound or particle effect.<br />
<br />
By default, the Minecraft client adjusts the volume of sound effects based on distance. The final boolean field is used to disable this, and instead the effect is played from 2 blocks away in the correct direction. Currently this is only used for effect 1013 (mob.wither.spawn), and is ignored for any other value by the client.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="4"| 0x28<br />
|rowspan="4"| Play<br />
|rowspan="4"| Client<br />
| Effect ID<br />
| Int<br />
| The ID of the effect, see below<br />
|-<br />
| Location<br />
| Position<br />
| The location of the effect<br />
|-<br />
| Data<br />
| Int<br />
| Extra data for certain effects, see below<br />
|-<br />
| Disable Relative Volume<br />
| Boolean<br />
| See above<br />
|}<br />
<br />
Effect IDs:<br />
<br />
{| class="wikitable"<br />
! ID<br />
! Name<br />
! Data<br />
|-<br />
!colspan="3"| Sound<br />
|-<br />
| 1000<br />
| <code>random.click</code><br />
| <br />
|-<br />
| 1001<br />
| <code>random.click</code><br />
| <br />
|-<br />
| 1002<br />
| <code>random.bow</code><br />
| <br />
|-<br />
| 1003<br />
| <code>random.door_open</code> or <code>random.door_close</code> (50/50 chance)<br />
| <br />
|-<br />
| 1004<br />
| <code>random.fizz</code><br />
| <br />
|-<br />
| 1005<br />
| Play a music disc.<br />
| {{Minecraft Wiki|Music Discs|Record ID}}<br />
|-<br />
| 1006<br />
| ''not assigned''<br />
| <br />
|-<br />
| 1007<br />
| <code>mob.ghast.charge</code><br />
| <br />
|-<br />
| 1008<br />
| <code>mob.ghast.fireball</code><br />
| <br />
|-<br />
| 1009<br />
| <code>mob.ghast.fireball</code>, but with a lower volume<br />
| <br />
|-<br />
| 1010<br />
| <code>mob.zombie.wood</code><br />
| <br />
|-<br />
| 1011<br />
| <code>mob.zombie.metal</code><br />
| <br />
|-<br />
| 1012<br />
| <code>mob.zombie.woodbreak</code><br />
| <br />
|-<br />
| 1013<br />
| <code>mob.wither.spawn</code><br />
| <br />
|-<br />
| 1014<br />
| <code>mob.wither.shoot</code><br />
| <br />
|-<br />
| 1015<br />
| <code>mob.bat.takeoff</code><br />
| <br />
|-<br />
| 1016<br />
| <code>mob.zombie.infect</code><br />
| <br />
|-<br />
| 1017<br />
| <code>mob.zombie.unfect</code><br />
| <br />
|-<br />
| 1018<br />
| <code>mob.enderdragon.end</code><br />
| <br />
|-<br />
| 1020<br />
| <code>random.anvil_break</code><br />
| <br />
|-<br />
| 1021<br />
| <code>random.anvil_use</code><br />
| <br />
|-<br />
| 1022<br />
| <code>random.anvil_land</code><br />
| <br />
|-<br />
!colspan="3"| Particle<br />
|-<br />
| 2000<br />
| Spawns 10 smoke particles, e.g. from a fire<br />
| Direction, see below<br />
|-<br />
| 2001<br />
| Block break<br />
| {{Minecraft Wiki|Data values|Block ID}}<br />
|-<br />
| 2002<br />
| Splash potion. Particle effect + glass break sound.<br />
| [http://www.lb-stuff.com/Minecraft/PotionDataValues1.9pre3.txt Potion ID]<br />
|-<br />
| 2003<br />
| Eye of Ender entity break animation — particles and sound<br />
| <br />
|-<br />
| 2004<br />
| Mob spawn particle effect: smoke + flames<br />
| <br />
|-<br />
| 2005<br />
| Spawn “happy villager” effect (green crosses), used for bonemealing vegetation<br />
| <br />
|}<br />
<br />
Smoke directions:<br />
<br />
{| class="wikitable"<br />
! ID<br />
! Direction<br />
|-<br />
| 0<br />
| South-East<br />
|-<br />
| 1<br />
| South<br />
|-<br />
| 2<br />
| South-West<br />
|-<br />
| 3<br />
| East<br />
|-<br />
| 4<br />
| (Up or middle ?)<br />
|-<br />
| 5<br />
| West<br />
|-<br />
| 6<br />
| North-East<br />
|-<br />
| 7<br />
| North<br />
|-<br />
| 8<br />
| North-West<br />
|}<br />
<br />
==== 声音特效 ====<br />
<br />
Used to play a sound effect on the client.<br />
<br />
Custom sounds may be added by resource packs.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="6"| 0x29<br />
|rowspan="6"| Play<br />
|rowspan="6"| Client<br />
| Sound name<br />
| String<br />
| All known sound effect names can be seen [https://github.com/SirCmpwn/Craft.Net/blob/master/source/Craft.Net.Common/SoundEffect.cs here]<br />
|-<br />
| Effect position X<br />
| Int<br />
| Effect X multiplied by 8<br />
|-<br />
| Effect position Y<br />
| Int<br />
| Effect Y multiplied by 8<br />
|-<br />
| Effect position Z<br />
| Int<br />
| Effect Z multiplied by 8<br />
|-<br />
| Volume<br />
| Float<br />
| 1 is 100%, can be more<br />
|-<br />
| Pitch<br />
| Unsigned Byte<br />
| 63 is 100%, can be more<br />
|}<br />
<br />
==== 粒子效果 ====<br />
<br />
Displays the named particle<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="11"| 0x2A<br />
|rowspan="11"| Play<br />
|rowspan="11"| Client<br />
| Particle ID<br />
| Int<br />
| See below<br />
|-<br />
| Long Distance<br />
| Boolean<br />
| If true, particle distance increases from 256 to 65536<br />
|-<br />
| X<br />
| Float<br />
| X position of the particle<br />
|-<br />
| Y<br />
| Float<br />
| Y position of the particle<br />
|-<br />
| Z<br />
| Float<br />
| Z position of the particle<br />
|-<br />
| Offset X<br />
| Float<br />
| This is added to the X position after being multiplied by random.nextGaussian()<br />
|-<br />
| Offset Y<br />
| Float<br />
| This is added to the Y position after being multiplied by random.nextGaussian()<br />
|-<br />
| Offset Z<br />
| Float<br />
| This is added to the Z position after being multiplied by random.nextGaussian()<br />
|-<br />
| Particle Data<br />
| Float<br />
| The data of each particle<br />
|-<br />
| Particle Count<br />
| Int<br />
| The number of particles to create<br />
|-<br />
| Data<br />
| Array of VarInt<br />
| Length depends on particle. "iconcrack" has length of 2, "blockcrack", and "blockdust" have lengths of 1, the rest have 0.<br />
|}<br />
<br />
Particle IDs:<br />
<br />
{| class="wikitable"<br />
|-<br />
! Particle Name<br />
! Particle ID<br />
|-<br />
| explode<br />
| 0<br />
|-<br />
| largeexplosion<br />
| 1<br />
|-<br />
| hugeexplosion<br />
| 2<br />
|-<br />
| fireworksSpark<br />
| 3<br />
|-<br />
| bubble<br />
| 4<br />
|-<br />
| splash<br />
| 5<br />
|-<br />
| wake<br />
| 6<br />
|-<br />
| suspended<br />
| 7<br />
|-<br />
| depthsuspend<br />
| 8<br />
|-<br />
| crit<br />
| 9<br />
|-<br />
| magicCrit<br />
| 10<br />
|-<br />
| smoke<br />
| 11<br />
|-<br />
| largesmoke<br />
| 12<br />
|-<br />
| spell<br />
| 13<br />
|-<br />
| instantSpell<br />
| 14<br />
|-<br />
| mobSpell<br />
| 15<br />
|-<br />
| mobSpellAmbient<br />
| 16<br />
|-<br />
| witchMagic<br />
| 17<br />
|-<br />
| dripWater<br />
| 18<br />
|-<br />
| dripLava<br />
| 19<br />
|-<br />
| angryVillager<br />
| 20<br />
|-<br />
| happyVillager<br />
| 21<br />
|-<br />
| townaura<br />
| 22<br />
|-<br />
| note<br />
| 23<br />
|-<br />
| portal<br />
| 24<br />
|-<br />
| enchantmenttable<br />
| 25<br />
|-<br />
| flame<br />
| 26<br />
|-<br />
| lava<br />
| 27<br />
|-<br />
| footstep<br />
| 28<br />
|-<br />
| cloud<br />
| 29<br />
|-<br />
| reddust<br />
| 30<br />
|-<br />
| snowballpoof<br />
| 31<br />
|-<br />
| snowshovel<br />
| 32<br />
|-<br />
| slime<br />
| 33<br />
|-<br />
| heart<br />
| 34<br />
|-<br />
| barrier<br />
| 35<br />
|-<br />
| iconcrack_(id)_(data)<br />
| 36<br />
|-<br />
| blockcrack_(id+(data<<12))<br />
| 37<br />
|-<br />
| blockdust_(id)<br />
| 38<br />
|-<br />
| droplet<br />
| 39<br />
|-<br />
| take<br />
| 40<br />
|-<br />
| mobappearance<br />
| 41<br />
|}<br />
<br />
==== 改变游戏状态 ====<br />
<br />
It appears when a bed can't be used as a spawn point and when the rain state changes.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="2"| 0x2B<br />
|rowspan="2"| Play<br />
|rowspan="2"| Client<br />
| Reason<br />
| Unsigned Byte<br />
| See below<br />
|-<br />
| Value<br />
| Float<br />
| Depends on Reason<br />
|}<br />
<br />
''Reason codes'':<br />
<br />
{| class="wikitable"<br />
! Reason<br />
! Effect<br />
! Value<br />
|-<br />
| 0<br />
| Invalid Bed<br />
| <br />
|-<br />
| 1<br />
| End raining<br />
| <br />
|-<br />
| 2<br />
| Begin raining<br />
| <br />
|-<br />
| 3<br />
| Change game mode<br />
| 0: Survival, 1: Creative, 2: Adventure, 3: Spectator<br />
|-<br />
| 4<br />
| Enter credits<br />
| <br />
|-<br />
| 5<br />
| Demo message<br />
| 0: Show welcome to demo screen, 101: Tell movement controls, 102: Tell jump control, 103: Tell inventory control<br />
|- <br />
| 6<br />
| Arrow hitting player<br />
| Appears to be played when an arrow strikes another player in Multiplayer<br />
|-<br />
| 7<br />
| Fade value<br />
| The current darkness value. 1 = Dark, 0 = Bright, Setting the value higher causes the game to change color and freeze<br />
|-<br />
| 8<br />
| Fade time<br />
| Time in ticks for the sky to fade<br />
|-<br />
| 10<br />
| Play mob appearance (effect and sound)<br />
| Unknown<br />
|}<br />
<br />
==== 生存全局实体 ====<br />
<br />
With this packet, the server notifies the client of thunderbolts striking within a 512 block radius around the player. The coordinates specify where exactly the thunderbolt strikes.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="5"| 0x2C<br />
|rowspan="5"| Play<br />
|rowspan="5"| Client<br />
| Entity ID<br />
| VarInt<br />
| The EID of the thunderbolt<br />
|-<br />
| Type<br />
| Byte<br />
| The global entity type, currently always 1 for thunderbolt<br />
|-<br />
| X<br />
| Int<br />
| Thunderbolt X, a [[Data Types#Fixed-point numbers|fixed-point number]]<br />
|-<br />
| Y<br />
| Int<br />
| Thunderbolt Y, a [[Data Types#Fixed-point numbers|fixed-point number]]<br />
|-<br />
| Z<br />
| Int<br />
| Thunderbolt Z, a [[Data Types#Fixed-point numbers|fixed-point number]]<br />
|}<br />
<br />
==== 打开窗户 ====<br />
<br />
This is sent to the client when it should open an inventory, such as a chest, workbench, or furnace. This message is not sent anywhere for clients opening their own inventory.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="5"| 0x2D<br />
|rowspan="5"| Play<br />
|rowspan="5"| Client<br />
| Window ID<br />
| Unsigned Byte<br />
| A unique id number for the window to be displayed. Notchian server implementation is a counter, starting at 1.<br />
|-<br />
| Window Type<br />
| String<br />
| The window type to use for display. See [[Inventory]] for a list.<br />
|-<br />
| Window Title<br />
| [[Chat]]<br />
| The title of the window<br />
|-<br />
| Number Of Slots<br />
| Unsigned Byte<br />
| Number of slots in the window (excluding the number of slots in the player inventory)<br />
|-<br />
| Entity ID<br />
| Optional Int<br />
| EntityHorse's EID. Only sent when Window Type is “EntityHorse”<br />
|}<br />
<br />
See [[Inventory]] for further information.<br />
<br />
==== 关闭窗户 ====<br />
<br />
This packet is sent from the server to the client when a window is forcibly closed, such as when a chest is destroyed while it's open.<br />
<br />
Note, notchian clients send a close window packet with Window ID 0 to close their inventory even though there is never an [[#Open Window|Open Window]] packet for inventory. <br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
| 0x2E<br />
|rowspan="1"| Play<br />
|rowspan="1"| Client<br />
| Window ID<br />
| Unsigned Byte<br />
| This is the ID of the window that was closed. 0 for inventory.<br />
|}<br />
<br />
==== 设置位置 ====<br />
<br />
Sent by the server when an item in a slot (in a window) is added/removed.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="3"| 0x2F<br />
|rowspan="3"| Play<br />
|rowspan="3"| Client<br />
| Window ID<br />
| Byte<br />
| The window which is being updated. 0 for player inventory. Note that all known window types include the player inventory. This packet will only be sent for the currently opened window while the player is performing actions, even if it affects the player inventory. After the window is closed, a number of these packets are sent to update the player's inventory window (0).<br />
|-<br />
| Slot<br />
| Short<br />
| The slot that should be updated<br />
|-<br />
| Slot Data<br />
| [[Slot Data|Slot]]<br />
| <br />
|}<br />
<br />
==== 窗口物品 ====<br />
<br />
[[File:Inventory-slots.png|thumb|The inventory slots]]<br />
<br />
Sent by the server when items in multiple slots (in a window) are added/removed. This includes the main inventory, equipped armour and crafting slots.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="3"| 0x30<br />
|rowspan="3"| Play<br />
|rowspan="3"| Client<br />
| Window ID<br />
| Unsigned Byte<br />
| The ID of window which items are being sent for. 0 for player inventory.<br />
|-<br />
| Count<br />
| Short<br />
| Number of elements in the following array<br />
|-<br />
| Slot Data<br />
| Array of [[Slot Data|Slot]]<br />
| <br />
|}<br />
<br />
See [[Inventory#Windows|inventory windows]] for further information about how slots are indexed.<br />
<br />
==== Window Property ====<br />
<br />
This packet is used to inform the client that part of a GUI window should be updated.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="3"| 0x31<br />
|rowspan="3"| Play<br />
|rowspan="3"| Client<br />
| Window ID<br />
| Unsigned Byte<br />
| <br />
|-<br />
| Property<br />
| Short<br />
| The property to be updated, see below<br />
|-<br />
| Value<br />
| Short<br />
| The new value for the property, see below<br />
|}<br />
<br />
The meaning of the Property field depends on the type of the window. The following table shows the known combinations of window type and property, and how the value is to be interpreted.<br />
<br />
{| class="wikitable"<br />
|-<br />
! Window type<br />
! Property<br />
! Value<br />
|-<br />
|rowspan="2"| Furnace<br />
| 0: Progress arrow<br />
| 0–200 (presumably in in-game ticks)<br />
|-<br />
| 1: Fire icon (fuel)<br />
| 0–200 (presumably in in-game ticks)<br />
|-<br />
|rowspan="7"| Enchantment Table<br />
| 0: Level requirement for top enchantment slot<br />
|rowspan="3"| The enchantment's xp level requirement<br />
|-<br />
| 1: Level requirement for middle enchantment slot<br />
|-<br />
| 2: Level requirement for bottom enchantment slot<br />
|-<br />
| 3: The seed for generating the enchantments view for the client<br />
| Unknown<br />
|-<br />
| 4: tooltip shown on mouse hover over top enchantment slot<br />
|rowspan="3"| Unknown (set to -1 to hide it)<br />
|-<br />
| 5: tooltip shown on mouse hover over middle enchantment slot<br />
|-<br />
| 6: tooltip shown on mouse hover over bottom enchantment slot<br />
|-<br />
|rowspan="3"| Beacon<br />
| 0: Power level<br />
| Unknown<br />
|-<br />
| 1: First potion effect<br />
| Unknown<br />
|-<br />
| 2: Second potion effect<br />
| Unknown<br />
|-<br />
| Anvil<br />
| 0: Repair cost<br />
| The repair's cost in xp levels<br />
|-<br />
| Brewing Stand<br />
| 0: Brew time<br />
| 0–400, with 400 making the arrow empty, and 0 making the arrow full<br />
|}<br />
<br />
==== 确认事物 ====<br />
<br />
A packet from the server indicating whether a request from the client was accepted, or whether there was a conflict (due to lag).<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="3"| 0x32<br />
|rowspan="3"| Play<br />
|rowspan="3"| Client<br />
| Window ID<br />
| Byte<br />
| The ID of the window that the action occurred in<br />
|-<br />
| Action Number<br />
| Short<br />
| Every action that is to be accepted has a unique number. This field corresponds to that number.<br />
|-<br />
| Accepted<br />
| Boolean<br />
| Whether the action was accepted<br />
|}<br />
<br />
==== 更新标志 ====<br />
<br />
This message is sent from the server to the client whenever a sign is discovered or created. This message is NOT sent when a sign is destroyed or unloaded.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="5"| 0x33<br />
|rowspan="5"| Play<br />
|rowspan="5"| Client<br />
| Location<br />
| Position<br />
| <br />
|-<br />
| Line 1<br />
| [[Chat]]<br />
| First line of text in the sign<br />
|-<br />
| Line 2<br />
| [[Chat]]<br />
| Second line of text in the sign<br />
|-<br />
| Line 3<br />
| [[Chat]]<br />
| Third line of text in the sign<br />
|-<br />
| Line 4<br />
| [[Chat]]<br />
| Fourth line of text in the sign<br />
|}<br />
<br />
==== 地图 ====<br />
<br />
Updates a rectangular area on a map.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
!colspan="2"| Field Name<br />
!colspan="2"| Field Type<br />
! Notes<br />
|-<br />
|rowspan="12"| 0x34<br />
|rowspan="12"| Play<br />
|rowspan="12"| Client<br />
|colspan="2"| Item Damage<br />
|colspan="2"| VarInt<br />
| The damage value (map ID) of the map being modified<br />
|-<br />
|colspan="2"| Scale<br />
|colspan="2"| Byte<br />
| <br />
|- <br />
|colspan="2"| Icon Count<br />
|colspan="2"| VarInt<br />
| Number of elements in the following array<br />
|-<br />
|rowspan="3"| Icon<br />
| Direction And Type<br />
|rowspan="3"| Array<br />
| Byte<br />
| 0xF0 = Direction, 0x0F = Type<br />
|-<br />
| X<br />
| Byte<br />
| <br />
|-<br />
| Z<br />
| Byte<br />
| <br />
|- <br />
|colspan="2"| Columns<br />
|colspan="2"| Byte<br />
| Number of columns updated<br />
|-<br />
|colspan="2"| Rows<br />
|colspan="2"| Optional Byte<br />
| Only if Columns is more than 0; number of rows updated<br />
|-<br />
|colspan="2"| X<br />
|colspan="2"| Optional Byte<br />
| Only if Columns is more than 0; x offset of the westernmost column<br />
|-<br />
|colspan="2"| Z<br />
|colspan="2"| Optional Byte<br />
| Only if Columns is more than 0; z offset of the northernmost row<br />
|-<br />
|colspan="2"| Length<br />
|colspan="2"| Optional VarInt<br />
| Only if Columns is more than 0; length of the following array<br />
|-<br />
|colspan="2"| Data<br />
|colspan="2"| Optional Array of Unsigned Byte<br />
| Only if Columns is more than 0; see {{Minecraft Wiki|Map item format}}<br />
|}<br />
<br />
==== 更新方块实体 ====<br />
<br />
Essentially a block update on a block entity.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="3"| 0x35<br />
|rowspan="3"| Play<br />
|rowspan="3"| Client<br />
| Location<br />
| Position<br />
| <br />
|-<br />
| Action<br />
| Unsigned Byte<br />
| The type of update to perform, see below<br />
|-<br />
| NBT Data<br />
| Optional [[NBT|NBT Tag]]<br />
| If not present then it's a TAG_END (0)<br />
|}<br />
<br />
''Action'' field:<br />
<br />
* '''1''': Set SpawnPotentials of a mob spawner<br />
* '''2''': Set command block text (command and last execution status)<br />
* '''3''': Set the level, primary, and secondary powers of a beacon<br />
* '''4''': Set rotation and skin of mob head<br />
* '''5''': Set type of flower in flower pot<br />
* '''6''': Set base color and patterns on a banner<br />
<br />
==== 打开标志牌编辑器 ====<br />
<br />
Sent on placement of sign.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="1"| 0x36<br />
|rowspan="1"| Play<br />
|rowspan="1"| Client<br />
| Location<br />
| Position<br />
| <br />
|}<br />
<br />
==== 统计数据 ====<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To <br />
!colspan="2"| Field Name<br />
!colspan="2"| Field Type<br />
! Notes<br />
|-<br />
|rowspan="3"| 0x37<br />
|rowspan="3"| Play<br />
|rowspan="3"| Client<br />
|colspan="2"| Count<br />
|colspan="2"| VarInt<br />
| Number of elements in the following array<br />
|-<br />
|rowspan="2"| Statistic<br />
| Name<br />
|rowspan="2"| Array<br />
| String<br />
| [https://gist.github.com/thinkofdeath/a1842c21a0cf2e1fb5e0 https://gist.github.com/thinkofdeath/a1842c21a0cf2e1fb5e0]<br />
|-<br />
| Value<br />
| VarInt<br />
| The amount to set it to<br />
|}<br />
<br />
==== 玩家列表项 ====<br />
<br />
Sent by the notchian server to update the user list (<tab> in the client).<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
!colspan="4"| Field Name<br />
!colspan="3"| Field Type<br />
! Notes<br />
|-<br />
|rowspan="19"| 0x38<br />
|rowspan="19"| Play<br />
|rowspan="19"| Client<br />
|colspan="4"| Action<br />
|colspan="3"| VarInt<br />
| Determines the rest of the Player format after the UUID<br />
|-<br />
|colspan="4"| Number Of Players<br />
|colspan="3"| VarInt<br />
| Number of elements in the following array<br />
|-<br />
|rowspan="17"| Player<br />
|colspan="3"| UUID<br />
|rowspan="17"| Array<br />
|colspan="2"| UUID<br />
| <br />
|-<br />
! Action<br />
!colspan="2"| Field Name<br />
!colspan="2"| <br />
! <br />
|-<br />
|rowspan="10"| 0: add player<br />
|colspan="2"| Name<br />
|colspan="2"| String<br />
| <br />
|-<br />
|colspan="2"| Number Of Properties<br />
|colspan="2"| VarInt<br />
| Number of elements in the following array<br />
|-<br />
|rowspan="4"| Property<br />
| Name<br />
|rowspan="4"| Array<br />
| String<br />
| <br />
|-<br />
| Value<br />
| String<br />
| <br />
|- <br />
| Is Signed<br />
| Boolean<br />
| <br />
|-<br />
| Signature<br />
| Optional String<br />
| Only if Is Signed is true<br />
|-<br />
|colspan="2"| Gamemode<br />
|colspan="2"| VarInt<br />
| <br />
|-<br />
|colspan="2"| Ping<br />
|colspan="2"| VarInt<br />
| <br />
|-<br />
|colspan="2"| Has Display Name<br />
|colspan="2"| Boolean<br />
| <br />
|-<br />
|colspan="2"| Display Name<br />
|colspan="2"| Optional [[Chat]]<br />
| Only if Has Display Name is true<br />
|-<br />
| 1: update gamemode<br />
|colspan="2"| Gamemode<br />
|colspan="2"| VarInt<br />
| <br />
|- <br />
| 2: update latency<br />
|colspan="2"| Ping<br />
|colspan="2"| VarInt<br />
| <br />
|-<br />
|rowspan="2"| 3: update display name<br />
|colspan="2"| Has Display Name<br />
|colspan="2"| Boolean<br />
| <br />
|-<br />
|colspan="2"| Display Name<br />
|colspan="2"| Optional [[Chat]]<br />
| Only send if Has Display Name is true<br />
|-<br />
| 4: remove player<br />
|colspan="2"| ''no fields''<br />
|colspan="2"| ''no fields''<br />
| <br />
|}<br />
<br />
==== 玩家能力 ====<br />
<br />
The latter 2 floats are used to indicate the walking and flying speeds respectively, while the first byte is used to determine the value of 4 booleans.<br />
<br />
The flags are whether damage is disabled (god mode, 8, bit 3), whether the player can fly (4, bit 2), whether the player is flying (2, bit 1), and whether the player is in creative mode (1, bit 0).<br />
<br />
To get the values of these booleans, simply AND (&) the byte with 1,2,4 and 8 respectively, to get the 0 or 1 bitwise value. To set them OR (|) them with their repspective masks.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="3"| 0x39<br />
|rowspan="3"| Play<br />
|rowspan="3"| Client<br />
| Flags<br />
| Byte<br />
| Bit mask, see above<br />
|-<br />
| Flying Speed<br />
| Float<br />
| <br />
|-<br />
| Walking Speed<br />
| Float<br />
| <br />
|}<br />
<br />
==== Tab补全 ====<br />
<br />
The server responds with a list of auto-completions of the last word sent to it. In the case of regular chat, this is a player username. Command names and parameters are also supported.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="2"| 0x3A<br />
|rowspan="2"| Play<br />
|rowspan="2"| Client<br />
| Count<br />
| VarInt<br />
| Number of elements in the following array<br />
|-<br />
| Matches<br />
| Array of String<br />
| One eligible command, note that each command is sent separately instead of in a single string, hence the need for Count<br />
|}<br />
<br />
==== 计分板目标 ====<br />
<br />
This is sent to the client when it should create a new {{Minecraft Wiki|scoreboard}} objective or remove one.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="4"| 0x3B<br />
|rowspan="4"| Play<br />
|rowspan="4"| Client<br />
| Objective Name<br />
| String<br />
| An unique name for the objective<br />
|-<br />
| Mode<br />
| Byte<br />
| 0 to create the scoreboard. 1 to remove the scoreboard. 2 to update the display text. <br />
|-<br />
| Objective Value<br />
| Optional String<br />
| Only if mode is 0 or 2. The text to be displayed for the score<br />
|-<br />
| Type<br />
| Optional String<br />
| Only if mode is 0 or 2. “integer” or “hearts”<br />
|}<br />
<br />
==== 更新分数 ====<br />
<br />
This is sent to the client when it should update a scoreboard item. <br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="4"| 0x3C<br />
|rowspan="4"| Play<br />
|rowspan="4"| Client<br />
| Score Name<br />
| String<br />
| The name of the score to be updated or removed<br />
|-<br />
| Action<br />
| Byte<br />
| 0 to create/update an item. 1 to remove an item.<br />
|-<br />
| Objective Name<br />
| String<br />
| The name of the objective the score belongs to<br />
|-<br />
| Value<br />
| Optional VarInt<br />
| The score to be displayed next to the entry. Only sent when Action does not equal 1.<br />
|}<br />
<br />
==== 显示计分板 ====<br />
<br />
This is sent to the client when it should display a scoreboard.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="2"| 0x3D<br />
|rowspan="2"| Play<br />
|rowspan="2"| Client<br />
| Position<br />
| Byte<br />
| The position of the scoreboard. 0: list, 1: sidebar, 2: below name.<br />
|-<br />
| Score Name<br />
| String<br />
| The unique name for the scoreboard to be displayed.<br />
|}<br />
<br />
==== 团队 ====<br />
<br />
Creates and updates teams.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="10"| 0x3E<br />
|rowspan="10"| Play<br />
|rowspan="10"| Client<br />
| Team Name<br />
| String<br />
| A unique name for the team. (Shared with scoreboard).<br />
|-<br />
| Mode<br />
| Byte<br />
| If 0 then the team is created.<br />
<br />
If 1 then the team is removed. <br />
<br />
If 2 the team team information is updated. <br />
<br />
If 3 then new players are added to the team. <br />
<br />
If 4 then players are removed from the team.<br />
|-<br />
| Team Display Name<br />
| Optional String<br />
| Only if Mode = 0 or 2.<br />
|-<br />
| Team Prefix<br />
| Optional String<br />
| Only if Mode = 0 or 2. Displayed before the players' name that are part of this team<br />
|-<br />
| Team Suffix<br />
| Optional String<br />
| Only if Mode = 0 or 2. Displayed after the players' name that are part of this team<br />
|-<br />
| Friendly Fire<br />
| Optional Byte<br />
| Only if Mode = 0 or 2. 0 for off, 1 for on, 3 for seeing friendly invisibles<br />
|-<br />
| Name Tag Visibility<br />
| Optional String<br />
| Only if Mode = 0 or 2. always, hideForOtherTeams, hideForOwnTeam, never<br />
|-<br />
| Color<br />
| Optional Byte<br />
| Only if Mode = 0 or 2. Same as [[Chat]] colors<br />
|-<br />
| Player Count<br />
| Optional VarInt<br />
| Only if Mode = 0 or 3 or 4. Number of players in the array<br />
|-<br />
| Players<br />
| Optional Array of String<br />
| Only if Mode = 0 or 3 or 4. Players to be added/remove from the team. Max 40 characters so may be uuid's later<br />
|}<br />
<br />
==== 插件信息 ====<br />
<br />
Mods and plugins can use this to send their data. Minecraft itself uses a number of [[plugin channel]]s. These internal channels are prefixed with <code>MC|</code>.<br />
<br />
More documentation on this: [http://dinnerbone.com/blog/2012/01/13/minecraft-plugin-channels-messaging/ http://dinnerbone.com/blog/2012/01/13/minecraft-plugin-channels-messaging/]<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="2"| 0x3F<br />
|rowspan="2"| Play<br />
|rowspan="2"| Client<br />
| Channel<br />
| String<br />
| Name of the [[plugin channel]] used to send the data<br />
|-<br />
| Data<br />
| Byte Array<br />
| Any data, depending on the channel. <code><nowiki>MC|</nowiki></code> channels are documented [[plugin channel|here]].<br />
|}<br />
<br />
==== 断开连接 ====<br />
<br />
Sent by the server before it disconnects a client. The server assumes that the sender has already closed the connection by the time the packet arrives.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
| 0x40<br />
|rowspan="1"| Play<br />
|rowspan="1"| Client<br />
| Reason<br />
| [[Chat]]<br />
| Displayed to the client when the connection terminates.<br />
|}<br />
<br />
==== 服务器难度 ====<br />
<br />
Changes the difficulty setting in the client's option menu<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="1"| 0x41<br />
|rowspan="1"| Play<br />
|rowspan="1"| Client<br />
| Difficulty<br />
| Unsigned Byte<br />
| 0: peaceful, 1: easy, 2: normal, 3: hard<br />
|}<br />
<br />
==== 战斗事件 ====<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="6"| 0x42<br />
|rowspan="6"| Play<br />
|rowspan="6"| Client<br />
| Event<br />
| VarInt<br />
| 0: enter combat, 1: end combat, 2: entity dead<br />
|-<br />
| Duration<br />
| Optional VarInt<br />
| Only for end combat<br />
|-<br />
| Player ID<br />
| Optional VarInt<br />
| Only for entity dead<br />
|-<br />
| Entity ID<br />
| Optional Int<br />
| Only for end combat and entity dead<br />
|-<br />
| Message<br />
| String<br />
| Only for entity dead<br />
|}<br />
<br />
==== 摄像机 ====<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="1"| 0x43<br />
|rowspan="1"| Play<br />
|rowspan="1"| Client<br />
| Camera ID<br />
| VarInt<br />
| <br />
|}<br />
<br />
==== 世界边界 ==== <br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
!colspan="2"| Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="18"| 0x44<br />
|rowspan="18"| Play<br />
|rowspan="18"| Client<br />
|colspan="2"| Action<br />
| VarInt<br />
| Determines the format of the rest of the packet<br />
|-<br />
! Action<br />
! Field Name<br />
! <br />
! <br />
|-<br />
| 0: set size<br />
| Radius<br />
| Double<br />
| meters<br />
|-<br />
|rowspan="3"| 1: lerp size<br />
| Old Radius<br />
| Double<br />
| meters<br />
|-<br />
| New Radius<br />
| Double<br />
| meters<br />
|-<br />
| Speed<br />
| VarLong<br />
| number of real-time ticks/seconds (?) until New Radius is reached. From experiments, it appears that Notchian server does not sync world border speed to game ticks, so it gets out of sync with server lag<br />
|-<br />
|rowspan="2"| 2: set center<br />
| X<br />
| Double<br />
| <br />
|-<br />
| Z<br />
| Double<br />
| <br />
|-<br />
|rowspan="8"| 3: initialize<br />
| X<br />
| Double<br />
| <br />
|-<br />
| Z<br />
| Double<br />
| <br />
|-<br />
| Old Radius<br />
| Double<br />
| <br />
|-<br />
| New Radius<br />
| Double<br />
| <br />
|-<br />
| Speed<br />
| VarLong<br />
| <br />
|-<br />
| Portal Teleport Boundary<br />
| VarInt<br />
| Resulting coordinates from a portal teleport are limited to +-value. Usually 29999984.<br />
|-<br />
| Warning Time<br />
| VarInt<br />
| <br />
|-<br />
| Warning Blocks<br />
| VarInt<br />
| <br />
|-<br />
|rowspan="1"| 4: set warning time<br />
| Warning Time<br />
| VarInt<br />
| unit?<br />
|-<br />
|rowspan="1"| 5: set warning blocks<br />
| Warning Blocks<br />
| VarInt<br />
| <br />
|}<br />
<br />
==== 显示标题 ==== <br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
!colspan="2"| Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="9"| 0x45<br />
|rowspan="9"| Play<br />
|rowspan="9"| Client<br />
|colspan="2"| Action<br />
| VarInt<br />
| <br />
|-<br />
! Action<br />
! Field Name<br />
! <br />
! <br />
|-<br />
| 0: set title<br />
| Title Text<br />
| [[Chat]]<br />
| <br />
|-<br />
| 1: set subtitle<br />
| Subtitle Text<br />
| [[Chat]]<br />
| <br />
|-<br />
|rowspan="3"| 2: set times and display<br />
| Fade In<br />
| Int<br />
| ticks<br />
|-<br />
| Stay<br />
| Int<br />
| ticks<br />
|-<br />
| Fade Out<br />
| Int<br />
| ticks<br />
|-<br />
| 3: hide<br />
| ''no fields''<br />
| ''no fields''<br />
| <br />
|-<br />
| 4: reset<br />
| ''no fields''<br />
| ''no fields''<br />
| <br />
|}<br />
<br />
“Hide” makes the title disappear, but if you run times again the same title will appear. “Reset” erases the text.<br />
<br />
==== 设置压缩 ====<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="1"| 0x46<br />
|rowspan="1"| Play<br />
|rowspan="1"| Client<br />
| Threshold<br />
| VarInt<br />
| Packets of this size or higher may be compressed<br />
|}<br />
<br />
==== 玩家列表页眉与页脚 ====<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="2"| 0x47<br />
|rowspan="2"| Play<br />
|rowspan="2"| Client<br />
| Header<br />
| [[Chat]]<br />
| <br />
|-<br />
| Footer<br />
| [[Chat]]<br />
| <br />
|}<br />
<br />
==== 发送资源包 ==== <br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="2"| 0x48<br />
|rowspan="2"| Play<br />
|rowspan="2"| Client<br />
| URL<br />
| String<br />
| 资源包的 URL 地址<br />
|-<br />
| Hash<br />
| String<br />
| 一个40个字符的十六进制和小写的[[wikipedia:SHA-1|SHA-1]]哈希的资源包文件。（必须小写）<br />如果不符合上一行的标准， 客户端将不会验证它哈希值及浪费不必要的带宽 — 但仍将把它作为唯一的标识符处理<br />
|}<br />
<br />
==== 更新实体 NBT ==== <br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="2"| 0x49<br />
|rowspan="2"| Play<br />
|rowspan="2"| Client<br />
| Entity ID<br />
| VarInt<br />
| <br />
|-<br />
| Tag<br />
| [[NBT|NBT Tag]]<br />
| <br />
|}<br />
<br />
=== 发送到服务器 ===<br />
<br />
==== 保持连接 ====<br />
<br />
服务器会经常发送一个保持连接包，内含一个随机的ID。客户端必须回应同样的包。<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="1"| 0x00<br />
|rowspan="1"| Play<br />
|rowspan="1"| Server<br />
| Keep Alive ID<br />
| VarInt<br />
| <br />
|}<br />
<br />
==== 聊天信息 ====<br />
<br />
默认服务端会检查信息是否以 '/' 开头。如果不是是，发送者的用户名将被放在消息前并且发送到所有其他客户端（包括原始的发送者）。如果是，服务端认为它是一个命令并尝试处理它。一个长度大于 100 的信息会导致服务端踢出该客户端。这个行为一开始是在不修改服务端的前提下不允许客户端不分段发送长度超过 119（以前的限制）的信息。因为这个原因，原始的服务端保留了在 119 处将消息切片的代码，但是这不是一个协议限制并且可以被跳过。<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="1"| 0x01<br />
|rowspan="1"| Play<br />
|rowspan="1"| Server<br />
| Message<br />
| String<br />
| The client sends the raw input, not [[Chat]]<br />
|}<br />
<br />
==== 使用实体 ====<br />
<br />
这个包在玩家攻击或者右键点击其他实体（一个玩家、矿车等）时从客户端发往服务器。<br />
<br />
一个官方服务端只在被攻击或使用的实体是可视的、在以玩家为中心 4单位 的范围内且与玩家之间没有阻碍时才接受这个包。<br />
<br />
注意：创造模式的中键点击会被客户端解析且被发送为 [[#Creative Inventory Action|创造背包动作]] 包。<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="5"| 0x02<br />
|rowspan="5"| Play<br />
|rowspan="5"| Server<br />
| Target<br />
| VarInt<br />
| <br />
|-<br />
| Type<br />
| VarInt<br />
| 0: interact, 1: attack, 2: interact at<br />
|-<br />
| Target X<br />
| Optional Float<br />
| 只有当类型为 interact at 时<br />
|-<br />
| Target Y<br />
| Optional Float<br />
| 只有当类型为 interact at 时<br />
|-<br />
| Target Z<br />
| Optional Float<br />
| 只有当类型为 interact at 时<br />
|}<br />
<br />
==== 玩家状态 ====<br />
<br />
这个包用于表明玩家正在陆地上（行走/游泳）还是在空中（跳跃/掉落）。<br />
<br />
当从足够高的高度掉落，这个状态从 false 设置为 true 时会受到掉落伤害。受到伤害的数值基于最后状态从 true 设置为 false。 注意有一些运动相关的包包含了这个包。<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="1"| 0x03<br />
|rowspan="1"| Play<br />
|rowspan="1"| Server<br />
| On Ground<br />
| Boolean<br />
| 当对象站在地上时为 true , 反之则为 false<br />
|}<br />
<br />
==== 玩家坐标 ====<br />
<br />
更新玩家在服务器上的 XYZ 坐标。<br />
<br />
如果在服务器上最后记录的位置和这个包设置的新位置之间的距离大于 100 单位，将会导致客户端因为 “You moved too quickly :( (Hacking?)” 而被踢出服务器。<br />
<br />
如果之间的距离大于 10 单位，服务器会在日志中写下警告信息 “<name> moved too quickly!” 和两个三元坐标（可能是运动增量？），但不会踢出客户端。<br />
<br />
如果 X 或 Z 的定点数被设置大于 3.2×10<sup>7</sup> 客户端会因为 “Illegal position” 而被踢出服务器。<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="4"| 0x04<br />
|rowspan="4"| Play<br />
|rowspan="4"| Server<br />
| X<br />
| Double<br />
| 绝对位置<br />
|-<br />
| Feet Y<br />
| Double<br />
| 绝对位置，史蒂夫头部一般在 Y - 1.62<br />
|-<br />
| Z<br />
| Double<br />
| 绝对位置<br />
|-<br />
| On Ground<br />
| Boolean<br />
| 当对象站在地上时为 true , 反之则为 false<br />
|}<br />
<br />
==== 玩家观察 ====<br />
[[File:Minecraft-trig-yaw.png|thumb|The unit circle for yaw]]<br />
[[File:Yaw.png|thumb|The unit circle of yaw, redrawn]]<br />
<br />
更新玩家目前所看的方向。<br />
<br />
偏航（Yaw）以度为单位，并且不遵循经典的三角规则。</div>
梦彗業
https://mineplugin.org/index.php?title=Protocol&diff=5411
Protocol
2017-09-02T14:12:46Z
<p>梦彗業：翻译</p>
<hr />
<div>{{待翻译}}<br />
{{待更新|url=http://wiki.vg/Protocol}}<br />
<br />
这里剖析了最近的 '''[http://wiki.vg/Protocol_Encryption Minecraft协议]'''.<br />
<br />
如果你有疑问, 请查阅下文或在IRC请求帮助 ([irc://irc.freenode.net/mcdevs #mcdevs on irc.freenode.net]).<br />
<br />
'''注意:''' 你可以不受限制地使用这个页面的内容来创建服务端, 客户端, 机器人…… 诸如此类的任何东西…<br />
<br />
== 定义 ==<br />
<br />
Minecraft服务器是基于TCP通讯的。它和客户端使用所谓的 ''数据包''交流. 一个包被通过字节编码后从TCP连接中发送. 数据包的含义取决于其包标识和连接的当前状态. 每个链接从 '''[http://wiki.vg/Handshaking 握手]'''开始, 使用包切换状态 '''[http://wiki.vg/Handshaking 握手]''',( 0x00, serverbound) 和 [[#Login Success|成功登陆]] ([[#Login|登陆]], 0x02, clientbound).<br />
<br />
=== 数据类型 ===<br />
<br />
<!-- Transcluded contents of Data Types article in here - go to that page if you want to edit it --><br />
<br />
{{:Data Types}}<br />
<br />
=== 其他定义 ===<br />
<br />
{| class="wikitable"<br />
|-<br />
! 术语<br />
! 定义<br />
|-<br />
| Player——玩家<br />
| 使用时, 玩家通常使用它来链接到服务端.<br />
|-<br />
| Entity——实体<br />
| 实体相当于玩家、物品、怪物、船和矿车等. 查看 {{Minecraft Wiki|Entity|the Minecraft Wiki article}} 来寻找一个完整的表单.<br />
|-<br />
| EID——实体ID<br />
| An EID — 或者说是实体ID — 是一个用来识别特定实体的4字节序列. 在同一个服务器,没有相同的实体编号.<br />
|-<br />
| XYZ坐标<br />
| 游戏时，可以使用按钮“F3”来在屏幕上查看坐标位置 Y代表高度, X代表东西, Z代表南北.<br />
|-<br />
| 单位“Meter”<br />
| Meter是Minecraft的基本长度单位, 相当于一个方块的长度. “block”一词也许意味着 “meter”或者“cubic meter”.<br />
|}<br />
<br />
== 数据包的格式 ==<br />
<br />
=== 无压缩 ===<br />
<br />
{| class="wikitable"<br />
! 域名称<br />
! 域类型<br />
! 注释<br />
|-<br />
| 长度<br />
| VarInt<br />
| 包数据的长度 + 包序号的长度<br />
|-<br />
| 包序号<br />
| VarInt<br />
| <br />
|-<br />
| 数据<br />
| Byte Array<br />
| 依赖于连接状态和包序号，详见下面的部分。<br />
|}<br />
<br />
=== 压缩 ===<br />
<br />
当一个 [[#Set Compression|设置压缩]] 包被发送，[[wikipedia:Zlib|zlib]] 压缩将会对之后的所有包开启。 包的格式略微改变以包含未压缩前的包的长度。<br />
''译注：注意区分包长度和数据长度，关系：“包”包含“数据”''<br />
{| class=wikitable<br />
! 是否压缩<br />
! 域名称<br />
! 域类型<br />
! 注释<br />
|-<br />
| 否<br />
| 包长度<br />
| VarInt<br />
| 数据长度的长度 + 压缩后的 (包序号 + 数据) 的长度<br />
|-<br />
| 否<br />
| 数据长度<br />
| VarInt<br />
| 未压缩前的 (包序号 + 数据) 的长度 或 0<br />
|-<br />
|rowspan="2"| 是<br />
| 包序号<br />
| Varint<br />
| zlib 压缩后的包序号（详见下面的部分）<br />
|-<br />
| 数据<br />
| Byte Array<br />
| zlib 压缩后的包数据（详见下面的部分）<br />
|}<br />
<br />
包长度域提供的是包中存在的字节的数量，包括数据长度域。<br />
<br />
如果数据长度被设置为 0，则这个包没有被压缩；否则它表示已压缩的包未压缩前的包长度。<br />
<br />
如果包被压缩，压缩前的 (包序号 + 数据) 的长度必须等于或大于 [[#Set Compression|设置压缩]] 包中设置的最小值，否则客户端/服务端将会断开连接。<br />
<br />
压缩能通过发送一个最小值设定为 -1 的 [[#Set Compression|设置压缩]] 包来关闭。<br />
<br />
== 握手协议 ==<br />
<br />
=== 客户端绑定 ===<br />
<br />
因为协议在客户端发送第一个数据包后会立刻切换到另一个阶段，所以握手阶段没有客户端绑定的数据包。<br />
<br />
=== 服务端绑定 ===<br />
<br />
==== 握手协议 ====<br />
<br />
这将使得服务器切换至目标阶段。<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="4"| 0x00<br />
|rowspan="4"| Handshaking<br />
|rowspan="4"| Server<br />
| 协议版本<br />
| VarInt<br />
| See [[protocol version numbers]] (currently 47)<br />
|-<br />
| 服务器地址<br />
| String<br />
| 域名或是IP, 例如： localhost 或是 127.0.0.1<!-- does this support IPv6? --><br />
|- <br />
| 服务器端口<br />
| Unsigned Short<br />
| 默认值为25565<br />
|-<br />
| 下一阶段<br />
| VarInt<br />
| 1 for [[#Status|status]], 2 for [[#Login|login]]<br />
|}<br />
<br />
==== 传统的服务器列表Ping ====<br />
<br />
严格来说这不是当前协议的一部分，传统客户端可能会发送这一数据包来发起（initiate） [[Server List Ping]], 现代服务器也应当能够适当地处理这一数据包。<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
| 0xFE<br />
| Handshaking<br />
| Server<br />
| Payload<br />
| Unsigned Byte<br />
| always 1 (<code>0x01</code>)<br />
|}<br />
<br />
See [[Server List Ping#1.6]] for the details of the protocol that follows this packet.<br />
<br />
== 开始游戏 ==<br />
<br />
=== 发送到客户端 ===<br />
<br />
==== 心跳包 ====<br />
<br />
The server will frequently send out a keep-alive, each containing a random ID. The client must respond with the same packet. If the client does not respond to them for over 30 seconds, the server kicks the client. Vice versa, if the server does not send any keep-alives for 20 seconds, the client will disconnect and yields a "Timed out" exception.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="1"| 0x00<br />
|rowspan="1"| Play<br />
|rowspan="1"| Client<br />
| Keep Alive ID<br />
| VarInt<br />
| <br />
|}<br />
<br />
==== 加入游戏 ====<br />
<br />
See [[Protocol Encryption]] for information on logging in.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="7"| 0x01<br />
|rowspan="7"| Play<br />
|rowspan="7"| Client<br />
| Entity ID<br />
| Int<br />
| The player's Entity ID (EID)<br />
|-<br />
| Gamemode<br />
| Unsigned Byte<br />
| 0: Survival, 1: Creative, 2: Adventure, 3: Spectator. Bit 3 (0x8) is the hardcore flag.<br />
|-<br />
| Dimension<br />
| Byte<br />
| -1: Nether, 0: Overworld, 1: End<br />
|-<br />
| Difficulty<br />
| Unsigned Byte<br />
| 0: peaceful, 1: easy, 2: normal, 3: hard<br />
|-<br />
| Max Players<br />
| Unsigned Byte<br />
| Used by the client to draw the player list<br />
|-<br />
| Level Type<br />
| String<br />
| default, flat, largeBiomes, amplified, default_1_1<br />
|-<br />
| Reduced Debug Info<br />
| Boolean<br />
| If true, a Notchian client shows reduced information on the {{Minecraft Wiki|debug screen}}.<br />
|}<br />
<br />
{{Warning|如果位置无效，服务端将崩溃}}<br />
<br />
==== 聊天内容 ==== <br />
<br />
Identifying the difference between Chat/System Message is important as it helps respect the user's chat visibility options. While Position 2 accepts json formatting it will not display, old style formatting works<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="2"| 0x02<br />
|rowspan="2"| Play<br />
|rowspan="2"| Client<br />
| JSON Data<br />
| [[Chat]]<br />
| Limited to 32767 bytes<br />
|-<br />
| Position<br />
| Byte<br />
| 0: chat (chat box), 1: system message (chat box), 2: above action bar<br />
|}<br />
<br />
{{Warning|错误的JSON将断开连接}}<br />
<br />
==== 时间更新 ====<br />
<br />
Time is based on ticks, where 20 ticks happen every second. There are 24000 ticks in a day, making Minecraft days exactly 20 minutes long.<br />
<br />
The time of day is based on the timestamp modulo 24000. 0 is sunrise, 6000 is noon, 12000 is sunset, and 18000 is midnight.<br />
<br />
The default SMP server increments the time by <code>20</code> every second.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="2"| 0x03<br />
|rowspan="2"| Play<br />
|rowspan="2"| Client<br />
| World Age<br />
| Long<br />
| In ticks; not changed by server commands<br />
|-<br />
| Time of day<br />
| Long<br />
| The world (or region) time, in ticks. If negative the sun will stop moving at the Math.abs of the time<br />
|}<br />
<br />
==== 持有的物品 ====<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="3"| 0x04<br />
|rowspan="3"| Play<br />
|rowspan="3"| Client<br />
| Entity ID<br />
| VarInt<br />
| Entity's EID<br />
|-<br />
| Slot<br />
| Short<br />
| Equipment slot. 0: held, 1–4: armor slot (1: boots, 2: leggings, 3: chestplate, 4: helmet)<br />
|-<br />
| Item<br />
| [[Slot Data|Slot]]<br />
| Item in slot format<br />
|}<br />
<br />
==== 出生姿势 ====<br />
<br />
Sent by the server after login to specify the coordinates of the spawn point (the point at which players spawn at, and which the compass points to). It can be sent at any time to update the point compasses point at.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="1"| 0x05<br />
|rowspan="1"| Play<br />
|rowspan="1"| Client<br />
| Location<br />
| Position<br />
| Spawn location<br />
|}<br />
<br />
==== 更新生命值 ====<br />
<br />
Sent by the server to update/set the health of the player it is sent to.<br />
<br />
Food {{Minecraft Wiki|Food#Hunger vs. Saturation|saturation}} acts as a food “overcharge”. Food values will not decrease while the saturation is over zero. Players logging in automatically get a saturation of 5.0. Eating food increases the saturation as well as the food bar.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="3"| 0x06<br />
|rowspan="3"| Play<br />
|rowspan="3"| Client<br />
| Health<br />
| Float<br />
| 0 or less = dead, 20 = full HP<br />
|-<br />
| Food<br />
| VarInt<br />
| 0–20<br />
|- <br />
| Food Saturation<br />
| Float<br />
| Seems to vary from 0.0 to 5.0 in integer increments<br />
|}<br />
<br />
==== 重生 ====<br />
<br />
来改变玩家的位置(主世界/地狱/末地), 发送给他们一个重生指令, 其次是prechunks或chunks的新位置, and finally a position and look packet. You do not need to unload chunks, the client will do it automatically.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="4"| 0x07<br />
|rowspan="4"| Play<br />
|rowspan="4"| Client<br />
| Dimension<br />
| Int<br />
| -1: The Nether, 0: The Overworld, 1: The End<br />
|-<br />
| Difficulty<br />
| Unsigned Byte<br />
| 0: Peaceful, 1: Easy, 2: Normal, 3: Hard<br />
|-<br />
| Gamemode<br />
| Unsigned Byte<br />
| 0: survival, 1: creative, 2: adventure. The hardcore flag is not included<br />
|-<br />
| Level Type<br />
| String<br />
| Same as [[#Join Game|Join Game]]<br />
|}<br />
<br />
{{Warning|如果位置无效，服务端将崩溃 }}<br />
<br />
{{Warning|如果玩家出现在了相同的位置, weird bugs can occur i.e. such player will be unable to attack other players in new world (修复后他们将重生)}}<br />
<br />
==== 玩家姿势以及看的方向 ==== <br />
<br />
Updates the player's position on the server.<br />
<br />
If the distance between the last known position of the player on the server and the new position set by this packet is greater than 100 meters, the client will be kicked for “You moved too quickly :( (Hacking?)”.<br />
<br />
Also if the fixed-point number of X or Z is set greater than <code>3.2E7D</code> the client will be kicked for “Illegal position”.<br />
<br />
Yaw is measured in degrees, and does not follow classical trigonometry rules. The unit circle of yaw on the XZ-plane starts at (0, 1) and turns counterclockwise, with 90 at (-1, 0), 180 at (0, -1) and 270 at (1, 0). Additionally, yaw is not clamped to between 0 and 360 degrees; any number is valid, including negative numbers and numbers greater than 360.<br />
<br />
Pitch is measured in degrees, where 0 is looking straight ahead, -90 is looking straight up, and 90 is looking straight down.<br />
<br />
The yaw in degrees of a player standing at point (x0, z0) and looking towards point (x, z) can be calculated with:<br />
<br />
l = x-x0<br />
w = z-z0<br />
c = sqrt( l*l + w*w )<br />
alpha1 = -arcsin(l/c)/PI*180<br />
alpha2 = arccos(w/c)/PI*180<br />
if alpha2 > 90 then<br />
yaw = 180 - alpha1<br />
else<br />
yaw = alpha1<br />
<br />
You can get a unit vector from a given yaw/pitch via:<br />
<br />
x = -cos(pitch) * sin(yaw)<br />
y = -sin(pitch)<br />
z = cos(pitch) * cos(yaw)<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="6"| 0x08<br />
|rowspan="6"| Play<br />
|rowspan="6"| Client<br />
| X<br />
| Double<br />
| Absolute or relative position, depending on Flags<br />
|-<br />
| Y<br />
| Double<br />
| Absolute or relative position, depending on Flags<br />
|-<br />
| Z<br />
| Double<br />
| Absolute or relative position, depending on Flags<br />
|-<br />
| Yaw<br />
| Float<br />
| Absolute or relative rotation on the X Axis, in degrees<br />
|-<br />
| Pitch<br />
| Float<br />
| Absolute or relative rotation on the Y Axis, in degrees<br />
|-<br />
| Flags<br />
| Byte<br />
| Bit field, see below<br />
|}<br />
<br />
About the Flags field:<br />
<br />
<Dinnerbone> It's a bitfield, X/Y/Z/Y_ROT/X_ROT. If X is set, the x value is relative and not absolute.<br />
<br />
{| class="wikitable"<br />
|-<br />
! Field<br />
! Bit<br />
|-<br />
| X<br />
| 0x01<br />
|-<br />
| Y<br />
| 0x02<br />
|-<br />
| Z<br />
| 0x04<br />
|-<br />
| Y_ROT<br />
| 0x08<br />
|-<br />
| X_ROT<br />
| 0x10<br />
|}<br />
<br />
==== 持有物品变更 ====<br />
<br />
Sent to change the player's slot selection.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="1"| 0x09<br />
|rowspan="1"| Play<br />
|rowspan="1"| Client<br />
| Slot<br />
| Byte<br />
| The slot which the player has selected (0–8)<br />
|}<br />
<br />
==== 使用床 ==== <br />
<br />
This packet tells that a player goes to bed.<br />
<br />
The client with the matching Entity ID will go into bed mode.<br />
<br />
This Packet is sent to all nearby players including the one sent to bed.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="2"| 0x0A<br />
|rowspan="2"| Play<br />
|rowspan="2"| Client<br />
| Entity ID<br />
| VarInt<br />
| Sleeping player's EID<br />
|-<br />
| Location<br />
| Position<br />
| Block location of the head part of the bed<br />
|}<br />
<br />
==== 动画 ====<br />
<br />
Sent whenever an entity should change animation.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="2"| 0x0B<br />
|rowspan="2"| Play<br />
|rowspan="2"| Client<br />
| Entity ID<br />
| VarInt<br />
| Player ID<br />
|-<br />
| Animation<br />
| Unsigned Byte<br />
| Animation ID (see below)<br />
|}<br />
<br />
Animation can be one of the following values:<br />
<br />
{| class="wikitable"<br />
! ID<br />
! Animation<br />
|-<br />
| 0<br />
| Swing arm<br />
|-<br />
| 1<br />
| Take damage<br />
|-<br />
| 2<br />
| Leave bed<br />
|-<br />
| 3<br />
| Eat food<br />
|-<br />
| 4<br />
| Critical effect<br />
|-<br />
| 5<br />
| Magic critical effect<br />
|}<br />
<br />
==== 生成玩家 ====<br />
<br />
This packet is sent by the server when a player comes into visible range, ''not'' when a player joins.<br />
<br />
This packet must be sent after the [[#Player List Item|Player List Item]] ([[#Play|Play]], 0x38, clientbound) packet that adds the player data for the client to use when spawning a player. If the tab list entry for the UUID included in this packet is not present when this packet arrives, the entity will not be spawned. The tab includes skin/cape data.<br />
<br />
Servers can, however, safely spawn player entities for players not in visible range. The client appears to handle it correctly.<br />
<br />
When in online-mode the UUIDs must be valid and have valid skin blobs, in offline-mode UUID v3 is used.<br />
<br />
For NPCs UUID v2 should be used. Note:<br />
<br />
<+Grum> i will never confirm this as a feature you know that :)<br />
<br />
In an example UUID, <code>xxxxxxxx-xxxx-Yxxx-xxxx-xxxxxxxxxxxx</code>, the UUID version is specified by <code>Y</code>. So, for UUID v3, <code>Y</code> will always be <code>3</code>, and for UUID v2, <code>Y</code> will always be <code>2</code>.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="9"| 0x0C<br />
|rowspan="9"| Play<br />
|rowspan="9"| Client<br />
| Entity ID<br />
| VarInt<br />
| Player's EID<br />
|-<br />
| Player UUID<br />
| UUID<br />
| <br />
|-<br />
| X<br />
| Int<br />
| Player X as a [[Data Types#Fixed-point numbers|Fixed-Point number]]<br />
|-<br />
| Y<br />
| Int<br />
| Player Y as a [[Data Types#Fixed-point numbers|Fixed-Point number]]<br />
|-<br />
| Z<br />
| Int<br />
| Player Z as a [[Data Types#Fixed-point numbers|Fixed-Point number]]<br />
|-<br />
| Yaw<br />
| Angle<br />
| <br />
|-<br />
| Pitch<br />
| Angle<br />
| <br />
|-<br />
| Current Item<br />
| Short<br />
| The item the player is currently holding. Note that this should be 0 for “no item”, unlike -1 used in other packets.<br />
|-<br />
| Metadata<br />
| [[Entities#Entity Metadata Format|Metadata]]<br />
| <br />
|}<br />
<br />
{{Warning|A negative Current Item crashes clients}}<br />
<br />
{{Warning|The client will crash if no Metadata is sent}}<br />
<br />
==== 拾起物品 ====<br />
<br />
Sent by the server when someone picks up an item lying on the ground — its sole purpose appears to be the animation of the item flying towards you. It doesn't destroy the entity in the client memory, and it doesn't add it to your inventory. The server only checks for items to be picked up after each [[#Player Position|Player Position]] (and [[#Player Position And Look|Player Position And Look]]) packet sent by the client.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="2"| 0x0D<br />
|rowspan="2"| Play<br />
|rowspan="2"| Client<br />
| Collected Entity ID<br />
| VarInt<br />
| <br />
|- <br />
| Collector Entity ID<br />
| VarInt<br />
| <br />
|}<br />
<br />
==== 生成对象 ====<br />
<br />
Sent by the server when an Object/Vehicle is created.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="8"| 0x0E<br />
|rowspan="8"| Play<br />
|rowspan="8"| Client<br />
| Entity ID <br />
| VarInt<br />
| EID of the object<br />
|-<br />
| Type<br />
| Byte<br />
| The type of object (See [[Entities#Objects|Objects]])<br />
|-<br />
| X<br />
| Int<br />
| X position as a [[Data Types#Fixed-point numbers|Fixed-Point number]]<br />
|-<br />
| Y<br />
| Int<br />
| Y position as a [[Data Types#Fixed-point numbers|Fixed-Point number]]<br />
|-<br />
| Z<br />
| Int<br />
| Z position as a [[Data Types#Fixed-point numbers|Fixed-Point number]]<br />
|-<br />
| Pitch<br />
| Angle<br />
| <br />
|-<br />
| Yaw<br />
| Angle<br />
| <br />
|-<br />
| Data<br />
| [[Object Data]]<br />
| <br />
|}<br />
<br />
==== 生成怪物 ====<br />
<br />
Sent by the server when a Mob Entity is Spawned<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="12"| 0x0F<br />
|rowspan="12"| Play<br />
|rowspan="12"| Client<br />
| Entity ID<br />
| VarInt<br />
| <br />
|-<br />
| Type<br />
| Unsigned Byte<br />
| The type of mob. See [[Entities#Mobs|Mobs]]<br />
|-<br />
| X<br />
| Int<br />
| X position as a [[Data Types#Fixed-point numbers|Fixed-Point number]] <br />
|-<br />
| Y<br />
| Int<br />
| Y position as a [[Data Types#Fixed-point numbers|Fixed-Point number]] <br />
|-<br />
| Z<br />
| Int<br />
| Z position as a [[Data Types#Fixed-point numbers|Fixed-Point number]] <br />
|-<br />
| Yaw<br />
| Angle<br />
| <br />
|-<br />
| Pitch<br />
| Angle<br />
| <br />
|-<br />
| Head Pitch<br />
| Angle<br />
| <br />
|-<br />
| Velocity X<br />
| Short<br />
| Same units as [[#Entity Velocity|Entity Velocity]]<br />
|-<br />
| Velocity Y<br />
| Short<br />
| Same units as [[#Entity Velocity|Entity Velocity]]<br />
|-<br />
| Velocity Z<br />
| Short<br />
| Same units as [[#Entity Velocity|Entity Velocity]]<br />
|-<br />
| Metadata<br />
| [[Entities#Entity Metadata Format|Metadata]]<br />
| <br />
|}<br />
<br />
==== 重生绘图 ====<br />
<br />
This packet shows location, name, and type of painting.<br />
<br />
Calculating the center of an image: given a (width x height) grid of cells, with (0, 0) being the top left corner, the center is (max(0, width / 2 - 1), height / 2). E.g.<br />
<br />
2x1 (1, 0)<br />
4x4 (1, 2)<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="4"| 0x10<br />
|rowspan="4"| Play<br />
|rowspan="4"| Client<br />
| Entity ID<br />
| VarInt<br />
| <br />
|-<br />
| Title<br />
| String<br />
| Name of the painting. Max length 13<br />
|-<br />
| Location<br />
| Position<br />
| Center coordinates<br />
|-<br />
| Direction<br />
| Unsigned Byte<br />
| Direction the painting faces. 0: north (-z), 1: west (-x), 2: south (+z), 3: east (+x)<br />
|}<br />
<br />
==== 重生掉落经验 ====<br />
<br />
Spawns one or more experience orbs.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="5"| 0x11<br />
|rowspan="5"| Play<br />
|rowspan="5"| Client<br />
| Entity ID<br />
| VarInt<br />
| Entity's ID<br />
|-<br />
| X<br />
| Int<br />
| X position as a [[Data Types#Fixed-point numbers|Fixed-Point number]]<br />
|-<br />
| Y<br />
| Int<br />
| Y position as a [[Data Types#Fixed-point numbers|Fixed-Point number]]<br />
|-<br />
| Z<br />
| Int<br />
| Z position as a [[Data Types#Fixed-point numbers|Fixed-Point number]]<br />
|-<br />
| Count<br />
| Short<br />
| The amount of experience this orb will reward once collected<br />
|}<br />
<br />
==== 实体速率 ====<br />
<br />
Velocity is believed to be in units of 1/8000 of a block per server tick (50ms); for example, -1343 would move (-1343 / 8000) = −0.167875 blocks per tick (or −3,3575 blocks per second).<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="4"| 0x12<br />
|rowspan="4"| Play<br />
|rowspan="4"| Client<br />
| Entity ID<br />
| VarInt<br />
| <br />
|-<br />
| Velocity X<br />
| Short<br />
| Velocity on the X axis<br />
|-<br />
| Velocity Y<br />
| Short<br />
| Velocity on the Y axis<br />
|-<br />
| Velocity Z<br />
| Short<br />
| Velocity on the Z axis<br />
|}<br />
<br />
==== 销毁实体 ====<br />
<br />
Sent by the server when a list of entities is to be destroyed on the client.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="2"| 0x13<br />
|rowspan="2"| Play<br />
|rowspan="2"| Client<br />
| Count<br />
| VarInt<br />
| Number of elements in the following array<br />
|-<br />
| Entity IDs<br />
| Array of VarInt<br />
| The list of entities of destroy<br />
|}<br />
<br />
==== 实体 ====<br />
<br />
This packet may be used to initialize an entity.<br />
<br />
For player entities, either this packet or any move/look packet is sent every game tick. So the meaning of this packet is basically that the entity did not move/look since the last such packet.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="1"| 0x14<br />
|rowspan="1"| Play<br />
|rowspan="1"| Client<br />
| Entity ID<br />
| VarInt<br />
| <br />
|}<br />
<br />
==== 实体相对移动 ====<br />
<br />
This packet is sent by the server when an entity moves less then 4 blocks; if an entity moves more than 4 blocks [[#Entity Teleport|Entity Teleport]] should be sent instead.<br />
<br />
This packet allows at most four blocks movement in any direction, because byte range is from -128 to 127.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="5"| 0x15<br />
|rowspan="5"| Play<br />
|rowspan="5"| Client<br />
| Entity ID<br />
| VarInt<br />
| <br />
|-<br />
| Delta X<br />
| Byte<br />
| Change in X position as a [[Data Types#Fixed-point numbers|Fixed-Point number]]<br />
|-<br />
| Delta Y<br />
| Byte<br />
| Change in Y position as a [[Data Types#Fixed-point numbers|Fixed-Point number]]<br />
|-<br />
| Delta Z<br />
| Byte<br />
| Change in Z position as a [[Data Types#Fixed-point numbers|Fixed-Point number]]<br />
|-<br />
| On Ground<br />
| Boolean<br />
| <br />
|}<br />
<br />
==== 实体朝向 ====<br />
<br />
This packet is sent by the server when an entity rotates.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="5"| 0x16<br />
|rowspan="5"| Play<br />
|rowspan="5"| Client<br />
| Entity ID<br />
| VarInt<br />
| <br />
|-<br />
| Yaw<br />
| Angle<br />
| New angle, not a delta<br />
|-<br />
| Pitch<br />
| Angle<br />
| New angle, not a delta<br />
|-<br />
| On Ground<br />
| Boolean<br />
| <br />
|}<br />
<br />
==== 实体朝向与相对移动 ====<br />
<br />
This packet is sent by the server when an entity rotates and moves. Since a byte range is limited from -128 to 127, and movement is offset of fixed-point numbers, this packet allows at most four blocks movement in any direction. (-128/32 == -4)<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="7"| 0x17<br />
|rowspan="7"| Play<br />
|rowspan="7"| Client<br />
| Entity ID<br />
| VarInt<br />
| <br />
|-<br />
| Delta X<br />
| Byte<br />
| Change in X position as a [[Data Types#Fixed-point numbers|Fixed-Point number]]<br />
|-<br />
| Delta Y<br />
| Byte<br />
| Change in Y position as a [[Data Types#Fixed-point numbers|Fixed-Point number]]<br />
|-<br />
| Delta Z<br />
| Byte<br />
| Change in Z position as a [[Data Types#Fixed-point numbers|Fixed-Point number]]<br />
|-<br />
| Yaw<br />
| Angle<br />
| New angle, not a delta<br />
|-<br />
| Pitch<br />
| Angle<br />
| New angle, not a delta<br />
|-<br />
| On Ground<br />
| Boolean<br />
| <br />
|}<br />
<br />
==== 实体传送 ====<br />
<br />
This packet is sent by the server when an entity moves more than 4 blocks.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="7"| 0x18<br />
|rowspan="7"| Play<br />
|rowspan="7"| Client<br />
| Entity ID<br />
| VarInt<br />
| <br />
|-<br />
| X<br />
| Int<br />
| X position as a [[Data Types#Fixed-point numbers|Fixed-Point number]]<br />
|-<br />
| Y<br />
| Int<br />
| Y position as a [[Data Types#Fixed-point numbers|Fixed-Point number]]<br />
|-<br />
| Z<br />
| Int<br />
| Z position as a [[Data Types#Fixed-point numbers|Fixed-Point number]]<br />
|-<br />
| Yaw<br />
| Angle<br />
| New angle, not a delta<br />
|-<br />
| Pitch<br />
| Angle<br />
| New angle, not a delta<br />
|-<br />
| On Ground<br />
| Boolean<br />
| <br />
|}<br />
<br />
==== 实体手朝向 ====<br />
<br />
Changes the direction an entity's head is facing.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="2"| 0x19<br />
|rowspan="2"| Play<br />
|rowspan="2"| Client<br />
| Entity ID<br />
| VarInt<br />
| <br />
|-<br />
| Head Yaw<br />
| Angle<br />
| New angle, not a delta<br />
|}<br />
<br />
==== 实体状态 ====<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="2"| 0x1A<br />
|rowspan="2"| Play<br />
|rowspan="2"| Client<br />
| Entity ID<br />
| Int<br />
| <br />
|-<br />
| Entity Status<br />
| Byte<br />
| See below<br />
|}<br />
<br />
{| class="wikitable"<br />
|-<br />
! Entity Status<br />
! Meaning<br />
|-<br />
| 1<br />
| Sent when resetting a mob spawn minecart's timer - appears to be unused by the client<br />
|-<br />
| 2<br />
| Living Entity hurt <br />
|-<br />
| 3<br />
| Living Entity dead<br />
|-<br />
| 4<br />
| Iron Golem throwing up arms<br />
|-<br />
| 6<br />
| Wolf/Ocelot/Horse taming — Spawn “heart” particles<br />
|-<br />
| 7<br />
| Wolf/Ocelot/Horse tamed — Spawn “smoke” particles<br />
|-<br />
| 8<br />
| Wolf shaking water — Trigger the shaking animation<br />
|-<br />
| 9<br />
| (of self) Eating accepted by server<br />
|-<br />
| 10<br />
| Sheep eating grass<br />
|-<br />
| 10<br />
| Play TNT ignite sound<br />
|-<br />
| 11<br />
| Iron Golem handing over a rose<br />
|-<br />
| 12<br />
| Villager mating — Spawn “heart” particles<br />
|-<br />
| 13<br />
| Spawn particles indicating that a villager is angry and seeking revenge<br />
|-<br />
| 14<br />
| Spawn happy particles near a villager<br />
|-<br />
| 15<br />
| Witch animation — Spawn “magic” particles<br />
|-<br />
| 16<br />
| Play zombie converting into a villager sound<br />
|-<br />
| 17<br />
| Firework exploding<br />
|-<br />
| 18<br />
| Animal in love (ready to mate) — Spawn “heart” particles<br />
|-<br />
| 19<br />
| Reset squid rotation<br />
|-<br />
| 20<br />
| Spawn explosion particle — works for some living entities<br />
|-<br />
| 21<br />
| Play guardian sound — works for every entity<br />
|-<br />
| 22<br />
| Enables reduced debug for players<br />
|-<br />
| 23<br />
| Disables reduced debug for players<br />
|}<br />
<br />
==== 附加实体 ====<br />
<br />
This packet is sent when a player has been attached to an entity (e.g. Minecart).<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="3"| 0x1B<br />
|rowspan="3"| Play<br />
|rowspan="3"| Client<br />
| Entity ID<br />
| Int<br />
| Attached entity's EID. Set to -1 to detach.<br />
|-<br />
| Vehicle ID<br />
| Int<br />
| Vechicle's Entity ID<br />
|-<br />
| Leash<br />
| Boolean<br />
| If true leashes the entity to the vehicle<br />
|}<br />
<br />
==== 实体数据值 ====<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="2"| 0x1C<br />
|rowspan="2"| Play<br />
|rowspan="2"| Client<br />
| Entity ID<br />
| VarInt<br />
| <br />
|-<br />
| Metadata<br />
| [[Entities#Entity Metadata Format|Metadata]]<br />
| <br />
|}<br />
<br />
==== 实体属性 ====<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="5"| 0x1D<br />
|rowspan="5"| Play<br />
|rowspan="5"| Client<br />
| Entity ID<br />
| VarInt<br />
| <br />
|-<br />
| Effect ID<br />
| Byte<br />
| See {{Minecraft Wiki|Status effect#List of effects|this table}}<br />
|-<br />
| Amplifier<br />
| Byte<br />
| Notchian client displays effect level as Amplifier + 1<br />
|-<br />
| Duration<br />
| VarInt<br />
| Seconds<br />
|-<br />
| Hide Particles<br />
| Boolean<br />
| <br />
|}<br />
<br />
==== 移除实体属性 ====<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="2"| 0x1E<br />
|rowspan="2"| Play<br />
|rowspan="2"| Client<br />
| Entity ID<br />
| VarInt<br />
| <br />
|-<br />
| Effect ID<br />
| Byte<br />
| See {{Minecraft Wiki|Status effect#List of effects|this table}}<br />
|}<br />
<br />
==== 设置经验值 ====<br />
<br />
Sent by the server when the client should change experience levels.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="3"| 0x1F<br />
|rowspan="3"| Play<br />
|rowspan="3"| Client<br />
| Experience bar<br />
| Float<br />
| Between 0 and 1<br />
|-<br />
| Level<br />
| VarInt<br />
| <br />
|-<br />
| Total Experience<br />
| VarInt<br />
| See {{Minecraft Wiki|Experience#Leveling up}} on the Minecraft Wiki for Total Experience to Level conversion<br />
|}<br />
<br />
==== 实体配置 ====<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
!colspan="2"| Field Name<br />
!colspan="2"| Field Type<br />
! Notes<br />
|-<br />
|rowspan="6"| 0x20<br />
|rowspan="6"| Play<br />
|rowspan="6"| Client<br />
|colspan="2"| Entity ID<br />
|colspan="2"| VarInt<br />
| <br />
|-<br />
|colspan="2"| Number Of Properties<br />
|colspan="2"| Int<br />
| Number of elements in the following array<br />
|-<br />
|rowspan="4"| Property<br />
| Key<br />
|rowspan="4"| Array<br />
| String<br />
| See below<br />
|-<br />
| Value<br />
| Double<br />
| See below<br />
|-<br />
| Number Of Modifiers<br />
| VarInt<br />
| Number of elements in the following array<br />
|-<br />
| Modifiers<br />
| Array of Modifier Data<br />
| See {{Minecraft Wiki|Attribute#Modifiers}}<br />
|}<br />
<br />
Known Key values:<br />
<br />
{| class="wikitable"<br />
|-<br />
! Key<br />
! Default<br />
! Min<br />
! Max<br />
! Label<br />
|-<br />
| generic.maxHealth<br />
| 20.0<br />
| 0.0<br />
| Double.MaxValue<br />
| Max Health<br />
|-<br />
| generic.followRange<br />
| 32.0<br />
| 0.0<br />
| 2048.0<br />
| Follow Range<br />
|-<br />
| generic.knockbackResistance<br />
| 0.0 <br />
| 0.0<br />
| 1.0<br />
| Knockback Resistance<br />
|-<br />
| generic.movementSpeed<br />
| 0.699999988079071<br />
| 0.0<br />
| Double.MaxValue<br />
| Movement Speed<br />
|-<br />
| generic.attackDamage<br />
| 2.0<br />
| 0.0<br />
| Double.MaxValue<br />
| <br />
|-<br />
| horse.jumpStrength<br />
| 0.7<br />
| 0.0<br />
| 2.0<br />
| Jump Strength<br />
|-<br />
| zombie.spawnReinforcements<br />
| 0.0<br />
| 0.0<br />
| 1.0<br />
| Spawn Reinforcements Chance<br />
|}<br />
<br />
''Modifier Data'' structure:<br />
<br />
{| class="wikitable"<br />
|-<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
| UUID<br />
| UUID<br />
| <br />
|-<br />
| Amount<br />
| Double<br />
| <br />
|-<br />
| Operation<br />
| Byte<br />
| <br />
|}<br />
<br />
==== 区块数据 ====<br />
<br />
Chunks are not unloaded by the client automatically. To unload chunks, send this packet with Ground-Up Continuous=true and no 16^3 chunks (eg. Primary Bit Mask=0). The server does not send skylight information for nether-chunks, it's up to the client to know if the player is currently in the nether. You can also infer this information from the primary bitmask and the amount of uncompressed bytes sent.<br />
<br />
See also: [[SMP Map Format]]<br />
<br />
Changes in 1.8:<br />
<br />
* Data value section removed<br />
* Extended id section removed<br />
* Block id section is now a unsigned short (little endian) per a block<br />
* The block id is equal to <code>(id << 4) | data</code><br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="6"| 0x21<br />
|rowspan="6"| Play<br />
|rowspan="6"| Client<br />
| Chunk X<br />
| Int<br />
| Chunk X coordinate<br />
|-<br />
| Chunk Z<br />
| Int<br />
| Chunk Z coordinate<br />
|-<br />
| Ground-Up Continuous<br />
| Boolean<br />
| This is true if the packet represents all sections in this vertical column, where the Primary Bit Mask specifies exactly which sections are included, and which are air<br />
|-<br />
| Primary Bit Mask<br />
| Unsigned Short<br />
| Bitmask with 1 for every 16x16x16 section whose data follows in the compressed data<br />
|- <br />
| Size<br />
| VarInt<br />
| Size of Data<br />
|-<br />
| Data<br />
| [[SMP Map Format#Data|Chunk]]<br />
| <br />
|}<br />
<br />
==== 多个方块改变 ====<br />
Fired whenever 2 or more blocks are changed within the render distance.<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
!colspan="2"| Field Name<br />
!colspan="2"| Field Type<br />
! Notes<br />
|-<br />
|rowspan="6"| 0x22<br />
|rowspan="6"| Play<br />
|rowspan="6"| Client<br />
|colspan="2"| Chunk X<br />
|colspan="2"| Int<br />
| Chunk X coordinate<br />
|-<br />
|colspan="2"| Chunk Z<br />
|colspan="2"| Int<br />
| Chunk Z coordinate<br />
|-<br />
|colspan="2"| Record Count<br />
|colspan="2"| VarInt<br />
| Number of elements in the following array, a.k.a. the number of blocks affected<br />
|-<br />
|rowspan="3"| Record<br />
| Horizontal Position<br />
|rowspan="3"| Array<br />
| Unsigned Byte<br />
| The 4 most significant bits (<code>0xF0</code>) encode the X coordinate, relative to the chunk. The 4 least significant bits (<code>0x0F</code>) encode the Z coordinate, relative to the chunk.<br />
|-<br />
| Y Coordinate<br />
| Unsigned Byte<br />
| <br />
|-<br />
| Block ID<br />
| VarInt<br />
| The new block ID for the block. <code><nowiki>id &lt;&lt; 4 | data</nowiki></code><br />
|}<br />
<br />
==== 方块改变 ====<br />
Fired whenever a block is changed within the render distance.<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="2"| 0x23<br />
|rowspan="2"| Play<br />
|rowspan="2"| Client<br />
| Location<br />
| Position<br />
| Block Coordinates<br />
|-<br />
| Block ID<br />
| VarInt<br />
| The new block ID for the block. <code><nowiki>id &lt;&lt; 4 | data</nowiki></code><br />
|}<br />
<br />
==== 方块功能 ====<br />
<br />
This packet is used for a number of things:<br />
<br />
* Chests opening and closing<br />
* Pistons pushing and pulling<br />
* Note blocks playing<br />
* Updating beacons<br />
<br />
See Also: [[Block Actions]] <br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="4"| 0x24<br />
|rowspan="4"| Play<br />
|rowspan="4"| Client<br />
| Location<br />
| Position<br />
| Block Coordinates<br />
|-<br />
| Byte 1<br />
| Unsigned Byte<br />
| Varies depending on block — see [[Block Actions]]<br />
|-<br />
| Byte 2<br />
| Unsigned Byte<br />
| Varies depending on block — see [[Block Actions]]<br />
|-<br />
| Block Type<br />
| VarInt<br />
| The block type for the block<br />
|}<br />
<br />
==== 方块破坏动画 ====<br />
<br />
0–9 are the displayable destroy stages and each other number means that there is no animation on this coordinate.<br />
<br />
You can also set an animation to air! The animation will still be visible.<br />
<br />
If you need to display several break animations at the same time you have to give each of them a unique Entity ID.<br />
<br />
Also if you set the coordinates to a special block like water etc. it won't show the actual break animation but some other interesting effects. (Water will lose it's transparency)<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="3"| 0x25<br />
|rowspan="3"| Play<br />
|rowspan="3"| Client<br />
| Entity ID<br />
| VarInt<br />
| EID for the animation<br />
|-<br />
| Location<br />
| Position<br />
| Block Position<br />
|-<br />
| Destroy Stage<br />
| Byte<br />
| 0–9 to set it, any other value to remove it<br />
|}<br />
<br />
==== 地图区块 ====<br />
<br />
1.8 changes at [[#Chunk Data|Chunk Data]]<br />
<br />
To reduce the number of bytes, this packet is used to send chunks together for better compression results.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
!colspan="2"| Field Name<br />
!colspan="2"| Field Type<br />
! Notes<br />
|-<br />
|rowspan="7"| 0x26<br />
|rowspan="7"| Play<br />
|rowspan="7"| Client<br />
|colspan="2"| Sky Light Sent<br />
|colspan="2"| Boolean<br />
| Whether or not Chunk Data contains light nibble arrays. This is true in the Overworld, false in the End + Nether<br />
|-<br />
|colspan="2"| Chunk Column Count<br />
|colspan="2"| VarInt<br />
| Number of elements in each of the following arrays<br />
|-<br />
|rowspan="3"| Chunk Meta<br />
| Chunk X<br />
|rowspan="3"| Array<br />
| Int<br />
| The X coordinate of the chunk<br />
|-<br />
| Chunk Z<br />
| Int<br />
| The Z coordinate of the chunk<br />
|-<br />
| Primary Bit Mask<br />
| Unsigned Short<br />
| A bit mask which specifies which sections are not empty in this chunk<br />
|-<br />
|colspan="2"| Chunk Data<br />
|colspan="2"| Array of [[SMP Map Format#Data|Chunk]]<br />
| Each chunk in this array corresponds to the data at the same position in Chunk Meta<br />
|}<br />
<br />
==== 爆炸 ====<br />
<br />
Sent when an explosion occurs (creepers, TNT, and ghast fireballs).<br />
<br />
Each block in Records is set to air. Coordinates for each axis in record is int(X) + record.x<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="9"| 0x27<br />
|rowspan="9"| Play<br />
|rowspan="9"| Client<br />
| X<br />
| Float<br />
| <br />
|-<br />
| Y<br />
| Float<br />
| <br />
|-<br />
| Z<br />
| Float<br />
| <br />
|-<br />
| Radius<br />
| Float<br />
| Currently unused in the client<br />
|-<br />
| Record Count<br />
| Int<br />
| Number of elements in the following array<br />
|-<br />
| Records<br />
| Array of (Byte, Byte, Byte)<br />
| Each record is 3 signed bytes long, each bytes are the XYZ (respectively) offsets of affected blocks.<br />
|-<br />
| Player Motion X<br />
| Float<br />
| X velocity of the player being pushed by the explosion<br />
|-<br />
| Player Motion Y<br />
| Float<br />
| Y velocity of the player being pushed by the explosion<br />
|-<br />
| Player Motion Z<br />
| Float<br />
| Z velocity of the player being pushed by the explosion<br />
|}<br />
<br />
==== 属性 ====<br />
<br />
Sent when a client is to play a sound or particle effect.<br />
<br />
By default, the Minecraft client adjusts the volume of sound effects based on distance. The final boolean field is used to disable this, and instead the effect is played from 2 blocks away in the correct direction. Currently this is only used for effect 1013 (mob.wither.spawn), and is ignored for any other value by the client.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="4"| 0x28<br />
|rowspan="4"| Play<br />
|rowspan="4"| Client<br />
| Effect ID<br />
| Int<br />
| The ID of the effect, see below<br />
|-<br />
| Location<br />
| Position<br />
| The location of the effect<br />
|-<br />
| Data<br />
| Int<br />
| Extra data for certain effects, see below<br />
|-<br />
| Disable Relative Volume<br />
| Boolean<br />
| See above<br />
|}<br />
<br />
Effect IDs:<br />
<br />
{| class="wikitable"<br />
! ID<br />
! Name<br />
! Data<br />
|-<br />
!colspan="3"| Sound<br />
|-<br />
| 1000<br />
| <code>random.click</code><br />
| <br />
|-<br />
| 1001<br />
| <code>random.click</code><br />
| <br />
|-<br />
| 1002<br />
| <code>random.bow</code><br />
| <br />
|-<br />
| 1003<br />
| <code>random.door_open</code> or <code>random.door_close</code> (50/50 chance)<br />
| <br />
|-<br />
| 1004<br />
| <code>random.fizz</code><br />
| <br />
|-<br />
| 1005<br />
| Play a music disc.<br />
| {{Minecraft Wiki|Music Discs|Record ID}}<br />
|-<br />
| 1006<br />
| ''not assigned''<br />
| <br />
|-<br />
| 1007<br />
| <code>mob.ghast.charge</code><br />
| <br />
|-<br />
| 1008<br />
| <code>mob.ghast.fireball</code><br />
| <br />
|-<br />
| 1009<br />
| <code>mob.ghast.fireball</code>, but with a lower volume<br />
| <br />
|-<br />
| 1010<br />
| <code>mob.zombie.wood</code><br />
| <br />
|-<br />
| 1011<br />
| <code>mob.zombie.metal</code><br />
| <br />
|-<br />
| 1012<br />
| <code>mob.zombie.woodbreak</code><br />
| <br />
|-<br />
| 1013<br />
| <code>mob.wither.spawn</code><br />
| <br />
|-<br />
| 1014<br />
| <code>mob.wither.shoot</code><br />
| <br />
|-<br />
| 1015<br />
| <code>mob.bat.takeoff</code><br />
| <br />
|-<br />
| 1016<br />
| <code>mob.zombie.infect</code><br />
| <br />
|-<br />
| 1017<br />
| <code>mob.zombie.unfect</code><br />
| <br />
|-<br />
| 1018<br />
| <code>mob.enderdragon.end</code><br />
| <br />
|-<br />
| 1020<br />
| <code>random.anvil_break</code><br />
| <br />
|-<br />
| 1021<br />
| <code>random.anvil_use</code><br />
| <br />
|-<br />
| 1022<br />
| <code>random.anvil_land</code><br />
| <br />
|-<br />
!colspan="3"| Particle<br />
|-<br />
| 2000<br />
| Spawns 10 smoke particles, e.g. from a fire<br />
| Direction, see below<br />
|-<br />
| 2001<br />
| Block break<br />
| {{Minecraft Wiki|Data values|Block ID}}<br />
|-<br />
| 2002<br />
| Splash potion. Particle effect + glass break sound.<br />
| [http://www.lb-stuff.com/Minecraft/PotionDataValues1.9pre3.txt Potion ID]<br />
|-<br />
| 2003<br />
| Eye of Ender entity break animation — particles and sound<br />
| <br />
|-<br />
| 2004<br />
| Mob spawn particle effect: smoke + flames<br />
| <br />
|-<br />
| 2005<br />
| Spawn “happy villager” effect (green crosses), used for bonemealing vegetation<br />
| <br />
|}<br />
<br />
Smoke directions:<br />
<br />
{| class="wikitable"<br />
! ID<br />
! Direction<br />
|-<br />
| 0<br />
| South-East<br />
|-<br />
| 1<br />
| South<br />
|-<br />
| 2<br />
| South-West<br />
|-<br />
| 3<br />
| East<br />
|-<br />
| 4<br />
| (Up or middle ?)<br />
|-<br />
| 5<br />
| West<br />
|-<br />
| 6<br />
| North-East<br />
|-<br />
| 7<br />
| North<br />
|-<br />
| 8<br />
| North-West<br />
|}<br />
<br />
==== 声音特效 ====<br />
<br />
Used to play a sound effect on the client.<br />
<br />
Custom sounds may be added by resource packs.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="6"| 0x29<br />
|rowspan="6"| Play<br />
|rowspan="6"| Client<br />
| Sound name<br />
| String<br />
| All known sound effect names can be seen [https://github.com/SirCmpwn/Craft.Net/blob/master/source/Craft.Net.Common/SoundEffect.cs here]<br />
|-<br />
| Effect position X<br />
| Int<br />
| Effect X multiplied by 8<br />
|-<br />
| Effect position Y<br />
| Int<br />
| Effect Y multiplied by 8<br />
|-<br />
| Effect position Z<br />
| Int<br />
| Effect Z multiplied by 8<br />
|-<br />
| Volume<br />
| Float<br />
| 1 is 100%, can be more<br />
|-<br />
| Pitch<br />
| Unsigned Byte<br />
| 63 is 100%, can be more<br />
|}<br />
<br />
==== 粒子效果 ====<br />
<br />
Displays the named particle<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="11"| 0x2A<br />
|rowspan="11"| Play<br />
|rowspan="11"| Client<br />
| Particle ID<br />
| Int<br />
| See below<br />
|-<br />
| Long Distance<br />
| Boolean<br />
| If true, particle distance increases from 256 to 65536<br />
|-<br />
| X<br />
| Float<br />
| X position of the particle<br />
|-<br />
| Y<br />
| Float<br />
| Y position of the particle<br />
|-<br />
| Z<br />
| Float<br />
| Z position of the particle<br />
|-<br />
| Offset X<br />
| Float<br />
| This is added to the X position after being multiplied by random.nextGaussian()<br />
|-<br />
| Offset Y<br />
| Float<br />
| This is added to the Y position after being multiplied by random.nextGaussian()<br />
|-<br />
| Offset Z<br />
| Float<br />
| This is added to the Z position after being multiplied by random.nextGaussian()<br />
|-<br />
| Particle Data<br />
| Float<br />
| The data of each particle<br />
|-<br />
| Particle Count<br />
| Int<br />
| The number of particles to create<br />
|-<br />
| Data<br />
| Array of VarInt<br />
| Length depends on particle. "iconcrack" has length of 2, "blockcrack", and "blockdust" have lengths of 1, the rest have 0.<br />
|}<br />
<br />
Particle IDs:<br />
<br />
{| class="wikitable"<br />
|-<br />
! Particle Name<br />
! Particle ID<br />
|-<br />
| explode<br />
| 0<br />
|-<br />
| largeexplosion<br />
| 1<br />
|-<br />
| hugeexplosion<br />
| 2<br />
|-<br />
| fireworksSpark<br />
| 3<br />
|-<br />
| bubble<br />
| 4<br />
|-<br />
| splash<br />
| 5<br />
|-<br />
| wake<br />
| 6<br />
|-<br />
| suspended<br />
| 7<br />
|-<br />
| depthsuspend<br />
| 8<br />
|-<br />
| crit<br />
| 9<br />
|-<br />
| magicCrit<br />
| 10<br />
|-<br />
| smoke<br />
| 11<br />
|-<br />
| largesmoke<br />
| 12<br />
|-<br />
| spell<br />
| 13<br />
|-<br />
| instantSpell<br />
| 14<br />
|-<br />
| mobSpell<br />
| 15<br />
|-<br />
| mobSpellAmbient<br />
| 16<br />
|-<br />
| witchMagic<br />
| 17<br />
|-<br />
| dripWater<br />
| 18<br />
|-<br />
| dripLava<br />
| 19<br />
|-<br />
| angryVillager<br />
| 20<br />
|-<br />
| happyVillager<br />
| 21<br />
|-<br />
| townaura<br />
| 22<br />
|-<br />
| note<br />
| 23<br />
|-<br />
| portal<br />
| 24<br />
|-<br />
| enchantmenttable<br />
| 25<br />
|-<br />
| flame<br />
| 26<br />
|-<br />
| lava<br />
| 27<br />
|-<br />
| footstep<br />
| 28<br />
|-<br />
| cloud<br />
| 29<br />
|-<br />
| reddust<br />
| 30<br />
|-<br />
| snowballpoof<br />
| 31<br />
|-<br />
| snowshovel<br />
| 32<br />
|-<br />
| slime<br />
| 33<br />
|-<br />
| heart<br />
| 34<br />
|-<br />
| barrier<br />
| 35<br />
|-<br />
| iconcrack_(id)_(data)<br />
| 36<br />
|-<br />
| blockcrack_(id+(data<<12))<br />
| 37<br />
|-<br />
| blockdust_(id)<br />
| 38<br />
|-<br />
| droplet<br />
| 39<br />
|-<br />
| take<br />
| 40<br />
|-<br />
| mobappearance<br />
| 41<br />
|}<br />
<br />
==== 改变游戏状态 ====<br />
<br />
It appears when a bed can't be used as a spawn point and when the rain state changes.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="2"| 0x2B<br />
|rowspan="2"| Play<br />
|rowspan="2"| Client<br />
| Reason<br />
| Unsigned Byte<br />
| See below<br />
|-<br />
| Value<br />
| Float<br />
| Depends on Reason<br />
|}<br />
<br />
''Reason codes'':<br />
<br />
{| class="wikitable"<br />
! Reason<br />
! Effect<br />
! Value<br />
|-<br />
| 0<br />
| Invalid Bed<br />
| <br />
|-<br />
| 1<br />
| End raining<br />
| <br />
|-<br />
| 2<br />
| Begin raining<br />
| <br />
|-<br />
| 3<br />
| Change game mode<br />
| 0: Survival, 1: Creative, 2: Adventure, 3: Spectator<br />
|-<br />
| 4<br />
| Enter credits<br />
| <br />
|-<br />
| 5<br />
| Demo message<br />
| 0: Show welcome to demo screen, 101: Tell movement controls, 102: Tell jump control, 103: Tell inventory control<br />
|- <br />
| 6<br />
| Arrow hitting player<br />
| Appears to be played when an arrow strikes another player in Multiplayer<br />
|-<br />
| 7<br />
| Fade value<br />
| The current darkness value. 1 = Dark, 0 = Bright, Setting the value higher causes the game to change color and freeze<br />
|-<br />
| 8<br />
| Fade time<br />
| Time in ticks for the sky to fade<br />
|-<br />
| 10<br />
| Play mob appearance (effect and sound)<br />
| Unknown<br />
|}<br />
<br />
==== 生存全局实体 ====<br />
<br />
With this packet, the server notifies the client of thunderbolts striking within a 512 block radius around the player. The coordinates specify where exactly the thunderbolt strikes.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="5"| 0x2C<br />
|rowspan="5"| Play<br />
|rowspan="5"| Client<br />
| Entity ID<br />
| VarInt<br />
| The EID of the thunderbolt<br />
|-<br />
| Type<br />
| Byte<br />
| The global entity type, currently always 1 for thunderbolt<br />
|-<br />
| X<br />
| Int<br />
| Thunderbolt X, a [[Data Types#Fixed-point numbers|fixed-point number]]<br />
|-<br />
| Y<br />
| Int<br />
| Thunderbolt Y, a [[Data Types#Fixed-point numbers|fixed-point number]]<br />
|-<br />
| Z<br />
| Int<br />
| Thunderbolt Z, a [[Data Types#Fixed-point numbers|fixed-point number]]<br />
|}<br />
<br />
==== 打开窗户 ====<br />
<br />
This is sent to the client when it should open an inventory, such as a chest, workbench, or furnace. This message is not sent anywhere for clients opening their own inventory.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="5"| 0x2D<br />
|rowspan="5"| Play<br />
|rowspan="5"| Client<br />
| Window ID<br />
| Unsigned Byte<br />
| A unique id number for the window to be displayed. Notchian server implementation is a counter, starting at 1.<br />
|-<br />
| Window Type<br />
| String<br />
| The window type to use for display. See [[Inventory]] for a list.<br />
|-<br />
| Window Title<br />
| [[Chat]]<br />
| The title of the window<br />
|-<br />
| Number Of Slots<br />
| Unsigned Byte<br />
| Number of slots in the window (excluding the number of slots in the player inventory)<br />
|-<br />
| Entity ID<br />
| Optional Int<br />
| EntityHorse's EID. Only sent when Window Type is “EntityHorse”<br />
|}<br />
<br />
See [[Inventory]] for further information.<br />
<br />
==== 关闭窗户 ====<br />
<br />
This packet is sent from the server to the client when a window is forcibly closed, such as when a chest is destroyed while it's open.<br />
<br />
Note, notchian clients send a close window packet with Window ID 0 to close their inventory even though there is never an [[#Open Window|Open Window]] packet for inventory. <br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
| 0x2E<br />
|rowspan="1"| Play<br />
|rowspan="1"| Client<br />
| Window ID<br />
| Unsigned Byte<br />
| This is the ID of the window that was closed. 0 for inventory.<br />
|}<br />
<br />
==== 设置位置 ====<br />
<br />
Sent by the server when an item in a slot (in a window) is added/removed.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="3"| 0x2F<br />
|rowspan="3"| Play<br />
|rowspan="3"| Client<br />
| Window ID<br />
| Byte<br />
| The window which is being updated. 0 for player inventory. Note that all known window types include the player inventory. This packet will only be sent for the currently opened window while the player is performing actions, even if it affects the player inventory. After the window is closed, a number of these packets are sent to update the player's inventory window (0).<br />
|-<br />
| Slot<br />
| Short<br />
| The slot that should be updated<br />
|-<br />
| Slot Data<br />
| [[Slot Data|Slot]]<br />
| <br />
|}<br />
<br />
==== 窗口物品 ====<br />
<br />
[[File:Inventory-slots.png|thumb|The inventory slots]]<br />
<br />
Sent by the server when items in multiple slots (in a window) are added/removed. This includes the main inventory, equipped armour and crafting slots.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="3"| 0x30<br />
|rowspan="3"| Play<br />
|rowspan="3"| Client<br />
| Window ID<br />
| Unsigned Byte<br />
| The ID of window which items are being sent for. 0 for player inventory.<br />
|-<br />
| Count<br />
| Short<br />
| Number of elements in the following array<br />
|-<br />
| Slot Data<br />
| Array of [[Slot Data|Slot]]<br />
| <br />
|}<br />
<br />
See [[Inventory#Windows|inventory windows]] for further information about how slots are indexed.<br />
<br />
==== Window Property ====<br />
<br />
This packet is used to inform the client that part of a GUI window should be updated.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="3"| 0x31<br />
|rowspan="3"| Play<br />
|rowspan="3"| Client<br />
| Window ID<br />
| Unsigned Byte<br />
| <br />
|-<br />
| Property<br />
| Short<br />
| The property to be updated, see below<br />
|-<br />
| Value<br />
| Short<br />
| The new value for the property, see below<br />
|}<br />
<br />
The meaning of the Property field depends on the type of the window. The following table shows the known combinations of window type and property, and how the value is to be interpreted.<br />
<br />
{| class="wikitable"<br />
|-<br />
! Window type<br />
! Property<br />
! Value<br />
|-<br />
|rowspan="2"| Furnace<br />
| 0: Progress arrow<br />
| 0–200 (presumably in in-game ticks)<br />
|-<br />
| 1: Fire icon (fuel)<br />
| 0–200 (presumably in in-game ticks)<br />
|-<br />
|rowspan="7"| Enchantment Table<br />
| 0: Level requirement for top enchantment slot<br />
|rowspan="3"| The enchantment's xp level requirement<br />
|-<br />
| 1: Level requirement for middle enchantment slot<br />
|-<br />
| 2: Level requirement for bottom enchantment slot<br />
|-<br />
| 3: The seed for generating the enchantments view for the client<br />
| Unknown<br />
|-<br />
| 4: tooltip shown on mouse hover over top enchantment slot<br />
|rowspan="3"| Unknown (set to -1 to hide it)<br />
|-<br />
| 5: tooltip shown on mouse hover over middle enchantment slot<br />
|-<br />
| 6: tooltip shown on mouse hover over bottom enchantment slot<br />
|-<br />
|rowspan="3"| Beacon<br />
| 0: Power level<br />
| Unknown<br />
|-<br />
| 1: First potion effect<br />
| Unknown<br />
|-<br />
| 2: Second potion effect<br />
| Unknown<br />
|-<br />
| Anvil<br />
| 0: Repair cost<br />
| The repair's cost in xp levels<br />
|-<br />
| Brewing Stand<br />
| 0: Brew time<br />
| 0–400, with 400 making the arrow empty, and 0 making the arrow full<br />
|}<br />
<br />
==== 确认事物 ====<br />
<br />
A packet from the server indicating whether a request from the client was accepted, or whether there was a conflict (due to lag).<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="3"| 0x32<br />
|rowspan="3"| Play<br />
|rowspan="3"| Client<br />
| Window ID<br />
| Byte<br />
| The ID of the window that the action occurred in<br />
|-<br />
| Action Number<br />
| Short<br />
| Every action that is to be accepted has a unique number. This field corresponds to that number.<br />
|-<br />
| Accepted<br />
| Boolean<br />
| Whether the action was accepted<br />
|}<br />
<br />
==== 更新标志 ====<br />
<br />
This message is sent from the server to the client whenever a sign is discovered or created. This message is NOT sent when a sign is destroyed or unloaded.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="5"| 0x33<br />
|rowspan="5"| Play<br />
|rowspan="5"| Client<br />
| Location<br />
| Position<br />
| <br />
|-<br />
| Line 1<br />
| [[Chat]]<br />
| First line of text in the sign<br />
|-<br />
| Line 2<br />
| [[Chat]]<br />
| Second line of text in the sign<br />
|-<br />
| Line 3<br />
| [[Chat]]<br />
| Third line of text in the sign<br />
|-<br />
| Line 4<br />
| [[Chat]]<br />
| Fourth line of text in the sign<br />
|}<br />
<br />
==== 地图 ====<br />
<br />
Updates a rectangular area on a map.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
!colspan="2"| Field Name<br />
!colspan="2"| Field Type<br />
! Notes<br />
|-<br />
|rowspan="12"| 0x34<br />
|rowspan="12"| Play<br />
|rowspan="12"| Client<br />
|colspan="2"| Item Damage<br />
|colspan="2"| VarInt<br />
| The damage value (map ID) of the map being modified<br />
|-<br />
|colspan="2"| Scale<br />
|colspan="2"| Byte<br />
| <br />
|- <br />
|colspan="2"| Icon Count<br />
|colspan="2"| VarInt<br />
| Number of elements in the following array<br />
|-<br />
|rowspan="3"| Icon<br />
| Direction And Type<br />
|rowspan="3"| Array<br />
| Byte<br />
| 0xF0 = Direction, 0x0F = Type<br />
|-<br />
| X<br />
| Byte<br />
| <br />
|-<br />
| Z<br />
| Byte<br />
| <br />
|- <br />
|colspan="2"| Columns<br />
|colspan="2"| Byte<br />
| Number of columns updated<br />
|-<br />
|colspan="2"| Rows<br />
|colspan="2"| Optional Byte<br />
| Only if Columns is more than 0; number of rows updated<br />
|-<br />
|colspan="2"| X<br />
|colspan="2"| Optional Byte<br />
| Only if Columns is more than 0; x offset of the westernmost column<br />
|-<br />
|colspan="2"| Z<br />
|colspan="2"| Optional Byte<br />
| Only if Columns is more than 0; z offset of the northernmost row<br />
|-<br />
|colspan="2"| Length<br />
|colspan="2"| Optional VarInt<br />
| Only if Columns is more than 0; length of the following array<br />
|-<br />
|colspan="2"| Data<br />
|colspan="2"| Optional Array of Unsigned Byte<br />
| Only if Columns is more than 0; see {{Minecraft Wiki|Map item format}}<br />
|}<br />
<br />
==== 更新方块实体 ====<br />
<br />
Essentially a block update on a block entity.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="3"| 0x35<br />
|rowspan="3"| Play<br />
|rowspan="3"| Client<br />
| Location<br />
| Position<br />
| <br />
|-<br />
| Action<br />
| Unsigned Byte<br />
| The type of update to perform, see below<br />
|-<br />
| NBT Data<br />
| Optional [[NBT|NBT Tag]]<br />
| If not present then it's a TAG_END (0)<br />
|}<br />
<br />
''Action'' field:<br />
<br />
* '''1''': Set SpawnPotentials of a mob spawner<br />
* '''2''': Set command block text (command and last execution status)<br />
* '''3''': Set the level, primary, and secondary powers of a beacon<br />
* '''4''': Set rotation and skin of mob head<br />
* '''5''': Set type of flower in flower pot<br />
* '''6''': Set base color and patterns on a banner<br />
<br />
==== 打开标志牌编辑器 ====<br />
<br />
Sent on placement of sign.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="1"| 0x36<br />
|rowspan="1"| Play<br />
|rowspan="1"| Client<br />
| Location<br />
| Position<br />
| <br />
|}<br />
<br />
==== 统计数据 ====<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To <br />
!colspan="2"| Field Name<br />
!colspan="2"| Field Type<br />
! Notes<br />
|-<br />
|rowspan="3"| 0x37<br />
|rowspan="3"| Play<br />
|rowspan="3"| Client<br />
|colspan="2"| Count<br />
|colspan="2"| VarInt<br />
| Number of elements in the following array<br />
|-<br />
|rowspan="2"| Statistic<br />
| Name<br />
|rowspan="2"| Array<br />
| String<br />
| [https://gist.github.com/thinkofdeath/a1842c21a0cf2e1fb5e0 https://gist.github.com/thinkofdeath/a1842c21a0cf2e1fb5e0]<br />
|-<br />
| Value<br />
| VarInt<br />
| The amount to set it to<br />
|}<br />
<br />
==== 玩家列表项 ====<br />
<br />
Sent by the notchian server to update the user list (<tab> in the client).<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
!colspan="4"| Field Name<br />
!colspan="3"| Field Type<br />
! Notes<br />
|-<br />
|rowspan="19"| 0x38<br />
|rowspan="19"| Play<br />
|rowspan="19"| Client<br />
|colspan="4"| Action<br />
|colspan="3"| VarInt<br />
| Determines the rest of the Player format after the UUID<br />
|-<br />
|colspan="4"| Number Of Players<br />
|colspan="3"| VarInt<br />
| Number of elements in the following array<br />
|-<br />
|rowspan="17"| Player<br />
|colspan="3"| UUID<br />
|rowspan="17"| Array<br />
|colspan="2"| UUID<br />
| <br />
|-<br />
! Action<br />
!colspan="2"| Field Name<br />
!colspan="2"| <br />
! <br />
|-<br />
|rowspan="10"| 0: add player<br />
|colspan="2"| Name<br />
|colspan="2"| String<br />
| <br />
|-<br />
|colspan="2"| Number Of Properties<br />
|colspan="2"| VarInt<br />
| Number of elements in the following array<br />
|-<br />
|rowspan="4"| Property<br />
| Name<br />
|rowspan="4"| Array<br />
| String<br />
| <br />
|-<br />
| Value<br />
| String<br />
| <br />
|- <br />
| Is Signed<br />
| Boolean<br />
| <br />
|-<br />
| Signature<br />
| Optional String<br />
| Only if Is Signed is true<br />
|-<br />
|colspan="2"| Gamemode<br />
|colspan="2"| VarInt<br />
| <br />
|-<br />
|colspan="2"| Ping<br />
|colspan="2"| VarInt<br />
| <br />
|-<br />
|colspan="2"| Has Display Name<br />
|colspan="2"| Boolean<br />
| <br />
|-<br />
|colspan="2"| Display Name<br />
|colspan="2"| Optional [[Chat]]<br />
| Only if Has Display Name is true<br />
|-<br />
| 1: update gamemode<br />
|colspan="2"| Gamemode<br />
|colspan="2"| VarInt<br />
| <br />
|- <br />
| 2: update latency<br />
|colspan="2"| Ping<br />
|colspan="2"| VarInt<br />
| <br />
|-<br />
|rowspan="2"| 3: update display name<br />
|colspan="2"| Has Display Name<br />
|colspan="2"| Boolean<br />
| <br />
|-<br />
|colspan="2"| Display Name<br />
|colspan="2"| Optional [[Chat]]<br />
| Only send if Has Display Name is true<br />
|-<br />
| 4: remove player<br />
|colspan="2"| ''no fields''<br />
|colspan="2"| ''no fields''<br />
| <br />
|}<br />
<br />
==== 玩家能力 ====<br />
<br />
The latter 2 floats are used to indicate the walking and flying speeds respectively, while the first byte is used to determine the value of 4 booleans.<br />
<br />
The flags are whether damage is disabled (god mode, 8, bit 3), whether the player can fly (4, bit 2), whether the player is flying (2, bit 1), and whether the player is in creative mode (1, bit 0).<br />
<br />
To get the values of these booleans, simply AND (&) the byte with 1,2,4 and 8 respectively, to get the 0 or 1 bitwise value. To set them OR (|) them with their repspective masks.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="3"| 0x39<br />
|rowspan="3"| Play<br />
|rowspan="3"| Client<br />
| Flags<br />
| Byte<br />
| Bit mask, see above<br />
|-<br />
| Flying Speed<br />
| Float<br />
| <br />
|-<br />
| Walking Speed<br />
| Float<br />
| <br />
|}<br />
<br />
==== Tab补全 ====<br />
<br />
The server responds with a list of auto-completions of the last word sent to it. In the case of regular chat, this is a player username. Command names and parameters are also supported.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="2"| 0x3A<br />
|rowspan="2"| Play<br />
|rowspan="2"| Client<br />
| Count<br />
| VarInt<br />
| Number of elements in the following array<br />
|-<br />
| Matches<br />
| Array of String<br />
| One eligible command, note that each command is sent separately instead of in a single string, hence the need for Count<br />
|}<br />
<br />
==== 计分板目标 ====<br />
<br />
This is sent to the client when it should create a new {{Minecraft Wiki|scoreboard}} objective or remove one.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="4"| 0x3B<br />
|rowspan="4"| Play<br />
|rowspan="4"| Client<br />
| Objective Name<br />
| String<br />
| An unique name for the objective<br />
|-<br />
| Mode<br />
| Byte<br />
| 0 to create the scoreboard. 1 to remove the scoreboard. 2 to update the display text. <br />
|-<br />
| Objective Value<br />
| Optional String<br />
| Only if mode is 0 or 2. The text to be displayed for the score<br />
|-<br />
| Type<br />
| Optional String<br />
| Only if mode is 0 or 2. “integer” or “hearts”<br />
|}<br />
<br />
==== 更新分数 ====<br />
<br />
This is sent to the client when it should update a scoreboard item. <br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="4"| 0x3C<br />
|rowspan="4"| Play<br />
|rowspan="4"| Client<br />
| Score Name<br />
| String<br />
| The name of the score to be updated or removed<br />
|-<br />
| Action<br />
| Byte<br />
| 0 to create/update an item. 1 to remove an item.<br />
|-<br />
| Objective Name<br />
| String<br />
| The name of the objective the score belongs to<br />
|-<br />
| Value<br />
| Optional VarInt<br />
| The score to be displayed next to the entry. Only sent when Action does not equal 1.<br />
|}<br />
<br />
==== 显示计分板 ====<br />
<br />
This is sent to the client when it should display a scoreboard.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="2"| 0x3D<br />
|rowspan="2"| Play<br />
|rowspan="2"| Client<br />
| Position<br />
| Byte<br />
| The position of the scoreboard. 0: list, 1: sidebar, 2: below name.<br />
|-<br />
| Score Name<br />
| String<br />
| The unique name for the scoreboard to be displayed.<br />
|}<br />
<br />
==== 团队 ====<br />
<br />
Creates and updates teams.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="10"| 0x3E<br />
|rowspan="10"| Play<br />
|rowspan="10"| Client<br />
| Team Name<br />
| String<br />
| A unique name for the team. (Shared with scoreboard).<br />
|-<br />
| Mode<br />
| Byte<br />
| If 0 then the team is created.<br />
<br />
If 1 then the team is removed. <br />
<br />
If 2 the team team information is updated. <br />
<br />
If 3 then new players are added to the team. <br />
<br />
If 4 then players are removed from the team.<br />
|-<br />
| Team Display Name<br />
| Optional String<br />
| Only if Mode = 0 or 2.<br />
|-<br />
| Team Prefix<br />
| Optional String<br />
| Only if Mode = 0 or 2. Displayed before the players' name that are part of this team<br />
|-<br />
| Team Suffix<br />
| Optional String<br />
| Only if Mode = 0 or 2. Displayed after the players' name that are part of this team<br />
|-<br />
| Friendly Fire<br />
| Optional Byte<br />
| Only if Mode = 0 or 2. 0 for off, 1 for on, 3 for seeing friendly invisibles<br />
|-<br />
| Name Tag Visibility<br />
| Optional String<br />
| Only if Mode = 0 or 2. always, hideForOtherTeams, hideForOwnTeam, never<br />
|-<br />
| Color<br />
| Optional Byte<br />
| Only if Mode = 0 or 2. Same as [[Chat]] colors<br />
|-<br />
| Player Count<br />
| Optional VarInt<br />
| Only if Mode = 0 or 3 or 4. Number of players in the array<br />
|-<br />
| Players<br />
| Optional Array of String<br />
| Only if Mode = 0 or 3 or 4. Players to be added/remove from the team. Max 40 characters so may be uuid's later<br />
|}<br />
<br />
==== 插件信息 ====<br />
<br />
Mods and plugins can use this to send their data. Minecraft itself uses a number of [[plugin channel]]s. These internal channels are prefixed with <code>MC|</code>.<br />
<br />
More documentation on this: [http://dinnerbone.com/blog/2012/01/13/minecraft-plugin-channels-messaging/ http://dinnerbone.com/blog/2012/01/13/minecraft-plugin-channels-messaging/]<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="2"| 0x3F<br />
|rowspan="2"| Play<br />
|rowspan="2"| Client<br />
| Channel<br />
| String<br />
| Name of the [[plugin channel]] used to send the data<br />
|-<br />
| Data<br />
| Byte Array<br />
| Any data, depending on the channel. <code><nowiki>MC|</nowiki></code> channels are documented [[plugin channel|here]].<br />
|}<br />
<br />
==== 断开连接 ====<br />
<br />
Sent by the server before it disconnects a client. The server assumes that the sender has already closed the connection by the time the packet arrives.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
| 0x40<br />
|rowspan="1"| Play<br />
|rowspan="1"| Client<br />
| Reason<br />
| [[Chat]]<br />
| Displayed to the client when the connection terminates.<br />
|}<br />
<br />
==== 服务器难度 ====<br />
<br />
Changes the difficulty setting in the client's option menu<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="1"| 0x41<br />
|rowspan="1"| Play<br />
|rowspan="1"| Client<br />
| Difficulty<br />
| Unsigned Byte<br />
| 0: peaceful, 1: easy, 2: normal, 3: hard<br />
|}<br />
<br />
==== 战斗事件 ====<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="6"| 0x42<br />
|rowspan="6"| Play<br />
|rowspan="6"| Client<br />
| Event<br />
| VarInt<br />
| 0: enter combat, 1: end combat, 2: entity dead<br />
|-<br />
| Duration<br />
| Optional VarInt<br />
| Only for end combat<br />
|-<br />
| Player ID<br />
| Optional VarInt<br />
| Only for entity dead<br />
|-<br />
| Entity ID<br />
| Optional Int<br />
| Only for end combat and entity dead<br />
|-<br />
| Message<br />
| String<br />
| Only for entity dead<br />
|}<br />
<br />
==== 摄像机 ====<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="1"| 0x43<br />
|rowspan="1"| Play<br />
|rowspan="1"| Client<br />
| Camera ID<br />
| VarInt<br />
| <br />
|}<br />
<br />
==== 世界边界 ==== <br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
!colspan="2"| Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="18"| 0x44<br />
|rowspan="18"| Play<br />
|rowspan="18"| Client<br />
|colspan="2"| Action<br />
| VarInt<br />
| Determines the format of the rest of the packet<br />
|-<br />
! Action<br />
! Field Name<br />
! <br />
! <br />
|-<br />
| 0: set size<br />
| Radius<br />
| Double<br />
| meters<br />
|-<br />
|rowspan="3"| 1: lerp size<br />
| Old Radius<br />
| Double<br />
| meters<br />
|-<br />
| New Radius<br />
| Double<br />
| meters<br />
|-<br />
| Speed<br />
| VarLong<br />
| number of real-time ticks/seconds (?) until New Radius is reached. From experiments, it appears that Notchian server does not sync world border speed to game ticks, so it gets out of sync with server lag<br />
|-<br />
|rowspan="2"| 2: set center<br />
| X<br />
| Double<br />
| <br />
|-<br />
| Z<br />
| Double<br />
| <br />
|-<br />
|rowspan="8"| 3: initialize<br />
| X<br />
| Double<br />
| <br />
|-<br />
| Z<br />
| Double<br />
| <br />
|-<br />
| Old Radius<br />
| Double<br />
| <br />
|-<br />
| New Radius<br />
| Double<br />
| <br />
|-<br />
| Speed<br />
| VarLong<br />
| <br />
|-<br />
| Portal Teleport Boundary<br />
| VarInt<br />
| Resulting coordinates from a portal teleport are limited to +-value. Usually 29999984.<br />
|-<br />
| Warning Time<br />
| VarInt<br />
| <br />
|-<br />
| Warning Blocks<br />
| VarInt<br />
| <br />
|-<br />
|rowspan="1"| 4: set warning time<br />
| Warning Time<br />
| VarInt<br />
| unit?<br />
|-<br />
|rowspan="1"| 5: set warning blocks<br />
| Warning Blocks<br />
| VarInt<br />
| <br />
|}<br />
<br />
==== 显示标题 ==== <br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
!colspan="2"| Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="9"| 0x45<br />
|rowspan="9"| Play<br />
|rowspan="9"| Client<br />
|colspan="2"| Action<br />
| VarInt<br />
| <br />
|-<br />
! Action<br />
! Field Name<br />
! <br />
! <br />
|-<br />
| 0: set title<br />
| Title Text<br />
| [[Chat]]<br />
| <br />
|-<br />
| 1: set subtitle<br />
| Subtitle Text<br />
| [[Chat]]<br />
| <br />
|-<br />
|rowspan="3"| 2: set times and display<br />
| Fade In<br />
| Int<br />
| ticks<br />
|-<br />
| Stay<br />
| Int<br />
| ticks<br />
|-<br />
| Fade Out<br />
| Int<br />
| ticks<br />
|-<br />
| 3: hide<br />
| ''no fields''<br />
| ''no fields''<br />
| <br />
|-<br />
| 4: reset<br />
| ''no fields''<br />
| ''no fields''<br />
| <br />
|}<br />
<br />
“Hide” makes the title disappear, but if you run times again the same title will appear. “Reset” erases the text.<br />
<br />
==== 设置压缩 ====<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="1"| 0x46<br />
|rowspan="1"| Play<br />
|rowspan="1"| Client<br />
| Threshold<br />
| VarInt<br />
| Packets of this size or higher may be compressed<br />
|}<br />
<br />
==== 玩家列表页眉与页脚 ====<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="2"| 0x47<br />
|rowspan="2"| Play<br />
|rowspan="2"| Client<br />
| Header<br />
| [[Chat]]<br />
| <br />
|-<br />
| Footer<br />
| [[Chat]]<br />
| <br />
|}<br />
<br />
==== 发送资源包 ==== <br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="2"| 0x48<br />
|rowspan="2"| Play<br />
|rowspan="2"| Client<br />
| URL<br />
| String<br />
| The URL to the resource pack.<br />
|-<br />
| Hash<br />
| String<br />
| A 40 character hexadecimal and lowercase [[wikipedia:SHA-1|SHA-1]] hash of the resource pack file. (must be lower case in order to work)<br />If it's not a 40 character hexadecimal string, the client will not use it for hash verification and likely waste bandwidth — but it will still treat it as a unique id<br />
|}<br />
<br />
==== 更新实体 NBT ==== <br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="2"| 0x49<br />
|rowspan="2"| Play<br />
|rowspan="2"| Client<br />
| Entity ID<br />
| VarInt<br />
| <br />
|-<br />
| Tag<br />
| [[NBT|NBT Tag]]<br />
| <br />
|}<br />
<br />
=== 发送到服务器 ===<br />
<br />
==== 保持连接 ====<br />
<br />
服务器会经常发送一个保持连接包，内含一个随机的ID。客户端必须回应同样的包。<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="1"| 0x00<br />
|rowspan="1"| Play<br />
|rowspan="1"| Server<br />
| Keep Alive ID<br />
| VarInt<br />
| <br />
|}<br />
<br />
==== 聊天信息 ====<br />
<br />
默认服务端会检查信息是否以 '/' 开头。如果不是是，发送者的用户名将被放在消息前并且发送到所有其他客户端（包括原始的发送者）。如果是，服务端认为它是一个命令并尝试处理它。一个长度大于 100 的信息会导致服务端踢出该客户端。这个行为一开始是在不修改服务端的前提下不允许客户端不分段发送长度超过 119（以前的限制）的信息。因为这个原因，原始的服务端保留了在 119 处将消息切片的代码，但是这不是一个协议限制并且可以被跳过。<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="1"| 0x01<br />
|rowspan="1"| Play<br />
|rowspan="1"| Server<br />
| Message<br />
| String<br />
| The client sends the raw input, not [[Chat]]<br />
|}<br />
<br />
==== 使用实体 ====<br />
<br />
这个包在玩家攻击或者右键点击其他实体（一个玩家、矿车等）时从客户端发往服务器。<br />
<br />
一个官方服务端只在被攻击或使用的实体是可视的、在以玩家为中心 4单位 的范围内且与玩家之间没有阻碍时才接受这个包。<br />
<br />
注意：创造模式的中键点击会被客户端解析且被发送为 [[#Creative Inventory Action|创造背包动作]] 包。<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="5"| 0x02<br />
|rowspan="5"| Play<br />
|rowspan="5"| Server<br />
| Target<br />
| VarInt<br />
| <br />
|-<br />
| Type<br />
| VarInt<br />
| 0: interact, 1: attack, 2: interact at<br />
|-<br />
| Target X<br />
| Optional Float<br />
| 只有当类型为 interact at 时<br />
|-<br />
| Target Y<br />
| Optional Float<br />
| 只有当类型为 interact at 时<br />
|-<br />
| Target Z<br />
| Optional Float<br />
| 只有当类型为 interact at 时<br />
|}<br />
<br />
==== 玩家状态 ====<br />
<br />
这个包用于表明玩家正在陆地上（行走/游泳）还是在空中（跳跃/掉落）。<br />
<br />
当从足够高的高度掉落，这个状态从 false 设置为 true 时会受到掉落伤害。受到伤害的数值基于最后状态从 true 设置为 false。 注意有一些运动相关的包包含了这个包。<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="1"| 0x03<br />
|rowspan="1"| Play<br />
|rowspan="1"| Server<br />
| On Ground<br />
| Boolean<br />
| 当对象站在地上时为 true , 反之则为 false<br />
|}<br />
<br />
==== 玩家坐标 ====<br />
<br />
更新玩家在服务器上的 XYZ 坐标。<br />
<br />
如果在服务器上最后记录的位置和这个包设置的新位置之间的距离大于 100 单位，将会导致客户端因为 “You moved too quickly :( (Hacking?)” 而被踢出服务器。<br />
<br />
如果之间的距离大于 10 单位，服务器会在日志中写下警告信息 “<name> moved too quickly!” 和两个三元坐标（可能是运动增量？），但不会踢出客户端。<br />
<br />
如果 X 或 Z 的定点数被设置大于 3.2×10<sup>7</sup> 客户端会因为 “Illegal position” 而被踢出服务器。<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="4"| 0x04<br />
|rowspan="4"| Play<br />
|rowspan="4"| Server<br />
| X<br />
| Double<br />
| 绝对位置<br />
|-<br />
| Feet Y<br />
| Double<br />
| 绝对位置，史蒂夫头部一般在 Y - 1.62<br />
|-<br />
| Z<br />
| Double<br />
| 绝对位置<br />
|-<br />
| On Ground<br />
| Boolean<br />
| 当对象站在地上时为 true , 反之则为 false<br />
|}<br />
<br />
==== 玩家观察 ====<br />
[[File:Minecraft-trig-yaw.png|thumb|The unit circle for yaw]]<br />
[[File:Yaw.png|thumb|The unit circle of yaw, redrawn]]<br />
<br />
更新玩家目前所看的方向。<br />
<br />
偏航（Yaw）以度为单位，并且不遵循经典的三角规则。</div>
梦彗業
https://mineplugin.org/index.php?title=Protocol&diff=5410
Protocol
2017-09-02T14:10:02Z
<p>梦彗業：翻译订正</p>
<hr />
<div>{{待翻译}}<br />
{{待更新|url=http://wiki.vg/Protocol}}<br />
<br />
这里剖析了最近的 '''[http://wiki.vg/Protocol_Encryption Minecraft协议]'''.<br />
<br />
如果你有疑问, 请查阅下文或在IRC请求帮助 ([irc://irc.freenode.net/mcdevs #mcdevs on irc.freenode.net]).<br />
<br />
'''注意:''' 你可以不受限制地使用这个页面的内容来创建服务端, 客户端, 机器人…… 诸如此类的任何东西…<br />
<br />
== 定义 ==<br />
<br />
Minecraft服务器是基于TCP通讯的。它和客户端使用所谓的 ''数据包''交流. 一个包被通过字节编码后从TCP连接中发送. 数据包的含义取决于其包标识和连接的当前状态. 每个链接从 '''[http://wiki.vg/Handshaking 握手]'''开始, 使用包切换状态 '''[http://wiki.vg/Handshaking 握手]''',( 0x00, serverbound) 和 [[#Login Success|成功登陆]] ([[#Login|登陆]], 0x02, clientbound).<br />
<br />
=== 数据类型 ===<br />
<br />
<!-- Transcluded contents of Data Types article in here - go to that page if you want to edit it --><br />
<br />
{{:Data Types}}<br />
<br />
=== 其他定义 ===<br />
<br />
{| class="wikitable"<br />
|-<br />
! 术语<br />
! 定义<br />
|-<br />
| Player——玩家<br />
| 使用时, 玩家通常使用它来链接到服务端.<br />
|-<br />
| Entity——实体<br />
| 实体相当于玩家、物品、怪物、船和矿车等. 查看 {{Minecraft Wiki|Entity|the Minecraft Wiki article}} 来寻找一个完整的表单.<br />
|-<br />
| EID——实体ID<br />
| An EID — 或者说是实体ID — 是一个用来识别特定实体的4字节序列. 在同一个服务器,没有相同的实体编号.<br />
|-<br />
| XYZ坐标<br />
| 游戏时，可以使用按钮“F3”来在屏幕上查看坐标位置 Y代表高度, X代表东西, Z代表南北.<br />
|-<br />
| 单位“Meter”<br />
| Meter是Minecraft的基本长度单位, 相当于一个方块的长度. “block”一词也许意味着 “meter”或者“cubic meter”.<br />
|}<br />
<br />
== 数据包的格式 ==<br />
<br />
=== 无压缩 ===<br />
<br />
{| class="wikitable"<br />
! 域名称<br />
! 域类型<br />
! 注释<br />
|-<br />
| 长度<br />
| VarInt<br />
| 包数据的长度 + 包序号的长度<br />
|-<br />
| 包序号<br />
| VarInt<br />
| <br />
|-<br />
| 数据<br />
| Byte Array<br />
| 依赖于连接状态和包序号，详见下面的部分。<br />
|}<br />
<br />
=== 压缩 ===<br />
<br />
当一个 [[#Set Compression|设置压缩]] 包被发送，[[wikipedia:Zlib|zlib]] 压缩将会对之后的所有包开启。 包的格式略微改变以包含未压缩前的包的长度。<br />
''译注：注意区分包长度和数据长度，关系：“包”包含“数据”''<br />
{| class=wikitable<br />
! 是否压缩<br />
! 域名称<br />
! 域类型<br />
! 注释<br />
|-<br />
| 否<br />
| 包长度<br />
| VarInt<br />
| 数据长度的长度 + 压缩后的 (包序号 + 数据) 的长度<br />
|-<br />
| 否<br />
| 数据长度<br />
| VarInt<br />
| 未压缩前的 (包序号 + 数据) 的长度 或 0<br />
|-<br />
|rowspan="2"| 是<br />
| 包序号<br />
| Varint<br />
| zlib 压缩后的包序号（详见下面的部分）<br />
|-<br />
| 数据<br />
| Byte Array<br />
| zlib 压缩后的包数据（详见下面的部分）<br />
|}<br />
<br />
包长度域提供的是包中存在的字节的数量，包括数据长度域。<br />
<br />
如果数据长度被设置为 0，则这个包没有被压缩；否则它表示已压缩的包未压缩前的包长度。<br />
<br />
如果包被压缩，压缩前的 (包序号 + 数据) 的长度必须等于或大于 [[#Set Compression|设置压缩]] 包中设置的最小值，否则客户端/服务端将会断开连接。<br />
<br />
压缩能通过发送一个最小值设定为 -1 的 [[#Set Compression|设置压缩]] 包来关闭。<br />
<br />
== 握手协议 ==<br />
<br />
=== 客户端绑定 ===<br />
<br />
因为协议在客户端发送第一个数据包后会立刻切换到另一个阶段，所以握手阶段没有客户端绑定的数据包。<br />
<br />
=== 服务端绑定 ===<br />
<br />
==== 握手协议 ====<br />
<br />
这将使得服务器切换至目标阶段。<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="4"| 0x00<br />
|rowspan="4"| Handshaking<br />
|rowspan="4"| Server<br />
| 协议版本<br />
| VarInt<br />
| See [[protocol version numbers]] (currently 47)<br />
|-<br />
| 服务器地址<br />
| String<br />
| 域名或是IP, 例如： localhost 或是 127.0.0.1<!-- does this support IPv6? --><br />
|- <br />
| 服务器端口<br />
| Unsigned Short<br />
| 默认值为25565<br />
|-<br />
| 下一阶段<br />
| VarInt<br />
| 1 for [[#Status|status]], 2 for [[#Login|login]]<br />
|}<br />
<br />
==== 传统的服务器列表Ping ====<br />
<br />
严格来说这不是当前协议的一部分，传统客户端可能会发送这一数据包来发起（initiate） [[Server List Ping]], 现代服务器也应当能够适当地处理这一数据包。<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
| 0xFE<br />
| Handshaking<br />
| Server<br />
| Payload<br />
| Unsigned Byte<br />
| always 1 (<code>0x01</code>)<br />
|}<br />
<br />
See [[Server List Ping#1.6]] for the details of the protocol that follows this packet.<br />
<br />
== 开始游戏 ==<br />
<br />
=== 发送到客户端 ===<br />
<br />
==== 心跳包 ====<br />
<br />
The server will frequently send out a keep-alive, each containing a random ID. The client must respond with the same packet. If the client does not respond to them for over 30 seconds, the server kicks the client. Vice versa, if the server does not send any keep-alives for 20 seconds, the client will disconnect and yields a "Timed out" exception.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="1"| 0x00<br />
|rowspan="1"| Play<br />
|rowspan="1"| Client<br />
| Keep Alive ID<br />
| VarInt<br />
| <br />
|}<br />
<br />
==== 加入游戏 ====<br />
<br />
See [[Protocol Encryption]] for information on logging in.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="7"| 0x01<br />
|rowspan="7"| Play<br />
|rowspan="7"| Client<br />
| Entity ID<br />
| Int<br />
| The player's Entity ID (EID)<br />
|-<br />
| Gamemode<br />
| Unsigned Byte<br />
| 0: Survival, 1: Creative, 2: Adventure, 3: Spectator. Bit 3 (0x8) is the hardcore flag.<br />
|-<br />
| Dimension<br />
| Byte<br />
| -1: Nether, 0: Overworld, 1: End<br />
|-<br />
| Difficulty<br />
| Unsigned Byte<br />
| 0: peaceful, 1: easy, 2: normal, 3: hard<br />
|-<br />
| Max Players<br />
| Unsigned Byte<br />
| Used by the client to draw the player list<br />
|-<br />
| Level Type<br />
| String<br />
| default, flat, largeBiomes, amplified, default_1_1<br />
|-<br />
| Reduced Debug Info<br />
| Boolean<br />
| If true, a Notchian client shows reduced information on the {{Minecraft Wiki|debug screen}}.<br />
|}<br />
<br />
{{Warning|如果位置无效，服务端将崩溃}}<br />
<br />
==== 聊天内容 ==== <br />
<br />
Identifying the difference between Chat/System Message is important as it helps respect the user's chat visibility options. While Position 2 accepts json formatting it will not display, old style formatting works<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="2"| 0x02<br />
|rowspan="2"| Play<br />
|rowspan="2"| Client<br />
| JSON Data<br />
| [[Chat]]<br />
| Limited to 32767 bytes<br />
|-<br />
| Position<br />
| Byte<br />
| 0: chat (chat box), 1: system message (chat box), 2: above action bar<br />
|}<br />
<br />
{{Warning|错误的JSON将断开连接}}<br />
<br />
==== 时间更新 ====<br />
<br />
Time is based on ticks, where 20 ticks happen every second. There are 24000 ticks in a day, making Minecraft days exactly 20 minutes long.<br />
<br />
The time of day is based on the timestamp modulo 24000. 0 is sunrise, 6000 is noon, 12000 is sunset, and 18000 is midnight.<br />
<br />
The default SMP server increments the time by <code>20</code> every second.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="2"| 0x03<br />
|rowspan="2"| Play<br />
|rowspan="2"| Client<br />
| World Age<br />
| Long<br />
| In ticks; not changed by server commands<br />
|-<br />
| Time of day<br />
| Long<br />
| The world (or region) time, in ticks. If negative the sun will stop moving at the Math.abs of the time<br />
|}<br />
<br />
==== 持有的物品 ====<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="3"| 0x04<br />
|rowspan="3"| Play<br />
|rowspan="3"| Client<br />
| Entity ID<br />
| VarInt<br />
| Entity's EID<br />
|-<br />
| Slot<br />
| Short<br />
| Equipment slot. 0: held, 1–4: armor slot (1: boots, 2: leggings, 3: chestplate, 4: helmet)<br />
|-<br />
| Item<br />
| [[Slot Data|Slot]]<br />
| Item in slot format<br />
|}<br />
<br />
==== 出生姿势 ====<br />
<br />
Sent by the server after login to specify the coordinates of the spawn point (the point at which players spawn at, and which the compass points to). It can be sent at any time to update the point compasses point at.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="1"| 0x05<br />
|rowspan="1"| Play<br />
|rowspan="1"| Client<br />
| Location<br />
| Position<br />
| Spawn location<br />
|}<br />
<br />
==== 更新生命值 ====<br />
<br />
Sent by the server to update/set the health of the player it is sent to.<br />
<br />
Food {{Minecraft Wiki|Food#Hunger vs. Saturation|saturation}} acts as a food “overcharge”. Food values will not decrease while the saturation is over zero. Players logging in automatically get a saturation of 5.0. Eating food increases the saturation as well as the food bar.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="3"| 0x06<br />
|rowspan="3"| Play<br />
|rowspan="3"| Client<br />
| Health<br />
| Float<br />
| 0 or less = dead, 20 = full HP<br />
|-<br />
| Food<br />
| VarInt<br />
| 0–20<br />
|- <br />
| Food Saturation<br />
| Float<br />
| Seems to vary from 0.0 to 5.0 in integer increments<br />
|}<br />
<br />
==== 重生 ====<br />
<br />
来改变玩家的位置(主世界/地狱/末地), 发送给他们一个重生指令, 其次是prechunks或chunks的新位置, and finally a position and look packet. You do not need to unload chunks, the client will do it automatically.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="4"| 0x07<br />
|rowspan="4"| Play<br />
|rowspan="4"| Client<br />
| Dimension<br />
| Int<br />
| -1: The Nether, 0: The Overworld, 1: The End<br />
|-<br />
| Difficulty<br />
| Unsigned Byte<br />
| 0: Peaceful, 1: Easy, 2: Normal, 3: Hard<br />
|-<br />
| Gamemode<br />
| Unsigned Byte<br />
| 0: survival, 1: creative, 2: adventure. The hardcore flag is not included<br />
|-<br />
| Level Type<br />
| String<br />
| Same as [[#Join Game|Join Game]]<br />
|}<br />
<br />
{{Warning|如果位置无效，服务端将崩溃 }}<br />
<br />
{{Warning|如果玩家出现在了相同的位置, weird bugs can occur i.e. such player will be unable to attack other players in new world (修复后他们将重生)}}<br />
<br />
==== 玩家姿势以及看的方向 ==== <br />
<br />
Updates the player's position on the server.<br />
<br />
If the distance between the last known position of the player on the server and the new position set by this packet is greater than 100 meters, the client will be kicked for “You moved too quickly :( (Hacking?)”.<br />
<br />
Also if the fixed-point number of X or Z is set greater than <code>3.2E7D</code> the client will be kicked for “Illegal position”.<br />
<br />
Yaw is measured in degrees, and does not follow classical trigonometry rules. The unit circle of yaw on the XZ-plane starts at (0, 1) and turns counterclockwise, with 90 at (-1, 0), 180 at (0, -1) and 270 at (1, 0). Additionally, yaw is not clamped to between 0 and 360 degrees; any number is valid, including negative numbers and numbers greater than 360.<br />
<br />
Pitch is measured in degrees, where 0 is looking straight ahead, -90 is looking straight up, and 90 is looking straight down.<br />
<br />
The yaw in degrees of a player standing at point (x0, z0) and looking towards point (x, z) can be calculated with:<br />
<br />
l = x-x0<br />
w = z-z0<br />
c = sqrt( l*l + w*w )<br />
alpha1 = -arcsin(l/c)/PI*180<br />
alpha2 = arccos(w/c)/PI*180<br />
if alpha2 > 90 then<br />
yaw = 180 - alpha1<br />
else<br />
yaw = alpha1<br />
<br />
You can get a unit vector from a given yaw/pitch via:<br />
<br />
x = -cos(pitch) * sin(yaw)<br />
y = -sin(pitch)<br />
z = cos(pitch) * cos(yaw)<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="6"| 0x08<br />
|rowspan="6"| Play<br />
|rowspan="6"| Client<br />
| X<br />
| Double<br />
| Absolute or relative position, depending on Flags<br />
|-<br />
| Y<br />
| Double<br />
| Absolute or relative position, depending on Flags<br />
|-<br />
| Z<br />
| Double<br />
| Absolute or relative position, depending on Flags<br />
|-<br />
| Yaw<br />
| Float<br />
| Absolute or relative rotation on the X Axis, in degrees<br />
|-<br />
| Pitch<br />
| Float<br />
| Absolute or relative rotation on the Y Axis, in degrees<br />
|-<br />
| Flags<br />
| Byte<br />
| Bit field, see below<br />
|}<br />
<br />
About the Flags field:<br />
<br />
<Dinnerbone> It's a bitfield, X/Y/Z/Y_ROT/X_ROT. If X is set, the x value is relative and not absolute.<br />
<br />
{| class="wikitable"<br />
|-<br />
! Field<br />
! Bit<br />
|-<br />
| X<br />
| 0x01<br />
|-<br />
| Y<br />
| 0x02<br />
|-<br />
| Z<br />
| 0x04<br />
|-<br />
| Y_ROT<br />
| 0x08<br />
|-<br />
| X_ROT<br />
| 0x10<br />
|}<br />
<br />
==== 持有物品变更 ====<br />
<br />
Sent to change the player's slot selection.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="1"| 0x09<br />
|rowspan="1"| Play<br />
|rowspan="1"| Client<br />
| Slot<br />
| Byte<br />
| The slot which the player has selected (0–8)<br />
|}<br />
<br />
==== 使用床 ==== <br />
<br />
This packet tells that a player goes to bed.<br />
<br />
The client with the matching Entity ID will go into bed mode.<br />
<br />
This Packet is sent to all nearby players including the one sent to bed.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="2"| 0x0A<br />
|rowspan="2"| Play<br />
|rowspan="2"| Client<br />
| Entity ID<br />
| VarInt<br />
| Sleeping player's EID<br />
|-<br />
| Location<br />
| Position<br />
| Block location of the head part of the bed<br />
|}<br />
<br />
==== 动画 ====<br />
<br />
Sent whenever an entity should change animation.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="2"| 0x0B<br />
|rowspan="2"| Play<br />
|rowspan="2"| Client<br />
| Entity ID<br />
| VarInt<br />
| Player ID<br />
|-<br />
| Animation<br />
| Unsigned Byte<br />
| Animation ID (see below)<br />
|}<br />
<br />
Animation can be one of the following values:<br />
<br />
{| class="wikitable"<br />
! ID<br />
! Animation<br />
|-<br />
| 0<br />
| Swing arm<br />
|-<br />
| 1<br />
| Take damage<br />
|-<br />
| 2<br />
| Leave bed<br />
|-<br />
| 3<br />
| Eat food<br />
|-<br />
| 4<br />
| Critical effect<br />
|-<br />
| 5<br />
| Magic critical effect<br />
|}<br />
<br />
==== 生成玩家 ====<br />
<br />
This packet is sent by the server when a player comes into visible range, ''not'' when a player joins.<br />
<br />
This packet must be sent after the [[#Player List Item|Player List Item]] ([[#Play|Play]], 0x38, clientbound) packet that adds the player data for the client to use when spawning a player. If the tab list entry for the UUID included in this packet is not present when this packet arrives, the entity will not be spawned. The tab includes skin/cape data.<br />
<br />
Servers can, however, safely spawn player entities for players not in visible range. The client appears to handle it correctly.<br />
<br />
When in online-mode the UUIDs must be valid and have valid skin blobs, in offline-mode UUID v3 is used.<br />
<br />
For NPCs UUID v2 should be used. Note:<br />
<br />
<+Grum> i will never confirm this as a feature you know that :)<br />
<br />
In an example UUID, <code>xxxxxxxx-xxxx-Yxxx-xxxx-xxxxxxxxxxxx</code>, the UUID version is specified by <code>Y</code>. So, for UUID v3, <code>Y</code> will always be <code>3</code>, and for UUID v2, <code>Y</code> will always be <code>2</code>.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="9"| 0x0C<br />
|rowspan="9"| Play<br />
|rowspan="9"| Client<br />
| Entity ID<br />
| VarInt<br />
| Player's EID<br />
|-<br />
| Player UUID<br />
| UUID<br />
| <br />
|-<br />
| X<br />
| Int<br />
| Player X as a [[Data Types#Fixed-point numbers|Fixed-Point number]]<br />
|-<br />
| Y<br />
| Int<br />
| Player Y as a [[Data Types#Fixed-point numbers|Fixed-Point number]]<br />
|-<br />
| Z<br />
| Int<br />
| Player Z as a [[Data Types#Fixed-point numbers|Fixed-Point number]]<br />
|-<br />
| Yaw<br />
| Angle<br />
| <br />
|-<br />
| Pitch<br />
| Angle<br />
| <br />
|-<br />
| Current Item<br />
| Short<br />
| The item the player is currently holding. Note that this should be 0 for “no item”, unlike -1 used in other packets.<br />
|-<br />
| Metadata<br />
| [[Entities#Entity Metadata Format|Metadata]]<br />
| <br />
|}<br />
<br />
{{Warning|A negative Current Item crashes clients}}<br />
<br />
{{Warning|The client will crash if no Metadata is sent}}<br />
<br />
==== 拾起物品 ====<br />
<br />
Sent by the server when someone picks up an item lying on the ground — its sole purpose appears to be the animation of the item flying towards you. It doesn't destroy the entity in the client memory, and it doesn't add it to your inventory. The server only checks for items to be picked up after each [[#Player Position|Player Position]] (and [[#Player Position And Look|Player Position And Look]]) packet sent by the client.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="2"| 0x0D<br />
|rowspan="2"| Play<br />
|rowspan="2"| Client<br />
| Collected Entity ID<br />
| VarInt<br />
| <br />
|- <br />
| Collector Entity ID<br />
| VarInt<br />
| <br />
|}<br />
<br />
==== 生成对象 ====<br />
<br />
Sent by the server when an Object/Vehicle is created.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="8"| 0x0E<br />
|rowspan="8"| Play<br />
|rowspan="8"| Client<br />
| Entity ID <br />
| VarInt<br />
| EID of the object<br />
|-<br />
| Type<br />
| Byte<br />
| The type of object (See [[Entities#Objects|Objects]])<br />
|-<br />
| X<br />
| Int<br />
| X position as a [[Data Types#Fixed-point numbers|Fixed-Point number]]<br />
|-<br />
| Y<br />
| Int<br />
| Y position as a [[Data Types#Fixed-point numbers|Fixed-Point number]]<br />
|-<br />
| Z<br />
| Int<br />
| Z position as a [[Data Types#Fixed-point numbers|Fixed-Point number]]<br />
|-<br />
| Pitch<br />
| Angle<br />
| <br />
|-<br />
| Yaw<br />
| Angle<br />
| <br />
|-<br />
| Data<br />
| [[Object Data]]<br />
| <br />
|}<br />
<br />
==== 生成怪物 ====<br />
<br />
Sent by the server when a Mob Entity is Spawned<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="12"| 0x0F<br />
|rowspan="12"| Play<br />
|rowspan="12"| Client<br />
| Entity ID<br />
| VarInt<br />
| <br />
|-<br />
| Type<br />
| Unsigned Byte<br />
| The type of mob. See [[Entities#Mobs|Mobs]]<br />
|-<br />
| X<br />
| Int<br />
| X position as a [[Data Types#Fixed-point numbers|Fixed-Point number]] <br />
|-<br />
| Y<br />
| Int<br />
| Y position as a [[Data Types#Fixed-point numbers|Fixed-Point number]] <br />
|-<br />
| Z<br />
| Int<br />
| Z position as a [[Data Types#Fixed-point numbers|Fixed-Point number]] <br />
|-<br />
| Yaw<br />
| Angle<br />
| <br />
|-<br />
| Pitch<br />
| Angle<br />
| <br />
|-<br />
| Head Pitch<br />
| Angle<br />
| <br />
|-<br />
| Velocity X<br />
| Short<br />
| Same units as [[#Entity Velocity|Entity Velocity]]<br />
|-<br />
| Velocity Y<br />
| Short<br />
| Same units as [[#Entity Velocity|Entity Velocity]]<br />
|-<br />
| Velocity Z<br />
| Short<br />
| Same units as [[#Entity Velocity|Entity Velocity]]<br />
|-<br />
| Metadata<br />
| [[Entities#Entity Metadata Format|Metadata]]<br />
| <br />
|}<br />
<br />
==== 重生绘图 ====<br />
<br />
This packet shows location, name, and type of painting.<br />
<br />
Calculating the center of an image: given a (width x height) grid of cells, with (0, 0) being the top left corner, the center is (max(0, width / 2 - 1), height / 2). E.g.<br />
<br />
2x1 (1, 0)<br />
4x4 (1, 2)<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="4"| 0x10<br />
|rowspan="4"| Play<br />
|rowspan="4"| Client<br />
| Entity ID<br />
| VarInt<br />
| <br />
|-<br />
| Title<br />
| String<br />
| Name of the painting. Max length 13<br />
|-<br />
| Location<br />
| Position<br />
| Center coordinates<br />
|-<br />
| Direction<br />
| Unsigned Byte<br />
| Direction the painting faces. 0: north (-z), 1: west (-x), 2: south (+z), 3: east (+x)<br />
|}<br />
<br />
==== 重生掉落经验 ====<br />
<br />
Spawns one or more experience orbs.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="5"| 0x11<br />
|rowspan="5"| Play<br />
|rowspan="5"| Client<br />
| Entity ID<br />
| VarInt<br />
| Entity's ID<br />
|-<br />
| X<br />
| Int<br />
| X position as a [[Data Types#Fixed-point numbers|Fixed-Point number]]<br />
|-<br />
| Y<br />
| Int<br />
| Y position as a [[Data Types#Fixed-point numbers|Fixed-Point number]]<br />
|-<br />
| Z<br />
| Int<br />
| Z position as a [[Data Types#Fixed-point numbers|Fixed-Point number]]<br />
|-<br />
| Count<br />
| Short<br />
| The amount of experience this orb will reward once collected<br />
|}<br />
<br />
==== 实体速率 ====<br />
<br />
Velocity is believed to be in units of 1/8000 of a block per server tick (50ms); for example, -1343 would move (-1343 / 8000) = −0.167875 blocks per tick (or −3,3575 blocks per second).<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="4"| 0x12<br />
|rowspan="4"| Play<br />
|rowspan="4"| Client<br />
| Entity ID<br />
| VarInt<br />
| <br />
|-<br />
| Velocity X<br />
| Short<br />
| Velocity on the X axis<br />
|-<br />
| Velocity Y<br />
| Short<br />
| Velocity on the Y axis<br />
|-<br />
| Velocity Z<br />
| Short<br />
| Velocity on the Z axis<br />
|}<br />
<br />
==== 销毁实体 ====<br />
<br />
Sent by the server when a list of entities is to be destroyed on the client.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="2"| 0x13<br />
|rowspan="2"| Play<br />
|rowspan="2"| Client<br />
| Count<br />
| VarInt<br />
| Number of elements in the following array<br />
|-<br />
| Entity IDs<br />
| Array of VarInt<br />
| The list of entities of destroy<br />
|}<br />
<br />
==== 实体 ====<br />
<br />
This packet may be used to initialize an entity.<br />
<br />
For player entities, either this packet or any move/look packet is sent every game tick. So the meaning of this packet is basically that the entity did not move/look since the last such packet.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="1"| 0x14<br />
|rowspan="1"| Play<br />
|rowspan="1"| Client<br />
| Entity ID<br />
| VarInt<br />
| <br />
|}<br />
<br />
==== 实体相对移动 ====<br />
<br />
This packet is sent by the server when an entity moves less then 4 blocks; if an entity moves more than 4 blocks [[#Entity Teleport|Entity Teleport]] should be sent instead.<br />
<br />
This packet allows at most four blocks movement in any direction, because byte range is from -128 to 127.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="5"| 0x15<br />
|rowspan="5"| Play<br />
|rowspan="5"| Client<br />
| Entity ID<br />
| VarInt<br />
| <br />
|-<br />
| Delta X<br />
| Byte<br />
| Change in X position as a [[Data Types#Fixed-point numbers|Fixed-Point number]]<br />
|-<br />
| Delta Y<br />
| Byte<br />
| Change in Y position as a [[Data Types#Fixed-point numbers|Fixed-Point number]]<br />
|-<br />
| Delta Z<br />
| Byte<br />
| Change in Z position as a [[Data Types#Fixed-point numbers|Fixed-Point number]]<br />
|-<br />
| On Ground<br />
| Boolean<br />
| <br />
|}<br />
<br />
==== 实体朝向 ====<br />
<br />
This packet is sent by the server when an entity rotates.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="5"| 0x16<br />
|rowspan="5"| Play<br />
|rowspan="5"| Client<br />
| Entity ID<br />
| VarInt<br />
| <br />
|-<br />
| Yaw<br />
| Angle<br />
| New angle, not a delta<br />
|-<br />
| Pitch<br />
| Angle<br />
| New angle, not a delta<br />
|-<br />
| On Ground<br />
| Boolean<br />
| <br />
|}<br />
<br />
==== 实体朝向与相对移动 ====<br />
<br />
This packet is sent by the server when an entity rotates and moves. Since a byte range is limited from -128 to 127, and movement is offset of fixed-point numbers, this packet allows at most four blocks movement in any direction. (-128/32 == -4)<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="7"| 0x17<br />
|rowspan="7"| Play<br />
|rowspan="7"| Client<br />
| Entity ID<br />
| VarInt<br />
| <br />
|-<br />
| Delta X<br />
| Byte<br />
| Change in X position as a [[Data Types#Fixed-point numbers|Fixed-Point number]]<br />
|-<br />
| Delta Y<br />
| Byte<br />
| Change in Y position as a [[Data Types#Fixed-point numbers|Fixed-Point number]]<br />
|-<br />
| Delta Z<br />
| Byte<br />
| Change in Z position as a [[Data Types#Fixed-point numbers|Fixed-Point number]]<br />
|-<br />
| Yaw<br />
| Angle<br />
| New angle, not a delta<br />
|-<br />
| Pitch<br />
| Angle<br />
| New angle, not a delta<br />
|-<br />
| On Ground<br />
| Boolean<br />
| <br />
|}<br />
<br />
==== 实体传送 ====<br />
<br />
This packet is sent by the server when an entity moves more than 4 blocks.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="7"| 0x18<br />
|rowspan="7"| Play<br />
|rowspan="7"| Client<br />
| Entity ID<br />
| VarInt<br />
| <br />
|-<br />
| X<br />
| Int<br />
| X position as a [[Data Types#Fixed-point numbers|Fixed-Point number]]<br />
|-<br />
| Y<br />
| Int<br />
| Y position as a [[Data Types#Fixed-point numbers|Fixed-Point number]]<br />
|-<br />
| Z<br />
| Int<br />
| Z position as a [[Data Types#Fixed-point numbers|Fixed-Point number]]<br />
|-<br />
| Yaw<br />
| Angle<br />
| New angle, not a delta<br />
|-<br />
| Pitch<br />
| Angle<br />
| New angle, not a delta<br />
|-<br />
| On Ground<br />
| Boolean<br />
| <br />
|}<br />
<br />
==== 实体手朝向 ====<br />
<br />
Changes the direction an entity's head is facing.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="2"| 0x19<br />
|rowspan="2"| Play<br />
|rowspan="2"| Client<br />
| Entity ID<br />
| VarInt<br />
| <br />
|-<br />
| Head Yaw<br />
| Angle<br />
| New angle, not a delta<br />
|}<br />
<br />
==== 实体状态 ====<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="2"| 0x1A<br />
|rowspan="2"| Play<br />
|rowspan="2"| Client<br />
| Entity ID<br />
| Int<br />
| <br />
|-<br />
| Entity Status<br />
| Byte<br />
| See below<br />
|}<br />
<br />
{| class="wikitable"<br />
|-<br />
! Entity Status<br />
! Meaning<br />
|-<br />
| 1<br />
| Sent when resetting a mob spawn minecart's timer - appears to be unused by the client<br />
|-<br />
| 2<br />
| Living Entity hurt <br />
|-<br />
| 3<br />
| Living Entity dead<br />
|-<br />
| 4<br />
| Iron Golem throwing up arms<br />
|-<br />
| 6<br />
| Wolf/Ocelot/Horse taming — Spawn “heart” particles<br />
|-<br />
| 7<br />
| Wolf/Ocelot/Horse tamed — Spawn “smoke” particles<br />
|-<br />
| 8<br />
| Wolf shaking water — Trigger the shaking animation<br />
|-<br />
| 9<br />
| (of self) Eating accepted by server<br />
|-<br />
| 10<br />
| Sheep eating grass<br />
|-<br />
| 10<br />
| Play TNT ignite sound<br />
|-<br />
| 11<br />
| Iron Golem handing over a rose<br />
|-<br />
| 12<br />
| Villager mating — Spawn “heart” particles<br />
|-<br />
| 13<br />
| Spawn particles indicating that a villager is angry and seeking revenge<br />
|-<br />
| 14<br />
| Spawn happy particles near a villager<br />
|-<br />
| 15<br />
| Witch animation — Spawn “magic” particles<br />
|-<br />
| 16<br />
| Play zombie converting into a villager sound<br />
|-<br />
| 17<br />
| Firework exploding<br />
|-<br />
| 18<br />
| Animal in love (ready to mate) — Spawn “heart” particles<br />
|-<br />
| 19<br />
| Reset squid rotation<br />
|-<br />
| 20<br />
| Spawn explosion particle — works for some living entities<br />
|-<br />
| 21<br />
| Play guardian sound — works for every entity<br />
|-<br />
| 22<br />
| Enables reduced debug for players<br />
|-<br />
| 23<br />
| Disables reduced debug for players<br />
|}<br />
<br />
==== 附加实体 ====<br />
<br />
This packet is sent when a player has been attached to an entity (e.g. Minecart).<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="3"| 0x1B<br />
|rowspan="3"| Play<br />
|rowspan="3"| Client<br />
| Entity ID<br />
| Int<br />
| Attached entity's EID. Set to -1 to detach.<br />
|-<br />
| Vehicle ID<br />
| Int<br />
| Vechicle's Entity ID<br />
|-<br />
| Leash<br />
| Boolean<br />
| If true leashes the entity to the vehicle<br />
|}<br />
<br />
==== 实体数据值 ====<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="2"| 0x1C<br />
|rowspan="2"| Play<br />
|rowspan="2"| Client<br />
| Entity ID<br />
| VarInt<br />
| <br />
|-<br />
| Metadata<br />
| [[Entities#Entity Metadata Format|Metadata]]<br />
| <br />
|}<br />
<br />
==== 实体属性 ====<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="5"| 0x1D<br />
|rowspan="5"| Play<br />
|rowspan="5"| Client<br />
| Entity ID<br />
| VarInt<br />
| <br />
|-<br />
| Effect ID<br />
| Byte<br />
| See {{Minecraft Wiki|Status effect#List of effects|this table}}<br />
|-<br />
| Amplifier<br />
| Byte<br />
| Notchian client displays effect level as Amplifier + 1<br />
|-<br />
| Duration<br />
| VarInt<br />
| Seconds<br />
|-<br />
| Hide Particles<br />
| Boolean<br />
| <br />
|}<br />
<br />
==== 移除实体属性 ====<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="2"| 0x1E<br />
|rowspan="2"| Play<br />
|rowspan="2"| Client<br />
| Entity ID<br />
| VarInt<br />
| <br />
|-<br />
| Effect ID<br />
| Byte<br />
| See {{Minecraft Wiki|Status effect#List of effects|this table}}<br />
|}<br />
<br />
==== 设置经验值 ====<br />
<br />
Sent by the server when the client should change experience levels.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="3"| 0x1F<br />
|rowspan="3"| Play<br />
|rowspan="3"| Client<br />
| Experience bar<br />
| Float<br />
| Between 0 and 1<br />
|-<br />
| Level<br />
| VarInt<br />
| <br />
|-<br />
| Total Experience<br />
| VarInt<br />
| See {{Minecraft Wiki|Experience#Leveling up}} on the Minecraft Wiki for Total Experience to Level conversion<br />
|}<br />
<br />
==== 实体配置 ====<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
!colspan="2"| Field Name<br />
!colspan="2"| Field Type<br />
! Notes<br />
|-<br />
|rowspan="6"| 0x20<br />
|rowspan="6"| Play<br />
|rowspan="6"| Client<br />
|colspan="2"| Entity ID<br />
|colspan="2"| VarInt<br />
| <br />
|-<br />
|colspan="2"| Number Of Properties<br />
|colspan="2"| Int<br />
| Number of elements in the following array<br />
|-<br />
|rowspan="4"| Property<br />
| Key<br />
|rowspan="4"| Array<br />
| String<br />
| See below<br />
|-<br />
| Value<br />
| Double<br />
| See below<br />
|-<br />
| Number Of Modifiers<br />
| VarInt<br />
| Number of elements in the following array<br />
|-<br />
| Modifiers<br />
| Array of Modifier Data<br />
| See {{Minecraft Wiki|Attribute#Modifiers}}<br />
|}<br />
<br />
Known Key values:<br />
<br />
{| class="wikitable"<br />
|-<br />
! Key<br />
! Default<br />
! Min<br />
! Max<br />
! Label<br />
|-<br />
| generic.maxHealth<br />
| 20.0<br />
| 0.0<br />
| Double.MaxValue<br />
| Max Health<br />
|-<br />
| generic.followRange<br />
| 32.0<br />
| 0.0<br />
| 2048.0<br />
| Follow Range<br />
|-<br />
| generic.knockbackResistance<br />
| 0.0 <br />
| 0.0<br />
| 1.0<br />
| Knockback Resistance<br />
|-<br />
| generic.movementSpeed<br />
| 0.699999988079071<br />
| 0.0<br />
| Double.MaxValue<br />
| Movement Speed<br />
|-<br />
| generic.attackDamage<br />
| 2.0<br />
| 0.0<br />
| Double.MaxValue<br />
| <br />
|-<br />
| horse.jumpStrength<br />
| 0.7<br />
| 0.0<br />
| 2.0<br />
| Jump Strength<br />
|-<br />
| zombie.spawnReinforcements<br />
| 0.0<br />
| 0.0<br />
| 1.0<br />
| Spawn Reinforcements Chance<br />
|}<br />
<br />
''Modifier Data'' structure:<br />
<br />
{| class="wikitable"<br />
|-<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
| UUID<br />
| UUID<br />
| <br />
|-<br />
| Amount<br />
| Double<br />
| <br />
|-<br />
| Operation<br />
| Byte<br />
| <br />
|}<br />
<br />
==== 区块数据 ====<br />
<br />
Chunks are not unloaded by the client automatically. To unload chunks, send this packet with Ground-Up Continuous=true and no 16^3 chunks (eg. Primary Bit Mask=0). The server does not send skylight information for nether-chunks, it's up to the client to know if the player is currently in the nether. You can also infer this information from the primary bitmask and the amount of uncompressed bytes sent.<br />
<br />
See also: [[SMP Map Format]]<br />
<br />
Changes in 1.8:<br />
<br />
* Data value section removed<br />
* Extended id section removed<br />
* Block id section is now a unsigned short (little endian) per a block<br />
* The block id is equal to <code>(id << 4) | data</code><br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="6"| 0x21<br />
|rowspan="6"| Play<br />
|rowspan="6"| Client<br />
| Chunk X<br />
| Int<br />
| Chunk X coordinate<br />
|-<br />
| Chunk Z<br />
| Int<br />
| Chunk Z coordinate<br />
|-<br />
| Ground-Up Continuous<br />
| Boolean<br />
| This is true if the packet represents all sections in this vertical column, where the Primary Bit Mask specifies exactly which sections are included, and which are air<br />
|-<br />
| Primary Bit Mask<br />
| Unsigned Short<br />
| Bitmask with 1 for every 16x16x16 section whose data follows in the compressed data<br />
|- <br />
| Size<br />
| VarInt<br />
| Size of Data<br />
|-<br />
| Data<br />
| [[SMP Map Format#Data|Chunk]]<br />
| <br />
|}<br />
<br />
==== 多个方块改变 ====<br />
Fired whenever 2 or more blocks are changed within the render distance.<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
!colspan="2"| Field Name<br />
!colspan="2"| Field Type<br />
! Notes<br />
|-<br />
|rowspan="6"| 0x22<br />
|rowspan="6"| Play<br />
|rowspan="6"| Client<br />
|colspan="2"| Chunk X<br />
|colspan="2"| Int<br />
| Chunk X coordinate<br />
|-<br />
|colspan="2"| Chunk Z<br />
|colspan="2"| Int<br />
| Chunk Z coordinate<br />
|-<br />
|colspan="2"| Record Count<br />
|colspan="2"| VarInt<br />
| Number of elements in the following array, a.k.a. the number of blocks affected<br />
|-<br />
|rowspan="3"| Record<br />
| Horizontal Position<br />
|rowspan="3"| Array<br />
| Unsigned Byte<br />
| The 4 most significant bits (<code>0xF0</code>) encode the X coordinate, relative to the chunk. The 4 least significant bits (<code>0x0F</code>) encode the Z coordinate, relative to the chunk.<br />
|-<br />
| Y Coordinate<br />
| Unsigned Byte<br />
| <br />
|-<br />
| Block ID<br />
| VarInt<br />
| The new block ID for the block. <code><nowiki>id &lt;&lt; 4 | data</nowiki></code><br />
|}<br />
<br />
==== 方块改变 ====<br />
Fired whenever a block is changed within the render distance.<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="2"| 0x23<br />
|rowspan="2"| Play<br />
|rowspan="2"| Client<br />
| Location<br />
| Position<br />
| Block Coordinates<br />
|-<br />
| Block ID<br />
| VarInt<br />
| The new block ID for the block. <code><nowiki>id &lt;&lt; 4 | data</nowiki></code><br />
|}<br />
<br />
==== 方块功能 ====<br />
<br />
This packet is used for a number of things:<br />
<br />
* Chests opening and closing<br />
* Pistons pushing and pulling<br />
* Note blocks playing<br />
* Updating beacons<br />
<br />
See Also: [[Block Actions]] <br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="4"| 0x24<br />
|rowspan="4"| Play<br />
|rowspan="4"| Client<br />
| Location<br />
| Position<br />
| Block Coordinates<br />
|-<br />
| Byte 1<br />
| Unsigned Byte<br />
| Varies depending on block — see [[Block Actions]]<br />
|-<br />
| Byte 2<br />
| Unsigned Byte<br />
| Varies depending on block — see [[Block Actions]]<br />
|-<br />
| Block Type<br />
| VarInt<br />
| The block type for the block<br />
|}<br />
<br />
==== 方块破坏动画 ====<br />
<br />
0–9 are the displayable destroy stages and each other number means that there is no animation on this coordinate.<br />
<br />
You can also set an animation to air! The animation will still be visible.<br />
<br />
If you need to display several break animations at the same time you have to give each of them a unique Entity ID.<br />
<br />
Also if you set the coordinates to a special block like water etc. it won't show the actual break animation but some other interesting effects. (Water will lose it's transparency)<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="3"| 0x25<br />
|rowspan="3"| Play<br />
|rowspan="3"| Client<br />
| Entity ID<br />
| VarInt<br />
| EID for the animation<br />
|-<br />
| Location<br />
| Position<br />
| Block Position<br />
|-<br />
| Destroy Stage<br />
| Byte<br />
| 0–9 to set it, any other value to remove it<br />
|}<br />
<br />
==== 地图区块 ====<br />
<br />
1.8 changes at [[#Chunk Data|Chunk Data]]<br />
<br />
To reduce the number of bytes, this packet is used to send chunks together for better compression results.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
!colspan="2"| Field Name<br />
!colspan="2"| Field Type<br />
! Notes<br />
|-<br />
|rowspan="7"| 0x26<br />
|rowspan="7"| Play<br />
|rowspan="7"| Client<br />
|colspan="2"| Sky Light Sent<br />
|colspan="2"| Boolean<br />
| Whether or not Chunk Data contains light nibble arrays. This is true in the Overworld, false in the End + Nether<br />
|-<br />
|colspan="2"| Chunk Column Count<br />
|colspan="2"| VarInt<br />
| Number of elements in each of the following arrays<br />
|-<br />
|rowspan="3"| Chunk Meta<br />
| Chunk X<br />
|rowspan="3"| Array<br />
| Int<br />
| The X coordinate of the chunk<br />
|-<br />
| Chunk Z<br />
| Int<br />
| The Z coordinate of the chunk<br />
|-<br />
| Primary Bit Mask<br />
| Unsigned Short<br />
| A bit mask which specifies which sections are not empty in this chunk<br />
|-<br />
|colspan="2"| Chunk Data<br />
|colspan="2"| Array of [[SMP Map Format#Data|Chunk]]<br />
| Each chunk in this array corresponds to the data at the same position in Chunk Meta<br />
|}<br />
<br />
==== 爆炸 ====<br />
<br />
Sent when an explosion occurs (creepers, TNT, and ghast fireballs).<br />
<br />
Each block in Records is set to air. Coordinates for each axis in record is int(X) + record.x<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="9"| 0x27<br />
|rowspan="9"| Play<br />
|rowspan="9"| Client<br />
| X<br />
| Float<br />
| <br />
|-<br />
| Y<br />
| Float<br />
| <br />
|-<br />
| Z<br />
| Float<br />
| <br />
|-<br />
| Radius<br />
| Float<br />
| Currently unused in the client<br />
|-<br />
| Record Count<br />
| Int<br />
| Number of elements in the following array<br />
|-<br />
| Records<br />
| Array of (Byte, Byte, Byte)<br />
| Each record is 3 signed bytes long, each bytes are the XYZ (respectively) offsets of affected blocks.<br />
|-<br />
| Player Motion X<br />
| Float<br />
| X velocity of the player being pushed by the explosion<br />
|-<br />
| Player Motion Y<br />
| Float<br />
| Y velocity of the player being pushed by the explosion<br />
|-<br />
| Player Motion Z<br />
| Float<br />
| Z velocity of the player being pushed by the explosion<br />
|}<br />
<br />
==== 属性 ====<br />
<br />
Sent when a client is to play a sound or particle effect.<br />
<br />
By default, the Minecraft client adjusts the volume of sound effects based on distance. The final boolean field is used to disable this, and instead the effect is played from 2 blocks away in the correct direction. Currently this is only used for effect 1013 (mob.wither.spawn), and is ignored for any other value by the client.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="4"| 0x28<br />
|rowspan="4"| Play<br />
|rowspan="4"| Client<br />
| Effect ID<br />
| Int<br />
| The ID of the effect, see below<br />
|-<br />
| Location<br />
| Position<br />
| The location of the effect<br />
|-<br />
| Data<br />
| Int<br />
| Extra data for certain effects, see below<br />
|-<br />
| Disable Relative Volume<br />
| Boolean<br />
| See above<br />
|}<br />
<br />
Effect IDs:<br />
<br />
{| class="wikitable"<br />
! ID<br />
! Name<br />
! Data<br />
|-<br />
!colspan="3"| Sound<br />
|-<br />
| 1000<br />
| <code>random.click</code><br />
| <br />
|-<br />
| 1001<br />
| <code>random.click</code><br />
| <br />
|-<br />
| 1002<br />
| <code>random.bow</code><br />
| <br />
|-<br />
| 1003<br />
| <code>random.door_open</code> or <code>random.door_close</code> (50/50 chance)<br />
| <br />
|-<br />
| 1004<br />
| <code>random.fizz</code><br />
| <br />
|-<br />
| 1005<br />
| Play a music disc.<br />
| {{Minecraft Wiki|Music Discs|Record ID}}<br />
|-<br />
| 1006<br />
| ''not assigned''<br />
| <br />
|-<br />
| 1007<br />
| <code>mob.ghast.charge</code><br />
| <br />
|-<br />
| 1008<br />
| <code>mob.ghast.fireball</code><br />
| <br />
|-<br />
| 1009<br />
| <code>mob.ghast.fireball</code>, but with a lower volume<br />
| <br />
|-<br />
| 1010<br />
| <code>mob.zombie.wood</code><br />
| <br />
|-<br />
| 1011<br />
| <code>mob.zombie.metal</code><br />
| <br />
|-<br />
| 1012<br />
| <code>mob.zombie.woodbreak</code><br />
| <br />
|-<br />
| 1013<br />
| <code>mob.wither.spawn</code><br />
| <br />
|-<br />
| 1014<br />
| <code>mob.wither.shoot</code><br />
| <br />
|-<br />
| 1015<br />
| <code>mob.bat.takeoff</code><br />
| <br />
|-<br />
| 1016<br />
| <code>mob.zombie.infect</code><br />
| <br />
|-<br />
| 1017<br />
| <code>mob.zombie.unfect</code><br />
| <br />
|-<br />
| 1018<br />
| <code>mob.enderdragon.end</code><br />
| <br />
|-<br />
| 1020<br />
| <code>random.anvil_break</code><br />
| <br />
|-<br />
| 1021<br />
| <code>random.anvil_use</code><br />
| <br />
|-<br />
| 1022<br />
| <code>random.anvil_land</code><br />
| <br />
|-<br />
!colspan="3"| Particle<br />
|-<br />
| 2000<br />
| Spawns 10 smoke particles, e.g. from a fire<br />
| Direction, see below<br />
|-<br />
| 2001<br />
| Block break<br />
| {{Minecraft Wiki|Data values|Block ID}}<br />
|-<br />
| 2002<br />
| Splash potion. Particle effect + glass break sound.<br />
| [http://www.lb-stuff.com/Minecraft/PotionDataValues1.9pre3.txt Potion ID]<br />
|-<br />
| 2003<br />
| Eye of Ender entity break animation — particles and sound<br />
| <br />
|-<br />
| 2004<br />
| Mob spawn particle effect: smoke + flames<br />
| <br />
|-<br />
| 2005<br />
| Spawn “happy villager” effect (green crosses), used for bonemealing vegetation<br />
| <br />
|}<br />
<br />
Smoke directions:<br />
<br />
{| class="wikitable"<br />
! ID<br />
! Direction<br />
|-<br />
| 0<br />
| South-East<br />
|-<br />
| 1<br />
| South<br />
|-<br />
| 2<br />
| South-West<br />
|-<br />
| 3<br />
| East<br />
|-<br />
| 4<br />
| (Up or middle ?)<br />
|-<br />
| 5<br />
| West<br />
|-<br />
| 6<br />
| North-East<br />
|-<br />
| 7<br />
| North<br />
|-<br />
| 8<br />
| North-West<br />
|}<br />
<br />
==== 声音特效 ====<br />
<br />
Used to play a sound effect on the client.<br />
<br />
Custom sounds may be added by resource packs.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="6"| 0x29<br />
|rowspan="6"| Play<br />
|rowspan="6"| Client<br />
| Sound name<br />
| String<br />
| All known sound effect names can be seen [https://github.com/SirCmpwn/Craft.Net/blob/master/source/Craft.Net.Common/SoundEffect.cs here]<br />
|-<br />
| Effect position X<br />
| Int<br />
| Effect X multiplied by 8<br />
|-<br />
| Effect position Y<br />
| Int<br />
| Effect Y multiplied by 8<br />
|-<br />
| Effect position Z<br />
| Int<br />
| Effect Z multiplied by 8<br />
|-<br />
| Volume<br />
| Float<br />
| 1 is 100%, can be more<br />
|-<br />
| Pitch<br />
| Unsigned Byte<br />
| 63 is 100%, can be more<br />
|}<br />
<br />
==== 粒子效果 ====<br />
<br />
Displays the named particle<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="11"| 0x2A<br />
|rowspan="11"| Play<br />
|rowspan="11"| Client<br />
| Particle ID<br />
| Int<br />
| See below<br />
|-<br />
| Long Distance<br />
| Boolean<br />
| If true, particle distance increases from 256 to 65536<br />
|-<br />
| X<br />
| Float<br />
| X position of the particle<br />
|-<br />
| Y<br />
| Float<br />
| Y position of the particle<br />
|-<br />
| Z<br />
| Float<br />
| Z position of the particle<br />
|-<br />
| Offset X<br />
| Float<br />
| This is added to the X position after being multiplied by random.nextGaussian()<br />
|-<br />
| Offset Y<br />
| Float<br />
| This is added to the Y position after being multiplied by random.nextGaussian()<br />
|-<br />
| Offset Z<br />
| Float<br />
| This is added to the Z position after being multiplied by random.nextGaussian()<br />
|-<br />
| Particle Data<br />
| Float<br />
| The data of each particle<br />
|-<br />
| Particle Count<br />
| Int<br />
| The number of particles to create<br />
|-<br />
| Data<br />
| Array of VarInt<br />
| Length depends on particle. "iconcrack" has length of 2, "blockcrack", and "blockdust" have lengths of 1, the rest have 0.<br />
|}<br />
<br />
Particle IDs:<br />
<br />
{| class="wikitable"<br />
|-<br />
! Particle Name<br />
! Particle ID<br />
|-<br />
| explode<br />
| 0<br />
|-<br />
| largeexplosion<br />
| 1<br />
|-<br />
| hugeexplosion<br />
| 2<br />
|-<br />
| fireworksSpark<br />
| 3<br />
|-<br />
| bubble<br />
| 4<br />
|-<br />
| splash<br />
| 5<br />
|-<br />
| wake<br />
| 6<br />
|-<br />
| suspended<br />
| 7<br />
|-<br />
| depthsuspend<br />
| 8<br />
|-<br />
| crit<br />
| 9<br />
|-<br />
| magicCrit<br />
| 10<br />
|-<br />
| smoke<br />
| 11<br />
|-<br />
| largesmoke<br />
| 12<br />
|-<br />
| spell<br />
| 13<br />
|-<br />
| instantSpell<br />
| 14<br />
|-<br />
| mobSpell<br />
| 15<br />
|-<br />
| mobSpellAmbient<br />
| 16<br />
|-<br />
| witchMagic<br />
| 17<br />
|-<br />
| dripWater<br />
| 18<br />
|-<br />
| dripLava<br />
| 19<br />
|-<br />
| angryVillager<br />
| 20<br />
|-<br />
| happyVillager<br />
| 21<br />
|-<br />
| townaura<br />
| 22<br />
|-<br />
| note<br />
| 23<br />
|-<br />
| portal<br />
| 24<br />
|-<br />
| enchantmenttable<br />
| 25<br />
|-<br />
| flame<br />
| 26<br />
|-<br />
| lava<br />
| 27<br />
|-<br />
| footstep<br />
| 28<br />
|-<br />
| cloud<br />
| 29<br />
|-<br />
| reddust<br />
| 30<br />
|-<br />
| snowballpoof<br />
| 31<br />
|-<br />
| snowshovel<br />
| 32<br />
|-<br />
| slime<br />
| 33<br />
|-<br />
| heart<br />
| 34<br />
|-<br />
| barrier<br />
| 35<br />
|-<br />
| iconcrack_(id)_(data)<br />
| 36<br />
|-<br />
| blockcrack_(id+(data<<12))<br />
| 37<br />
|-<br />
| blockdust_(id)<br />
| 38<br />
|-<br />
| droplet<br />
| 39<br />
|-<br />
| take<br />
| 40<br />
|-<br />
| mobappearance<br />
| 41<br />
|}<br />
<br />
==== 改变游戏状态 ====<br />
<br />
It appears when a bed can't be used as a spawn point and when the rain state changes.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="2"| 0x2B<br />
|rowspan="2"| Play<br />
|rowspan="2"| Client<br />
| Reason<br />
| Unsigned Byte<br />
| See below<br />
|-<br />
| Value<br />
| Float<br />
| Depends on Reason<br />
|}<br />
<br />
''Reason codes'':<br />
<br />
{| class="wikitable"<br />
! Reason<br />
! Effect<br />
! Value<br />
|-<br />
| 0<br />
| Invalid Bed<br />
| <br />
|-<br />
| 1<br />
| End raining<br />
| <br />
|-<br />
| 2<br />
| Begin raining<br />
| <br />
|-<br />
| 3<br />
| Change game mode<br />
| 0: Survival, 1: Creative, 2: Adventure, 3: Spectator<br />
|-<br />
| 4<br />
| Enter credits<br />
| <br />
|-<br />
| 5<br />
| Demo message<br />
| 0: Show welcome to demo screen, 101: Tell movement controls, 102: Tell jump control, 103: Tell inventory control<br />
|- <br />
| 6<br />
| Arrow hitting player<br />
| Appears to be played when an arrow strikes another player in Multiplayer<br />
|-<br />
| 7<br />
| Fade value<br />
| The current darkness value. 1 = Dark, 0 = Bright, Setting the value higher causes the game to change color and freeze<br />
|-<br />
| 8<br />
| Fade time<br />
| Time in ticks for the sky to fade<br />
|-<br />
| 10<br />
| Play mob appearance (effect and sound)<br />
| Unknown<br />
|}<br />
<br />
==== 生存全局实体 ====<br />
<br />
With this packet, the server notifies the client of thunderbolts striking within a 512 block radius around the player. The coordinates specify where exactly the thunderbolt strikes.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="5"| 0x2C<br />
|rowspan="5"| Play<br />
|rowspan="5"| Client<br />
| Entity ID<br />
| VarInt<br />
| The EID of the thunderbolt<br />
|-<br />
| Type<br />
| Byte<br />
| The global entity type, currently always 1 for thunderbolt<br />
|-<br />
| X<br />
| Int<br />
| Thunderbolt X, a [[Data Types#Fixed-point numbers|fixed-point number]]<br />
|-<br />
| Y<br />
| Int<br />
| Thunderbolt Y, a [[Data Types#Fixed-point numbers|fixed-point number]]<br />
|-<br />
| Z<br />
| Int<br />
| Thunderbolt Z, a [[Data Types#Fixed-point numbers|fixed-point number]]<br />
|}<br />
<br />
==== 打开窗户 ====<br />
<br />
This is sent to the client when it should open an inventory, such as a chest, workbench, or furnace. This message is not sent anywhere for clients opening their own inventory.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="5"| 0x2D<br />
|rowspan="5"| Play<br />
|rowspan="5"| Client<br />
| Window ID<br />
| Unsigned Byte<br />
| A unique id number for the window to be displayed. Notchian server implementation is a counter, starting at 1.<br />
|-<br />
| Window Type<br />
| String<br />
| The window type to use for display. See [[Inventory]] for a list.<br />
|-<br />
| Window Title<br />
| [[Chat]]<br />
| The title of the window<br />
|-<br />
| Number Of Slots<br />
| Unsigned Byte<br />
| Number of slots in the window (excluding the number of slots in the player inventory)<br />
|-<br />
| Entity ID<br />
| Optional Int<br />
| EntityHorse's EID. Only sent when Window Type is “EntityHorse”<br />
|}<br />
<br />
See [[Inventory]] for further information.<br />
<br />
==== 关闭窗户 ====<br />
<br />
This packet is sent from the server to the client when a window is forcibly closed, such as when a chest is destroyed while it's open.<br />
<br />
Note, notchian clients send a close window packet with Window ID 0 to close their inventory even though there is never an [[#Open Window|Open Window]] packet for inventory. <br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
| 0x2E<br />
|rowspan="1"| Play<br />
|rowspan="1"| Client<br />
| Window ID<br />
| Unsigned Byte<br />
| This is the ID of the window that was closed. 0 for inventory.<br />
|}<br />
<br />
==== 设置位置 ====<br />
<br />
Sent by the server when an item in a slot (in a window) is added/removed.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="3"| 0x2F<br />
|rowspan="3"| Play<br />
|rowspan="3"| Client<br />
| Window ID<br />
| Byte<br />
| The window which is being updated. 0 for player inventory. Note that all known window types include the player inventory. This packet will only be sent for the currently opened window while the player is performing actions, even if it affects the player inventory. After the window is closed, a number of these packets are sent to update the player's inventory window (0).<br />
|-<br />
| Slot<br />
| Short<br />
| The slot that should be updated<br />
|-<br />
| Slot Data<br />
| [[Slot Data|Slot]]<br />
| <br />
|}<br />
<br />
==== 窗口物品 ====<br />
<br />
[[File:Inventory-slots.png|thumb|The inventory slots]]<br />
<br />
Sent by the server when items in multiple slots (in a window) are added/removed. This includes the main inventory, equipped armour and crafting slots.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="3"| 0x30<br />
|rowspan="3"| Play<br />
|rowspan="3"| Client<br />
| Window ID<br />
| Unsigned Byte<br />
| The ID of window which items are being sent for. 0 for player inventory.<br />
|-<br />
| Count<br />
| Short<br />
| Number of elements in the following array<br />
|-<br />
| Slot Data<br />
| Array of [[Slot Data|Slot]]<br />
| <br />
|}<br />
<br />
See [[Inventory#Windows|inventory windows]] for further information about how slots are indexed.<br />
<br />
==== Window Property ====<br />
<br />
This packet is used to inform the client that part of a GUI window should be updated.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="3"| 0x31<br />
|rowspan="3"| Play<br />
|rowspan="3"| Client<br />
| Window ID<br />
| Unsigned Byte<br />
| <br />
|-<br />
| Property<br />
| Short<br />
| The property to be updated, see below<br />
|-<br />
| Value<br />
| Short<br />
| The new value for the property, see below<br />
|}<br />
<br />
The meaning of the Property field depends on the type of the window. The following table shows the known combinations of window type and property, and how the value is to be interpreted.<br />
<br />
{| class="wikitable"<br />
|-<br />
! Window type<br />
! Property<br />
! Value<br />
|-<br />
|rowspan="2"| Furnace<br />
| 0: Progress arrow<br />
| 0–200 (presumably in in-game ticks)<br />
|-<br />
| 1: Fire icon (fuel)<br />
| 0–200 (presumably in in-game ticks)<br />
|-<br />
|rowspan="7"| Enchantment Table<br />
| 0: Level requirement for top enchantment slot<br />
|rowspan="3"| The enchantment's xp level requirement<br />
|-<br />
| 1: Level requirement for middle enchantment slot<br />
|-<br />
| 2: Level requirement for bottom enchantment slot<br />
|-<br />
| 3: The seed for generating the enchantments view for the client<br />
| Unknown<br />
|-<br />
| 4: tooltip shown on mouse hover over top enchantment slot<br />
|rowspan="3"| Unknown (set to -1 to hide it)<br />
|-<br />
| 5: tooltip shown on mouse hover over middle enchantment slot<br />
|-<br />
| 6: tooltip shown on mouse hover over bottom enchantment slot<br />
|-<br />
|rowspan="3"| Beacon<br />
| 0: Power level<br />
| Unknown<br />
|-<br />
| 1: First potion effect<br />
| Unknown<br />
|-<br />
| 2: Second potion effect<br />
| Unknown<br />
|-<br />
| Anvil<br />
| 0: Repair cost<br />
| The repair's cost in xp levels<br />
|-<br />
| Brewing Stand<br />
| 0: Brew time<br />
| 0–400, with 400 making the arrow empty, and 0 making the arrow full<br />
|}<br />
<br />
==== 确认事物 ====<br />
<br />
A packet from the server indicating whether a request from the client was accepted, or whether there was a conflict (due to lag).<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="3"| 0x32<br />
|rowspan="3"| Play<br />
|rowspan="3"| Client<br />
| Window ID<br />
| Byte<br />
| The ID of the window that the action occurred in<br />
|-<br />
| Action Number<br />
| Short<br />
| Every action that is to be accepted has a unique number. This field corresponds to that number.<br />
|-<br />
| Accepted<br />
| Boolean<br />
| Whether the action was accepted<br />
|}<br />
<br />
==== 更新标志 ====<br />
<br />
This message is sent from the server to the client whenever a sign is discovered or created. This message is NOT sent when a sign is destroyed or unloaded.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="5"| 0x33<br />
|rowspan="5"| Play<br />
|rowspan="5"| Client<br />
| Location<br />
| Position<br />
| <br />
|-<br />
| Line 1<br />
| [[Chat]]<br />
| First line of text in the sign<br />
|-<br />
| Line 2<br />
| [[Chat]]<br />
| Second line of text in the sign<br />
|-<br />
| Line 3<br />
| [[Chat]]<br />
| Third line of text in the sign<br />
|-<br />
| Line 4<br />
| [[Chat]]<br />
| Fourth line of text in the sign<br />
|}<br />
<br />
==== 地图 ====<br />
<br />
Updates a rectangular area on a map.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
!colspan="2"| Field Name<br />
!colspan="2"| Field Type<br />
! Notes<br />
|-<br />
|rowspan="12"| 0x34<br />
|rowspan="12"| Play<br />
|rowspan="12"| Client<br />
|colspan="2"| Item Damage<br />
|colspan="2"| VarInt<br />
| The damage value (map ID) of the map being modified<br />
|-<br />
|colspan="2"| Scale<br />
|colspan="2"| Byte<br />
| <br />
|- <br />
|colspan="2"| Icon Count<br />
|colspan="2"| VarInt<br />
| Number of elements in the following array<br />
|-<br />
|rowspan="3"| Icon<br />
| Direction And Type<br />
|rowspan="3"| Array<br />
| Byte<br />
| 0xF0 = Direction, 0x0F = Type<br />
|-<br />
| X<br />
| Byte<br />
| <br />
|-<br />
| Z<br />
| Byte<br />
| <br />
|- <br />
|colspan="2"| Columns<br />
|colspan="2"| Byte<br />
| Number of columns updated<br />
|-<br />
|colspan="2"| Rows<br />
|colspan="2"| Optional Byte<br />
| Only if Columns is more than 0; number of rows updated<br />
|-<br />
|colspan="2"| X<br />
|colspan="2"| Optional Byte<br />
| Only if Columns is more than 0; x offset of the westernmost column<br />
|-<br />
|colspan="2"| Z<br />
|colspan="2"| Optional Byte<br />
| Only if Columns is more than 0; z offset of the northernmost row<br />
|-<br />
|colspan="2"| Length<br />
|colspan="2"| Optional VarInt<br />
| Only if Columns is more than 0; length of the following array<br />
|-<br />
|colspan="2"| Data<br />
|colspan="2"| Optional Array of Unsigned Byte<br />
| Only if Columns is more than 0; see {{Minecraft Wiki|Map item format}}<br />
|}<br />
<br />
==== 更新方块实体 ====<br />
<br />
Essentially a block update on a block entity.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="3"| 0x35<br />
|rowspan="3"| Play<br />
|rowspan="3"| Client<br />
| Location<br />
| Position<br />
| <br />
|-<br />
| Action<br />
| Unsigned Byte<br />
| The type of update to perform, see below<br />
|-<br />
| NBT Data<br />
| Optional [[NBT|NBT Tag]]<br />
| If not present then it's a TAG_END (0)<br />
|}<br />
<br />
''Action'' field:<br />
<br />
* '''1''': Set SpawnPotentials of a mob spawner<br />
* '''2''': Set command block text (command and last execution status)<br />
* '''3''': Set the level, primary, and secondary powers of a beacon<br />
* '''4''': Set rotation and skin of mob head<br />
* '''5''': Set type of flower in flower pot<br />
* '''6''': Set base color and patterns on a banner<br />
<br />
==== 打开标志牌编辑器 ====<br />
<br />
Sent on placement of sign.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="1"| 0x36<br />
|rowspan="1"| Play<br />
|rowspan="1"| Client<br />
| Location<br />
| Position<br />
| <br />
|}<br />
<br />
==== 统计数据 ====<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To <br />
!colspan="2"| Field Name<br />
!colspan="2"| Field Type<br />
! Notes<br />
|-<br />
|rowspan="3"| 0x37<br />
|rowspan="3"| Play<br />
|rowspan="3"| Client<br />
|colspan="2"| Count<br />
|colspan="2"| VarInt<br />
| Number of elements in the following array<br />
|-<br />
|rowspan="2"| Statistic<br />
| Name<br />
|rowspan="2"| Array<br />
| String<br />
| [https://gist.github.com/thinkofdeath/a1842c21a0cf2e1fb5e0 https://gist.github.com/thinkofdeath/a1842c21a0cf2e1fb5e0]<br />
|-<br />
| Value<br />
| VarInt<br />
| The amount to set it to<br />
|}<br />
<br />
==== 玩家列表项 ====<br />
<br />
Sent by the notchian server to update the user list (<tab> in the client).<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
!colspan="4"| Field Name<br />
!colspan="3"| Field Type<br />
! Notes<br />
|-<br />
|rowspan="19"| 0x38<br />
|rowspan="19"| Play<br />
|rowspan="19"| Client<br />
|colspan="4"| Action<br />
|colspan="3"| VarInt<br />
| Determines the rest of the Player format after the UUID<br />
|-<br />
|colspan="4"| Number Of Players<br />
|colspan="3"| VarInt<br />
| Number of elements in the following array<br />
|-<br />
|rowspan="17"| Player<br />
|colspan="3"| UUID<br />
|rowspan="17"| Array<br />
|colspan="2"| UUID<br />
| <br />
|-<br />
! Action<br />
!colspan="2"| Field Name<br />
!colspan="2"| <br />
! <br />
|-<br />
|rowspan="10"| 0: add player<br />
|colspan="2"| Name<br />
|colspan="2"| String<br />
| <br />
|-<br />
|colspan="2"| Number Of Properties<br />
|colspan="2"| VarInt<br />
| Number of elements in the following array<br />
|-<br />
|rowspan="4"| Property<br />
| Name<br />
|rowspan="4"| Array<br />
| String<br />
| <br />
|-<br />
| Value<br />
| String<br />
| <br />
|- <br />
| Is Signed<br />
| Boolean<br />
| <br />
|-<br />
| Signature<br />
| Optional String<br />
| Only if Is Signed is true<br />
|-<br />
|colspan="2"| Gamemode<br />
|colspan="2"| VarInt<br />
| <br />
|-<br />
|colspan="2"| Ping<br />
|colspan="2"| VarInt<br />
| <br />
|-<br />
|colspan="2"| Has Display Name<br />
|colspan="2"| Boolean<br />
| <br />
|-<br />
|colspan="2"| Display Name<br />
|colspan="2"| Optional [[Chat]]<br />
| Only if Has Display Name is true<br />
|-<br />
| 1: update gamemode<br />
|colspan="2"| Gamemode<br />
|colspan="2"| VarInt<br />
| <br />
|- <br />
| 2: update latency<br />
|colspan="2"| Ping<br />
|colspan="2"| VarInt<br />
| <br />
|-<br />
|rowspan="2"| 3: update display name<br />
|colspan="2"| Has Display Name<br />
|colspan="2"| Boolean<br />
| <br />
|-<br />
|colspan="2"| Display Name<br />
|colspan="2"| Optional [[Chat]]<br />
| Only send if Has Display Name is true<br />
|-<br />
| 4: remove player<br />
|colspan="2"| ''no fields''<br />
|colspan="2"| ''no fields''<br />
| <br />
|}<br />
<br />
==== 玩家能力 ====<br />
<br />
The latter 2 floats are used to indicate the walking and flying speeds respectively, while the first byte is used to determine the value of 4 booleans.<br />
<br />
The flags are whether damage is disabled (god mode, 8, bit 3), whether the player can fly (4, bit 2), whether the player is flying (2, bit 1), and whether the player is in creative mode (1, bit 0).<br />
<br />
To get the values of these booleans, simply AND (&) the byte with 1,2,4 and 8 respectively, to get the 0 or 1 bitwise value. To set them OR (|) them with their repspective masks.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="3"| 0x39<br />
|rowspan="3"| Play<br />
|rowspan="3"| Client<br />
| Flags<br />
| Byte<br />
| Bit mask, see above<br />
|-<br />
| Flying Speed<br />
| Float<br />
| <br />
|-<br />
| Walking Speed<br />
| Float<br />
| <br />
|}<br />
<br />
==== Tab补全 ====<br />
<br />
The server responds with a list of auto-completions of the last word sent to it. In the case of regular chat, this is a player username. Command names and parameters are also supported.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="2"| 0x3A<br />
|rowspan="2"| Play<br />
|rowspan="2"| Client<br />
| Count<br />
| VarInt<br />
| Number of elements in the following array<br />
|-<br />
| Matches<br />
| Array of String<br />
| One eligible command, note that each command is sent separately instead of in a single string, hence the need for Count<br />
|}<br />
<br />
==== 计分板目标 ====<br />
<br />
This is sent to the client when it should create a new {{Minecraft Wiki|scoreboard}} objective or remove one.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="4"| 0x3B<br />
|rowspan="4"| Play<br />
|rowspan="4"| Client<br />
| Objective Name<br />
| String<br />
| An unique name for the objective<br />
|-<br />
| Mode<br />
| Byte<br />
| 0 to create the scoreboard. 1 to remove the scoreboard. 2 to update the display text. <br />
|-<br />
| Objective Value<br />
| Optional String<br />
| Only if mode is 0 or 2. The text to be displayed for the score<br />
|-<br />
| Type<br />
| Optional String<br />
| Only if mode is 0 or 2. “integer” or “hearts”<br />
|}<br />
<br />
==== 更新分数 ====<br />
<br />
This is sent to the client when it should update a scoreboard item. <br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="4"| 0x3C<br />
|rowspan="4"| Play<br />
|rowspan="4"| Client<br />
| Score Name<br />
| String<br />
| The name of the score to be updated or removed<br />
|-<br />
| Action<br />
| Byte<br />
| 0 to create/update an item. 1 to remove an item.<br />
|-<br />
| Objective Name<br />
| String<br />
| The name of the objective the score belongs to<br />
|-<br />
| Value<br />
| Optional VarInt<br />
| The score to be displayed next to the entry. Only sent when Action does not equal 1.<br />
|}<br />
<br />
==== 显示计分板 ====<br />
<br />
This is sent to the client when it should display a scoreboard.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="2"| 0x3D<br />
|rowspan="2"| Play<br />
|rowspan="2"| Client<br />
| Position<br />
| Byte<br />
| The position of the scoreboard. 0: list, 1: sidebar, 2: below name.<br />
|-<br />
| Score Name<br />
| String<br />
| The unique name for the scoreboard to be displayed.<br />
|}<br />
<br />
==== 团队 ====<br />
<br />
Creates and updates teams.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="10"| 0x3E<br />
|rowspan="10"| Play<br />
|rowspan="10"| Client<br />
| Team Name<br />
| String<br />
| A unique name for the team. (Shared with scoreboard).<br />
|-<br />
| Mode<br />
| Byte<br />
| If 0 then the team is created.<br />
<br />
If 1 then the team is removed. <br />
<br />
If 2 the team team information is updated. <br />
<br />
If 3 then new players are added to the team. <br />
<br />
If 4 then players are removed from the team.<br />
|-<br />
| Team Display Name<br />
| Optional String<br />
| Only if Mode = 0 or 2.<br />
|-<br />
| Team Prefix<br />
| Optional String<br />
| Only if Mode = 0 or 2. Displayed before the players' name that are part of this team<br />
|-<br />
| Team Suffix<br />
| Optional String<br />
| Only if Mode = 0 or 2. Displayed after the players' name that are part of this team<br />
|-<br />
| Friendly Fire<br />
| Optional Byte<br />
| Only if Mode = 0 or 2. 0 for off, 1 for on, 3 for seeing friendly invisibles<br />
|-<br />
| Name Tag Visibility<br />
| Optional String<br />
| Only if Mode = 0 or 2. always, hideForOtherTeams, hideForOwnTeam, never<br />
|-<br />
| Color<br />
| Optional Byte<br />
| Only if Mode = 0 or 2. Same as [[Chat]] colors<br />
|-<br />
| Player Count<br />
| Optional VarInt<br />
| Only if Mode = 0 or 3 or 4. Number of players in the array<br />
|-<br />
| Players<br />
| Optional Array of String<br />
| Only if Mode = 0 or 3 or 4. Players to be added/remove from the team. Max 40 characters so may be uuid's later<br />
|}<br />
<br />
==== 插件信息 ====<br />
<br />
Mods and plugins can use this to send their data. Minecraft itself uses a number of [[plugin channel]]s. These internal channels are prefixed with <code>MC|</code>.<br />
<br />
More documentation on this: [http://dinnerbone.com/blog/2012/01/13/minecraft-plugin-channels-messaging/ http://dinnerbone.com/blog/2012/01/13/minecraft-plugin-channels-messaging/]<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="2"| 0x3F<br />
|rowspan="2"| Play<br />
|rowspan="2"| Client<br />
| Channel<br />
| String<br />
| Name of the [[plugin channel]] used to send the data<br />
|-<br />
| Data<br />
| Byte Array<br />
| Any data, depending on the channel. <code><nowiki>MC|</nowiki></code> channels are documented [[plugin channel|here]].<br />
|}<br />
<br />
==== 断开连接 ====<br />
<br />
Sent by the server before it disconnects a client. The server assumes that the sender has already closed the connection by the time the packet arrives.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
| 0x40<br />
|rowspan="1"| Play<br />
|rowspan="1"| Client<br />
| Reason<br />
| [[Chat]]<br />
| Displayed to the client when the connection terminates.<br />
|}<br />
<br />
==== 服务器难度 ====<br />
<br />
Changes the difficulty setting in the client's option menu<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="1"| 0x41<br />
|rowspan="1"| Play<br />
|rowspan="1"| Client<br />
| Difficulty<br />
| Unsigned Byte<br />
| 0: peaceful, 1: easy, 2: normal, 3: hard<br />
|}<br />
<br />
==== 战斗事件 ====<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="6"| 0x42<br />
|rowspan="6"| Play<br />
|rowspan="6"| Client<br />
| Event<br />
| VarInt<br />
| 0: enter combat, 1: end combat, 2: entity dead<br />
|-<br />
| Duration<br />
| Optional VarInt<br />
| Only for end combat<br />
|-<br />
| Player ID<br />
| Optional VarInt<br />
| Only for entity dead<br />
|-<br />
| Entity ID<br />
| Optional Int<br />
| Only for end combat and entity dead<br />
|-<br />
| Message<br />
| String<br />
| Only for entity dead<br />
|}<br />
<br />
==== 摄像机 ====<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="1"| 0x43<br />
|rowspan="1"| Play<br />
|rowspan="1"| Client<br />
| Camera ID<br />
| VarInt<br />
| <br />
|}<br />
<br />
==== 世界边界 ==== <br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
!colspan="2"| Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="18"| 0x44<br />
|rowspan="18"| Play<br />
|rowspan="18"| Client<br />
|colspan="2"| Action<br />
| VarInt<br />
| Determines the format of the rest of the packet<br />
|-<br />
! Action<br />
! Field Name<br />
! <br />
! <br />
|-<br />
| 0: set size<br />
| Radius<br />
| Double<br />
| meters<br />
|-<br />
|rowspan="3"| 1: lerp size<br />
| Old Radius<br />
| Double<br />
| meters<br />
|-<br />
| New Radius<br />
| Double<br />
| meters<br />
|-<br />
| Speed<br />
| VarLong<br />
| number of real-time ticks/seconds (?) until New Radius is reached. From experiments, it appears that Notchian server does not sync world border speed to game ticks, so it gets out of sync with server lag<br />
|-<br />
|rowspan="2"| 2: set center<br />
| X<br />
| Double<br />
| <br />
|-<br />
| Z<br />
| Double<br />
| <br />
|-<br />
|rowspan="8"| 3: initialize<br />
| X<br />
| Double<br />
| <br />
|-<br />
| Z<br />
| Double<br />
| <br />
|-<br />
| Old Radius<br />
| Double<br />
| <br />
|-<br />
| New Radius<br />
| Double<br />
| <br />
|-<br />
| Speed<br />
| VarLong<br />
| <br />
|-<br />
| Portal Teleport Boundary<br />
| VarInt<br />
| Resulting coordinates from a portal teleport are limited to +-value. Usually 29999984.<br />
|-<br />
| Warning Time<br />
| VarInt<br />
| <br />
|-<br />
| Warning Blocks<br />
| VarInt<br />
| <br />
|-<br />
|rowspan="1"| 4: set warning time<br />
| Warning Time<br />
| VarInt<br />
| unit?<br />
|-<br />
|rowspan="1"| 5: set warning blocks<br />
| Warning Blocks<br />
| VarInt<br />
| <br />
|}<br />
<br />
==== 显示标题 ==== <br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
!colspan="2"| Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="9"| 0x45<br />
|rowspan="9"| Play<br />
|rowspan="9"| Client<br />
|colspan="2"| Action<br />
| VarInt<br />
| <br />
|-<br />
! Action<br />
! Field Name<br />
! <br />
! <br />
|-<br />
| 0: set title<br />
| Title Text<br />
| [[Chat]]<br />
| <br />
|-<br />
| 1: set subtitle<br />
| Subtitle Text<br />
| [[Chat]]<br />
| <br />
|-<br />
|rowspan="3"| 2: set times and display<br />
| Fade In<br />
| Int<br />
| ticks<br />
|-<br />
| Stay<br />
| Int<br />
| ticks<br />
|-<br />
| Fade Out<br />
| Int<br />
| ticks<br />
|-<br />
| 3: hide<br />
| ''no fields''<br />
| ''no fields''<br />
| <br />
|-<br />
| 4: reset<br />
| ''no fields''<br />
| ''no fields''<br />
| <br />
|}<br />
<br />
“Hide” makes the title disappear, but if you run times again the same title will appear. “Reset” erases the text.<br />
<br />
==== 设置压缩 ====<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="1"| 0x46<br />
|rowspan="1"| Play<br />
|rowspan="1"| Client<br />
| Threshold<br />
| VarInt<br />
| Packets of this size or higher may be compressed<br />
|}<br />
<br />
==== 玩家列表页眉与页脚 ====<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="2"| 0x47<br />
|rowspan="2"| Play<br />
|rowspan="2"| Client<br />
| Header<br />
| [[Chat]]<br />
| <br />
|-<br />
| Footer<br />
| [[Chat]]<br />
| <br />
|}<br />
<br />
==== 发送资源包 ==== <br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="2"| 0x48<br />
|rowspan="2"| Play<br />
|rowspan="2"| Client<br />
| URL<br />
| String<br />
| The URL to the resource pack.<br />
|-<br />
| Hash<br />
| String<br />
| A 40 character hexadecimal and lowercase [[wikipedia:SHA-1|SHA-1]] hash of the resource pack file. (must be lower case in order to work)<br />If it's not a 40 character hexadecimal string, the client will not use it for hash verification and likely waste bandwidth — but it will still treat it as a unique id<br />
|}<br />
<br />
==== 更新实体 NBT ==== <br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="2"| 0x49<br />
|rowspan="2"| Play<br />
|rowspan="2"| Client<br />
| Entity ID<br />
| VarInt<br />
| <br />
|-<br />
| Tag<br />
| [[NBT|NBT Tag]]<br />
| <br />
|}<br />
<br />
=== 发送到服务器 ===<br />
<br />
==== 保持连接 ====<br />
<br />
服务器会经常发送一个保持连接包，内含一个随机的ID。客户端必须回应同样的包。<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="1"| 0x00<br />
|rowspan="1"| Play<br />
|rowspan="1"| Server<br />
| Keep Alive ID<br />
| VarInt<br />
| <br />
|}<br />
<br />
==== 聊天信息 ====<br />
<br />
默认服务端会检查信息是否以 '/' 开头。如果不是是，发送者的用户名将被放在消息前并且发送到所有其他客户端（包括原始的发送者）。如果是，服务端认为它是一个命令并尝试处理它。一个长度大于 100 的信息会导致服务端踢出该客户端。这个行为一开始是在不修改服务端的前提下不允许客户端不分段发送长度超过 119（以前的限制）的信息。因为这个原因，原始的服务端保留了在 119 处将消息切片的代码，但是这不是一个协议限制并且可以被跳过。<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="1"| 0x01<br />
|rowspan="1"| Play<br />
|rowspan="1"| Server<br />
| Message<br />
| String<br />
| The client sends the raw input, not [[Chat]]<br />
|}<br />
<br />
==== 使用实体 ====<br />
<br />
这个包在玩家攻击或者右键点击其他实体（一个玩家、矿车等）时从客户端发往服务器。<br />
<br />
一个官方服务端只在被攻击或使用的实体是可视的、在以玩家为中心 4单位 的范围内且与玩家之间没有阻碍时才接受这个包。<br />
<br />
注意：创造模式的中键点击会被客户端解析且被发送为 [[#Creative Inventory Action|创造背包动作]] 包。<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="5"| 0x02<br />
|rowspan="5"| Play<br />
|rowspan="5"| Server<br />
| Target<br />
| VarInt<br />
| <br />
|-<br />
| Type<br />
| VarInt<br />
| 0: interact, 1: attack, 2: interact at<br />
|-<br />
| Target X<br />
| Optional Float<br />
| Only if Type is interact at<br />
|-<br />
| Target Y<br />
| Optional Float<br />
| Only if Type is interact at<br />
|-<br />
| Target Z<br />
| Optional Float<br />
| Only if Type is interact at<br />
|}<br />
<br />
==== 玩家状态 ====<br />
<br />
这个包用于表明玩家正在陆地上（行走/游泳）还是在空中（跳跃/掉落）。<br />
<br />
当从足够高的高度掉落，这个状态从 false 设置为 true 时会受到掉落伤害。受到伤害的数值基于最后状态从 true 设置为 false。 注意有一些运动相关的包包含了这个包。<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="1"| 0x03<br />
|rowspan="1"| Play<br />
|rowspan="1"| Server<br />
| On Ground<br />
| Boolean<br />
| 当对象站在地上时为 true , 反之则为 false<br />
|}<br />
<br />
==== 玩家坐标 ====<br />
<br />
更新玩家在服务器上的 XYZ 坐标。<br />
<br />
如果在服务器上最后记录的位置和这个包设置的新位置之间的距离大于 100 单位，将会导致客户端因为 “You moved too quickly :( (Hacking?)” 而被踢出服务器。<br />
<br />
如果之间的距离大于 10 单位，服务器会在日志中写下警告信息 “<name> moved too quickly!” 和两个三元坐标（可能是运动增量？），但不会踢出客户端。<br />
<br />
如果 X 或 Z 的定点数被设置大于 3.2×10<sup>7</sup> 客户端会因为 “Illegal position” 而被踢出服务器。<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="4"| 0x04<br />
|rowspan="4"| Play<br />
|rowspan="4"| Server<br />
| X<br />
| Double<br />
| 绝对位置<br />
|-<br />
| Feet Y<br />
| Double<br />
| 绝对位置，史蒂夫头部一般在 Y - 1.62<br />
|-<br />
| Z<br />
| Double<br />
| 绝对位置<br />
|-<br />
| On Ground<br />
| Boolean<br />
| 当对象站在地上时为 true , 反之则为 false<br />
|}<br />
<br />
==== 玩家观察 ====<br />
[[File:Minecraft-trig-yaw.png|thumb|The unit circle for yaw]]<br />
[[File:Yaw.png|thumb|The unit circle of yaw, redrawn]]<br />
<br />
更新玩家目前所看的方向。<br />
<br />
偏航（Yaw）以度为单位，并且不遵循经典的三角规则。</div>
梦彗業
https://mineplugin.org/index.php?title=Protocol&diff=5409
Protocol
2017-09-02T14:08:59Z
<p>梦彗業：翻译</p>
<hr />
<div>{{待翻译}}<br />
{{待更新|url=http://wiki.vg/Protocol}}<br />
<br />
这里剖析了最近的 '''[http://wiki.vg/Protocol_Encryption Minecraft协议]'''.<br />
<br />
如果你有疑问, 请查阅下文或在IRC请求帮助 ([irc://irc.freenode.net/mcdevs #mcdevs on irc.freenode.net]).<br />
<br />
'''注意:''' 你可以不受限制地使用这个页面的内容来创建服务端, 客户端, 机器人…… 诸如此类的任何东西…<br />
<br />
== 定义 ==<br />
<br />
Minecraft服务器是基于TCP通讯的。它和客户端使用所谓的 ''数据包''交流. 一个包被通过字节编码后从TCP连接中发送. 数据包的含义取决于其包标识和连接的当前状态. 每个链接从 '''[http://wiki.vg/Handshaking 握手]'''开始, 使用包切换状态 '''[http://wiki.vg/Handshaking 握手]''',( 0x00, serverbound) 和 [[#Login Success|成功登陆]] ([[#Login|登陆]], 0x02, clientbound).<br />
<br />
=== 数据类型 ===<br />
<br />
<!-- Transcluded contents of Data Types article in here - go to that page if you want to edit it --><br />
<br />
{{:Data Types}}<br />
<br />
=== 其他定义 ===<br />
<br />
{| class="wikitable"<br />
|-<br />
! 术语<br />
! 定义<br />
|-<br />
| Player——玩家<br />
| 使用时, 玩家通常使用它来链接到服务端.<br />
|-<br />
| Entity——实体<br />
| 实体相当于玩家、物品、怪物、船和矿车等. 查看 {{Minecraft Wiki|Entity|the Minecraft Wiki article}} 来寻找一个完整的表单.<br />
|-<br />
| EID——实体ID<br />
| An EID — 或者说是实体ID — 是一个用来识别特定实体的4字节序列. 在同一个服务器,没有相同的实体编号.<br />
|-<br />
| XYZ坐标<br />
| 游戏时，可以使用按钮“F3”来在屏幕上查看坐标位置 Y代表高度, X代表东西, Z代表南北.<br />
|-<br />
| 单位“Meter”<br />
| Meter是Minecraft的基本长度单位, 相当于一个方块的长度. “block”一词也许意味着 “meter”或者“cubic meter”.<br />
|}<br />
<br />
== 数据包的格式 ==<br />
<br />
=== 无压缩 ===<br />
<br />
{| class="wikitable"<br />
! 域名称<br />
! 域类型<br />
! 注释<br />
|-<br />
| 长度<br />
| VarInt<br />
| 包数据的长度 + 包序号的长度<br />
|-<br />
| 包序号<br />
| VarInt<br />
| <br />
|-<br />
| 数据<br />
| Byte Array<br />
| 依赖于连接状态和包序号，详见下面的部分。<br />
|}<br />
<br />
=== 压缩 ===<br />
<br />
当一个 [[#Set Compression|设置压缩]] 包被发送，[[wikipedia:Zlib|zlib]] 压缩将会对之后的所有包开启。 包的格式略微改变以包含未压缩前的包的长度。<br />
''译注：注意区分包长度和数据长度，关系：“包”包含“数据”''<br />
{| class=wikitable<br />
! 是否压缩<br />
! 域名称<br />
! 域类型<br />
! 注释<br />
|-<br />
| 否<br />
| 包长度<br />
| VarInt<br />
| 数据长度的长度 + 压缩后的 (包序号 + 数据) 的长度<br />
|-<br />
| 否<br />
| 数据长度<br />
| VarInt<br />
| 未压缩前的 (包序号 + 数据) 的长度 或 0<br />
|-<br />
|rowspan="2"| 是<br />
| 包序号<br />
| Varint<br />
| zlib 压缩后的包序号（详见下面的部分）<br />
|-<br />
| 数据<br />
| Byte Array<br />
| zlib 压缩后的包数据（详见下面的部分）<br />
|}<br />
<br />
包长度域提供的是包中存在的字节的数量，包括数据长度域。<br />
<br />
如果数据长度被设置为 0，则这个包没有被压缩；否则它表示已压缩的包未压缩前的包长度。<br />
<br />
如果包被压缩，压缩前的 (包序号 + 数据) 的长度必须等于或大于 [[#Set Compression|设置压缩]] 包中设置的最小值，否则客户端/服务端将会断开连接。<br />
<br />
压缩能通过发送一个最小值设定为 -1 的 [[#Set Compression|设置压缩]] 包来关闭。<br />
<br />
== 握手协议 ==<br />
<br />
=== 客户端绑定 ===<br />
<br />
因为协议在客户端发送第一个数据包后会立刻切换到另一个阶段，所以握手阶段没有客户端绑定的数据包。<br />
<br />
=== 服务端绑定 ===<br />
<br />
==== 握手协议 ====<br />
<br />
这将使得服务器切换至目标阶段。<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="4"| 0x00<br />
|rowspan="4"| Handshaking<br />
|rowspan="4"| Server<br />
| 协议版本<br />
| VarInt<br />
| See [[protocol version numbers]] (currently 47)<br />
|-<br />
| 服务器地址<br />
| String<br />
| 域名或是IP, 例如： localhost 或是 127.0.0.1<!-- does this support IPv6? --><br />
|- <br />
| 服务器端口<br />
| Unsigned Short<br />
| 默认值为25565<br />
|-<br />
| 下一阶段<br />
| VarInt<br />
| 1 for [[#Status|status]], 2 for [[#Login|login]]<br />
|}<br />
<br />
==== 传统的服务器列表Ping ====<br />
<br />
严格来说这不是当前协议的一部分，传统客户端可能会发送这一数据包来发起（initiate） [[Server List Ping]], 现代服务器也应当能够适当地处理这一数据包。<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
| 0xFE<br />
| Handshaking<br />
| Server<br />
| Payload<br />
| Unsigned Byte<br />
| always 1 (<code>0x01</code>)<br />
|}<br />
<br />
See [[Server List Ping#1.6]] for the details of the protocol that follows this packet.<br />
<br />
== 开始游戏 ==<br />
<br />
=== 发送到客户端 ===<br />
<br />
==== 心跳包 ====<br />
<br />
The server will frequently send out a keep-alive, each containing a random ID. The client must respond with the same packet. If the client does not respond to them for over 30 seconds, the server kicks the client. Vice versa, if the server does not send any keep-alives for 20 seconds, the client will disconnect and yields a "Timed out" exception.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="1"| 0x00<br />
|rowspan="1"| Play<br />
|rowspan="1"| Client<br />
| Keep Alive ID<br />
| VarInt<br />
| <br />
|}<br />
<br />
==== 加入游戏 ====<br />
<br />
See [[Protocol Encryption]] for information on logging in.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="7"| 0x01<br />
|rowspan="7"| Play<br />
|rowspan="7"| Client<br />
| Entity ID<br />
| Int<br />
| The player's Entity ID (EID)<br />
|-<br />
| Gamemode<br />
| Unsigned Byte<br />
| 0: Survival, 1: Creative, 2: Adventure, 3: Spectator. Bit 3 (0x8) is the hardcore flag.<br />
|-<br />
| Dimension<br />
| Byte<br />
| -1: Nether, 0: Overworld, 1: End<br />
|-<br />
| Difficulty<br />
| Unsigned Byte<br />
| 0: peaceful, 1: easy, 2: normal, 3: hard<br />
|-<br />
| Max Players<br />
| Unsigned Byte<br />
| Used by the client to draw the player list<br />
|-<br />
| Level Type<br />
| String<br />
| default, flat, largeBiomes, amplified, default_1_1<br />
|-<br />
| Reduced Debug Info<br />
| Boolean<br />
| If true, a Notchian client shows reduced information on the {{Minecraft Wiki|debug screen}}.<br />
|}<br />
<br />
{{Warning|如果位置无效，服务端将崩溃}}<br />
<br />
==== 聊天内容 ==== <br />
<br />
Identifying the difference between Chat/System Message is important as it helps respect the user's chat visibility options. While Position 2 accepts json formatting it will not display, old style formatting works<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="2"| 0x02<br />
|rowspan="2"| Play<br />
|rowspan="2"| Client<br />
| JSON Data<br />
| [[Chat]]<br />
| Limited to 32767 bytes<br />
|-<br />
| Position<br />
| Byte<br />
| 0: chat (chat box), 1: system message (chat box), 2: above action bar<br />
|}<br />
<br />
{{Warning|错误的JSON将断开连接}}<br />
<br />
==== 时间更新 ====<br />
<br />
Time is based on ticks, where 20 ticks happen every second. There are 24000 ticks in a day, making Minecraft days exactly 20 minutes long.<br />
<br />
The time of day is based on the timestamp modulo 24000. 0 is sunrise, 6000 is noon, 12000 is sunset, and 18000 is midnight.<br />
<br />
The default SMP server increments the time by <code>20</code> every second.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="2"| 0x03<br />
|rowspan="2"| Play<br />
|rowspan="2"| Client<br />
| World Age<br />
| Long<br />
| In ticks; not changed by server commands<br />
|-<br />
| Time of day<br />
| Long<br />
| The world (or region) time, in ticks. If negative the sun will stop moving at the Math.abs of the time<br />
|}<br />
<br />
==== 持有的物品 ====<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="3"| 0x04<br />
|rowspan="3"| Play<br />
|rowspan="3"| Client<br />
| Entity ID<br />
| VarInt<br />
| Entity's EID<br />
|-<br />
| Slot<br />
| Short<br />
| Equipment slot. 0: held, 1–4: armor slot (1: boots, 2: leggings, 3: chestplate, 4: helmet)<br />
|-<br />
| Item<br />
| [[Slot Data|Slot]]<br />
| Item in slot format<br />
|}<br />
<br />
==== 出生姿势 ====<br />
<br />
Sent by the server after login to specify the coordinates of the spawn point (the point at which players spawn at, and which the compass points to). It can be sent at any time to update the point compasses point at.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="1"| 0x05<br />
|rowspan="1"| Play<br />
|rowspan="1"| Client<br />
| Location<br />
| Position<br />
| Spawn location<br />
|}<br />
<br />
==== 更新生命值 ====<br />
<br />
Sent by the server to update/set the health of the player it is sent to.<br />
<br />
Food {{Minecraft Wiki|Food#Hunger vs. Saturation|saturation}} acts as a food “overcharge”. Food values will not decrease while the saturation is over zero. Players logging in automatically get a saturation of 5.0. Eating food increases the saturation as well as the food bar.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="3"| 0x06<br />
|rowspan="3"| Play<br />
|rowspan="3"| Client<br />
| Health<br />
| Float<br />
| 0 or less = dead, 20 = full HP<br />
|-<br />
| Food<br />
| VarInt<br />
| 0–20<br />
|- <br />
| Food Saturation<br />
| Float<br />
| Seems to vary from 0.0 to 5.0 in integer increments<br />
|}<br />
<br />
==== 重生 ====<br />
<br />
来改变玩家的位置(主世界/地狱/末地), 发送给他们一个重生指令, 其次是prechunks或chunks的新位置, and finally a position and look packet. You do not need to unload chunks, the client will do it automatically.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="4"| 0x07<br />
|rowspan="4"| Play<br />
|rowspan="4"| Client<br />
| Dimension<br />
| Int<br />
| -1: The Nether, 0: The Overworld, 1: The End<br />
|-<br />
| Difficulty<br />
| Unsigned Byte<br />
| 0: Peaceful, 1: Easy, 2: Normal, 3: Hard<br />
|-<br />
| Gamemode<br />
| Unsigned Byte<br />
| 0: survival, 1: creative, 2: adventure. The hardcore flag is not included<br />
|-<br />
| Level Type<br />
| String<br />
| Same as [[#Join Game|Join Game]]<br />
|}<br />
<br />
{{Warning|如果位置无效，服务端将崩溃 }}<br />
<br />
{{Warning|如果玩家出现在了相同的位置, weird bugs can occur i.e. such player will be unable to attack other players in new world (修复后他们将重生)}}<br />
<br />
==== 玩家姿势以及看的方向 ==== <br />
<br />
Updates the player's position on the server.<br />
<br />
If the distance between the last known position of the player on the server and the new position set by this packet is greater than 100 meters, the client will be kicked for “You moved too quickly :( (Hacking?)”.<br />
<br />
Also if the fixed-point number of X or Z is set greater than <code>3.2E7D</code> the client will be kicked for “Illegal position”.<br />
<br />
Yaw is measured in degrees, and does not follow classical trigonometry rules. The unit circle of yaw on the XZ-plane starts at (0, 1) and turns counterclockwise, with 90 at (-1, 0), 180 at (0, -1) and 270 at (1, 0). Additionally, yaw is not clamped to between 0 and 360 degrees; any number is valid, including negative numbers and numbers greater than 360.<br />
<br />
Pitch is measured in degrees, where 0 is looking straight ahead, -90 is looking straight up, and 90 is looking straight down.<br />
<br />
The yaw in degrees of a player standing at point (x0, z0) and looking towards point (x, z) can be calculated with:<br />
<br />
l = x-x0<br />
w = z-z0<br />
c = sqrt( l*l + w*w )<br />
alpha1 = -arcsin(l/c)/PI*180<br />
alpha2 = arccos(w/c)/PI*180<br />
if alpha2 > 90 then<br />
yaw = 180 - alpha1<br />
else<br />
yaw = alpha1<br />
<br />
You can get a unit vector from a given yaw/pitch via:<br />
<br />
x = -cos(pitch) * sin(yaw)<br />
y = -sin(pitch)<br />
z = cos(pitch) * cos(yaw)<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="6"| 0x08<br />
|rowspan="6"| Play<br />
|rowspan="6"| Client<br />
| X<br />
| Double<br />
| Absolute or relative position, depending on Flags<br />
|-<br />
| Y<br />
| Double<br />
| Absolute or relative position, depending on Flags<br />
|-<br />
| Z<br />
| Double<br />
| Absolute or relative position, depending on Flags<br />
|-<br />
| Yaw<br />
| Float<br />
| Absolute or relative rotation on the X Axis, in degrees<br />
|-<br />
| Pitch<br />
| Float<br />
| Absolute or relative rotation on the Y Axis, in degrees<br />
|-<br />
| Flags<br />
| Byte<br />
| Bit field, see below<br />
|}<br />
<br />
About the Flags field:<br />
<br />
<Dinnerbone> It's a bitfield, X/Y/Z/Y_ROT/X_ROT. If X is set, the x value is relative and not absolute.<br />
<br />
{| class="wikitable"<br />
|-<br />
! Field<br />
! Bit<br />
|-<br />
| X<br />
| 0x01<br />
|-<br />
| Y<br />
| 0x02<br />
|-<br />
| Z<br />
| 0x04<br />
|-<br />
| Y_ROT<br />
| 0x08<br />
|-<br />
| X_ROT<br />
| 0x10<br />
|}<br />
<br />
==== 持有物品变更 ====<br />
<br />
Sent to change the player's slot selection.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="1"| 0x09<br />
|rowspan="1"| Play<br />
|rowspan="1"| Client<br />
| Slot<br />
| Byte<br />
| The slot which the player has selected (0–8)<br />
|}<br />
<br />
==== 使用床 ==== <br />
<br />
This packet tells that a player goes to bed.<br />
<br />
The client with the matching Entity ID will go into bed mode.<br />
<br />
This Packet is sent to all nearby players including the one sent to bed.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="2"| 0x0A<br />
|rowspan="2"| Play<br />
|rowspan="2"| Client<br />
| Entity ID<br />
| VarInt<br />
| Sleeping player's EID<br />
|-<br />
| Location<br />
| Position<br />
| Block location of the head part of the bed<br />
|}<br />
<br />
==== 动画 ====<br />
<br />
Sent whenever an entity should change animation.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="2"| 0x0B<br />
|rowspan="2"| Play<br />
|rowspan="2"| Client<br />
| Entity ID<br />
| VarInt<br />
| Player ID<br />
|-<br />
| Animation<br />
| Unsigned Byte<br />
| Animation ID (see below)<br />
|}<br />
<br />
Animation can be one of the following values:<br />
<br />
{| class="wikitable"<br />
! ID<br />
! Animation<br />
|-<br />
| 0<br />
| Swing arm<br />
|-<br />
| 1<br />
| Take damage<br />
|-<br />
| 2<br />
| Leave bed<br />
|-<br />
| 3<br />
| Eat food<br />
|-<br />
| 4<br />
| Critical effect<br />
|-<br />
| 5<br />
| Magic critical effect<br />
|}<br />
<br />
==== 生成玩家 ====<br />
<br />
This packet is sent by the server when a player comes into visible range, ''not'' when a player joins.<br />
<br />
This packet must be sent after the [[#Player List Item|Player List Item]] ([[#Play|Play]], 0x38, clientbound) packet that adds the player data for the client to use when spawning a player. If the tab list entry for the UUID included in this packet is not present when this packet arrives, the entity will not be spawned. The tab includes skin/cape data.<br />
<br />
Servers can, however, safely spawn player entities for players not in visible range. The client appears to handle it correctly.<br />
<br />
When in online-mode the UUIDs must be valid and have valid skin blobs, in offline-mode UUID v3 is used.<br />
<br />
For NPCs UUID v2 should be used. Note:<br />
<br />
<+Grum> i will never confirm this as a feature you know that :)<br />
<br />
In an example UUID, <code>xxxxxxxx-xxxx-Yxxx-xxxx-xxxxxxxxxxxx</code>, the UUID version is specified by <code>Y</code>. So, for UUID v3, <code>Y</code> will always be <code>3</code>, and for UUID v2, <code>Y</code> will always be <code>2</code>.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="9"| 0x0C<br />
|rowspan="9"| Play<br />
|rowspan="9"| Client<br />
| Entity ID<br />
| VarInt<br />
| Player's EID<br />
|-<br />
| Player UUID<br />
| UUID<br />
| <br />
|-<br />
| X<br />
| Int<br />
| Player X as a [[Data Types#Fixed-point numbers|Fixed-Point number]]<br />
|-<br />
| Y<br />
| Int<br />
| Player Y as a [[Data Types#Fixed-point numbers|Fixed-Point number]]<br />
|-<br />
| Z<br />
| Int<br />
| Player Z as a [[Data Types#Fixed-point numbers|Fixed-Point number]]<br />
|-<br />
| Yaw<br />
| Angle<br />
| <br />
|-<br />
| Pitch<br />
| Angle<br />
| <br />
|-<br />
| Current Item<br />
| Short<br />
| The item the player is currently holding. Note that this should be 0 for “no item”, unlike -1 used in other packets.<br />
|-<br />
| Metadata<br />
| [[Entities#Entity Metadata Format|Metadata]]<br />
| <br />
|}<br />
<br />
{{Warning|A negative Current Item crashes clients}}<br />
<br />
{{Warning|The client will crash if no Metadata is sent}}<br />
<br />
==== 拾起物品 ====<br />
<br />
Sent by the server when someone picks up an item lying on the ground — its sole purpose appears to be the animation of the item flying towards you. It doesn't destroy the entity in the client memory, and it doesn't add it to your inventory. The server only checks for items to be picked up after each [[#Player Position|Player Position]] (and [[#Player Position And Look|Player Position And Look]]) packet sent by the client.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="2"| 0x0D<br />
|rowspan="2"| Play<br />
|rowspan="2"| Client<br />
| Collected Entity ID<br />
| VarInt<br />
| <br />
|- <br />
| Collector Entity ID<br />
| VarInt<br />
| <br />
|}<br />
<br />
==== 生成对象 ====<br />
<br />
Sent by the server when an Object/Vehicle is created.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="8"| 0x0E<br />
|rowspan="8"| Play<br />
|rowspan="8"| Client<br />
| Entity ID <br />
| VarInt<br />
| EID of the object<br />
|-<br />
| Type<br />
| Byte<br />
| The type of object (See [[Entities#Objects|Objects]])<br />
|-<br />
| X<br />
| Int<br />
| X position as a [[Data Types#Fixed-point numbers|Fixed-Point number]]<br />
|-<br />
| Y<br />
| Int<br />
| Y position as a [[Data Types#Fixed-point numbers|Fixed-Point number]]<br />
|-<br />
| Z<br />
| Int<br />
| Z position as a [[Data Types#Fixed-point numbers|Fixed-Point number]]<br />
|-<br />
| Pitch<br />
| Angle<br />
| <br />
|-<br />
| Yaw<br />
| Angle<br />
| <br />
|-<br />
| Data<br />
| [[Object Data]]<br />
| <br />
|}<br />
<br />
==== 生成怪物 ====<br />
<br />
Sent by the server when a Mob Entity is Spawned<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="12"| 0x0F<br />
|rowspan="12"| Play<br />
|rowspan="12"| Client<br />
| Entity ID<br />
| VarInt<br />
| <br />
|-<br />
| Type<br />
| Unsigned Byte<br />
| The type of mob. See [[Entities#Mobs|Mobs]]<br />
|-<br />
| X<br />
| Int<br />
| X position as a [[Data Types#Fixed-point numbers|Fixed-Point number]] <br />
|-<br />
| Y<br />
| Int<br />
| Y position as a [[Data Types#Fixed-point numbers|Fixed-Point number]] <br />
|-<br />
| Z<br />
| Int<br />
| Z position as a [[Data Types#Fixed-point numbers|Fixed-Point number]] <br />
|-<br />
| Yaw<br />
| Angle<br />
| <br />
|-<br />
| Pitch<br />
| Angle<br />
| <br />
|-<br />
| Head Pitch<br />
| Angle<br />
| <br />
|-<br />
| Velocity X<br />
| Short<br />
| Same units as [[#Entity Velocity|Entity Velocity]]<br />
|-<br />
| Velocity Y<br />
| Short<br />
| Same units as [[#Entity Velocity|Entity Velocity]]<br />
|-<br />
| Velocity Z<br />
| Short<br />
| Same units as [[#Entity Velocity|Entity Velocity]]<br />
|-<br />
| Metadata<br />
| [[Entities#Entity Metadata Format|Metadata]]<br />
| <br />
|}<br />
<br />
==== 重生绘图 ====<br />
<br />
This packet shows location, name, and type of painting.<br />
<br />
Calculating the center of an image: given a (width x height) grid of cells, with (0, 0) being the top left corner, the center is (max(0, width / 2 - 1), height / 2). E.g.<br />
<br />
2x1 (1, 0)<br />
4x4 (1, 2)<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="4"| 0x10<br />
|rowspan="4"| Play<br />
|rowspan="4"| Client<br />
| Entity ID<br />
| VarInt<br />
| <br />
|-<br />
| Title<br />
| String<br />
| Name of the painting. Max length 13<br />
|-<br />
| Location<br />
| Position<br />
| Center coordinates<br />
|-<br />
| Direction<br />
| Unsigned Byte<br />
| Direction the painting faces. 0: north (-z), 1: west (-x), 2: south (+z), 3: east (+x)<br />
|}<br />
<br />
==== 重生掉落经验 ====<br />
<br />
Spawns one or more experience orbs.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="5"| 0x11<br />
|rowspan="5"| Play<br />
|rowspan="5"| Client<br />
| Entity ID<br />
| VarInt<br />
| Entity's ID<br />
|-<br />
| X<br />
| Int<br />
| X position as a [[Data Types#Fixed-point numbers|Fixed-Point number]]<br />
|-<br />
| Y<br />
| Int<br />
| Y position as a [[Data Types#Fixed-point numbers|Fixed-Point number]]<br />
|-<br />
| Z<br />
| Int<br />
| Z position as a [[Data Types#Fixed-point numbers|Fixed-Point number]]<br />
|-<br />
| Count<br />
| Short<br />
| The amount of experience this orb will reward once collected<br />
|}<br />
<br />
==== 实体速率 ====<br />
<br />
Velocity is believed to be in units of 1/8000 of a block per server tick (50ms); for example, -1343 would move (-1343 / 8000) = −0.167875 blocks per tick (or −3,3575 blocks per second).<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="4"| 0x12<br />
|rowspan="4"| Play<br />
|rowspan="4"| Client<br />
| Entity ID<br />
| VarInt<br />
| <br />
|-<br />
| Velocity X<br />
| Short<br />
| Velocity on the X axis<br />
|-<br />
| Velocity Y<br />
| Short<br />
| Velocity on the Y axis<br />
|-<br />
| Velocity Z<br />
| Short<br />
| Velocity on the Z axis<br />
|}<br />
<br />
==== 销毁实体 ====<br />
<br />
Sent by the server when a list of entities is to be destroyed on the client.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="2"| 0x13<br />
|rowspan="2"| Play<br />
|rowspan="2"| Client<br />
| Count<br />
| VarInt<br />
| Number of elements in the following array<br />
|-<br />
| Entity IDs<br />
| Array of VarInt<br />
| The list of entities of destroy<br />
|}<br />
<br />
==== 实体 ====<br />
<br />
This packet may be used to initialize an entity.<br />
<br />
For player entities, either this packet or any move/look packet is sent every game tick. So the meaning of this packet is basically that the entity did not move/look since the last such packet.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="1"| 0x14<br />
|rowspan="1"| Play<br />
|rowspan="1"| Client<br />
| Entity ID<br />
| VarInt<br />
| <br />
|}<br />
<br />
==== 实体相对移动 ====<br />
<br />
This packet is sent by the server when an entity moves less then 4 blocks; if an entity moves more than 4 blocks [[#Entity Teleport|Entity Teleport]] should be sent instead.<br />
<br />
This packet allows at most four blocks movement in any direction, because byte range is from -128 to 127.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="5"| 0x15<br />
|rowspan="5"| Play<br />
|rowspan="5"| Client<br />
| Entity ID<br />
| VarInt<br />
| <br />
|-<br />
| Delta X<br />
| Byte<br />
| Change in X position as a [[Data Types#Fixed-point numbers|Fixed-Point number]]<br />
|-<br />
| Delta Y<br />
| Byte<br />
| Change in Y position as a [[Data Types#Fixed-point numbers|Fixed-Point number]]<br />
|-<br />
| Delta Z<br />
| Byte<br />
| Change in Z position as a [[Data Types#Fixed-point numbers|Fixed-Point number]]<br />
|-<br />
| On Ground<br />
| Boolean<br />
| <br />
|}<br />
<br />
==== 实体朝向 ====<br />
<br />
This packet is sent by the server when an entity rotates.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="5"| 0x16<br />
|rowspan="5"| Play<br />
|rowspan="5"| Client<br />
| Entity ID<br />
| VarInt<br />
| <br />
|-<br />
| Yaw<br />
| Angle<br />
| New angle, not a delta<br />
|-<br />
| Pitch<br />
| Angle<br />
| New angle, not a delta<br />
|-<br />
| On Ground<br />
| Boolean<br />
| <br />
|}<br />
<br />
==== 实体朝向与相对移动 ====<br />
<br />
This packet is sent by the server when an entity rotates and moves. Since a byte range is limited from -128 to 127, and movement is offset of fixed-point numbers, this packet allows at most four blocks movement in any direction. (-128/32 == -4)<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="7"| 0x17<br />
|rowspan="7"| Play<br />
|rowspan="7"| Client<br />
| Entity ID<br />
| VarInt<br />
| <br />
|-<br />
| Delta X<br />
| Byte<br />
| Change in X position as a [[Data Types#Fixed-point numbers|Fixed-Point number]]<br />
|-<br />
| Delta Y<br />
| Byte<br />
| Change in Y position as a [[Data Types#Fixed-point numbers|Fixed-Point number]]<br />
|-<br />
| Delta Z<br />
| Byte<br />
| Change in Z position as a [[Data Types#Fixed-point numbers|Fixed-Point number]]<br />
|-<br />
| Yaw<br />
| Angle<br />
| New angle, not a delta<br />
|-<br />
| Pitch<br />
| Angle<br />
| New angle, not a delta<br />
|-<br />
| On Ground<br />
| Boolean<br />
| <br />
|}<br />
<br />
==== 实体传送 ====<br />
<br />
This packet is sent by the server when an entity moves more than 4 blocks.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="7"| 0x18<br />
|rowspan="7"| Play<br />
|rowspan="7"| Client<br />
| Entity ID<br />
| VarInt<br />
| <br />
|-<br />
| X<br />
| Int<br />
| X position as a [[Data Types#Fixed-point numbers|Fixed-Point number]]<br />
|-<br />
| Y<br />
| Int<br />
| Y position as a [[Data Types#Fixed-point numbers|Fixed-Point number]]<br />
|-<br />
| Z<br />
| Int<br />
| Z position as a [[Data Types#Fixed-point numbers|Fixed-Point number]]<br />
|-<br />
| Yaw<br />
| Angle<br />
| New angle, not a delta<br />
|-<br />
| Pitch<br />
| Angle<br />
| New angle, not a delta<br />
|-<br />
| On Ground<br />
| Boolean<br />
| <br />
|}<br />
<br />
==== 实体手朝向 ====<br />
<br />
Changes the direction an entity's head is facing.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="2"| 0x19<br />
|rowspan="2"| Play<br />
|rowspan="2"| Client<br />
| Entity ID<br />
| VarInt<br />
| <br />
|-<br />
| Head Yaw<br />
| Angle<br />
| New angle, not a delta<br />
|}<br />
<br />
==== 实体状态 ====<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="2"| 0x1A<br />
|rowspan="2"| Play<br />
|rowspan="2"| Client<br />
| Entity ID<br />
| Int<br />
| <br />
|-<br />
| Entity Status<br />
| Byte<br />
| See below<br />
|}<br />
<br />
{| class="wikitable"<br />
|-<br />
! Entity Status<br />
! Meaning<br />
|-<br />
| 1<br />
| Sent when resetting a mob spawn minecart's timer - appears to be unused by the client<br />
|-<br />
| 2<br />
| Living Entity hurt <br />
|-<br />
| 3<br />
| Living Entity dead<br />
|-<br />
| 4<br />
| Iron Golem throwing up arms<br />
|-<br />
| 6<br />
| Wolf/Ocelot/Horse taming — Spawn “heart” particles<br />
|-<br />
| 7<br />
| Wolf/Ocelot/Horse tamed — Spawn “smoke” particles<br />
|-<br />
| 8<br />
| Wolf shaking water — Trigger the shaking animation<br />
|-<br />
| 9<br />
| (of self) Eating accepted by server<br />
|-<br />
| 10<br />
| Sheep eating grass<br />
|-<br />
| 10<br />
| Play TNT ignite sound<br />
|-<br />
| 11<br />
| Iron Golem handing over a rose<br />
|-<br />
| 12<br />
| Villager mating — Spawn “heart” particles<br />
|-<br />
| 13<br />
| Spawn particles indicating that a villager is angry and seeking revenge<br />
|-<br />
| 14<br />
| Spawn happy particles near a villager<br />
|-<br />
| 15<br />
| Witch animation — Spawn “magic” particles<br />
|-<br />
| 16<br />
| Play zombie converting into a villager sound<br />
|-<br />
| 17<br />
| Firework exploding<br />
|-<br />
| 18<br />
| Animal in love (ready to mate) — Spawn “heart” particles<br />
|-<br />
| 19<br />
| Reset squid rotation<br />
|-<br />
| 20<br />
| Spawn explosion particle — works for some living entities<br />
|-<br />
| 21<br />
| Play guardian sound — works for every entity<br />
|-<br />
| 22<br />
| Enables reduced debug for players<br />
|-<br />
| 23<br />
| Disables reduced debug for players<br />
|}<br />
<br />
==== 附加实体 ====<br />
<br />
This packet is sent when a player has been attached to an entity (e.g. Minecart).<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="3"| 0x1B<br />
|rowspan="3"| Play<br />
|rowspan="3"| Client<br />
| Entity ID<br />
| Int<br />
| Attached entity's EID. Set to -1 to detach.<br />
|-<br />
| Vehicle ID<br />
| Int<br />
| Vechicle's Entity ID<br />
|-<br />
| Leash<br />
| Boolean<br />
| If true leashes the entity to the vehicle<br />
|}<br />
<br />
==== 实体数据值 ====<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="2"| 0x1C<br />
|rowspan="2"| Play<br />
|rowspan="2"| Client<br />
| Entity ID<br />
| VarInt<br />
| <br />
|-<br />
| Metadata<br />
| [[Entities#Entity Metadata Format|Metadata]]<br />
| <br />
|}<br />
<br />
==== 实体属性 ====<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="5"| 0x1D<br />
|rowspan="5"| Play<br />
|rowspan="5"| Client<br />
| Entity ID<br />
| VarInt<br />
| <br />
|-<br />
| Effect ID<br />
| Byte<br />
| See {{Minecraft Wiki|Status effect#List of effects|this table}}<br />
|-<br />
| Amplifier<br />
| Byte<br />
| Notchian client displays effect level as Amplifier + 1<br />
|-<br />
| Duration<br />
| VarInt<br />
| Seconds<br />
|-<br />
| Hide Particles<br />
| Boolean<br />
| <br />
|}<br />
<br />
==== 移除实体属性 ====<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="2"| 0x1E<br />
|rowspan="2"| Play<br />
|rowspan="2"| Client<br />
| Entity ID<br />
| VarInt<br />
| <br />
|-<br />
| Effect ID<br />
| Byte<br />
| See {{Minecraft Wiki|Status effect#List of effects|this table}}<br />
|}<br />
<br />
==== 设置经验值 ====<br />
<br />
Sent by the server when the client should change experience levels.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="3"| 0x1F<br />
|rowspan="3"| Play<br />
|rowspan="3"| Client<br />
| Experience bar<br />
| Float<br />
| Between 0 and 1<br />
|-<br />
| Level<br />
| VarInt<br />
| <br />
|-<br />
| Total Experience<br />
| VarInt<br />
| See {{Minecraft Wiki|Experience#Leveling up}} on the Minecraft Wiki for Total Experience to Level conversion<br />
|}<br />
<br />
==== 实体配置 ====<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
!colspan="2"| Field Name<br />
!colspan="2"| Field Type<br />
! Notes<br />
|-<br />
|rowspan="6"| 0x20<br />
|rowspan="6"| Play<br />
|rowspan="6"| Client<br />
|colspan="2"| Entity ID<br />
|colspan="2"| VarInt<br />
| <br />
|-<br />
|colspan="2"| Number Of Properties<br />
|colspan="2"| Int<br />
| Number of elements in the following array<br />
|-<br />
|rowspan="4"| Property<br />
| Key<br />
|rowspan="4"| Array<br />
| String<br />
| See below<br />
|-<br />
| Value<br />
| Double<br />
| See below<br />
|-<br />
| Number Of Modifiers<br />
| VarInt<br />
| Number of elements in the following array<br />
|-<br />
| Modifiers<br />
| Array of Modifier Data<br />
| See {{Minecraft Wiki|Attribute#Modifiers}}<br />
|}<br />
<br />
Known Key values:<br />
<br />
{| class="wikitable"<br />
|-<br />
! Key<br />
! Default<br />
! Min<br />
! Max<br />
! Label<br />
|-<br />
| generic.maxHealth<br />
| 20.0<br />
| 0.0<br />
| Double.MaxValue<br />
| Max Health<br />
|-<br />
| generic.followRange<br />
| 32.0<br />
| 0.0<br />
| 2048.0<br />
| Follow Range<br />
|-<br />
| generic.knockbackResistance<br />
| 0.0 <br />
| 0.0<br />
| 1.0<br />
| Knockback Resistance<br />
|-<br />
| generic.movementSpeed<br />
| 0.699999988079071<br />
| 0.0<br />
| Double.MaxValue<br />
| Movement Speed<br />
|-<br />
| generic.attackDamage<br />
| 2.0<br />
| 0.0<br />
| Double.MaxValue<br />
| <br />
|-<br />
| horse.jumpStrength<br />
| 0.7<br />
| 0.0<br />
| 2.0<br />
| Jump Strength<br />
|-<br />
| zombie.spawnReinforcements<br />
| 0.0<br />
| 0.0<br />
| 1.0<br />
| Spawn Reinforcements Chance<br />
|}<br />
<br />
''Modifier Data'' structure:<br />
<br />
{| class="wikitable"<br />
|-<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
| UUID<br />
| UUID<br />
| <br />
|-<br />
| Amount<br />
| Double<br />
| <br />
|-<br />
| Operation<br />
| Byte<br />
| <br />
|}<br />
<br />
==== 区块数据 ====<br />
<br />
Chunks are not unloaded by the client automatically. To unload chunks, send this packet with Ground-Up Continuous=true and no 16^3 chunks (eg. Primary Bit Mask=0). The server does not send skylight information for nether-chunks, it's up to the client to know if the player is currently in the nether. You can also infer this information from the primary bitmask and the amount of uncompressed bytes sent.<br />
<br />
See also: [[SMP Map Format]]<br />
<br />
Changes in 1.8:<br />
<br />
* Data value section removed<br />
* Extended id section removed<br />
* Block id section is now a unsigned short (little endian) per a block<br />
* The block id is equal to <code>(id << 4) | data</code><br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="6"| 0x21<br />
|rowspan="6"| Play<br />
|rowspan="6"| Client<br />
| Chunk X<br />
| Int<br />
| Chunk X coordinate<br />
|-<br />
| Chunk Z<br />
| Int<br />
| Chunk Z coordinate<br />
|-<br />
| Ground-Up Continuous<br />
| Boolean<br />
| This is true if the packet represents all sections in this vertical column, where the Primary Bit Mask specifies exactly which sections are included, and which are air<br />
|-<br />
| Primary Bit Mask<br />
| Unsigned Short<br />
| Bitmask with 1 for every 16x16x16 section whose data follows in the compressed data<br />
|- <br />
| Size<br />
| VarInt<br />
| Size of Data<br />
|-<br />
| Data<br />
| [[SMP Map Format#Data|Chunk]]<br />
| <br />
|}<br />
<br />
==== 多个方块改变 ====<br />
Fired whenever 2 or more blocks are changed within the render distance.<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
!colspan="2"| Field Name<br />
!colspan="2"| Field Type<br />
! Notes<br />
|-<br />
|rowspan="6"| 0x22<br />
|rowspan="6"| Play<br />
|rowspan="6"| Client<br />
|colspan="2"| Chunk X<br />
|colspan="2"| Int<br />
| Chunk X coordinate<br />
|-<br />
|colspan="2"| Chunk Z<br />
|colspan="2"| Int<br />
| Chunk Z coordinate<br />
|-<br />
|colspan="2"| Record Count<br />
|colspan="2"| VarInt<br />
| Number of elements in the following array, a.k.a. the number of blocks affected<br />
|-<br />
|rowspan="3"| Record<br />
| Horizontal Position<br />
|rowspan="3"| Array<br />
| Unsigned Byte<br />
| The 4 most significant bits (<code>0xF0</code>) encode the X coordinate, relative to the chunk. The 4 least significant bits (<code>0x0F</code>) encode the Z coordinate, relative to the chunk.<br />
|-<br />
| Y Coordinate<br />
| Unsigned Byte<br />
| <br />
|-<br />
| Block ID<br />
| VarInt<br />
| The new block ID for the block. <code><nowiki>id &lt;&lt; 4 | data</nowiki></code><br />
|}<br />
<br />
==== 方块改变 ====<br />
Fired whenever a block is changed within the render distance.<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="2"| 0x23<br />
|rowspan="2"| Play<br />
|rowspan="2"| Client<br />
| Location<br />
| Position<br />
| Block Coordinates<br />
|-<br />
| Block ID<br />
| VarInt<br />
| The new block ID for the block. <code><nowiki>id &lt;&lt; 4 | data</nowiki></code><br />
|}<br />
<br />
==== 方块功能 ====<br />
<br />
This packet is used for a number of things:<br />
<br />
* Chests opening and closing<br />
* Pistons pushing and pulling<br />
* Note blocks playing<br />
* Updating beacons<br />
<br />
See Also: [[Block Actions]] <br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="4"| 0x24<br />
|rowspan="4"| Play<br />
|rowspan="4"| Client<br />
| Location<br />
| Position<br />
| Block Coordinates<br />
|-<br />
| Byte 1<br />
| Unsigned Byte<br />
| Varies depending on block — see [[Block Actions]]<br />
|-<br />
| Byte 2<br />
| Unsigned Byte<br />
| Varies depending on block — see [[Block Actions]]<br />
|-<br />
| Block Type<br />
| VarInt<br />
| The block type for the block<br />
|}<br />
<br />
==== 方块破坏动画 ====<br />
<br />
0–9 are the displayable destroy stages and each other number means that there is no animation on this coordinate.<br />
<br />
You can also set an animation to air! The animation will still be visible.<br />
<br />
If you need to display several break animations at the same time you have to give each of them a unique Entity ID.<br />
<br />
Also if you set the coordinates to a special block like water etc. it won't show the actual break animation but some other interesting effects. (Water will lose it's transparency)<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="3"| 0x25<br />
|rowspan="3"| Play<br />
|rowspan="3"| Client<br />
| Entity ID<br />
| VarInt<br />
| EID for the animation<br />
|-<br />
| Location<br />
| Position<br />
| Block Position<br />
|-<br />
| Destroy Stage<br />
| Byte<br />
| 0–9 to set it, any other value to remove it<br />
|}<br />
<br />
==== 地图区块 ====<br />
<br />
1.8 changes at [[#Chunk Data|Chunk Data]]<br />
<br />
To reduce the number of bytes, this packet is used to send chunks together for better compression results.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
!colspan="2"| Field Name<br />
!colspan="2"| Field Type<br />
! Notes<br />
|-<br />
|rowspan="7"| 0x26<br />
|rowspan="7"| Play<br />
|rowspan="7"| Client<br />
|colspan="2"| Sky Light Sent<br />
|colspan="2"| Boolean<br />
| Whether or not Chunk Data contains light nibble arrays. This is true in the Overworld, false in the End + Nether<br />
|-<br />
|colspan="2"| Chunk Column Count<br />
|colspan="2"| VarInt<br />
| Number of elements in each of the following arrays<br />
|-<br />
|rowspan="3"| Chunk Meta<br />
| Chunk X<br />
|rowspan="3"| Array<br />
| Int<br />
| The X coordinate of the chunk<br />
|-<br />
| Chunk Z<br />
| Int<br />
| The Z coordinate of the chunk<br />
|-<br />
| Primary Bit Mask<br />
| Unsigned Short<br />
| A bit mask which specifies which sections are not empty in this chunk<br />
|-<br />
|colspan="2"| Chunk Data<br />
|colspan="2"| Array of [[SMP Map Format#Data|Chunk]]<br />
| Each chunk in this array corresponds to the data at the same position in Chunk Meta<br />
|}<br />
<br />
==== 爆炸 ====<br />
<br />
Sent when an explosion occurs (creepers, TNT, and ghast fireballs).<br />
<br />
Each block in Records is set to air. Coordinates for each axis in record is int(X) + record.x<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="9"| 0x27<br />
|rowspan="9"| Play<br />
|rowspan="9"| Client<br />
| X<br />
| Float<br />
| <br />
|-<br />
| Y<br />
| Float<br />
| <br />
|-<br />
| Z<br />
| Float<br />
| <br />
|-<br />
| Radius<br />
| Float<br />
| Currently unused in the client<br />
|-<br />
| Record Count<br />
| Int<br />
| Number of elements in the following array<br />
|-<br />
| Records<br />
| Array of (Byte, Byte, Byte)<br />
| Each record is 3 signed bytes long, each bytes are the XYZ (respectively) offsets of affected blocks.<br />
|-<br />
| Player Motion X<br />
| Float<br />
| X velocity of the player being pushed by the explosion<br />
|-<br />
| Player Motion Y<br />
| Float<br />
| Y velocity of the player being pushed by the explosion<br />
|-<br />
| Player Motion Z<br />
| Float<br />
| Z velocity of the player being pushed by the explosion<br />
|}<br />
<br />
==== 属性 ====<br />
<br />
Sent when a client is to play a sound or particle effect.<br />
<br />
By default, the Minecraft client adjusts the volume of sound effects based on distance. The final boolean field is used to disable this, and instead the effect is played from 2 blocks away in the correct direction. Currently this is only used for effect 1013 (mob.wither.spawn), and is ignored for any other value by the client.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="4"| 0x28<br />
|rowspan="4"| Play<br />
|rowspan="4"| Client<br />
| Effect ID<br />
| Int<br />
| The ID of the effect, see below<br />
|-<br />
| Location<br />
| Position<br />
| The location of the effect<br />
|-<br />
| Data<br />
| Int<br />
| Extra data for certain effects, see below<br />
|-<br />
| Disable Relative Volume<br />
| Boolean<br />
| See above<br />
|}<br />
<br />
Effect IDs:<br />
<br />
{| class="wikitable"<br />
! ID<br />
! Name<br />
! Data<br />
|-<br />
!colspan="3"| Sound<br />
|-<br />
| 1000<br />
| <code>random.click</code><br />
| <br />
|-<br />
| 1001<br />
| <code>random.click</code><br />
| <br />
|-<br />
| 1002<br />
| <code>random.bow</code><br />
| <br />
|-<br />
| 1003<br />
| <code>random.door_open</code> or <code>random.door_close</code> (50/50 chance)<br />
| <br />
|-<br />
| 1004<br />
| <code>random.fizz</code><br />
| <br />
|-<br />
| 1005<br />
| Play a music disc.<br />
| {{Minecraft Wiki|Music Discs|Record ID}}<br />
|-<br />
| 1006<br />
| ''not assigned''<br />
| <br />
|-<br />
| 1007<br />
| <code>mob.ghast.charge</code><br />
| <br />
|-<br />
| 1008<br />
| <code>mob.ghast.fireball</code><br />
| <br />
|-<br />
| 1009<br />
| <code>mob.ghast.fireball</code>, but with a lower volume<br />
| <br />
|-<br />
| 1010<br />
| <code>mob.zombie.wood</code><br />
| <br />
|-<br />
| 1011<br />
| <code>mob.zombie.metal</code><br />
| <br />
|-<br />
| 1012<br />
| <code>mob.zombie.woodbreak</code><br />
| <br />
|-<br />
| 1013<br />
| <code>mob.wither.spawn</code><br />
| <br />
|-<br />
| 1014<br />
| <code>mob.wither.shoot</code><br />
| <br />
|-<br />
| 1015<br />
| <code>mob.bat.takeoff</code><br />
| <br />
|-<br />
| 1016<br />
| <code>mob.zombie.infect</code><br />
| <br />
|-<br />
| 1017<br />
| <code>mob.zombie.unfect</code><br />
| <br />
|-<br />
| 1018<br />
| <code>mob.enderdragon.end</code><br />
| <br />
|-<br />
| 1020<br />
| <code>random.anvil_break</code><br />
| <br />
|-<br />
| 1021<br />
| <code>random.anvil_use</code><br />
| <br />
|-<br />
| 1022<br />
| <code>random.anvil_land</code><br />
| <br />
|-<br />
!colspan="3"| Particle<br />
|-<br />
| 2000<br />
| Spawns 10 smoke particles, e.g. from a fire<br />
| Direction, see below<br />
|-<br />
| 2001<br />
| Block break<br />
| {{Minecraft Wiki|Data values|Block ID}}<br />
|-<br />
| 2002<br />
| Splash potion. Particle effect + glass break sound.<br />
| [http://www.lb-stuff.com/Minecraft/PotionDataValues1.9pre3.txt Potion ID]<br />
|-<br />
| 2003<br />
| Eye of Ender entity break animation — particles and sound<br />
| <br />
|-<br />
| 2004<br />
| Mob spawn particle effect: smoke + flames<br />
| <br />
|-<br />
| 2005<br />
| Spawn “happy villager” effect (green crosses), used for bonemealing vegetation<br />
| <br />
|}<br />
<br />
Smoke directions:<br />
<br />
{| class="wikitable"<br />
! ID<br />
! Direction<br />
|-<br />
| 0<br />
| South-East<br />
|-<br />
| 1<br />
| South<br />
|-<br />
| 2<br />
| South-West<br />
|-<br />
| 3<br />
| East<br />
|-<br />
| 4<br />
| (Up or middle ?)<br />
|-<br />
| 5<br />
| West<br />
|-<br />
| 6<br />
| North-East<br />
|-<br />
| 7<br />
| North<br />
|-<br />
| 8<br />
| North-West<br />
|}<br />
<br />
==== 声音特效 ====<br />
<br />
Used to play a sound effect on the client.<br />
<br />
Custom sounds may be added by resource packs.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="6"| 0x29<br />
|rowspan="6"| Play<br />
|rowspan="6"| Client<br />
| Sound name<br />
| String<br />
| All known sound effect names can be seen [https://github.com/SirCmpwn/Craft.Net/blob/master/source/Craft.Net.Common/SoundEffect.cs here]<br />
|-<br />
| Effect position X<br />
| Int<br />
| Effect X multiplied by 8<br />
|-<br />
| Effect position Y<br />
| Int<br />
| Effect Y multiplied by 8<br />
|-<br />
| Effect position Z<br />
| Int<br />
| Effect Z multiplied by 8<br />
|-<br />
| Volume<br />
| Float<br />
| 1 is 100%, can be more<br />
|-<br />
| Pitch<br />
| Unsigned Byte<br />
| 63 is 100%, can be more<br />
|}<br />
<br />
==== 粒子效果 ====<br />
<br />
Displays the named particle<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="11"| 0x2A<br />
|rowspan="11"| Play<br />
|rowspan="11"| Client<br />
| Particle ID<br />
| Int<br />
| See below<br />
|-<br />
| Long Distance<br />
| Boolean<br />
| If true, particle distance increases from 256 to 65536<br />
|-<br />
| X<br />
| Float<br />
| X position of the particle<br />
|-<br />
| Y<br />
| Float<br />
| Y position of the particle<br />
|-<br />
| Z<br />
| Float<br />
| Z position of the particle<br />
|-<br />
| Offset X<br />
| Float<br />
| This is added to the X position after being multiplied by random.nextGaussian()<br />
|-<br />
| Offset Y<br />
| Float<br />
| This is added to the Y position after being multiplied by random.nextGaussian()<br />
|-<br />
| Offset Z<br />
| Float<br />
| This is added to the Z position after being multiplied by random.nextGaussian()<br />
|-<br />
| Particle Data<br />
| Float<br />
| The data of each particle<br />
|-<br />
| Particle Count<br />
| Int<br />
| The number of particles to create<br />
|-<br />
| Data<br />
| Array of VarInt<br />
| Length depends on particle. "iconcrack" has length of 2, "blockcrack", and "blockdust" have lengths of 1, the rest have 0.<br />
|}<br />
<br />
Particle IDs:<br />
<br />
{| class="wikitable"<br />
|-<br />
! Particle Name<br />
! Particle ID<br />
|-<br />
| explode<br />
| 0<br />
|-<br />
| largeexplosion<br />
| 1<br />
|-<br />
| hugeexplosion<br />
| 2<br />
|-<br />
| fireworksSpark<br />
| 3<br />
|-<br />
| bubble<br />
| 4<br />
|-<br />
| splash<br />
| 5<br />
|-<br />
| wake<br />
| 6<br />
|-<br />
| suspended<br />
| 7<br />
|-<br />
| depthsuspend<br />
| 8<br />
|-<br />
| crit<br />
| 9<br />
|-<br />
| magicCrit<br />
| 10<br />
|-<br />
| smoke<br />
| 11<br />
|-<br />
| largesmoke<br />
| 12<br />
|-<br />
| spell<br />
| 13<br />
|-<br />
| instantSpell<br />
| 14<br />
|-<br />
| mobSpell<br />
| 15<br />
|-<br />
| mobSpellAmbient<br />
| 16<br />
|-<br />
| witchMagic<br />
| 17<br />
|-<br />
| dripWater<br />
| 18<br />
|-<br />
| dripLava<br />
| 19<br />
|-<br />
| angryVillager<br />
| 20<br />
|-<br />
| happyVillager<br />
| 21<br />
|-<br />
| townaura<br />
| 22<br />
|-<br />
| note<br />
| 23<br />
|-<br />
| portal<br />
| 24<br />
|-<br />
| enchantmenttable<br />
| 25<br />
|-<br />
| flame<br />
| 26<br />
|-<br />
| lava<br />
| 27<br />
|-<br />
| footstep<br />
| 28<br />
|-<br />
| cloud<br />
| 29<br />
|-<br />
| reddust<br />
| 30<br />
|-<br />
| snowballpoof<br />
| 31<br />
|-<br />
| snowshovel<br />
| 32<br />
|-<br />
| slime<br />
| 33<br />
|-<br />
| heart<br />
| 34<br />
|-<br />
| barrier<br />
| 35<br />
|-<br />
| iconcrack_(id)_(data)<br />
| 36<br />
|-<br />
| blockcrack_(id+(data<<12))<br />
| 37<br />
|-<br />
| blockdust_(id)<br />
| 38<br />
|-<br />
| droplet<br />
| 39<br />
|-<br />
| take<br />
| 40<br />
|-<br />
| mobappearance<br />
| 41<br />
|}<br />
<br />
==== 改变游戏状态 ====<br />
<br />
It appears when a bed can't be used as a spawn point and when the rain state changes.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="2"| 0x2B<br />
|rowspan="2"| Play<br />
|rowspan="2"| Client<br />
| Reason<br />
| Unsigned Byte<br />
| See below<br />
|-<br />
| Value<br />
| Float<br />
| Depends on Reason<br />
|}<br />
<br />
''Reason codes'':<br />
<br />
{| class="wikitable"<br />
! Reason<br />
! Effect<br />
! Value<br />
|-<br />
| 0<br />
| Invalid Bed<br />
| <br />
|-<br />
| 1<br />
| End raining<br />
| <br />
|-<br />
| 2<br />
| Begin raining<br />
| <br />
|-<br />
| 3<br />
| Change game mode<br />
| 0: Survival, 1: Creative, 2: Adventure, 3: Spectator<br />
|-<br />
| 4<br />
| Enter credits<br />
| <br />
|-<br />
| 5<br />
| Demo message<br />
| 0: Show welcome to demo screen, 101: Tell movement controls, 102: Tell jump control, 103: Tell inventory control<br />
|- <br />
| 6<br />
| Arrow hitting player<br />
| Appears to be played when an arrow strikes another player in Multiplayer<br />
|-<br />
| 7<br />
| Fade value<br />
| The current darkness value. 1 = Dark, 0 = Bright, Setting the value higher causes the game to change color and freeze<br />
|-<br />
| 8<br />
| Fade time<br />
| Time in ticks for the sky to fade<br />
|-<br />
| 10<br />
| Play mob appearance (effect and sound)<br />
| Unknown<br />
|}<br />
<br />
==== 生存全局实体 ====<br />
<br />
With this packet, the server notifies the client of thunderbolts striking within a 512 block radius around the player. The coordinates specify where exactly the thunderbolt strikes.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="5"| 0x2C<br />
|rowspan="5"| Play<br />
|rowspan="5"| Client<br />
| Entity ID<br />
| VarInt<br />
| The EID of the thunderbolt<br />
|-<br />
| Type<br />
| Byte<br />
| The global entity type, currently always 1 for thunderbolt<br />
|-<br />
| X<br />
| Int<br />
| Thunderbolt X, a [[Data Types#Fixed-point numbers|fixed-point number]]<br />
|-<br />
| Y<br />
| Int<br />
| Thunderbolt Y, a [[Data Types#Fixed-point numbers|fixed-point number]]<br />
|-<br />
| Z<br />
| Int<br />
| Thunderbolt Z, a [[Data Types#Fixed-point numbers|fixed-point number]]<br />
|}<br />
<br />
==== 打开窗户 ====<br />
<br />
This is sent to the client when it should open an inventory, such as a chest, workbench, or furnace. This message is not sent anywhere for clients opening their own inventory.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="5"| 0x2D<br />
|rowspan="5"| Play<br />
|rowspan="5"| Client<br />
| Window ID<br />
| Unsigned Byte<br />
| A unique id number for the window to be displayed. Notchian server implementation is a counter, starting at 1.<br />
|-<br />
| Window Type<br />
| String<br />
| The window type to use for display. See [[Inventory]] for a list.<br />
|-<br />
| Window Title<br />
| [[Chat]]<br />
| The title of the window<br />
|-<br />
| Number Of Slots<br />
| Unsigned Byte<br />
| Number of slots in the window (excluding the number of slots in the player inventory)<br />
|-<br />
| Entity ID<br />
| Optional Int<br />
| EntityHorse's EID. Only sent when Window Type is “EntityHorse”<br />
|}<br />
<br />
See [[Inventory]] for further information.<br />
<br />
==== 关闭窗户 ====<br />
<br />
This packet is sent from the server to the client when a window is forcibly closed, such as when a chest is destroyed while it's open.<br />
<br />
Note, notchian clients send a close window packet with Window ID 0 to close their inventory even though there is never an [[#Open Window|Open Window]] packet for inventory. <br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
| 0x2E<br />
|rowspan="1"| Play<br />
|rowspan="1"| Client<br />
| Window ID<br />
| Unsigned Byte<br />
| This is the ID of the window that was closed. 0 for inventory.<br />
|}<br />
<br />
==== 设置位置 ====<br />
<br />
Sent by the server when an item in a slot (in a window) is added/removed.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="3"| 0x2F<br />
|rowspan="3"| Play<br />
|rowspan="3"| Client<br />
| Window ID<br />
| Byte<br />
| The window which is being updated. 0 for player inventory. Note that all known window types include the player inventory. This packet will only be sent for the currently opened window while the player is performing actions, even if it affects the player inventory. After the window is closed, a number of these packets are sent to update the player's inventory window (0).<br />
|-<br />
| Slot<br />
| Short<br />
| The slot that should be updated<br />
|-<br />
| Slot Data<br />
| [[Slot Data|Slot]]<br />
| <br />
|}<br />
<br />
==== 窗口物品 ====<br />
<br />
[[File:Inventory-slots.png|thumb|The inventory slots]]<br />
<br />
Sent by the server when items in multiple slots (in a window) are added/removed. This includes the main inventory, equipped armour and crafting slots.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="3"| 0x30<br />
|rowspan="3"| Play<br />
|rowspan="3"| Client<br />
| Window ID<br />
| Unsigned Byte<br />
| The ID of window which items are being sent for. 0 for player inventory.<br />
|-<br />
| Count<br />
| Short<br />
| Number of elements in the following array<br />
|-<br />
| Slot Data<br />
| Array of [[Slot Data|Slot]]<br />
| <br />
|}<br />
<br />
See [[Inventory#Windows|inventory windows]] for further information about how slots are indexed.<br />
<br />
==== Window Property ====<br />
<br />
This packet is used to inform the client that part of a GUI window should be updated.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="3"| 0x31<br />
|rowspan="3"| Play<br />
|rowspan="3"| Client<br />
| Window ID<br />
| Unsigned Byte<br />
| <br />
|-<br />
| Property<br />
| Short<br />
| The property to be updated, see below<br />
|-<br />
| Value<br />
| Short<br />
| The new value for the property, see below<br />
|}<br />
<br />
The meaning of the Property field depends on the type of the window. The following table shows the known combinations of window type and property, and how the value is to be interpreted.<br />
<br />
{| class="wikitable"<br />
|-<br />
! Window type<br />
! Property<br />
! Value<br />
|-<br />
|rowspan="2"| Furnace<br />
| 0: Progress arrow<br />
| 0–200 (presumably in in-game ticks)<br />
|-<br />
| 1: Fire icon (fuel)<br />
| 0–200 (presumably in in-game ticks)<br />
|-<br />
|rowspan="7"| Enchantment Table<br />
| 0: Level requirement for top enchantment slot<br />
|rowspan="3"| The enchantment's xp level requirement<br />
|-<br />
| 1: Level requirement for middle enchantment slot<br />
|-<br />
| 2: Level requirement for bottom enchantment slot<br />
|-<br />
| 3: The seed for generating the enchantments view for the client<br />
| Unknown<br />
|-<br />
| 4: tooltip shown on mouse hover over top enchantment slot<br />
|rowspan="3"| Unknown (set to -1 to hide it)<br />
|-<br />
| 5: tooltip shown on mouse hover over middle enchantment slot<br />
|-<br />
| 6: tooltip shown on mouse hover over bottom enchantment slot<br />
|-<br />
|rowspan="3"| Beacon<br />
| 0: Power level<br />
| Unknown<br />
|-<br />
| 1: First potion effect<br />
| Unknown<br />
|-<br />
| 2: Second potion effect<br />
| Unknown<br />
|-<br />
| Anvil<br />
| 0: Repair cost<br />
| The repair's cost in xp levels<br />
|-<br />
| Brewing Stand<br />
| 0: Brew time<br />
| 0–400, with 400 making the arrow empty, and 0 making the arrow full<br />
|}<br />
<br />
==== 确认事物 ====<br />
<br />
A packet from the server indicating whether a request from the client was accepted, or whether there was a conflict (due to lag).<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="3"| 0x32<br />
|rowspan="3"| Play<br />
|rowspan="3"| Client<br />
| Window ID<br />
| Byte<br />
| The ID of the window that the action occurred in<br />
|-<br />
| Action Number<br />
| Short<br />
| Every action that is to be accepted has a unique number. This field corresponds to that number.<br />
|-<br />
| Accepted<br />
| Boolean<br />
| Whether the action was accepted<br />
|}<br />
<br />
==== 更新标志 ====<br />
<br />
This message is sent from the server to the client whenever a sign is discovered or created. This message is NOT sent when a sign is destroyed or unloaded.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="5"| 0x33<br />
|rowspan="5"| Play<br />
|rowspan="5"| Client<br />
| Location<br />
| Position<br />
| <br />
|-<br />
| Line 1<br />
| [[Chat]]<br />
| First line of text in the sign<br />
|-<br />
| Line 2<br />
| [[Chat]]<br />
| Second line of text in the sign<br />
|-<br />
| Line 3<br />
| [[Chat]]<br />
| Third line of text in the sign<br />
|-<br />
| Line 4<br />
| [[Chat]]<br />
| Fourth line of text in the sign<br />
|}<br />
<br />
==== 地图 ====<br />
<br />
Updates a rectangular area on a map.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
!colspan="2"| Field Name<br />
!colspan="2"| Field Type<br />
! Notes<br />
|-<br />
|rowspan="12"| 0x34<br />
|rowspan="12"| Play<br />
|rowspan="12"| Client<br />
|colspan="2"| Item Damage<br />
|colspan="2"| VarInt<br />
| The damage value (map ID) of the map being modified<br />
|-<br />
|colspan="2"| Scale<br />
|colspan="2"| Byte<br />
| <br />
|- <br />
|colspan="2"| Icon Count<br />
|colspan="2"| VarInt<br />
| Number of elements in the following array<br />
|-<br />
|rowspan="3"| Icon<br />
| Direction And Type<br />
|rowspan="3"| Array<br />
| Byte<br />
| 0xF0 = Direction, 0x0F = Type<br />
|-<br />
| X<br />
| Byte<br />
| <br />
|-<br />
| Z<br />
| Byte<br />
| <br />
|- <br />
|colspan="2"| Columns<br />
|colspan="2"| Byte<br />
| Number of columns updated<br />
|-<br />
|colspan="2"| Rows<br />
|colspan="2"| Optional Byte<br />
| Only if Columns is more than 0; number of rows updated<br />
|-<br />
|colspan="2"| X<br />
|colspan="2"| Optional Byte<br />
| Only if Columns is more than 0; x offset of the westernmost column<br />
|-<br />
|colspan="2"| Z<br />
|colspan="2"| Optional Byte<br />
| Only if Columns is more than 0; z offset of the northernmost row<br />
|-<br />
|colspan="2"| Length<br />
|colspan="2"| Optional VarInt<br />
| Only if Columns is more than 0; length of the following array<br />
|-<br />
|colspan="2"| Data<br />
|colspan="2"| Optional Array of Unsigned Byte<br />
| Only if Columns is more than 0; see {{Minecraft Wiki|Map item format}}<br />
|}<br />
<br />
==== 更新方块实体 ====<br />
<br />
Essentially a block update on a block entity.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="3"| 0x35<br />
|rowspan="3"| Play<br />
|rowspan="3"| Client<br />
| Location<br />
| Position<br />
| <br />
|-<br />
| Action<br />
| Unsigned Byte<br />
| The type of update to perform, see below<br />
|-<br />
| NBT Data<br />
| Optional [[NBT|NBT Tag]]<br />
| If not present then it's a TAG_END (0)<br />
|}<br />
<br />
''Action'' field:<br />
<br />
* '''1''': Set SpawnPotentials of a mob spawner<br />
* '''2''': Set command block text (command and last execution status)<br />
* '''3''': Set the level, primary, and secondary powers of a beacon<br />
* '''4''': Set rotation and skin of mob head<br />
* '''5''': Set type of flower in flower pot<br />
* '''6''': Set base color and patterns on a banner<br />
<br />
==== 打开标志牌编辑器 ====<br />
<br />
Sent on placement of sign.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="1"| 0x36<br />
|rowspan="1"| Play<br />
|rowspan="1"| Client<br />
| Location<br />
| Position<br />
| <br />
|}<br />
<br />
==== 统计数据 ====<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To <br />
!colspan="2"| Field Name<br />
!colspan="2"| Field Type<br />
! Notes<br />
|-<br />
|rowspan="3"| 0x37<br />
|rowspan="3"| Play<br />
|rowspan="3"| Client<br />
|colspan="2"| Count<br />
|colspan="2"| VarInt<br />
| Number of elements in the following array<br />
|-<br />
|rowspan="2"| Statistic<br />
| Name<br />
|rowspan="2"| Array<br />
| String<br />
| [https://gist.github.com/thinkofdeath/a1842c21a0cf2e1fb5e0 https://gist.github.com/thinkofdeath/a1842c21a0cf2e1fb5e0]<br />
|-<br />
| Value<br />
| VarInt<br />
| The amount to set it to<br />
|}<br />
<br />
==== 玩家列表项 ====<br />
<br />
Sent by the notchian server to update the user list (<tab> in the client).<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
!colspan="4"| Field Name<br />
!colspan="3"| Field Type<br />
! Notes<br />
|-<br />
|rowspan="19"| 0x38<br />
|rowspan="19"| Play<br />
|rowspan="19"| Client<br />
|colspan="4"| Action<br />
|colspan="3"| VarInt<br />
| Determines the rest of the Player format after the UUID<br />
|-<br />
|colspan="4"| Number Of Players<br />
|colspan="3"| VarInt<br />
| Number of elements in the following array<br />
|-<br />
|rowspan="17"| Player<br />
|colspan="3"| UUID<br />
|rowspan="17"| Array<br />
|colspan="2"| UUID<br />
| <br />
|-<br />
! Action<br />
!colspan="2"| Field Name<br />
!colspan="2"| <br />
! <br />
|-<br />
|rowspan="10"| 0: add player<br />
|colspan="2"| Name<br />
|colspan="2"| String<br />
| <br />
|-<br />
|colspan="2"| Number Of Properties<br />
|colspan="2"| VarInt<br />
| Number of elements in the following array<br />
|-<br />
|rowspan="4"| Property<br />
| Name<br />
|rowspan="4"| Array<br />
| String<br />
| <br />
|-<br />
| Value<br />
| String<br />
| <br />
|- <br />
| Is Signed<br />
| Boolean<br />
| <br />
|-<br />
| Signature<br />
| Optional String<br />
| Only if Is Signed is true<br />
|-<br />
|colspan="2"| Gamemode<br />
|colspan="2"| VarInt<br />
| <br />
|-<br />
|colspan="2"| Ping<br />
|colspan="2"| VarInt<br />
| <br />
|-<br />
|colspan="2"| Has Display Name<br />
|colspan="2"| Boolean<br />
| <br />
|-<br />
|colspan="2"| Display Name<br />
|colspan="2"| Optional [[Chat]]<br />
| Only if Has Display Name is true<br />
|-<br />
| 1: update gamemode<br />
|colspan="2"| Gamemode<br />
|colspan="2"| VarInt<br />
| <br />
|- <br />
| 2: update latency<br />
|colspan="2"| Ping<br />
|colspan="2"| VarInt<br />
| <br />
|-<br />
|rowspan="2"| 3: update display name<br />
|colspan="2"| Has Display Name<br />
|colspan="2"| Boolean<br />
| <br />
|-<br />
|colspan="2"| Display Name<br />
|colspan="2"| Optional [[Chat]]<br />
| Only send if Has Display Name is true<br />
|-<br />
| 4: remove player<br />
|colspan="2"| ''no fields''<br />
|colspan="2"| ''no fields''<br />
| <br />
|}<br />
<br />
==== 玩家能力 ====<br />
<br />
The latter 2 floats are used to indicate the walking and flying speeds respectively, while the first byte is used to determine the value of 4 booleans.<br />
<br />
The flags are whether damage is disabled (god mode, 8, bit 3), whether the player can fly (4, bit 2), whether the player is flying (2, bit 1), and whether the player is in creative mode (1, bit 0).<br />
<br />
To get the values of these booleans, simply AND (&) the byte with 1,2,4 and 8 respectively, to get the 0 or 1 bitwise value. To set them OR (|) them with their repspective masks.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="3"| 0x39<br />
|rowspan="3"| Play<br />
|rowspan="3"| Client<br />
| Flags<br />
| Byte<br />
| Bit mask, see above<br />
|-<br />
| Flying Speed<br />
| Float<br />
| <br />
|-<br />
| Walking Speed<br />
| Float<br />
| <br />
|}<br />
<br />
==== Tab补全 ====<br />
<br />
The server responds with a list of auto-completions of the last word sent to it. In the case of regular chat, this is a player username. Command names and parameters are also supported.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="2"| 0x3A<br />
|rowspan="2"| Play<br />
|rowspan="2"| Client<br />
| Count<br />
| VarInt<br />
| Number of elements in the following array<br />
|-<br />
| Matches<br />
| Array of String<br />
| One eligible command, note that each command is sent separately instead of in a single string, hence the need for Count<br />
|}<br />
<br />
==== 计分板目标 ====<br />
<br />
This is sent to the client when it should create a new {{Minecraft Wiki|scoreboard}} objective or remove one.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="4"| 0x3B<br />
|rowspan="4"| Play<br />
|rowspan="4"| Client<br />
| Objective Name<br />
| String<br />
| An unique name for the objective<br />
|-<br />
| Mode<br />
| Byte<br />
| 0 to create the scoreboard. 1 to remove the scoreboard. 2 to update the display text. <br />
|-<br />
| Objective Value<br />
| Optional String<br />
| Only if mode is 0 or 2. The text to be displayed for the score<br />
|-<br />
| Type<br />
| Optional String<br />
| Only if mode is 0 or 2. “integer” or “hearts”<br />
|}<br />
<br />
==== 更新分数 ====<br />
<br />
This is sent to the client when it should update a scoreboard item. <br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="4"| 0x3C<br />
|rowspan="4"| Play<br />
|rowspan="4"| Client<br />
| Score Name<br />
| String<br />
| The name of the score to be updated or removed<br />
|-<br />
| Action<br />
| Byte<br />
| 0 to create/update an item. 1 to remove an item.<br />
|-<br />
| Objective Name<br />
| String<br />
| The name of the objective the score belongs to<br />
|-<br />
| Value<br />
| Optional VarInt<br />
| The score to be displayed next to the entry. Only sent when Action does not equal 1.<br />
|}<br />
<br />
==== 显示计分板 ====<br />
<br />
This is sent to the client when it should display a scoreboard.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="2"| 0x3D<br />
|rowspan="2"| Play<br />
|rowspan="2"| Client<br />
| Position<br />
| Byte<br />
| The position of the scoreboard. 0: list, 1: sidebar, 2: below name.<br />
|-<br />
| Score Name<br />
| String<br />
| The unique name for the scoreboard to be displayed.<br />
|}<br />
<br />
==== 团队 ====<br />
<br />
Creates and updates teams.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="10"| 0x3E<br />
|rowspan="10"| Play<br />
|rowspan="10"| Client<br />
| Team Name<br />
| String<br />
| A unique name for the team. (Shared with scoreboard).<br />
|-<br />
| Mode<br />
| Byte<br />
| If 0 then the team is created.<br />
<br />
If 1 then the team is removed. <br />
<br />
If 2 the team team information is updated. <br />
<br />
If 3 then new players are added to the team. <br />
<br />
If 4 then players are removed from the team.<br />
|-<br />
| Team Display Name<br />
| Optional String<br />
| Only if Mode = 0 or 2.<br />
|-<br />
| Team Prefix<br />
| Optional String<br />
| Only if Mode = 0 or 2. Displayed before the players' name that are part of this team<br />
|-<br />
| Team Suffix<br />
| Optional String<br />
| Only if Mode = 0 or 2. Displayed after the players' name that are part of this team<br />
|-<br />
| Friendly Fire<br />
| Optional Byte<br />
| Only if Mode = 0 or 2. 0 for off, 1 for on, 3 for seeing friendly invisibles<br />
|-<br />
| Name Tag Visibility<br />
| Optional String<br />
| Only if Mode = 0 or 2. always, hideForOtherTeams, hideForOwnTeam, never<br />
|-<br />
| Color<br />
| Optional Byte<br />
| Only if Mode = 0 or 2. Same as [[Chat]] colors<br />
|-<br />
| Player Count<br />
| Optional VarInt<br />
| Only if Mode = 0 or 3 or 4. Number of players in the array<br />
|-<br />
| Players<br />
| Optional Array of String<br />
| Only if Mode = 0 or 3 or 4. Players to be added/remove from the team. Max 40 characters so may be uuid's later<br />
|}<br />
<br />
==== 插件信息 ====<br />
<br />
Mods and plugins can use this to send their data. Minecraft itself uses a number of [[plugin channel]]s. These internal channels are prefixed with <code>MC|</code>.<br />
<br />
More documentation on this: [http://dinnerbone.com/blog/2012/01/13/minecraft-plugin-channels-messaging/ http://dinnerbone.com/blog/2012/01/13/minecraft-plugin-channels-messaging/]<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="2"| 0x3F<br />
|rowspan="2"| Play<br />
|rowspan="2"| Client<br />
| Channel<br />
| String<br />
| Name of the [[plugin channel]] used to send the data<br />
|-<br />
| Data<br />
| Byte Array<br />
| Any data, depending on the channel. <code><nowiki>MC|</nowiki></code> channels are documented [[plugin channel|here]].<br />
|}<br />
<br />
==== 断开连接 ====<br />
<br />
Sent by the server before it disconnects a client. The server assumes that the sender has already closed the connection by the time the packet arrives.<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
| 0x40<br />
|rowspan="1"| Play<br />
|rowspan="1"| Client<br />
| Reason<br />
| [[Chat]]<br />
| Displayed to the client when the connection terminates.<br />
|}<br />
<br />
==== 服务器难度 ====<br />
<br />
Changes the difficulty setting in the client's option menu<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="1"| 0x41<br />
|rowspan="1"| Play<br />
|rowspan="1"| Client<br />
| Difficulty<br />
| Unsigned Byte<br />
| 0: peaceful, 1: easy, 2: normal, 3: hard<br />
|}<br />
<br />
==== 战斗事件 ====<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="6"| 0x42<br />
|rowspan="6"| Play<br />
|rowspan="6"| Client<br />
| Event<br />
| VarInt<br />
| 0: enter combat, 1: end combat, 2: entity dead<br />
|-<br />
| Duration<br />
| Optional VarInt<br />
| Only for end combat<br />
|-<br />
| Player ID<br />
| Optional VarInt<br />
| Only for entity dead<br />
|-<br />
| Entity ID<br />
| Optional Int<br />
| Only for end combat and entity dead<br />
|-<br />
| Message<br />
| String<br />
| Only for entity dead<br />
|}<br />
<br />
==== 摄像机 ====<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="1"| 0x43<br />
|rowspan="1"| Play<br />
|rowspan="1"| Client<br />
| Camera ID<br />
| VarInt<br />
| <br />
|}<br />
<br />
==== 世界边界 ==== <br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
!colspan="2"| Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="18"| 0x44<br />
|rowspan="18"| Play<br />
|rowspan="18"| Client<br />
|colspan="2"| Action<br />
| VarInt<br />
| Determines the format of the rest of the packet<br />
|-<br />
! Action<br />
! Field Name<br />
! <br />
! <br />
|-<br />
| 0: set size<br />
| Radius<br />
| Double<br />
| meters<br />
|-<br />
|rowspan="3"| 1: lerp size<br />
| Old Radius<br />
| Double<br />
| meters<br />
|-<br />
| New Radius<br />
| Double<br />
| meters<br />
|-<br />
| Speed<br />
| VarLong<br />
| number of real-time ticks/seconds (?) until New Radius is reached. From experiments, it appears that Notchian server does not sync world border speed to game ticks, so it gets out of sync with server lag<br />
|-<br />
|rowspan="2"| 2: set center<br />
| X<br />
| Double<br />
| <br />
|-<br />
| Z<br />
| Double<br />
| <br />
|-<br />
|rowspan="8"| 3: initialize<br />
| X<br />
| Double<br />
| <br />
|-<br />
| Z<br />
| Double<br />
| <br />
|-<br />
| Old Radius<br />
| Double<br />
| <br />
|-<br />
| New Radius<br />
| Double<br />
| <br />
|-<br />
| Speed<br />
| VarLong<br />
| <br />
|-<br />
| Portal Teleport Boundary<br />
| VarInt<br />
| Resulting coordinates from a portal teleport are limited to +-value. Usually 29999984.<br />
|-<br />
| Warning Time<br />
| VarInt<br />
| <br />
|-<br />
| Warning Blocks<br />
| VarInt<br />
| <br />
|-<br />
|rowspan="1"| 4: set warning time<br />
| Warning Time<br />
| VarInt<br />
| unit?<br />
|-<br />
|rowspan="1"| 5: set warning blocks<br />
| Warning Blocks<br />
| VarInt<br />
| <br />
|}<br />
<br />
==== 显示标题 ==== <br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
!colspan="2"| Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="9"| 0x45<br />
|rowspan="9"| Play<br />
|rowspan="9"| Client<br />
|colspan="2"| Action<br />
| VarInt<br />
| <br />
|-<br />
! Action<br />
! Field Name<br />
! <br />
! <br />
|-<br />
| 0: set title<br />
| Title Text<br />
| [[Chat]]<br />
| <br />
|-<br />
| 1: set subtitle<br />
| Subtitle Text<br />
| [[Chat]]<br />
| <br />
|-<br />
|rowspan="3"| 2: set times and display<br />
| Fade In<br />
| Int<br />
| ticks<br />
|-<br />
| Stay<br />
| Int<br />
| ticks<br />
|-<br />
| Fade Out<br />
| Int<br />
| ticks<br />
|-<br />
| 3: hide<br />
| ''no fields''<br />
| ''no fields''<br />
| <br />
|-<br />
| 4: reset<br />
| ''no fields''<br />
| ''no fields''<br />
| <br />
|}<br />
<br />
“Hide” makes the title disappear, but if you run times again the same title will appear. “Reset” erases the text.<br />
<br />
==== 设置压缩 ====<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="1"| 0x46<br />
|rowspan="1"| Play<br />
|rowspan="1"| Client<br />
| Threshold<br />
| VarInt<br />
| Packets of this size or higher may be compressed<br />
|}<br />
<br />
==== 玩家列表页眉与页脚 ====<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="2"| 0x47<br />
|rowspan="2"| Play<br />
|rowspan="2"| Client<br />
| Header<br />
| [[Chat]]<br />
| <br />
|-<br />
| Footer<br />
| [[Chat]]<br />
| <br />
|}<br />
<br />
==== 发送资源包 ==== <br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="2"| 0x48<br />
|rowspan="2"| Play<br />
|rowspan="2"| Client<br />
| URL<br />
| String<br />
| The URL to the resource pack.<br />
|-<br />
| Hash<br />
| String<br />
| A 40 character hexadecimal and lowercase [[wikipedia:SHA-1|SHA-1]] hash of the resource pack file. (must be lower case in order to work)<br />If it's not a 40 character hexadecimal string, the client will not use it for hash verification and likely waste bandwidth — but it will still treat it as a unique id<br />
|}<br />
<br />
==== 更新实体 NBT ==== <br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="2"| 0x49<br />
|rowspan="2"| Play<br />
|rowspan="2"| Client<br />
| Entity ID<br />
| VarInt<br />
| <br />
|-<br />
| Tag<br />
| [[NBT|NBT Tag]]<br />
| <br />
|}<br />
<br />
=== 发送到服务器 ===<br />
<br />
==== 保持连接 ====<br />
<br />
服务器会经常发送一个保持连接包，内含一个随机的ID。客户端必须回应同样的包。<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="1"| 0x00<br />
|rowspan="1"| Play<br />
|rowspan="1"| Server<br />
| Keep Alive ID<br />
| VarInt<br />
| <br />
|}<br />
<br />
==== 聊天信息 ====<br />
<br />
默认服务端会检查信息是否以 '/' 开头。如果不是是，发送者的用户名将被放在消息前并且发送到所有其他客户端（包括原始的发送者）。如果是，服务端认为它是一个命令并尝试处理它。一个长度大于 100 的信息会导致服务端踢出该客户端。这个行为一开始是在不修改服务端的前提下不允许客户端不分段发送长度超过 119（以前的限制）的信息。因为这个原因，原始的服务端保留了在 119 处将消息切片的代码，但是这不是一个协议限制并且可以被跳过。<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="1"| 0x01<br />
|rowspan="1"| Play<br />
|rowspan="1"| Server<br />
| Message<br />
| String<br />
| The client sends the raw input, not [[Chat]]<br />
|}<br />
<br />
==== 使用实体 ====<br />
<br />
这个包在玩家攻击或者右键点击其他实体（一个玩家、矿车等）时从客户端发往服务器。<br />
<br />
一个官方服务端只在被攻击或使用的实体是可视的、在以玩家为中心 4单位 的范围内且与玩家之间没有阻碍时才接受这个包。<br />
<br />
注意：创造模式的中键点击会被客户端解析且被发送为 [[#Creative Inventory Action|创造背包动作]] 包。<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="5"| 0x02<br />
|rowspan="5"| Play<br />
|rowspan="5"| Server<br />
| Target<br />
| VarInt<br />
| <br />
|-<br />
| Type<br />
| VarInt<br />
| 0: interact, 1: attack, 2: interact at<br />
|-<br />
| Target X<br />
| Optional Float<br />
| Only if Type is interact at<br />
|-<br />
| Target Y<br />
| Optional Float<br />
| Only if Type is interact at<br />
|-<br />
| Target Z<br />
| Optional Float<br />
| Only if Type is interact at<br />
|}<br />
<br />
==== 玩家状态 ====<br />
<br />
这个包用于表明玩家正在陆地上（行走/游泳）还是在空中（跳跃/掉落）。<br />
<br />
当从足够高的高度掉落，这个状态从 false 设置为 true 时会受到掉落伤害。受到伤害的数值基于最后状态从 true 设置为 false。 注意有一些运动相关的包包含了这个包。<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="1"| 0x03<br />
|rowspan="1"| Play<br />
|rowspan="1"| Server<br />
| On Ground<br />
| Boolean<br />
| True 如果玩家在陆地上，否则为 false<br />
|}<br />
<br />
==== 玩家坐标 ====<br />
<br />
更新玩家在服务器上的 XYZ 坐标。<br />
<br />
如果在服务器上最后记录的位置和这个包设置的新位置之间的距离大于 100 单位，将会导致客户端因为 “You moved too quickly :( (Hacking?)” 而被踢出服务器。<br />
<br />
如果之间的距离大于 10 单位，服务器会在日志中写下警告信息 “<name> moved too quickly!” 和两个三元坐标（可能是运动增量？），但不会踢出客户端。<br />
<br />
如果 X 或 Z 的定点数被设置大于 3.2×10<sup>7</sup> 客户端会因为 “Illegal position” 而被踢出服务器。<br />
<br />
{| class="wikitable"<br />
! Packet ID<br />
! State<br />
! Bound To<br />
! Field Name<br />
! Field Type<br />
! Notes<br />
|-<br />
|rowspan="4"| 0x04<br />
|rowspan="4"| Play<br />
|rowspan="4"| Server<br />
| X<br />
| Double<br />
| 绝对位置<br />
|-<br />
| Feet Y<br />
| Double<br />
| 绝对位置，史蒂夫头部一般在 Y - 1.62<br />
|-<br />
| Z<br />
| Double<br />
| 绝对位置<br />
|-<br />
| On Ground<br />
| Boolean<br />
| 当对象站在地上时为 true , 反之则为 false<br />
|}<br />
<br />
==== 玩家观察 ====<br />
[[File:Minecraft-trig-yaw.png|thumb|The unit circle for yaw]]<br />
[[File:Yaw.png|thumb|The unit circle of yaw, redrawn]]<br />
<br />
更新玩家目前所看的方向。<br />
<br />
偏航（Yaw）以度为单位，并且不遵循经典的三角规则。</div>
梦彗業
https://mineplugin.org/index.php?title=Authme&diff=4063
Authme
2016-09-30T10:54:57Z
<p>梦彗業：/* 介绍 */</p>
<hr />
<div>{{Plugin<br />
|version=v未知<br />
|URL=http://dev.bukkit.org/bukkit-plugins/authme/<br />
}}<br />
[[Category:娱乐]]<br />
== 综述 ==<br />
=== 介绍 ===<br />
AuthMe Reloaded<br />
一个注册/登陆插件！<br />
特别是防止被盗号，自动通过UUID更新ID<br />
AuthMe Reloaded可以防止在未登录的情况下放置方块、移动、使用其他命令，或者查看当前的在线玩家数。<br />
只有输入正确的密码才能正常登陆<br />
登陆失败可能是你没有在指定时间内登陆<br />
每个命令和每个设置都可以用极其简单的配置文件来启用或者禁用<br />
如果你不喜欢英语，或者不喜欢作者的翻译，你也可以轻松的自主编辑语言环境！<br />
[https://github.com/AuthMe/AuthMeReloaded Github]<br />
<br />
=== 特点 ===<br />
可以通过电子邮件找回密码<br />
用户名保护<br />
国家选择！[http://dev.bukkit.org/bukkit-plugins/authme-reloaded/pages/countries-codes/ （国家代码）]<br />
AntiBot功能！<br />
Passpartu管理员功能：管理员可以设置查看所有用户账户信息。[http://dev.bukkit.org/server-mods/authme-reloaded/pages/how-to-install-and-initial-configuration/ 更多查看这里]<br />
没有“已经在另外位置登陆”消息登陆会话<br />
可编辑和设置信息<br />
支持MySQL、flatfile和Sqlite<br />
支持的散列算法：MD5、SHA1、SHA256、[https://github.com/CypherX/xAuth/wiki/Password-Hashing xAuth]、[http://en.wikipedia.org/wiki/Whirlpool_(cryptography) Whirlpool]<br />
支持纯文本密码储存<br />
支持PHOBB、VBulletin论坛注册：MD5VB - PHPBB<br />
支持MyBB：MyBB<br />
支持IPB3：IPB3<br />
支持PhpFisuon：PHPFISUON<br />
支持Xenforo SHA1：XFSHA1<br />
支持Xenforo SHA256：XFSHA256<br />
支持joomal：JOOMAL<br />
支持WBB3：WBB3*<br />
支持SHA512：SHA512<br />
支持DoubleSaltedMD5密码：SALTED2MD5<br />
支持WordPass集成和密码：WORDPASS<br />
定制MySQL列表（可用论坛和其他脚本）<br />
数据库查询可用被缓存<br />
兼容NPC和战墙插件<br />
兼容MC Mods，例如BuildCraft和RedStonCraft<br />
可以限制一个ip可以注册的账号数上限<br />
未登录没有指定权限<br />
注册和未注册的有不同的权限组<br />
支持权限在登陆瞬间的改变<br />
缓存玩家物品，包括所有物品和附魔<br />
保存退出位置，以避免损失位置信息<br />
不可以使用权限插件<br />
持续弹出登陆界面<br />
您的所有用户信息和密码备份储存<br />
该FLATFILE auths.db转换为有用的authme.sql，你可以在MySql数据库使用！<br />
从Rakamak或XAUTH导入您的数据库<br />
<br />
=== 权限&指令 ===<br />
==== 权限 ====<br />
authme.player.* 所有用户命令<br />
authme.admin.* 管理员命令<br />
authme.* 所有用户和管理员命令<br />
<br />
==== 指令 ====<br />
===== 玩家指令 =====<br />
指令 权限 默认<br />
/register authme.register true<br />
/login authme.login true<br />
/logout authme.logout ture<br />
/changepassword authme.changepassword false<br />
/unregister autheme.unregister true<br />
===== 管理员指令 =====<br />
指令 权限 默认<br />
/authme register authme.admin.register op<br />
/authme unregister authme.admin.unregister op<br />
/authme reload authme.admin.reload op<br />
/authme changepassword authme.admin.changepassword op<br />
/authme convertflattosql authme.admin.convertflattosql op<br />
<br />
=== 配置 ===<br />
#存储设置<br />
DataSource:<br />
# 你想使用哪种数据库来存储？ sqlite为文件存储<br />
# 可选的值: sqlite, mysql<br />
backend: sqlite<br />
# 是否启用数据库缓存，以提高数据库性能 无需更改<br />
caching: true<br />
# 数据库地址 如果是本机就写127.0.0.1 如果是云端数据库就写ip或者域名<br />
mySQLHost: 127.0.0.1<br />
# 数据库端口号<br />
mySQLPort: '3306'<br />
# 用于连接数据库的用户名(Username)<br />
mySQLUsername: authme<br />
# 用于连接数据库的密码(Password)<br />
mySQLPassword: '12345'<br />
# 数据库名字，或者SQLITE的文件名<br />
mySQLDatabase: authme<br />
# 数据库表名<br />
mySQLTablename: authme<br />
# 用户ID列的名字<br />
mySQLColumnId: id<br />
# 玩家名或昵称列的名字<br />
mySQLColumnName: username<br />
# 密码列的名字<br />
mySQLColumnPassword: password<br />
# 邮箱列的名字<br />
mySQLColumnEmail: email<br />
# 用于存储玩家是否登录的列的名字<br />
mySQLColumnLogged: isLogged<br />
# 玩家ip列的名字<br />
mySQLColumnIp: ip<br />
# 玩家最后登录时间列的名字<br />
mySQLColumnLastLogin: lastlogin<br />
# 最后退出坐标 - X 列的名字<br />
mySQLlastlocX: x<br />
# 最后退出坐标 - Y 列的名字<br />
mySQLlastlocY: y<br />
# 最后退出坐标 - Z 列的名字<br />
mySQLlastlocZ: z<br />
# 最后退出世界 的 世界名字 列的名字<br />
mySQLlastlocWorld: world<br />
# 真实名字列的名字<br />
mySQLRealName: realname<br />
# 如果你想要启用网站注册请开启此项<br />
mySQLWebsite: false<br />
#普通设置<br />
settings:<br />
# 在“帮助”消息中显示的名字<br />
helpHeader: AuthMeReloaded<br />
sessions:<br />
# 你想启用会话缓存(session)功能吗？<br />
# 如果启用，当玩家成功验证后<br />
# 他的IP和昵称将会被存储<br />
# 当他下次进入服务器时，如果他的IP与上次相同<br />
# 并且没有超过下面那项设置的时间<br />
# 他可以不用重新登录<br />
enabled: false<br />
# 几分钟后会话(session)会过期？<br />
# 0 为无限时间 (非常危险，请注意这样设置的风险)<br />
# 此项只决定会话(session)时间, 如果玩家IP改变<br />
# 但是会话(session)没有超时<br />
# 玩家将会由于 “无效的会话” 而被踢出服务器<br />
# 单位是 分钟 <br />
timeout: 10<br />
# 是否在玩家使用别的IP登陆时关闭会话(session)？（就是换ip需要重新验证）<br />
# 建议为true<br />
sessionExpireOnIpChange: true<br />
restrictions:<br />
# 为注册/登录的玩家能否聊天和看到别人聊天？（此项可以防止小白吧密码发出去）<br />
# 注意，将不能使用所有不在下面的<br />
# 命令列表里的命令<br />
allowChat: false<br />
# 警告: 请只在你需要的时候考虑此项<br />
# 如果注册不是强制的 允许未登录用户使用所有命令<br />
allowAllCommandsIfRegistrationIsOptional: false<br />
# 在未验证时允许的命令<br />
allowCommands:<br />
- /login<br />
- /register<br />
- /l<br />
- /reg<br />
- /email<br />
- /captcha<br />
# 每个IP允许注册的账号的最大数目 (默认为: 1)<br />
maxRegPerIp: 1<br />
# 最大用户名长度<br />
maxNicknameLength: 16<br />
# 如果启用此项， 当前在线的玩家将不会被<br />
# "另一位置登录的玩家" 踢出<br />
# 这能提高安全性 但是卡的时候可能会出现 同名玩家已经在游戏<br />
ForceSingleSession: true<br />
# 如果启用， 每当玩家验证成功后<br />
# 都会被传送到世界的出生点<br />
# 玩家退出位置会被覆盖<br />
# 这个与 "传送未登陆的玩家到出生点(teleportUnAuthedToSpawn)" 不同<br />
# 此选项在玩家登录后也会传送<br />
ForceSpawnLocOnJoinEnabled: false<br />
# 此选项将会保存玩家退出位置<br />
SaveQuitLocation: false<br />
# 启用此项将限制<br />
# 指定ID/IP的用户<br />
# 下面是个例子<br />
AllowRestrictedUser: false<br />
# 符合以下id或ip的受限<br />
# 用户将无法进入服务器<br />
# 默认的例子:<br />
# AllowedRestrictedUser:<br />
# - playername;127.0.0.1 <br />
AllowedRestrictedUser:<br />
- playername;127.0.0.1<br />
# 是否踢出未注册的玩家<br />
kickNonRegistered: false<br />
# 是否在玩家输错密码时踢出<br />
kickOnWrongPassword: false<br />
# 是否传送未登陆的玩家到出生点？<br />
# 当他们登陆后他们会被<br />
# 传送回原来的位置 开启后可以防止卡位置<br />
teleportUnAuthedToSpawn: false<br />
# 昵称最小允许长度<br />
minNicknameLength: 4<br />
# 未注册的玩家可以走动吗？<br />
allowMovement: false<br />
# 是否设置未验证的玩家速度 =0？<br />
# 登陆后 飞行/行走 速度将恢复正常<br />
removeSpeed: true<br />
# 在提示 注册/登陆 多久后踢出玩家？<br />
# 设置未0禁用<br />
timeout: 30<br />
# 玩家名字所允许的正则表达式 中文的表达式：[\u4E00-\u9FA5]*或[一-龥]*<br />
allowedNicknameCharacters: '[a-zA-Z0-9_]*'<br />
# 未注册的玩家可以走多远？<br />
# 设为0则无限半径<br />
allowedMovementRadius: 100<br />
# 时候启用双密码验证注册？<br />
# 如果设置为 true 注册时就需要使用：<br />
# /register <密码> <重复密码><br />
enablePasswordConfirmation: true<br />
# 是否在玩家登陆前保存玩家的库存? 需要 ProtocolLib 前置 登陆之前无物品<br />
ProtectInventoryBeforeLogIn: true<br />
# 是否在登录前拒绝玩家使用TAB列表？ 需要 ProtocolLib 前置<br />
DenyTabCompleteBeforeLogin: true<br />
# 是否在玩家登录前隐藏TAB列表？ 需要 ProtocolLib 前置<br />
HideTablistBeforeLogin: true<br />
# 是否在玩家登录是显示其他几个他的账号？<br />
# 权限: /authme.admin.accounts<br />
displayOtherAccounts: true<br />
# ForceSpawnLocOnJoinEnabled 项中那些世界会强制出生点登录<br />
# 区分大小写<br />
ForceSpawnOnTheseWorlds:<br />
- world<br />
- world_nether<br />
- world_the_end<br />
# 当ip没有注册在数据库时，封禁该ip<br />
banUnsafedIP: false<br />
# 出生点优先级， 可选值 : authme, essentials, multiverse, default<br />
spawnPriority: authme,essentials,multiverse,default<br />
# 一个IP可以登录的账号最大数量<br />
maxLoginPerIp: 0<br />
# 一个IP可以加入游戏最大数量<br />
maxJoinPerIp: 0<br />
# 开启后 AuthMe 将绝对不会传送玩家！<br />
noTeleport: false<br />
# 密码允许的字符的正则表达式 不建议更改<br />
allowedPasswordCharacters: '[\x21-\x7E]*'<br />
GameMode:<br />
# 是否在加入游戏时强制生存模式<br />
ForceSurvivalMode: false<br />
security:<br />
# 密码最小长度<br />
minPasswordLength: 5<br />
# 密码最大长度<br />
passwordMaxLength: 30<br />
# 这是一个非常重要的选项，<br />
# 每次玩家加入服务器，<br />
# 如果他们已经注册, AuthMe 将会吧他们移动<br />
# 到未登陆组, 这应该能<br />
# 防止所有重大漏洞<br />
# 你可以在你的权限插件里<br />
# 设置这个特殊的分组，并且拥有 0 个权限， 或只有聊天权限，<br />
# 或者可以发送私人消息<br />
# 或其他消息，以及其他任何你想要设置的权限<br />
# 最好是将这个组设置为<br />
# 只有很少的权限，<br />
# 当某些玩家尝试利用一些不属于他们的账户，<br />
# 他们将只能做你设置过权限的事<br />
# 当他们登陆后，他们会被<br />
# 移动到正常的权限组！<br />
# 注意组名是区分大小写的<br />
# 所以 Admin ≠ admin，<br />
# 否则你的分组将会被抹除,<br />
# 玩家将加入默认的分组 [] 中!<br />
# 例如： unLoggedinGroup: NotLogged<br />
unLoggedinGroup: unLoggedinGroup<br />
# 密码加密算法<br />
# 可以设置的值: MD5, SHA1, SHA256, WHIRLPOOL, XAUTH, MD5VB, PHPBB,<br />
# MYBB, IPB3, IPB4, PHPFUSION, SMF, XENFORO, SALTED2MD5, JOOMLA, BCRYPT, WBB3, SHA512,<br />
# DOUBLEMD5, PBKDF2, PBKDF2DJANGO, WORDPRESS, ROYALAUTH, CUSTOM(开发者限定)<br />
passwordHash: SHA256<br />
# SALTED2MD5 盐度 MD5(MD5(密码)+混搅盐) <br />
doubleMD5SaltLength: 8<br />
# 如果密码检测返回为 false， 是否需要检测一遍<br />
# 其他密码算法来检查这个旧密码？<br />
# AuthMe 将会吧这个密码更新为新的密码加密算法<br />
supportOldPasswordHash: false<br />
# 禁止使用的不安全密码， 请写小写！ 可以防止小白直接写上密码两个字<br />
# 例子：<br />
#unsafePasswords:<br />
#- '123456'<br />
#- '密码'<br />
#- 'password'<br />
unsafePasswords:<br />
- '123456'<br />
- 'password'<br />
- '密码'<br />
- 'qwerty'<br />
- '12345'<br />
- '54321'<br />
registration:<br />
# 是否开放注册？<br />
enabled: true<br />
# 每 X 秒发送一条叫玩家 注册/登录<br />
# 的消息给玩家<br />
messageInterval: 5<br />
# 只有注册玩家可以玩<br />
# 请查看 restrictions 免责条款<br />
force: true<br />
# 是否用邮箱注册来代替密码注册？<br />
enableEmailRegistrationSystem: false<br />
# 是否启用邮箱双重验证<br />
# 当它开启后，注册是否的命令会是：<br />
# /register <邮箱l> <再次输入邮箱><br />
doubleEmailCheck: false<br />
# 是否在注册后踢出玩家？<br />
# 不使用登录功能<br />
forceKickAfterRegister: false<br />
# 是否让 AuthMe 在玩家成功注册后自动执行 /login ？<br />
forceLoginAfterRegister: false<br />
unrestrictions:<br />
# 你可以在下面列出<br />
# AuthMe 将会忽略注册或登录的账户名<br />
# 配置它你需要自己承担风险！！<br />
# 如果你要吧昵称加进 [], 你需要用 ' '括起来.<br />
# 此选项是为了 BuildCraft 和一些其他<br />
# 插件或者mod的兼容性<br />
# 区分大小写！！<br />
UnrestrictedName: []<br />
# 消息语言，可选值 : en, de, br, cz, pl, fr, ru, hu, sk, es, zhtw, fi, zhcn, lt, it, ko, pt 中文请设置zhcn<br />
messagesLanguage: en<br />
# 强制这些命令在 /login 后才可使用，不需要任何 '/' ，并且使用%代替玩家名称<br />
forceCommands: []<br />
# 强制这些后台命令在 /login 后才可使用，不需要任何 '/' ，并且使用%代替玩家名称<br />
forceCommandsAsConsole: []<br />
# 强制这些命令在 /register, 后才可使用，不需要任何 '/' ，并且使用%代替玩家名称<br />
forceRegisterCommands: []<br />
# 强制这些后台命令在 /register, 后才可使用，不需要任何 '/' ，并且使用%代替玩家名称<br />
forceRegisterCommandsAsConsole: []<br />
# 是否需要在登录或者注册后显示欢迎消息(welcome.txt)？<br />
# 你可以在 welcome.txt + 使用不同的颜色和一些替换符号 :<br />
# {PLAYER} : 玩家名， {ONLINE} : 显示在线人数， {MAXPLAYERS} : 显示服务器最大人数，<br />
# {IP} : 玩家IP， {LOGINS} : 登录的玩家数， {WORLD} : 玩家当前所在的世界名， {SERVER} : 服务器名<br />
# {VERSION} : 当前服务器版本， {COUNTRY} : 玩家的国家<br />
useWelcomeMessage: true<br />
# 是向全服广播 welcome.txt 还是只对登录的玩家显示？ 设置为false将只对登录的玩家显示<br />
broadcastWelcomeMessage: false<br />
# 是否延迟加入游戏消息在玩家登录后才显示？<br />
delayJoinMessage: true<br />
# 是否移除加入游戏的消息？<br />
removeJoinMessage: true<br />
# 是否移除离开游戏的消息？<br />
removeLeaveMessage: true<br />
# 是否在登录或者注册前加入药水效果？ 此条可以设置登录前失明<br />
applyBlindEffect: false<br />
# 是否阻止不同态玩家名的登录？<br />
# 如果 Xephi 注册了， 然后 Xephi 能登录， 但是 XEPHI/xephi/XePhI 不能<br />
preventOtherCase: false<br />
#以下为高级设置内容<br />
#外部关联相关设置<br />
ExternalBoardOptions:<br />
# 需要加密的 MySQL 列， 某些 论坛/cms 需要此项支持<br />
mySQLColumnSalt: ''<br />
# 需要分组的 MySQL 列， 某些 论坛/cms 需要此项支持<br />
mySQLColumnGroup: ''<br />
# -1 为不使用。 如果你想要只有<br />
# 已经激活的用户能登录你的服务器<br />
# 你可以在这里写下你的用户组数<br />
# 某些 论坛/cms 需要此项支持<br />
nonActivedUserGroup: -1<br />
# 其他的需要放用户名的 MySQL 列 (区分大小写)<br />
mySQLOtherUsernameColumns: []<br />
# 在 BCrypt 计算多少轮(如果你不知道它是干什么的不要修改它) (bcrypt，是一个跨平台的文件加密工具)<br />
bCryptLog2Round: 10<br />
# 在 phpBB 安装过程中定义的 phpbb 前缀<br />
phpbbTablePrefix: 'phpbb_'<br />
# phpBB 激活组的 id， 2 是 phpbb 默认定义的注册组<br />
phpbbActivatedGroupId: 2<br />
# 在 WordPress 安装过程中定义的 WordPress 前缀<br />
wordpressTablePrefix: 'wp_'<br />
#权限<br />
permission:<br />
# 注意这个选项，如果你不想<br />
# 使用Vault 和Group Switching<br />
# 来区分 AuthMe 的未登陆组，设置为 true<br />
# 否则，默认为 false<br />
EnablePermissionCheck: false<br />
#备份<br />
BackupSystem:<br />
# 启用或者禁用自动备份<br />
ActivateBackup: false<br />
# 是否每次开服都会备份<br />
OnServerStart: false<br />
# 是否每次关服都会备份<br />
OnServerStop: true<br />
# Windows 下 mysql 的安装路径<br />
MysqlWindowsPath: 'C:\\Program Files\\MySQL\\MySQL Server 5.1\\'<br />
#安全<br />
Security:<br />
SQLProblem:<br />
# 如果和数据库断开连接就关服<br />
# 要考虑这个， 如果你设置这个为 false，<br />
# AuthMe 将自动禁用，并且服务器将失去保护！<br />
stopServer: true<br />
ReloadCommand:<br />
# 是否支持 /reload <br />
useReloadCommandSupport: true<br />
console:<br />
# 不在控制台显示消息<br />
noConsoleSpam: false<br />
# 在控制台更换密码是要像玩家那样输入 /login<br />
removePassword: true<br />
# 是否吧AuthMe的记录文件放在单独的文件夹？<br />
logConsole: true<br />
captcha:<br />
# 在玩家输错太多次后他将需要输入验证码<br />
useCaptcha: false<br />
# 在多少次后要求验证码<br />
maxLoginTry: 5<br />
# 验证码长度<br />
captchaLength: 5<br />
stop:<br />
# 在服务器关闭之前踢出所有玩家， 这样能够保存玩家的位置，并且所有<br />
# 信息都正确正常无任何错误<br />
kickPlayersBeforeStopping: true<br />
#转换<br />
Converter:<br />
Rakamak:<br />
# Rakamak 文件名<br />
fileName: users.rak<br />
# Rakamak 使用 ip ?<br />
useIP: false<br />
# rakamak IP 文件名<br />
ipFileName: UsersIp.rak<br />
CrazyLogin:<br />
# CrazyLogin 数据库文件<br />
fileName: accounts.db<br />
#邮件<br />
Email:<br />
# 电子邮件的SMTP服务器主机名<br />
mailSMTP: smtp.gmail.com<br />
# 电子邮件的SMTP服务器主机端口<br />
mailPort: 465<br />
# 发送邮件的账户<br />
mailAccount: ''<br />
# 邮箱密码<br />
mailPassword: ''<br />
# 自定义发件人的名字，这名字将会代替邮箱显示<br />
mailSenderName: ''<br />
# 随机密码长度<br />
RecoveryPasswordLength: 8<br />
# 邮件主题<br />
mailSubject: 'Your new AuthMe Password'<br />
# 有点像最大注册数但是是邮件的<br />
maxRegPerEmail: 1<br />
# 是否提醒玩家添加一个邮件地址？<br />
recallPlayers: false<br />
# 一分钟内提醒多少次<br />
delayRecall: 5<br />
# 邮箱域名黑名单<br />
emailBlacklisted:<br />
- 10minutemail.com<br />
# 邮箱域名白名单<br />
emailWhitelisted: []<br />
# 是否吧新密码画在图片中？<br />
generateImage: false<br />
# 邮件 OAuth 2 标记 (如果未使用则留空)<br />
emailOauth2Token: ''<br />
#关联<br />
Hooks:<br />
# 是否与 multiverse 的出生点关联？<br />
multiverse: true<br />
# 是否关联 BungeeCord ?（跨服)<br />
bungeecord: false<br />
# 在玩家注册/登录后将玩家发送到某个 BungeeCord 服务器 <br />
sendPlayerTo: ''<br />
# 是否在加入游戏时禁用 Essentials SocialSpy ？<br />
disableSocialSpy: true<br />
# 是否在加入游戏时禁用类似 /motd 的 Essentials 命令？<br />
useEssentialsMotd: false<br />
# 是否缓存 Attributes 自定义？<br />
customAttributes: false<br />
#清理<br />
Purge:<br />
# 如果启用，AuthMe将自动清理掉旧的，未使用的账户<br />
useAutoPurge: false<br />
# 多少天后变为未使用的账户<br />
daysBeforeRemovePlayer: 60<br />
# 是否在清理中顺便清理player.dat文件？<br />
removePlayerDat: false<br />
# 是否在清理中顺便清理 Essentials/users/player.yml 文件？<br />
removeEssentialsFile: false<br />
# 哪个世界存放了 players.dat <br />
defaultWorld: 'world'<br />
# 是否在清理中顺便清理 LimitedCreative/inventories/player.yml, player_creative.yml 文件？<br />
removeLimitedCreativesInventories: false<br />
# 是否在清理中顺便清理 AntiXRayData/PlayerData/player 文件？<br />
removeAntiXRayFile: false<br />
# 是否顺便清理权限？<br />
removePermissions: false<br />
#服务器保护<br />
Protection:<br />
# 启用后服务器将受到一些保护 ( 限制国家登录, 防压测 )<br />
enableProtection: false<br />
# 允许登录和注册的国家，国家代码详情见 http://dev.bukkit.org/bukkit-plugins/authme-reloaded/pages/countries-codes/ <br />
# 请使用引号！！<br />
countries:<br />
- 'US'<br />
- 'GB'<br />
# 黑名单的国家 (不需要启用 protection)<br />
# 请使用引号！！<br />
countriesBlacklist:<br />
- 'A1'<br />
# 是否启用反僵尸压测？<br />
enableAntiBot: false<br />
# 5秒内最大可以登录的玩家 如果启用反压测<br />
antiBotSensibility: 5<br />
# 在多少时间内自动启用反僵尸压测系统<br />
antiBotDuration: 10<br />
VeryGames:<br />
# 这条只是测试 VeryGames 服务器运营商的性能<br />
enableIpCheck: false<br />
<br />
`</div>
梦彗業
https://mineplugin.org/index.php?title=Authme&diff=4062
Authme
2016-09-30T10:53:01Z
<p>梦彗業：/* 权限 */</p>
<hr />
<div>{{Plugin<br />
|version=v未知<br />
|URL=http://dev.bukkit.org/bukkit-plugins/authme/<br />
}}<br />
[[Category:娱乐]]<br />
== 综述 ==<br />
=== 介绍 ===<br />
AuthMe Reloaded<br />
一个注册/登陆插件！<br />
特别是防止被盗号，自动通过UUID更新ID<br />
AuthMe Reloaded可以防止在未登录的情况下放置方块、移动、使用其他命令，或者查看当前的在线玩家数。<br />
只有输入正确的密码才能正常登陆<br />
登陆失败可能是你没有在指定时间内登陆<br />
每个命令和每个设置都可以用极其简单的配置文件来启用或者禁用<br />
如果你不喜欢英语，或者不喜欢作者的翻译，你也可以轻松的自主编辑语言环境！<br />
<br />
=== 特点 ===<br />
可以通过电子邮件找回密码<br />
用户名保护<br />
国家选择！[http://dev.bukkit.org/bukkit-plugins/authme-reloaded/pages/countries-codes/ （国家代码）]<br />
AntiBot功能！<br />
Passpartu管理员功能：管理员可以设置查看所有用户账户信息。[http://dev.bukkit.org/server-mods/authme-reloaded/pages/how-to-install-and-initial-configuration/ 更多查看这里]<br />
没有“已经在另外位置登陆”消息登陆会话<br />
可编辑和设置信息<br />
支持MySQL、flatfile和Sqlite<br />
支持的散列算法：MD5、SHA1、SHA256、[https://github.com/CypherX/xAuth/wiki/Password-Hashing xAuth]、[http://en.wikipedia.org/wiki/Whirlpool_(cryptography) Whirlpool]<br />
支持纯文本密码储存<br />
支持PHOBB、VBulletin论坛注册：MD5VB - PHPBB<br />
支持MyBB：MyBB<br />
支持IPB3：IPB3<br />
支持PhpFisuon：PHPFISUON<br />
支持Xenforo SHA1：XFSHA1<br />
支持Xenforo SHA256：XFSHA256<br />
支持joomal：JOOMAL<br />
支持WBB3：WBB3*<br />
支持SHA512：SHA512<br />
支持DoubleSaltedMD5密码：SALTED2MD5<br />
支持WordPass集成和密码：WORDPASS<br />
定制MySQL列表（可用论坛和其他脚本）<br />
数据库查询可用被缓存<br />
兼容NPC和战墙插件<br />
兼容MC Mods，例如BuildCraft和RedStonCraft<br />
可以限制一个ip可以注册的账号数上限<br />
未登录没有指定权限<br />
注册和未注册的有不同的权限组<br />
支持权限在登陆瞬间的改变<br />
缓存玩家物品，包括所有物品和附魔<br />
保存退出位置，以避免损失位置信息<br />
不可以使用权限插件<br />
持续弹出登陆界面<br />
您的所有用户信息和密码备份储存<br />
该FLATFILE auths.db转换为有用的authme.sql，你可以在MySql数据库使用！<br />
从Rakamak或XAUTH导入您的数据库<br />
<br />
=== 权限&指令 ===<br />
==== 权限 ====<br />
authme.player.* 所有用户命令<br />
authme.admin.* 管理员命令<br />
authme.* 所有用户和管理员命令<br />
<br />
==== 指令 ====<br />
===== 玩家指令 =====<br />
指令 权限 默认<br />
/register authme.register true<br />
/login authme.login true<br />
/logout authme.logout ture<br />
/changepassword authme.changepassword false<br />
/unregister autheme.unregister true<br />
===== 管理员指令 =====<br />
指令 权限 默认<br />
/authme register authme.admin.register op<br />
/authme unregister authme.admin.unregister op<br />
/authme reload authme.admin.reload op<br />
/authme changepassword authme.admin.changepassword op<br />
/authme convertflattosql authme.admin.convertflattosql op<br />
<br />
=== 配置 ===<br />
#存储设置<br />
DataSource:<br />
# 你想使用哪种数据库来存储？ sqlite为文件存储<br />
# 可选的值: sqlite, mysql<br />
backend: sqlite<br />
# 是否启用数据库缓存，以提高数据库性能 无需更改<br />
caching: true<br />
# 数据库地址 如果是本机就写127.0.0.1 如果是云端数据库就写ip或者域名<br />
mySQLHost: 127.0.0.1<br />
# 数据库端口号<br />
mySQLPort: '3306'<br />
# 用于连接数据库的用户名(Username)<br />
mySQLUsername: authme<br />
# 用于连接数据库的密码(Password)<br />
mySQLPassword: '12345'<br />
# 数据库名字，或者SQLITE的文件名<br />
mySQLDatabase: authme<br />
# 数据库表名<br />
mySQLTablename: authme<br />
# 用户ID列的名字<br />
mySQLColumnId: id<br />
# 玩家名或昵称列的名字<br />
mySQLColumnName: username<br />
# 密码列的名字<br />
mySQLColumnPassword: password<br />
# 邮箱列的名字<br />
mySQLColumnEmail: email<br />
# 用于存储玩家是否登录的列的名字<br />
mySQLColumnLogged: isLogged<br />
# 玩家ip列的名字<br />
mySQLColumnIp: ip<br />
# 玩家最后登录时间列的名字<br />
mySQLColumnLastLogin: lastlogin<br />
# 最后退出坐标 - X 列的名字<br />
mySQLlastlocX: x<br />
# 最后退出坐标 - Y 列的名字<br />
mySQLlastlocY: y<br />
# 最后退出坐标 - Z 列的名字<br />
mySQLlastlocZ: z<br />
# 最后退出世界 的 世界名字 列的名字<br />
mySQLlastlocWorld: world<br />
# 真实名字列的名字<br />
mySQLRealName: realname<br />
# 如果你想要启用网站注册请开启此项<br />
mySQLWebsite: false<br />
#普通设置<br />
settings:<br />
# 在“帮助”消息中显示的名字<br />
helpHeader: AuthMeReloaded<br />
sessions:<br />
# 你想启用会话缓存(session)功能吗？<br />
# 如果启用，当玩家成功验证后<br />
# 他的IP和昵称将会被存储<br />
# 当他下次进入服务器时，如果他的IP与上次相同<br />
# 并且没有超过下面那项设置的时间<br />
# 他可以不用重新登录<br />
enabled: false<br />
# 几分钟后会话(session)会过期？<br />
# 0 为无限时间 (非常危险，请注意这样设置的风险)<br />
# 此项只决定会话(session)时间, 如果玩家IP改变<br />
# 但是会话(session)没有超时<br />
# 玩家将会由于 “无效的会话” 而被踢出服务器<br />
# 单位是 分钟 <br />
timeout: 10<br />
# 是否在玩家使用别的IP登陆时关闭会话(session)？（就是换ip需要重新验证）<br />
# 建议为true<br />
sessionExpireOnIpChange: true<br />
restrictions:<br />
# 为注册/登录的玩家能否聊天和看到别人聊天？（此项可以防止小白吧密码发出去）<br />
# 注意，将不能使用所有不在下面的<br />
# 命令列表里的命令<br />
allowChat: false<br />
# 警告: 请只在你需要的时候考虑此项<br />
# 如果注册不是强制的 允许未登录用户使用所有命令<br />
allowAllCommandsIfRegistrationIsOptional: false<br />
# 在未验证时允许的命令<br />
allowCommands:<br />
- /login<br />
- /register<br />
- /l<br />
- /reg<br />
- /email<br />
- /captcha<br />
# 每个IP允许注册的账号的最大数目 (默认为: 1)<br />
maxRegPerIp: 1<br />
# 最大用户名长度<br />
maxNicknameLength: 16<br />
# 如果启用此项， 当前在线的玩家将不会被<br />
# "另一位置登录的玩家" 踢出<br />
# 这能提高安全性 但是卡的时候可能会出现 同名玩家已经在游戏<br />
ForceSingleSession: true<br />
# 如果启用， 每当玩家验证成功后<br />
# 都会被传送到世界的出生点<br />
# 玩家退出位置会被覆盖<br />
# 这个与 "传送未登陆的玩家到出生点(teleportUnAuthedToSpawn)" 不同<br />
# 此选项在玩家登录后也会传送<br />
ForceSpawnLocOnJoinEnabled: false<br />
# 此选项将会保存玩家退出位置<br />
SaveQuitLocation: false<br />
# 启用此项将限制<br />
# 指定ID/IP的用户<br />
# 下面是个例子<br />
AllowRestrictedUser: false<br />
# 符合以下id或ip的受限<br />
# 用户将无法进入服务器<br />
# 默认的例子:<br />
# AllowedRestrictedUser:<br />
# - playername;127.0.0.1 <br />
AllowedRestrictedUser:<br />
- playername;127.0.0.1<br />
# 是否踢出未注册的玩家<br />
kickNonRegistered: false<br />
# 是否在玩家输错密码时踢出<br />
kickOnWrongPassword: false<br />
# 是否传送未登陆的玩家到出生点？<br />
# 当他们登陆后他们会被<br />
# 传送回原来的位置 开启后可以防止卡位置<br />
teleportUnAuthedToSpawn: false<br />
# 昵称最小允许长度<br />
minNicknameLength: 4<br />
# 未注册的玩家可以走动吗？<br />
allowMovement: false<br />
# 是否设置未验证的玩家速度 =0？<br />
# 登陆后 飞行/行走 速度将恢复正常<br />
removeSpeed: true<br />
# 在提示 注册/登陆 多久后踢出玩家？<br />
# 设置未0禁用<br />
timeout: 30<br />
# 玩家名字所允许的正则表达式 中文的表达式：[\u4E00-\u9FA5]*或[一-龥]*<br />
allowedNicknameCharacters: '[a-zA-Z0-9_]*'<br />
# 未注册的玩家可以走多远？<br />
# 设为0则无限半径<br />
allowedMovementRadius: 100<br />
# 时候启用双密码验证注册？<br />
# 如果设置为 true 注册时就需要使用：<br />
# /register <密码> <重复密码><br />
enablePasswordConfirmation: true<br />
# 是否在玩家登陆前保存玩家的库存? 需要 ProtocolLib 前置 登陆之前无物品<br />
ProtectInventoryBeforeLogIn: true<br />
# 是否在登录前拒绝玩家使用TAB列表？ 需要 ProtocolLib 前置<br />
DenyTabCompleteBeforeLogin: true<br />
# 是否在玩家登录前隐藏TAB列表？ 需要 ProtocolLib 前置<br />
HideTablistBeforeLogin: true<br />
# 是否在玩家登录是显示其他几个他的账号？<br />
# 权限: /authme.admin.accounts<br />
displayOtherAccounts: true<br />
# ForceSpawnLocOnJoinEnabled 项中那些世界会强制出生点登录<br />
# 区分大小写<br />
ForceSpawnOnTheseWorlds:<br />
- world<br />
- world_nether<br />
- world_the_end<br />
# 当ip没有注册在数据库时，封禁该ip<br />
banUnsafedIP: false<br />
# 出生点优先级， 可选值 : authme, essentials, multiverse, default<br />
spawnPriority: authme,essentials,multiverse,default<br />
# 一个IP可以登录的账号最大数量<br />
maxLoginPerIp: 0<br />
# 一个IP可以加入游戏最大数量<br />
maxJoinPerIp: 0<br />
# 开启后 AuthMe 将绝对不会传送玩家！<br />
noTeleport: false<br />
# 密码允许的字符的正则表达式 不建议更改<br />
allowedPasswordCharacters: '[\x21-\x7E]*'<br />
GameMode:<br />
# 是否在加入游戏时强制生存模式<br />
ForceSurvivalMode: false<br />
security:<br />
# 密码最小长度<br />
minPasswordLength: 5<br />
# 密码最大长度<br />
passwordMaxLength: 30<br />
# 这是一个非常重要的选项，<br />
# 每次玩家加入服务器，<br />
# 如果他们已经注册, AuthMe 将会吧他们移动<br />
# 到未登陆组, 这应该能<br />
# 防止所有重大漏洞<br />
# 你可以在你的权限插件里<br />
# 设置这个特殊的分组，并且拥有 0 个权限， 或只有聊天权限，<br />
# 或者可以发送私人消息<br />
# 或其他消息，以及其他任何你想要设置的权限<br />
# 最好是将这个组设置为<br />
# 只有很少的权限，<br />
# 当某些玩家尝试利用一些不属于他们的账户，<br />
# 他们将只能做你设置过权限的事<br />
# 当他们登陆后，他们会被<br />
# 移动到正常的权限组！<br />
# 注意组名是区分大小写的<br />
# 所以 Admin ≠ admin，<br />
# 否则你的分组将会被抹除,<br />
# 玩家将加入默认的分组 [] 中!<br />
# 例如： unLoggedinGroup: NotLogged<br />
unLoggedinGroup: unLoggedinGroup<br />
# 密码加密算法<br />
# 可以设置的值: MD5, SHA1, SHA256, WHIRLPOOL, XAUTH, MD5VB, PHPBB,<br />
# MYBB, IPB3, IPB4, PHPFUSION, SMF, XENFORO, SALTED2MD5, JOOMLA, BCRYPT, WBB3, SHA512,<br />
# DOUBLEMD5, PBKDF2, PBKDF2DJANGO, WORDPRESS, ROYALAUTH, CUSTOM(开发者限定)<br />
passwordHash: SHA256<br />
# SALTED2MD5 盐度 MD5(MD5(密码)+混搅盐) <br />
doubleMD5SaltLength: 8<br />
# 如果密码检测返回为 false， 是否需要检测一遍<br />
# 其他密码算法来检查这个旧密码？<br />
# AuthMe 将会吧这个密码更新为新的密码加密算法<br />
supportOldPasswordHash: false<br />
# 禁止使用的不安全密码， 请写小写！ 可以防止小白直接写上密码两个字<br />
# 例子：<br />
#unsafePasswords:<br />
#- '123456'<br />
#- '密码'<br />
#- 'password'<br />
unsafePasswords:<br />
- '123456'<br />
- 'password'<br />
- '密码'<br />
- 'qwerty'<br />
- '12345'<br />
- '54321'<br />
registration:<br />
# 是否开放注册？<br />
enabled: true<br />
# 每 X 秒发送一条叫玩家 注册/登录<br />
# 的消息给玩家<br />
messageInterval: 5<br />
# 只有注册玩家可以玩<br />
# 请查看 restrictions 免责条款<br />
force: true<br />
# 是否用邮箱注册来代替密码注册？<br />
enableEmailRegistrationSystem: false<br />
# 是否启用邮箱双重验证<br />
# 当它开启后，注册是否的命令会是：<br />
# /register <邮箱l> <再次输入邮箱><br />
doubleEmailCheck: false<br />
# 是否在注册后踢出玩家？<br />
# 不使用登录功能<br />
forceKickAfterRegister: false<br />
# 是否让 AuthMe 在玩家成功注册后自动执行 /login ？<br />
forceLoginAfterRegister: false<br />
unrestrictions:<br />
# 你可以在下面列出<br />
# AuthMe 将会忽略注册或登录的账户名<br />
# 配置它你需要自己承担风险！！<br />
# 如果你要吧昵称加进 [], 你需要用 ' '括起来.<br />
# 此选项是为了 BuildCraft 和一些其他<br />
# 插件或者mod的兼容性<br />
# 区分大小写！！<br />
UnrestrictedName: []<br />
# 消息语言，可选值 : en, de, br, cz, pl, fr, ru, hu, sk, es, zhtw, fi, zhcn, lt, it, ko, pt 中文请设置zhcn<br />
messagesLanguage: en<br />
# 强制这些命令在 /login 后才可使用，不需要任何 '/' ，并且使用%代替玩家名称<br />
forceCommands: []<br />
# 强制这些后台命令在 /login 后才可使用，不需要任何 '/' ，并且使用%代替玩家名称<br />
forceCommandsAsConsole: []<br />
# 强制这些命令在 /register, 后才可使用，不需要任何 '/' ，并且使用%代替玩家名称<br />
forceRegisterCommands: []<br />
# 强制这些后台命令在 /register, 后才可使用，不需要任何 '/' ，并且使用%代替玩家名称<br />
forceRegisterCommandsAsConsole: []<br />
# 是否需要在登录或者注册后显示欢迎消息(welcome.txt)？<br />
# 你可以在 welcome.txt + 使用不同的颜色和一些替换符号 :<br />
# {PLAYER} : 玩家名， {ONLINE} : 显示在线人数， {MAXPLAYERS} : 显示服务器最大人数，<br />
# {IP} : 玩家IP， {LOGINS} : 登录的玩家数， {WORLD} : 玩家当前所在的世界名， {SERVER} : 服务器名<br />
# {VERSION} : 当前服务器版本， {COUNTRY} : 玩家的国家<br />
useWelcomeMessage: true<br />
# 是向全服广播 welcome.txt 还是只对登录的玩家显示？ 设置为false将只对登录的玩家显示<br />
broadcastWelcomeMessage: false<br />
# 是否延迟加入游戏消息在玩家登录后才显示？<br />
delayJoinMessage: true<br />
# 是否移除加入游戏的消息？<br />
removeJoinMessage: true<br />
# 是否移除离开游戏的消息？<br />
removeLeaveMessage: true<br />
# 是否在登录或者注册前加入药水效果？ 此条可以设置登录前失明<br />
applyBlindEffect: false<br />
# 是否阻止不同态玩家名的登录？<br />
# 如果 Xephi 注册了， 然后 Xephi 能登录， 但是 XEPHI/xephi/XePhI 不能<br />
preventOtherCase: false<br />
#以下为高级设置内容<br />
#外部关联相关设置<br />
ExternalBoardOptions:<br />
# 需要加密的 MySQL 列， 某些 论坛/cms 需要此项支持<br />
mySQLColumnSalt: ''<br />
# 需要分组的 MySQL 列， 某些 论坛/cms 需要此项支持<br />
mySQLColumnGroup: ''<br />
# -1 为不使用。 如果你想要只有<br />
# 已经激活的用户能登录你的服务器<br />
# 你可以在这里写下你的用户组数<br />
# 某些 论坛/cms 需要此项支持<br />
nonActivedUserGroup: -1<br />
# 其他的需要放用户名的 MySQL 列 (区分大小写)<br />
mySQLOtherUsernameColumns: []<br />
# 在 BCrypt 计算多少轮(如果你不知道它是干什么的不要修改它) (bcrypt，是一个跨平台的文件加密工具)<br />
bCryptLog2Round: 10<br />
# 在 phpBB 安装过程中定义的 phpbb 前缀<br />
phpbbTablePrefix: 'phpbb_'<br />
# phpBB 激活组的 id， 2 是 phpbb 默认定义的注册组<br />
phpbbActivatedGroupId: 2<br />
# 在 WordPress 安装过程中定义的 WordPress 前缀<br />
wordpressTablePrefix: 'wp_'<br />
#权限<br />
permission:<br />
# 注意这个选项，如果你不想<br />
# 使用Vault 和Group Switching<br />
# 来区分 AuthMe 的未登陆组，设置为 true<br />
# 否则，默认为 false<br />
EnablePermissionCheck: false<br />
#备份<br />
BackupSystem:<br />
# 启用或者禁用自动备份<br />
ActivateBackup: false<br />
# 是否每次开服都会备份<br />
OnServerStart: false<br />
# 是否每次关服都会备份<br />
OnServerStop: true<br />
# Windows 下 mysql 的安装路径<br />
MysqlWindowsPath: 'C:\\Program Files\\MySQL\\MySQL Server 5.1\\'<br />
#安全<br />
Security:<br />
SQLProblem:<br />
# 如果和数据库断开连接就关服<br />
# 要考虑这个， 如果你设置这个为 false，<br />
# AuthMe 将自动禁用，并且服务器将失去保护！<br />
stopServer: true<br />
ReloadCommand:<br />
# 是否支持 /reload <br />
useReloadCommandSupport: true<br />
console:<br />
# 不在控制台显示消息<br />
noConsoleSpam: false<br />
# 在控制台更换密码是要像玩家那样输入 /login<br />
removePassword: true<br />
# 是否吧AuthMe的记录文件放在单独的文件夹？<br />
logConsole: true<br />
captcha:<br />
# 在玩家输错太多次后他将需要输入验证码<br />
useCaptcha: false<br />
# 在多少次后要求验证码<br />
maxLoginTry: 5<br />
# 验证码长度<br />
captchaLength: 5<br />
stop:<br />
# 在服务器关闭之前踢出所有玩家， 这样能够保存玩家的位置，并且所有<br />
# 信息都正确正常无任何错误<br />
kickPlayersBeforeStopping: true<br />
#转换<br />
Converter:<br />
Rakamak:<br />
# Rakamak 文件名<br />
fileName: users.rak<br />
# Rakamak 使用 ip ?<br />
useIP: false<br />
# rakamak IP 文件名<br />
ipFileName: UsersIp.rak<br />
CrazyLogin:<br />
# CrazyLogin 数据库文件<br />
fileName: accounts.db<br />
#邮件<br />
Email:<br />
# 电子邮件的SMTP服务器主机名<br />
mailSMTP: smtp.gmail.com<br />
# 电子邮件的SMTP服务器主机端口<br />
mailPort: 465<br />
# 发送邮件的账户<br />
mailAccount: ''<br />
# 邮箱密码<br />
mailPassword: ''<br />
# 自定义发件人的名字，这名字将会代替邮箱显示<br />
mailSenderName: ''<br />
# 随机密码长度<br />
RecoveryPasswordLength: 8<br />
# 邮件主题<br />
mailSubject: 'Your new AuthMe Password'<br />
# 有点像最大注册数但是是邮件的<br />
maxRegPerEmail: 1<br />
# 是否提醒玩家添加一个邮件地址？<br />
recallPlayers: false<br />
# 一分钟内提醒多少次<br />
delayRecall: 5<br />
# 邮箱域名黑名单<br />
emailBlacklisted:<br />
- 10minutemail.com<br />
# 邮箱域名白名单<br />
emailWhitelisted: []<br />
# 是否吧新密码画在图片中？<br />
generateImage: false<br />
# 邮件 OAuth 2 标记 (如果未使用则留空)<br />
emailOauth2Token: ''<br />
#关联<br />
Hooks:<br />
# 是否与 multiverse 的出生点关联？<br />
multiverse: true<br />
# 是否关联 BungeeCord ?（跨服)<br />
bungeecord: false<br />
# 在玩家注册/登录后将玩家发送到某个 BungeeCord 服务器 <br />
sendPlayerTo: ''<br />
# 是否在加入游戏时禁用 Essentials SocialSpy ？<br />
disableSocialSpy: true<br />
# 是否在加入游戏时禁用类似 /motd 的 Essentials 命令？<br />
useEssentialsMotd: false<br />
# 是否缓存 Attributes 自定义？<br />
customAttributes: false<br />
#清理<br />
Purge:<br />
# 如果启用，AuthMe将自动清理掉旧的，未使用的账户<br />
useAutoPurge: false<br />
# 多少天后变为未使用的账户<br />
daysBeforeRemovePlayer: 60<br />
# 是否在清理中顺便清理player.dat文件？<br />
removePlayerDat: false<br />
# 是否在清理中顺便清理 Essentials/users/player.yml 文件？<br />
removeEssentialsFile: false<br />
# 哪个世界存放了 players.dat <br />
defaultWorld: 'world'<br />
# 是否在清理中顺便清理 LimitedCreative/inventories/player.yml, player_creative.yml 文件？<br />
removeLimitedCreativesInventories: false<br />
# 是否在清理中顺便清理 AntiXRayData/PlayerData/player 文件？<br />
removeAntiXRayFile: false<br />
# 是否顺便清理权限？<br />
removePermissions: false<br />
#服务器保护<br />
Protection:<br />
# 启用后服务器将受到一些保护 ( 限制国家登录, 防压测 )<br />
enableProtection: false<br />
# 允许登录和注册的国家，国家代码详情见 http://dev.bukkit.org/bukkit-plugins/authme-reloaded/pages/countries-codes/ <br />
# 请使用引号！！<br />
countries:<br />
- 'US'<br />
- 'GB'<br />
# 黑名单的国家 (不需要启用 protection)<br />
# 请使用引号！！<br />
countriesBlacklist:<br />
- 'A1'<br />
# 是否启用反僵尸压测？<br />
enableAntiBot: false<br />
# 5秒内最大可以登录的玩家 如果启用反压测<br />
antiBotSensibility: 5<br />
# 在多少时间内自动启用反僵尸压测系统<br />
antiBotDuration: 10<br />
VeryGames:<br />
# 这条只是测试 VeryGames 服务器运营商的性能<br />
enableIpCheck: false<br />
<br />
`</div>
梦彗業
https://mineplugin.org/index.php?title=Authme&diff=4061
Authme
2016-09-30T10:52:39Z
<p>梦彗業：/* 特点 */</p>
<hr />
<div>{{Plugin<br />
|version=v未知<br />
|URL=http://dev.bukkit.org/bukkit-plugins/authme/<br />
}}<br />
[[Category:娱乐]]<br />
== 综述 ==<br />
=== 介绍 ===<br />
AuthMe Reloaded<br />
一个注册/登陆插件！<br />
特别是防止被盗号，自动通过UUID更新ID<br />
AuthMe Reloaded可以防止在未登录的情况下放置方块、移动、使用其他命令，或者查看当前的在线玩家数。<br />
只有输入正确的密码才能正常登陆<br />
登陆失败可能是你没有在指定时间内登陆<br />
每个命令和每个设置都可以用极其简单的配置文件来启用或者禁用<br />
如果你不喜欢英语，或者不喜欢作者的翻译，你也可以轻松的自主编辑语言环境！<br />
<br />
=== 特点 ===<br />
可以通过电子邮件找回密码<br />
用户名保护<br />
国家选择！[http://dev.bukkit.org/bukkit-plugins/authme-reloaded/pages/countries-codes/ （国家代码）]<br />
AntiBot功能！<br />
Passpartu管理员功能：管理员可以设置查看所有用户账户信息。[http://dev.bukkit.org/server-mods/authme-reloaded/pages/how-to-install-and-initial-configuration/ 更多查看这里]<br />
没有“已经在另外位置登陆”消息登陆会话<br />
可编辑和设置信息<br />
支持MySQL、flatfile和Sqlite<br />
支持的散列算法：MD5、SHA1、SHA256、[https://github.com/CypherX/xAuth/wiki/Password-Hashing xAuth]、[http://en.wikipedia.org/wiki/Whirlpool_(cryptography) Whirlpool]<br />
支持纯文本密码储存<br />
支持PHOBB、VBulletin论坛注册：MD5VB - PHPBB<br />
支持MyBB：MyBB<br />
支持IPB3：IPB3<br />
支持PhpFisuon：PHPFISUON<br />
支持Xenforo SHA1：XFSHA1<br />
支持Xenforo SHA256：XFSHA256<br />
支持joomal：JOOMAL<br />
支持WBB3：WBB3*<br />
支持SHA512：SHA512<br />
支持DoubleSaltedMD5密码：SALTED2MD5<br />
支持WordPass集成和密码：WORDPASS<br />
定制MySQL列表（可用论坛和其他脚本）<br />
数据库查询可用被缓存<br />
兼容NPC和战墙插件<br />
兼容MC Mods，例如BuildCraft和RedStonCraft<br />
可以限制一个ip可以注册的账号数上限<br />
未登录没有指定权限<br />
注册和未注册的有不同的权限组<br />
支持权限在登陆瞬间的改变<br />
缓存玩家物品，包括所有物品和附魔<br />
保存退出位置，以避免损失位置信息<br />
不可以使用权限插件<br />
持续弹出登陆界面<br />
您的所有用户信息和密码备份储存<br />
该FLATFILE auths.db转换为有用的authme.sql，你可以在MySql数据库使用！<br />
从Rakamak或XAUTH导入您的数据库<br />
<br />
=== 权限&指令 ===<br />
==== 权限 ====<br />
authme.player* 所有用户命令<br />
authme.admin* 管理员命令<br />
authme.* 所有用户和管理员命令<br />
==== 指令 ====<br />
===== 玩家指令 =====<br />
指令 权限 默认<br />
/register authme.register true<br />
/login authme.login true<br />
/logout authme.logout ture<br />
/changepassword authme.changepassword false<br />
/unregister autheme.unregister true<br />
===== 管理员指令 =====<br />
指令 权限 默认<br />
/authme register authme.admin.register op<br />
/authme unregister authme.admin.unregister op<br />
/authme reload authme.admin.reload op<br />
/authme changepassword authme.admin.changepassword op<br />
/authme convertflattosql authme.admin.convertflattosql op<br />
<br />
=== 配置 ===<br />
#存储设置<br />
DataSource:<br />
# 你想使用哪种数据库来存储？ sqlite为文件存储<br />
# 可选的值: sqlite, mysql<br />
backend: sqlite<br />
# 是否启用数据库缓存，以提高数据库性能 无需更改<br />
caching: true<br />
# 数据库地址 如果是本机就写127.0.0.1 如果是云端数据库就写ip或者域名<br />
mySQLHost: 127.0.0.1<br />
# 数据库端口号<br />
mySQLPort: '3306'<br />
# 用于连接数据库的用户名(Username)<br />
mySQLUsername: authme<br />
# 用于连接数据库的密码(Password)<br />
mySQLPassword: '12345'<br />
# 数据库名字，或者SQLITE的文件名<br />
mySQLDatabase: authme<br />
# 数据库表名<br />
mySQLTablename: authme<br />
# 用户ID列的名字<br />
mySQLColumnId: id<br />
# 玩家名或昵称列的名字<br />
mySQLColumnName: username<br />
# 密码列的名字<br />
mySQLColumnPassword: password<br />
# 邮箱列的名字<br />
mySQLColumnEmail: email<br />
# 用于存储玩家是否登录的列的名字<br />
mySQLColumnLogged: isLogged<br />
# 玩家ip列的名字<br />
mySQLColumnIp: ip<br />
# 玩家最后登录时间列的名字<br />
mySQLColumnLastLogin: lastlogin<br />
# 最后退出坐标 - X 列的名字<br />
mySQLlastlocX: x<br />
# 最后退出坐标 - Y 列的名字<br />
mySQLlastlocY: y<br />
# 最后退出坐标 - Z 列的名字<br />
mySQLlastlocZ: z<br />
# 最后退出世界 的 世界名字 列的名字<br />
mySQLlastlocWorld: world<br />
# 真实名字列的名字<br />
mySQLRealName: realname<br />
# 如果你想要启用网站注册请开启此项<br />
mySQLWebsite: false<br />
#普通设置<br />
settings:<br />
# 在“帮助”消息中显示的名字<br />
helpHeader: AuthMeReloaded<br />
sessions:<br />
# 你想启用会话缓存(session)功能吗？<br />
# 如果启用，当玩家成功验证后<br />
# 他的IP和昵称将会被存储<br />
# 当他下次进入服务器时，如果他的IP与上次相同<br />
# 并且没有超过下面那项设置的时间<br />
# 他可以不用重新登录<br />
enabled: false<br />
# 几分钟后会话(session)会过期？<br />
# 0 为无限时间 (非常危险，请注意这样设置的风险)<br />
# 此项只决定会话(session)时间, 如果玩家IP改变<br />
# 但是会话(session)没有超时<br />
# 玩家将会由于 “无效的会话” 而被踢出服务器<br />
# 单位是 分钟 <br />
timeout: 10<br />
# 是否在玩家使用别的IP登陆时关闭会话(session)？（就是换ip需要重新验证）<br />
# 建议为true<br />
sessionExpireOnIpChange: true<br />
restrictions:<br />
# 为注册/登录的玩家能否聊天和看到别人聊天？（此项可以防止小白吧密码发出去）<br />
# 注意，将不能使用所有不在下面的<br />
# 命令列表里的命令<br />
allowChat: false<br />
# 警告: 请只在你需要的时候考虑此项<br />
# 如果注册不是强制的 允许未登录用户使用所有命令<br />
allowAllCommandsIfRegistrationIsOptional: false<br />
# 在未验证时允许的命令<br />
allowCommands:<br />
- /login<br />
- /register<br />
- /l<br />
- /reg<br />
- /email<br />
- /captcha<br />
# 每个IP允许注册的账号的最大数目 (默认为: 1)<br />
maxRegPerIp: 1<br />
# 最大用户名长度<br />
maxNicknameLength: 16<br />
# 如果启用此项， 当前在线的玩家将不会被<br />
# "另一位置登录的玩家" 踢出<br />
# 这能提高安全性 但是卡的时候可能会出现 同名玩家已经在游戏<br />
ForceSingleSession: true<br />
# 如果启用， 每当玩家验证成功后<br />
# 都会被传送到世界的出生点<br />
# 玩家退出位置会被覆盖<br />
# 这个与 "传送未登陆的玩家到出生点(teleportUnAuthedToSpawn)" 不同<br />
# 此选项在玩家登录后也会传送<br />
ForceSpawnLocOnJoinEnabled: false<br />
# 此选项将会保存玩家退出位置<br />
SaveQuitLocation: false<br />
# 启用此项将限制<br />
# 指定ID/IP的用户<br />
# 下面是个例子<br />
AllowRestrictedUser: false<br />
# 符合以下id或ip的受限<br />
# 用户将无法进入服务器<br />
# 默认的例子:<br />
# AllowedRestrictedUser:<br />
# - playername;127.0.0.1 <br />
AllowedRestrictedUser:<br />
- playername;127.0.0.1<br />
# 是否踢出未注册的玩家<br />
kickNonRegistered: false<br />
# 是否在玩家输错密码时踢出<br />
kickOnWrongPassword: false<br />
# 是否传送未登陆的玩家到出生点？<br />
# 当他们登陆后他们会被<br />
# 传送回原来的位置 开启后可以防止卡位置<br />
teleportUnAuthedToSpawn: false<br />
# 昵称最小允许长度<br />
minNicknameLength: 4<br />
# 未注册的玩家可以走动吗？<br />
allowMovement: false<br />
# 是否设置未验证的玩家速度 =0？<br />
# 登陆后 飞行/行走 速度将恢复正常<br />
removeSpeed: true<br />
# 在提示 注册/登陆 多久后踢出玩家？<br />
# 设置未0禁用<br />
timeout: 30<br />
# 玩家名字所允许的正则表达式 中文的表达式：[\u4E00-\u9FA5]*或[一-龥]*<br />
allowedNicknameCharacters: '[a-zA-Z0-9_]*'<br />
# 未注册的玩家可以走多远？<br />
# 设为0则无限半径<br />
allowedMovementRadius: 100<br />
# 时候启用双密码验证注册？<br />
# 如果设置为 true 注册时就需要使用：<br />
# /register <密码> <重复密码><br />
enablePasswordConfirmation: true<br />
# 是否在玩家登陆前保存玩家的库存? 需要 ProtocolLib 前置 登陆之前无物品<br />
ProtectInventoryBeforeLogIn: true<br />
# 是否在登录前拒绝玩家使用TAB列表？ 需要 ProtocolLib 前置<br />
DenyTabCompleteBeforeLogin: true<br />
# 是否在玩家登录前隐藏TAB列表？ 需要 ProtocolLib 前置<br />
HideTablistBeforeLogin: true<br />
# 是否在玩家登录是显示其他几个他的账号？<br />
# 权限: /authme.admin.accounts<br />
displayOtherAccounts: true<br />
# ForceSpawnLocOnJoinEnabled 项中那些世界会强制出生点登录<br />
# 区分大小写<br />
ForceSpawnOnTheseWorlds:<br />
- world<br />
- world_nether<br />
- world_the_end<br />
# 当ip没有注册在数据库时，封禁该ip<br />
banUnsafedIP: false<br />
# 出生点优先级， 可选值 : authme, essentials, multiverse, default<br />
spawnPriority: authme,essentials,multiverse,default<br />
# 一个IP可以登录的账号最大数量<br />
maxLoginPerIp: 0<br />
# 一个IP可以加入游戏最大数量<br />
maxJoinPerIp: 0<br />
# 开启后 AuthMe 将绝对不会传送玩家！<br />
noTeleport: false<br />
# 密码允许的字符的正则表达式 不建议更改<br />
allowedPasswordCharacters: '[\x21-\x7E]*'<br />
GameMode:<br />
# 是否在加入游戏时强制生存模式<br />
ForceSurvivalMode: false<br />
security:<br />
# 密码最小长度<br />
minPasswordLength: 5<br />
# 密码最大长度<br />
passwordMaxLength: 30<br />
# 这是一个非常重要的选项，<br />
# 每次玩家加入服务器，<br />
# 如果他们已经注册, AuthMe 将会吧他们移动<br />
# 到未登陆组, 这应该能<br />
# 防止所有重大漏洞<br />
# 你可以在你的权限插件里<br />
# 设置这个特殊的分组，并且拥有 0 个权限， 或只有聊天权限，<br />
# 或者可以发送私人消息<br />
# 或其他消息，以及其他任何你想要设置的权限<br />
# 最好是将这个组设置为<br />
# 只有很少的权限，<br />
# 当某些玩家尝试利用一些不属于他们的账户，<br />
# 他们将只能做你设置过权限的事<br />
# 当他们登陆后，他们会被<br />
# 移动到正常的权限组！<br />
# 注意组名是区分大小写的<br />
# 所以 Admin ≠ admin，<br />
# 否则你的分组将会被抹除,<br />
# 玩家将加入默认的分组 [] 中!<br />
# 例如： unLoggedinGroup: NotLogged<br />
unLoggedinGroup: unLoggedinGroup<br />
# 密码加密算法<br />
# 可以设置的值: MD5, SHA1, SHA256, WHIRLPOOL, XAUTH, MD5VB, PHPBB,<br />
# MYBB, IPB3, IPB4, PHPFUSION, SMF, XENFORO, SALTED2MD5, JOOMLA, BCRYPT, WBB3, SHA512,<br />
# DOUBLEMD5, PBKDF2, PBKDF2DJANGO, WORDPRESS, ROYALAUTH, CUSTOM(开发者限定)<br />
passwordHash: SHA256<br />
# SALTED2MD5 盐度 MD5(MD5(密码)+混搅盐) <br />
doubleMD5SaltLength: 8<br />
# 如果密码检测返回为 false， 是否需要检测一遍<br />
# 其他密码算法来检查这个旧密码？<br />
# AuthMe 将会吧这个密码更新为新的密码加密算法<br />
supportOldPasswordHash: false<br />
# 禁止使用的不安全密码， 请写小写！ 可以防止小白直接写上密码两个字<br />
# 例子：<br />
#unsafePasswords:<br />
#- '123456'<br />
#- '密码'<br />
#- 'password'<br />
unsafePasswords:<br />
- '123456'<br />
- 'password'<br />
- '密码'<br />
- 'qwerty'<br />
- '12345'<br />
- '54321'<br />
registration:<br />
# 是否开放注册？<br />
enabled: true<br />
# 每 X 秒发送一条叫玩家 注册/登录<br />
# 的消息给玩家<br />
messageInterval: 5<br />
# 只有注册玩家可以玩<br />
# 请查看 restrictions 免责条款<br />
force: true<br />
# 是否用邮箱注册来代替密码注册？<br />
enableEmailRegistrationSystem: false<br />
# 是否启用邮箱双重验证<br />
# 当它开启后，注册是否的命令会是：<br />
# /register <邮箱l> <再次输入邮箱><br />
doubleEmailCheck: false<br />
# 是否在注册后踢出玩家？<br />
# 不使用登录功能<br />
forceKickAfterRegister: false<br />
# 是否让 AuthMe 在玩家成功注册后自动执行 /login ？<br />
forceLoginAfterRegister: false<br />
unrestrictions:<br />
# 你可以在下面列出<br />
# AuthMe 将会忽略注册或登录的账户名<br />
# 配置它你需要自己承担风险！！<br />
# 如果你要吧昵称加进 [], 你需要用 ' '括起来.<br />
# 此选项是为了 BuildCraft 和一些其他<br />
# 插件或者mod的兼容性<br />
# 区分大小写！！<br />
UnrestrictedName: []<br />
# 消息语言，可选值 : en, de, br, cz, pl, fr, ru, hu, sk, es, zhtw, fi, zhcn, lt, it, ko, pt 中文请设置zhcn<br />
messagesLanguage: en<br />
# 强制这些命令在 /login 后才可使用，不需要任何 '/' ，并且使用%代替玩家名称<br />
forceCommands: []<br />
# 强制这些后台命令在 /login 后才可使用，不需要任何 '/' ，并且使用%代替玩家名称<br />
forceCommandsAsConsole: []<br />
# 强制这些命令在 /register, 后才可使用，不需要任何 '/' ，并且使用%代替玩家名称<br />
forceRegisterCommands: []<br />
# 强制这些后台命令在 /register, 后才可使用，不需要任何 '/' ，并且使用%代替玩家名称<br />
forceRegisterCommandsAsConsole: []<br />
# 是否需要在登录或者注册后显示欢迎消息(welcome.txt)？<br />
# 你可以在 welcome.txt + 使用不同的颜色和一些替换符号 :<br />
# {PLAYER} : 玩家名， {ONLINE} : 显示在线人数， {MAXPLAYERS} : 显示服务器最大人数，<br />
# {IP} : 玩家IP， {LOGINS} : 登录的玩家数， {WORLD} : 玩家当前所在的世界名， {SERVER} : 服务器名<br />
# {VERSION} : 当前服务器版本， {COUNTRY} : 玩家的国家<br />
useWelcomeMessage: true<br />
# 是向全服广播 welcome.txt 还是只对登录的玩家显示？ 设置为false将只对登录的玩家显示<br />
broadcastWelcomeMessage: false<br />
# 是否延迟加入游戏消息在玩家登录后才显示？<br />
delayJoinMessage: true<br />
# 是否移除加入游戏的消息？<br />
removeJoinMessage: true<br />
# 是否移除离开游戏的消息？<br />
removeLeaveMessage: true<br />
# 是否在登录或者注册前加入药水效果？ 此条可以设置登录前失明<br />
applyBlindEffect: false<br />
# 是否阻止不同态玩家名的登录？<br />
# 如果 Xephi 注册了， 然后 Xephi 能登录， 但是 XEPHI/xephi/XePhI 不能<br />
preventOtherCase: false<br />
#以下为高级设置内容<br />
#外部关联相关设置<br />
ExternalBoardOptions:<br />
# 需要加密的 MySQL 列， 某些 论坛/cms 需要此项支持<br />
mySQLColumnSalt: ''<br />
# 需要分组的 MySQL 列， 某些 论坛/cms 需要此项支持<br />
mySQLColumnGroup: ''<br />
# -1 为不使用。 如果你想要只有<br />
# 已经激活的用户能登录你的服务器<br />
# 你可以在这里写下你的用户组数<br />
# 某些 论坛/cms 需要此项支持<br />
nonActivedUserGroup: -1<br />
# 其他的需要放用户名的 MySQL 列 (区分大小写)<br />
mySQLOtherUsernameColumns: []<br />
# 在 BCrypt 计算多少轮(如果你不知道它是干什么的不要修改它) (bcrypt，是一个跨平台的文件加密工具)<br />
bCryptLog2Round: 10<br />
# 在 phpBB 安装过程中定义的 phpbb 前缀<br />
phpbbTablePrefix: 'phpbb_'<br />
# phpBB 激活组的 id， 2 是 phpbb 默认定义的注册组<br />
phpbbActivatedGroupId: 2<br />
# 在 WordPress 安装过程中定义的 WordPress 前缀<br />
wordpressTablePrefix: 'wp_'<br />
#权限<br />
permission:<br />
# 注意这个选项，如果你不想<br />
# 使用Vault 和Group Switching<br />
# 来区分 AuthMe 的未登陆组，设置为 true<br />
# 否则，默认为 false<br />
EnablePermissionCheck: false<br />
#备份<br />
BackupSystem:<br />
# 启用或者禁用自动备份<br />
ActivateBackup: false<br />
# 是否每次开服都会备份<br />
OnServerStart: false<br />
# 是否每次关服都会备份<br />
OnServerStop: true<br />
# Windows 下 mysql 的安装路径<br />
MysqlWindowsPath: 'C:\\Program Files\\MySQL\\MySQL Server 5.1\\'<br />
#安全<br />
Security:<br />
SQLProblem:<br />
# 如果和数据库断开连接就关服<br />
# 要考虑这个， 如果你设置这个为 false，<br />
# AuthMe 将自动禁用，并且服务器将失去保护！<br />
stopServer: true<br />
ReloadCommand:<br />
# 是否支持 /reload <br />
useReloadCommandSupport: true<br />
console:<br />
# 不在控制台显示消息<br />
noConsoleSpam: false<br />
# 在控制台更换密码是要像玩家那样输入 /login<br />
removePassword: true<br />
# 是否吧AuthMe的记录文件放在单独的文件夹？<br />
logConsole: true<br />
captcha:<br />
# 在玩家输错太多次后他将需要输入验证码<br />
useCaptcha: false<br />
# 在多少次后要求验证码<br />
maxLoginTry: 5<br />
# 验证码长度<br />
captchaLength: 5<br />
stop:<br />
# 在服务器关闭之前踢出所有玩家， 这样能够保存玩家的位置，并且所有<br />
# 信息都正确正常无任何错误<br />
kickPlayersBeforeStopping: true<br />
#转换<br />
Converter:<br />
Rakamak:<br />
# Rakamak 文件名<br />
fileName: users.rak<br />
# Rakamak 使用 ip ?<br />
useIP: false<br />
# rakamak IP 文件名<br />
ipFileName: UsersIp.rak<br />
CrazyLogin:<br />
# CrazyLogin 数据库文件<br />
fileName: accounts.db<br />
#邮件<br />
Email:<br />
# 电子邮件的SMTP服务器主机名<br />
mailSMTP: smtp.gmail.com<br />
# 电子邮件的SMTP服务器主机端口<br />
mailPort: 465<br />
# 发送邮件的账户<br />
mailAccount: ''<br />
# 邮箱密码<br />
mailPassword: ''<br />
# 自定义发件人的名字，这名字将会代替邮箱显示<br />
mailSenderName: ''<br />
# 随机密码长度<br />
RecoveryPasswordLength: 8<br />
# 邮件主题<br />
mailSubject: 'Your new AuthMe Password'<br />
# 有点像最大注册数但是是邮件的<br />
maxRegPerEmail: 1<br />
# 是否提醒玩家添加一个邮件地址？<br />
recallPlayers: false<br />
# 一分钟内提醒多少次<br />
delayRecall: 5<br />
# 邮箱域名黑名单<br />
emailBlacklisted:<br />
- 10minutemail.com<br />
# 邮箱域名白名单<br />
emailWhitelisted: []<br />
# 是否吧新密码画在图片中？<br />
generateImage: false<br />
# 邮件 OAuth 2 标记 (如果未使用则留空)<br />
emailOauth2Token: ''<br />
#关联<br />
Hooks:<br />
# 是否与 multiverse 的出生点关联？<br />
multiverse: true<br />
# 是否关联 BungeeCord ?（跨服)<br />
bungeecord: false<br />
# 在玩家注册/登录后将玩家发送到某个 BungeeCord 服务器 <br />
sendPlayerTo: ''<br />
# 是否在加入游戏时禁用 Essentials SocialSpy ？<br />
disableSocialSpy: true<br />
# 是否在加入游戏时禁用类似 /motd 的 Essentials 命令？<br />
useEssentialsMotd: false<br />
# 是否缓存 Attributes 自定义？<br />
customAttributes: false<br />
#清理<br />
Purge:<br />
# 如果启用，AuthMe将自动清理掉旧的，未使用的账户<br />
useAutoPurge: false<br />
# 多少天后变为未使用的账户<br />
daysBeforeRemovePlayer: 60<br />
# 是否在清理中顺便清理player.dat文件？<br />
removePlayerDat: false<br />
# 是否在清理中顺便清理 Essentials/users/player.yml 文件？<br />
removeEssentialsFile: false<br />
# 哪个世界存放了 players.dat <br />
defaultWorld: 'world'<br />
# 是否在清理中顺便清理 LimitedCreative/inventories/player.yml, player_creative.yml 文件？<br />
removeLimitedCreativesInventories: false<br />
# 是否在清理中顺便清理 AntiXRayData/PlayerData/player 文件？<br />
removeAntiXRayFile: false<br />
# 是否顺便清理权限？<br />
removePermissions: false<br />
#服务器保护<br />
Protection:<br />
# 启用后服务器将受到一些保护 ( 限制国家登录, 防压测 )<br />
enableProtection: false<br />
# 允许登录和注册的国家，国家代码详情见 http://dev.bukkit.org/bukkit-plugins/authme-reloaded/pages/countries-codes/ <br />
# 请使用引号！！<br />
countries:<br />
- 'US'<br />
- 'GB'<br />
# 黑名单的国家 (不需要启用 protection)<br />
# 请使用引号！！<br />
countriesBlacklist:<br />
- 'A1'<br />
# 是否启用反僵尸压测？<br />
enableAntiBot: false<br />
# 5秒内最大可以登录的玩家 如果启用反压测<br />
antiBotSensibility: 5<br />
# 在多少时间内自动启用反僵尸压测系统<br />
antiBotDuration: 10<br />
VeryGames:<br />
# 这条只是测试 VeryGames 服务器运营商的性能<br />
enableIpCheck: false<br />
<br />
`</div>
梦彗業
https://mineplugin.org/index.php?title=Authme&diff=4060
Authme
2016-09-30T10:48:27Z
<p>梦彗業：/* 特点 */</p>
<hr />
<div>{{Plugin<br />
|version=v未知<br />
|URL=http://dev.bukkit.org/bukkit-plugins/authme/<br />
}}<br />
[[Category:娱乐]]<br />
== 综述 ==<br />
=== 介绍 ===<br />
AuthMe Reloaded<br />
一个注册/登陆插件！<br />
特别是防止被盗号，自动通过UUID更新ID<br />
AuthMe Reloaded可以防止在未登录的情况下放置方块、移动、使用其他命令，或者查看当前的在线玩家数。<br />
只有输入正确的密码才能正常登陆<br />
登陆失败可能是你没有在指定时间内登陆<br />
每个命令和每个设置都可以用极其简单的配置文件来启用或者禁用<br />
如果你不喜欢英语，或者不喜欢作者的翻译，你也可以轻松的自主编辑语言环境！<br />
<br />
=== 特点 ===<br />
可以通过电子邮件找回密码<br />
用户名保护<br />
国家选择！[http://dev.bukkit.org/bukkit-plugins/authme-reloaded/pages/countries-codes/ （国家代码）]<br />
AntiBot功能！<br />
Passpartu管理员功能：管理员可以设置查看所有用户账户信息。更多查看这里<br />
没有“已经在另外位置登陆”消息登陆会话<br />
可编辑和设置信息<br />
支持MySQL、flatfile和Sqlite<br />
支持的散列算法：MD5、SHA1、SHA256、xAuth、Whirlpool<br />
支持纯文本密码储存<br />
支持PHOBB、VBulletin论坛注册：MD5VB - PHPBB<br />
支持MyBB：MyBB<br />
支持IPB3：IPB3<br />
支持PhpFisuon：PHPFISUON<br />
支持Xenforo SHA1：XFSHA1<br />
支持Xenforo SHA256：XFSHA256<br />
支持joomal：JOOMAL<br />
支持WBB3：WBB3*<br />
支持SHA512：SHA512<br />
支持DoubleSaltedMD5密码：SALTED2MD5<br />
支持WordPass集成和密码：WORDPASS<br />
定制MySQL列表（可用论坛和其他脚本）<br />
数据库查询可用被缓存<br />
兼容NPC和战墙插件<br />
兼容MC Mods，例如BuildCraft和RedStonCraft<br />
可以限制一个ip可以注册的账号数上限<br />
未登录没有指定权限<br />
注册和未注册的有不同的权限组<br />
支持权限在登陆瞬间的改变<br />
缓存玩家物品，包括所有物品和附魔<br />
保存退出位置，以避免损失位置信息<br />
不可以使用权限插件<br />
持续弹出登陆界面<br />
您的所有用户信息和密码备份储存<br />
该FLATFILE auths.db转换为有用的authme.sql，你可以在MySql数据库使用！<br />
从Rakamak或XAUTH导入您的数据库<br />
<br />
=== 权限&指令 ===<br />
==== 权限 ====<br />
authme.player* 所有用户命令<br />
authme.admin* 管理员命令<br />
authme.* 所有用户和管理员命令<br />
==== 指令 ====<br />
===== 玩家指令 =====<br />
指令 权限 默认<br />
/register authme.register true<br />
/login authme.login true<br />
/logout authme.logout ture<br />
/changepassword authme.changepassword false<br />
/unregister autheme.unregister true<br />
===== 管理员指令 =====<br />
指令 权限 默认<br />
/authme register authme.admin.register op<br />
/authme unregister authme.admin.unregister op<br />
/authme reload authme.admin.reload op<br />
/authme changepassword authme.admin.changepassword op<br />
/authme convertflattosql authme.admin.convertflattosql op<br />
<br />
=== 配置 ===<br />
#存储设置<br />
DataSource:<br />
# 你想使用哪种数据库来存储？ sqlite为文件存储<br />
# 可选的值: sqlite, mysql<br />
backend: sqlite<br />
# 是否启用数据库缓存，以提高数据库性能 无需更改<br />
caching: true<br />
# 数据库地址 如果是本机就写127.0.0.1 如果是云端数据库就写ip或者域名<br />
mySQLHost: 127.0.0.1<br />
# 数据库端口号<br />
mySQLPort: '3306'<br />
# 用于连接数据库的用户名(Username)<br />
mySQLUsername: authme<br />
# 用于连接数据库的密码(Password)<br />
mySQLPassword: '12345'<br />
# 数据库名字，或者SQLITE的文件名<br />
mySQLDatabase: authme<br />
# 数据库表名<br />
mySQLTablename: authme<br />
# 用户ID列的名字<br />
mySQLColumnId: id<br />
# 玩家名或昵称列的名字<br />
mySQLColumnName: username<br />
# 密码列的名字<br />
mySQLColumnPassword: password<br />
# 邮箱列的名字<br />
mySQLColumnEmail: email<br />
# 用于存储玩家是否登录的列的名字<br />
mySQLColumnLogged: isLogged<br />
# 玩家ip列的名字<br />
mySQLColumnIp: ip<br />
# 玩家最后登录时间列的名字<br />
mySQLColumnLastLogin: lastlogin<br />
# 最后退出坐标 - X 列的名字<br />
mySQLlastlocX: x<br />
# 最后退出坐标 - Y 列的名字<br />
mySQLlastlocY: y<br />
# 最后退出坐标 - Z 列的名字<br />
mySQLlastlocZ: z<br />
# 最后退出世界 的 世界名字 列的名字<br />
mySQLlastlocWorld: world<br />
# 真实名字列的名字<br />
mySQLRealName: realname<br />
# 如果你想要启用网站注册请开启此项<br />
mySQLWebsite: false<br />
#普通设置<br />
settings:<br />
# 在“帮助”消息中显示的名字<br />
helpHeader: AuthMeReloaded<br />
sessions:<br />
# 你想启用会话缓存(session)功能吗？<br />
# 如果启用，当玩家成功验证后<br />
# 他的IP和昵称将会被存储<br />
# 当他下次进入服务器时，如果他的IP与上次相同<br />
# 并且没有超过下面那项设置的时间<br />
# 他可以不用重新登录<br />
enabled: false<br />
# 几分钟后会话(session)会过期？<br />
# 0 为无限时间 (非常危险，请注意这样设置的风险)<br />
# 此项只决定会话(session)时间, 如果玩家IP改变<br />
# 但是会话(session)没有超时<br />
# 玩家将会由于 “无效的会话” 而被踢出服务器<br />
# 单位是 分钟 <br />
timeout: 10<br />
# 是否在玩家使用别的IP登陆时关闭会话(session)？（就是换ip需要重新验证）<br />
# 建议为true<br />
sessionExpireOnIpChange: true<br />
restrictions:<br />
# 为注册/登录的玩家能否聊天和看到别人聊天？（此项可以防止小白吧密码发出去）<br />
# 注意，将不能使用所有不在下面的<br />
# 命令列表里的命令<br />
allowChat: false<br />
# 警告: 请只在你需要的时候考虑此项<br />
# 如果注册不是强制的 允许未登录用户使用所有命令<br />
allowAllCommandsIfRegistrationIsOptional: false<br />
# 在未验证时允许的命令<br />
allowCommands:<br />
- /login<br />
- /register<br />
- /l<br />
- /reg<br />
- /email<br />
- /captcha<br />
# 每个IP允许注册的账号的最大数目 (默认为: 1)<br />
maxRegPerIp: 1<br />
# 最大用户名长度<br />
maxNicknameLength: 16<br />
# 如果启用此项， 当前在线的玩家将不会被<br />
# "另一位置登录的玩家" 踢出<br />
# 这能提高安全性 但是卡的时候可能会出现 同名玩家已经在游戏<br />
ForceSingleSession: true<br />
# 如果启用， 每当玩家验证成功后<br />
# 都会被传送到世界的出生点<br />
# 玩家退出位置会被覆盖<br />
# 这个与 "传送未登陆的玩家到出生点(teleportUnAuthedToSpawn)" 不同<br />
# 此选项在玩家登录后也会传送<br />
ForceSpawnLocOnJoinEnabled: false<br />
# 此选项将会保存玩家退出位置<br />
SaveQuitLocation: false<br />
# 启用此项将限制<br />
# 指定ID/IP的用户<br />
# 下面是个例子<br />
AllowRestrictedUser: false<br />
# 符合以下id或ip的受限<br />
# 用户将无法进入服务器<br />
# 默认的例子:<br />
# AllowedRestrictedUser:<br />
# - playername;127.0.0.1 <br />
AllowedRestrictedUser:<br />
- playername;127.0.0.1<br />
# 是否踢出未注册的玩家<br />
kickNonRegistered: false<br />
# 是否在玩家输错密码时踢出<br />
kickOnWrongPassword: false<br />
# 是否传送未登陆的玩家到出生点？<br />
# 当他们登陆后他们会被<br />
# 传送回原来的位置 开启后可以防止卡位置<br />
teleportUnAuthedToSpawn: false<br />
# 昵称最小允许长度<br />
minNicknameLength: 4<br />
# 未注册的玩家可以走动吗？<br />
allowMovement: false<br />
# 是否设置未验证的玩家速度 =0？<br />
# 登陆后 飞行/行走 速度将恢复正常<br />
removeSpeed: true<br />
# 在提示 注册/登陆 多久后踢出玩家？<br />
# 设置未0禁用<br />
timeout: 30<br />
# 玩家名字所允许的正则表达式 中文的表达式：[\u4E00-\u9FA5]*或[一-龥]*<br />
allowedNicknameCharacters: '[a-zA-Z0-9_]*'<br />
# 未注册的玩家可以走多远？<br />
# 设为0则无限半径<br />
allowedMovementRadius: 100<br />
# 时候启用双密码验证注册？<br />
# 如果设置为 true 注册时就需要使用：<br />
# /register <密码> <重复密码><br />
enablePasswordConfirmation: true<br />
# 是否在玩家登陆前保存玩家的库存? 需要 ProtocolLib 前置 登陆之前无物品<br />
ProtectInventoryBeforeLogIn: true<br />
# 是否在登录前拒绝玩家使用TAB列表？ 需要 ProtocolLib 前置<br />
DenyTabCompleteBeforeLogin: true<br />
# 是否在玩家登录前隐藏TAB列表？ 需要 ProtocolLib 前置<br />
HideTablistBeforeLogin: true<br />
# 是否在玩家登录是显示其他几个他的账号？<br />
# 权限: /authme.admin.accounts<br />
displayOtherAccounts: true<br />
# ForceSpawnLocOnJoinEnabled 项中那些世界会强制出生点登录<br />
# 区分大小写<br />
ForceSpawnOnTheseWorlds:<br />
- world<br />
- world_nether<br />
- world_the_end<br />
# 当ip没有注册在数据库时，封禁该ip<br />
banUnsafedIP: false<br />
# 出生点优先级， 可选值 : authme, essentials, multiverse, default<br />
spawnPriority: authme,essentials,multiverse,default<br />
# 一个IP可以登录的账号最大数量<br />
maxLoginPerIp: 0<br />
# 一个IP可以加入游戏最大数量<br />
maxJoinPerIp: 0<br />
# 开启后 AuthMe 将绝对不会传送玩家！<br />
noTeleport: false<br />
# 密码允许的字符的正则表达式 不建议更改<br />
allowedPasswordCharacters: '[\x21-\x7E]*'<br />
GameMode:<br />
# 是否在加入游戏时强制生存模式<br />
ForceSurvivalMode: false<br />
security:<br />
# 密码最小长度<br />
minPasswordLength: 5<br />
# 密码最大长度<br />
passwordMaxLength: 30<br />
# 这是一个非常重要的选项，<br />
# 每次玩家加入服务器，<br />
# 如果他们已经注册, AuthMe 将会吧他们移动<br />
# 到未登陆组, 这应该能<br />
# 防止所有重大漏洞<br />
# 你可以在你的权限插件里<br />
# 设置这个特殊的分组，并且拥有 0 个权限， 或只有聊天权限，<br />
# 或者可以发送私人消息<br />
# 或其他消息，以及其他任何你想要设置的权限<br />
# 最好是将这个组设置为<br />
# 只有很少的权限，<br />
# 当某些玩家尝试利用一些不属于他们的账户，<br />
# 他们将只能做你设置过权限的事<br />
# 当他们登陆后，他们会被<br />
# 移动到正常的权限组！<br />
# 注意组名是区分大小写的<br />
# 所以 Admin ≠ admin，<br />
# 否则你的分组将会被抹除,<br />
# 玩家将加入默认的分组 [] 中!<br />
# 例如： unLoggedinGroup: NotLogged<br />
unLoggedinGroup: unLoggedinGroup<br />
# 密码加密算法<br />
# 可以设置的值: MD5, SHA1, SHA256, WHIRLPOOL, XAUTH, MD5VB, PHPBB,<br />
# MYBB, IPB3, IPB4, PHPFUSION, SMF, XENFORO, SALTED2MD5, JOOMLA, BCRYPT, WBB3, SHA512,<br />
# DOUBLEMD5, PBKDF2, PBKDF2DJANGO, WORDPRESS, ROYALAUTH, CUSTOM(开发者限定)<br />
passwordHash: SHA256<br />
# SALTED2MD5 盐度 MD5(MD5(密码)+混搅盐) <br />
doubleMD5SaltLength: 8<br />
# 如果密码检测返回为 false， 是否需要检测一遍<br />
# 其他密码算法来检查这个旧密码？<br />
# AuthMe 将会吧这个密码更新为新的密码加密算法<br />
supportOldPasswordHash: false<br />
# 禁止使用的不安全密码， 请写小写！ 可以防止小白直接写上密码两个字<br />
# 例子：<br />
#unsafePasswords:<br />
#- '123456'<br />
#- '密码'<br />
#- 'password'<br />
unsafePasswords:<br />
- '123456'<br />
- 'password'<br />
- '密码'<br />
- 'qwerty'<br />
- '12345'<br />
- '54321'<br />
registration:<br />
# 是否开放注册？<br />
enabled: true<br />
# 每 X 秒发送一条叫玩家 注册/登录<br />
# 的消息给玩家<br />
messageInterval: 5<br />
# 只有注册玩家可以玩<br />
# 请查看 restrictions 免责条款<br />
force: true<br />
# 是否用邮箱注册来代替密码注册？<br />
enableEmailRegistrationSystem: false<br />
# 是否启用邮箱双重验证<br />
# 当它开启后，注册是否的命令会是：<br />
# /register <邮箱l> <再次输入邮箱><br />
doubleEmailCheck: false<br />
# 是否在注册后踢出玩家？<br />
# 不使用登录功能<br />
forceKickAfterRegister: false<br />
# 是否让 AuthMe 在玩家成功注册后自动执行 /login ？<br />
forceLoginAfterRegister: false<br />
unrestrictions:<br />
# 你可以在下面列出<br />
# AuthMe 将会忽略注册或登录的账户名<br />
# 配置它你需要自己承担风险！！<br />
# 如果你要吧昵称加进 [], 你需要用 ' '括起来.<br />
# 此选项是为了 BuildCraft 和一些其他<br />
# 插件或者mod的兼容性<br />
# 区分大小写！！<br />
UnrestrictedName: []<br />
# 消息语言，可选值 : en, de, br, cz, pl, fr, ru, hu, sk, es, zhtw, fi, zhcn, lt, it, ko, pt 中文请设置zhcn<br />
messagesLanguage: en<br />
# 强制这些命令在 /login 后才可使用，不需要任何 '/' ，并且使用%代替玩家名称<br />
forceCommands: []<br />
# 强制这些后台命令在 /login 后才可使用，不需要任何 '/' ，并且使用%代替玩家名称<br />
forceCommandsAsConsole: []<br />
# 强制这些命令在 /register, 后才可使用，不需要任何 '/' ，并且使用%代替玩家名称<br />
forceRegisterCommands: []<br />
# 强制这些后台命令在 /register, 后才可使用，不需要任何 '/' ，并且使用%代替玩家名称<br />
forceRegisterCommandsAsConsole: []<br />
# 是否需要在登录或者注册后显示欢迎消息(welcome.txt)？<br />
# 你可以在 welcome.txt + 使用不同的颜色和一些替换符号 :<br />
# {PLAYER} : 玩家名， {ONLINE} : 显示在线人数， {MAXPLAYERS} : 显示服务器最大人数，<br />
# {IP} : 玩家IP， {LOGINS} : 登录的玩家数， {WORLD} : 玩家当前所在的世界名， {SERVER} : 服务器名<br />
# {VERSION} : 当前服务器版本， {COUNTRY} : 玩家的国家<br />
useWelcomeMessage: true<br />
# 是向全服广播 welcome.txt 还是只对登录的玩家显示？ 设置为false将只对登录的玩家显示<br />
broadcastWelcomeMessage: false<br />
# 是否延迟加入游戏消息在玩家登录后才显示？<br />
delayJoinMessage: true<br />
# 是否移除加入游戏的消息？<br />
removeJoinMessage: true<br />
# 是否移除离开游戏的消息？<br />
removeLeaveMessage: true<br />
# 是否在登录或者注册前加入药水效果？ 此条可以设置登录前失明<br />
applyBlindEffect: false<br />
# 是否阻止不同态玩家名的登录？<br />
# 如果 Xephi 注册了， 然后 Xephi 能登录， 但是 XEPHI/xephi/XePhI 不能<br />
preventOtherCase: false<br />
#以下为高级设置内容<br />
#外部关联相关设置<br />
ExternalBoardOptions:<br />
# 需要加密的 MySQL 列， 某些 论坛/cms 需要此项支持<br />
mySQLColumnSalt: ''<br />
# 需要分组的 MySQL 列， 某些 论坛/cms 需要此项支持<br />
mySQLColumnGroup: ''<br />
# -1 为不使用。 如果你想要只有<br />
# 已经激活的用户能登录你的服务器<br />
# 你可以在这里写下你的用户组数<br />
# 某些 论坛/cms 需要此项支持<br />
nonActivedUserGroup: -1<br />
# 其他的需要放用户名的 MySQL 列 (区分大小写)<br />
mySQLOtherUsernameColumns: []<br />
# 在 BCrypt 计算多少轮(如果你不知道它是干什么的不要修改它) (bcrypt，是一个跨平台的文件加密工具)<br />
bCryptLog2Round: 10<br />
# 在 phpBB 安装过程中定义的 phpbb 前缀<br />
phpbbTablePrefix: 'phpbb_'<br />
# phpBB 激活组的 id， 2 是 phpbb 默认定义的注册组<br />
phpbbActivatedGroupId: 2<br />
# 在 WordPress 安装过程中定义的 WordPress 前缀<br />
wordpressTablePrefix: 'wp_'<br />
#权限<br />
permission:<br />
# 注意这个选项，如果你不想<br />
# 使用Vault 和Group Switching<br />
# 来区分 AuthMe 的未登陆组，设置为 true<br />
# 否则，默认为 false<br />
EnablePermissionCheck: false<br />
#备份<br />
BackupSystem:<br />
# 启用或者禁用自动备份<br />
ActivateBackup: false<br />
# 是否每次开服都会备份<br />
OnServerStart: false<br />
# 是否每次关服都会备份<br />
OnServerStop: true<br />
# Windows 下 mysql 的安装路径<br />
MysqlWindowsPath: 'C:\\Program Files\\MySQL\\MySQL Server 5.1\\'<br />
#安全<br />
Security:<br />
SQLProblem:<br />
# 如果和数据库断开连接就关服<br />
# 要考虑这个， 如果你设置这个为 false，<br />
# AuthMe 将自动禁用，并且服务器将失去保护！<br />
stopServer: true<br />
ReloadCommand:<br />
# 是否支持 /reload <br />
useReloadCommandSupport: true<br />
console:<br />
# 不在控制台显示消息<br />
noConsoleSpam: false<br />
# 在控制台更换密码是要像玩家那样输入 /login<br />
removePassword: true<br />
# 是否吧AuthMe的记录文件放在单独的文件夹？<br />
logConsole: true<br />
captcha:<br />
# 在玩家输错太多次后他将需要输入验证码<br />
useCaptcha: false<br />
# 在多少次后要求验证码<br />
maxLoginTry: 5<br />
# 验证码长度<br />
captchaLength: 5<br />
stop:<br />
# 在服务器关闭之前踢出所有玩家， 这样能够保存玩家的位置，并且所有<br />
# 信息都正确正常无任何错误<br />
kickPlayersBeforeStopping: true<br />
#转换<br />
Converter:<br />
Rakamak:<br />
# Rakamak 文件名<br />
fileName: users.rak<br />
# Rakamak 使用 ip ?<br />
useIP: false<br />
# rakamak IP 文件名<br />
ipFileName: UsersIp.rak<br />
CrazyLogin:<br />
# CrazyLogin 数据库文件<br />
fileName: accounts.db<br />
#邮件<br />
Email:<br />
# 电子邮件的SMTP服务器主机名<br />
mailSMTP: smtp.gmail.com<br />
# 电子邮件的SMTP服务器主机端口<br />
mailPort: 465<br />
# 发送邮件的账户<br />
mailAccount: ''<br />
# 邮箱密码<br />
mailPassword: ''<br />
# 自定义发件人的名字，这名字将会代替邮箱显示<br />
mailSenderName: ''<br />
# 随机密码长度<br />
RecoveryPasswordLength: 8<br />
# 邮件主题<br />
mailSubject: 'Your new AuthMe Password'<br />
# 有点像最大注册数但是是邮件的<br />
maxRegPerEmail: 1<br />
# 是否提醒玩家添加一个邮件地址？<br />
recallPlayers: false<br />
# 一分钟内提醒多少次<br />
delayRecall: 5<br />
# 邮箱域名黑名单<br />
emailBlacklisted:<br />
- 10minutemail.com<br />
# 邮箱域名白名单<br />
emailWhitelisted: []<br />
# 是否吧新密码画在图片中？<br />
generateImage: false<br />
# 邮件 OAuth 2 标记 (如果未使用则留空)<br />
emailOauth2Token: ''<br />
#关联<br />
Hooks:<br />
# 是否与 multiverse 的出生点关联？<br />
multiverse: true<br />
# 是否关联 BungeeCord ?（跨服)<br />
bungeecord: false<br />
# 在玩家注册/登录后将玩家发送到某个 BungeeCord 服务器 <br />
sendPlayerTo: ''<br />
# 是否在加入游戏时禁用 Essentials SocialSpy ？<br />
disableSocialSpy: true<br />
# 是否在加入游戏时禁用类似 /motd 的 Essentials 命令？<br />
useEssentialsMotd: false<br />
# 是否缓存 Attributes 自定义？<br />
customAttributes: false<br />
#清理<br />
Purge:<br />
# 如果启用，AuthMe将自动清理掉旧的，未使用的账户<br />
useAutoPurge: false<br />
# 多少天后变为未使用的账户<br />
daysBeforeRemovePlayer: 60<br />
# 是否在清理中顺便清理player.dat文件？<br />
removePlayerDat: false<br />
# 是否在清理中顺便清理 Essentials/users/player.yml 文件？<br />
removeEssentialsFile: false<br />
# 哪个世界存放了 players.dat <br />
defaultWorld: 'world'<br />
# 是否在清理中顺便清理 LimitedCreative/inventories/player.yml, player_creative.yml 文件？<br />
removeLimitedCreativesInventories: false<br />
# 是否在清理中顺便清理 AntiXRayData/PlayerData/player 文件？<br />
removeAntiXRayFile: false<br />
# 是否顺便清理权限？<br />
removePermissions: false<br />
#服务器保护<br />
Protection:<br />
# 启用后服务器将受到一些保护 ( 限制国家登录, 防压测 )<br />
enableProtection: false<br />
# 允许登录和注册的国家，国家代码详情见 http://dev.bukkit.org/bukkit-plugins/authme-reloaded/pages/countries-codes/ <br />
# 请使用引号！！<br />
countries:<br />
- 'US'<br />
- 'GB'<br />
# 黑名单的国家 (不需要启用 protection)<br />
# 请使用引号！！<br />
countriesBlacklist:<br />
- 'A1'<br />
# 是否启用反僵尸压测？<br />
enableAntiBot: false<br />
# 5秒内最大可以登录的玩家 如果启用反压测<br />
antiBotSensibility: 5<br />
# 在多少时间内自动启用反僵尸压测系统<br />
antiBotDuration: 10<br />
VeryGames:<br />
# 这条只是测试 VeryGames 服务器运营商的性能<br />
enableIpCheck: false<br />
<br />
`</div>
梦彗業
https://mineplugin.org/index.php?title=Authme&diff=4059
Authme
2016-09-30T10:47:52Z
<p>梦彗業：/* 权限&指令 */</p>
<hr />
<div>{{Plugin<br />
|version=v未知<br />
|URL=http://dev.bukkit.org/bukkit-plugins/authme/<br />
}}<br />
[[Category:娱乐]]<br />
== 综述 ==<br />
=== 介绍 ===<br />
AuthMe Reloaded<br />
一个注册/登陆插件！<br />
特别是防止被盗号，自动通过UUID更新ID<br />
AuthMe Reloaded可以防止在未登录的情况下放置方块、移动、使用其他命令，或者查看当前的在线玩家数。<br />
只有输入正确的密码才能正常登陆<br />
登陆失败可能是你没有在指定时间内登陆<br />
每个命令和每个设置都可以用极其简单的配置文件来启用或者禁用<br />
如果你不喜欢英语，或者不喜欢作者的翻译，你也可以轻松的自主编辑语言环境！<br />
<br />
=== 特点 ===<br />
可以通过电子邮件找回密码<br />
用户名保护<br />
国家选择！（国家代码）<br />
AntiBot功能！<br />
Passpartu管理员功能：管理员可以设置查看所有用户账户信息。更多查看这里<br />
没有“已经在另外位置登陆”消息登陆会话<br />
可编辑和设置信息<br />
支持MySQL、flatfile和Sqlite<br />
支持的散列算法：MD5、SHA1、SHA256、xAuth、Whirlpool<br />
支持纯文本密码储存<br />
支持PHOBB、VBulletin论坛注册：MD5VB - PHPBB<br />
支持MyBB：MyBB<br />
支持IPB3：IPB3<br />
支持PhpFisuon：PHPFISUON<br />
支持Xenforo SHA1：XFSHA1<br />
支持Xenforo SHA256：XFSHA256<br />
支持joomal：JOOMAL<br />
支持WBB3：WBB3*<br />
支持SHA512：SHA512<br />
支持DoubleSaltedMD5密码：SALTED2MD5<br />
支持WordPass集成和密码：WORDPASS<br />
定制MySQL列表（可用论坛和其他脚本）<br />
数据库查询可用被缓存<br />
兼容NPC和战墙插件<br />
兼容MC Mods，例如BuildCraft和RedStonCraft<br />
可以限制一个ip可以注册的账号数上限<br />
未登录没有指定权限<br />
注册和未注册的有不同的权限组<br />
支持权限在登陆瞬间的改变<br />
缓存玩家物品，包括所有物品和附魔<br />
保存退出位置，以避免损失位置信息<br />
不可以使用权限插件<br />
持续弹出登陆界面<br />
您的所有用户信息和密码备份储存<br />
该FLATFILE auths.db转换为有用的authme.sql，你可以在MySql数据库使用！<br />
从Rakamak或XAUTH导入您的数据库<br />
<br />
=== 权限&指令 ===<br />
==== 权限 ====<br />
authme.player* 所有用户命令<br />
authme.admin* 管理员命令<br />
authme.* 所有用户和管理员命令<br />
==== 指令 ====<br />
===== 玩家指令 =====<br />
指令 权限 默认<br />
/register authme.register true<br />
/login authme.login true<br />
/logout authme.logout ture<br />
/changepassword authme.changepassword false<br />
/unregister autheme.unregister true<br />
===== 管理员指令 =====<br />
指令 权限 默认<br />
/authme register authme.admin.register op<br />
/authme unregister authme.admin.unregister op<br />
/authme reload authme.admin.reload op<br />
/authme changepassword authme.admin.changepassword op<br />
/authme convertflattosql authme.admin.convertflattosql op<br />
<br />
=== 配置 ===<br />
#存储设置<br />
DataSource:<br />
# 你想使用哪种数据库来存储？ sqlite为文件存储<br />
# 可选的值: sqlite, mysql<br />
backend: sqlite<br />
# 是否启用数据库缓存，以提高数据库性能 无需更改<br />
caching: true<br />
# 数据库地址 如果是本机就写127.0.0.1 如果是云端数据库就写ip或者域名<br />
mySQLHost: 127.0.0.1<br />
# 数据库端口号<br />
mySQLPort: '3306'<br />
# 用于连接数据库的用户名(Username)<br />
mySQLUsername: authme<br />
# 用于连接数据库的密码(Password)<br />
mySQLPassword: '12345'<br />
# 数据库名字，或者SQLITE的文件名<br />
mySQLDatabase: authme<br />
# 数据库表名<br />
mySQLTablename: authme<br />
# 用户ID列的名字<br />
mySQLColumnId: id<br />
# 玩家名或昵称列的名字<br />
mySQLColumnName: username<br />
# 密码列的名字<br />
mySQLColumnPassword: password<br />
# 邮箱列的名字<br />
mySQLColumnEmail: email<br />
# 用于存储玩家是否登录的列的名字<br />
mySQLColumnLogged: isLogged<br />
# 玩家ip列的名字<br />
mySQLColumnIp: ip<br />
# 玩家最后登录时间列的名字<br />
mySQLColumnLastLogin: lastlogin<br />
# 最后退出坐标 - X 列的名字<br />
mySQLlastlocX: x<br />
# 最后退出坐标 - Y 列的名字<br />
mySQLlastlocY: y<br />
# 最后退出坐标 - Z 列的名字<br />
mySQLlastlocZ: z<br />
# 最后退出世界 的 世界名字 列的名字<br />
mySQLlastlocWorld: world<br />
# 真实名字列的名字<br />
mySQLRealName: realname<br />
# 如果你想要启用网站注册请开启此项<br />
mySQLWebsite: false<br />
#普通设置<br />
settings:<br />
# 在“帮助”消息中显示的名字<br />
helpHeader: AuthMeReloaded<br />
sessions:<br />
# 你想启用会话缓存(session)功能吗？<br />
# 如果启用，当玩家成功验证后<br />
# 他的IP和昵称将会被存储<br />
# 当他下次进入服务器时，如果他的IP与上次相同<br />
# 并且没有超过下面那项设置的时间<br />
# 他可以不用重新登录<br />
enabled: false<br />
# 几分钟后会话(session)会过期？<br />
# 0 为无限时间 (非常危险，请注意这样设置的风险)<br />
# 此项只决定会话(session)时间, 如果玩家IP改变<br />
# 但是会话(session)没有超时<br />
# 玩家将会由于 “无效的会话” 而被踢出服务器<br />
# 单位是 分钟 <br />
timeout: 10<br />
# 是否在玩家使用别的IP登陆时关闭会话(session)？（就是换ip需要重新验证）<br />
# 建议为true<br />
sessionExpireOnIpChange: true<br />
restrictions:<br />
# 为注册/登录的玩家能否聊天和看到别人聊天？（此项可以防止小白吧密码发出去）<br />
# 注意，将不能使用所有不在下面的<br />
# 命令列表里的命令<br />
allowChat: false<br />
# 警告: 请只在你需要的时候考虑此项<br />
# 如果注册不是强制的 允许未登录用户使用所有命令<br />
allowAllCommandsIfRegistrationIsOptional: false<br />
# 在未验证时允许的命令<br />
allowCommands:<br />
- /login<br />
- /register<br />
- /l<br />
- /reg<br />
- /email<br />
- /captcha<br />
# 每个IP允许注册的账号的最大数目 (默认为: 1)<br />
maxRegPerIp: 1<br />
# 最大用户名长度<br />
maxNicknameLength: 16<br />
# 如果启用此项， 当前在线的玩家将不会被<br />
# "另一位置登录的玩家" 踢出<br />
# 这能提高安全性 但是卡的时候可能会出现 同名玩家已经在游戏<br />
ForceSingleSession: true<br />
# 如果启用， 每当玩家验证成功后<br />
# 都会被传送到世界的出生点<br />
# 玩家退出位置会被覆盖<br />
# 这个与 "传送未登陆的玩家到出生点(teleportUnAuthedToSpawn)" 不同<br />
# 此选项在玩家登录后也会传送<br />
ForceSpawnLocOnJoinEnabled: false<br />
# 此选项将会保存玩家退出位置<br />
SaveQuitLocation: false<br />
# 启用此项将限制<br />
# 指定ID/IP的用户<br />
# 下面是个例子<br />
AllowRestrictedUser: false<br />
# 符合以下id或ip的受限<br />
# 用户将无法进入服务器<br />
# 默认的例子:<br />
# AllowedRestrictedUser:<br />
# - playername;127.0.0.1 <br />
AllowedRestrictedUser:<br />
- playername;127.0.0.1<br />
# 是否踢出未注册的玩家<br />
kickNonRegistered: false<br />
# 是否在玩家输错密码时踢出<br />
kickOnWrongPassword: false<br />
# 是否传送未登陆的玩家到出生点？<br />
# 当他们登陆后他们会被<br />
# 传送回原来的位置 开启后可以防止卡位置<br />
teleportUnAuthedToSpawn: false<br />
# 昵称最小允许长度<br />
minNicknameLength: 4<br />
# 未注册的玩家可以走动吗？<br />
allowMovement: false<br />
# 是否设置未验证的玩家速度 =0？<br />
# 登陆后 飞行/行走 速度将恢复正常<br />
removeSpeed: true<br />
# 在提示 注册/登陆 多久后踢出玩家？<br />
# 设置未0禁用<br />
timeout: 30<br />
# 玩家名字所允许的正则表达式 中文的表达式：[\u4E00-\u9FA5]*或[一-龥]*<br />
allowedNicknameCharacters: '[a-zA-Z0-9_]*'<br />
# 未注册的玩家可以走多远？<br />
# 设为0则无限半径<br />
allowedMovementRadius: 100<br />
# 时候启用双密码验证注册？<br />
# 如果设置为 true 注册时就需要使用：<br />
# /register <密码> <重复密码><br />
enablePasswordConfirmation: true<br />
# 是否在玩家登陆前保存玩家的库存? 需要 ProtocolLib 前置 登陆之前无物品<br />
ProtectInventoryBeforeLogIn: true<br />
# 是否在登录前拒绝玩家使用TAB列表？ 需要 ProtocolLib 前置<br />
DenyTabCompleteBeforeLogin: true<br />
# 是否在玩家登录前隐藏TAB列表？ 需要 ProtocolLib 前置<br />
HideTablistBeforeLogin: true<br />
# 是否在玩家登录是显示其他几个他的账号？<br />
# 权限: /authme.admin.accounts<br />
displayOtherAccounts: true<br />
# ForceSpawnLocOnJoinEnabled 项中那些世界会强制出生点登录<br />
# 区分大小写<br />
ForceSpawnOnTheseWorlds:<br />
- world<br />
- world_nether<br />
- world_the_end<br />
# 当ip没有注册在数据库时，封禁该ip<br />
banUnsafedIP: false<br />
# 出生点优先级， 可选值 : authme, essentials, multiverse, default<br />
spawnPriority: authme,essentials,multiverse,default<br />
# 一个IP可以登录的账号最大数量<br />
maxLoginPerIp: 0<br />
# 一个IP可以加入游戏最大数量<br />
maxJoinPerIp: 0<br />
# 开启后 AuthMe 将绝对不会传送玩家！<br />
noTeleport: false<br />
# 密码允许的字符的正则表达式 不建议更改<br />
allowedPasswordCharacters: '[\x21-\x7E]*'<br />
GameMode:<br />
# 是否在加入游戏时强制生存模式<br />
ForceSurvivalMode: false<br />
security:<br />
# 密码最小长度<br />
minPasswordLength: 5<br />
# 密码最大长度<br />
passwordMaxLength: 30<br />
# 这是一个非常重要的选项，<br />
# 每次玩家加入服务器，<br />
# 如果他们已经注册, AuthMe 将会吧他们移动<br />
# 到未登陆组, 这应该能<br />
# 防止所有重大漏洞<br />
# 你可以在你的权限插件里<br />
# 设置这个特殊的分组，并且拥有 0 个权限， 或只有聊天权限，<br />
# 或者可以发送私人消息<br />
# 或其他消息，以及其他任何你想要设置的权限<br />
# 最好是将这个组设置为<br />
# 只有很少的权限，<br />
# 当某些玩家尝试利用一些不属于他们的账户，<br />
# 他们将只能做你设置过权限的事<br />
# 当他们登陆后，他们会被<br />
# 移动到正常的权限组！<br />
# 注意组名是区分大小写的<br />
# 所以 Admin ≠ admin，<br />
# 否则你的分组将会被抹除,<br />
# 玩家将加入默认的分组 [] 中!<br />
# 例如： unLoggedinGroup: NotLogged<br />
unLoggedinGroup: unLoggedinGroup<br />
# 密码加密算法<br />
# 可以设置的值: MD5, SHA1, SHA256, WHIRLPOOL, XAUTH, MD5VB, PHPBB,<br />
# MYBB, IPB3, IPB4, PHPFUSION, SMF, XENFORO, SALTED2MD5, JOOMLA, BCRYPT, WBB3, SHA512,<br />
# DOUBLEMD5, PBKDF2, PBKDF2DJANGO, WORDPRESS, ROYALAUTH, CUSTOM(开发者限定)<br />
passwordHash: SHA256<br />
# SALTED2MD5 盐度 MD5(MD5(密码)+混搅盐) <br />
doubleMD5SaltLength: 8<br />
# 如果密码检测返回为 false， 是否需要检测一遍<br />
# 其他密码算法来检查这个旧密码？<br />
# AuthMe 将会吧这个密码更新为新的密码加密算法<br />
supportOldPasswordHash: false<br />
# 禁止使用的不安全密码， 请写小写！ 可以防止小白直接写上密码两个字<br />
# 例子：<br />
#unsafePasswords:<br />
#- '123456'<br />
#- '密码'<br />
#- 'password'<br />
unsafePasswords:<br />
- '123456'<br />
- 'password'<br />
- '密码'<br />
- 'qwerty'<br />
- '12345'<br />
- '54321'<br />
registration:<br />
# 是否开放注册？<br />
enabled: true<br />
# 每 X 秒发送一条叫玩家 注册/登录<br />
# 的消息给玩家<br />
messageInterval: 5<br />
# 只有注册玩家可以玩<br />
# 请查看 restrictions 免责条款<br />
force: true<br />
# 是否用邮箱注册来代替密码注册？<br />
enableEmailRegistrationSystem: false<br />
# 是否启用邮箱双重验证<br />
# 当它开启后，注册是否的命令会是：<br />
# /register <邮箱l> <再次输入邮箱><br />
doubleEmailCheck: false<br />
# 是否在注册后踢出玩家？<br />
# 不使用登录功能<br />
forceKickAfterRegister: false<br />
# 是否让 AuthMe 在玩家成功注册后自动执行 /login ？<br />
forceLoginAfterRegister: false<br />
unrestrictions:<br />
# 你可以在下面列出<br />
# AuthMe 将会忽略注册或登录的账户名<br />
# 配置它你需要自己承担风险！！<br />
# 如果你要吧昵称加进 [], 你需要用 ' '括起来.<br />
# 此选项是为了 BuildCraft 和一些其他<br />
# 插件或者mod的兼容性<br />
# 区分大小写！！<br />
UnrestrictedName: []<br />
# 消息语言，可选值 : en, de, br, cz, pl, fr, ru, hu, sk, es, zhtw, fi, zhcn, lt, it, ko, pt 中文请设置zhcn<br />
messagesLanguage: en<br />
# 强制这些命令在 /login 后才可使用，不需要任何 '/' ，并且使用%代替玩家名称<br />
forceCommands: []<br />
# 强制这些后台命令在 /login 后才可使用，不需要任何 '/' ，并且使用%代替玩家名称<br />
forceCommandsAsConsole: []<br />
# 强制这些命令在 /register, 后才可使用，不需要任何 '/' ，并且使用%代替玩家名称<br />
forceRegisterCommands: []<br />
# 强制这些后台命令在 /register, 后才可使用，不需要任何 '/' ，并且使用%代替玩家名称<br />
forceRegisterCommandsAsConsole: []<br />
# 是否需要在登录或者注册后显示欢迎消息(welcome.txt)？<br />
# 你可以在 welcome.txt + 使用不同的颜色和一些替换符号 :<br />
# {PLAYER} : 玩家名， {ONLINE} : 显示在线人数， {MAXPLAYERS} : 显示服务器最大人数，<br />
# {IP} : 玩家IP， {LOGINS} : 登录的玩家数， {WORLD} : 玩家当前所在的世界名， {SERVER} : 服务器名<br />
# {VERSION} : 当前服务器版本， {COUNTRY} : 玩家的国家<br />
useWelcomeMessage: true<br />
# 是向全服广播 welcome.txt 还是只对登录的玩家显示？ 设置为false将只对登录的玩家显示<br />
broadcastWelcomeMessage: false<br />
# 是否延迟加入游戏消息在玩家登录后才显示？<br />
delayJoinMessage: true<br />
# 是否移除加入游戏的消息？<br />
removeJoinMessage: true<br />
# 是否移除离开游戏的消息？<br />
removeLeaveMessage: true<br />
# 是否在登录或者注册前加入药水效果？ 此条可以设置登录前失明<br />
applyBlindEffect: false<br />
# 是否阻止不同态玩家名的登录？<br />
# 如果 Xephi 注册了， 然后 Xephi 能登录， 但是 XEPHI/xephi/XePhI 不能<br />
preventOtherCase: false<br />
#以下为高级设置内容<br />
#外部关联相关设置<br />
ExternalBoardOptions:<br />
# 需要加密的 MySQL 列， 某些 论坛/cms 需要此项支持<br />
mySQLColumnSalt: ''<br />
# 需要分组的 MySQL 列， 某些 论坛/cms 需要此项支持<br />
mySQLColumnGroup: ''<br />
# -1 为不使用。 如果你想要只有<br />
# 已经激活的用户能登录你的服务器<br />
# 你可以在这里写下你的用户组数<br />
# 某些 论坛/cms 需要此项支持<br />
nonActivedUserGroup: -1<br />
# 其他的需要放用户名的 MySQL 列 (区分大小写)<br />
mySQLOtherUsernameColumns: []<br />
# 在 BCrypt 计算多少轮(如果你不知道它是干什么的不要修改它) (bcrypt，是一个跨平台的文件加密工具)<br />
bCryptLog2Round: 10<br />
# 在 phpBB 安装过程中定义的 phpbb 前缀<br />
phpbbTablePrefix: 'phpbb_'<br />
# phpBB 激活组的 id， 2 是 phpbb 默认定义的注册组<br />
phpbbActivatedGroupId: 2<br />
# 在 WordPress 安装过程中定义的 WordPress 前缀<br />
wordpressTablePrefix: 'wp_'<br />
#权限<br />
permission:<br />
# 注意这个选项，如果你不想<br />
# 使用Vault 和Group Switching<br />
# 来区分 AuthMe 的未登陆组，设置为 true<br />
# 否则，默认为 false<br />
EnablePermissionCheck: false<br />
#备份<br />
BackupSystem:<br />
# 启用或者禁用自动备份<br />
ActivateBackup: false<br />
# 是否每次开服都会备份<br />
OnServerStart: false<br />
# 是否每次关服都会备份<br />
OnServerStop: true<br />
# Windows 下 mysql 的安装路径<br />
MysqlWindowsPath: 'C:\\Program Files\\MySQL\\MySQL Server 5.1\\'<br />
#安全<br />
Security:<br />
SQLProblem:<br />
# 如果和数据库断开连接就关服<br />
# 要考虑这个， 如果你设置这个为 false，<br />
# AuthMe 将自动禁用，并且服务器将失去保护！<br />
stopServer: true<br />
ReloadCommand:<br />
# 是否支持 /reload <br />
useReloadCommandSupport: true<br />
console:<br />
# 不在控制台显示消息<br />
noConsoleSpam: false<br />
# 在控制台更换密码是要像玩家那样输入 /login<br />
removePassword: true<br />
# 是否吧AuthMe的记录文件放在单独的文件夹？<br />
logConsole: true<br />
captcha:<br />
# 在玩家输错太多次后他将需要输入验证码<br />
useCaptcha: false<br />
# 在多少次后要求验证码<br />
maxLoginTry: 5<br />
# 验证码长度<br />
captchaLength: 5<br />
stop:<br />
# 在服务器关闭之前踢出所有玩家， 这样能够保存玩家的位置，并且所有<br />
# 信息都正确正常无任何错误<br />
kickPlayersBeforeStopping: true<br />
#转换<br />
Converter:<br />
Rakamak:<br />
# Rakamak 文件名<br />
fileName: users.rak<br />
# Rakamak 使用 ip ?<br />
useIP: false<br />
# rakamak IP 文件名<br />
ipFileName: UsersIp.rak<br />
CrazyLogin:<br />
# CrazyLogin 数据库文件<br />
fileName: accounts.db<br />
#邮件<br />
Email:<br />
# 电子邮件的SMTP服务器主机名<br />
mailSMTP: smtp.gmail.com<br />
# 电子邮件的SMTP服务器主机端口<br />
mailPort: 465<br />
# 发送邮件的账户<br />
mailAccount: ''<br />
# 邮箱密码<br />
mailPassword: ''<br />
# 自定义发件人的名字，这名字将会代替邮箱显示<br />
mailSenderName: ''<br />
# 随机密码长度<br />
RecoveryPasswordLength: 8<br />
# 邮件主题<br />
mailSubject: 'Your new AuthMe Password'<br />
# 有点像最大注册数但是是邮件的<br />
maxRegPerEmail: 1<br />
# 是否提醒玩家添加一个邮件地址？<br />
recallPlayers: false<br />
# 一分钟内提醒多少次<br />
delayRecall: 5<br />
# 邮箱域名黑名单<br />
emailBlacklisted:<br />
- 10minutemail.com<br />
# 邮箱域名白名单<br />
emailWhitelisted: []<br />
# 是否吧新密码画在图片中？<br />
generateImage: false<br />
# 邮件 OAuth 2 标记 (如果未使用则留空)<br />
emailOauth2Token: ''<br />
#关联<br />
Hooks:<br />
# 是否与 multiverse 的出生点关联？<br />
multiverse: true<br />
# 是否关联 BungeeCord ?（跨服)<br />
bungeecord: false<br />
# 在玩家注册/登录后将玩家发送到某个 BungeeCord 服务器 <br />
sendPlayerTo: ''<br />
# 是否在加入游戏时禁用 Essentials SocialSpy ？<br />
disableSocialSpy: true<br />
# 是否在加入游戏时禁用类似 /motd 的 Essentials 命令？<br />
useEssentialsMotd: false<br />
# 是否缓存 Attributes 自定义？<br />
customAttributes: false<br />
#清理<br />
Purge:<br />
# 如果启用，AuthMe将自动清理掉旧的，未使用的账户<br />
useAutoPurge: false<br />
# 多少天后变为未使用的账户<br />
daysBeforeRemovePlayer: 60<br />
# 是否在清理中顺便清理player.dat文件？<br />
removePlayerDat: false<br />
# 是否在清理中顺便清理 Essentials/users/player.yml 文件？<br />
removeEssentialsFile: false<br />
# 哪个世界存放了 players.dat <br />
defaultWorld: 'world'<br />
# 是否在清理中顺便清理 LimitedCreative/inventories/player.yml, player_creative.yml 文件？<br />
removeLimitedCreativesInventories: false<br />
# 是否在清理中顺便清理 AntiXRayData/PlayerData/player 文件？<br />
removeAntiXRayFile: false<br />
# 是否顺便清理权限？<br />
removePermissions: false<br />
#服务器保护<br />
Protection:<br />
# 启用后服务器将受到一些保护 ( 限制国家登录, 防压测 )<br />
enableProtection: false<br />
# 允许登录和注册的国家，国家代码详情见 http://dev.bukkit.org/bukkit-plugins/authme-reloaded/pages/countries-codes/ <br />
# 请使用引号！！<br />
countries:<br />
- 'US'<br />
- 'GB'<br />
# 黑名单的国家 (不需要启用 protection)<br />
# 请使用引号！！<br />
countriesBlacklist:<br />
- 'A1'<br />
# 是否启用反僵尸压测？<br />
enableAntiBot: false<br />
# 5秒内最大可以登录的玩家 如果启用反压测<br />
antiBotSensibility: 5<br />
# 在多少时间内自动启用反僵尸压测系统<br />
antiBotDuration: 10<br />
VeryGames:<br />
# 这条只是测试 VeryGames 服务器运营商的性能<br />
enableIpCheck: false<br />
<br />
`</div>
梦彗業
https://mineplugin.org/index.php?title=Authme&diff=4058
Authme
2016-09-30T10:44:19Z
<p>梦彗業：/* 特点 */</p>
<hr />
<div>{{Plugin<br />
|version=v未知<br />
|URL=http://dev.bukkit.org/bukkit-plugins/authme/<br />
}}<br />
[[Category:娱乐]]<br />
== 综述 ==<br />
=== 介绍 ===<br />
AuthMe Reloaded<br />
一个注册/登陆插件！<br />
特别是防止被盗号，自动通过UUID更新ID<br />
AuthMe Reloaded可以防止在未登录的情况下放置方块、移动、使用其他命令，或者查看当前的在线玩家数。<br />
只有输入正确的密码才能正常登陆<br />
登陆失败可能是你没有在指定时间内登陆<br />
每个命令和每个设置都可以用极其简单的配置文件来启用或者禁用<br />
如果你不喜欢英语，或者不喜欢作者的翻译，你也可以轻松的自主编辑语言环境！<br />
<br />
=== 特点 ===<br />
可以通过电子邮件找回密码<br />
用户名保护<br />
国家选择！（国家代码）<br />
AntiBot功能！<br />
Passpartu管理员功能：管理员可以设置查看所有用户账户信息。更多查看这里<br />
没有“已经在另外位置登陆”消息登陆会话<br />
可编辑和设置信息<br />
支持MySQL、flatfile和Sqlite<br />
支持的散列算法：MD5、SHA1、SHA256、xAuth、Whirlpool<br />
支持纯文本密码储存<br />
支持PHOBB、VBulletin论坛注册：MD5VB - PHPBB<br />
支持MyBB：MyBB<br />
支持IPB3：IPB3<br />
支持PhpFisuon：PHPFISUON<br />
支持Xenforo SHA1：XFSHA1<br />
支持Xenforo SHA256：XFSHA256<br />
支持joomal：JOOMAL<br />
支持WBB3：WBB3*<br />
支持SHA512：SHA512<br />
支持DoubleSaltedMD5密码：SALTED2MD5<br />
支持WordPass集成和密码：WORDPASS<br />
定制MySQL列表（可用论坛和其他脚本）<br />
数据库查询可用被缓存<br />
兼容NPC和战墙插件<br />
兼容MC Mods，例如BuildCraft和RedStonCraft<br />
可以限制一个ip可以注册的账号数上限<br />
未登录没有指定权限<br />
注册和未注册的有不同的权限组<br />
支持权限在登陆瞬间的改变<br />
缓存玩家物品，包括所有物品和附魔<br />
保存退出位置，以避免损失位置信息<br />
不可以使用权限插件<br />
持续弹出登陆界面<br />
您的所有用户信息和密码备份储存<br />
该FLATFILE auths.db转换为有用的authme.sql，你可以在MySql数据库使用！<br />
从Rakamak或XAUTH导入您的数据库<br />
<br />
=== 权限&指令 ===<br />
==== 权限 ====<br />
authme.player* 所有用户命令<br />
authme.admin* 管理员命令<br />
authme.* 所有用户和管理员命令<br />
==== 指令 ====<br />
===== 玩家指令 =====<br />
指令 权限 默认<br />
/register authme.register true<br />
/login authme.login true<br />
/logout authme.logout ture<br />
/changepassword authme.changepassword false<br />
/unregister autheme.unregister true<br />
===== 管理员指令 =====<br />
指令 权限 默认<br />
/authme register authme.admin.register op<br />
/authme unregister authme.admin.unregister op<br />
/authme reload authme.admin.reload op<br />
/authme changepassword authme.admin.changepassword op<br />
/authme convertflattosql authme.admin.convertflattosql op<br />
=== 配置 ===<br />
#存储设置<br />
DataSource:<br />
# 你想使用哪种数据库来存储？ sqlite为文件存储<br />
# 可选的值: sqlite, mysql<br />
backend: sqlite<br />
# 是否启用数据库缓存，以提高数据库性能 无需更改<br />
caching: true<br />
# 数据库地址 如果是本机就写127.0.0.1 如果是云端数据库就写ip或者域名<br />
mySQLHost: 127.0.0.1<br />
# 数据库端口号<br />
mySQLPort: '3306'<br />
# 用于连接数据库的用户名(Username)<br />
mySQLUsername: authme<br />
# 用于连接数据库的密码(Password)<br />
mySQLPassword: '12345'<br />
# 数据库名字，或者SQLITE的文件名<br />
mySQLDatabase: authme<br />
# 数据库表名<br />
mySQLTablename: authme<br />
# 用户ID列的名字<br />
mySQLColumnId: id<br />
# 玩家名或昵称列的名字<br />
mySQLColumnName: username<br />
# 密码列的名字<br />
mySQLColumnPassword: password<br />
# 邮箱列的名字<br />
mySQLColumnEmail: email<br />
# 用于存储玩家是否登录的列的名字<br />
mySQLColumnLogged: isLogged<br />
# 玩家ip列的名字<br />
mySQLColumnIp: ip<br />
# 玩家最后登录时间列的名字<br />
mySQLColumnLastLogin: lastlogin<br />
# 最后退出坐标 - X 列的名字<br />
mySQLlastlocX: x<br />
# 最后退出坐标 - Y 列的名字<br />
mySQLlastlocY: y<br />
# 最后退出坐标 - Z 列的名字<br />
mySQLlastlocZ: z<br />
# 最后退出世界 的 世界名字 列的名字<br />
mySQLlastlocWorld: world<br />
# 真实名字列的名字<br />
mySQLRealName: realname<br />
# 如果你想要启用网站注册请开启此项<br />
mySQLWebsite: false<br />
#普通设置<br />
settings:<br />
# 在“帮助”消息中显示的名字<br />
helpHeader: AuthMeReloaded<br />
sessions:<br />
# 你想启用会话缓存(session)功能吗？<br />
# 如果启用，当玩家成功验证后<br />
# 他的IP和昵称将会被存储<br />
# 当他下次进入服务器时，如果他的IP与上次相同<br />
# 并且没有超过下面那项设置的时间<br />
# 他可以不用重新登录<br />
enabled: false<br />
# 几分钟后会话(session)会过期？<br />
# 0 为无限时间 (非常危险，请注意这样设置的风险)<br />
# 此项只决定会话(session)时间, 如果玩家IP改变<br />
# 但是会话(session)没有超时<br />
# 玩家将会由于 “无效的会话” 而被踢出服务器<br />
# 单位是 分钟 <br />
timeout: 10<br />
# 是否在玩家使用别的IP登陆时关闭会话(session)？（就是换ip需要重新验证）<br />
# 建议为true<br />
sessionExpireOnIpChange: true<br />
restrictions:<br />
# 为注册/登录的玩家能否聊天和看到别人聊天？（此项可以防止小白吧密码发出去）<br />
# 注意，将不能使用所有不在下面的<br />
# 命令列表里的命令<br />
allowChat: false<br />
# 警告: 请只在你需要的时候考虑此项<br />
# 如果注册不是强制的 允许未登录用户使用所有命令<br />
allowAllCommandsIfRegistrationIsOptional: false<br />
# 在未验证时允许的命令<br />
allowCommands:<br />
- /login<br />
- /register<br />
- /l<br />
- /reg<br />
- /email<br />
- /captcha<br />
# 每个IP允许注册的账号的最大数目 (默认为: 1)<br />
maxRegPerIp: 1<br />
# 最大用户名长度<br />
maxNicknameLength: 16<br />
# 如果启用此项， 当前在线的玩家将不会被<br />
# "另一位置登录的玩家" 踢出<br />
# 这能提高安全性 但是卡的时候可能会出现 同名玩家已经在游戏<br />
ForceSingleSession: true<br />
# 如果启用， 每当玩家验证成功后<br />
# 都会被传送到世界的出生点<br />
# 玩家退出位置会被覆盖<br />
# 这个与 "传送未登陆的玩家到出生点(teleportUnAuthedToSpawn)" 不同<br />
# 此选项在玩家登录后也会传送<br />
ForceSpawnLocOnJoinEnabled: false<br />
# 此选项将会保存玩家退出位置<br />
SaveQuitLocation: false<br />
# 启用此项将限制<br />
# 指定ID/IP的用户<br />
# 下面是个例子<br />
AllowRestrictedUser: false<br />
# 符合以下id或ip的受限<br />
# 用户将无法进入服务器<br />
# 默认的例子:<br />
# AllowedRestrictedUser:<br />
# - playername;127.0.0.1 <br />
AllowedRestrictedUser:<br />
- playername;127.0.0.1<br />
# 是否踢出未注册的玩家<br />
kickNonRegistered: false<br />
# 是否在玩家输错密码时踢出<br />
kickOnWrongPassword: false<br />
# 是否传送未登陆的玩家到出生点？<br />
# 当他们登陆后他们会被<br />
# 传送回原来的位置 开启后可以防止卡位置<br />
teleportUnAuthedToSpawn: false<br />
# 昵称最小允许长度<br />
minNicknameLength: 4<br />
# 未注册的玩家可以走动吗？<br />
allowMovement: false<br />
# 是否设置未验证的玩家速度 =0？<br />
# 登陆后 飞行/行走 速度将恢复正常<br />
removeSpeed: true<br />
# 在提示 注册/登陆 多久后踢出玩家？<br />
# 设置未0禁用<br />
timeout: 30<br />
# 玩家名字所允许的正则表达式 中文的表达式：[\u4E00-\u9FA5]*或[一-龥]*<br />
allowedNicknameCharacters: '[a-zA-Z0-9_]*'<br />
# 未注册的玩家可以走多远？<br />
# 设为0则无限半径<br />
allowedMovementRadius: 100<br />
# 时候启用双密码验证注册？<br />
# 如果设置为 true 注册时就需要使用：<br />
# /register <密码> <重复密码><br />
enablePasswordConfirmation: true<br />
# 是否在玩家登陆前保存玩家的库存? 需要 ProtocolLib 前置 登陆之前无物品<br />
ProtectInventoryBeforeLogIn: true<br />
# 是否在登录前拒绝玩家使用TAB列表？ 需要 ProtocolLib 前置<br />
DenyTabCompleteBeforeLogin: true<br />
# 是否在玩家登录前隐藏TAB列表？ 需要 ProtocolLib 前置<br />
HideTablistBeforeLogin: true<br />
# 是否在玩家登录是显示其他几个他的账号？<br />
# 权限: /authme.admin.accounts<br />
displayOtherAccounts: true<br />
# ForceSpawnLocOnJoinEnabled 项中那些世界会强制出生点登录<br />
# 区分大小写<br />
ForceSpawnOnTheseWorlds:<br />
- world<br />
- world_nether<br />
- world_the_end<br />
# 当ip没有注册在数据库时，封禁该ip<br />
banUnsafedIP: false<br />
# 出生点优先级， 可选值 : authme, essentials, multiverse, default<br />
spawnPriority: authme,essentials,multiverse,default<br />
# 一个IP可以登录的账号最大数量<br />
maxLoginPerIp: 0<br />
# 一个IP可以加入游戏最大数量<br />
maxJoinPerIp: 0<br />
# 开启后 AuthMe 将绝对不会传送玩家！<br />
noTeleport: false<br />
# 密码允许的字符的正则表达式 不建议更改<br />
allowedPasswordCharacters: '[\x21-\x7E]*'<br />
GameMode:<br />
# 是否在加入游戏时强制生存模式<br />
ForceSurvivalMode: false<br />
security:<br />
# 密码最小长度<br />
minPasswordLength: 5<br />
# 密码最大长度<br />
passwordMaxLength: 30<br />
# 这是一个非常重要的选项，<br />
# 每次玩家加入服务器，<br />
# 如果他们已经注册, AuthMe 将会吧他们移动<br />
# 到未登陆组, 这应该能<br />
# 防止所有重大漏洞<br />
# 你可以在你的权限插件里<br />
# 设置这个特殊的分组，并且拥有 0 个权限， 或只有聊天权限，<br />
# 或者可以发送私人消息<br />
# 或其他消息，以及其他任何你想要设置的权限<br />
# 最好是将这个组设置为<br />
# 只有很少的权限，<br />
# 当某些玩家尝试利用一些不属于他们的账户，<br />
# 他们将只能做你设置过权限的事<br />
# 当他们登陆后，他们会被<br />
# 移动到正常的权限组！<br />
# 注意组名是区分大小写的<br />
# 所以 Admin ≠ admin，<br />
# 否则你的分组将会被抹除,<br />
# 玩家将加入默认的分组 [] 中!<br />
# 例如： unLoggedinGroup: NotLogged<br />
unLoggedinGroup: unLoggedinGroup<br />
# 密码加密算法<br />
# 可以设置的值: MD5, SHA1, SHA256, WHIRLPOOL, XAUTH, MD5VB, PHPBB,<br />
# MYBB, IPB3, IPB4, PHPFUSION, SMF, XENFORO, SALTED2MD5, JOOMLA, BCRYPT, WBB3, SHA512,<br />
# DOUBLEMD5, PBKDF2, PBKDF2DJANGO, WORDPRESS, ROYALAUTH, CUSTOM(开发者限定)<br />
passwordHash: SHA256<br />
# SALTED2MD5 盐度 MD5(MD5(密码)+混搅盐) <br />
doubleMD5SaltLength: 8<br />
# 如果密码检测返回为 false， 是否需要检测一遍<br />
# 其他密码算法来检查这个旧密码？<br />
# AuthMe 将会吧这个密码更新为新的密码加密算法<br />
supportOldPasswordHash: false<br />
# 禁止使用的不安全密码， 请写小写！ 可以防止小白直接写上密码两个字<br />
# 例子：<br />
#unsafePasswords:<br />
#- '123456'<br />
#- '密码'<br />
#- 'password'<br />
unsafePasswords:<br />
- '123456'<br />
- 'password'<br />
- '密码'<br />
- 'qwerty'<br />
- '12345'<br />
- '54321'<br />
registration:<br />
# 是否开放注册？<br />
enabled: true<br />
# 每 X 秒发送一条叫玩家 注册/登录<br />
# 的消息给玩家<br />
messageInterval: 5<br />
# 只有注册玩家可以玩<br />
# 请查看 restrictions 免责条款<br />
force: true<br />
# 是否用邮箱注册来代替密码注册？<br />
enableEmailRegistrationSystem: false<br />
# 是否启用邮箱双重验证<br />
# 当它开启后，注册是否的命令会是：<br />
# /register <邮箱l> <再次输入邮箱><br />
doubleEmailCheck: false<br />
# 是否在注册后踢出玩家？<br />
# 不使用登录功能<br />
forceKickAfterRegister: false<br />
# 是否让 AuthMe 在玩家成功注册后自动执行 /login ？<br />
forceLoginAfterRegister: false<br />
unrestrictions:<br />
# 你可以在下面列出<br />
# AuthMe 将会忽略注册或登录的账户名<br />
# 配置它你需要自己承担风险！！<br />
# 如果你要吧昵称加进 [], 你需要用 ' '括起来.<br />
# 此选项是为了 BuildCraft 和一些其他<br />
# 插件或者mod的兼容性<br />
# 区分大小写！！<br />
UnrestrictedName: []<br />
# 消息语言，可选值 : en, de, br, cz, pl, fr, ru, hu, sk, es, zhtw, fi, zhcn, lt, it, ko, pt 中文请设置zhcn<br />
messagesLanguage: en<br />
# 强制这些命令在 /login 后才可使用，不需要任何 '/' ，并且使用%代替玩家名称<br />
forceCommands: []<br />
# 强制这些后台命令在 /login 后才可使用，不需要任何 '/' ，并且使用%代替玩家名称<br />
forceCommandsAsConsole: []<br />
# 强制这些命令在 /register, 后才可使用，不需要任何 '/' ，并且使用%代替玩家名称<br />
forceRegisterCommands: []<br />
# 强制这些后台命令在 /register, 后才可使用，不需要任何 '/' ，并且使用%代替玩家名称<br />
forceRegisterCommandsAsConsole: []<br />
# 是否需要在登录或者注册后显示欢迎消息(welcome.txt)？<br />
# 你可以在 welcome.txt + 使用不同的颜色和一些替换符号 :<br />
# {PLAYER} : 玩家名， {ONLINE} : 显示在线人数， {MAXPLAYERS} : 显示服务器最大人数，<br />
# {IP} : 玩家IP， {LOGINS} : 登录的玩家数， {WORLD} : 玩家当前所在的世界名， {SERVER} : 服务器名<br />
# {VERSION} : 当前服务器版本， {COUNTRY} : 玩家的国家<br />
useWelcomeMessage: true<br />
# 是向全服广播 welcome.txt 还是只对登录的玩家显示？ 设置为false将只对登录的玩家显示<br />
broadcastWelcomeMessage: false<br />
# 是否延迟加入游戏消息在玩家登录后才显示？<br />
delayJoinMessage: true<br />
# 是否移除加入游戏的消息？<br />
removeJoinMessage: true<br />
# 是否移除离开游戏的消息？<br />
removeLeaveMessage: true<br />
# 是否在登录或者注册前加入药水效果？ 此条可以设置登录前失明<br />
applyBlindEffect: false<br />
# 是否阻止不同态玩家名的登录？<br />
# 如果 Xephi 注册了， 然后 Xephi 能登录， 但是 XEPHI/xephi/XePhI 不能<br />
preventOtherCase: false<br />
#以下为高级设置内容<br />
#外部关联相关设置<br />
ExternalBoardOptions:<br />
# 需要加密的 MySQL 列， 某些 论坛/cms 需要此项支持<br />
mySQLColumnSalt: ''<br />
# 需要分组的 MySQL 列， 某些 论坛/cms 需要此项支持<br />
mySQLColumnGroup: ''<br />
# -1 为不使用。 如果你想要只有<br />
# 已经激活的用户能登录你的服务器<br />
# 你可以在这里写下你的用户组数<br />
# 某些 论坛/cms 需要此项支持<br />
nonActivedUserGroup: -1<br />
# 其他的需要放用户名的 MySQL 列 (区分大小写)<br />
mySQLOtherUsernameColumns: []<br />
# 在 BCrypt 计算多少轮(如果你不知道它是干什么的不要修改它) (bcrypt，是一个跨平台的文件加密工具)<br />
bCryptLog2Round: 10<br />
# 在 phpBB 安装过程中定义的 phpbb 前缀<br />
phpbbTablePrefix: 'phpbb_'<br />
# phpBB 激活组的 id， 2 是 phpbb 默认定义的注册组<br />
phpbbActivatedGroupId: 2<br />
# 在 WordPress 安装过程中定义的 WordPress 前缀<br />
wordpressTablePrefix: 'wp_'<br />
#权限<br />
permission:<br />
# 注意这个选项，如果你不想<br />
# 使用Vault 和Group Switching<br />
# 来区分 AuthMe 的未登陆组，设置为 true<br />
# 否则，默认为 false<br />
EnablePermissionCheck: false<br />
#备份<br />
BackupSystem:<br />
# 启用或者禁用自动备份<br />
ActivateBackup: false<br />
# 是否每次开服都会备份<br />
OnServerStart: false<br />
# 是否每次关服都会备份<br />
OnServerStop: true<br />
# Windows 下 mysql 的安装路径<br />
MysqlWindowsPath: 'C:\\Program Files\\MySQL\\MySQL Server 5.1\\'<br />
#安全<br />
Security:<br />
SQLProblem:<br />
# 如果和数据库断开连接就关服<br />
# 要考虑这个， 如果你设置这个为 false，<br />
# AuthMe 将自动禁用，并且服务器将失去保护！<br />
stopServer: true<br />
ReloadCommand:<br />
# 是否支持 /reload <br />
useReloadCommandSupport: true<br />
console:<br />
# 不在控制台显示消息<br />
noConsoleSpam: false<br />
# 在控制台更换密码是要像玩家那样输入 /login<br />
removePassword: true<br />
# 是否吧AuthMe的记录文件放在单独的文件夹？<br />
logConsole: true<br />
captcha:<br />
# 在玩家输错太多次后他将需要输入验证码<br />
useCaptcha: false<br />
# 在多少次后要求验证码<br />
maxLoginTry: 5<br />
# 验证码长度<br />
captchaLength: 5<br />
stop:<br />
# 在服务器关闭之前踢出所有玩家， 这样能够保存玩家的位置，并且所有<br />
# 信息都正确正常无任何错误<br />
kickPlayersBeforeStopping: true<br />
#转换<br />
Converter:<br />
Rakamak:<br />
# Rakamak 文件名<br />
fileName: users.rak<br />
# Rakamak 使用 ip ?<br />
useIP: false<br />
# rakamak IP 文件名<br />
ipFileName: UsersIp.rak<br />
CrazyLogin:<br />
# CrazyLogin 数据库文件<br />
fileName: accounts.db<br />
#邮件<br />
Email:<br />
# 电子邮件的SMTP服务器主机名<br />
mailSMTP: smtp.gmail.com<br />
# 电子邮件的SMTP服务器主机端口<br />
mailPort: 465<br />
# 发送邮件的账户<br />
mailAccount: ''<br />
# 邮箱密码<br />
mailPassword: ''<br />
# 自定义发件人的名字，这名字将会代替邮箱显示<br />
mailSenderName: ''<br />
# 随机密码长度<br />
RecoveryPasswordLength: 8<br />
# 邮件主题<br />
mailSubject: 'Your new AuthMe Password'<br />
# 有点像最大注册数但是是邮件的<br />
maxRegPerEmail: 1<br />
# 是否提醒玩家添加一个邮件地址？<br />
recallPlayers: false<br />
# 一分钟内提醒多少次<br />
delayRecall: 5<br />
# 邮箱域名黑名单<br />
emailBlacklisted:<br />
- 10minutemail.com<br />
# 邮箱域名白名单<br />
emailWhitelisted: []<br />
# 是否吧新密码画在图片中？<br />
generateImage: false<br />
# 邮件 OAuth 2 标记 (如果未使用则留空)<br />
emailOauth2Token: ''<br />
#关联<br />
Hooks:<br />
# 是否与 multiverse 的出生点关联？<br />
multiverse: true<br />
# 是否关联 BungeeCord ?（跨服)<br />
bungeecord: false<br />
# 在玩家注册/登录后将玩家发送到某个 BungeeCord 服务器 <br />
sendPlayerTo: ''<br />
# 是否在加入游戏时禁用 Essentials SocialSpy ？<br />
disableSocialSpy: true<br />
# 是否在加入游戏时禁用类似 /motd 的 Essentials 命令？<br />
useEssentialsMotd: false<br />
# 是否缓存 Attributes 自定义？<br />
customAttributes: false<br />
#清理<br />
Purge:<br />
# 如果启用，AuthMe将自动清理掉旧的，未使用的账户<br />
useAutoPurge: false<br />
# 多少天后变为未使用的账户<br />
daysBeforeRemovePlayer: 60<br />
# 是否在清理中顺便清理player.dat文件？<br />
removePlayerDat: false<br />
# 是否在清理中顺便清理 Essentials/users/player.yml 文件？<br />
removeEssentialsFile: false<br />
# 哪个世界存放了 players.dat <br />
defaultWorld: 'world'<br />
# 是否在清理中顺便清理 LimitedCreative/inventories/player.yml, player_creative.yml 文件？<br />
removeLimitedCreativesInventories: false<br />
# 是否在清理中顺便清理 AntiXRayData/PlayerData/player 文件？<br />
removeAntiXRayFile: false<br />
# 是否顺便清理权限？<br />
removePermissions: false<br />
#服务器保护<br />
Protection:<br />
# 启用后服务器将受到一些保护 ( 限制国家登录, 防压测 )<br />
enableProtection: false<br />
# 允许登录和注册的国家，国家代码详情见 http://dev.bukkit.org/bukkit-plugins/authme-reloaded/pages/countries-codes/ <br />
# 请使用引号！！<br />
countries:<br />
- 'US'<br />
- 'GB'<br />
# 黑名单的国家 (不需要启用 protection)<br />
# 请使用引号！！<br />
countriesBlacklist:<br />
- 'A1'<br />
# 是否启用反僵尸压测？<br />
enableAntiBot: false<br />
# 5秒内最大可以登录的玩家 如果启用反压测<br />
antiBotSensibility: 5<br />
# 在多少时间内自动启用反僵尸压测系统<br />
antiBotDuration: 10<br />
VeryGames:<br />
# 这条只是测试 VeryGames 服务器运营商的性能<br />
enableIpCheck: false<br />
<br />
`</div>
梦彗業
https://mineplugin.org/index.php?title=Authme&diff=4057
Authme
2016-09-30T10:42:15Z
<p>梦彗業：/* 介绍 */</p>
<hr />
<div>{{Plugin<br />
|version=v未知<br />
|URL=http://dev.bukkit.org/bukkit-plugins/authme/<br />
}}<br />
[[Category:娱乐]]<br />
== 综述 ==<br />
=== 介绍 ===<br />
AuthMe Reloaded<br />
一个注册/登陆插件！<br />
特别是防止被盗号，自动通过UUID更新ID<br />
AuthMe Reloaded可以防止在未登录的情况下放置方块、移动、使用其他命令，或者查看当前的在线玩家数。<br />
只有输入正确的密码才能正常登陆<br />
登陆失败可能是你没有在指定时间内登陆<br />
每个命令和每个设置都可以用极其简单的配置文件来启用或者禁用<br />
如果你不喜欢英语，或者不喜欢作者的翻译，你也可以轻松的自主编辑语言环境！<br />
<br />
=== 特点 ===<br />
可以通过电子邮件找回密码<br />
用户名保护<br />
国家选择！（国家代码）<br />
AntiBot功能！<br />
Passpartu管理员功能：管理员可以设置查看所有用户账户信息。更多查看这里<br />
没有“已经在另外位置登陆”消息登陆会话<br />
可编辑和设置信息<br />
支持MySQL、flatfile和SQLITE<br />
支持的散列算法：MD5、SHA1、SHA256、xAuth、Whirlpool<br />
支持纯文本密码储存<br />
支持PHOBB、VBulletin论坛注册：MD5VB - PHPBB<br />
支持MyBB：MyBB<br />
支持IPB3：IPB3<br />
支持PhpFisuon：PHPFISUON<br />
支持Xenforo SHA1：XFSHA1<br />
支持Xenforo SHA256：XFSHA256<br />
支持joomal：JOOMAL<br />
支持WBB3：WBB3*<br />
支持SHA512：SHA512<br />
支持DoubleSaltedMD5密码：SALTED2MD5<br />
支持WordPass集成和密码：WORDPASS<br />
定制MySQL列表（可用论坛和其他脚本）<br />
数据库查询可用被缓存<br />
兼容npc和战墙插件<br />
兼容mc mods 像BuildCraft和RedStonCraft<br />
可以限制一个ip可以注册的账号数<br />
未登录没有权限<br />
注册和未注册的有不同的权限组<br />
支持权限在登陆瞬间的库系统<br />
缓存玩家物品，所有物品和附魔<br />
保存退出位置，以避免损失位置<br />
不可以使用权限插件<br />
持续弹出登陆界面<br />
您的所有用户信息和密码备份储存<br />
该FLATFILE auths.db转换为有用的authme.sql，你可以在MySql数据库使用！<br />
从Rakamak或XAUTH导入您的数据库<br />
=== 权限&指令 ===<br />
==== 权限 ====<br />
authme.player* 所有用户命令<br />
authme.admin* 管理员命令<br />
authme.* 所有用户和管理员命令<br />
==== 指令 ====<br />
===== 玩家指令 =====<br />
指令 权限 默认<br />
/register authme.register true<br />
/login authme.login true<br />
/logout authme.logout ture<br />
/changepassword authme.changepassword false<br />
/unregister autheme.unregister true<br />
===== 管理员指令 =====<br />
指令 权限 默认<br />
/authme register authme.admin.register op<br />
/authme unregister authme.admin.unregister op<br />
/authme reload authme.admin.reload op<br />
/authme changepassword authme.admin.changepassword op<br />
/authme convertflattosql authme.admin.convertflattosql op<br />
=== 配置 ===<br />
#存储设置<br />
DataSource:<br />
# 你想使用哪种数据库来存储？ sqlite为文件存储<br />
# 可选的值: sqlite, mysql<br />
backend: sqlite<br />
# 是否启用数据库缓存，以提高数据库性能 无需更改<br />
caching: true<br />
# 数据库地址 如果是本机就写127.0.0.1 如果是云端数据库就写ip或者域名<br />
mySQLHost: 127.0.0.1<br />
# 数据库端口号<br />
mySQLPort: '3306'<br />
# 用于连接数据库的用户名(Username)<br />
mySQLUsername: authme<br />
# 用于连接数据库的密码(Password)<br />
mySQLPassword: '12345'<br />
# 数据库名字，或者SQLITE的文件名<br />
mySQLDatabase: authme<br />
# 数据库表名<br />
mySQLTablename: authme<br />
# 用户ID列的名字<br />
mySQLColumnId: id<br />
# 玩家名或昵称列的名字<br />
mySQLColumnName: username<br />
# 密码列的名字<br />
mySQLColumnPassword: password<br />
# 邮箱列的名字<br />
mySQLColumnEmail: email<br />
# 用于存储玩家是否登录的列的名字<br />
mySQLColumnLogged: isLogged<br />
# 玩家ip列的名字<br />
mySQLColumnIp: ip<br />
# 玩家最后登录时间列的名字<br />
mySQLColumnLastLogin: lastlogin<br />
# 最后退出坐标 - X 列的名字<br />
mySQLlastlocX: x<br />
# 最后退出坐标 - Y 列的名字<br />
mySQLlastlocY: y<br />
# 最后退出坐标 - Z 列的名字<br />
mySQLlastlocZ: z<br />
# 最后退出世界 的 世界名字 列的名字<br />
mySQLlastlocWorld: world<br />
# 真实名字列的名字<br />
mySQLRealName: realname<br />
# 如果你想要启用网站注册请开启此项<br />
mySQLWebsite: false<br />
#普通设置<br />
settings:<br />
# 在“帮助”消息中显示的名字<br />
helpHeader: AuthMeReloaded<br />
sessions:<br />
# 你想启用会话缓存(session)功能吗？<br />
# 如果启用，当玩家成功验证后<br />
# 他的IP和昵称将会被存储<br />
# 当他下次进入服务器时，如果他的IP与上次相同<br />
# 并且没有超过下面那项设置的时间<br />
# 他可以不用重新登录<br />
enabled: false<br />
# 几分钟后会话(session)会过期？<br />
# 0 为无限时间 (非常危险，请注意这样设置的风险)<br />
# 此项只决定会话(session)时间, 如果玩家IP改变<br />
# 但是会话(session)没有超时<br />
# 玩家将会由于 “无效的会话” 而被踢出服务器<br />
# 单位是 分钟 <br />
timeout: 10<br />
# 是否在玩家使用别的IP登陆时关闭会话(session)？（就是换ip需要重新验证）<br />
# 建议为true<br />
sessionExpireOnIpChange: true<br />
restrictions:<br />
# 为注册/登录的玩家能否聊天和看到别人聊天？（此项可以防止小白吧密码发出去）<br />
# 注意，将不能使用所有不在下面的<br />
# 命令列表里的命令<br />
allowChat: false<br />
# 警告: 请只在你需要的时候考虑此项<br />
# 如果注册不是强制的 允许未登录用户使用所有命令<br />
allowAllCommandsIfRegistrationIsOptional: false<br />
# 在未验证时允许的命令<br />
allowCommands:<br />
- /login<br />
- /register<br />
- /l<br />
- /reg<br />
- /email<br />
- /captcha<br />
# 每个IP允许注册的账号的最大数目 (默认为: 1)<br />
maxRegPerIp: 1<br />
# 最大用户名长度<br />
maxNicknameLength: 16<br />
# 如果启用此项， 当前在线的玩家将不会被<br />
# "另一位置登录的玩家" 踢出<br />
# 这能提高安全性 但是卡的时候可能会出现 同名玩家已经在游戏<br />
ForceSingleSession: true<br />
# 如果启用， 每当玩家验证成功后<br />
# 都会被传送到世界的出生点<br />
# 玩家退出位置会被覆盖<br />
# 这个与 "传送未登陆的玩家到出生点(teleportUnAuthedToSpawn)" 不同<br />
# 此选项在玩家登录后也会传送<br />
ForceSpawnLocOnJoinEnabled: false<br />
# 此选项将会保存玩家退出位置<br />
SaveQuitLocation: false<br />
# 启用此项将限制<br />
# 指定ID/IP的用户<br />
# 下面是个例子<br />
AllowRestrictedUser: false<br />
# 符合以下id或ip的受限<br />
# 用户将无法进入服务器<br />
# 默认的例子:<br />
# AllowedRestrictedUser:<br />
# - playername;127.0.0.1 <br />
AllowedRestrictedUser:<br />
- playername;127.0.0.1<br />
# 是否踢出未注册的玩家<br />
kickNonRegistered: false<br />
# 是否在玩家输错密码时踢出<br />
kickOnWrongPassword: false<br />
# 是否传送未登陆的玩家到出生点？<br />
# 当他们登陆后他们会被<br />
# 传送回原来的位置 开启后可以防止卡位置<br />
teleportUnAuthedToSpawn: false<br />
# 昵称最小允许长度<br />
minNicknameLength: 4<br />
# 未注册的玩家可以走动吗？<br />
allowMovement: false<br />
# 是否设置未验证的玩家速度 =0？<br />
# 登陆后 飞行/行走 速度将恢复正常<br />
removeSpeed: true<br />
# 在提示 注册/登陆 多久后踢出玩家？<br />
# 设置未0禁用<br />
timeout: 30<br />
# 玩家名字所允许的正则表达式 中文的表达式：[\u4E00-\u9FA5]*或[一-龥]*<br />
allowedNicknameCharacters: '[a-zA-Z0-9_]*'<br />
# 未注册的玩家可以走多远？<br />
# 设为0则无限半径<br />
allowedMovementRadius: 100<br />
# 时候启用双密码验证注册？<br />
# 如果设置为 true 注册时就需要使用：<br />
# /register <密码> <重复密码><br />
enablePasswordConfirmation: true<br />
# 是否在玩家登陆前保存玩家的库存? 需要 ProtocolLib 前置 登陆之前无物品<br />
ProtectInventoryBeforeLogIn: true<br />
# 是否在登录前拒绝玩家使用TAB列表？ 需要 ProtocolLib 前置<br />
DenyTabCompleteBeforeLogin: true<br />
# 是否在玩家登录前隐藏TAB列表？ 需要 ProtocolLib 前置<br />
HideTablistBeforeLogin: true<br />
# 是否在玩家登录是显示其他几个他的账号？<br />
# 权限: /authme.admin.accounts<br />
displayOtherAccounts: true<br />
# ForceSpawnLocOnJoinEnabled 项中那些世界会强制出生点登录<br />
# 区分大小写<br />
ForceSpawnOnTheseWorlds:<br />
- world<br />
- world_nether<br />
- world_the_end<br />
# 当ip没有注册在数据库时，封禁该ip<br />
banUnsafedIP: false<br />
# 出生点优先级， 可选值 : authme, essentials, multiverse, default<br />
spawnPriority: authme,essentials,multiverse,default<br />
# 一个IP可以登录的账号最大数量<br />
maxLoginPerIp: 0<br />
# 一个IP可以加入游戏最大数量<br />
maxJoinPerIp: 0<br />
# 开启后 AuthMe 将绝对不会传送玩家！<br />
noTeleport: false<br />
# 密码允许的字符的正则表达式 不建议更改<br />
allowedPasswordCharacters: '[\x21-\x7E]*'<br />
GameMode:<br />
# 是否在加入游戏时强制生存模式<br />
ForceSurvivalMode: false<br />
security:<br />
# 密码最小长度<br />
minPasswordLength: 5<br />
# 密码最大长度<br />
passwordMaxLength: 30<br />
# 这是一个非常重要的选项，<br />
# 每次玩家加入服务器，<br />
# 如果他们已经注册, AuthMe 将会吧他们移动<br />
# 到未登陆组, 这应该能<br />
# 防止所有重大漏洞<br />
# 你可以在你的权限插件里<br />
# 设置这个特殊的分组，并且拥有 0 个权限， 或只有聊天权限，<br />
# 或者可以发送私人消息<br />
# 或其他消息，以及其他任何你想要设置的权限<br />
# 最好是将这个组设置为<br />
# 只有很少的权限，<br />
# 当某些玩家尝试利用一些不属于他们的账户，<br />
# 他们将只能做你设置过权限的事<br />
# 当他们登陆后，他们会被<br />
# 移动到正常的权限组！<br />
# 注意组名是区分大小写的<br />
# 所以 Admin ≠ admin，<br />
# 否则你的分组将会被抹除,<br />
# 玩家将加入默认的分组 [] 中!<br />
# 例如： unLoggedinGroup: NotLogged<br />
unLoggedinGroup: unLoggedinGroup<br />
# 密码加密算法<br />
# 可以设置的值: MD5, SHA1, SHA256, WHIRLPOOL, XAUTH, MD5VB, PHPBB,<br />
# MYBB, IPB3, IPB4, PHPFUSION, SMF, XENFORO, SALTED2MD5, JOOMLA, BCRYPT, WBB3, SHA512,<br />
# DOUBLEMD5, PBKDF2, PBKDF2DJANGO, WORDPRESS, ROYALAUTH, CUSTOM(开发者限定)<br />
passwordHash: SHA256<br />
# SALTED2MD5 盐度 MD5(MD5(密码)+混搅盐) <br />
doubleMD5SaltLength: 8<br />
# 如果密码检测返回为 false， 是否需要检测一遍<br />
# 其他密码算法来检查这个旧密码？<br />
# AuthMe 将会吧这个密码更新为新的密码加密算法<br />
supportOldPasswordHash: false<br />
# 禁止使用的不安全密码， 请写小写！ 可以防止小白直接写上密码两个字<br />
# 例子：<br />
#unsafePasswords:<br />
#- '123456'<br />
#- '密码'<br />
#- 'password'<br />
unsafePasswords:<br />
- '123456'<br />
- 'password'<br />
- '密码'<br />
- 'qwerty'<br />
- '12345'<br />
- '54321'<br />
registration:<br />
# 是否开放注册？<br />
enabled: true<br />
# 每 X 秒发送一条叫玩家 注册/登录<br />
# 的消息给玩家<br />
messageInterval: 5<br />
# 只有注册玩家可以玩<br />
# 请查看 restrictions 免责条款<br />
force: true<br />
# 是否用邮箱注册来代替密码注册？<br />
enableEmailRegistrationSystem: false<br />
# 是否启用邮箱双重验证<br />
# 当它开启后，注册是否的命令会是：<br />
# /register <邮箱l> <再次输入邮箱><br />
doubleEmailCheck: false<br />
# 是否在注册后踢出玩家？<br />
# 不使用登录功能<br />
forceKickAfterRegister: false<br />
# 是否让 AuthMe 在玩家成功注册后自动执行 /login ？<br />
forceLoginAfterRegister: false<br />
unrestrictions:<br />
# 你可以在下面列出<br />
# AuthMe 将会忽略注册或登录的账户名<br />
# 配置它你需要自己承担风险！！<br />
# 如果你要吧昵称加进 [], 你需要用 ' '括起来.<br />
# 此选项是为了 BuildCraft 和一些其他<br />
# 插件或者mod的兼容性<br />
# 区分大小写！！<br />
UnrestrictedName: []<br />
# 消息语言，可选值 : en, de, br, cz, pl, fr, ru, hu, sk, es, zhtw, fi, zhcn, lt, it, ko, pt 中文请设置zhcn<br />
messagesLanguage: en<br />
# 强制这些命令在 /login 后才可使用，不需要任何 '/' ，并且使用%代替玩家名称<br />
forceCommands: []<br />
# 强制这些后台命令在 /login 后才可使用，不需要任何 '/' ，并且使用%代替玩家名称<br />
forceCommandsAsConsole: []<br />
# 强制这些命令在 /register, 后才可使用，不需要任何 '/' ，并且使用%代替玩家名称<br />
forceRegisterCommands: []<br />
# 强制这些后台命令在 /register, 后才可使用，不需要任何 '/' ，并且使用%代替玩家名称<br />
forceRegisterCommandsAsConsole: []<br />
# 是否需要在登录或者注册后显示欢迎消息(welcome.txt)？<br />
# 你可以在 welcome.txt + 使用不同的颜色和一些替换符号 :<br />
# {PLAYER} : 玩家名， {ONLINE} : 显示在线人数， {MAXPLAYERS} : 显示服务器最大人数，<br />
# {IP} : 玩家IP， {LOGINS} : 登录的玩家数， {WORLD} : 玩家当前所在的世界名， {SERVER} : 服务器名<br />
# {VERSION} : 当前服务器版本， {COUNTRY} : 玩家的国家<br />
useWelcomeMessage: true<br />
# 是向全服广播 welcome.txt 还是只对登录的玩家显示？ 设置为false将只对登录的玩家显示<br />
broadcastWelcomeMessage: false<br />
# 是否延迟加入游戏消息在玩家登录后才显示？<br />
delayJoinMessage: true<br />
# 是否移除加入游戏的消息？<br />
removeJoinMessage: true<br />
# 是否移除离开游戏的消息？<br />
removeLeaveMessage: true<br />
# 是否在登录或者注册前加入药水效果？ 此条可以设置登录前失明<br />
applyBlindEffect: false<br />
# 是否阻止不同态玩家名的登录？<br />
# 如果 Xephi 注册了， 然后 Xephi 能登录， 但是 XEPHI/xephi/XePhI 不能<br />
preventOtherCase: false<br />
#以下为高级设置内容<br />
#外部关联相关设置<br />
ExternalBoardOptions:<br />
# 需要加密的 MySQL 列， 某些 论坛/cms 需要此项支持<br />
mySQLColumnSalt: ''<br />
# 需要分组的 MySQL 列， 某些 论坛/cms 需要此项支持<br />
mySQLColumnGroup: ''<br />
# -1 为不使用。 如果你想要只有<br />
# 已经激活的用户能登录你的服务器<br />
# 你可以在这里写下你的用户组数<br />
# 某些 论坛/cms 需要此项支持<br />
nonActivedUserGroup: -1<br />
# 其他的需要放用户名的 MySQL 列 (区分大小写)<br />
mySQLOtherUsernameColumns: []<br />
# 在 BCrypt 计算多少轮(如果你不知道它是干什么的不要修改它) (bcrypt，是一个跨平台的文件加密工具)<br />
bCryptLog2Round: 10<br />
# 在 phpBB 安装过程中定义的 phpbb 前缀<br />
phpbbTablePrefix: 'phpbb_'<br />
# phpBB 激活组的 id， 2 是 phpbb 默认定义的注册组<br />
phpbbActivatedGroupId: 2<br />
# 在 WordPress 安装过程中定义的 WordPress 前缀<br />
wordpressTablePrefix: 'wp_'<br />
#权限<br />
permission:<br />
# 注意这个选项，如果你不想<br />
# 使用Vault 和Group Switching<br />
# 来区分 AuthMe 的未登陆组，设置为 true<br />
# 否则，默认为 false<br />
EnablePermissionCheck: false<br />
#备份<br />
BackupSystem:<br />
# 启用或者禁用自动备份<br />
ActivateBackup: false<br />
# 是否每次开服都会备份<br />
OnServerStart: false<br />
# 是否每次关服都会备份<br />
OnServerStop: true<br />
# Windows 下 mysql 的安装路径<br />
MysqlWindowsPath: 'C:\\Program Files\\MySQL\\MySQL Server 5.1\\'<br />
#安全<br />
Security:<br />
SQLProblem:<br />
# 如果和数据库断开连接就关服<br />
# 要考虑这个， 如果你设置这个为 false，<br />
# AuthMe 将自动禁用，并且服务器将失去保护！<br />
stopServer: true<br />
ReloadCommand:<br />
# 是否支持 /reload <br />
useReloadCommandSupport: true<br />
console:<br />
# 不在控制台显示消息<br />
noConsoleSpam: false<br />
# 在控制台更换密码是要像玩家那样输入 /login<br />
removePassword: true<br />
# 是否吧AuthMe的记录文件放在单独的文件夹？<br />
logConsole: true<br />
captcha:<br />
# 在玩家输错太多次后他将需要输入验证码<br />
useCaptcha: false<br />
# 在多少次后要求验证码<br />
maxLoginTry: 5<br />
# 验证码长度<br />
captchaLength: 5<br />
stop:<br />
# 在服务器关闭之前踢出所有玩家， 这样能够保存玩家的位置，并且所有<br />
# 信息都正确正常无任何错误<br />
kickPlayersBeforeStopping: true<br />
#转换<br />
Converter:<br />
Rakamak:<br />
# Rakamak 文件名<br />
fileName: users.rak<br />
# Rakamak 使用 ip ?<br />
useIP: false<br />
# rakamak IP 文件名<br />
ipFileName: UsersIp.rak<br />
CrazyLogin:<br />
# CrazyLogin 数据库文件<br />
fileName: accounts.db<br />
#邮件<br />
Email:<br />
# 电子邮件的SMTP服务器主机名<br />
mailSMTP: smtp.gmail.com<br />
# 电子邮件的SMTP服务器主机端口<br />
mailPort: 465<br />
# 发送邮件的账户<br />
mailAccount: ''<br />
# 邮箱密码<br />
mailPassword: ''<br />
# 自定义发件人的名字，这名字将会代替邮箱显示<br />
mailSenderName: ''<br />
# 随机密码长度<br />
RecoveryPasswordLength: 8<br />
# 邮件主题<br />
mailSubject: 'Your new AuthMe Password'<br />
# 有点像最大注册数但是是邮件的<br />
maxRegPerEmail: 1<br />
# 是否提醒玩家添加一个邮件地址？<br />
recallPlayers: false<br />
# 一分钟内提醒多少次<br />
delayRecall: 5<br />
# 邮箱域名黑名单<br />
emailBlacklisted:<br />
- 10minutemail.com<br />
# 邮箱域名白名单<br />
emailWhitelisted: []<br />
# 是否吧新密码画在图片中？<br />
generateImage: false<br />
# 邮件 OAuth 2 标记 (如果未使用则留空)<br />
emailOauth2Token: ''<br />
#关联<br />
Hooks:<br />
# 是否与 multiverse 的出生点关联？<br />
multiverse: true<br />
# 是否关联 BungeeCord ?（跨服)<br />
bungeecord: false<br />
# 在玩家注册/登录后将玩家发送到某个 BungeeCord 服务器 <br />
sendPlayerTo: ''<br />
# 是否在加入游戏时禁用 Essentials SocialSpy ？<br />
disableSocialSpy: true<br />
# 是否在加入游戏时禁用类似 /motd 的 Essentials 命令？<br />
useEssentialsMotd: false<br />
# 是否缓存 Attributes 自定义？<br />
customAttributes: false<br />
#清理<br />
Purge:<br />
# 如果启用，AuthMe将自动清理掉旧的，未使用的账户<br />
useAutoPurge: false<br />
# 多少天后变为未使用的账户<br />
daysBeforeRemovePlayer: 60<br />
# 是否在清理中顺便清理player.dat文件？<br />
removePlayerDat: false<br />
# 是否在清理中顺便清理 Essentials/users/player.yml 文件？<br />
removeEssentialsFile: false<br />
# 哪个世界存放了 players.dat <br />
defaultWorld: 'world'<br />
# 是否在清理中顺便清理 LimitedCreative/inventories/player.yml, player_creative.yml 文件？<br />
removeLimitedCreativesInventories: false<br />
# 是否在清理中顺便清理 AntiXRayData/PlayerData/player 文件？<br />
removeAntiXRayFile: false<br />
# 是否顺便清理权限？<br />
removePermissions: false<br />
#服务器保护<br />
Protection:<br />
# 启用后服务器将受到一些保护 ( 限制国家登录, 防压测 )<br />
enableProtection: false<br />
# 允许登录和注册的国家，国家代码详情见 http://dev.bukkit.org/bukkit-plugins/authme-reloaded/pages/countries-codes/ <br />
# 请使用引号！！<br />
countries:<br />
- 'US'<br />
- 'GB'<br />
# 黑名单的国家 (不需要启用 protection)<br />
# 请使用引号！！<br />
countriesBlacklist:<br />
- 'A1'<br />
# 是否启用反僵尸压测？<br />
enableAntiBot: false<br />
# 5秒内最大可以登录的玩家 如果启用反压测<br />
antiBotSensibility: 5<br />
# 在多少时间内自动启用反僵尸压测系统<br />
antiBotDuration: 10<br />
VeryGames:<br />
# 这条只是测试 VeryGames 服务器运营商的性能<br />
enableIpCheck: false<br />
<br />
`</div>
梦彗業
https://mineplugin.org/index.php?title=FakePlayersOnline&diff=4056
FakePlayersOnline
2016-09-30T10:40:43Z
<p>梦彗業：/* 介绍 */</p>
<hr />
<div>{{Bukkit Plugin Infobox<br />
|插件名=FakePlayersOnline<br />
|版本=v0.1.7<br />
|前置插件=无<br />
|兼容服务端版本=1.7.2及以上<br />
(也许1.7.10并不能使用)<br />
|網址=http://dev.bukkit.org/bukkit-plugins/fakeplayers/<br />
}}<br />
{{#categorytree:插件分类|hideroot|mode=pages}}.<br />
{{待完善}}<br />
[[Category:管理]] [[Category:信息]] [[Category:修正]]<br />
= 介绍 =<br />
故名思议，这个插件允许你在你的服务器玩家列表内添加"假玩家"(仅存在于玩家列表中，且无法使用Tab进行用户名快捷输入，也并非意义上真实存在的玩家)，<br />
<br>同时玩家的名字可以使用各种的颜色代码进行标注。当然，他的主要用处并不只是添加一些假玩家来提升服务器的总体人气。<br />
<br>例如，你可以在里面加入一个假的在线管理员(对于多数服务器来讲，只需要在名字前加上&c)，<br />
<br>或者在Tab上放置一些公告(但是如果是真的打算放置公告，反而不建议使用该插件进行公告放置，而且很容易被玩家察觉Tab列表的问题所在)。<br />
<br>然而，这个插件所加入的玩家是按照时间顺序进行排列的，进入服务器的玩家也会排列在这之后。<br />
<br />
= 指令以及权限 =<br />
== 指令 ==<br />
/fpo help - 帮助<br />
<br>/fpo lock - 服务器锁定/解锁，锁定后将会踢出所有服内玩家(类似于白名单功能，但是在原版白名单功能上则添加了踢出)<br />
<br>/fpo real - 切换真实玩家游戏名覆盖功能<br />
<br>/fpo add <fakeplayer> - 添加一个假玩家(支持颜色代码，输入后立即生效)<br />
<br>/fpo join <fakeplayer> - 添加一个假玩家并且发送进服消息<br />
<br>/fpo del <fakeplayer> - 删除一个假玩家(必须完整输入添加时的名称，包括空格，符号和颜色代码)<br />
<br>/fpo leave <fakeplayer> - 删除一个假玩家并且发送退服消息<br />
<br>/fpo list - 获取假玩家列表<br />
== 权限 ==<br />
fakeplayers.config - 使用所有指令的权限<br />
<br>fakeplayers.canseehidden - 在tab列表内显示隐藏玩家(也就是例如essentials自带的隐身功能会在tab上隐藏用户信息，利用它可以将隐身的所有玩家玩家强制显示在tab上，但只有获得该权限的玩家可见)<br />
<br>fakeplayers.red - 将获得权限的玩家名变为红色<br />
<br>fakeplayers.unlock - 允许玩家忽略服务器锁定状态(即服务器锁定后不会被强制踢出，且允许进入服务器)<br />
= 更多说明 =<br />
你不仅可以通过指令来管理假玩家，也同样可以在插件配置文件中进行管理。当然，进行删除命令时，你必须输入完整的玩家名，包括代码。<br />
<br>但是，有些时候你通过这种方式进行修改的话，会很麻烦。因此很多时候需要以修改配置文件的方法来管理假玩家。<br />
= 实例 =<br />
&cSystem (装逼用啦，即使是小学生也能以为红色就是OP)<br />
<br>&a欢迎来到xx服 (你懂得)<br />
<br>[[文件:fpo.jpg|一个实例]]</div>
梦彗業