game-server
Distributed Java game server for board games and MMORPGs with multi-protocol gateway.
Build scalable MMORPG and board game servers with integrated cluster management and routing.
This is a distributed Java game server architecture designed for board games and MMORPGs, featuring horizontal scaling for gateways, lobbies, and game logic. It suits Java backend developers building multiplayer games who need built-in cluster registration, database wrappers, and multi-protocol support.
What it is
The framework provides cluster management, background monitoring, and a running web version of a fishing game example. It encapsulates Redis clusters, MongoDB, message queues, custom thread models, and table-export tools, with Mina handling TCP, UDP, WebSocket, and HTTP protocols.
Who it's for
It suits Java backend developers experienced with distributed systems who need a foundation for MMORPG or board game servers. It does not suit developers looking for active feature updates, as the author has moved new development to successor projects like GameServer4j.
Key features
Distributed Cluster Architecture
Includes registration centers, gateway servers, login nodes, and hall servers designed for horizontal scaling.
Multi-Protocol Gateway
Uses Mina to support TCP, UDP, WebSocket, and HTTP client connections simultaneously.
Database and Queue Wrappers
Encapsulates Redis clusters, MongoDB, and message queue processing for rapid backend integration.
Built-In Game Tools
Provides state machines, behavior trees, A* pathfinding, and navigation mesh utilities.
Up and running in 3 steps
Our honest verdict
What's great
- Supports multiple client communication protocols out of the box through Mina.
- Includes pre-built wrappers for Redis clusters and MongoDB.
- Provides horizontal scaling for gateways, halls, and game logic servers.
- Comes with classic game AI tools like behavior trees and A* pathfinding.
Where it falls short
- No longer receives new feature updates, as development shifted to newer repositories.
- Requires managing a complex distributed Java architecture with multiple server types.
- Documentation relies heavily on the GitHub wiki and community QQ groups.
Pricing & license
Free under its license, with the only cost being running it yourself on your own infrastructure.
Open remote AI-training roles
880 open remote AI-training roles, updated November 15, 2026; most pay $20–$175 an hour. Zekai lists them free; the application goes to the employer’s platform.
Alternatives
Use it, or have us set it up
FAQ
Is this project actively developed?
No, the repository is only in maintenance mode, and the author recommends using GameServer4j for new versions.
What protocols does the gateway support?
The Mina-based gateway supports TCP, UDP, WebSocket, and HTTP.
Where is the AI functionality located?
The game-ai components have been moved to a separate repository named GameAi4j.
