using FunGame.Core.Entity; using FunGame.Core.Model.Queue; using FunGame.Server.Contracts.Networking; namespace FunGame.Server.Contracts.Gaming; /// /// 对局会话(宿主维护,暴露给游戏模式模组 GameModuleServer) /// 模组能力:读参与角色 / 广播局内事件 / 结束对局 /// public interface IGameSession { /// 对局唯一标识 Guid Id { get; } /// 战斗引擎队列(模组建房时创建) GamingQueue Queue { get; } /// 游戏模式(GameModule 名 / 服务器插件名) string Mode { get; } /// 用户 Id -> 客户端会话(本局参与者) IReadOnlyDictionary Clients { get; } /// 对局是否仍在运行 bool Running { get; } /// 自定义数据(模组私有状态) Dictionary CustomData { get; } /// 本局参与角色(宿主装配,供模组取用) IReadOnlyList Characters { get; } /// 广播消息给本局全部用户(userIds 为空)或指定用户 Task BroadcastAsync(string messageType, Dictionary data, params long[] userIds); /// 结束对局(宿主负责归档回合记录与广播结算) Task EndGameAsync(bool aborted = false); }