Gestures
Spark supports 8-directional swipe gestures during gameplay that can trigger Ren’Py actions.
Enable Gestures
Section titled “Enable Gestures”| Setting | Use Ren’Py Gestures |
| Default | Off |
Master toggle for the gesture system.
Override All Gestures
Section titled “Override All Gestures”| Setting | Override All Gestures |
| Default | On |
When enabled, Spark’s gesture settings override any gesture configuration the game itself may define.
Gesture Directions
Section titled “Gesture Directions”You can assign an action to each of the 8 swipe directions:
| Direction | Default | Available Actions |
|---|---|---|
| North (↑) | None | Main Menu, Rollback, Toggle Skip, Hide Windows |
| North-East (↗) | None | Main Menu, Rollback, Toggle Skip, Hide Windows |
| East (→) | None | Main Menu, Rollback, Toggle Skip, Hide Windows |
| South-East (↘) | None | Main Menu, Rollback, Toggle Skip, Hide Windows |
| South (↓) | None | Main Menu, Rollback, Toggle Skip, Hide Windows |
| South-West (↙) | None | Main Menu, Rollback, Toggle Skip, Hide Windows |
| West (←) | None | Main Menu, Rollback, Toggle Skip, Hide Windows |
| North-West (↖) | None | Main Menu, Rollback, Toggle Skip, Hide Windows |
Available Actions
Section titled “Available Actions”| Action | Ren’Py Command | Description |
|---|---|---|
| None | — | No action |
| Main Menu | game_menu | Opens the in-game menu (save/load/settings) |
| Rollback | rollback | Goes back one dialogue step |
| Toggle Skip | toggle_skip | Starts or stops text skipping |
| Hide Windows | hide_windows | Hides the dialogue window |
- Gestures work well for one-handed play on iPhone
- Rollback on swipe left is a popular configuration
- Main Menu on swipe down mimics many games’ built-in gesture
- Be careful with gestures near screen edges, as iOS system gestures may interfere
For more details on how Ren’Py’s gesture system works, see the official Ren’Py gesture documentation.