BoatSailSaveFix
Fixes a vanilla bug where custom boat sails are not written to the save file when masts are inactive in the hierarchy. Affects owned boats left behind while sailing another vessel.
模組介紹 作者原文
Boat Sail Save Fix
Fixes a vanilla Sailwind bug that drops custom sails from owned boats left in the world when you sail on another vessel (anchored, moored, or at port).
Affects boats with modular parts and multiple mast configurations (often reported on the sanbuq).
The bug
On save (manual save, autosave, sleep), SaveableBoatCustomization.GetData() only serializes sails on masts where gameObject.activeInHierarchy is true. Inactive masts can still hold sails in memory. The save file then stores an empty or incomplete sail list. After reload, those boats spawn without sails.
Leaving and returning in the same session without saving does not trigger this code path; the problem appears after autosave (default: every 15 minutes) and the next load.
What this mod does
- On save — also writes sails from inactive masts (same data the game should have saved).
- On load — keeps an in-session cache per boat sceneIndex. If a save file already has zero sails, restores the last known good rig from cache (safety net only).
Install
- Install BepInEx for Sailwind.
- Extract this folder into BepInEx/plugins.
- Launch the game. Check BepInEx/LogOutput.log for: Boat Sail Save Fix 1.0.0 loaded.
Already corrupted saves
This mod prevents new data loss. It does not edit save files on disk. For a save that already has no sails stored, either:
- Load once after restoring sails with a save editor / patch tool, then play with this mod enabled, or
- Load a backup from before the bug occurred.
After one successful load with sails present, the session cache can cover empty entries until you fix the file.
Compatibility
- BepInEx 5.4+
- Tested on game versions 0.38
- No config file required
Uninstall
Delete the BoatSailSaveFix folder from BepInEx/plugins.
Building from source
From the repository root:
dotnet build -c Release -p:SailwindDir="C:/Program Files (x86)/Steam/steamapps/common/Sailwind"
Copy bin/Release/netstandard2.0/BoatSailSaveFix.dll into BepInEx/plugins/BoatSailSaveFix.
- Ensure icon.png (256×256) is at the repository root.
2..\build-.ps1
- Upload g1llez-BoatSailSaveFix-1.0.0.zip (community: Sailwind).
Links
- Source: github.com/g1llez/sailwind-boatsailsavefix
License
MIT — fix upstream in Sailwind is welcome; this mod can be retired when the vanilla bug is patched.
安裝與使用 安裝：按包內說明操作
- 解壓本站下載的壓縮包，先讀包內的 readme / 說明檔案。
- 多數模組依賴遊戲的模組載入器：常見做法是用社群模組管理器（如 r2modman）選中本遊戲安裝，由管理器自動處理載入器與依賴。
- 手動安裝時，把模組檔案放進遊戲目錄下對應的 Mod / plugins 資料夾。
- 啟動遊戲確認載入成功；帶「前置依賴」的模組需要把依賴一併安裝。
不同模組的安裝位置差異較大，包內說明是最可靠的依據。
下面這些內容需要先安裝，否則該模組不會生效：