RimWorld

RimWorld

1,610 ratings
Prepatcher
9
4
3
5
2
   
Award
Favorite
Favorited
Unfavorite
Mod, 1.4, 1.5
File Size
Posted
Updated
4.044 MB
16 Feb, 2023 @ 1:33pm
28 Apr, 2024 @ 8:25am
23 Change Notes ( view )

Subscribe to download
Prepatcher

Description
Prepatcher is most importantly a powerful tool for mod developers. The project also includes a mod manager which runs before the game loads.

The mod manager - Prestarter
Prestarter is still in more of a preview state currently and I'll be expanding it in the near future. It's already very convenient though.

Features:
  • Runs before the game loads
  • Press Space while the game is loading to open (unfortunately only after a message saying you can do so appears on screen)
  • Load, save, copy and paste mod lists
  • Undo/redo while editing (Ctrl-Z/Ctrl-Shift-Z)

Relation to Harmony
With Brrainz's permission, Prepatcher is an alternative provider of the Harmony library for RimWorld mods. This means that:
  • Prepatcher can be used in place of the Harmony mod (brrainz.harmony). In practice, this is done by patching the mod loading system to make Prepatcher satisfy dependencies on Harmony.
  • Having both the Harmony mod and Prepatcher active won't cause any problems

Dependencies
Prepatcher has no dependencies on other mods.

Load order
Prepatcher should go first in the mod list, above Core and expansions. Its placement relative to Harmony doesn't matter, it can be put below or above it.

For modders
Prepatcher doesn't do anything on its own, it's only useful when other mods depend on it.
The library provides patching capabilities beyond those of Harmony. Currently these are:
  • Adding fields to types
  • Free editing of the game's assembly before the game starts
Visit the Github wiki for more information.

Acknowledgements
Prepatcher builds upon other great software. Thanks to Brrainz for Harmony, 0x0ade for MonoMod and jbevain for Mono.Cecil (and anyone who ever contributed to these projects!).

Troubleshooting
When you encounter an issue you think might be caused by Prepatcher, the information on what happened is most likely contained in RimWorld's error log (Player.log).

Please upload your log file somewhere like pastebin.com and paste the link here or, ideally, post a bug report at: https://github.com/Zetrith/Prepatcher/issues

Location of RimWorld's error log file (Player.log):
  • Windows shortcut: Press Win+R, type appdata and hit enter, go to LocalLow\Ludeon Studios\RimWorld by Ludeon Studios
  • Windows path: %USERPROFILE%\Appdata\LocalLow\Ludeon Studios\RimWorld by Ludeon Studios\Player.log
  • Linux: ~/.config/unity3d/Ludeon Studios/RimWorld by Ludeon Studios/Player.log
  • Mac: ~/Library/Application Support/RimWorld/Player.log

Links
Issue reports and suggestions: https://github.com/Zetrith/Prepatcher/issues
Github: https://github.com/Zetrith/Prepatcher
Dev wiki: https://github.com/Zetrith/Prepatcher/wiki
Standalone download: https://github.com/Zetrith/Prepatcher/ (click Code -> Download zip)

[www.patreon.com]
Popular Discussions View All (4)
4
6 hours ago
Prepatcher broken
⦃Sค†คn⦄
3
23 Mar @ 6:32pm
Prepatcher incompatibilities
Aaron
7
11 Jun @ 3:58pm
black screen when i try to open the mod manager
Nerok
324 Comments
dr650cp 20 Jul @ 9:32pm 
1.6 pls
Alu 20 Jul @ 7:00pm 
If a mod needed it
They would lidt it in their dependency sections
The game will tell you if you are missing any in the mod menu
frodeobaggins 20 Jul @ 5:43pm 
does anyone know what mods this mod relies on? a list would be ideal as i cannot play as i dont know which mods need prepatcher to work
Scionin 20 Jul @ 1:24pm 
Performance fish relies on prepatcher
PHCGamer 20 Jul @ 10:39am 
I saw a pull request on the Github page for a 1.6 update, but haven't checked to see if it works.
Lunar Nepneus 20 Jul @ 9:06am 
Agreed, hope someone continues it if the original author has other stuff going on, haven't seen them on here in a minute so hope all is well on their end.
frodeobaggins 19 Jul @ 9:50am 
please someone update this somehow. its an essential mod
bradson 19 Jul @ 7:23am 
Other mods can use this to recompile the base game assembly in memory during loading, making deeper changes to code than is possible with harmony. It doesn't change anything itself, except for the small loading UI change and the experimental mod manager
Ffisher 19 Jul @ 5:51am 
Can someone please explain what this mod actually does, if you have no mods that need it as a pre-req? I timed it, and it's adding 20% to my load time..
Lucifearus 19 Jul @ 3:29am 
hi :mhwilds_grr: