IronyModManager 找不到 Stellaris 模组从日志到修复的完整排障路线图【免费下载链接】IronyModManagerMod Manager for Paradox Games. Official Discord: https://discord.gg/t9JmY8KFrV项目地址: https://gitcode.com/gh_mirrors/ir/IronyModManager模组订阅了一堆、游戏里也能正常加载可一打开 IronyModManagerStellaris 模组却像被集体请进了黑名单列表里空空如也——这种憋屈老玩家都懂。别急着卸载重装也别怀疑人生。这篇路线图按先定位、再动手修、后防复发三幕展开教你用日志和路径两把听诊器找到病根再对症下药把失踪的模组一个个带回家。先分诊你的模组属于哪种失踪动手之前先回答一个问题模组是怎么没的症状不同病根完全不同。一个都不显示多半是扫描路径或权限问题IMM 根本没找到模组目录只有个别模组消失多半是那个模组的描述文件descriptor.mod出了岔子模组在、本地化却乱码多半是文件编码不符合 Stellaris 的硬规矩冲突警告刷屏、文件缺胳膊少腿多个模组互相覆盖解析被卡住游戏一更新就集体失效版本不匹配或缓存信息过期。用下面这张文字决策图快速对号入座你的症状是什么 ├── 一个都看不到 ──────→ 查三条路径 日志里的 directory not found ├── 个别模组缺失 ──────→ 打开它的 descriptor.mod 核对身份字段 ├── 本地化乱码 ────────→ 检查 localisation 与 name_lists 的 BOM 编码 ├── 冲突警告刷屏 ──────→ 用冲突检测视图逐个做减法 └── 更新后集体失效 ────→ 先升级 IMM再考虑清缓存记住一句口诀先看日志再查路径最后才动手改文件。顺序一乱很容易越修越乱。第一幕 定位让日志和路径开口说话 日志是模组的黑匣子别让它吃灰IMM 每一条关键动作都会写进日志位置按平台区分Windows%APPDATA%\Irony Mod Manager\logs\Linux~/.config/Irony Mod Manager/logs/macOS~/Library/Application Support/Irony Mod Manager/logs/排查前先在设置 → 高级里把日志级别调到详细然后重启 IMM 并刷新一次模组列表让日志把刚才发生的事完整记下来。读日志时重点盯这几个关键词StellarisDefinitionInfoProviderStellaris 专属解析器跟它有关的报错基本指向编码或结构问题Encoding validation failed编码校验失败多半是 BOM 丢了GetInstalledModsAsync扫描模组的入口它附近的报错往往和路径有关Workshop directory not found工坊目录没找到路径配置错了。三条路径一条都不能错把模组想象成快递工坊是发件地模组目录是收货点游戏目录是仓库。三段地址任何一段写错包裹都到不了家。游戏目录Steam/steamapps/common/Stellaris/GOG 版在GOG Galaxy/Games/Stellaris/模组目录文档/Paradox Interactive/Stellaris/mod/工坊目录Steam/steamapps/workshop/content/281990/281990 是 Stellaris 在创意工坊的专属编号在 IMM 里点自动检测通常能一步到位失败了就手动填填完点刷新模组列表验证效果。案例一一行编码报错揪出乱码元凶一位玩家反映模组在列表里好好的但进游戏后本地化文本全变方块字。翻日志看到这样一行StellarisDefinitionInfoProvider: Encoding validation failed for localisation/english/mod_l_english.yml Expected UTF-8 BOM but found none分析Stellaris 对本地化文件有硬性要求——必须带 UTF-8 BOM 编码。这个文件是普通 UTF-8无 BOMIMM 解析时直接把它判了不合格。解决用 VS Code 或 Notepad 打开该文件把编码转为UTF-8 with BOM再保存重启 IMM 刷新乱码立刻消失。需要补 BOM 的不止localisation下的*.yml还有common/name_lists/*.txt——这两处是 Stellaris 编码要求的重灾区。案例二工坊目录找不到模组集体失联另一位玩家说 Steam 版模组一个都扫不出来日志里躺着这句话ModService: Workshop directory not found: /home/user/.steam/steam/steamapps/workshop/content/281990分析日志已经把答案写在脸上了——IMM 按默认路径去找工坊目录但这位玩家的 Steam 装在另一个磁盘/库上路径对不上号。解决打开 Steam右键 Stellaris → 属性 → 本地文件 → 浏览确认真实的工坊路径然后在 IMM 里手动填上刷新即可。第二幕 动手修不同症状不同药方 模组全军覆没先查路径与权限日志里没有明显报错、却一个模组都扫不到多半是路径或权限问题。确认三条路径真实存在、目录可读Linux 下用ls -la看权限是否为drwxr-xr-x然后重填路径再刷新。个别模组失踪给描述文件做身份核对每个模组的身份证就是descriptor.modIMM 靠它确认模组叫什么、从哪来、支持什么版本。一份合格的描述文件长这样name你的模组名称 pathmod/你的模组文件夹 tags{ Gameplay Balance } supported_version3.*最常见的坑是path 字段与实际文件夹名对不上——就像快递单地址写错IMM 顺着地址找过去却扑了个空。打开模组目录比对一下把 path 改成实际文件夹名即可。本地化乱码把 BOM 补回来再强调一次localisation/*.yml和common/name_lists/*.txt必须使用UTF-8 BOM。转换方法很直观VS Code 右下角点编码 → 通过编码重新打开 → 选 UTF-8 with BOMNotepad 则是编码 → 转为 UTF-8-BOM。文件多的时候也可以写个小脚本遍历目录批量补齐。冲突刷屏用冲突检测做减法当多个模组改同一个文件比如common/technology/下的科技定义IMM 会拉响冲突警报。这时打开冲突检测视图看清是谁和谁在打架逐个禁用试探直到找出肇事模组。模组不是越多越好——克制一点反而更稳。更新后集体失效先升版本再清缓存Stellaris 大版本更新后模组集体失效先确认 IMM 是否还是最新版——老版本对新游戏版本的支持往往滞后。升级之后仍不行就清一次缓存Windows清空%APPDATA%\Irony Mod Manager\cache\Linux/macOS清空~/.cache/Irony Mod Manager/清完重启 IMM 重新扫描过期信息被丢弃模组列表恢复干净。顺带一提如果模组结构本身不合规——比如localisation下直接堆 yml而不是按english/、simp_chinese/分语言子目录或者该用replace目录做文本覆盖却没用——也会被 IMM 打上警告标记。对照游戏目录里官方模组的结构整理一遍即可。第三幕 防复发三个让你少熬夜的习惯 修好了不算完把好习惯养起来才能一劳永逸。习惯一日志默认开详细。调高日志级别不会损失什么但下次出问题时你能立刻看到现场记录而不是对着黑屏瞎猜。习惯二新模组进门前先体检。三分钟检查三件事描述文件字段齐全、path 与实际文件夹一致、localisation 与 name_lists 带 BOM。三分钟换一个不熬夜的夜晚值。习惯三游戏更新前留退路。大版本更新前记录当前启用的模组列表、备份重要配置更新后若模组失效按升 IMM → 清缓存 → 逐个启用测试的顺序推进把问题挡在开玩之前。三句话带走遇事先看日志——Encoding validation failed、Workshop directory not found这类关键词会直接告诉你病根在哪三条路径 两个文件——游戏目录、模组目录、工坊目录必须对描述文件与本地化编码必须合规版本和缓存是隐藏变量——游戏一更新先升 IMM、再清缓存很多问题会自己痊愈。如果整套流程走完模组还是不肯露面别灰心——带上日志和复现步骤去项目仓库提交 issue把现场记录交给维护者也是在帮整个社区把 IMM 打磨得更顺手。收藏这份路线图吧。下次 Stellaris 模组再玩失踪照单抓药十分钟就能让它回家。【免费下载链接】IronyModManagerMod Manager for Paradox Games. Official Discord: https://discord.gg/t9JmY8KFrV项目地址: https://gitcode.com/gh_mirrors/ir/IronyModManager创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
