two-torial/docs/extras/patchsp2x.md

Spice2x DLL Patching

!!! info "TWO-TORIAL Patcher"

URL: `https://sp2x.two-torial.xyz`  
[GitHub Repo](https://github.com/two-torial/sp2xpatcher)  
[Supported Games](https://github.com/two-torial/sp2xpatcher/blob/main/SUPPORTED.md)  
[Contributing](https://github.com/two-torial/sp2xpatcher/blob/main/CONTRIBUTING.md)  

[Known spice2x patchers](../resources.md#spice2x-patchers)

!!! warning "Compatibility"

This patching method only is for [spice2x supported games](https://github.com/spice2x/spice2x.github.io/wiki/List-of-supported-games).

**Please make sure you're using the latest release for [spice2x](https://spice2x.github.io/) as the feature is fairly new.**

!!! danger "Before proceeding"

**It is highly recommended to use an unpatched DLL as your base!**

If you've already patched your game through other methods *([web patching](patchweb.md) or [hex editing](hexguide.md))*,  
**Please replace your game's DLL with the original**.

---

Getting Started

!!! tip ""

**The following guide works the same regardless of which spice2x compatible game you're using.**

In this case we will be using a clean SDVX installation as a reference, with the following folder structure.

Importing Patches from URL

!!! tip ""

Open `spicecfg.exe` and head to the `Patches` tab.

!!! tip ""

By default no patches will be available, we need to import some. 

- Click on `Import from URL`.	
- Paste your preferred patcher's URL.  

**Note**: Check the [Resources](../resources.md) page for a list of recommended patchers.

- Click on `Import`.  

^^**If patching fails, it most likely is because the URL you provided doesn't support your game's version.**^^

Picking Patches

!!! danger "Important"

**As a general rule of thumb, if you're not sure what a patch does or you're not absolutely certain you need it, leave it alone**.

!!! tip ""

After a successful import, your patches should now show up inside spice2x.

A new `Patches` folder has also been created, containing a `.json` file with your available patches for offline use.

!!! tip ""

Now you may pick and choose desired patches!

For game-specific instructions, refer to their respective dedicated pages.

Auto apply / Overwrite game files

!!! tip "Auto apply (recommended)"

After picking your patches, it is **strongly recommended** to tick the `Auto apply patches on game start` box.

Doing so will keep your game files intact until you start it, at which point your selected patches will apply.  
Upon closing the game your game's files will be restored.

!!! warning "Overwrite game files"

You also have the option to `Overwrite game files`, which will **permanently modify your game files**.

This is **NOT** recommended unless you have a good reason to do so.  
A backup of your original dll will be created, however it is recommended to make your own!