💻 Method 1: PC / Emulator Controller Mapping
For PC controller support searches, the most practical workaround is mapping an Xbox, PlayStation, or generic gamepad through an Android emulator such as BlueStacks or LDPlayer.
Step 1: Install Emulator
Download and install BlueStacks 5 (Android 11 version recommended) or LDPlayer 9 on your PC.
Step 2: Connect Controller
Plug in your Xbox, PS4/PS5, or generic gamepad via USB or Bluetooth BEFORE launching the emulator. You should see a "Gamepad Connected" notification.
Step 3: Map Keys (The Setup)
- Launch Heartopia inside the emulator.
- Open the "Game Controls" menu (Keyboard icon usually on the sidebar).
- Select "Controls Editor" and switch to "Gamepad".
- Movement: Drag the "D-Pad" or "Joystick" widget onto the on-screen movement wheel.
- Actions: Drag "Tap Spot" widgets onto buttons like Jump, Interact, and Fishing. Press the controller button you want to assign (e.g., 'A' for Jump).
- Save your profile!
📱 Method 2: Android / Mobile Controller Mapping
For Heartopia Android controller support, you usually need a keymapper app that turns gamepad buttons into touch inputs. Mantis Gamepad Pro is one commonly used option, but setup requirements can vary by phone.
- Download Mantis Gamepad Pro from the Play Store.
- Follow the in-app setup (requires activating via Wifi Debugging or PC).
- Add "Heartopia" to Mantis and launch it.
- Press the floating Mantis widget -> Click "Add" button.
- Drag the "Stick" widget to the movement wheel.
- Drag "Key" widgets to all interaction buttons and press your controller buttons to bind them.
❓ Frequently Asked Questions
Is there any way to play on iOS with a controller?
Currently, this guide does not list a reliable iPhone or iPad workaround. iOS and iPadOS are restrictive with screen overlay keymapping, so touch controls are the safest option unless native support is added later.
Can I get banned for using keymappers?
Simple 1:1 button mapping is lower risk than automation, but third-party tools are still outside the game client. Avoid macros, auto-clickers, scripts, or anything that plays for you.
Does Heartopia mobile controller support work on Android?
It can work as a touch-mapping workaround if your phone, controller, and keymapper app cooperate. Test movement, camera, interact, jump, fishing, and menu buttons before doing long quests.
Which controller buttons should I map first?
Start with left stick for movement, right stick or swipe area for camera, A/Cross for jump, X/Square for interact, B/Circle for back, and menu buttons for inventory or map.
Will Heartopia add official controller support?
It is a common player request, especially for PC and mobile players, but there is no confirmed release date listed here for official native controller support.