中文 | English
jforgame,是一个用java编写的轻量级高性能手游服务端框架。项目提供各种支持快速二次开发的组件,以及对生产环境的服务进行管理的工具。同时,为了使用户能够快速上手,项目提供了若干常用业务功能作为演示。
- 搭配框架博客栏目教程,快速理解项目模块原理
- 支持socket/webSocket接入,兼容手游/页游服务端架构
- 通信协议支持protobuf或java反射,为客户端提供多种选择
- 框架提供多种组件,可以直接二次开发业务逻辑
- 提供热更机制以及jmx接口,方便对生产项目进行监控与维护
- 有独立http后台网站,为游戏运维/运营提供支持 --> 后台管理系统
jforgame
├── jforgame-common --基础公共服务
├── jforgame-match --跨服匹配服
├── jforgame-merge --合服工具
├── jforgame-net --包括io网关模块,玩家消息自动映射到业务模块,异步处理玩家消息的线程模型
├── jforgame-orm --使用自定义的orm框架,用于数据库表记录与程序pojo对象的相互转换
├── hotswap-agent 支持游戏业务热更新的agent机制
├── jforgame-server --游戏基础组件以及业务逻辑模块
| ├── cache包,使用guava cache库,用于支持系统的缓存框架
| ├── db包,使用独立线程,异步处理玩家及公共数据的持久化
| ├── monitor包,系统监控模块,包括使用jmx对程序进行监控
| ├── listener包,事件驱动模型
| ├── doctor包,采用Groovy执行任意动态代码,或JDK的instrument机制修改类方法体
| ├── cross包,天梯等跨服赛事的通信基础
| ├── game/gm包,游戏内部金手指命令
| ├── game/admin包,游戏运营/运维后台命令
| ├── redis包,跨服通信(比如跨服排行榜)
| ├── tools包,简化项目开发的辅助小工具
| └── utils包,各种工具类
名称 | 用途 | 官网 |
---|---|---|
Mina | nio socket 框架 | http:https://mina.apache.org/ |
Netty | nio socket 框架 | http:https://netty.io/ |
jprotobuf | protobuff协议层注解 | https://github.com/jhunters/jprotobuf |
Guava | 玩家数据缓存系统 | https://github.com/google/guava |
Jedis | 跨服数据缓存 | https://redis.io |
quartz | job调度任务 | http:https://www.quartz-scheduler.org/ |
groovy | 热更新维护相关 | http:https://www.groovy-lang.org/ |
proxool | mysql数据链接池 | http:https://proxool.sourceforge.net/ |
slf4j+log4j | 日志系统 | https://www.slf4j.org/ |
maven | 依赖管理及项目构建 | http:https://maven.apache.org/ |
- 登录服工程
- 更多基础设施与业务演示
- 使用git下载代码 git clone https://github.com/kingston-csj/jforgame;
- 将代码导入带有maven插件的IDE(选择根目录下的pom.xml文件);
- 新建数据库game_data_001和game_user_001,并分别导入test/resources下的同名sql文件;
- 启动服务端,入口为ServerStartup类
(开发工具需要将src同目录的configs视为代码目录!如果导入项目所有模块,还需要设置好工作区间。例如idea设置:run->EditConfirations->Workingdirectory,设置为,**\jforgame\jforgame-server。); - 启动客户端,入口为ClientStartup类;
(温馨提醒:在根目录执行mvn clean package install -DskipTests 后,在ide环境下就不用导入所有模块了。例如,只导入jforgame-server模块)
各模块demo教程 --> wiki
本栏目详细教程 --> csdn博客
欢迎star/fork,欢迎学习/使用,期待一起贡献代码!!
如果您觉得有所收获,可以请作者喝杯咖啡。大家的支持,促使我不断改进优化,谢谢!
如果您发现bug,或者有任何疑问,请提交issue !!
架构解析,技术咨询,请加Q475139136(有偿服务,非诚勿扰!!)
本项目只用于学习研究,禁止用于非法获利和商业活动。如产生法律纠纷与作者无关!!