SaveGuard

版本 v0.1.4·更新於 2026-08-02

溫和的失敗處理:撤離失敗物品默認回收 | 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

安裝與使用 安裝:按包內說明操作

  1. 解壓本站下載的壓縮包,先讀包內的 readme / 說明檔案。
  2. 多數模組依賴遊戲的模組載入器:常見做法是用社群模組管理器(如 r2modman)選中本遊戲安裝,由管理器自動處理載入器與依賴。
  3. 手動安裝時,把模組檔案放進遊戲目錄下對應的 Mod / plugins 資料夾。
  4. 啟動遊戲確認載入成功;帶「前置依賴」的模組需要把依賴一併安裝。

不同模組的安裝位置差異較大,包內說明是最可靠的依據。

前置依賴

下面這些內容需要先安裝,否則該模組不會生效:

BepInEx-BepInExPack

檔案與校驗

檔案名稱
SaveGuard-0.1.4.zip
檔案大小
130.1 KiB