IcarusModelReplacement

Icarus Model Replacement

中文看我

將伊卡洛斯的外觀替換爲咕嘎。模型隨 Mod 提供，默認啓用，進入存檔即可使用。也支持自定義模型，換模型不需要重新編譯 DLL。

配置項

首次啓動後會生成 BepInEx/config/org.fyyy.icarusmodelreplacement.cfg。只使用內置咕嘎時，無需修改配置。

[Model] 下的 Directory 決定使用哪個模型：

| 值 | 效果 |

|---|---|

| builtin（默認） | 使用內置咕嘎 |

| 模型文件夾路徑 | 使用自定義模型；支持相對 BepInEx/plugins/ 的路徑或絕對路徑 |

| 留空 | 恢復原版伊卡洛斯 |

編輯配置文件後重啓遊戲生效。使用配置管理器修改這一項，可以直接在遊戲中切換。升級會保留已有配置。

功能與限制

角色跟隨伊卡洛斯行走、懸浮和飛行，只替換外觀，不修改碰撞、存檔或戰鬥邏輯。機甲編輯器保留原有功能，噴焰、護盾和武器特效仍使用伊卡洛斯的骨骼位置。

模型加載失敗時會記錄日誌並保留伊卡洛斯，切換模型或重新讀檔後重試。停用插件、清空選擇或退出存檔時會恢復原模型。

內置模型沒有專用的表情、採礦或戰鬥動畫。自定義模型支持一個網格、一張 PNG 圖集、一個材質和最多 256 根骨骼，每頂點最多四項權重。骨骼和動作由模型文件定義，製作方法見 MODEL_FORMAT.md。

模型來源

咕嘎原作爲 ReedMan 的 Cute Gugugaga，採用 CC BY 4.0 許可。

README

Replaces Icarus with Cute Gugugaga. The model is included and enabled by default when you load a save. Custom models are also supported, with no DLL rebuild needed to switch characters.

Configuration

The first launch creates BepInEx/config/org.fyyy.icarusmodelreplacement.cfg. You can leave it unchanged to use the included Gugugaga.

Directory in the [Model] section selects the model:

| Value | Effect |

|---|---|

| builtin (default) | Use the included Gugugaga |

| Model folder path | Use a custom model, with a path relative to BepInEx/plugins/ or an absolute path |

| Empty | Restore the original Icarus |

Restart the game after editing the file. Changes made through a configuration manager apply in game. Updates preserve your existing configuration.

Features and limits

The character follows Icarus while walking, hovering and flying. The mod changes appearance without modifying collision, save data or combat logic. The mecha editor keeps its existing functions; thrusters, shields and weapon effects still use Icarus's bone positions.

If a model fails to load, the mod logs the error and keeps Icarus visible. Changing the selection or reloading the save retries loading. Disabling the plugin, clearing the selection or leaving the save restores the original model.

The included model has no dedicated facial, mining or combat animations. Custom models support one mesh, one PNG atlas, one material and up to 256 bones, with at most four weights per vertex. Model files define the skeleton and motion. See MODEL_FORMAT.md for the export format.

Model credits

The original model is Cute Gugugaga by ReedMan, licensed under CC BY 4.0.