Красный текст в углу экрана после запуска сборки — классика RimWorld. Хорошая новость: почти любую ошибку мода можно найти и вылечить за 10–15 минут, если действовать по системе. Плохая — «просто переустанови игру» тут почти никогда не помогает.
Шаг 1. Читаем лог ошибок
Откройте консоль разработчика (клавиша ` — тильда, слева от единицы) и посмотрите на первые строки красного текста. Не пытайтесь прочесть всю простыню — смотрите на первые 1–2 ошибки: остальные часто лишь следствие. В самом верху — тип исключения и имя мода, например «Exception in Humanoid Alien Races (…): …». Это и есть ваш пациент.
Удобнее всего лог смотреть через HugsLib: нажмите Ctrl+F12 — мод загрузит полный лог в интернет и даст ссылку, которую можно отправить в Discord или на форум вместо скриншотов.
Шаг 2. Отличаем красное от жёлтого
- Красные ошибки (exceptions) — реальный сбой: мод не отработал. Виновник почти всегда назван в первых строках.
- Жёлтые предупреждения — «мод пытается сделать X, не получилось, пропущено». Часто безвредны, особенно если ничего заметного в игре не сломалось.
- Could not resolve cross-reference / could not find def — мод ссылается на объект из другого мода, которого нет. Обычно патч совместимости для мода, который вы не ставили.
Шаг 3. Ищем виновника методом половинного деления
Если имя мода в логе непонятно, работает бисекция. Отключите половину модов (галочки в меню «Моды»), перезапустите игру. Ошибка осталась — виновник в активной половине. Исчезла — в отключённой. Повторите с подозрительной половиной. Даже 200 модов сужаются до одного за 7–8 перезапусков.
Шаг 4. Типичные причины и лечение
- Мод не для вашей версии игры — проверьте поддержку версии (1.4/1.5/1.6) на странице мода; старые моды на новой версии — источник №1 ошибок.
- Библиотека ниже зависимого мода — Harmony и HugsLib поднимите в самый верх (см. гайд о порядке загрузки).
- Нет требуемого фреймворка — в описании мода ищите «Requires» и ставьте зависимость (например, Vanilla Expanded Framework для серии VE).
- Два мода меняют одно и то же — ищите патч совместимости (compatibility patch) к паре конфликтующих модов.
- Мусор в папке Mods — старые версии того же мода рядом с новыми; удалите дубли.
Ошибка вылетает только в конкретной колонии, а в новой игре всё чисто? Значит, сломалось сохранение после удаления мода. Вариант — откатиться к автосейву до удаления или включить мод обратно.
Профилактика вместо лечения
Добавляйте моды пачками по 3–5 штук, а не сотней за раз. Держите оптимизаторы — Performance Fish и RocketMan — они не только ускоряют игру, но и глушат часть фоновых ошибок производительности. И следите за версиями: на странице каждого мода в нашем каталоге указаны поддерживаемые версии игры.
HugsLib
от
Библиотека общей функциональности для модов RimWorld + публикация логов по Ctrl+F12.
Performance Fish
от
Набор патчей производительности от Bradson: стабильный FPS и быстрый тик даже в поздней игре.
RocketMan - Performance Mod
от ,
Мод производительности: кэширование загрузки, фикс освещения и до +500 TPS к игре.