T2FGame 0.0.2

T2FGame

T2FGame 是一个基于 .NET 9 的高性能分布式游戏服务器框架，灵感来源于 Java 游戏框架 ioGame。

特性

• 高性能网络层：基于 SuperSocket 2.x 的 TCP 通信
• 分布式架构：基于 Microsoft Orleans 的 Actor 模型
• DDD 支持：完整的领域驱动设计基础设施
• Pipeline 处理链：可扩展的请求处理管道
• 多数据库支持：MongoDB、SQL Server、PostgreSQL、MySQL
• 房间系统：内置游戏房间和匹配功能

架构概览

┌─────────────────────────────────────────────────────────────────┐
│                         客户端 (Client)                          │
└─────────────────────────────────────────────────────────────────┘
                                │
                                ▼
┌─────────────────────────────────────────────────────────────────┐
│                    T2FGame.Network.Socket                        │
│                      (外部网关 Gateway)                           │
│  ┌──────────────┐  ┌──────────────┐  ┌──────────────┐           │
│  │ TCP Server   │  │ 协议编解码    │  │ 会话管理      │           │
│  └──────────────┘  └──────────────┘  └──────────────┘           │
└─────────────────────────────────────────────────────────────────┘
                                │
                                ▼
┌─────────────────────────────────────────────────────────────────┐
│                   T2FGame.Cluster.Orleans                        │
│                      (消息代理 Broker)                            │
│  ┌──────────────┐  ┌──────────────┐  ┌──────────────┐           │
│  │ BrokerGrain  │  │ 路由分发      │  │ 负载均衡      │           │
│  └──────────────┘  └──────────────┘  └──────────────┘           │
└─────────────────────────────────────────────────────────────────┘
          │                   │                   │
          ▼                   ▼                   ▼
┌─────────────────┐  ┌─────────────────┐  ┌─────────────────┐
│ GameServerGrain │  │ GameServerGrain │  │ GameServerGrain │
│   (用户模块)     │  │   (战斗模块)     │  │   (房间模块)     │
└─────────────────┘  └─────────────────┘  └─────────────────┘
          │                   │                   │
          ▼                   ▼                   ▼
┌─────────────────────────────────────────────────────────────────┐
│                       T2FGame.Action                             │
│                     (业务处理 Pipeline)                           │
│  ┌──────────────┐  ┌──────────────┐  ┌──────────────┐           │
│  │ 认证/授权     │  │ Action 调用   │  │ 异常处理      │           │
│  └──────────────┘  └──────────────┘  └──────────────┘           │
└─────────────────────────────────────────────────────────────────┘
          │                   │                   │
          ▼                   ▼                   ▼
┌─────────────────────────────────────────────────────────────────┐
│                        T2FGame.Core                              │
│                     (DDD 基础设施)                                │
│  ┌──────────────┐  ┌──────────────┐  ┌──────────────┐           │
│  │ Entity       │  │ Result 模式   │  │ 领域事件      │           │
│  │ AggregateRoot│  │ Error 处理    │  │ EventBus     │           │
│  └──────────────┘  └──────────────┘  └──────────────┘           │
└─────────────────────────────────────────────────────────────────┘
                                │
                                ▼
┌─────────────────────────────────────────────────────────────────┐
│                 T2FGame.Persistence.MongoDB                      │
│                      (数据持久化)                                 │
└─────────────────────────────────────────────────────────────────┘

模块说明

快速开始

1. 安装

# 创建新项目
dotnet new console -n MyGameServer
cd MyGameServer

# 添加 T2FGame 依赖
dotnet add package T2FGame.Core
dotnet add package T2FGame.Protocol
dotnet add package T2FGame.Action
dotnet add package T2FGame.Network.Socket
dotnet add package T2FGame.Cluster.Orleans
dotnet add package T2FGame.Persistence.MongoDB

2. 定义 Action

[ActionController(cmd: 1)] // 用户模块
public class UserController
{
    private readonly IUserService _userService;

    public UserController(IUserService userService)
    {
        _userService = userService;
    }

    [ActionMethod(subCmd: 1, Description = "用户登录")]
    public async Task<LoginResponse> Login(LoginRequest request, FlowContext context)
    {
        var result = await _userService.LoginAsync(request.Username, request.Password);

        context.SetAuthenticated(result.UserId);

        return new LoginResponse
        {
            UserId = result.UserId,
            Token = result.Token
        };
    }

    [ActionMethod(subCmd: 2, RequireAuth = true)]
    public async Task<UserInfo> GetUserInfo(FlowContext context)
    {
        return await _userService.GetByIdAsync(context.UserId);
    }
}

3. 配置服务器

var host = Host.CreateDefaultBuilder(args)
    // 配置 Orleans 集群
    .UseT2FGameCluster(options =>
    {
        options.ClusterId = "MyGameCluster";
        options.ServiceId = "MyGame";

        // 生产环境使用 MongoDB
        options.ClusteringProvider = ClusteringProviderType.MongoDB;
        options.PersistenceProvider = PersistenceProviderType.MongoDB;
        options.MongoConnectionString = "mongodb://localhost:27017";
        options.MongoDatabaseName = "MyGame";
    })
    .ConfigureServices((context, services) =>
    {
        // 注册 Action
        services.AddActionMethodRegistry(options =>
        {
            options.ScanAssemblies(typeof(UserController).Assembly);
        });
        services.AddActionPipeline();

        // 注册 MongoDB 持久化
        services.AddMongoDbPersistence(options =>
        {
            options.ConnectionString = "mongodb://localhost:27017";
            options.DatabaseName = "MyGame";
        });

        // 注册游戏服务器
        services.AddT2FGameServer(options =>
        {
            options.ServerId = "game-server-1";
            options.ServerName = "游戏服务器1";
        });

        // 注册网络服务
        services.AddT2FGameSocket(options =>
        {
            options.Port = 9000;
        });
    })
    .Build();

await host.RunAsync();

4. 定义 Proto 消息

syntax = "proto3";
package myproject;

message LoginRequest {
    string username = 1;
    string password = 2;
}

message LoginResponse {
    int64 user_id = 1;
    string token = 2;
}

message UserInfo {
    int64 user_id = 1;
    string nickname = 2;
    int32 level = 3;
}

与 ioGame 对比

技术栈

• .NET 9：最新 LTS 版本
• Microsoft Orleans 9.x：分布式 Actor 框架
• SuperSocket 2.x：高性能网络库
• MongoDB Driver 3.x：MongoDB 官方驱动
• Google.Protobuf：高性能序列化

环境要求

• .NET 9.0 SDK
• MongoDB 4.4+（推荐副本集模式）
• 或其他支持的数据库

项目结构

T2FGame/
├── src/
│   ├── T2FGame.Core/              # 核心库
│   ├── T2FGame.Protocol/          # 协议层
│   ├── T2FGame.Action/            # Action 层
│   ├── T2FGame.Network.Socket/    # 网络层
│   ├── T2FGame.Cluster.Orleans/   # 集群层
│   ├── T2FGame.Room/              # 房间模块
│   └── T2FGame.Persistence.MongoDB/ # MongoDB 持久化
├── tests/                         # 测试项目
├── examples/                      # 示例项目
├── Directory.Packages.props       # 中央包管理
├── Directory.Build.props          # 公共构建配置
└── T2FGame.sln                    # 解决方案文件

文档

每个模块都有独立的 README 文档，详细说明用法：

• T2FGame.Core - DDD 基础设施
• T2FGame.Protocol - 协议定义
• T2FGame.Action - Action 框架
• T2FGame.Network.Socket - 网络通信
• T2FGame.Cluster.Orleans - 分布式集群
• T2FGame.Room - 房间系统
• T2FGame.Persistence.MongoDB - MongoDB 持久化

构建

# 还原依赖
dotnet restore

# 构建
dotnet build

# 运行测试
dotnet test

致谢

• ioGame - 灵感来源
• Microsoft Orleans - 分布式 Actor 框架
• SuperSocket - 网络通信库

License

MIT License