ZScripter uses controllers recognized by iOS or iPadOS. Available buttons and actions depend on the controller and game engine.
Supported controllers
| Family | Models |
|---|
| PlayStation | DualShock 4 DualSense DualSense Edge |
| Xbox | Wireless Controller (Bluetooth, model 1708) Series X|S Wireless Controller Elite Wireless Controller Series 2 Adaptive Controller |
| Nintendo Switch | Pro Controller Joy-Con (L/R) |
| MFi and mobile | Backbone One (iPhone-compatible models) Other MFi gamepads |
Other controllers can work when iOS or iPadOS recognizes them as gamepads. Compatibility and available buttons depend on system and controller firmware versions.
Connect a controller
Pair the controller through Bluetooth or connect it by cable. In app Settings, open Controls, choose an engine, then open Hardware Controller. With a controller connected, the diagram shows live input in green and dims unavailable controls. You can configure a preview layout without a controller.
The controller diagram and the selected button's assignment. Open full-size image
Assign buttons
In Custom Bindings, tap a button in the diagram, then its action under Selected Control. All Controls lists the available bindings. Select by Pressing a Button lets you choose a control using the controller itself.
Changes save automatically and apply to all games using that engine. Touch control layouts have separate settings.
Ren'Py input modes
Native Gamepad uses a compatible Ren'Py game's own controller bindings. Older runtimes fall back to your saved custom bindings. Switch to Custom Bindings to assign game actions or use a stick as a mouse.
Adjust sticks and triggers
Sticks & Sensitivity lets each stick act as direction buttons, a mouse cursor, or scrolling input. A stick can also be turned off. Increase the dead zone to reduce drift; adjust speed and the response curve to change how movement feels. Horizontal and vertical movement can be inverted.
Trigger Press Point sets how far a trigger must travel. Direction buttons can repeat while held, with adjustable delay and interval. Restore Controller Defaults resets bindings and stick settings for the selected engine.
Back to sections