jforgame

中文 | English

项目介绍

jforgame，是一个用java编写的轻量级高性能手游服务端框架。项目提供各种支持快速二次开发的组件，以及对生产环境的服务进行管理的工具。同时，为了使用户能够快速上手，项目提供了若干常用业务功能作为演示。

项目特点

• 搭配框架博客栏目教程，快速理解项目模块原理
• 支持socket/webSocket接入，完美适配手游/页游/H5/小游戏服务端架构
• 配套c#版本的网络框架，兼容websocket/socket,兼容json/struct。
• 通信协议支持json/protobuf或普通javabean，为客户端提供多种选择
• 一键导出csharp/typescript等客户端语言的通信协议，参考CSharpProtocolGenerator工具
• 内置跨进程通信，强大的客户端异步/同步api，轻松实现跨服业务
• 使用自定义的轻量级orm工具库，支持多数据源，自动建表增加字段，支持表字段全量/增量更新
• 框架提供多种组件，可以直接二次开发业务逻辑
• 不停机热更代码，不停机热更配置，运维，运营不掉线
• 喜欢Go语言，这里也支持 --> Go版游戏服务器
• 基于springboot的jforgame实操项目 --> mmorpg游戏服务器
• 有独立http管理后台网站，为游戏运维/运营提供支持 --> 后台管理系统
• 除了做游戏，也可以用来开发其他网络应用，例如实时聊天 --> 仿QQ聊天应用

模块组织结构

…

jforgame采用组件化的方式，每个模块都是一个独立的组件，用户可以根据自己的需求选择导入目标模块。 例如：如果只需要使用socket通信，那么只需要导入jforgame-socket-netty模块或者jforgame-socket-mina。

快速开始

1. 各模块demo教程 --> wiki
2. 使用git下载代码 git clone https://github.com/kingston-csj/jforgame;
3. 将代码导入带有maven插件的IDE(选择根目录下的pom.xml文件);
4. 新建数据库game_data_001和game_user_001，并分别导入test/resources下的同名sql文件;
5. 启动服务端，入口为ServerStartup类;
   （如果导入项目所有模块，还需要设置好工作区间。例如idea设置：run->EditConfirations->Workingdirectory,设置为，**\jforgame\jforgame-demo。）;
6. 启动客户端，入口为ClientStartup类;
   （如果导入项目所有模块，还需要设置好工作区间。例如idea设置：run->EditConfirations->Workingdirectory,设置为，**\jforgame\jforgame-demo。)
7. 项目demo

导入组件

  
      io.github.jforgame
      jforgame-socket-netty
      latest
  
  
      io.github.jforgame
      jforgame-codec-struct
      latest
  

一行代码启动服务器(socket/websocket)

 TcpSocketServerBuilder.newBuilder()
  .bindingPort(HostAndPort.valueOf(ServerConfig.getInstance().getServerPort()))
  .setMessageFactory(GameMessageFactory.getInstance())
  .setMessageCodec(new StructMessageCodec())
  .setSocketIoDispatcher(new MessageIoDispatcher(ServerScanPaths.MESSAGE_PATH))
  .build()
  .start();

消息协议

@MessageMeta(module = Modules.LOGIN, cmd = LoginDataPool.REQ_LOGIN)
public class ReqAccountLogin implements Message {

  /**
   * 账号流水号
   */
  private long accountId;

  private String password;
  
  }

消息路由

@MessageRoute
public class LoginController {

@RequestHandler
public void reqAccountLogin(IdSession session, ReqAccountLogin request) {
      GameContext.loginManager.handleAccountLogin(session, request.getAccountId(), request.getPassword());
}
}

就是这么简单，写业务只需要依样画葫芦，撸起袖子就是干！！

本栏目详细教程

从零开始搭建游戏服务器框架
漫谈游戏服务器

一起交流

欢迎star/fork，欢迎学习/使用，期待一起贡献代码！！ 如果您发现bug，或者有任何疑问，请提交issue !! bug会被及时修复，并及时发布新的补丁release。
承诺：持续迭代，永久维护！！

mysql合服工程，基于jforgame的分布式五子棋源代码(cocos+h5客户端)，私聊获取。

合作/咨询：+Q 641711541
我刚开通了知识星球，快来瞧一瞧吧~~
(加入星主游戏开发微信群，随时随地交流提问~~)

贡献代码

- 非常欢迎大家一起来维护这个项目，提交代码的时候请按以下规范
```
feat[模块]：新增功能
fix[模块]：修复缺陷/BUG
test[模块]：新增/调整测试用例
doc[模块]：补充、更新文档
refactor[模块]：代码重构/结构调整
upgrade[模块]：升级依赖/插件版本
clean[模块]：移除废弃工具方法与冗余代码
```

e

特别鸣谢

感谢网友CarsonQizhao提供的commons多个优秀的工具类;
感谢网友wupeng0528为threadmodel模块引入Akka风格的Actor配置系统;
感谢网友fagarine解决hotswap在jdk17环境不生效的问题;
以及其他所有参与项目的网友（包括并不限于提出issue，在聊天讨论提出建议或bug），万分感谢！！

免责申明

本项目只用于学习研究，禁止用于非法获利和商业活动。如产生法律纠纷与作者无关！！