Skip to content

Installation

Prerequisites

  • Unity 6000.0+ with a Universal Render Pipeline (URP) project
  • Git installed and available in your system PATH
  • Windows or Linux

Universal Render Pipeline

Your Unity project must use the Universal Render Pipeline. When creating a new project, select the Universal 3D template.

Step 1: Install SplashEdit in Unity

  1. Download the latest SplashEdit release as a .tgz file from the releases page
  2. In Unity, go to Window -> Package Manager
  3. Click the + button and select Add package from tarball...
  4. Select the downloaded .tgz file
  5. Unity imports the package

Step 2: Open the Control Panel

Go to PlayStation 1 -> SplashEdit Control Panel (or press Ctrl+Shift+L).

The Control Panel is your central hub for dependencies, scene management, and building.

Step 3: Install the Native Project

In the Control Panel's Dependencies tab:

  1. Under Native Project, click the release dropdown and select the version that matches your SplashEdit package version
  2. Click Clone to download the psxsplash C++ runtime
  3. Wait for the clone to complete (this uses Git under the hood)

Tip

Alternatively, click Browse to point to a local copy of the psxsplash source if you already have it cloned.

Step 4: Install the Toolchain

Still in the Dependencies tab, the toolchain section shows the status of each required tool:

Tool Purpose Install Method
MIPS Cross-Compiler Compiles C++ to PS1 machine code Click "Install"
GNU Make Build system Click "Install"
PCSX-Redux PS1 emulator for testing Click "Download"
psxavenc Audio conversion to ADPCM Click "Download"
mkpsxiso ISO image creation Click "Download"

Each tool shows a green Ready badge when installed. SplashEdit handles downloading and setting up all of these for you.

Minimum requirements

You need at minimum the MIPS compiler and Make to build. PCSX-Redux is needed for emulator testing and Lua compilation. mkpsxiso is only needed for ISO builds.

Verifying Installation

When all required tools show green badges, the Control Panel status bar shows "Ready". You're good to go.

If SplashEdit detects a missing toolchain on first launch, it automatically opens the Control Panel to guide you through setup.