README.md · Eovl/ioGame-example

<h2 align="center" style="text-align:center;">
 ioGame
</h2>

 国内首个基于蚂蚁金服 SOFABolt 的 java 网络游戏服务器框架；无锁异步化、事件驱动的架构设计
 
 通过 ioGame 可以很容易的搭建出一个集群无中心节点、有状态多进程的分步式游戏服务器
 
 无中间件依赖、代码即文档、JSR380、断言 + 异常机制 = 更少的维护成本、开发成本
 
 同样的一套业务代码无需变更，可以支持多种协议：protobuf、json，并且可扩展
 
 同样一套业务代码无需变更，可以支持多种通信协议：websocket、socket
 
 轻量级、启动快、更节约、简单、开箱即用、无配置文件、超高性能
 
 近原生的快、业务框架平均每秒可以执行 1152 万次业务逻辑
 
 在业务开发中自带神级特性：业务代码访问定位与跳转
 
 架构部署多样性：即可相互独立，又可相互融合
 
 各个逻辑服之间可以相互的进行跨进程通信
 
 可同时与同类型多个游戏逻辑服通信
 
 支持玩家动态绑定逻辑服节点
 
 对webMVC开发者友好
 
 无 spring 强依赖

过去、现在、将来都不会有商业版本，所有功能全部开源！

只做真的完全式开源，拒绝虚假开源，售卖商业版，不搞短暂维护！

承诺项目的维护周期是十年起步， 2022-03-01起，至少十年维护期！

提供高质量的使用文档！

如果您觉得还不错，帮忙给个 star 关注!

## 综合示例请看

这个仓库用于存放 ioGame 相关的使用示例

https://www.yuque.com/iohao/game/ruaqza

**示例内容包含**

1. 多服多进程的方式部署
2. 单体应用方式部署
3. [springboot 集成](https://www.yuque.com/iohao/game/evkgnz)
4. [JSR380验证](https://www.yuque.com/iohao/game/ghng6g)
5. [断言 + 异常机制 = 清晰简洁的代码](https://www.yuque.com/iohao/game/avlo99)
6. [请求、无响应](https://www.yuque.com/iohao/game/nelwuz#qs7yJ)
7. [请求、响应](https://www.yuque.com/iohao/game/nelwuz#UAUE4)
8. [广播指定玩家](https://www.yuque.com/iohao/game/nelwuz#EY6Ln)
9. [广播全服玩家](https://www.yuque.com/iohao/game/nelwuz#mStIA)
10. [单个逻辑服与单个逻辑服通信请求 - 有返回值（可跨进程）](https://www.yuque.com/iohao/game/nelwuz#L9TAJ)
11. [单个逻辑服与单个逻辑服通信请求 - 无返回值（可跨进程）](https://www.yuque.com/iohao/game/nelwuz#gtdrv)
12. [单个逻辑服与同类型多个逻辑服通信请求（可跨进程）](https://www.yuque.com/iohao/game/nelwuz#gSdya)
13. [业务参数自动装箱、拆箱基础类型（解决协议碎片问题）](https://www.yuque.com/iohao/game/ieimzn)
14. [游戏文档生成](https://www.yuque.com/iohao/game/irth38)
15. [业务协议文件 .proto 的生成](https://www.yuque.com/iohao/game/vpe2t6#R5w5m)
16. [登录相关：包含重复登录、顶号相关的业务](https://www.yuque.com/iohao/game/tywkqv)
17. 启动多个同类型的游戏逻辑服
18. 将项目打成 jar 包
19. 启动 jar 包
20. docker 运行综合示例
21. 纯原生 proto 数据的模拟客户端模块
22. CocosCreator 与综合示例联调
23. 模块的整理与建议（路由相关）

还有更多，将在后续添加 ... ...

## 阅读前的建议

阅读综合示例这部分时，建议先看[简单介绍](https://www.yuque.com/iohao/game/wwvg7z)、[快速从零编写服务器完整示例](https://www.yuque.com/iohao/game/zm6qg2)这两部分；

## 源码目录介绍
```text
.
├── example （示例）
│   ├── example-broadcast （广播示例）
│   ├── example-cluster-run-one （集群示例）
│   ├── example-endpoint 示例目录 玩家动态绑定逻辑服节点
│   ├── example-for-spring （spring集成示例）
│   ├── example-for-tcp-socket （对外服使用tcp协议示例）
│   ├── example-hook 示例目录 钩子相关(心跳，用户上线、下线)
│   ├── example-interaction （逻辑服与逻辑服之间的交互，可跨进程通信）
│   ├── example-interaction-same 示例目录 逻辑服间的相互通信；请求同类型多个逻辑服的结果集（可跨进程）
│   ├── example-parent
│   ├── example-redisson-lock （分步式锁）
│   ├── example-redisson-lock-spring-boot-starter （分步式锁 for springBootStarter）
│   └── example-run-one （快速启动示例）
├── example-game-collect （实战示例、坦克）
│   ├── fxgl-tank （游戏引擎-坦克游戏启动端）
│   ├── game-common （一些通用的功能）
│   ├── game-common-proto （示例 pb ）
│   ├── game-external （对外服）
│   ├── game-logic-hall （登录逻辑服）
│   ├── game-logic-tank （坦克逻辑服）
│   └── game-one （一键启动 游戏网关、游戏逻辑服（登录和坦克）、对外服）
└── example-springboot #### 综合示例 #### 
    ├── spring-common-pb （通用PB相关）
    ├── spring-game-broker # 游戏网关服 - 启动项目
    ├── spring-game-external # 游戏对外服 - 启动项目
    ├── spring-game-logic-classes （游戏逻辑服 - 班级）
    ├── spring-game-logic-classes-starter # 游戏逻辑服 - 班级 - 启动项目
    ├── spring-game-logic-school （游戏逻辑服 - 学校）
    ├── spring-game-logic-school-starter # 游戏逻辑服 - 学校 - 启动项目
    ├── spring-websocket-client #游戏客户端模拟 - 启动项目
    └── spring-z-one-game （一键启动）
```

## jmeter 压测

[https://gitee.com/iohao/iogame-example/tree/main/example/example-meter](https://gitee.com/iohao/iogame-example/tree/main/example/example-meter)

Eovl/ioGame-example

简介

发行版

贡献者

近期动态

Eovl/ioGame-example .gitee-modal { width: 500px !important; }

简介

发行版

贡献者

近期动态

搜索帮助

Eovl/ioGame-example