Updated: January 2026

🎮 Heartopia Controller Support Guide

Does Heartopia have native controller support? No. currently, there is no official gamepad support on iOS, Android, or PC.

However, you CAN play with a controller using:

  • 💻 PC: Custom mapping via BlueStacks or LDPlayer (Best Method)
  • 📱 Android: Keymapping apps like Mantis Buddy
  • 🍎 iOS: No current workaround

💻 Method 1: Playing on PC (Recommended)

The best way to play Heartopia with a controller (Xbox/PS5) is by using an Android Emulator on PC. We recommend 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 (Mantis Buddy)

If you want to play on your phone/tablet with a controller, you'll need a "Keymapper" app. Mantis Buddy is the safest and most popular option.

⚠️ Note: This usually requires enabling "USB Debugging" on your phone and connecting it to a PC/Mac once to activate the app services.
  1. Download Mantis Gamepad Pro from the Play Store.
  2. Follow the in-app setup (requires activating via Wifi Debugging or PC).
  3. Add "Heartopia" to Mantis and launch it.
  4. Press the floating Mantis widget -> Click "Add" button.
  5. Drag the "Stick" widget to the movement wheel.
  6. 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, no. iOS is very restrictive with screen overlay apps. Unless the developers add official support, you are stuck with touch controls on iPhone and iPad.

Can I get banned for using Keymappers?

Generally, no. Emulators and keymappers are widely used for cozy games. However, avoid using macros (scripts that automate play) as that can flag anti-cheat systems. Simple 1:1 button mapping is considered safe by most communities.

Will Heartopia add official support?

Many players have requested it on the official Discord! It is a commonly requested feature, but there is no confirmed roadmap release date yet.

Disclaimer: This guide involves using third-party tools (BlueStacks, Mantis Buddy). Heartopia.Life is not affiliated with these apps or XD Entertainment. Use at your own discretion.