Papyrus Compiler Patch (NoDox edition) - Fallout 4

The why?

This is a simple set of files to patch the Papyrus Compiler for Fallout 4. It always annoyed me that with its robustness Bethesda intentionally disallowed using arrays within structs and structs within structs. I've also made this a "NoDox" edition which also removes your computer and username from the compiled output along with stripping the extraneous path from the source filename. I'm not sure why anyone would want that data in there, but I left the option to use either one.

• []Updated patch files for the last CreationKit release from Nov 2025 where BGS recompiled the files so their hashes didn't match the prior patch set.

  []Set defaults to enable cache and use 2 threads. When compiling from CreationKit you cannot specify execution parameters and this can have a drastic improvement in performance. Using only 2 threads keeps the memory usage pretty low while still providing enough performance from the caching.

  Starting with v1. 40 there are changes that now require patching the PapyrusCompiler.exe and the PCompile.dll. You need . NET 4. 0 (which most anyone should have by now) and the included .config file is also necessary or you will get a . NET error when it tries to run and nothing will happen.

  v1. 40 adds some additional features to the compiler exe

  • []Added timing metrics on the output and more verbose information for when it's compiling multiple files at a time. Compile start time, end time, and elapsed time.

    []Added command line argument -threads=n (where n is a number ie 5) to limit the number of threads the compiler will spawn for compiling. In edge cases the vanilla compiler exe will cause an out of memory error with complex scripts. There is a sister setting for ppj files see below example.

    []Added command line argument  -enablecache argument and ppj setting for an in memory cache which dramatically speeds up compiles when doing a whole folder or using a ppj for multiple file compiles. If your project recompile takes more than 2 minutes this will probably help.

    []AnyCPU mode instead of 32bit limited to alleviate an edge case out of memory issue with compelx scripts.

    Cache usage warning. It is a memory hog. If you have limited memory (8gb or less) use the threads option to limit to 1. It will still be faster than not using the cache. In my testing the sweet spot for memory usage vs speed benefit was 4 threads. More threads did not speed it up significantly. As a sample metric, on my test system the original BGS compiler took over 3 hours to compile the whole Fallout 4 Base tree (7800 files). With the cache set to 1 thread it was about 5 minutes, and cache 4 threads was about 4 minutes.

    Sample ppj header