Files

boybook 9a0334ee84 first commit

2025-03-17 13:24:39 +08:00

front, hard, time

front	hard	time
	入门	60分钟

支持基岩版客户端的Java版网络游戏概述

目的

Spigot、Spigot服

Spigot是一个开源的、高效的Java版MC服务器，并且提供了丰富的api可以编写插件。他是由第三方提供的，并非官方提供，是由官方的minecraft server反编译后，打进去一些patch后而来
BC、BungeeCord、BC服

BungeeCord（后面简称BC）是一个代理，提供了切服、数据包转发、插件编写、BC指令等等
Geyser、Geyser服、协议服

Geyser是第三方开源的MC协议转换工具，它能把MC-Bedrock版本协议转换为MC-java版本协议，也就是说通过Geyser，我们能实现基岩版客户端进入Java版服务器游玩的效果
Master服、Proxy服

见名词解释

如框架图所示，为了尽可能地兼容不同服主Spigot服框架，我们把整体的Java版网络游戏分为两部分：

接着阐述每个部分的具体作用

负载/协议转换部分
- 这一部分包括了Master服、Proxy服、Geyser服
- Master和Proxy服作用和基岩版网络游戏一致
- 由于基岩版和Java版的游戏数据协议包格式并不相同，因此，Geyser服则扮演着协议转换者的角色，它负责把基岩版的协议转换为Java版的协议
Java服部分
- 这一部分为Java游戏服，它的作用相当于基岩版网络游戏中，Lobby服和Game服的结合体，是存储玩家实际游玩数据以及世界数据的服务器
- 它主要由两部分组成，BC服和Spigot服
- 架构图中的DB则指额外数据库（可选）、其他则是指用于进一步管理BC、Spigot或者其他更多功能的第三方应用程序（可选）

为了可扩展地连接起上下两部分，框架中，我们会把Java服视为黑盒，并为BC服提供名为BungeeMaster的插件，这个插件安装在BC服上，负责建立起BC服和Master服的通信连接。

在进行Java版网络游戏搭建和部署流程前，首先需要注册成为我的世界开发者，并完成入驻申请，申请开发阶段服务器。具体步骤，请详细阅读如下文档：

在准备好开发机后，连接上开发机
通过服主各自的Java服框架，部署各自的Java服(必须存在BC服)
经过初步的调研，确定目前使用的Spigot版本为1.12.2，因此为了兼容基岩版1.18客户端，需要在Spigot服使用ViaVersion插件
下载ViaVersion插件，并放置于 Spigot服目录/plugins/ 目录下。
下载BungeeMaster插件，并放置于 BC服目录/plugins/ 目录下。
在 BC服目录/plugins/ 下，新建文件夹 BungeeMaster，并在 BungeeMaster 文件夹下新建文件 config.yml（此为BungeeMaster插件配置）
然后填入如下内容,其中
- server_id 取值区间在[12000, 14000)内，并且保持单次部署唯一即可
- master_port端口范围要求[29000,31000)
- 填写完毕后，请记下相关参数，后面需要在studio中填写
打开BC服目录/config.yml文件(此为bc服配置)，查看bc服监听的端口，并记下端口参数，后面需要在studio中填写
- 注意，此处的query_port和host中冒号后面的端口值，请保持一致
- 该处的端口，均为BC服用于监听来自Geyser服相关连接的端口
配置完成后，可使用Java版客户端连接BC，测试Java服部署是否成功