Heartopia Heartopia Guide
Setup Easy

Heartopia Controller Setup Guide

Complete controller setup guide for Heartopia on all platforms. Button mapping, troubleshooting, and compatible controllers.

⏱️ 10 min read 📅 Updated 2026-01-14

🎮 Supported Controllers

Xbox Controller

Platforms: PC, Xbox One, Xbox Series X/S

Compatibility:

Native

Layout: Xbox layout

PlayStation 4 Controller

Platforms: PC, PlayStation 4

Compatibility:

Full Support

Layout: PlayStation layout

PlayStation 5 Controller

Platforms: PC, PlayStation 5

Compatibility:

Full Support with DualSense features

Layout: PlayStation layout

Nintendo Pro Controller

Platforms: Nintendo Switch, PC

Compatibility:

Full Support

Layout: Nintendo layout

Generic Gamepad

Platforms: Any

Compatibility:

Partial Support

Layout: May need manual mapping

📋 Setup Guides by Platform

PC (TapTap) - Xbox Controller

Setup Guide

Steps:

  1. 1. Connect Xbox Controller via USB or wireless adapter
  2. 2. Launch Heartopia on PC
  3. 3. Go to Settings > Controls > Controller Configuration
  4. 4. Select 'Xbox Controller' from the list
  5. 5. Test all buttons in the control test menu
  6. 6. Adjust sensitivity if needed
  7. 7. Save configuration

💡 Note: Windows automatically installs drivers for Xbox controllers

PC (TapTap) - PlayStation 4 Controller

Setup Guide

Steps:

  1. 1. Connect PS4 Controller via USB or Bluetooth
  2. 2. For Bluetooth: Hold Share + PS button until LED flashes
  3. 3. On PC, go to Bluetooth settings and pair the controller
  4. 4. Launch Heartopia
  5. 5. Go to Settings > Controls > Controller Configuration
  6. 6. Select 'PlayStation 4 Controller'
  7. 7. Test all buttons
  8. 8. Save configuration

💡 Note: You may need to install DS4Windows for better compatibility on older Windows versions

Mobile (iOS) - MFi Controller

Setup Guide

Steps:

  1. 1. Enable Bluetooth on iPhone/iPad
  2. 2. Put controller in pairing mode (check manual for button)
  3. 3. Go to Settings > Bluetooth > Select your controller
  4. 4. Once paired, controller icon appears in status bar
  5. 5. Launch Heartopia
  6. 6. Controller will work immediately in-game

💡 Note: Supported MFi controllers include: SteelSeries Nimbus, Xbox controller via adapter, PS4 with adapter

Mobile (Android) - Generic Gamepad

Setup Guide

Steps:

  1. 1. Enable Bluetooth on Android device
  2. 2. Put gamepad in pairing mode
  3. 3. Go to Settings > Bluetooth > Select gamepad
  4. 4. Once paired, launch Heartopia
  5. 5. Controller should work, though button mapping may differ
  6. 6. If needed, remap buttons in Heartopia Settings > Controls

💡 Note: Not all Android gamepads are fully compatible. Test thoroughly

🔘 Button Mapping

Xbox Controller

Button Action
A / Green Interact / Confirm
B / Red Cancel / Back
X / Blue Inventory
Y / Yellow Map
LB Cycle Left
RB Cycle Right
LT (Trigger) Look Around
RT (Trigger) Action Alternative
Left Stick Click Sprint / Speed Up
Right Stick Click Center Camera
Menu Button Pause Menu
View Button Quick Menu
Left Stick Move Character
Right Stick Move Camera
D-Pad Quick Select

PlayStation Controller

Button Action
Cross / X Interact / Confirm
Circle / O Cancel / Back
Square Inventory
Triangle Map
L1 Cycle Left
R1 Cycle Right
L2 (Trigger) Look Around
R2 (Trigger) Action Alternative
L3 (Stick Click) Sprint / Speed Up
R3 (Stick Click) Center Camera
Options Pause Menu
Share / Create Screenshot / Quick Menu
Left Stick Move Character
Right Stick Move Camera
D-Pad Quick Select

Nintendo Switch Pro Controller

Button Action
A / Green Interact / Confirm
B / Red Cancel / Back
X / Blue Inventory
Y / Yellow Map
L Cycle Left
R Cycle Right
ZL Look Around
ZR Action Alternative
Left Stick Click Sprint / Speed Up
Right Stick Click Center Camera
Plus Pause Menu
Minus Quick Menu
Left Stick Move Character
Right Stick Move Camera
D-Pad Quick Select

🔧 Troubleshooting

❌ Controller not recognized

✓ Restart the game
✓ Update controller drivers (PC only)
✓ Reconnect controller via USB
✓ Check if controller is fully charged
✓ Try a different USB port (PC)
✓ Check if controller is in pairing mode

❌ Buttons not responding correctly

✓ Recalibrate controller in Settings > Controls > Calibrate
✓ Check button mapping - may be different from expected
✓ Update controller firmware
✓ Close other applications that may be interfering
✓ Check if controller needs cleaning (dust on buttons)

❌ Stick drift (movement continues without input)

✓ Restart the game
✓ Calibrate stick in Settings > Controls > Calibrate Analog Sticks
✓ Adjust stick deadzone in Settings > Controls > Adjust Deadzone
✓ Clean stick with isopropyl alcohol
✓ If persistent, controller may need repair or replacement

❌ Vibration not working

✓ Check if vibration is enabled in Settings > Audio > Vibration
✓ Ensure controller has battery charge
✓ Test vibration in Settings > Controls > Test Vibration
✓ Restart game
✓ Update controller firmware

❌ Connection drops / Disconnects

✓ Move controller closer to console/PC
✓ Remove wireless interference sources
✓ Recharge controller battery
✓ Reconnect controller
✓ Update controller drivers (PC)
✓ Check for system updates

❌ Triggers stuck or not registering

✓ Restart game
✓ Adjust trigger deadzone in Settings
✓ Clean triggers with compressed air
✓ Avoid exposing controller to liquids
✓ If damaged, may need professional repair

💡 Pro Tips

  • ✓ Adjust stick sensitivity in Settings for comfortable gameplay
  • ✓ Increase deadzone if experiencing stick drift
  • ✓ Test controller settings in Settings > Controls before playing
  • ✓ Calibrate controller regularly for best performance
  • ✓ Keep controller firmware updated
  • ✓ Use vibration for enhanced immersion (if preferred)
  • ✓ Charge controller regularly to avoid disconnections
  • ✓ Store controller in dry, cool place
  • ✓ Use official or certified controllers for best compatibility
  • ✓ Check Heartopia forums for platform-specific controller issues

❓ Frequently Asked Questions

What controllers work with Heartopia?

Xbox, PlayStation 4/5, Nintendo Pro Controller, and most certified gamepads. Generic controllers may have limited support.

How do I pair a Bluetooth controller?

Put controller in pairing mode, enable Bluetooth on your device, select controller from Bluetooth settings. Process varies by device.

Can I use a controller on mobile?

Yes, if your phone supports MFi (iOS) or Bluetooth gamepads (Android). Not all controllers are fully compatible with mobile.

What should I do if my controller doesn't work?

Try restarting the game, reconnecting the controller, updating drivers, or recalibrating in Settings > Controls.

How do I fix stick drift?

Calibrate sticks in Settings, adjust deadzone, or clean sticks with isopropyl alcohol. Persistent issues may need professional repair.

Can I customize button mapping?

Yes, go to Settings > Controls > Customize Controls to remap buttons to your preference.