主要更新

（#I5O5QH、#I5NUGF、#I5K3WE、#I5OB8T）

#I5O5QH

新增集群日志开关 BrokerGlobalConfig.brokerClusterLog，默认为 true

#I5NUGF

之前框架只会在玩家没有登录的时候，临时的使用了一下这个属性来存放 netty 的 channelId。

原因是不想为了这一次的使用，而特意声明一个变量来存放 netty 的 channelId。

简单点说就是在玩家没有登录时，开发者是不能使用该属性的。

只登录了的玩家，框架才不会占用该属性来存放 netty 的 channelId。

现在改为即使没有登录，框架也不占用 HeadMetadata.attachmentData 属性了，开发者可以放心的使用了；

比如，用于在登录时，拿到玩家 IP，用于封号相关和其他的（比如日志、等）

具体使用可参考 https://www.yuque.com/iohao/game/sw1y8u

#I5K3WE

增强顶号强制下线的问题，在发送强制离线时，需要先给个客户端发个错误码。

防止客户端会自动进行重试再次连接。

这里顶号服务端主动断开连接，如果服务器不发送错误码，会导致 2 个客户端来回顶号的情况。

#I5OB8T

修复 JSR380 验证相关缺少判断

maven pom

ioGame 已经上传到中央仓库

https://search.maven.org/search?q=a:bolt-run-one

ioGame 是轻量级的网络游戏服务器框架，只需要在 pom 中引入如下就可以使用了，无需在安装任何其他的中间件产品了。

<dependency>
    <groupId>com.iohao.game</groupId>
    <artifactId>bolt-run-one</artifactId>
    <version>x.y.z</version>
</dependency>

ioGame 是一个由 java 语言编写的网络游戏服务器框架。支持 websocket、tcp ，适用于全球同服、回合制游戏、策略游戏、即时战斗等游戏服务器的开发。具有高性能、稳定、易用易扩展、超好编程体验等特点。可做为 H5、手游、端游的 java 游戏服务器。

ioGame 是轻量级的网络游戏服务器框架，在使用 ioGame 时，无需安装其他服务，如： Nginx、Redis、MQ、Mysql、ZooKeeper、Protobuf 协议编译工具 ... ... 等。简单点说，就是无需安装其他产品就能使用；这意味着在使用上简单了，在部署上也为企业节约了成本。

通过 ioGame 你可以很容易的搭建出一个稳定、高性能、集群无中心节点、分步式、自带负载均衡、跨进程通信、避免类爆炸设计的网络游戏服务器。游戏框架借助于蚂蚁金服 sofa-bolt 通信框架来提供通信方面的稳定与高性能。

在 ioGame 中能让你遗忘 Netty，你几乎没有机会能直接的接触到 Netty 的复杂，但却能享受 Netty 带来的高性能。对开发者要求极低，为开发者节约开发时间。

即使之前没有游戏编程的经验，也能参与到游戏编程中。如果你之前具备一些游戏开发或者 webMVC 相关的知识，则会更容易上手游戏服务器的开发。

ioGame 可以很方便的与 spring 集成（5 行代码）。

• 网络通信框架：职责是各服务器之间的网络通信
• 业务框架：职责是业务逻辑的处理方式和编写方式

通过 ioGame 你可以很容易的搭建出一个集群、分步式的网络游戏服务器！

---

 

通过 ioGame 可以使得游戏编程变得简单，下面是一个业务示例

Proto 协议文件定义

首先我们自定义一个协议文件，这个协议文件作为我们的业务载体描述。这个协议是纯 java 代码编写的，使用的是 jprotobuf，jprotobuf 是对 google protobuf 的简化使用，性能同等。

可以把这理解成 DTO、POJO、业务数据载体等，其主要目的是用于业务数据的传输；

/** 请求 */
@ProtobufClass
@FieldDefaults(level = AccessLevel.PUBLIC)
public class HelloReq {
    String name;
}

@ActionController(1)
public class DemoAction {
    @ActionMethod(0)
    public HelloReq here(HelloReq helloReq) {
        HelloReq newHelloReq = new HelloReq();
        newHelloReq.name = helloReq.name + ", I'm here ";
        return newHelloReq;
    }
}

访问示例（控制台）

当我们访问 here 方法时（通常由游戏前端来请求），控制台将会打印

┏━━━━━ Debug. [(DemoAction.java:4).here] ━━━ [cmd:1 - subCmd:0 - cmdMerge:65536]
┣ userId : 888
┣ 参数: helloReq : HelloReq(name=塔姆)
┣ 响应: HelloReq(name=塔姆, I'm here )
┣ 时间: 0 ms (业务方法总耗时)
┗━━━━━ Debug [DemoAction.java] ━━━

有了以上信息，游戏开发者可以很快的定位问题。如果没有可视化的信息，开发中会浪费很多时间在前后端的沟通上。问题包括：

• 是否传参问题 （游戏前端说传了）
• 是否响应问题（游戏后端说返回了）
• 业务执行时长问题 （游戏前端说没收到响应， 游戏后端说早就响应了）

其中代码导航可以让开发者快速的跳转到业务类对应代码中，在多人合作的项目中，可以快速的知道业务经过了哪些方法的执行，使得我们可以快速的进行阅读或修改；