来源摘要：GFXSever 核心架构及游戏逻辑

摘要

该材料概述 GameFrameX Server（.NET 8/C# 10）的 Actor 模型游戏服务器框架能力：组件化 Actor、消息协议与路由、网络会话与在线管理、MongoDB 持久化，以及玩家/背包等示例业务模块，并提及部分账号/宠物相关能力尚未完善。

要点

• 框架定位：Actor 模型、分布式、组件化的游戏服务器解决方案（.NET 8 / C# 10）。
• Actor 体系：ComponentAgent + Component；状态管理（StateComponent + CacheState）；ActorType 管理；支持全局与玩家级组件。
• 消息体系：Protobuf；请求/响应（IRequestMessage/IResponseMessage）；通知（INotifyMessage）；MessageMapping；包含 HTTP API 处理器系统。
• 网络通信：通道抽象 INetWorkChannel；SessionManager/Session；在线玩家管理；断连事件；WebSocket/TCP。
• 数据持久化：GameDb 抽象；异步 FindAsync/SaveOneAsync；状态自动持久化 WriteStateAsync；MongoDB（BSON）。
• 业务示例：Player 登录与会话绑定、在线列表；Bag 增删用查、变更通知、配置校验、离线道具发送（含 HTTP 接口）。
• 服务器管理：OnlineSet 在线集合与遍历；首次启动时间与服务器状态；跨天定时器与 QuartzTimer（Cron 支持）。

关联概念/实体

• GameFrameX Server
• GameFrameX Server：核心架构与业务轮廓

来源

• raw/GFXSever核心架构及游戏逻辑.md