Skip to content

Keyboard & Controller

Symptom: Can’t type in the Ren’Py console or name input screens.

Solutions:

  1. Use the keyboard overlay button — Tap the keyboard icon in the overlay to summon the iOS keyboard
  2. Enable OSK Overlay — Go to Settings and ensure On-Screen Keyboard Helper is enabled
  3. Enable Keyboard Overlay — Ensure the keyboard overlay button is enabled

Symptom: The iOS keyboard covers important game elements.

Solutions:

  • The OSK overlay includes a dismiss button
  • Swipe down on the keyboard to minimize
  • Tap outside the text field in the game

Symptom: Game controller is connected but Spark doesn’t respond to it.

Solutions:

  1. Check Settings > Game Controllers is enabled
  2. Verify Bluetooth connection in iOS Settings
  3. Disconnect and reconnect the controller
  4. Try closing and reopening Spark
  5. Some games don’t support controller input — this is a game limitation, not a Spark issue

Ren’Py uses standard controller mappings. If buttons seem wrong:

  • The game may have custom mappings that differ from Ren’Py defaults
  • Try using the D-pad for navigation
  • A/X button should advance text in most games
  1. Check Settings > Audio & Haptics — both device and controller haptics must be enabled
  2. Verify your controller supports haptics (DualSense, newer Xbox)
  3. Not all games trigger haptic feedback