稀有生物 - 稀有鱼类颜色变体

[size=5][b]稀有生物[/b][/size]
发现三种熟悉的海底迷航鱼类的罕见颜色变体：金孔雀鱼、蔚蓝雷金纳德鱼和玫瑰铲鱼。

这些变体使用原版鱼的模型、数值和动画。它们通过 Nautilus 注册为额外生物；普通鱼的生成条目不会被替换。

[size=4][b]发布状态 — 1.0.0[/b][/size]
初版发布，适用于 Windows 上的原版《海底迷航》，需要 BepInEx 5 和 Nautilus。该 DLL 是针对经过检查的本地游戏安装编译的。[b]实际游戏验证尚待进行。[/b]自动化策略测试被 Windows 应用程序控制阻止，因此未报告为通过。颜色外观、自然生成、物品栏/收容以及保存/加载仍需游戏内验证。请使用已备份的测试存档。

[size=4][b]三种稀有变体[/b][/size]
[list]
[][b]金孔雀鱼[/b] — 安全浅滩开阔浅水区域和稀疏的海藻森林草地。[/]
[][b]蔚蓝雷金纳德鱼[/b] — 草甸平原开阔深水区域和草地。[/]
[][b]玫瑰铲鱼[/b] — 草甸平原开阔浅水区域和蘑菇森林草地。[/]
[/list]该模组会为每个变体实例上兼容的渲染器应用颜色着色。共享材质会被保留。没有所需颜色属性的粒子渲染器和着色器会被跳过。不包含新的 3D 模型或作者制作的纹理文件。

[size=4][b]前置要求[/b][/size]
[list]
[][url=https://www.nexusmods.com/subnautica/mods/1108]Tobey's BepInEx Pack for Subnautica[/url] — BepInEx 5 及其捆绑的 Harmony 库。本地编译参考版本为 BepInEx 5.4.23.5。[/]
[][url=https://www.nexusmods.com/subnautica/mods/1262]Nautilus[/url] — 需单独安装。此版本是针对 1.0.0-pre.54 编译的。[/]
[/list]依赖项和游戏程序集不随包提供。不需要其他 PulseModdingSubnautica 模组。

[size=4][b]安装[/b][/size]
[list=1]
[]为原版《海底迷航》安装所需的 BepInEx 5 包和 Nautilus。[/]
[]备份存档，然后将 RareCreatures-1.0.0.zip 解压到《海底迷航》游戏文件夹中，保留 BepInEx/plugins/RareCreatures/ 目录结构。[/]
[]启动游戏，检查 BepInEx/LogOutput.log 中是否有 Rare Creatures 1.0.0 初始化条目以及任何错误。[/]
[]编辑配置前先退出游戏，然后重新启动。[/]
[/list]只安装一份 RareCreatures.dll。该 ZIP 包含插件及其文档；它不会运行安装脚本。

[size=4][b]配置[/b][/size]
文件：[b]BepInEx/config/com.p3lse.subnautica.rarecreatures.cfg[/b]
[code][General]
Enabled = true

[Diagnostics]
VerboseLogging = false

[Variants]
SpawnWeight = 0.008
Species = Peeper,Reginald,Spadefish[/code][b]SpawnWeight[/b] 是额外的原生生成槽位权重，限制在 0–0.05。它不是所有鱼类的保证百分比。[b]Species[/b] 接受上面显示的受支持源 ID；未知 ID 不会添加新物种。更改后请重启。变体名称和配置描述为英文；没有额外的设置菜单或自定义快捷键。

[size=4][b]兼容性与限制[/b][/size]
编译目标：原版《海底迷航》，Steam 构建 20241558 / Unity 2019.4.36.870。这仅记录构建目标，并不代表实际游戏中的兼容性。Below Zero、Legacy/QModManager、BepInEx 6 以及多人/Nitrox 未作为目标，也未经过测试。

颜色可见性取决于原生着色器、纹理和光照。现有世界区块不会通过扫描重新填充。自定义烹饪、扫描、卵和百科条目未注册。与其他生物模组的共存尚未验证。

[size=4][b]存档文件和移除[/b][/size]
这些变体使用自定义保存的预制体标识。[b]当存档包含这些变体时，包括在物品栏或收容设施中，请保持 DLL 处于安装状态。[/b]移除它可能会导致缺失的自定义实体。请备份存档并在副本上测试移除。设置 Enabled=false 并重启可阻止额外的自然生成条目，同时保留预制体注册。尚未实现将已保存的变体自动转换回普通鱼。

[size=4][b]故障排除与验证[/b][/size]
压缩包包含 README.md、配置示例、构建证据和 Docs/VALIDATION.md。若要在测试存档上进行可复现的视觉检查，文档中记录的控制台命令为：
[code]spawn RareCreaturesPeeper
spawn RareCreaturesReginald
spawn RareCreaturesSpadefish[/code]如需报告问题，请包含游戏、BepInEx 和 Nautilus 版本、相关日志错误以及复现步骤。分享日志前请检查其中是否有隐私信息。

[size=4][b]致谢[/b][/size]
模组：PulseModdingSubnautica。原始鱼类模型、动画和游戏资源：Unknown Worlds Entertainment。模组框架和库：BepInEx、Harmony 和 Nautilus 贡献者。原始游戏资源引用自已安装的游戏，未在此压缩包中重新分发。

[size=4][b]版本 1.0.0[/b][/size]
初始独立实现：三种颜色变体、可配置物种和生成权重、单独的 BepInEx 配置、诊断日志记录和打包文档。包含编译证据；实际游戏发布测试仍有待完成。