IoGame

<h2 align="center" style="text-align:center;"> ioGame </h2> <p align="center"> <strong>Lock-free, async, event-driven architecture — supports clustering & distribution out of the box, no middleware required</strong> <br> <strong>Build decentralized, auto-scaling, multi-process distributed game servers with ease</strong> <br> <strong>Tiny footprint, blazing-fast startup, low memory usage, zero config files, elegant route-level access control</strong> <br> <strong>Simultaneous support for WebSocket, UDP, TCP and more — with built-in full-link distributed tracing</strong> <br> <strong>One codebase, multiple protocols — seamlessly switch between Protobuf, JSON, and beyond</strong> <br> <strong>Near-native performance — 11.52 million business operations per second in a single thread</strong> <br> <strong>Code-as-documentation, JSR380 validation, assertion + exception patterns — minimal maintenance overhead</strong> <br> <strong>Smart same-process affinity with IDE-friendly code navigation & jump-to-source</strong> <br> <strong>Deploy your way — components run independently or fused together</strong> <br> <strong>Write once, generate client SDKs — interactive code generation for any frontend</strong> <br> <strong>Cross-process, cross-machine communication between logic servers</strong> <br> <strong>Dynamic player-to-server binding</strong> <br> <strong>Plays nicely with any framework</strong> <br> <strong>Feels natural for web MVC developers</strong> <br> <strong>No hard dependency on Spring</strong> <br> <strong>Zero learning curve</strong> <br> <strong>Pure JavaSE</strong> </p> <p align="center"> <a href="http://game.iohao.com">https://iohao.github.io/game</a> </p> <p align="center"> <a target="_blank" href="https://www.oracle.com/java/technologies/downloads/#java21"> <img src="https://img.shields.io/badge/JDK-21-success.svg" alt="JDK 21" /> </a> <br> <a target="_blank" href="https://www.gnu.org/licenses/agpl-3.0.txt"> <img src="https://img.shields.io/:license-AGPL3.0-blue.svg" alt="AGPL3.0" /> </a> <br /> <a target="_blank" href='https://gitee.com/iohao/ioGame'> <img src='https://gitee.com/iohao/ioGame/badge/star.svg' alt='gitee star'/> </a> <a target="_blank" href='https://github.com/iohao/ioGame'> <img src="https://img.shields.io/github/stars/iohao/ioGame.svg?logo=github" alt="github star"/> </a> <br /> <a target="_blank" href='https://app.codacy.com/gh/iohao/ioGame/dashboard?utm_source=gh&utm_medium=referral&utm_content=&utm_campaign=Badge_grade'> <img src="https://app.codacy.com/project/badge/Grade/4981fff112754686baad7442be998b17" alt="code quality"/> </a> </p> <hr />

Documentation: https://iohao.github.io/game/docs/intro

Vision

Make game server development effortless. We're here to change the industry — lowering the barrier to entry and making game development tools truly accessible to everyone.

Open, Free & Developer-Friendly License

• There is no commercial edition — never has been, never will be. Every feature is open source.
• We're committed to at least ten years of active maintenance, starting from 2022-03-01.
• ioGame is a lightweight networking framework built for online games, IoT, internal systems, and any scenario that needs persistent connections. The source code is fully open, documentation is free, and usage costs nothing (subject to license terms).

<hr/>

Why AGPL 3.0?

ioGame is released under the AGPL 3.0 license. Projects built with ioGame under this license are free of charge.

We chose AGPL 3.0 because it's fairer to developers. It ensures that project ownership is shared — meaning that even if a developer leaves a company, they retain legitimate rights to the project they helped build.

Contrast this with permissive licenses like Apache 2.0 or MIT, where developers who leave a company lose all control over the project and get nothing in return. We've all seen it: developers pour their hearts into a project through countless late nights and weekends, only to be let go right before — or just after — launch, watching their hard work become someone else's asset.

Under AGPL 3.0, shared ownership means developers are genuinely motivated to invest in and polish their work.

Startup Showcase

ioGame is impressively lean:

• Memory: Minimal footprint.
• Startup: Applications typically boot in under 1 second.
• Package size: ~15 MB as a jar.

What is ioGame?

Looking for a game server framework that's high-performance, stable, easy to use, with built-in load balancing, clean architecture (no class explosion), cross-process communication, decentralized clustering, auto-scaling, and stateful multi-process distribution? Meet ioGame — a Java networking framework designed exactly for this.

ioGame is a lightweight networking framework built for online games, IoT, internal systems, and any scenario that needs persistent connections.

Key Features at a Glance:

1. Truly lightweight — lock-free, async, event-driven from the ground up.
2. Small package, low memory, fast startup.
3. Pure JavaSE — integrates effortlessly with Spring, Vert.x, Quarkus, Solon, and others.
4. Zero learning curve. If you know basic Java or web MVC, you already know how to use ioGame. No game dev experience required.
5. Architecturally eliminates the N×N scaling problem that plagues traditional frameworks.
6. No third-party dependencies for clustering & distribution — just a JVM is all you need.
7. Three-part architecture: External Server + Broker (Gateway) + Game Logic Server — each can run independently or fused together, adapting to any game type.
8. Fully dynamic scaling — add or remove External Servers, Logic Servers, and Brokers on the fly.
9. Multi-server, single-process mode for development — debug distributed systems as easily as a monolith.
10. Logic Servers can run standalone, enabling true modularization.
11. Built-in full-link distributed tracing.
12. Rich communication primitives — logic servers can talk across machines seamlessly.
13. MVC-style coding with non-intrusive Java Beans — effectively prevents class explosion.
14. Built-in per-player thread safety — concurrency handled for you.
15. One codebase supports TCP, WebSocket, UDP simultaneously — no code changes needed. Extensible to KCP, QUIC, and beyond.
16. One codebase for switching data protocols — Protobuf, JSON, and more. Extensible.
17. Hot-swap protocols — add or remove protocols without restarting the gateway or External Server. No player disconnections.
18. Auto-boxing/unboxing of primitives in actions — solves the protocol fragment problem.
19. Pluggable, extensible plugin system.
20. Deploy as single-process or multi-process across machines — switch freely without code changes.
21. Logic Servers never expose ports — immune to port-scanning attacks by design.
22. Built-in stress testing & simulation module with real network conditions, continuous interaction, and automation support.
23. Sync, async, and async-callback methods for inter-service communication.
24. Distributed event bus (like MQ / Redis pub-sub — works across machines and processes).
25. Elegant route-level access control.
26. Intelligent same-process affinity.
27. JSR380 validation + assertions + exceptions = less boilerplate, fewer bugs.
28. Write once, generate everywhere — produce unified interactive SDKs for Godot, UE, Unity, Cocos Creator, Laya, React, Vue, Angular, and more. Massive productivity boost.

Packaging, memory, and startup are all best-in-class: jar size ~15 MB, startup typically under 1 second, low memory footprint.

Ecosystem integration is straightforward — Spring integration takes just 4 lines of code. Beyond Spring, ioGame plays well with Vert.x, Quarkus, Solon, and any other framework, letting you tap into their ecosystems.

Zero learning curve. If you know basic Java or web MVC patterns, you're ready. No game development background needed.

Clean coding style. ioGame provides MVC-like conventions with non-intrusive Java Beans, effectively preventing class explosion. Sync, async, and callback methods are available for inter-service calls — resulting in elegant code with full-link tracing baked in.

Write once, connect everywhere. ioGame generates client interaction code automatically, dramatically cutting client-side workload. Write your Java code once and generate unified SDKs for Godot, UE, Unity, Cocos Creator, Laya, React, Vue, Angular, and more. Supports code generation in C#, TypeScript, GDScript, and C++ — fully extensible.

No N×N headaches. Traditional architectures rely on Redis, MQ, ZooKeeper, and other middleware to scale — hardly "lightweight." ioGame solves the N×N problem architecturally, without external dependencies.

Truly lightweight. No third-party middleware or database is needed for clustering and distribution — just a JVM. This simplifies usage and slashes deployment and maintenance costs. A single dependency gives you the entire framework — no Nginx, Redis, MQ, MySQL, ZooKeeper, or Protobuf compiler to install.

Flexible architecture. ioGame's [three-part design](https://iohao.github.io/game/