RiptOPL DOCS

In-Game Reset (IGR)

In-Game Reset lets you leave a running game and come straight back to RiptOPL โ€” or power the console off โ€” without touching the console's own Reset button. It is a controller shortcut that works from inside the game.

RiptOPL installs a small hook into the running game that watches the controller for a reserved button combination. When it sees one, it tears the game down and either returns you to the browser or shuts the console down.

The button combinations

Every combination starts the same way: hold all four shoulder buttons โ€” L1 + L2 + R1 + R2 โ€” and then, while still holding them, press the second half.

HoldThen pressResult
L1 + L2 + R1 + R2Start + SelectReset โ€” quit the game and return to RiptOPL
L1 + L2 + R1 + R2L3 + R3Power off the console
L1 + L2 + R1 + R2UpIn-game screenshot โ€” see Screenshots

L3 and R3 are the analog-stick clicks, so the power-off combination needs a DualShock with the analog light on.

The console power button

The power button on the front of the console is hooked too, and does not need a controller:

Power buttonResult
Press oncePower off
Press twiceReset โ€” return to RiptOPL

The second press has to land within about a second โ€” RiptOPL waits ~50 vertical blanks after the first press to see whether another arrives, then acts on the count.

โ„น Worth remembering
This is the fallback when a game has stopped responding to the pad entirely โ€” it does not depend on the pad hook having attached.

Where a reset takes you

By default a reset returns you to the RiptOPL browser, started fresh. It does not restore what you had selected: Remember Last Played Game (Settings โ†’ General & System) is a separate setting, off by default, and it is what re-selects the last game you ran.

You can send it somewhere else with the IGR Path setting (Settings โ†’ General & System). Point it at an ELF and that ELF is booted on reset rather than the browser โ€” a common use is to drop straight back into a different launcher or a homebrew menu. The file must live on a memory card (mc0: or mc1:); leave the setting blank to return to RiptOPL normally.

If you use MMCE cards, IGR Bootcard Slot(s) (Settings โ†’ Game Sources โ†’ MMCE Settings) additionally sends a "switch to bootcard" command to slot 0, slot 1, both, or neither as the reset happens, so the card is already back on its boot image by the time the next thing loads. See MMCE.

When IGR is not available

IGR is not universal. It is worth knowing the three cases where the combinations will do nothing, so you do not spend time hunting a fault that is not there.

Before the game opens a controller

The hook attaches by patching the game's own scePadPortOpen / scePad2CreateSocket call. Until the game asks for a pad, there is nothing hooked โ€” so IGR does not respond during very early boot logos on some titles. The console power button still works.

When the game is incompatible

A few games handle input in a way the hook disturbs. Per-game compatibility Mode 6 โ€” Disable IGR turns the hook off for that title. If a game misbehaves in a way that started when you launched it through RiptOPL, this is the mode to try โ€” at the cost of losing IGR for that game. See Per-game Settings.

Under the Neutrino core

โš  Neutrino has no IGR
This is a property of that loader, not a RiptOPL limitation, and it is why Mode 6 is greyed out whenever the Loader Core is set to Neutrino โ€” there is no hook there to disable. To leave a Neutrino-launched game, use the console's power or reset button. See Neutrino Core.

PS1 titles are a separate case again: they run under POPSTARTER or Ember, each of which has its own independent IGR behaviour built into that binary. RiptOPL's hook is not involved. See PS1 Games and the sister POPStarter docs.

In-game screenshots (IGS)

The L1+L2+R1+R2 + Up combination captures the current frame to a bitmap on memory card slot 1, named from the game's ID with a zero-padded sequence number starting at 001 โ€” for example mc1:/SLUS_012.34_GS(001).bmp. The number increments to a maximum of 255 per game.

Two conditions gate it, and both catch people out:

  1. GSM must be enabled for the running game. The capture is gated on the game's GSM setting, so with GSM off the combination does nothing at all.
  2. The build must include IGS. The Makefile defaults EXTRA_FEATURES to 0 and IGS follows it, and the main release loader is built with that default โ€” so the loader most people run has no IGS and the Up combination is simply inert.
โ„น You do not have to build it yourself
The rolling release also publishes an IGS-enabled loader. Inside RIPTOPL-VARIANTS-*.zip, the variants named -extra1 are built with EXTRA_FEATURES=1, which turns IGS on; they come in pademu0/pademu1 and optional -ds5 flavours. Building from source with make IGS=1 works too. See Releases.
โš  RetroAchievements and IGS are mutually exclusive
The RA loader (RIPTOPL-RetroAchievements-*.zip) is deliberately built without EXTRA_FEATURES: GSM 1080p plus IGS and RA will not both fit in the console's ram84 region. You can have achievements or in-game screenshots, not both. See RetroAchievements.

Troubleshooting

Nothing happens when I press the combination. Check, in order: the game has actually started (past the early boot logos); the Loader Core is OPL rather than Neutrino; Mode 6 is not set for this game; and โ€” for the power-off combination specifically โ€” the controller is in analog mode, since L3 and R3 are the stick clicks. The screenshot combination uses Up, so it needs no analog mode.

Try the console power button as a cross-check: if that resets and the pad combination does not, the hook is fine and the problem is in the pad half.

Reset takes me somewhere unexpected. Check IGR Path in Settings โ†’ General & System. A stale path left over from an earlier setup will boot that ELF instead of returning to the browser.

The game resets on its own during play. A game that uses all four shoulders plus Start or Select in normal play can trigger IGR by accident. Set Mode 6 โ€” Disable IGR for that title.

Where this lives in the source
FileRole
ee_core/src/padhook.cThe hook itself: pad pattern matching, the VBLANK interrupt handler, combo dispatch, the IGR thread
ee_core/include/padhook.hThe combo constants (IGR_COMBO_R1_L1_R2_L2, IGR_COMBO_START_SELECT, IGR_COMBO_R3_L3, IGR_COMBO_UP)
ee_core/src/cd_igr_rpc.cIOP-side reset RPC
ee_core/src/igs_api.cScreenshot capture and BMP writing
include/iosupport.hCOMPAT_MODE_6 โ€” the Disable IGR flag