Per-game Settings

Every PS2 title in RiptOPL has its own configuration file stored in the CFG/ folder on your game device. The Game Settings screen lets you tune compatibility, memory cards, cheats, video, and the loader core independently for each game — without touching any other title's settings.

Opening Game Settings

Highlight a game in any list and press the Triangle button. A small menu drops down with these entries:

Compatibility Settings — compatibility modes, Loader Core, Neutrino args & video, DMA mode, Game ID, Alt-Startup
Cheat Settings — enable/disable PS2RD cheats for this title
GSM Settings — per-game video-mode override (OPL core only)
VMC — assign Virtual Memory Cards to slot 1 and slot 2
PADEMU Settings — DualShock 3 / DualShock 4 pad emulation (OPL core only)
OSD Language Settings — per-game OSD language override (OPL core only)
Save Changes — write the current settings to CFG/
Test Changes — launch the game immediately with the current (unsaved) settings
Remove All Settings — delete per-game (and optionally global) config entries for this title

i Config file location

Per-game settings are stored as CFG/<GAMEID>.cfg on the same device the game lives on. The filename is the game's startup ID (e.g. SLES_123.45.cfg). Settings are shared across all RiptOPL / OPL / wOPL builds that read from the same device; only the master settings file (settings_riptopl.cfg) is private to RiptOPL.

Compatibility Settings

The Compatibility Settings screen is the main per-game workhorse. It is split into several sections.

Loader Core

The Loader Core picker selects which engine launches this title:

Value	Description
`<OPL>`	OPL's built-in EE core. The default for all games.
`Neutrino`	Hand the game off to an external `neutrino.elf`. See Neutrino Core.

Config key: $CoreLoader. The screen adapts immediately when you change this picker — see Core-aware adaptation below.

i UDPBD / UDPFS games lock to Neutrino

Network-boot games (UDPBD / UDPFS) have no OPL core backend. For those titles the Loader Core selector is locked to Neutrino and cannot be changed. If neutrino.elf is missing, OPL warns you and returns to the menu — there is no fallback.

Neutrino Launch Args & Neutrino Video (Neutrino core only)

These two fields appear on the Compatibility screen and are only active when the Loader Core is set to Neutrino (they are greyed under <OPL>).

Neutrino Launch Args — a button that opens the same structured args sub-screen as the global setting: named fields (Quick Boot, Working Dir, Config, Boot ELF, ATA0 / ATA0 ID / ATA1 image, plus a free-form Extra field) reassembled in a valid order with --b last. Stored in config key $NeutrinoArgs as a single flat string (e.g. -mt=dvd). Each sub-field holds 31 visible characters; for a longer single value, edit $NeutrinoArgs in the .cfg directly — OPL forwards the full value at launch. A global default is set in Settings → General Settings → Neutrino Launch Args; per-game args are appended after it.
Neutrino Video — structured picker for Neutrino's -gsm video-mode flag. Config key: $NeutrinoVideo.

Picker value	Neutrino flag emitted	Notes
Off	(nothing)	Default; no video override
240p	`-gsm=fp1`	Force 240p / NTSC progressive
480p	`-gsm=fp2`	Force 480p / NTSC progressive scan
1080i	`-gsm=1080ix1`	Force 1080i

i Manual -gsm wins

If you type a -gsm=… flag directly into the Neutrino Launch Args field, it takes precedence over the picker. OPL emits only one -gsm argument — Neutrino aborts on a duplicate — so a manually typed value suppresses the picker's output entirely.

Compatibility Modes 1–7

Seven toggle switches control low-level loading behavior. OPL stores them as a bitmask in $Compatibility; under the Neutrino core the set that maps to Neutrino's -gc flag is forwarded automatically.

Mode	Label	What it does	Core
1	Accurate Reads	Use a slower but more accurate CD/DVD read path. Fixes some games that fail with the fast default reads.	OPL + Neutrino (`-gc`)
2	Synchronous Mode	Forces synchronous (blocking) data reads instead of asynchronous ones. Helps games that are sensitive to read-ahead buffering.	OPL + Neutrino (`-gc`)
3	Unhook Syscalls	Removes OPL's syscall hooks after the game boots. Required for a small number of titles that patch or inspect syscalls themselves.	OPL + Neutrino (`-gc`)
4	Skip Videos	Applies a zero file size to PSS video files and also skips Bink (.BIK) videos, preventing hangs on games that stall waiting for FMV playback.	OPL core only — greyed under Neutrino
5	Emulate DVD-DL	Emulates a dual-layer DVD. Necessary for a handful of titles that check the disc layer-break position.	OPL + Neutrino (`-gc`)
6	Disable IGR	Disables the In-Game Reset (IGR) hook. Use when IGR interferes with a game's own reset handling.	OPL core only — greyed under Neutrino
7	Neutrino only — fix games that overrun an IOP buffer (`-gc=7`)	Passes `-gc=7` to Neutrino, which applies an IOP-side fix for games that overrun an IOP buffer. Has no effect at all under the OPL core.	Neutrino only — greyed under OPL

i How -gc is built for Neutrino

When the Loader Core is Neutrino, OPL converts the compatibility bitmask to Neutrino's -gc=<value> format, forwarding modes 1, 2, 3, 5, and 7 (mode 4 and mode 6 have no Neutrino equivalent and are silently skipped). The DL Defaults button — which downloads OPL-bitmask compatibility data from the network — is greyed under the Neutrino core because that data does not map to -gc.

DMA Mode

For HDD (APA/PFS) and exFAT (BDMA) games, a DMA Mode picker appears. It sets the ATA transfer mode used to read the game partition. Options range from MDMA 0 through UDMA 4 (default UDMA 4). Lowering the DMA mode can resolve read errors on aging drives or cables. This picker is hidden for devices that do not support DMA (USB, SMB, MMCE, etc.).

Game ID & Alt-Startup

Game ID ($DNAS) stores the hexadecimal startup ID used to look up the game in the OPL compatibility database. Use Load from Disc to read it automatically from an inserted disc, or type it manually. Alt-Startup ($AltStartup) overrides the ELF that is executed at boot — useful for multi-disc sets or non-standard disc layouts. Both fields are 31 characters maximum in the on-screen editor.

VMC — Virtual Memory Cards

The VMC screen assigns a Virtual Memory Card image to each of the two memory-card slots for this title. Up to two VMCs can be active simultaneously. VMC images are .bin files in the VMC/ folder; they can range from 8 MB to 64 MB.

For each slot you can:

Select an existing VMC image by name.
Create a new image directly from the per-game VMC screen.
Clear the assignment (no VMC for that slot).

VMC works with both the OPL core and Neutrino. Under Neutrino, OPL passes the VMC paths as -mc0=<path> / -mc1=<path> arguments. Config keys: $VMC_0 (slot 1), $VMC_1 (slot 2). See VMC for full details on creating and managing VMC images.

i VMC and Neutrino: spaced names

VMC file names with spaces work correctly — OPL passes each VMC path as a discrete argument rather than concatenating into a flat string. Names up to 31 characters are supported in the on-screen editor; longer names can be set by editing the .cfg file directly.

Cheat Settings

The Cheat Settings screen lets you enable or disable PS2RD cheat codes loaded from a .cht file in the CHT/ folder. Cheats are applied by OPL's built-in core at launch; this panel is an OPL core feature and is not available under Neutrino.

If the game's Loader Core is set to Neutrino, opening Cheat Settings displays the message "This setting is not used with the Neutrino core."

For the cheat file format and a full how-to, see Cheats and the POPStarter cheats reference.

GSM Settings

GSM (Game Screen Mode) forces a specific video output mode for a game — useful for titles that output an unusual or unsupported signal. The per-game GSM screen is an OPL core feature; it is not available under Neutrino.

If the game's Loader Core is set to Neutrino, opening GSM Settings displays the message "This setting is not used with the Neutrino core." Use the Neutrino Video picker on the Compatibility Settings screen instead.

PADEMU Settings

PADEMU enables DualShock 3 and DualShock 4 controller emulation for a game. It is an OPL core feature and is not available under Neutrino.

If the game's Loader Core is set to Neutrino, opening PADEMU Settings displays the message "This setting is not used with the Neutrino core."

A DualSense / DualShock 5 build is available as a separate compile option (make DUALSENSE=1); see the Releases page.

OSD Language Settings

OPL can patch the OSD language, TV aspect ratio, and video output mode written into EEPROM during game boot via the per-game OSD Language Settings screen. This is an OPL core feature; it is not available under Neutrino.

If the game's Loader Core is set to Neutrino, opening OSD Language Settings displays the message "This setting is not used with the Neutrino core."

Core-aware adaptation

RiptOPL adapts the per-game screens to the Loader Core chosen for each title. The goal is to show only the options the active core actually honors, so you are never editing settings that will be silently ignored at launch.

Panel / option	<OPL> core	Neutrino core
Neutrino Launch Args	Greyed (never read)	Active
Neutrino Video picker	Greyed (never read)	Active
Mode 4 — Skip Videos	Active	Greyed (no Neutrino equivalent)
Mode 6 — Disable IGR	Active	Greyed (no Neutrino equivalent)
Mode 7 — Fix IOP buffer overrun	Greyed (no OPL effect)	Active
DL Defaults button	Active	Greyed (OPL bitmask data, not -gc)
Cheats panel	Active	Shows "not used with Neutrino core"
GSM panel	Active	Shows "not used with Neutrino core"
PADEMU / Pad Macro panels	Active	Shows "not used with Neutrino core"
OSD Language panel	Active	Shows "not used with Neutrino core"
VMC panel	Active	Active (via -mc0/-mc1)
Loader Core selector	Active	Active (locked for UDPBD/VCD)

i PS1 / VCD games

PS1 titles shown via the L3 VCD view always launch through POPSTARTER.ELF — never OPL's core and never Neutrino. The Loader Core selector is pinned to <OPL> and locked for VCD entries, since the choice is inert. For PS1-specific settings (IGR hotkeys, multi-disc, cheats), see the POPStarter docs.

Save Changes, Test Changes, Remove Settings

Save Changes

Writes the current state of all per-game panels to CFG/<GAMEID>.cfg on the game device. After saving, the config source is marked as User customized, which prevents automatic online compatibility updates from overwriting your manual settings.

Test Changes

Launches the game immediately using whatever is currently loaded in the Game Settings dialog — including any unsaved edits. Use this to verify a compatibility tweak before committing it to disk. If the settings turn out to work, follow up with Save Changes.

Remove All Settings

Prompts you to choose what to delete:

Per-game settings — removes this title's CFG/<GAMEID>.cfg entry only.
Global settings — removes any global (per-type) overrides stored for this title.
All settings — removes both. Resets the title to bare defaults.

After removal the dialog reloads defaults so the screen reflects the cleared state.

Config key reference

Per-game settings are stored in the game's .cfg file as key=value pairs. The keys used by the per-game settings screen are:

$Compatibility    compatibility mode bitmask (integer)
$CoreLoader       0 = <OPL>, 1 = Neutrino
$NeutrinoArgs     Neutrino launch arguments (set via the structured sub-screen)
$NeutrinoVideo    0=Off, 1=240p, 2=480p, 3=1080i
$VMC_0            VMC name for slot 1
$VMC_1            VMC name for slot 2
$DNAS             game hexadecimal ID (for compat DB lookup)
$AltStartup       override ELF path at boot

How are compat modes stored as a bitmask?

Each mode maps to a power-of-two bit: Mode 1 = 0x01, Mode 2 = 0x02, Mode 3 = 0x04, Mode 4 = 0x08, Mode 5 = 0x10, Mode 6 = 0x20, Mode 7 = 0x40. They are OR'd together into a single integer. For example, enabling Mode 1 + Mode 3 gives $Compatibility=5. When the Loader Core is Neutrino, OPL converts this to a -gc= value by forwarding only modes 1, 2, 3, 5, and 7 (modes 4 and 6 have no Neutrino equivalent).

Where exactly is the .cfg file stored?

On each game device, in a folder named CFG/ at the root of the OPL directory tree. For USB that is mass:/CFG/, for HDD APA it is pfs0:OPL/CFG/, for SMB it is relative to the configured OPL share root, and so on. The filename is the game's startup ID with a .cfg extension (e.g. SLUS_200.12.cfg). Because all OPL-family builds read the same CFG/ folder, per-game settings are shared between RiptOPL, wOPL, and stock OPL on the same drive.