Protocol:zh-cn - Revision history

imported>XiYang6666: /* 握手 (Handshake) */

2024-04-05T05:59:00Z

握手 (Handshake)

← Older revision		Revision as of 05:59, 5 April 2024
Line 144:		Line 144:
	\| 协议版本 (Protocol Version)		\| 协议版本 (Protocol Version)
	\| VarInt		\| VarInt
	\| 参考[[protocol version numbers~~:zh-cn~~]] (在Minecraft 1.18.1为757).		\| 参考[[protocol version numbers]] (在Minecraft 1.18.1为757).
	\|-		\|-
	\| 服务器地址 (Server Address)		\| 服务器地址 (Server Address)

imported>XiYang6666: /* 其他定义 */

2024-04-04T11:47:25Z

其他定义

← Older revision		Revision as of 11:47, 4 April 2024
Line 32:		Line 32:
	\|-		\|-
	\| 玩家		\| 玩家
	\| <del>当这个词是单数时</del>(中文'''没有'''单复数), 玩家是指连接到服务端的客户端		\| <del>当这个词是单数时,</del>(中文'''没有'''单复数) 玩家是指连接到服务端的客户端
	\|-		\|-
	\| 实体		\| 实体
Line 44:		Line 44:
	\|-		\|-
	\| 米 (Meter)		\| 米 (Meter)
	\| 米是 Minecraft 的基本长度单位, 等于完整方块的边长. ~~术语'''块'''可用于表示'''米'''或'''立方米'''~~.		\| 米是 Minecraft 的基本长度单位, 等于完整方块的边长. 术“语块”可用于表示“米”或“立方米”.
	\|-		\|-
	\| 全局调色板 (Global palette)		\| 全局调色板 (Global palette)

imported>XiYang6666: /* 其他定义 */

2024-04-04T11:45:16Z

其他定义

← Older revision		Revision as of 11:45, 4 April 2024
Line 32:		Line 32:
	\|-		\|-
	\| 玩家		\| 玩家
	\| <del>当这个词是单数时</del>中文'''没有'''单复数, 玩家是指连接到服务端的客户端		\| <del>当这个词是单数时</del>(中文'''没有'''单复数), 玩家是指连接到服务端的客户端
	\|-		\|-
	\| 实体		\| 实体

imported>XiYang6666: /* 定义 */

2024-04-04T11:44:37Z

定义

← Older revision		Revision as of 11:44, 4 April 2024
Line 22:		Line 22:
	=== 数据类型 ===		=== 数据类型 ===

	通过网络发送的所有数据（VarInt 和 VarLong 除外）都是小端序的, 即字节从最高有效字节发送到最低有效字节. 当今大多数计算机都是小端序的, 因此在用网络发送数据之前可能需要更改其字节序.		{{:Data types}} <!-- Transcluded contents of Data types article in here — go to that page if you want to edit it -->

	=== 其他定义 ===		=== 其他定义 ===
Line 54:		Line 54:
	\| Notchian		\| Notchian
	\| 由 Mojang 开发和发布的原版 Minecraft 的官方实现.		\| 由 Mojang 开发和发布的原版 Minecraft 的官方实现.
			\|-
			\| 序列
			\| 本地方块变化的动作编号的计数器, 在用手点击方块、右键点击物品、开始或结束挖掘方块时加一. 计数器处理延迟, 以避免将过时的方块变化应用到本地世界. 同时也用于恢复在放置方块、使用桶或破坏方块时创建的幽灵方块.
	\|}		\|}

imported>XiYang6666: /* 握手 (Handshake) */

2024-04-04T11:34:16Z

握手 (Handshake)

← Older revision		Revision as of 11:34, 4 April 2024
Line 153:		Line 153:
	\| 下一个状态 (Next State)		\| 下一个状态 (Next State)
	\| VarInt Enum		\| VarInt Enum
	\| 为1时 [[#~~Status~~\|~~status~~:zh-cn]], 为2时 [[#~~Login~~\|~~login~~:zh-cn]].		\| 为1时 [[#状态查询\|状态查询:zh-cn]], 为2时 [[#登录\|登录:zh-cn]].
	\|}		\|}

imported>XiYang6666: /* 状态查询 */

2024-04-04T11:30:50Z

状态查询

← Older revision		Revision as of 11:30, 4 April 2024
Line 181:		Line 181:

	== 状态查询 ==		== 状态查询 ==
	{{Main\|Server List Ping}}		{{Main\|Server List Ping:zh-cn}}

	=== 客户端绑定 ===		=== 客户端绑定 ===
Line 201:		Line 201:
	\| JSON 响应 (JSON Response)		\| JSON 响应 (JSON Response)
	\| String (32767)		\| String (32767)
	\| 请参阅[[Server List Ping#~~Response~~]]; 与所有字符串一样, JSON 响应前面会加上 VarInt 类型的前缀.		\| 请参阅[[Server List Ping:zh-cn#Status_Response]]; 与所有字符串一样, JSON 响应前面会加上 VarInt 类型的前缀.
	\|}		\|}

imported>XiYang6666: /* 数据包格式 */

2024-04-04T11:24:07Z

数据包格式

← Older revision		Revision as of 11:24, 4 April 2024
Line 58:		Line 58:
	== 数据包格式 ==		== 数据包格式 ==

	单个数据包不能超过2097151字节(the maximum that can be sent in a 3-byte VarInt). ~~For compressed packets~~, ~~this applies to both the compressed length and uncompressed lengths~~.		单个数据包不能超过2097151字节(the maximum that can be sent in a 3-byte VarInt). 对于压缩数据包, 这同时适用于压缩长度和未压缩长度.

	=== 无压缩 ===		=== 无压缩 ===
Line 82:		Line 82:
	=== 压缩 ===		=== 压缩 ===

	~~Once a~~ [[#Set Compression\|Set Compression]] ~~packet~~ (~~with a non-negative threshold~~) ~~is sent~~, [[wikipedia:Zlib\|zlib]] ~~compression is enabled for all following packets~~. ~~The format of a packet changes slightly to include the size of the uncompressed packet~~.		一旦发送了 [[#Set Compression\|Set Compression]] 数据包 (具有非负阈值), 就会对以下所有数据包启用 [[wikipedia:Zlib\|zlib]] 压缩. 数据包的格式略有变化, 以包括未压缩数据包的大小.

	{\| class=wikitable		{\| class=wikitable
	! ~~Compressed?~~		! 是否被压缩
	! ~~Field Name~~		! 字段名
	! ~~Field Type~~		! 字段类型
	! ~~Notes~~		! 备注
	\|-		\|-
	\| No		\| 否
	\| Packet Length		\| 数据包长度 (Packet Length)
	\| VarInt		\| VarInt
	\| ~~Length of Data Length~~ + ~~compressed length of~~ (~~Packet ID~~ + ~~Data~~)		\| 数据长度的长度 + 压缩过的 (数据包ID + 数据) 的长度
	\|-		\|-
	\| No		\| 否
	\| Data Length		\| 数据长度 (Data Length)
	\| VarInt		\| VarInt
	\| ~~Length of uncompressed~~ (Packet ID + Data) or 0		\| 未压缩的 (Packet ID + Data) 的长度或 0
	\|-		\|-
	\|rowspan="2"\| Yes		\|rowspan="2"\| Yes
	\| Packet ID		\| 数据包ID (Packet ID)
	\| VarInt		\| VarInt
	\| zlib ~~compressed packet ID~~ (~~see the sections below~~)		\| zlib 压缩的数据包ID (请参阅下面的各节)
	\|-		\|-
	\| Data		\| 数据 (Data)
	\| Byte Array		\| Byte Array
	\| zlib ~~compressed packet data~~ (~~see the sections below~~)		\| zlib 压缩的数据 (请参阅下面的各节)
	\|}		\|}

	~~If the size of the buffer containing the packet data and ID~~ (~~as a VarInt~~) ~~is smaller than the threshold specified in the packet~~ [[#Set Compression\|Set Compression]]. ~~It will be sent as uncompressed. This is done by setting the data length as 0.~~ (~~Comparable to sending a non-compressed format with an extra 0 between the length, and packet data~~).		如果包含数据和数据包ID(作为VarInt)的缓冲区的大小小于 [[#Set Compression\|Set Compression]] 数据包中指定的阈值, 它将以未压缩形式发送. 这是通过将数据长度设置为0来完成的。(相当于在长度和数据包数据之间额外添加了一个0来发送非压缩格式).

	~~If it's larger than the threshold, then it follows the regular compressed protocol format~~.		如果它大于阈值，则遵循常规的压缩协议格式.

	~~Compression can be disabled by sending the packet~~ [[#Set Compression\|Set Compression]] ~~with a negative Threshold, or not sending the Set Compression packet at all~~.		可以通过发送带有负阈值的 [[#Set Compression\|Set Compression]] 数据包，或根本不发送设置压缩数据包来禁用压缩.

	== Handshaking ==		== Handshaking ==

imported>XiYang6666: /* 其他定义 */

2024-04-04T11:05:06Z

其他定义

← Older revision		Revision as of 11:05, 4 April 2024
Line 37:		Line 37:
	\| 实体是指任何物品、玩家、生物、矿车或船等. 有关完整列表, 请参阅 {{Minecraft Wiki\|Entity\|the Minecraft Wiki article}} .		\| 实体是指任何物品、玩家、生物、矿车或船等. 有关完整列表, 请参阅 {{Minecraft Wiki\|Entity\|the Minecraft Wiki article}} .
	\|-		\|-
	\| EID		\| 实体 ID (EID)
	\| EID 或实体 ID 是一个用于识别特定实体的4字节序列. 实体的 EID 在整个服务器上是唯一的.		\| EID 或实体 ID 是一个用于识别特定实体的4字节序列. 实体的 EID 在整个服务器上是唯一的.
	\|-		\|-
	\| XYZ		\| 坐标 (XYZ)
	\| 在本文档中, 坐标轴名称与调试屏幕 (F3) 中显示的轴名称相同. Y轴指向上方, X轴指向东方, Z轴指向南方.		\| 在本文档中, 坐标轴名称与调试屏幕 (F3) 中显示的轴名称相同. Y轴指向上方, X轴指向东方, Z轴指向南方.
	\|-		\|-
	\| Meter		\| 米 (Meter)
	\| 米是 Minecraft 的基本长度单位, 等于完整方块的边长. ~~术语“块”可用于表示“米”或“立方米”~~.		\| 米是 Minecraft 的基本长度单位, 等于完整方块的边长. 术语'''块'''可用于表示'''米'''或'''立方米'''.
	\|-		\|-
	\| Global palette		\| 全局调色板 (Global palette)
	\| ~~A table~~/~~dictionary~~/palette ~~mapping nonnegative integers to block states~~. ~~Block state IDs are created in a linear fashion based off of order of assignment~~. ~~One block state ID allocated for each unique block state for a block~~; ~~if a block has multiple properties then the number of allocated states is the product of the number of values for each property~~. ~~A current list of properties and state ID ranges is found on~~ [https://pokechu22.github.io/Burger/1.16.5.html burger].		\| 将非负整数映射到方块状态的表/字典/调色板(palette). 方块状态ID是根据分配顺序线性创建的. 每个方块都分配了一个唯一的方块状态ID; 如果一个方块具有多个属性, 则分配的状态数是每个属性的值数的乘积. 当前属性和状态ID范围的列表可以在 [https://pokechu22.github.io/Burger/1.16.5.html burger] 中找到.

			此外，原版(Vanilla) 服务器现在包含了一个选项，可以通过运行 <code>java -cp minecraft_server.jar net.minecraft.data.Main --reports</code>来导出当前方块状态ID映射。有关更多信息，请参阅 [[Data Generators]]。

	Alternatively, the vanilla server now includes an option to export the current block state ID mapping, by running <code>java -cp minecraft_server.jar net.minecraft.data.Main --reports</code>. See [[Data Generators]] for more information.
	\|-		\|-
	\| Notchian		\| Notchian

imported>XiYang6666: /* 状态查询 */

2024-04-04T10:54:05Z

状态查询

← Older revision		Revision as of 10:54, 4 April 2024
Line 184:		Line 184:
	=== 客户端绑定 ===		=== 客户端绑定 ===

	==== 响应 ====		==== 状态响应 (Status Response) ====

	{\| class="wikitable"		{\| class="wikitable"
Line 203:		Line 203:
	\|}		\|}

	==== ~~Pong~~ ====		==== Ping 响应 (Ping Response) (status) ====

	{\| class="wikitable"		{\| class="wikitable"
Line 223:		Line 223:
	=== 服务器绑定 ===		=== 服务器绑定 ===

	==== 请求 ====		==== 状态请求 (Status Request) ====

	在握手之后、任何ping之前, 只能立即请求一次状态. 否则服务器不会响应.		在握手之后、任何ping之前, 只能立即请求一次状态. 否则服务器不会响应.
Line 241:		Line 241:
	\|}		\|}

	==== Ping ====		==== Ping 请求(Ping Request) (status) ====

	{\| class="wikitable"		{\| class="wikitable"

imported>XiYang6666: /* 旧版服务器列表 Ping */

2024-04-04T10:50:53Z

旧版服务器列表 Ping

← Older revision		Revision as of 10:50, 4 April 2024
Line 155:		Line 155:
	\|}		\|}

	==== 旧版服务器列表 Ping ====		==== 旧版服务器列表 Ping (Legacy Server List Ping) ====

	{{Warning\| 此数据包使用非标准格式. 它从不以长度为前缀, 并且数据包 ID 是Unsigned Byte而不是 VarInt.}}		{{Warning\| 此数据包使用非标准格式. 它从不以长度为前缀, 并且数据包 ID 是Unsigned Byte而不是 VarInt.}}