Basic Usage - hakasapl/PGPatcher GitHub Wiki

Requirements

Hardware Requirements

PGPatcher is heavily multithreaded and has a lot of random IOPS. This means that the runtime will be slow on an HDD, like REALLY REALLY slow (usually something like 10x the runtime over an SSD). Therefore, an SSD is HIGHLY recommended for your modlist.

The more cores you have the more PGPatcher will use by default.

Software Requirements

You just need runtime requirements. These are:

  1. .NET Runtime 8
  2. VCRedist x64

In order to see the shaders that PGPatcher patches in-game, you need to install either Community Shaders or ENBSeries. If you want to use TruePBR textures, only Community shaders is supported.

Mod Compatibility

  • Auto Parallax is INCOMPATIBLE with PBR and REDUNDANT for all other cases. PGPatcher replaces its functionality completely.
  • All parallax mods are compatible
  • All complex material mods are compatible if they use community-defined best-practice values. If they do not, they can be made compatible by ignoring their meshes in the PGPatcher mod window
  • All PBR mods are compatible as long as they include patcher jsons (99% do)
  • All other mods should be compatible

Game Requirements

ENBSeries Setup

After installing ENBSeries and a preset, you will need to open enbseries.ini and set the following items in the file:

  1. EnableComplexParallax=true
  2. EnableComplexParallaxShadows=true
  3. EnableComplexMaterial=true
  4. EnableDynamicCubemap=true

Community Shaders Setup

In the CS menu, ensure that Complex Material is enabled under Extended Materials. This is the default.

Usage

  1. Install the PGPatcher archive as a mod (You can do this as an external app instead, but for simplicity I am advising users who don't care to install it as a mod)
  2. Add the PGPatcher.exe executable to whatever mod manager you use (from the mod staging folder), then launch it via your mod manager.
    1. For vortex, verify that Run in Shell and Run Detached are both enabled
  3. In the launcher UI set the following settings:
    1. Under conflict resolution, make sure you select the mod manager you are using, or None if you do not use either.
      1. NOTE: For MO2, the instance folder is the location can be found by pressing the folder icon in the toolbar then "Open Instance Folder". It should have a modorganizer.ini file in it
    2. Set your output directory. I would recommend setting this to an empty mod folder like PGPatcher_Output directly, and unchecking the zip option. This will allow you to update your previous output automatically without having to reinstall every time. Keep in mind that the mod must be disabled in your mod manager prior to running PGPatcher.
    3. If not already set and locked, set your game path and game type
  4. Click on Start Patching.
  5. Wait until you get the mod window. Learn about the mod window and how to prioritize things on this page. Once done, click okay to continue.
  6. After patching is done, you will get a confirmation dialog. This dialog may contain some warnings or errors which you must read through. For help with these see this page
  7. Press any of the buttons to close the confirmation dialog, then either install as a mod, or if you output directly to a mod folder, simply activate the mod in your mod manager.

The installed mod should overwrite everything in your load order except DynDoLOD/TexGen outputs.

PG_X.esp plugins (where X is any number) MUST BE LOADED LAST, except for DynDoLOD/TexGen Outputs. LOOT will sort these plugins correctly.

Patcher Order of Operations

The various patchers should be run in this order. If it's not in the list order probably doesn't matter or we don't know about it yet (feel free to ask).

  1. Bodyslide
  2. PGPatcher (Keep PGPatcher output enabled for the rest of this list!)
  3. TexGen
  4. DynDoLOD

VRAMr is not included in this list because order doesn't technically matter. If you run VRAMr after PGPatcher, ensure PGPatcher output is enabled and generate VRAMr with it enabled. If you run VRAMr before PGPatcher, ensure its output is DISABLED before running PGPatcher.

How to Update PGPatcher

  • If you installed as a mod, install the new version and replace (not merge)
  • If you installed externally, go to the location you installed it and remove everything except the cfg folder, then drag the files from the new version in.

Both of these options will preserve your settings and mod rules.