# go-xserver-gameserver-framework

**Repository Path**: chinamd5/go-xserver-gameserver-framework

## Basic Information

- **Project Name**: go-xserver-gameserver-framework
- **Description**: Go 服务器框架（go-x.v2）
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2026-01-09
- **Last Updated**: 2026-01-09

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# go-xserver

**go-xserver 是一个 Golang 服务器框架（go-x.v2）**

致力于实现 1 个高可用、高易用的 Golang 服务器框架

并以插件的方式，来丰富框架内容

## 编译

- [安装 golang 1.12+](https://golang.google.cn/dl/)
- [安装 docker](https://docs.docker.com/install/linux/docker-ce/centos/)
- 编译执行以下语句即可：

  ```shell
  ./make.sh
  ```

## 运行

- 安装 Redis ，并修改 config/config.toml 相关配置

- All In One 例子
  ```shell
  ./make.sh start
  ./make.sh stop
  ```

## 测试客户端

- [pyclient](https://github.com/fananchong/go-xclient/tree/master/pyclient)


## 缺省插件

- [go-xserver-plugins](https://github.com/fananchong/go-xserver-plugins)
  - mgr
  - login
  - gateway


## v0.1

- 管理服务器
- 登陆服务器
- 网关服务器
  - 客户端消息中继
  - 服务器组内消息中继
- 大厅服务器
  - 获取角色列表（登录大厅服务）
  - 创建角色
  - 获取角色详细信息（进入游戏）
  - 登出游戏
  - 角色聊天（世界聊天、私聊）
  
  
## v0.2

- 基于 gRPC-go 改造框架层代码
- 分布式事务框架
- 支持 istio 部署


## WIKI

- [主体框架](doc/规范-代码框架.md)
- 配置模块
  - [框架层配置](doc/规范-配置文件_框架层.md)
  - [逻辑层配置](doc/规范-配置文件_逻辑层.md)
- [服务发现](doc/框架层功能-服务发现.md)
- [登陆模块](doc/框架层功能-登陆模块.md)
- [闲置连接处理](doc/框架层功能-闲置连接处理.md)
- [登出模块](doc/框架层功能-登出模块.md)
- [服务器组内互联](doc/规范-服务器架构.md)


## ISSUE

- [插件工程独立建库问题](doc/ISSUE-插件工程独立建库问题.md)

## 将要实现的功能

- 框架层功能
    - 灰度更新
    - 服务器健康监测
- 逻辑层功能
    - 匹配服务
    - 房间服务
    - 压测工具