Skip to content
Ludens Ludens Ludens 0.3.0

Input Keys

This content is for the 0.1.0 version. Switch to the latest version for up-to-date documentation.

This reference details the keyboard key codes used in Ludens to map physical or on-screen actions to the RPG Maker MV/MZ engine.

When you configure the Input Key property of an on-screen button (A, B, X, Y) in the Settings menu, you are assigning one of these numeric codes.

Because mobile devices lack physical keyboards, Ludens bridges its native Compose UI buttons to the game’s web environment. When you press an on-screen button, the app dispatches a JavaScript snippet via evaluateJavascript to the WebView. This snippet directly calls the engine’s input handler (Input.js) for the specific event type (e.g., keydown, keyup) and passes a pseudo event, avoiding the need to dispatch synthetic DOM events.

The following table lists the primary keys used for character movement and game interaction.

Key NameCodeTypical RPG Maker MV Default ActionTypical RPG Maker MZ Default Action
Enter13OK / ActionOK / Action
Escape27Cancel / MenuCancel / Menu
Up38Move UpMove Up
Down40Move DownMove Down
Left37Move LeftMove Left
Right39Move RightMove Right
Shift16Dash / RunDash / Run
Control17Special ControlSpecial Control
Alt18Special ControlSpecial Control

These keys are primarily used for system and graphics-related commands within the engine.

Key NameCodeRPG Maker Function
F2113Show/Hide FPS Counter
F3114Toggle Stretch Mode
F4115Toggle Fullscreen (PC only)