SaveGuard
溫和的失敗處理:撤離失敗物品默認回收 | Quota 失敗保檔不刪檔 | 安全備份 | 遊戲內設置頁。A gentle failure handler for YAPYAP.
模組介紹 作者原文
存檔守護 (SaveGuard)
中文 / Chinese (click to expand English)
爲 YAPYAP 提供溫和的失敗處理——撤離失敗物品回收,三夜任務失敗不刪檔
功能
撤離失敗物品回收
- 保留原版"先從玩家身上掉落到世界"的行爲
- 默認將所有符合條件的掉落物都進行回收,可以在回收處拿到
- 回收率可在遊戲內設置頁選擇:0% 25% 50% 75% 100%
- 尊重原版物品黑名單、物品狀態和網絡生成規則
任務失敗保檔
三夜任務沒能打滿分數時:
保留 存檔槽 · 金幣 · 庫存 · 裝備 · Hub 物品 · 地下室鑰匙 · Grimoire 進度 · 任務層數和目標 · 總回合數
重置 Session 分數 → 0,從第 1 夜重新挑戰同一層任務
- 成功達成任務時保持原版流程
- 保留完整 Game Over 動畫、界面和 Host 重建,僅跳過失敗流程中的存檔槽刪除
- 不會觸發 FrogDataLib 等模組的刪檔邏輯
遊戲內設置
進入 Settings → 存檔守護 / SaveGuard 頁籤:
| 設置項 | 類型 | 默認值 | 可選值 |
|---|:---:|---:|---|
| 任務失敗存檔 | 開關 | 開 | |
| 物品回收率 | 下拉 | 100% | 0% 25% 50% 75% 100% |
界面使用遊戲原生控件風格,配置保存在 BepInEx 配置文件中,不覆蓋原版設置
安裝
推薦:通過 Mod Manager / r2modman 安裝
手動安裝:
- 安裝 BepInEx 5
- 將 SaveGuard.dll 放入 BepInEx/plugins/SaveGuard/
- 啓動遊戲
配置文件路徑:BepInEx/config/com.saveguard.yapyap.cfg
聯機說明
Host 必須安裝,客戶端可以不裝
配置文件
[Quota Failure]
ProtectSave = true
[Recovery]
RecoveryPercent = 100
[Safety]
CreateEmergencyBackup = true
MaxEmergencyBackups = 5
[Compatibility]
EnforceBuildGuard = true
[General]
DebugLog = false
已知限制
- 黑名單物品不會進入回收列表
- 回收時非空閒狀態的物品可能無法搬回大廳
- 大廳物品受原版持久化規則和數量上限約束
- 遊戲 UI 大更新後設置頁可能需要適配
致謝
BepInEx · Harmony · · YapYap Graphics Enhancer
English (click to expand)
A gentle safety net for YAPYAP — recover dropped items after a failed extraction, keep your progress when you miss quota
Features
Failed Extraction Item Recovery
- Preserves the vanilla "items drop to the ground first" flow
- All eligible dropped items are recovered by default — grab them at the recovery point
- Recovery rate adjustable in-game: 0% 25% 50% 75% 100%
- Respects vanilla item blacklists, prop states, and network spawning rules
Quota Failure Protection
If you fall short of the quota after three nights:
Preserved Save slot · Gold · Inventory · Equipment · Hub props · Basement key · Grimoire progress · Quota tier & goal · Total rounds played
Reset Session score → 0, restart from Night 1 on the same quota tier
- Meeting the quota works exactly as in vanilla
- The full Game Over sequence plays normally — only the save-slot deletion is skipped
- Won't interfere with FrogDataLib or other mods that hook DeleteSlot
In-Game Settings
Open Settings → 存檔守護 / SaveGuard tab:
| Setting | Type | Default | Options |
|---|:---:|---:|---|
| Keep save after mission failure | Toggle | On | |
| Item recovery rate | Dropdown | 100% | 0% 25% 50% 75% 100% |
Uses native-style UI controls. Stored in the BepInEx config — does not touch vanilla PlayerPrefs
Installation
Recommended: Install Mod Manager / r2modman
Manual:
- Install BepInEx 5
- Place SaveGuard.dll in BepInEx/plugins/SaveGuard/
- Launch the game
Config file: BepInEx/config/com.saveguard.yapyap.cfg
Multiplayer
Host must install; clients are optional
Configuration
[Quota Failure]
ProtectSave = true
[Recovery]
RecoveryPercent = 100
[Safety]
CreateEmergencyBackup = true
MaxEmergencyBackups = 5
[Compatibility]
EnforceBuildGuard = true
[General]
DebugLog = false
Known Limitations
- Blacklisted items are never eligible for recovery
- Props not in an idle state may fail to transfer back to the Lobby
- Lobby props are still subject to vanilla persistence rules and prop limits
- The in-game settings tab may need updates after major game UI changes
Credits
BepInEx · Harmony · · YapYap Graphics Enhancer
安裝與使用 安裝:按包內說明操作
- 解壓本站下載的壓縮包,先讀包內的 readme / 說明檔案。
- 多數模組依賴遊戲的模組載入器:常見做法是用社群模組管理器(如 r2modman)選中本遊戲安裝,由管理器自動處理載入器與依賴。
- 手動安裝時,把模組檔案放進遊戲目錄下對應的 Mod / plugins 資料夾。
- 啟動遊戲確認載入成功;帶「前置依賴」的模組需要把依賴一併安裝。
不同模組的安裝位置差異較大,包內說明是最可靠的依據。
下面這些內容需要先安裝,否則該模組不會生效: