MIMESIS - BetterCheckpoint

English · 中文说明

Getting wiped shouldn't cost you the whole run. BetterCheckpoint saves the game the moment you depart, so a full-team wipe puts you back at that departure — same stage, same money, same items, same tram — instead of throwing you back to stage 1.

What it does

• Saves at departure. Every time you leave the maintenance room, the mod quietly writes a checkpoint: tram repaired, shopping done, items in your pockets.
• Full-team wipe → back to that checkpoint. Stage, cash left over, carried items, stash, tram upgrades and shop discounts all come back.
• Vanilla instead resets to stage 1 with starting money and an un-repaired tram.
• Works alone or in a group. Only the host needs it.

Where the checkpoint is taken

The run has three parts: maintenance room → departure → dungeon. The game already saves once, when you first walk into the maintenance room — but that's before you shop and before the tram is fixed.

So the checkpoint is taken at the only moment that behaves like a real save point: everything bought, tram fixed, money already spent.

Settings

What you give up

Loot found on the run that killed you isn't in the checkpoint — it was taken at departure, before you found it.

Wiping before your first departure of a session: there's no checkpoint yet, so the mod falls back to the game's own auto-save. Money and items are still there, but you'll repair the tram and shop again.

The deathmatch still happens. A wipe still runs the usual deathmatch round before the maintenance room reloads. Skipping it would mean rewriting how the room hands over, which is out of scope here.

Notes

• Your items are laid out on the maintenance room floor, not stuffed straight into your backpack. That's the only way to keep durability, ammo counts and other per-item details — the game's shortcut path only carries item IDs.
• Normal clears are untouched. Finishing a dungeon successfully takes a different route through the game and never touches this code.
• The checkpoint file is MMGameData01C.sav (one per save slot) next to your normal saves. It's overwritten on every departure, only the latest one is kept, and the game's own save list never shows it. Delete it and the mod falls back to the auto-save.
• Your normal auto-save is left alone. The mod borrows the game's save routine, then puts the original auto-save back exactly as it was — "Continue" behaves like it always did.

Installation

With a mod manager (recommended). r2modman or Gale; MelonLoader is pulled in automatically.

Manual. Install MelonLoader 0.7.3, drop BetterCheckpoint.dll into MIMESIS/Mods/, run once.

Configuration

• In game: the 「模组」 button on the main menu (needs BetterModMenu) or F9, category 「检查点」.
• In the file: UserData/MelonPreferences.cfg, section [BetterCheckpoint].

Multiplayer

Host only. Both halves — taking the checkpoint and restoring it — are host-side steps. Clients need nothing installed and will simply follow the host back to the earlier stage.

Troubleshooting

With Verbose log on:

[检查点] 发车前已存档：关卡 4，钱 320，道具 12 件
[检查点] 完整回档（发车前存档）：关卡 4 → 4（钱 320，道具 12 件，天 0）

The first line appears on every departure. The second appears after a wipe; the note in brackets says where the data came from — if it says 「维修室存档」, the checkpoint file was missing and the fallback was used.

Reasons for a fallback are printed too: 发车前存档失败：…, 读不到检查点存档, 完整回档失败. If you see 找不到 ... or 反射失败, the game changed and the mod needs an update.

中文说明

团灭不该把整局进度赔进去。BetterCheckpoint 在你发车的那一刻存一份档，团灭后直接回到发车点 —— 关卡、钱、买好的道具、储藏箱、电车升级全都还在，而不是被打回第一关。

它做了什么

• 发车即存档。 每次离开维修室，模组悄悄写一份检查点：车修好了、东西买完了、道具在身上。
• 团灭回到那个点。 关卡、花剩下的钱、背包里的道具、储藏箱、电车升级、商店折扣一起还原。
• 原版则回第一关，钱归初始值，车还得重新修。
• 单人和联机都能用。 联机只需要主机安装。

存档点为什么选在发车

一局分三段：维修室 → 发车 → 地牢。游戏自己也会存一次，但那是在你刚走进维修室的时候 —— 还没买东西，车也还没修。

所以检查点定在唯一说得通的时刻：东西买完、车修好、钱已经花掉的那一秒。

配置

会失去什么

害死你们那趟里捡到的东西不在检查点里 —— 存档是在发车时写的，那之后捡的当然没有。

一局里第一次发车之前就团灭：此时还没有检查点，模组会退回游戏自带的存档。钱和道具都在，但车要重修、东西要重买。

死斗照常打。 团灭后仍然要过完死斗那一轮才回维修室。跳过它得改房间的交接流程，不在这个模组的范围内。

几个细节

• 道具会摆回维修室地上，不直接塞进背包。只有这样耐久、弹量这些细节才保得住 —— 游戏另有一条"直接发到手"的捷径，但它只能带物品 ID。
• 正常通关不会走这套逻辑。 打通地牢走的是另一条路，不会被误伤。
• 检查点文件是存档目录里的 MMGameData01C.sav（每个存档槽一份）。每次发车覆盖，永远只留最近一份，游戏的存档列表里看不到它。删掉它，模组就退回用游戏自带存档。
• 你的自动存档不受影响。 模组借游戏的存档函数写一次，然后把原文件原样放回去，"继续游戏"和没装模组时一模一样。

安装

用模组管理器（推荐）。 r2modman 或 Gale 直接装，MelonLoader 会一起带上。

手动装。 装 MelonLoader 0.7.3，把 BetterCheckpoint.dll 放进 MIMESIS/Mods/，跑一次游戏。

怎么改配置

• 游戏内：主菜单的「模组」按钮（需要 BetterModMenu），或按 F9，分类「检查点」。
• 改文件：UserData/MelonPreferences.cfg 的 [BetterCheckpoint] 段。

联机

只装主机。 存档和还原都是主机端的动作。客人什么都不用装，只会跟着主机回到之前的关卡。

排查

打开「详细日志」后：

[检查点] 发车前已存档：关卡 4，钱 320，道具 12 件
[检查点] 完整回档（发车前存档）：关卡 4 → 4（钱 320，道具 12 件，天 0）

第一条每次发车都有。第二条是团灭回档，括号里注明数据来源 —— 显示「维修室存档」说明检查点文件没写成，走的是兜底。

兜底原因也会打印：发车前存档失败：… / 读不到检查点存档 / 完整回档失败。如果看到 找不到 ... 或 反射失败，是游戏改了相关逻辑，模组需要更新。

Changelog

1.3.1

• Rewrote the description page in the layout people actually read here: what it does, who has to install it, a quick start, then the settings. No code left.

1.3.0

Published as BetterCheckpoint (the mod was previously uploaded as Checkpoint; same code, new name).

• The checkpoint moved to the moment of departure. It used to restore the game's own auto-save, which is written when you first enter the maintenance room — before you shop and before the tram is repaired, so you had to buy and repair all over again. Now the checkpoint is taken the second you depart: tram fixed, shopping done, money already spent, items in your pockets.
• The save is taken with the game's own routine, so it captures floor items, every player's carried items, the stash, tram upgrades, shop prices and market stock, growth levels and the session report in one go.
• Checkpoints go to their own file (MMGameData01C.sav per slot). The normal auto-save is put back exactly as it was, so "Continue" behaves like vanilla.
• If the checkpoint file is missing, it falls back to the auto-save.

1.2.0

• Added full restore: money, items, stash, tram upgrades and shop prices come back, not just the stage number.
• Fixed a room-state desync that left the shop visible but unusable and the depart button unresponsive.
• Settings trimmed to five entries; the old "restore from auto-save" switch was folded into full restore.

1.1.0

• Added an experimental "restore from auto-save" option that read the maintenance room's auto-save.
• The first wipe of a session now always prints one line to the log, so you can confirm the patch fired.

1.0.0

• First release: snapshot before the session is torn down, then write the stage number back afterwards, so a wipe no longer drops the run to stage 1.