Store Page
RimWorld
All Discussions Screenshots Artwork Broadcasts Videos Workshop News Guides Reviews

RimWorld

Store Page
RimWorld >  Workshop > zetrith's Workshop
1,483 ratings
Prepatcher
Description Discussions4 Comments247 Change Notes
9
4
4
2
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 )
Created by
zetrith
Offline
See all 89206 collections (some may be hidden)
207,273 Unique Visitors
247,936 Current Subscribers
6,981 Current Favorites

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)
3
23 Mar @ 6:32pm
Prepatcher incompatibilities
Aaron
7
11 Jun @ 3:58pm
black screen when i try to open the mod manager
Nerok
2
2 Nov, 2024 @ 10:50am
Black Screen after using Prepatcher
The Gaming Archaeologist
247 Comments
< >
Levelith_ 12 Jun @ 7:41am 
I imagine Prepatcher will be upgraded to 1.6, am I right?
bradson 11 Jun @ 5:51pm 
That's also way more than just camera+ in that enormous modlist you threw into the discussion thread lol
bradson 11 Jun @ 5:48pm 
Pressing space opens the mod manager, which is still in a preview state as written in the description. It's not relevant for any patching functionalities this offers to other mods, as a library.

External mod managers like rimpy or rimsort are generally better options compared to managing mods through any ingame solution
raz334 11 Jun @ 3:43pm 
I am using Rimworld Version 1.4 and Camera+ Among many other mods.
I get a black screen when the patcher comes loads up, and have to ALT-F4 to exit the game at that point i'm stuck. Though this is ONLY if i hit space and have the prepatcher screen actually show up. But without that it's kind of useless..
bradson 1 Jun @ 11:39am 
If you've messed with windows security settings before, look into the known workarounds regarding ASLR. Harmony for rimworld 1.5 requires that for some patches, has nothing to do with prepatcher. Camera+ is definitely compatible and works
200 1 Jun @ 11:35am 
i get a black screen if combined with camera+.
bradson 31 May @ 5:59pm 
@cow of french if you encounter bugs, report them with a log after verifying that they're caused by this. Prepatcher stores absolutely nothing in save files, can be removed at any time to easily test in case of issues
Alu 31 May @ 4:48pm 
All the mod does
Is reload the assembly with things loaded by mods prepatches

Its only used by like 3 mods and entirely for optimizations not possible without it
cow of french 31 May @ 1:07pm 
this mod feels very sketchy, feels like the game is just gonna become a line of code full of errors
Daevinski 31 May @ 9:14am 
@FlamingLlama Thanks for sharing this solution. It solved my problem, and now I'm able to use Prepatcher again. Even other mods are now working properly. I can finally play modded RimWorld as I used to with 1.4.