Scripting - The Basics

Updated 6 months ago

What are scripts?

Scripts are what define the conditions that certain music will play, by default the mod will operate as displayed in the preview video, but you can tweak it to operate how you want. You can change which scripts the mod will load in the config.

Where to start

Start by creating a folder named "BGN-PizzaTowerEscapeMusic_Custom" in your BepInEx plugins folder, using this folder instead of the "DefaultScripts" folder prevents your scripts from being removed when the plugin is removed or updated.

Create two new folders named "Scripts" and "Music" in the folder you just created. The "Scripts" folder holds custom scripts. The "Music" folder holds custom music.

If you're fine with the default conditions and just want to replace the music you can copy the "Default.json" file in the "DefaultScripts" folder (located next to the mod DLL) into your "Scripts" folder, replace the music names with your own music file names (including the file extension), and place the custom files in the "Music" folder.
The supported music file extensions are: WAV, OGG, and MP3

If you want to share/upload your scripts and music to Thunderstore, see the page "How to Upload Custom Scripts and Music to Thunderstore".