[MHunterG]

LocoRoco is played by tilting the world with L and R (both together jump). With Controls > Tilt controls > Tilt with motion on, tilting a gamepad with a gyroscope, a phone or a Steam Deck does the same. It is off by default. The framework part is TeamGDB/PortableKit#41; this PR points the submodule at purun/tilt-controls (e73a866 plus that commit) and opts the profile in.

How the game reads tilt (traced, not assumed)

• The pad reader at 0x08A37DD4 calls sceCtrlReadBufferPositive(…, 1) and sceCtrlReadLatch every frame. It stores the held buttons (u32), the latch's presses and releases (u16 each) and the stick as floats in a struct at 0x08B2D738. Its play tests L (0x100) and R (0x200) as held bits, also as 0x300 for both.
• Hold R for 60 frames: the world eases towards the right over about 15–30 frames, and eases back over about 35–75 frames after release.
• R on half or a quarter of the frames leaned the world visibly less than holding it. So the tilt is eased, and a small device roll presses R part of the time (TiltControls::proportional).
• The stick does not tilt the world (full left and right for 60 frames, checked in the [pad] trace and captures).
• L+R: a 4-frame press gives a small hop at once; held and then released, a bigger jump. No flick-to-jump gesture was added, because it cannot be shown reliable without hardware. The jump stays on L and R together, and a shoulder button the player presses takes over from the tilt, so a tilt never becomes an accidental jump.

Settings (README, Tilt controls)

• Gyro mode: Angle (default; input only, picture untouched), Angle + level horizon (experimental; the picture is turned against the device and zoomed just enough to cover the screen, up to 10° by default, and the port's UI stays upright), Rate (turning tilts, and the tilt stays and fades).
• Full tilt 12°, dead zone 4° with 1.5° hysteresis, invert, level horizon limit.
• Re-centre: in the menu, R3, at start, and when the menu closes.
• Variables: PURUN_TILT, PURUN_TILT_MODE, PURUN_TILT_FULL, PURUN_TILT_DEAD_ZONE, PURUN_TRACE_TILT.
• Steam Deck: Steam Input hides the gyroscope. Either let Steam map it onto L and R, or disable Steam Input for the shortcut so SDL's own Deck driver exposes it.

How it was verified

macOS 27 on an M1, fresh in-place install from the European ISO into a scratch data dir, with a copy of an after-level-1 save. Bounded windowed NO_AUDIO runs driven with PURUN_INPUT_LIVE and the new tilt and gyro script steps:

• The sensor enumeration log.
• Angle mode:
  • 3° presses nothing.
  • 7° pulses R and the world leans part way.
  • 15° holds R.
  • -15° holds L.
• R3 re-centre.
• Rate mode: quick turn, slow return, fade.
• The menu section and saving to settings.ini.
• Level horizon at 0°, 5°, 10° and 15° (capped): the direction is right and no corner is uncovered.
• Unit tests portablekit_tilt_tests and portablekit_settings_tests.

Not verified

• Any real hardware: DualShock 4, DualSense, Switch Pro, the Steam Deck (either Steam Input setting), phones. Also Linux, Windows and Android.
• How the thresholds feel in the hand.

Merging with fix/confirm-cross

Only the portablekit pointer conflicts. purun/tilt-controls and purun/confirm-cross merge cleanly in PortableKit; point the submodule at their merge. The profile edits don't overlap.

🤖 Generated with Claude Code