Keyboard & Controller
Keyboard Not Appearing
Section titled “Keyboard Not Appearing”Symptom: Can’t type in the Ren’Py console or name input screens.
Solutions:
- Use the keyboard overlay button — Tap the keyboard icon in the overlay to summon the iOS keyboard
- Enable OSK Overlay — Go to Settings and ensure On-Screen Keyboard Helper is enabled
- Enable Keyboard Overlay — Ensure the keyboard overlay button is enabled
Keyboard Blocks Game View
Section titled “Keyboard Blocks Game View”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
Controller Not Detected
Section titled “Controller Not Detected”Symptom: Game controller is connected but Spark doesn’t respond to it.
Solutions:
- Check Settings > Game Controllers is enabled
- Verify Bluetooth connection in iOS Settings
- Disconnect and reconnect the controller
- Try closing and reopening Spark
- Some games don’t support controller input — this is a game limitation, not a Spark issue
Controller Buttons Mapped Wrong
Section titled “Controller Buttons Mapped Wrong”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
Haptics Not Working
Section titled “Haptics Not Working”- Check Settings > Audio & Haptics — both device and controller haptics must be enabled
- Verify your controller supports haptics (DualSense, newer Xbox)
- Not all games trigger haptic feedback