You are viewing a potentially older version of this package. View all versions.
SuzuAy-SaveManager-0.3.1 icon

SaveManager

SM - unlimited save slots for Casualties Unknown. Save anytime with F5, pick any slot from a native settings tab, sandbox & multiplayer aware.

Date uploaded 7 hours ago
Version 0.3.1
Download link SuzuAy-SaveManager-0.3.1.zip
Downloads 15
Dependency string SuzuAy-SaveManager-0.3.1

This mod requires the following mods to function

BepInEx-BepInExPack-5.4.2305 icon
BepInEx-BepInExPack

BepInEx pack for Mono Unity games. Preconfigured and ready to use.

Preferred version: 5.4.2305

README

SM (Save Manager)

给 Casualties Unknown 加无上限存档槽的 BepInEx 5 插件。 Unlimited save slots for Casualties Unknown — a BepInEx 5 plugin.

中文 · English · License


中文

简介

原版只有一个续关点 save.sv,而且读档成功后就把文件删掉。SM 把每次存档拍成独立快照:游戏里随时按 F5 存,设置菜单里多出一个「存档」分页可以挑任意一档读,档数没有上限,游戏外也能直接拖文件换档。界面全部用游戏原生 prefab 拼,和设置菜单其它页一个样。

功能

  • 无上限存档槽:每次存档一个独立文件夹,自动命名(2026-11-22_1534_D1)
  • 游戏内随时存档:F5,不用回主菜单
  • 设置菜单第 6 个分页「存档」:左侧操作栏 + 右侧可滚动存档列表,行/字体/边框/音效都是游戏原生的
  • 游戏内直接读档:解除暂停 → 回主菜单 → 铺档 → 继续,回到该层开头
  • 沙盒档 / 实机档双向隔离:沙盒里只看得到沙盒档,反之亦然,跨模式读取会被拒绝
  • 联机兼容:把 CasualtiesTogether 的 mp_save\(每个玩家的 STEAM_<id>\save.sv、mp_rules.json)整目录收进槽里
  • 覆盖前自动留上一档,可一键回滚
  • 所有开关都能在游戏里改(存档页 →「存档选项与设置 ▸」独立子页),改完立即写盘,下次启动保持
  • 控制台命令,方便脚本化

安装

需要 BepInEx 5.4.23.x(netstandard2.1)。

  • Gale / Thunderstore:在模组列表里搜 SM 或 SaveManager 直接装(社区:Casualties: Unknown)
  • 手动:
<游戏目录>\BepInEx\plugins\SaveManager\SaveManager.dll

启动后 BepInEx\LogOutput.log 里应能看到 设置页已注册「存档」分页。

使用

键 作用
F5 存档到新槽(自动命名)
F8 打开设置 →「存档」分页(游戏内会先自动暂停)
F9 读最近一档(按当前模式取)

也可以走原生路径:Esc 暂停 → 设置 → 点「存档」。

存档页布局:

┌──────────────┬──────────────────────────────────────────┐
│ + 新建存档   │ 已选:2026-11-22_1534_D1                 │
│ 读取最近一档  │ ┌ 新名字 ──────────────────────────────┐ │
│ 打开文件夹    │ └──────────────────────────────────────┘ │
│ 读取此档      │ 共 4 档(无上限,按时间倒序)             │
│ 回滚上一档    │ ▶ 2026-11-22_1621_D1  D1 · 0m28s · 4件 · 联机 │
│ 删除此档      │   2026-11-22_1610_D1  D1 · 1m22s · 0件 · 沙盒 │
│ 存档设置 ▸    │   …(右侧列表可滚轮/拖拽滚动)            │
└──────────────┴──────────────────────────────────────────┘

控制台命令:

cssave [名字]      存一个新槽(不写名字=自动命名)
cslots             列出所有槽
csload <槽名>      读这个槽(回主菜单流程)
csslots            打开设置里的「存档」分页
csdir              打开存档目录
csdel <槽名>       删除
csrename <旧> <新>  改名
csrollback <槽名>   回滚到该槽的 backup/
csexport <槽名>     把槽铺成游戏当前的 save.sv

存档放在哪

%USERPROFILE%\AppData\LocalLow\Orsoniks\CasualtiesUnknown\SaveSlots\
  <槽名>\
    meta.json     元数据(时间/层数/存活/角色/件数/模式/沙盒/作弊/玩家)
    save.sv       单人存档(原版格式,gzip + JSON)
    mp\           联机存档(存在时才有)
    backup\       覆盖同名槽之前的上一档

不进游戏换档:

  1. 关掉游戏
  2. SaveSlots\<槽名>\save.sv 覆盖到 ...\Orsoniks\CasualtiesUnknown\save.sv
  3. 联机档:SaveSlots\<槽名>\mp\ 整个覆盖到 ...\CasualtiesUnknown\mp_save\
  4. 开游戏 → 主菜单点「继续」

配置

BepInEx\config\suzuay.savemanager.cfg(也能在游戏「存档设置」子页改,重启后保持)

键 默认 说明
ExperimentalInGameLoad true 游戏内直接读档
AutoSave.Enabled / Minutes false / 5 定时自动存档
MarkCheatedSave false 存档标记 cheated(成就关闭到重启)
SandboxNoCheatMark true 沙盒里不标作弊
AllowInMultiplayer true 联机时允许存读档
KeepLastBackup true 覆盖同名槽前保留上一档
BypassTutorialGate true 没做完基础教程也能读档
SlotRootOverride 空 自定义存档根目录
QuickSave / QuickLoad / Panel F5 / F9 / F8 键位

已知限制

  1. 读档回到当前层的开头:原版 save.sv 只存身体/物品/世界数值,不含地图布局与玩家坐标,地图每层随机重新生成(原版 saveandquit 同样如此)
  2. 深度 ≥ 9(WHERE WE MUST REACH 及之后):原版不许存档,本插件绕过控制台检查直接调 SaveGame(),但读回来是否正常未验证,别在终点层存
  3. 联机:只负责整目录搬运 mp_save\,多人局细节取决于 CasualtiesTogether 本身
  4. 成就:MarkCheatedSave 默认关;打开后按原版语义「成就关闭到重启」

兼容性

项 版本
游戏 Casualties Unknown(Unity 2022.3.62f3,Mono)
BepInEx 5.4.23.x(netstandard2.1)
HarmonyX 随 BepInEx 一起(0Harmony.dll)
联机模组 CasualtiesTogether(mp_save\ 格式)

构建

git clone https://github.com/SuzuAy/SaveManager
cd SaveManager
Copy-Item local.props.example local.props   # 填自己的游戏路径
dotnet build SaveManager.csproj -c Release

local.props 填两个路径:GameRoot(游戏根目录,含 CasualtiesUnknown_Data\Managed)、GaleProfileBepInEx(BepInEx 目录,含 core\ 与 plugins\)。编完自动把 DLL 拷到 plugins\SaveManager\。

也可以直接命令行覆盖:

dotnet build -c Release -p:GameRoot="D:\Games\Casualties Unknown" -p:GaleProfileBepInEx="D:\Games\Casualties Unknown\BepInEx"

English

What it is

Vanilla Casualties Unknown keeps a single resume point (save.sv) and deletes it once you load it. SM snapshots every save into its own folder: press F5 anytime, open the new Save tab in the settings menu to load any slot — unlimited slots — and you can swap files on disk while the game is closed. The UI is built from the game's own prefabs, so it matches the rest of the settings menu.

Features

  • Unlimited slots, auto-named (2026-11-22_1534_D1)
  • Save anytime in-game with F5
  • Native "Save" tab (6th settings page): left action column + scrollable slot list
  • In-game load: unpause → main menu → restore files → continue (back to the start of the current layer)
  • Sandbox / normal saves are isolated from each other; cross-loading is refused
  • Multiplayer aware: captures the whole mp_save\ folder used by CasualtiesTogether (per-player STEAM_<id>\save.sv, mp_rules.json)
  • Keeps the previous version of a slot before overwriting; one-click rollback
  • All options editable in-game (Save → "Save options ▸" sub-page) and persisted to the config
  • Console commands for scripting

Install

Requires BepInEx 5.4.23.x (netstandard2.1).

  • Gale / Thunderstore: search SM or SaveManager (community: Casualties: Unknown)
  • Manual: drop the DLL at <GameDir>\BepInEx\plugins\SaveManager\SaveManager.dll

Keys

F5 save · F8 open the Save tab · F9 load the most recent slot of the current mode

cssave [name]   cslots   csload <slot>   csslots   csdir
csdel <slot>    csrename <old> <new>    csrollback <slot>    csexport <slot>

Save location

%USERPROFILE%\AppData\LocalLow\Orsoniks\CasualtiesUnknown\SaveSlots\<slot>\
    meta.json   save.sv   mp\   backup\

To swap a slot outside the game: copy <slot>\save.sv over ...\CasualtiesUnknown\save.sv (and <slot>\mp\ over ...\CasualtiesUnknown\mp_save\ for multiplayer saves), then launch the game and press Continue.

Known limitations

  1. Loading returns you to the beginning of the current layer — vanilla saves contain no map layout or player position
  2. Depth ≥ 9 layers cannot be saved in vanilla; this mod bypasses that check but loading such a save is untested
  3. Multiplayer handling is limited to copying mp_save\; the rest is up to CasualtiesTogether
  4. MarkCheatedSave is off by default; enabling it disables achievements until restart

License

MIT License, Copyright (c) 2026 SuzuAy. The full, legally binding text is in LICENSE; the summary below is only a convenience and the LICENSE file wins.

You may use, copy, modify, merge, publish, distribute, sublicense and/or sell copies of the software; use it in videos, modpacks and on servers, commercial or not.

You must keep the copyright notice and this permission notice in all copies or substantial portions of the software.

No warranty — the software is provided as is, without warranty of any kind, express or implied, including but not limited to the warranties of merchantability, fitness for a particular purpose and non-infringement. In no event shall the authors be liable for any claim, damages or other liability arising from the software or its use.

Scope & third parties — this repository contains only original plugin source code. It does not ship, unpack or redistribute the game, BepInEx, HarmonyX, Unity, TextMeshPro or any other third-party asset; those are referenced at compile time only.

No affiliation — SM is an unofficial fan-made mod. It is not affiliated with, endorsed by, or supported by the developers or publishers of Casualties Unknown, Thunderstore, Gale, or the CasualtiesTogether mod.

Your risk — save files and mods can fail. Back up your saves (%LocalLow%\Orsoniks\CasualtiesUnknown\) before using save-manipulating tools.

CHANGELOG

Changelog

0.4.6

  • 修「存档页和原版「画面」设置行叠在一起」:SettingsMenu.Start 会先渲染默认的 Video 分页行,独立窗口里之前没清掉 ⇒ 现在进窗前把 spawnedSettings(反射)与 content 下的残留子物体一并销毁
  • 日志新增 存档窗口:已清空原版设置行

0.4.5

  • 修「点存档按钮闪一下然后黑屏无反应」:0.4.4 把分页栏的父节点整个 SetActive(false),而那个父节点很可能同时装着 content ⇒ 连窗口内容一起消失、只剩暂停的黑色底。改为逐个隐藏分页按钮本身,绝不动父节点
  • 隐藏/重置按钮的成功数量写进日志,方便排查

0.4.4

  • ESC 存档按钮:位置改到齿轮右上约一格处(按主人红圈标注),图标自绘白圈 + 软盘(之前克隆的整张图标贴图被替换,圈也一起没了)
  • 存档界面独立成窗口:暂停按钮不再跳去「设置 → 存档」,而是打开独立存档窗口——复用游戏的 SettingsMenu prefab 当外壳(边框/背景/返回按钮都是原版),隐藏分页栏与「重置为默认」,内容换成存档页
  • 设置菜单里的「存档」分页仍然保留(方便从设置进)

0.4.3

  • ESC 存档按钮修图标:原版按钮是「外层圆环 Image + 图标 Image」,之前只改了子级导致图标仍是返回箭头 ⇒ 改为比对不同按钮的贴图定位图标那一层再替换(圆环不动)
  • ESC 存档按钮修位置:改为放在齿轮按钮右上方(+0.95 × 尺寸, +2.3 × 尺寸),并钳制在父容器内,不再压到大圆和文字
  • 左栏去掉多余标题:删掉「存档设置」标题行与内联入口,改为底部固定一行「设置」(点进设置页)
  • 设置页改成折叠分区 + 原版控件:分区头 ▾/▸ 行为 / 存档标记 / 其它 / 界面 可折叠;开关用 Special/GameSettingBool(右侧复选框,同游戏设置页)、间隔用 Special/GameSettingInt、语言用 Special/GameSettingDropdown

0.4.2

  • ESC 存档按钮改到右侧空白处:横向取「齿轮与最右按钮」的中点、纵向高出按钮行约 1.3 格(按主人截图里箭头的位置),不再挤进按钮行
  • 软盘图标重绘:实心白盘体 + 挖空标签窗 + 挖空快门(内含白色滑片),小尺寸下更醒目
  • 新增语言选项:存档设置 →「界面 / Interface」→ Language / 语言,可循环 跟随游戏(默认)/ 中文 / English,改完立即生效并写回配置

0.4.1

  • 修 ESC 存档按钮:改为克隆游戏原版圆按钮(圆环粗细、描边、悬停效果一致),只把图标换成纯白软盘剪影,不再自绘圆环
  • 位置改到按钮组最右侧(超出容器就自动往上排),不再和中间的图标重叠
  • 中英双语:暂停按钮 tooltip 与整个存档页文案跟随游戏当前语言(Locale.currentLangName + 系统语言兜底)

0.4.0

  • ESC 暂停菜单新增圆形「存档」按钮:白线圆环 + 软盘图标(程序生成,与游戏黑底白线风格一致),点击直达存档分页
  • 按钮注册进 PauseHandler.buttons / buttonPos,复用原生「从中心弹出 + 缩放渐入」动画,位置按现有按钮排列方向自动排在末尾
  • 悬停有原版 tooltip(「存档 / 打开存档页面」)

0.3.1

  • 文档重整:README 改为中英双语,删掉有误的截图,许可段补全(可用范围 / 必须保留声明 / 免责 / 第三方与归属声明)
  • 无功能变更,仅打包内容(Thunderstore 的 README 随版本走,所以发一个新版本)

0.3.0

  • 改名为 SM (Save Manager):插件 GUID suzuay.savemanager,DLL 与插件目录改为 SaveManager
  • 发布到 Thunderstore 社区 casualties-unknown(因此也会出现在 Gale 的模组浏览里)
  • 旧版配置 xiaomi.cssaveslots.cfg 不再读取,首次启动会生成 suzuay.savemanager.cfg

0.2.4

  • 存档页所有行改用游戏原生 prefab;分页宽度按布局组的真实 spacing + padding 计算,不再溢出
  • 沙盒档 / 实机档双向隔离:列表过滤 + 读档前校验
  • 插件选项搬进「存档设置」独立子页;MarkCheatedSave 默认改为关;改完配置显式写盘
  • 分页标签改为「禁用克隆来的 TMP / 贴图 + 自绘文字」,修掉显示成「画面/语言」的问题
  • 左栏独立滚动、行点击带拖动判定,修掉「滑一下就跳回顶部」

0.2.0

  • 界面改到设置菜单的第 6 个分页(原生 UI)
  • 游戏内直接读档(解除暂停 → 回主菜单 → 铺档 → 继续)默认开启
  • 沙盒模式识别(不标作弊、槽上标「沙盒」)

0.1.0

  • 初版:F5 随时存档、无上限槽、backup\ 回滚、控制台命令、CasualtiesTogether mp_save 兼容