An open-source compiler for the Papyrus scripting language. Currently, the compiler only supports Skyrim (tested on Skyrim SE/AE).
The compiler was created for the following purposes:
- Understanding Programming Languages: The project is designed to gain a deeper understanding of how programming languages work.
- Experimenting with the V Language: It uses the V programming language for implementation.
- Speeding Up Compilation: The standard Papyrus compiler is very slow, so this project aims to optimize that process.
- Improved Error Messages: Provides higher quality and more understandable error messages to simplify debugging.
- Download the archive with the compiler from the Github Releases page and extract it.
- Open a console in the directory where you extracted the compiler.
- Use the following syntax to work with the compiler:
papyrus <command> [arguments]
compile: Compiles files with the.pscextension into the binary.pexformat.read: Reads and disassembles a.pexfile, outputting its contents in a human-readable format to the console.disassembly: Reads and disassembles a.pexfile, saving its contents in a human-readable format to a text file.create-dump: Creates adump.jsonfile containing information about.pexfiles located in the specified directory.help: Displays a list of available commands and their descriptions.
The following arguments can be used with the compile command:
-i,-input: Specifies the directory with.pscfiles or a.pscfile to compile.-o,-output: Specifies the directory where the compiled.pexfiles will be placed.-h,-headers-dir: Specifies the directory with.pscheader/import files that will be analyzed by the compiler but not compiled. Used to let the compiler know about existing scripts (Form,ObjectReference,Actor, ...) and their methods/functions/properties/variables. See the "Header/Import Files" section.-nocache: Ignores the cache and forces compilation of all files.-silent: Disables output of error messages to the console.-original: Uses the original Papyrus compiler for compilation.-stats: Saves statistics on compiled files to .md files (number of function calls, inheritances, files).-check: Checks the syntax of .psc files without generating .pex files.-verbose: ...
Below are several examples demonstrating the use of various compiler commands and arguments for compiling scripts, reading compiled scripts, etc.
papyrus compile -nocache -i "D:\Steam\steamapps\common\Skyrim Special Edition\Data\Scripts\Source" -o "../test-files/compiled/skyrimSources"This command compiles all scripts (ignoring the cache) located in D:\Steam\steamapps\common\Skyrim Special Edition\Data\Scripts\Source and places the compiled .pex files in the ../test-files/compiled/skyrimSources directory.
papyrus compile -i "../../RH-workspace/scripts" -o "../../RH-workspace/compiled"This command compiles all scripts located in ../../RH-workspace/scripts and places the compiled .pex files in the ../../RH-workspace/compiled directory.
papyrus compile -nocache -h "D:\Steam\steamapps\common\Skyrim Special Edition\Data\Scripts\Source" -i "../test-files/compiler" -o "../test-files/compiled" This command will compile all scripts from the ../test-files/compiler directory to the ../test-files/compiled directory, and missing information about objects (Form, ObjectReference, Actor, etc.) will be taken from .psc files in the D:\Steam\steamapps\common\Skyrim Special Edition\Data\Scripts\Source directory.
papyrus read "../test-files/compiled/ABCD.pex"papyrus create-dump "../folder_with_pex_files"Creates a JSON file dump.json containing some information about all .pex files located in the ../folder_with_pex_files directory. Here's what it will look like:
[
{
"name": "ActiveMagicEffect",
"parent_name": "",
"methods": [
{
"name": "RegisterForUpdate",
"arguments": [
{
"name": "afInterval",
"type": "Float"
}
],
"return_type": "None",
"is_native": true,
"is_global": false
}
],
"global_functions": [...]
},
...
]By default, the compiler is unaware of existing scripts (Form, ObjectReference, Actor, etc.), their inheritance (ObjectReference -> Form), and available methods/functions/properties/variables.
You can fix this in two ways:
- Specify the path to the directory with the original scripts (e.g.,
..\Skyrim\Data\Scripts\Source) using the-h "..."argument. - Create a directory with header files indicating existing objects and their methods, functions, etc., and specify it using the
-h "..."argument.
Example of the Actor.psc header file:
ScriptName Actor extends ObjectReference
Function EquipItem(Form akItem, bool abPreventRemoval = false, bool abSilent = false) nativeBy analyzing this file, the compiler learns about the existence of the Actor object, its inheritance from ObjectReference, and the presence of the EquipItem function with the corresponding arguments (some of which have default values). The native flag allows skipping the writing of the function body in the header file, as these scripts are used only for analysis. This significantly speeds up compilation.
Scripts from the directory specified by the -h "..." argument will NOT be compiled and placed in the directory specified by -o "...".
v -o "bin\papyrus.exe" -prod -gc none compiler.vv -stats test modules- Papyrus docs
- VS Code Extension: Papyrus Language Tools
- Creation Kit Papyrus Reference
- Compiled Script File Format
- Caprica - A compiler for the Papyrus scripting language used by the Creation Engine.
- Champollion - A PEX to Papyrus Decompiler for Fallout 4
- PapyrusDotNet - PapyrusDotNet - A .NET Papyrus Compiler for Fallout 4 and Skyrim
- Open Papyrus - Docs
- Open Papyrus - Compiler - (WIP, Rust lang) Open-source compiler for the Papyrus scripting language of Bethesda games.