GoWorld - 可扩展的Golang游戏服务器引擎插件

GoWorld是一个支持热更新的可扩展分布式游戏服务器引擎，采用Golang开发。它提供了空间实体框架和热更新功能，非常适合开发多人在线游戏。

主要特性

• 空间与实体：支持管理多个空间和实体，包含AOI(Area of Interest)支持
• 分布式架构：可以通过增加机器来扩展服务器容量
• 热更新：通过重启服务器进程来更新游戏逻辑
• 多种通信协议：支持TCP、KCP和WebSocket
• 流量压缩与加密：客户端和服务器之间的通信可以压缩和加密

架构

GoWorld服务器采用实体框架，其中实体代表所有玩家、怪物和NPC。同一空间中的实体可以通过调用方法或访问属性直接相互访问。不同空间中的实体可以使用RPC相互调用。

一个GoWorld服务器由一个dispatcher、一个或多个game服务器和一个或多个gate服务器组成：

• gate负责处理客户端连接和接收/发送数据包
• game管理所有实体并运行所有游戏逻辑
• dispatcher负责在game服务器之间以及game和gate之间重定向数据包

热更新功能

游戏进程是可热交换的。我们可以通过向进程发送SIGHUP信号来交换游戏进程，并使用-restore参数重新启动进程，使游戏服务器恢复工作但使用最新的可执行映像。此功能可以在不显著干扰在线玩家的情况下透明地更新服务器端逻辑或修复服务器错误。

安装GoWorld

GoWorld需要Go 1.11+版本才能安装。

go install github.com/xiaonanln/goworld/cmd/...

管理GoWorld服务器

使用goworld命令来构建、启动、停止和重新加载游戏服务器。

构建示例聊天室服务器

goworld build examples/chatroom_demo

启动示例聊天室服务器

goworld start examples/chatroom_demo

停止游戏服务器

goworld stop examples/chatroom_demo

重新加载游戏服务器

goworld reload examples/chatroom_demo

查看服务器进程状态

goworld status examples/chatroom_demo

示例Demo

聊天室Demo

聊天室demo是聊天室服务器和客户端的简单实现。它展示了GoWorld如何用于不按空间划分玩家的游戏。

聊天室demo提供以下功能：

• 注册和登录
• 发送聊天消息
• 切换聊天室

构建服务器

goworld build examples/chatroom_demo

运行服务器

goworld start examples/chatroom_demo

Unity Demo

Unity Demo是一个简单的多人怪物射击游戏，展示了如何使用GoWorld的空间和实体来创建多人在线游戏。

功能包括：

• 注册和登录
• 在空间中移动玩家
• 召唤怪物
• 玩家射击怪物
• 怪物攻击玩家

构建服务器

goworld build examples/unity_demo

运行服务器

goworld start examples/unity_demo

代码示例

以下是GoWorld中定义实体和空间的基本代码结构：

package main

import (
	"github.com/xiaonanln/goworld"
	"github.com/xiaonanln/goworld/engine/common"
	"github.com/xiaonanln/goworld/engine/entity"
)

// 定义玩家实体类型
type Player struct {
	entity.Entity // 玩家实体继承自基类
}

// 定义空间类型
type Space struct {
	entity.Space // 空间继承自基类
}

// 玩家进入游戏
func (p *Player) OnEnterSpace() {
	p.CallAllClients("OnEnterSpace", p.Space.ID)
}

// 玩家移动
func (p *Player) Move(x, y, z float32) {
	p.SetPosition(x, y, z)
	p.CallAllClients("OnMove", x, y, z)
}

// 注册实体类型
func registerEntityTypes() {
	goworld.RegisterEntity("Player", &Player{})
	goworld.RegisterSpace(&Space{})
}

func main() {
	// 注册实体类型
	registerEntityTypes()
	
	// 启动服务器
	goworld.Run()
}

热更新示例

GoWorld支持热更新，可以通过以下步骤实现：

1. 修改代码后重新编译服务器
2. 向正在运行的game进程发送SIGHUP信号
3. 使用-restore参数重启game进程

# 1. 修改代码后重新编译
goworld build examples/chatroom_demo

# 2. 查找game进程ID
ps aux | grep chatroom_demo

# 3. 发送SIGHUP信号
kill -SIGHUP <game_pid>

# 4. 使用-restore参数重启
./chatroom_demo -gid 1 -restore

这种热更新方式可以保持游戏状态不变，同时加载新的代码逻辑。