HowToFish Comprehensive Optimization

HowToFish 綜合性能優化

模組名稱（中文）：HowToFish 綜合性能優化

Mod Name (English)：HowToFish Comprehensive Performance Optimization

當前版本（Version）：v1.5.4

說明：本文件上半部分爲中文說明，下方另附完整英文版說明。

Note: This document has a Chinese version (below the header) followed by a full English version at the bottom.

一、簡介

該模組是《How to Fish》的純性能優化插件。不修改任何遊戲文件、不接觸原版模組、不影響掉落物與存檔、不改變畫質，通過幾項相互獨立的優化提升運行流暢度，尤其針對「跨島卡頓」與「首次使用卡頓」。

二、功能特性

| 功能 | 作用 |

|------|------|

| JIT 預熱 | 啓動時預編譯所有模組方法（只編譯、不執行），消除每個模組首次使用時的卡頓；自動覆蓋之後新裝的模組 |

| 日誌削減 | 關閉每幀日誌的棧生成，降低 GC 頻率與 CPU 佔用 |

| 溫和垃圾清理 | 定期吸收臨時內存垃圾，平滑 GC 停頓，讓遊戲更流暢 |

| 島嶼早加載 | 加大跨島觸發距離，靠岸前提前流式加載新島，減輕跨島卡頓 |

三、安裝

• 打開遊戲目錄...\How to Fish\How to Fish\BepInEx\plugins
• 將 HowToFish.ComprehensivePerformanceOptimization.dll 放入其中
• 啓動遊戲，模組自動加載

環境要求：BepInEx 5，遊戲運行於 D3D12。

四、配置文件

文件路徑：BepInEx\config\HowToFish.ComprehensivePerformanceOptimization.cfg

| 節點 | 選項 | 默認 | 說明 |

|------|------|:---:|------|

| Logging | ReduceLogSpam | true | 削減每幀日誌棧生成 |

| GC | IdleCollect | true | 溫和垃圾清理 |

| GC | CollectIntervalSeconds | 20 | 清理間隔（秒） |

| Warmup | EnableJitWarmup | true | JIT 預熱 |

| IslandEarlyLoad | EnableEarlyLoadRange | true | 島嶼早加載 |

| IslandEarlyLoad | RangeMultiplier | 2.0 | 觸發距離放大倍數 |

所有選項均可獨立開關，改完重啓生效。

五、注意事項

• 該模組不刪除掉落物、不清理存檔、不影響任何持久數據。「垃圾清理/GC」只回收程序臨時內存。
• 島嶼早加載改變了島嶼觸發行爲，屬實驗性；如有異常可將 EnableEarlyLoadRange 設爲 false 還原。
• 低風險、可一鍵還原。

六、兼容與日誌

• 啓動日誌 LogOutput.log 會輸出 Optimize: loaded，開啓的優化各有對應條目。
• 兼容其他所有插件，不修改原版 ArceDev.FishEffects.dll 等。

HowToFish Comprehensive Performance Optimization

English version (full documentation).

• Overview

This is a pure-performance plugin for "How to Fish". It does not modify any game files, does not touch vanilla mods, does not affect loot or saves, and does not change visual quality. It improves smoothness through several independent optimizations, especially targeting island-crossing stutter and first-use hitch.

• Features

| Feature | What it does |

|---------|-------------|

| JIT Warmup | Precompiles every installed mod's methods at startup (compile-only, never run) to remove first-use stutter. Automatically covers mods added later. |

| Log Trim | Strips per-frame stack-trace population to cut GC rate and CPU usage. |

| Gentle GC | Periodically drains garbage at low pressure to smooth out GC pauses. |

| Island Early-Load | Enlarges the island load trigger distance so the next island streams earlier, reducing crossing stutter. |

• Installation

• Open the game folder...\How to Fish\How to Fish\BepInEx\plugins
• Copy HowToFish.ComprehensivePerformanceOptimization.dll into it
• Launch the game; the mod loads automatically

Requirements: BepInEx 5, game running on D3D12.

• Configuration

File: BepInEx\config\HowToFish.ComprehensivePerformanceOptimization.cfg

| Section | Key | Default | Description |

|---------|-----|:---:|-------------|

| Logging | ReduceLogSpam | true | Cut per-frame stack-trace population |

| GC | IdleCollect | true | Gentle garbage collection |

| GC | CollectIntervalSeconds | 20 | Collect interval in seconds |

| Warmup | EnableJitWarmup | true | JIT warmup |

| IslandEarlyLoad | EnableEarlyLoadRange | true | Island early-load range |

| IslandEarlyLoad | RangeMultiplier | 2.0 | Range multiplier |

All options are independent and take effect after restart.

• Notes

• This mod never removes loot, never cleans saves, and never affects persistent data. "GC" only reclaims transient memory.
• Island early-load changes island trigger behaviour (experimental). Set EnableEarlyLoadRange=false to restore defaults if needed.
• Low risk and fully revertible.
• Compatibility & Logs

• On startup, LogOutput.log prints Optimize: loaded, with one entry per enabled optimization.
• Compatible with all other mods; it does not modify vanilla DLLs such as ArceDev.FishEffects.dll.