PCSX2 LaunchBox Integration Plugin

Written By launchbox

Last updated 14 days ago

PCSX2 is the leading emulator for Sony PlayStation 2, and the LaunchBox plugin provides a streamlined integration for downloading, updating, and configuring it inside LaunchBox.

With this plugin, LaunchBox can download PCSX2 automatically, keep it updated, create a LaunchBox-ready emulator profile, enable portable mode, help track required BIOS files, and sync RetroAchievements settings. Users should still expect to configure their controllers manually inside PCSX2 on first launch.

📊 Capabilities Matrix

Capability	Availability	Notes
Download & Configure	✅	Downloads the Windows x64 Qt build from official PCSX2 GitHub releases
Update and Reinstall	✅	Existing PCSX2 installations can be updated or reinstalled
LaunchBox Emulator Profile	✅	Preconfigured Sony PlayStation 2 emulator profile is created automatically
Portable Mode	✅	`portable.ini` is created in the PCSX2 folder
Dependency Files	✅	PlayStation 2 BIOS files are tracked by LaunchBox
RetroAchievements Integration	✅	Credentials and Hardcore Mode can be synced into PCSX2
Automatic Controller Configuration	❌	Users need to configure controllers inside PCSX2
Bezel Download Integration	❌	This feature is not supported for PCSX2

⬇️ Download and Configure

LaunchBox downloads PCSX2 from the official PCSX2 GitHub releases and extracts it to LaunchBox\Emulators\PCSX2.

The plugin selects the Windows x64 Qt build and points LaunchBox to pcsx2-qt.exe. After installation, PCSX2 is ready to be used as the configured emulator for Sony PlayStation 2 games in LaunchBox.

🔄 Update and Reinstall

LaunchBox can check the installed PCSX2 version and compare it against the latest available release.

Updates replace PCSX2 with the newer version while keeping the emulator entry pointed at the correct executable
Reinstalls can refresh the PCSX2 files and recreate portable setup files when needed

This gives users a straightforward way to keep PCSX2 current or repair the local emulator installation.

⚙️ LaunchBox Emulator Profile

LaunchBox creates a ready-to-use PCSX2 profile for Sony PlayStation 2 games, associates supported PS2 platforms, and can make PCSX2 their default emulator.

The profile configures fullscreen launching, startup and pause screen support, save and load state hotkeys, disc-swapping controls, and other standard LaunchBox automation.

📁 Portable Mode

The PCSX2 plugin enables portable mode by creating portable.ini in the PCSX2 emulator folder.

This keeps PCSX2 configuration and related user files inside the emulator folder instead of relying only on the default Documents folder location. A portable setup makes the emulator easier to manage as part of a LaunchBox installation.

🧩 Dependency Files

PCSX2 requires a PlayStation 2 BIOS before games can run. The LaunchBox plugin helps track supported BIOS files and points users to the expected BIOS location.

The dependency file checks include many known PlayStation 2 BIOS filenames and hashes across supported BIOS revisions and regions. LaunchBox can use this information to show whether a recognized BIOS file is present.

Users are still responsible for providing their own PlayStation 2 BIOS files. These files cannot be distributed with LaunchBox or PCSX2.

🏆 RetroAchievements Integration

PCSX2 supports RetroAchievements integration through LaunchBox.

The plugin can read and update RetroAchievements settings in PCSX2's configuration file. This includes syncing the RetroAchievements username, token, enabled state, and Hardcore Mode setting into the [Achievements] section of PCSX2.ini.

If PCSX2 has not been run yet and the configuration file does not exist, users may need to open PCSX2 once before LaunchBox can write RetroAchievements settings.

🎮 Automatic Controller Configuration

PCSX2 does not automatically configure controllers in the way this documentation category is intended to describe. Users should expect to open PCSX2 and configure their controllers manually on first launch.

After that initial setup, PCSX2 can be launched normally through LaunchBox, but controller configuration is still handled inside PCSX2 itself.

🖼️ Bezel Download Integration

PCSX2 does not support bezel downloads through The Bezel Project. At present, this capability is limited to specific emulator integrations such as RetroArch and MAME.