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);
}