4.1 KiB
4.1 KiB
长期项目约定(FunGame.Server-v3)
架构方向:一切皆模组(Everything is a Module)
用户确定的设计理念:游戏逻辑由房间内生效的模组定义,服务器仅负责核心队列计算与转发。 核心是"多玩家联机":GameModule 本质是封装网络层在 GamingQueue 之上的"游戏模式模组";c/s/IModule 那套只是内容层。
已敲定的分叉(2026-08-26 讨论,2026-08-27 修正)
- GameModule = 游戏模式模组(核心抽象,参考 v2 设计):参考 FunGame.Core v2 分支
Interface/Base/Addons/IGameModule.cs、IGameModuleServer.cs、Library/Common/Addon/GameModule(Server).cs、ExampleGameModule.cs、GamingObject.cs,及旧版C:\milimoe\fungame.server的ServerModel路由(SocketMessageType.Gaming→NowGamingServer.GamingMessageHandler(this, type, data)→ 结果Send回客户端)。- 服务器侧
IGameModuleServer:GamingMessageHandler(model, type, data)switch-case 处理 GamingType(Connect/PickCharacter/Skill/Item/...);StartServer(GamingObject)建房即返回、为每房间建 Worker(玩家/角色/状态);SendGamingMessage广播;模组为单例、GamingObjects管所有进行中对局。 - 客户端侧
IGameModule:实现全部IGaming*EventHandler(局内事件就是模组接口面)+StartGame(Gaming instance)+GameModuleDepend声明内容依赖 +RoomType/MaxUsers/DefaultMap。
- 服务器侧
- 内容层(c/s/IModule)= 纯内容:角色/技能/物品/Effect 模组(
ICharacterModule等 +Factory.OpenFactory显式注册,沿用SkillModule.Load()与EffectHookCache.ScanAllAssemblies()),GameModule 通过GameModuleDepend依赖它们。 - 行为/跨模式逻辑:后续事件订阅模组(全局 Effect / 房间事件总线),非本期重点。
- 热重载:GameModule 逻辑开局锁定;内容模组可热重载。
- v3 现有
IServerPlugin.HandleGamingMessage(IGameSession, string type, data)= v2GamingMessageHandler的薄版;gaming.action尚未接路由(M7 候选"玩家局内决策接入"即此)。
硬约束
- 只改 FunGame.Server-v3,不修改 FunGame.Core 源码。
- 服务器核心收敛为:薄路由/转发 + 对局会话(
IGameSession)+ 模组生命周期(解析房间 GameModule 并编排)。
迁移路线(绞杀者)
- ✅ Contracts:
IGameModuleServer+GameModuleDepend(GamingType/RoomType 复用 Core 枚举);扩展IGameSession(Characters/BroadcastAsync/EndGameAsync)。 - ✅ 标准近战 GameModule(
modules/FunGame.Server.Modules.Melee):StartGameAsync 建 MixGamingQueue + HandleGamingMessage switch-case(Connect/PickCharacter/Surrender)。 - ✅ Host:
PluginKind.GameModuleServer+modules/games目录;GetGameModule;CreateGameFromModule/GetGameOfClient;gaming.action路由;RoomStart 优先 GameModule;GameModulesController modes 纳入。 - ⏳ 玩家局内决策接入(Attack/Skill/Item/Move 驱动队列)、客户端侧 GameModule(webui)、老
IServerPlugin退役。
引擎扩展点备忘(FunGame.Core,只读参考)
- Core 已到 #174:Effect 虚钩子为 Context 模式(
OnTurnStart(TurnContext)/OnEffectGained(HookContext)等),经GamingQueue.EffectDispatch.Trigger*分发(按角色/全队列);GamingType/RoomType枚举在Library/Constant/TypeEnum.cs。 MixGamingQueue/TeamGamingQueue是内置规则(死亡竞赛/组队)。IGameEventHandler局内事件当前未在对局循环派发(v3);v2 中它是 GameModule 的接口面。EventCenter是探索/活动系统(Stores 可复用为房间 KV)。- Oshima 引用不拷贝:内容权威源 = Testing-v3 独立库
C:\milimoe\FunGame.Testing-v3\OshimaGameModules\OshimaGameModules.csproj(最先适配 Core v3);Server-v3 的FunGame.Server.Modules.Oshima只保留包装层并 ProjectReference 它(CopyModulesToHost 同时复制OshimaGameModules.dll到 modules/*/_staging)。内容改动只改 Testing-v3,Server 重新 build 即跟随。 - 本地可编译:dotnet 10.0.400 可用。