创新互联MinecraftWiki教程：数据包[]

此特性为教育版和基岩版独有。

成都创新互联网站建设公司一直秉承“诚信做人，踏实做事”的原则，不欺瞒客户，是我们最起码的底线！ 以服务为基础，以质量求生存，以技术求发展，成交一个客户多一个朋友！专注中小微企业官网定制，成都网站制作、成都网站建设，塑造企业网络形象打造互联网企业效应。

本页面是指基岩版/connect命令连接的WebSocket（该服务器不是多人游戏所使用的服务器，以下简称服务器）。 本教程展示的是客户端与服务端的数据包，不涉及WebSocket服务端的开发，但你可以参考底部的链接来进行服务端的开发。

目录

• 1 数据包
  • 1.1 subscribe（订阅请求）
  • 1.2 unsubscribe（取消订阅请求）
  • 1.3 CommandRequest（命令请求）
• 2 返回数据包
  • 2.1 event包（订阅事件响应）
    • 2.1.1 标准Event包示例
    • 2.1.2 PlayerMessage event示例
  • 2.2 CommandResponse （CommandRequest返回）
    • 2.2.1 list命令
    • 2.2.2 say命令
    • 2.2.3 tp命令
    • 2.2.4 注释
• 3 事件表
• 4 历史
• 5 参考

数据包[ ]

Websocket服务器需要向mcbe发送数据包来进行交互。

Websocket服务器可以向游戏发送json格式的数据包，目前已知的有三种：

• 订阅请求
• 取消订阅请求
• 命令请求

这里有几个示例数据包。

subscribe（订阅请求）[ ]

订阅事件就是服务器向游戏说明自己要监听哪些事件，当游戏发生该事件后游戏就会向服务器发送该事件的相关信息，下面是一个订阅事件数据报的例子。

注意:目前有一部分事件在新版本当中是无效的

{
	"body": {
		"eventName": "PlayerMessage"
	},
	"header": {
		"requestId": "00000000-0000-0000-0000-000000000000",
		"messagePurpose": "subscribe",
		"version": 1,
		"messageType": "commandRequest"
	}
}

这将对PlayerMessage事件进行监听，玩家在聊天栏发的消息以及其他相关信息将被通过数据包发回。看一看这个包，你会发现requestId的value是一些0，这不是固定的，你完全可以对它进行更改。

unsubscribe（取消订阅请求）[ ]

Unsubscribe包是用来在监听事件之后取消监听。

{
	"body": {
		"eventName": "PlayerMessage"
	},
	"header": {
		"requestId": "00000000-0000-0000-0000-000000000000",
		"messagePurpose": "unsubscribe",
		"version": 1,
		"messageType": "commandRequest"
	}
}

这是一个对PlayerMessage事件进行unsubscribe的数据包，取消订阅后玩家在聊天栏发送的消息将不再会被服务器监听。

CommandRequest（命令请求）[ ]

该数据包会在游戏内执行指定的命令。

{
	"body": {
		"origin": {
			"type": "player"
		},
		"commandLine": "say Hello",
		"version": 1
	},
	"header": {
		"requestId": "00000000-0000-0000-0000-000000000000",
		"messagePurpose": "commandRequest",
		"version": 1,
		"messageType": "commandRequest"
	}
}

这将在客户端执行commandLine项（say Hello）的命令，执行结果会被发回。

• commandRequest能执行一些游戏内无法执行的命令，例如: /agent create（创建agent）

返回数据包[ ]

返回的数据包指的是游戏向服务器发送的数据包，这些数据包有两种类型:

• 对服务器订阅的事件的响应
• 对服务器发送的命令事件的反馈

event包（订阅事件响应）[ ]

标准Event包示例[ ]

{
	"body": {
        "eventName": "",
        "measurements":null,
        "properties": {
        }
    },
	"header": {
        "messagePurpose": "event",
        "requestId": "00000000-0000-0000-0000-000000000000",
        "version":1
    }
}

• 不同的事件在"body"和"properties"字段中填入的数据有些许不同（不同的事件会有不同的包含关键信息的字段），上方是一个标准数据包的例子

PlayerMessage event示例[ ]

示例：

{
  "body": {
    "eventName": "PlayerMessage",
    "measurements": {
      "Count": 1,
      "RecordCnt": 1,
      "SeqMax": 1355,
      "SeqMin": 1355
    },
    "properties": {
      "AccountType": 1,
      "ActiveSessionID": "a9f8087b-2e3d-495c-b3c3-aef515b7e19a",
      "AppSessionID": "43408684-6cb0-4896-b89d-66a2a1e48a73",
      "Biome": 1,
      "Build": "1.13.1",
      "BuildPlat": 7,
      "Cheevos": false,
      "ClientId": "0ceeb3a3-f96c-34b0-895f-b0d4ca7b129a",
      "CurrentInput": 1,
      "DeviceSessionId": "43408684-6cb0-4896-b89d-66a2a1e48a73",
      "Dim": 0,
      "GlobalMultiplayerCorrelationId": "0694aabd-ddde-466d-ae99-1f88faf1580a",
      "Message": "a",
      "MessageType": "chat",
      "Mode": 1,
      "MultiplayerCorrelationId": "ab4e37fe-2836-18a0-6d21-a85f781f8e70",
      "NetworkType": 0,
      "Plat": "Win 10.0.18362.1",
      "PlayerGameMode": 1,
      "SchemaCommitHash": "19b6ec0744c3c83a00ecbd840f48cb080c7bc64d",
      "Sender": "hhhxiao",
      "ServerId": "raknet:11376205654463177128",
      "Treatments": "mc-perf-plat-12-20:mc-perf-plat-1-20:mc-perf-plat-2-20:mc-perf-plat-4-20:mc-perf-plat-7-20:mc-perf-plat-13-20:mc-perf-plat-11-1:mc-rp-frozenbuttonandpanel:mc-rp-playfab",
      "UserId": "2535451099196973",
      "WorldFeature": 0,
      "WorldSessionId": "f7d8ca20-4be0-4d01-aa83-3c2c64dabc88",
      "editionType": "win10",
      "isTrial": 0,
      "locale": "zh_CN",
      "vrMode": false
    }
  },
  "header": {
    "messagePurpose": "event",
    "requestId": "00000000-0000-0000-0000-000000000000",
    "version": 1
  }
}

这是一个PlayerMessage返回包示例。

• body.properties.Message是用户发出的消息
• body.properties.MessageType是消息类型（say、me、chat等）
• body.properties.Sender是发送者名称
• body.properties.locale是设备使用的语言
• body.properties.UserId 与用户Xbox Live相关，登录同一Xbox Live时总为一个值，未登录时为空或未定义。

CommandResponse （CommandRequest返回）[ ]

一般格式:

{
  "body":{
    "statusCode": 0,
    "statusMessage": ""
  },
  "header": {
    "messagePurpose":"commandResponse",
    "requestId": "00000000-0000-0000-000000000000"
  }
}

示例：

list命令[ ]

{
    "body":{
        "currentPlayerCount":1,
        "maxPlayerCount":5,
        "players":"LNSSPsd",
        "statusCode":0,
        "statusMessage":"There are 1/5 players online:\nLNSSPsd"
    },
    "header":{
        "messagePurpose":"commandResponse",
        "requestId":"00000000-0000-0000-000000000000",
        "version":1
     }
}

• body.currentPlayerCount、body.maxPlayerCount、body.players是/list命令特有的，在执行其他命令时不存在。

say命令[ ]

本示例使用了/say oh命令

{
    "body":{
        "message":"oh",
        "statusCode":0
    },
    "header":{
        "messagePurpose":"commandResponse",
        "requestId":"00000000-0001-0000-000000000000",
        "version":1
    }
}

• body.message是/say特有的，而/say命令没有statusMessage项。

tp命令[ ]

本示例使用了/tp Steve ~ ~ ~命令

{
  "body": {
    "destination": {
      "x": 73.37560272216797,
      "y": 71.12252044677734,
      "z": 36.96865081787109
    },
    "statusCode": 0,
    "statusMessage": '已将 Steve 传送至 73.38, 71.12, 36.97',
    "victim": [ 'Steve' ]
  },
  "header": {
    "messagePurpose": 'commandResponse',
    "requestId": '00000000-0000-0000-0000-000000000000',
    "version": 1
  }
}

• body.destination、body.victim、header.version 是/tp特有的。

注释[ ]

• body.statusCode 是命令完成状态，成功时为0，失败时小于0。
• body.statusMessage 是状态消息，相当于执行命令后聊天里的命令返回，少数命令（如/say命令）无返回显示，故无此项。
• 返回请求的 header.requestId 与发送请求时附带的 header.requestId 相同。

事件表[ ]

下面是目前已知的所有可订阅事件，写了触发条件的是确认可用或者已知触发条件的。

历史[ ]

参考[ ]

• https://github.com/lZiMUl/Mcbbsmis.git
• https://github.com/mcpews/MyAgent.git
• https://github.com/CAIMEOX/FastBuilder.git
• https://github.com/liumingedwin/Minecraft-Mod-Configer.git

网站栏目：创新互联MinecraftWiki教程：数据包[]
网站路径：http://www.shufengxianlan.com/qtweb/news10/29710.html

网站建设、网络推广公司-创新互联，是专注品牌与效果的网站制作，网络营销seo公司；服务项目有等

广告

声明：本网站发布的内容（图片、视频和文字）以用户投稿、用户转载内容为主，如果涉及侵权请尽快告知，我们将会在第一时间删除。文章观点不代表本网站立场，如需处理请联系客服。电话：028-86922220；邮箱：631063699@qq.com。内容未经允许不得转载，或转载时需注明来源： 创新互联