The framework also includes session, limit, metrics, and persist packages. See Session And Room Guide for login sessions, room messages, rate limiting, metrics, and player persistence.
框架同时提供 session、limit、metrics 和 persist 包。登录会话、房间协议、限流、指标以及玩家持久化的使用方式，请参阅 会话与房间指南。
Ginx is a lightweight Go game-server framework with length-prefixed messages, message-ID routing, per-connection read/write goroutines, configurable worker pools, buffered outbound messages, connection properties, connection lifecycle hooks, and graceful shutdown.
Run commands from the repository root so config/ginx.json is loaded:
go run ./main/serverThe example server registers message IDs 0 and 1. Run the matching clients in separate terminals:
go run ./main/client0
go run ./main/client1A complete tutorial example is available in main/tutorial:
go run ./main/tutorial/server
go run ./main/tutorial/clientRun the server and client in separate terminals. The client sends a ping and a heartbeat message every two seconds.
The repository contains a backend compatible with the legacy Unity MMO demo protocol. Start it from the repository root:
go run ./main/unityserverOpen Assets/Scene/Login.unity in the Unity 5.4.1f1 client project, then connect to 127.0.0.1:7777. The Unity server supports player-ID assignment, existing-player synchronization, join/leave broadcasts, chat, and movement messages.
See the Unity client compatibility guide for the startup sequence, packet format, Protobuf messages, message flow, and troubleshooting notes.
Run the automated checks with:
go test ./...
go vet ./...
go build ./...See the game server guide for the message protocol, router setup, concurrency notes, and current production boundaries.
See the game core guide for AOI, room management, game protocol messages, and structured logging.
Ginx 是一个轻量级 Go 游戏服务端框架，提供长度前缀消息协议、按消息 ID 路由、单连接读写协程、可配置 Worker 工作池、带缓冲发包、连接属性、连接生命周期钩子和优雅停服。
请在项目根目录运行以下命令，确保能加载 config/ginx.json：
go run ./main/server示例服务注册了消息 ID 0 和 1。请在两个独立终端中运行对应客户端：
go run ./main/client0
go run ./main/client1完整教程示例位于 main/tutorial 目录：
go run ./main/tutorial/server
go run ./main/tutorial/client请在两个独立终端中运行服务端和客户端。客户端每两秒发送一次 ping 消息和心跳消息。
项目提供了兼容旧版 Unity MMO 示例客户端协议的服务端。在项目根目录执行：
go run ./main/unityserver使用 Unity 5.4.1f1 打开客户端项目中的 Assets/Scene/Login.unity，然后连接 127.0.0.1:7777。Unity 兼容服务端支持玩家 ID 分配、已有玩家同步、玩家加入和离线广播、聊天及移动消息。
完整启动顺序、数据包格式、Protobuf 消息、消息时序和排查方式，请参阅Unity 客户端兼容说明。
运行自动化测试、静态检查和构建验证：
go test ./...
go vet ./...
go build ./...消息协议、路由注册、并发注意事项和当前生产使用边界，请参阅游戏服务端使用指南。
AOI、游戏房间、游戏协议和日志体系的使用方式，请参阅游戏通用能力指南。
框架同时提供 session、limit、metrics 和 persist 包。登录会话、房间协议、限流、指标以及玩家持久化的使用方式，请参阅 会话与房间指南。