maven>> jforgame>> 返回
项目作者： kingston-csj

项目描述 ：
jforgame是一个一站式游戏服务端开发框架，包含游戏服，跨服，匹配服，后台管理系统等模块。同时提供大量业务案例以供学习。
高级语言： Java
项目地址: git://github.com/kingston-csj/jforgame.git
创建时间： 2017-06-18T06:41:13Z
项目社区：https://github.com/kingston-csj/jforgame
开源协议：Apache License 2.0
下载


中文 | English

项目介绍　　

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

项目特点

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

模块组织结构

  1.   jforgame
  2.   ├── jforgame-commons --基础公共服务  
  3.   ├── jforgame-runtime --应用运行时监控数据，包括内存，线程，类等等
  4.   ├── jforgame-socket-parent     --Tcp socket通信，包括io网关模块，消息路由，会话管理，包含netty和mina版本      
  5.       ├── jforgame-socket-api    --服务端/客户端基础API接口
  6.       ├── jforgame-socket-netty  --netty版实现，包含简易WebSocket
  7.       ├── jforgame-socket-mina   --mina版实现
  8.   ├── jforgame-orm     --使用自定义精心定制的orm库，用于数据库表记录与程序pojo对象的相互转换        
  9.   ├── jforgame-spring-boot-starter-data    --以springboot的starter模式封装对配置数据的读取，支持csv，excel等文件格式。支持配置数据热更新,支持二级缓存。       
  10.   ├── jforgame-hotswap  --支持游戏业务热更新
  11.   ├── jforgame-codec-parent         --用于socket通信的数据编解码  
  12.       ├── jforgame-codec-api        --消息编解码API接口
  13.       ├── jforgame-codec-protobuf   --protobuf实现
  14.       ├── jforgame-socket-mina      --普通javabean，反射实现  
  15.   ├── jforgame-demo  --游戏基础组件以及业务逻辑模块  
  16.   |    ├──  cache包，使用guava cache库，用于支持系统的缓存框架    
  17.   |    ├──  db包，使用独立线程，异步处理玩家及公共数据的持久化  
  18.   |    ├──  monitor包，系统监控模块，包括使用jmx对程序进行监控  
  19.   |    ├──  listener包，事件驱动模型  
  20.   |    ├──  doctor包，采用Groovy执行任意动态代码，或JDK的instrument机制修改类方法体 
  21.   |    ├──  cross包，跨服赛事的通信基础 
  22.   |    ├──  game/gm包，游戏内部金手指命令
  23.   |    ├──  game/admin包，游戏运营/运维后台命令  
  24.   |    ├──  redis包，跨服通信（比如跨服排行榜）  
  25.   |    ├──  tools包，简化项目开发的辅助小工具  
  26.   |    └──  utils包，各种工具类

快速开始

  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. 作为组件导入

    1. <dependency>
    2.    <groupId>io.github.jforgame</groupId>
    3.    <artifactId>jforgame-socket-netty</artifactId>
    4.    <version>2.1.1</version>
    5. </dependency>
    6. <dependency>
    7.    <groupId>io.github.jforgame</groupId>
    8.    <artifactId>jforgame-codec-struct</artifactId>
    9.    <version>2.1.1</version>
    10. </dependency>

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

    1. TcpSocketServerBuilder.newBuilder()
    2. .bindingPort(HostAndPort.valueOf(ServerConfig.getInstance().getServerPort()))
    3. .setMessageFactory(GameMessageFactory.getInstance())
    4. .setMessageCodec(new StructMessageCodec())
    5. .setSocketIoDispatcher(new MessageIoDispatcher(ServerScanPaths.MESSAGE_PATH))
    6. .build()
    7. .start();

    本栏目详细教程

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

一起交流

欢迎star/fork，欢迎学习/使用，期待一起贡献代码！！
如果您发现bug，或者有任何疑问，请提交issue !!
mysql合服工程，基于jforgame的分布式五子棋源代码，私聊获取。
合作/咨询：+Q 641711541
我刚开通了知识星球，快来瞧一瞧吧~~
定时更新基础业务模块开发，付费用户可向星主索取整套可运行源码~~

免责申明

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