Repository navigation
touchHLE UF v0.3.20
Native controller support
- Add native MFi GameController support for Monster Hunter Portable 2nd G (P2G 1.00.02) and Grand Theft Auto: Vice City 1.4.
- Support standard and extended controller profiles, face buttons, both analog sticks, independent triggers, D-pad input, pause callbacks, and connection/disconnection notifications.
- Verified on a Samsung Galaxy S10e with a GameSir-X4A for Xbox. Other Bluetooth/USB controllers depend on Android and SDL recognizing them correctly.
- Add the compatibility needed by these games' iOS 7 controller paths: Objective-C block lifetime handling, global block linking, Foundation JSON writing, dictionary construction, and unavailable iCloud-container queries.
- Retain touch controls and existing controller-to-touch options for games without native controller support.
P2G controller reference
This is the game's native extended MFi layout, using Xbox-style button labels. Actions depend on whether your weapon is drawn and on the current weapon type.
| Controller input | PSP equivalent | Action |
|---|---|---|
| Left stick | Analog stick | Move; partial input walks |
| Right stick | — | Rotate the camera |
| A | Cross (×) | Evade / roll |
| B | Circle (○) | Weapon attack; interact, gather, or carve with weapon sheathed |
| X | Square (□) | Sheathe weapon; use the selected item when sheathed |
| Y | Triangle (△) | Draw weapon / attack |
| LB | L | Center the camera; item-selection combinations |
| RB | R | Sprint while sheathed; weapon-specific action while drawn |
| LT | Select | Select function |
| RT | Start | Start function |
To sprint: hold RB while moving with the left stick. Normal walking is slower.
To carve: finish the attack animation, release RB, press X to sheathe, approach the corpse, and press B when prompted.
GTA: Vice City 1.4 controller reference
Vice City uses its native MFi controls. On-foot and vehicle actions are context-dependent; follow the game's controller prompts for other buttons.
| Controller input | Action |
|---|---|
| Left stick | Move on foot / steer a vehicle |
| Right stick | Look / rotate the camera where supported |
| D-pad Down + B | Open the map |
| D-pad Up + B | Change camera mode |
The map and camera shortcuts are documented by Rockstar Games Support.
Validation
- 96 Rust unit tests passed (1 ignored).
- 117 ARM integration tests passed on macOS.
- Virtual-controller guest tests covered values, copied-block callbacks, both sticks, independent triggers, pause edges, notifications, and disconnects.
- P2G and Vice City tested on a real Samsung device with a connected controller.
No game IPAs are included. Use your own compatible 32-bit game files.