Skip to content

v2.6.2-preview Holiday26

Pre-release
Pre-release

Choose a tag to compare

@DNTOF DNTOF released this 17 Oct 05:50

v2.6.2-preview Holiday26

预发布:SLDataAPI 2.6.2-preview,开发代号 Holiday26。适配 SCP:SL 14.2.8 万圣节测试版(Steam holiday 分支)新增的接口。包含 2.6.1 Mores 的全部内容(含同端口自签 TLS)。源码在分支 preview/v2.6.2-holiday,未合入 main。

重要提示(请先读)

  • 这是预发布(Pre-release)版本,目标游戏版本是 14.2.8 万圣节测试版。请只在测试服使用。
  • 本版本按 14.2.8 编译。在 14.2.7 上缺少新成员时会自动回落,但这条回落路径还没有在 14.2.7 服务器上实际运行过。
  • 带 TemporaryBypass 效果的真人开门还没有实测(测试用的假人不能开门),目前只验证了数据读出和效果下发。
  • 自动更新只认稳定版:2.6.x 正式版的更新检查不会推送本版本,需要手动下载。本版本自身在同版本号的 2.6.2 正式版发布后会提示更新。
  • 发现问题请积极开 Issue(附版本号 v2.6.2-preview Holiday26、游戏版本 / Steam 分支、相关日志与复现步骤):https://github.com/DNTOF/SLDataAPI/issues

新增

数据口

  • get_sl_data 新增:
    • game_version:游戏版本串(例如 14.2.8)
    • active_holiday:当前节日(None / Christmas / Halloween / AprilFools)

控制面

  • /control/player/data 新增:
    • effects:玩家当前生效的效果,每项含 name / intensity / duration(0 = 无限期)/ time_left / classification / door_permissions。14.2.8 读 PlayerEffectsController.EnabledEffects,14.2.7 回落为 AllEffects 中已启用的项
    • temporary_bypass:active / intensity / level(none / scp_override(强度 1)/ all(强度 ≥2))/ time_left / grants_door_access(本服游戏版本中该效果是否参与开门判定,14.2.8+ 为 true)
    • effect_door_permissions:所有生效效果提供的开门权限合集(如 None / ScpOverride / All)
  • /control/player/effects 新增可选参数 effect_intensity(0-255,默认 1,与旧行为一致;0 = 关闭该效果)。例:
{"target":"2","effect":"TemporaryBypass","effect_intensity":2,"effect_duration":30}

给 2 号玩家 30 秒全部门权限。ACL 与审计沿用原端点(admin 默认开放、duty 默认拒绝,写入 control_log)。

游戏侧说明:14.2.8 开门判定顺序变为「效果 → 角色 → 手持物品」,任一效果给出足够权限即放行。

更新检查

  • 预发布构建在同版本号的正式版发布后也会提示更新(2.6.2-preview → 2.6.2);正式版构建行为不变。

测试情况

  • 引用 14.2.8 DLL 编译 0 错误;单元测试 211 项全部通过
  • 14.2.8 测试服(非正式服)冒烟:插件加载正常,get_sl_data 返回 game_version: 14.2.8、active_holiday: Halloween;同端口 https:// 访问正常;/control/player/effects 参数校验正常
  • 未测:14.2.7 运行时回落;带效果的真人开门

安装

  1. 备份现有 config.yml / apikey.config
  2. 将 SLDataAPI.dll 放入测试服的 LabAPI/plugins/<端口>/ 或 global/
  3. 确认依赖:0Harmony.dll、Newtonsoft.Json.dll
  4. 重启服务器;TLS 相关说明见 2.6.1 Mores 的 Release

遇到异常请开 Issue,反馈越具体修得越快。