# iohao/ioGame

A lock-free, asynchronous, event-driven Java Netty framework for building high-performance network applications. Lightweight and dependency-free, it supports distributed, decentralized clusters without requiring external middleware or databases—ideal for game servers, IoT, and long-lived connection systems.

Repository: https://github.com/iohao/ioGame
Canonical: https://ross.abutalabs.com/products/iogame
Homepage: https://iohao.github.io/game
Language: Java
License: AGPL-3.0
License Family: copyleft
Topics: bolt, game, gameframework, java, netty, springboot, unity3d, unreal-engine, websocket, framework, fxgl, godot, protobuf, socket, tcp, cocos-creator, godot-engine, unity
Last push: 2026-08-02T09:20:15+00:00

## Health v2 (maintenance only)
Score: 88/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 95, release rhythm 71, longevity 100
- inputs: {"age_days": 1563, "days_push": 31, "days_rel": 198, "gap_med": 20.0, "n_releases_24m": 17}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1271, forks 285 (observed 2026-08-28T04:04:11.950704+00:00)

## What it is
ioGame is a lightweight, lock-free, asynchronous, event-driven Java game server framework built on Netty. It supports WebSocket, TCP, and UDP with distributed clustering without external middleware, and can generate typed client SDKs for Unity, Godot, Unreal, Cocos, and web frontends.

## Use cases
- build a multiplayer game server in java
- create a websocket server for real-time games
- develop an iot backend with long-lived connections
- generate client sdk for unity from java server code
- run a distributed game server cluster without middleware
- switch between protobuf and json protocols in one codebase
- build a chat or long-connection system in java

## When to choose
- you need a high-performance java game server framework with clustering built in
- you want websocket, tcp, and udp support from one codebase
- you want to avoid external middleware like redis or mq for distribution
- you target multiple client engines (unity, godot, unreal, web) and want generated SDKs
- you prefer a lightweight, zero-config, pure JavaSE stack

## When to avoid
- your project is not license-compatible with AGPL-3.0
- you need a non-JVM server language
- you want a general-purpose web MVC or REST framework rather than a game/long-connection server
- you require a large ecosystem and many third-party integrations
- you need JDK versions older than 21

## Facets
- artifact type: framework
- maturity: active
- function: web-framework, websocket, rpc, serialization, tracing, authorization, sdk
- domain: web-development, backend, iot, microservices
- platform: jvm, cross-platform
- tags: netty, game-server, lock-free, asynchronous, event-driven, protobuf, client-sdk-generation, long-connection, unity, godot, unreal-engine, cocos-creator, no-middleware, cluster, game-development, real-time, websocket, tcp

## Member repositories
- iohao/ioGame (main) score 88

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:04:11.950704+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T05:03:21.902781+00:00, confidence not recorded.
  - readme: https://github.com/iohao/ioGame (fetched 2026-08-28T04:04:11.950704+00:00, sha d568f9752ff0)
  - homepage: https://iohao.github.io/game (fetched 2026-08-29T12:14:41.730405+00:00, sha 2b8751009bb9)
- Data as of 2026-08-30T08:39:29.467469+00:00.