LossyCompression

Lossy Compression (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.

Provides archive data compression for conveyor belts (-80%), Dyson shells (-85%) and solar sails. Compression can be enabled/disabled in the performance test panel.

Before the game is revised, it is recommended to save the original file to avoid mod failure. If there is a compressed archive that cannot be read normally after the game is revised, please roll back the game version first and then save it as an uncompressed (original) archive.

[!WARNING]

BACKUP YOUR SAVE BEFORE USE! / Be sure to back up 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.

Dyson shell/solar sail compression is safe (external storage), but enabling CargoPath (conveyor belt) compression will modify the archive internal structure.

Archives with conveyor belt compression enabled must be installed with this mod in order to be read, otherwise the archive will be corrupted.

Configuration

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

✅ Safe: Independent Data (security function: 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.
• Effect: Lossless compressed Dyson shell (only blueprints are saved). Utilizes the CPU to rebuild the model on load.
• Mechanism: Data is stored in separate .moddsv files. If you remove the Mod, the save can be read, but the Dyson shell will disappear.

• 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.
• Effect: lossy compression of the solar sail (preservation of statistical distribution). Precise location is not saved.
• Side effect: The solar sail position will be reset/randomly generated each time the file is loaded.
• Mechanism: If the Mod is removed, the save can be read, but the solar sail will disappear.

⚠️ Risk: Save Dependency (risk function: 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.
• Effect: Lossy compression of conveyor data. Position and orientation will be slightly simplified.
• Risk: Permanent dependence. Data is written directly to the main archive. When enabled, archiving must rely on this Mod to be enabled.

⚡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.
• Effect: Enable multi-threading to speed up model reconstruction (loading speed 4x). The trade-off is higher peak memory (RAM) usage during loading.

• 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.
• Effect: Lazy loading. The model is only generated when the Dyson Sphere is visible or the panel is open. Significantly reduces the memory usage of idle galaxies.

• ReduceRAM (Default: false)
• Effect: Aggressively deletes shell models from RAM …