Мод «DefLoadCache» для Rimworld (v1.6)

DefLoadCache кэширует результаты загрузки XML-файлов определений и применения патчей в RimWorld, поэтому при повторном запуске с тем же списком модов пропускаются два самых медленных этапа запуска.

При списке из 414 модов это сокращает время запуска с ~9 минут до ~2:40 после первого запуска.

При запуске RimWorld с модами процесс загрузки проходит через ряд этапов. Вот некоторые из них, относящиеся к загрузке Def:

• Поиск модов — сканирует папку Mods/ и мастерскую Steam на наличие активных модов.
• Загрузка сборки — загружает DLL-файлы каждого мода.
• LoadModXML — считывает в память все файлы Defs/*.xml из каждого мода.
• CombineIntoUnifiedXML — объединяет весь проанализированный XML-код в один XML-документ.
• ApplyPatches — выполняет проверку каждого файла Patches/*.xml с помощью XPath на соответствие единому документу.
• ErrorCheckPatches — проверяет успешность установки патчей.
• ParseAndProcessXML — преобразует XmlNode в типизированные объекты Def.
• ResolveReferences — связывает перекрестные ссылки.
• Загрузка текстур, звука, строк — Unity загружает ресурсы мода.

В списке из 414 модов этапы 3 и 5 (LoadModXML + ApplyPatches) занимают около 6 из 9 минут. Кроме того, при каждом запуске они дают одинаковый результат, если ничего не менять.

DefLoadCache пропускает этапы 3, 5, 6 и 8 при запуске с попаданием в кэш. После первого обычного запуска он сериализует полностью пропатченный XmlDocument на диск, а затем при последующих запусках возвращает кэшированный документ обратно вместо повторного чтения файлов и повторного запуска патчей.

Кэш автоматически аннулируется при изменении любого содержимого def. Для каждого файла в папках Defs/, Patches/, Assemblies/ и About.xml каждого мода вычисляется отпечаток SHA-256. Любое изменение на уровне байтов в любом из этих файлов меняет отпечаток и принудительно запускает пересборку. Добавление, удаление, изменение порядка модов, изменение версий, обновления RimWorld и пересборка DLL-файлов запускают пересборку.

Этапы, которые по-прежнему выполняются при каждом запуске независимо от состояния кэша: загрузка текстур/аудио/строк, ParseAndProcessXML, ResolveReferences, патчинг Harmony и статические конструкторы. Это объясняет оставшиеся примерно 2:40 минуты времени запуска, которые остаются после попадания в кэш.

Измерения проводились на наборе модификаций Combat Extended milsim из 414 модулей:

• Первый запуск (создание кэша): ~9:10 — обычная скорость плюс несколько секунд на сериализацию
• Последующие запуски (попадание в кэш): ~2:40 — на 71% быстрее
• Размер кэша на диске: ~7 МБ

При любых изменениях (добавлении, обновлении, удалении, изменении порядка) при следующем запуске примерно через 9 минут выполняется полная пересборка, и цикл начинается заново.
Наибольшую выгоду получают SSD-накопители и 16 ГБ оперативной памяти и более. Более старое оборудование также работает, но прирост производительности невелик, поскольку чтение из кэша конкурирует с другими операциями ввода-вывода на диске.

MissileGirl — это комплексный пакет для повышения производительности. Он включает в себя Gagarin (кэширование XML-определений), RocketMan (кэширование статистики/объектов), Soyuz (регулирование тиков пешек), Cosmodrome (оптимизация патчей) и кэш текстур. Если вам нужен один мод, который решает множество проблем с производительностью одновременно, MissileGirl, как правило, является более предпочтительным выбором. Он делает больше, чем DefLoadCache.

DefLoadCache фокусируется на одном: конвейере XML-определений. На этом этапе он пересекается с Gagarin, поэтому запуск обоих избыточен. Остальные подсистемы MissileGirl (кэширование статистики, регулирование пешек, кэш текстур) не затрагивают загрузку XML и могут работать вместе с DefLoadCache без проблем. Вы можете использовать только один из них. Если вы предпочитаете другие возможности MissileGirl, пожалуйста, используйте MissileGirl.

Выбирайте DefLoadCache, если:

• Вам нужно только кэширование XML без более масштабных изменений, вносимых MissileGirl в статистику, время жизни персонажей, патчи и текстуры. Меньшая площадь поверхности означает меньше точек взаимодействия с другими модами.
• У вас возникли проблемы совместимости с подсистемами MissileGirl, не использующими XML.
• Вам нужно, чтобы кэш сохранялся до тех пор, пока ничего не меняется. Gagarin автоматически удаляет свой кэш через 2 дня, даже если список ваших модов не изменяется; DefLoadCache этого не делает.

Для работы мода требуется:

• Prepatcher

Мод проверен на версии игры: 1.6