01客户端导出
| 导出 | 说明 |
|---|---|
StartProgress(data: table) | 启动进度条，可设置文字、时长、主题、动画以及 onFinish/onCancel 回调。 |
StopProgress(completed: boolean) | 停止当前进度条，并将完成状态传给 onFinish。 |
IsProgressActive() | 返回当前是否有进度条在运行。 |
GetProgressPercentage() | 返回当前进度条 0-100 的完成百分比。 |
SetProgressTheme(theme: string) | 实时更新进度条主题（例如 'modern'）。 |
SetProgressPosition(position: string) | 实时更新进度条在屏幕上的位置。 |
TryReload(usedItem?: string) | 启动受保护的武器装弹流程（在服务端校验弹药类型和物品）。 |
UseConsumable(itemName: string, isDrink: boolean) | 为指定物品播放带动画的进食/饮用进度。 |
02服务端导出
| 导出 | 说明 |
|---|---|
StartProgressForPlayer(playerId: number, data: table) | 从服务端为指定玩家启动进度条。 |
StopProgressForPlayer(playerId: number, completed?: boolean) | 停止指定玩家当前的进度条。 |
StartProgressForAllPlayers(data: table) | 向所有在线玩家广播进度条。 |
StopProgressForAllPlayers(completed?: boolean) | 停止所有在线玩家当前的进度条。 |
03事件
| 名称 | 端 | 说明 |
|---|---|---|
Agency:Progressbar:LoadSettings | 客户端 | 从数据库将每位玩家的界面设置（位置、颜色、缩放、样式）加载到客户端。 |
agency-progressbar:client:start | 客户端 | 用给定数据在接收的客户端上启动进度条。 |
agency-progressbar:client:stop | 客户端 | 带完成标记停止当前进度条。 |
agency:consumables:useFood | 客户端 | 背包桥接，用于食用食物（动画 + 服务端安全生效）。 |
agency:consumables:useDrink | 客户端 | 背包桥接，用于饮用饮品（动画 + 服务端安全生效）。 |
Agency:Progressbar:SaveSettings | 服务端 | 校验玩家的进度条界面设置并保存到数据库。 |
agency-progressbar:server:start | 服务端 | 服务端触发器，为目标（或自己）启动进度条。 |
agency-progressbar:server:stop | 服务端 | 服务端触发器，停止目标（或自己）的进度条。 |
agency:reload:request | 服务端 | 在允许请求的玩家装弹前，校验弹药、武器和物品。 |
agency:consumables:apply | 服务端 | 校验背包，移除一个物品并恢复饥饿/口渴值。 |