GeneralGameServerMod 是基于 Paracraft 的一个多人联机的模块, 包含了该功能的客户端和服务端代码.
- 多个用户进入同一联机世界观赏, 编辑, 创造等
- 同时提供多个联机世界, 用户可以随时切换联机世界
- 提供联机世界保存, 多人编辑.
采用后端的集群模式, 服务器作为集群控制节点主负责客户端数据转发工作, 客户端可以看做集群中的工作节点.
- 执行命令:
ggs connect worldId
进入联机世界 worldId(keepwork项目Id) - 如 worldId 为 0, 则进入默认空世界, 否则加载并打开 worldId 对应的世界
- 与服务器建立TCP链接, 并登陆服务端对应的 worldId 世界中
- 接受服务端 worldId 世界更新数据并应用数据到客户端世界
- 接受新世界更新并应用, 监听当前用户的更新并发送至服务器(以便同步到其它用户世界)
- 程序启动, 启动TCP Server并监听客户端连接
- 客户端接入, 完成认证交互
- 认证通过后, 建立世界新玩家, 并将当前世界相关信息(玩家信息, 方块信息等)下发给新用户.
- 接受客户端对世界的更新信息, 将新更新存于后端数据化世界中, 并转发给其它玩家
- 安装 NPL 运行环境, 进入工作目录:
cd /workspace
(可更改工作目录, 此处以/workspace
) - 下载代码:
git clone [email protected]:tatfook/GeneralGameServerMod.git
- 启动程序: npl servermode="true" bootstrapper="/workspace/GeneralGameServerMod/Mod/GeneralGameServerMod/main.lua" loadpackage="/workspace/GeneralGameServerMod/" loadpackage选项中还需加载 paracraft 脚本包
pm2 start npm npl --name "GGS" -- isDevEnv="true" servermode="true" bootstrapper="/root/workspace/GeneralGameServerMod/Mod/GeneralGameServerMod/Server/main.lua" logfile="/root/workspace/GeneralGameServerMod/server.log" loadpackage="/root/workspace/GeneralGameServerMod/,;/root/workspace/npl/script/trunk/"
- 下载客户端模块的ZIP包, 下载地址: https://github.com/tatfook/GeneralGameServerMod
- 将下载好的zip包放在Paracraft安装目录的Mod文件夹里
- 启动Paracraft, 在登录页面, 点登录框下面的MOD加载, 再在弹出的Mod对话框中找到刚放入的zip包模块, 并勾选
- 登录进入世界, 执行
ggs connect worldId
(ggs connect -test worldId
选择测试服务器) 命令进入多人世界, 或按F12执行如下代码:
集群由控制服务和工作服务组成, 通常控制服务一个, 工作服务若干. 控制服链接地址提供客户端.
客户单进入联机世界流程:
- 连接控制服务
- 向控制服务发送进入联机世界 WorldId 请求, 控制服务找出合适的工作服务并返回该工作服务连接地址
- 关闭控制服务连接, 连接获取到的工作服务地址
- 登录联机世界, 以及相关操作与请求
服务器间的负载信息同步:
- 程序启动, 工作服务连接控制服务, 定时每隔3分钟发送一次本工作服务的负载信息给控制服务. 负载信息: 工作服务存在世界数, 用户数, 每个世界的用户数
最优工作服务选择:
- 排除更新时间超过5分钟(判定工作服务已停止), 用户数已超过最大值(8000)
- 优先选择工作服务已存在该世界信息, 且世界用户数不超过世界用户数的最大值(200)
- 其次选择工作服务的用户数最少
- 若工作服务可用, 选择控制服务
[x] 世界里自动创建的entity的entityId 无法同步, 可能会导致程序异常 通过区域化分解决, 自动创建去临界值以上, 服务器分配取临界值一下
[x] 当世界人数到达上限, 新接入用户进入新的虚拟世界
[x] 连接的断开重连
[x] 世界重复打开
[x] 世界打开失败 /loadworld 未处理世界打开失败情况, 本模块无法处理
[x] 玩家进入世界, 起始位置小范围随机
[x] 维持世界最小玩家, 当玩家数量过少维持离线玩家在世界中
[x] 支持平行世界(同一世界多开)
[x] 区域化离线人物 ParaWorldMinimapSurface.lua