LossyCompression

Lossy Compression (有損壓縮)

Compress belt & cargo data (-80%), dyson shells (-85%), and solar sails to drastically reduce save file size and improve I/O performance.

Includes Lazy Loading and Multi-threading to optimize RAM usage and loading speed.

提供傳送帶(-80%), 戴森殼(-85%)及太陽帆的存檔數據壓縮。在性能測試面板可以啓用/停用壓縮。

遊戲改版之前建議另存原檔避免mod失效。若遊戲改版後有無法正常讀取的壓縮存檔, 請先回滾遊戲版本再儲存成未壓縮(原版)存檔。

[!WARNING]

BACKUP YOUR SAVE BEFORE USE! / 使用前務必備份存檔！

While Dyson Shell/Swarm compression is safe (stored externally), enabling CargoPath (Belt) compression modifies the internal save structure.

Saves created with CargoPath compression CANNOT be loaded without this mod.

戴森殼/太陽帆壓縮是安全的（外部存儲），但啓用 CargoPath (傳送帶) 壓縮 會修改存檔內部結構。

啓用了傳送帶壓縮的存檔，必須安裝本 Mod 才能讀取，否則存檔將損壞。

Configuration (設置)

Run the game once to generate BepInEx\config\starfi5h.plugin.LossyCompression.cfg.

✅ Safe: Independent Data (安全功能：獨立數據)

• DysonShell (Default: true)
• Effect: Lossless compression (blueprint only). Geometry is rebuilt on load using CPU multithreading.
• Storage: Data saved in a separate.moddsv file.
• Safety: If mod is removed, the save loads fine, but all Dyson Shells will vanish.
• 效果: 無損壓縮戴森殼（僅保存藍圖）。載入時利用 CPU 重建模型。
• 機制: 數據存在獨立的.moddsv 文件中。若移除 Mod，存檔可讀取，但戴森殼會消失。

• DysonSwarm (Default: true)
• Effect: Lossy compression (statistical distribution). Exact positions are not saved.
• Side Effect: Sails are "regenerated" on load. Their positions will be randomized/reset each time.
• Safety: Same as above. If removed, all Solar Sails will vanish.
• 效果: 有損壓縮太陽帆（保存統計分佈）。不保存精確位置。
• 副作用: 每次讀檔時太陽帆位置會重置/隨機生成。
• 機制: 若移除 Mod，存檔可讀取，但太陽帆會消失。

⚠️ Risk: Save Dependency (風險功能：存檔依賴)

• CargoPath (Default: false)
• Effect: Lossy compression for belts/cargo. Positions/rotations are slightly simplified.
• Risk: PERMANENT DEPENDENCY. The compressed data is written directly into the main save file. If you uninstall the mod, the save will break unless you disable this option and re-save first.
• 效果: 有損壓縮傳送帶數據。位置和方向會些微簡化。
• 風險: 永久依賴。數據直接寫入主存檔。啓用後，存檔必須依賴此 Mod 才能開啓。

⚡ Performance & RAM (性能與內存)

• MultiThreading (Default: true)
• Effect: Uses multiple CPU threads to rebuild Shells (4x faster loading).
• Trade-off: Significantly higher RAM usage during the loading screen.
• 效果: 啓用多線程加速模型重建 (載入速度 4x)。代價是載入時內存 (RAM) 佔用峯值更高。

• LazyLoad (Default: true)
• Effect: Only generates shell models when you are viewing them or opening the editor.
• Benefit: Massively reduces RAM usage for stars you are not currently looking at.
• 效果: 延遲載入。只有在看見戴森球或打開面板時才生成模型。大幅降低閒置星系的內存佔用。

• ReduceRAM (Default: false)
• Effect: Aggressively deletes shell models from RAM immediately after saving.
• Trade-off: Lowest RAM usage, but causes CPU lag spikes during auto-save (needs to regenerate vanilla data) and requires rebuilding models when viewing the sphere again.
• 效果: 存檔後立即從內存刪除模型。極致省內存，但會導致存檔時卡頓（需臨時生成原版數據），且再次查看時需重新生成。

In-Game Controls (遊戲內控制)

• Performance Panel: A toggle button Compress - ON/OFF is added to the performance test panel.
• Usage: You can switch compression modes dynamically. The setting applies to the next save operation.
• 性能面板: 性能測試面板中新增 Compress - ON/OFF 按鈕。
• 用法: 可實時切換。設置將應用於下一次存檔操作。

Uninstall Guide (卸載指南)

• If CargoPath is OFF (Default):
• Safe to remove directly. Note: Shells/Sails in.moddsv will be lost.
• 若未啓用傳送帶壓縮：直接刪除即可。注意：儲存在.moddsv 中的殼/帆會消失。

• If CargoPath is ON:
• DO NOT DELETE MOD YET.
• Load game -> Disable compression in config/UI -> Save Game.
• Now it is safe to remove the mod.
• 若已啓用傳送帶壓縮：切勿直接刪除。
• 進遊戲 -> 關閉壓縮功能 -> 保存遊戲（轉回原版格式） -> 然後再刪除 Mod。

Compatibility (兼容性)

• (✅) NebulaMultiplayer: Supported. Syncs compressed data to clients, reducing network lag. (支持聯機，大幅減少數據傳輸量)
• (✅) DSPOptimizations
• (✅) CompressSave
• (⚠️) SphereOpt: Will automatically disable LazyLoad to avoid conflict. (會自動關閉延遲載入以避免衝突)

Acknowledgements

All trademarks, copyright, and resources related to Dyson Sphere Project itself, remain the property of Gamera Game and Youthcat Studio as applicable according to t