HTTP API

HTTP 接口参考

所有接口基于裸 HTTP（默认端口 8081），无 TLS。 鉴权见 Security-Model。

只读数据接口

GET /get_sl_data?token=<verify_token>

返回服务器实时状态快照（JSON），包含人数、回合、核弹、玩家列表（含坐标）、DNT_OF 插件状态。

核弹字段仅在回合进行中时实时读取（主线程派发），其余字段来自定时快照（每 push_interval_seconds 刷一次）。

控制接口

POST /control/command

{"command": "help"}

返回 {output, console}：output 为命令直接返回值（点命令含完整回显），console 为 Harmony 捕获的控制台管线输出。

点命令（.m 等）以主机玩家身份在 DotCommandHandler 上直连执行。

POST /control/player/{kick|ban|role|teleport|mute|msg|effect|state}

子命令	字段
kick	target, reason?
ban	target, reason?, duration?(分钟,0=永久)
role	target, role(RoleTypeId 名)
teleport	target, x, y, z
mute	target, mute(bool), mute_scope?(voice|intercom), persistent?(bool,默认false)
msg	target, message, duration_seconds?
effect	target, effect(名称), effect_duration?
state	target, godmode?, bypass?, health?, intercom?

target 支持 PlayerId / UserId / IP / 昵称模糊匹配。

POST /control/wave

重生波次控制。

{"faction": "mtf", "action": "instant"}
{"faction": "mtf", "action": "set", "seconds": 120, "tokens": 5}
{"faction": "chaos", "action": "status"}

faction: mtf 或 chaos。action: instant（立即生成）/ set（设置剩余秒数，可选 tokens 代币数）/ status（查询状态）。

POST /control/map

地图布局读取 + 门/电梯/灯光控制。

{"action": "doors", "door_type": "...", "scope": "type|all|all_not_list", "lock_door": true, "open_door": true}
{"action": "lights", "room_type": "...", "lights_off": true, "duration": 30}
{"action": "elevators", "elevator_type": "Nuke01", "command": "up|down|send", "level": 0}

elevator_type 支持当前 ElevatorGroup 枚举名（Nuke01/LczA01/GateA01…单轿厢粒度）或旧名别名（Nuke=整组）。

POST /control/reports（v2.5.4 推出 · 代号 GIS,GNSS,RS!）

举报记录管理（需 report_enabled: true，玩家在 SSS 面板提交）。

{"action": "list"}
{"action": "handle", "id": "85149ac2..."}

• list → 返回全部未处理（pending）记录：举报人/被举报人 steam64、举报人 IP、昵称、原因、时间、记录 id
• handle + id → 将该记录标记为已处理（handled）；记录不存在或已处理返回 404

记录落盘为插件配置目录下的 reports.json（status: pending / handled）；超 report_max_records 自动清理最旧已处理记录，全部未处理时 LocalAdmin 输出 WARN 提示。

其他端点

端点	说明
/control/round	回合控制 restart/end/start
/control/cassie	CASSIE 播报（translation 可选字幕翻译）
/control/warhead	核弹 start/stop/detonate
/control/wave	重生波次控制（v2.5.4）：faction mtf/chaos，action instant/set/status
/control/slplayer	SLPlayer 音乐控制（需装 SLPlayer）
/control/plugins	插件列表/启停暂存/apply/reload
/control/ban_list	封禁列表
/control/ban/add / ban/revoke	新增/解除封禁
/control/logs	服务器日志尾部读取
/control/files/list/read/write	文件管理（受 FileRoot 白名单限制）
/control/map/export	导出地图原始数据