Skip to content

hakasapl/PGPatcher

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1,172 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

image

PGPatcher - Mesh and Texture Patcher for Skyrim

For a long time, there were primarily only parallax mods (or complex parallax but that's the same thing. See my rant on the naming of these things here). The process for using them in-game was generally to install a ton of pre-patched parallax meshes (such as those offered by mods like Lux among others), and then installing auto parallax to automatically disable parallax on meshes for which textures did not exist. This method of doing things is very suboptimal and not clean for several reasons.

  • Your coverage of parallax is limited to the meshes you have
  • You need to use extra CPU time at runtime to disable some shaders that should have been disabled to begin with
  • You are limited to the parallax shader type, whereas complex material has been available for some time and is a superior shader
  • Alternate textures in plugins were often left not covered in this system
  • Mod authors had to ship meshes with their textures, which often did not include fixes from mesh fix compilation mods like assorted mesh fixes

This led me to develop PGPatcher to solve all of these cases. PGPatcher is a dynamic patcher primarily responsible for managing how meshes in your load order are configured for various materials in Skyrim. In basic terms, as a user you can install whatever retexture mods you want (whether that be vanilla, parallax, complex material, or PBR), and then let PGPatcher patch your meshes and plugins to make it all work in-game. You no longer should install prepatched meshes nor auto parallax as PGPatcher will take care of that for you. In addition, mixing and matching different shader types is supported. PGPatcher is capable of applying different shaders to the same mesh, and also handle alternate texture records which might need different shaders/properties through a comprehensive mesh permutation system. On top of these things, PGPatcher provides some optional convenience patchers, such as an automated fixed mesh lighting patcher, autoconversion from parallax to complex material, and a lot more. See the patchers wiki page for a full list.

From a texture mod author perspective, PGPatcher allows you to ship ONLY textures with your mod and nothing else (including plugins for alternate textures. PGPatcher will patch that for you too). You don't have to deal with prepatching any meshes, and the user can use your textures on their own meshes. The central idea behind PGPatcher is that textures should be separate from meshes and you shouldn't have to care about both at once. Should be a win-win all around. More information for mod authors can be found here.

As a user I understand the reluctance to learn and use yet another external tool. I always try to make things as easy and clear as possible and UX is a primary focus of mine for this reason. I hope the wiki is helpful for you. That being said I always look for feedback either here on nexus posts or in the form of a GitHub issue if you feel there is something that could be clearer. You can also find me on the Parallax Den discord.

Resources and Documentation

DarkFox127 made a fantastic tutorial video for those who prefer a video for getting started

Contributors

This is an open-source project. We would love to have others contribute as well! See CONTRIBUTING.md for more details about the project.

Acknowledgments

  • The amazing folks on the community shaders discord who answer all my ridiculous technical questions.
  • Spongeman131 for their SSEedit script NIF Batch Processing Script, which was instrumental on figuring out how to modify meshes to enable parallax
  • Kulharin for their SSEedit script itAddsComplexMaterialParallax, which served the same purpose for figuring out how to modify meshes to enable complex material

The following libraries made PGPatcher possible - send them your thanks!

About

Dynamic mesh and texture patcher for Skyrim

Topics

Resources

License

Contributing

Stars

Watchers

Forks

Contributors