HTF MoreHead

HTF MoreHead

中文 · English

HTF MoreHead is a BepInEx cosmetic framework for How to Fish. Content creators build independent.htfhhh AssetBundles with the Unity SDK; players select them through the game's original Hat, Accessory, and Outfit arrows.

Current release: 0.6.1, network protocol 3, tested against How to Fish 1.0.11.

中文說明

功能

• 支持三個原生外觀分類：帽子 Hat、配飾 Accessory、衣服 Outfit。
• 自定義物品直接接入各分類的原版左右箭頭，不修改原版 SkinManager 列表。
• 遞歸掃描 BepInEx/plugins/**/*.htfhhh；一個裝扮包就是一個文件。
• 遊戲內顯示彩色的 {Display Name} By {Author Name}。
• 三個槽位分別本地持久化，重新啓動遊戲後恢復。
• 基於 FishNet Broadcast 的 Host 權威同步，支持換裝增量、斷線清理與晚加入快照。
• 聯機僅傳穩定物品 ID，不傳模型。缺少內容包不會斷線，只在該客戶端隱藏對應裝扮。
• 0.6.1 使用網絡協議 3，所有聯機成員必須使用相同 Core 版本。

玩家安裝

• 安裝 BepInEx 5.4.23.5。
• 下載 Release，將 HTFMoreHead.dll 放入：

How to Fish/BepInEx/plugins/HTFMoreHead/

• 將任意.htfhhh 放在 BepInEx/plugins/ 的任意子目錄，例如：

How to Fish/BepInEx/plugins/HTFMoreHead/Content/豬豬眼罩.htfhhh

• 完整重啓遊戲，進入角色自定義界面。
• 打開對應的帽子、配飾或衣服頁面，繼續使用原版 `` 按鈕。越過原版列表邊界後會進入該分類的自定義物品。
• 點擊原版“返回”保存。選擇記錄寫入：

BepInEx/config/HTFMoreHead/loadout.json

內容作者 SDK

不再使用.unitypackage。請在 Unity Package Manager 選擇 Install package from git URL... 並粘貼：

完整的中英文製作教程、三個分類的準確掛點和構建限制見 HTF MoreHead SDK。Builder 會自動生成聯機/存檔所需的穩定內部 ID，並且每次只輸出一個 {DisplayName}.htfhhh 文件。

三分類工作方式

| 自定義分類 | SDK 校對掛點 | 遊戲內選擇頁 | 遠端運行時掛點 |

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

| Hat | Armature/Body/Head/HTFMoreHead_HeadAnchor | 帽子 | Player.Body.Head |

| Accessory | 參考角色根節點 Accessory | 配飾 | 原版 Accessory renderer Transform |

| Outfit | 參考角色根節點 Outfit | 衣服/外觀 | 原版 Outfit renderer Transform |

當前三個分類都使用剛性 MeshFilter + MeshRenderer 裝扮。需要隨骨骼變形的衣服和長髮仍需後續增加 SkinnedMeshRenderer 骨骼重定向，不能直接用本版 Builder 打包。

聯機說明

• 所有玩家必須安裝同一協議版本的 Core；0.6.1 不與協議 2 混用。
• 內容包可以不同。沒有某件.htfhhh 的客戶端不會顯示它，但仍可正常遊戲。
• Host 從 FishNet 的真實連接確定玩家身份，維護 Hat/Accessory/Outfit 三槽快照。
• 第一次進入和晚加入都會請求完整 Snapshot；換裝使用 Reliable 增量消息。
• 自定義模型只實例化爲本地純視覺對象，不註冊 NetworkObject，不修改遊戲 DLL。

從源碼構建

工程目標爲 netstandard2.1，引用當前遊戲、FishNet、BepInEx、Harmony 和 Unity Managed DLL；宿主引用全部爲 Private=false。

dotnet build.\HTFMoreHead.csproj -c Release --nologo `

-p:GameRoot='D:\SteamLibrary\steamapps\common\How to Fish\How to Fish'

輸出：

bin/Release/netstandard2.1/HTFMoreHead.dll

當前限制

• 本機第一人稱不在攝像機前掛載頭部裝扮；本機外觀通過角色自定義預覽顯示。
• 屍體和結算畫面的獨立角色目前不會複製自定義裝扮。
• 當前僅支持剛性模型，不支持蒙皮骨骼重定向。
• 遊戲更新後如果 Hook 或運行時指紋改變，應先通過日誌重新驗證兼容性。

特別鳴謝與授權

本項目在獲得 Masaicker 明確許可的前提下，參考了其 R.E.P.O. Mod「MoreHead」的架構與開發思路。感謝 Masaicker 的授權、開源貢獻以及對 Mod 社區的幫助。

• 原版作者：Masaicker
• 原版倉庫：Masaicker/repo-MoreHead
• 原倉庫源碼許可證：MIT License
• 原倉庫資源說明：ASSET_LICENSE.txt

上述鳴謝和授權記錄不替代原倉庫許可證。若複用其 MIT 源碼，應繼續保留相應版權與許可文本。

English

Features

• Integrates custom Hat, Accessory, and Outfit items with the matching native arrow selectors.
• Recursively loads single-file.htfhhh packages from BepInEx/plugins.
• Displays {Display Name} By {Author Name} in the customization preview.
• Persists all three custom slots across restarts.
• Uses a host-authoritative FishNet Broadcast protocol with reliable deltas, disconnect cleanup, and late-join snapshots.
• Synchronizes stable cosmetic IDs only. Missing local packages are tolerated.

Player installation

• Install BepInEx 5.4.23.5.
• Put HTFMoreHead.dll in BepInEx/plugins/HTFMoreHead.
• Put.htfhhh files anywhere below BepInEx/plugins.
• Restart the game. In character customization, use the original arrows on the matching Hat, Accessory, or Outfit tab.
• Use the game's Back button to save the current custom loadout.

Every multiplayer participant must use the same Core protocol. Content packages may differ; a missing package only hides that item on the affected client.

Creator SDK

Install the SDK from Unity Package Manager with:

See HTF MoreHead SDK for the bilingual step-by-step tutorial. The builder automatically creates stable internal IDs, bakes anchor-relative transforms, and outputs exactly one {DisplayName}.htfhhh file.

Build from source

dotnet build.\HTFMoreHead.csproj -c Releas