原创 【XMHeavenlyTribulation·天劫挑战】 1.0.2

API接口​

StartHeavenlyTribulation​

bool StartHeavenlyTribulation(string userIdString, int level, bool showUI = true)

• 为指定玩家发起天劫挑战
• userIdString: 玩家SteamID字符串
• level: 天劫等级
• showUI: 是否显示确认UI（false则直接开始）
• 返回值：是否成功发起

IsPlayerInTribulation​

bool IsPlayerInTribulation(string userIdString)

• 检查玩家是否正在进行天劫
• 返回值：true表示正在进行天劫

GetPlayerTribulationLevel​

int GetPlayerTribulationLevel(string userIdString)

• 获取玩家当前天劫等级
• 返回值：天劫等级，-1表示未在进行天劫

StopPlayerTribulation​

bool StopPlayerTribulation(string userIdString, string reason = "管理员终止")

• 强制停止玩家的天劫
• 返回值：是否成功停止

Hook事件​

OnHeavenlyTribulationStart​

void OnHeavenlyTribulationStart(string userIdString, int level)

• 当玩家发起天劫挑战时触发

OnHeavenlyTribulationBegin​

void OnHeavenlyTribulationBegin(string userIdString, int level)

• 当天劫正式开始时触发（倒计时结束后）

OnHeavenlyTribulationSuccess​

void OnHeavenlyTribulationSuccess(string userIdString, int level)

• 当玩家成功完成天劫时触发

OnHeavenlyTribulationFailed​

void OnHeavenlyTribulationFailed(string userIdString, int level, string reason)

• 当玩家天劫失败时触发
• reason: 失败原因（如"死亡"、"掉落平台"等）