How It Works

InputPro ships as two packages: a paid Studio plugin for visual editing, and a free open-source runtime for your game code.

Plugin Guide Paid

The InputPro plugin adds a visual editor to Roblox Studio for creating input bindings without writing code.

Installation

1. Purchase and install the plugin from the Creator Store
2. Open Studio — click the InputPro button in the toolbar
3. The editor widget opens as a dockable panel

Quick Start

1. The editor starts with a default "Gameplay" context
2. Click "+ Action" to create your first action (e.g. "Jump", type Bool)
3. Expand the action row, then click "+ Keyboard"
4. The plugin enters listen mode — press a key (e.g. Space) and it's bound immediately
5. Go to File > Export Config, name it, and click Save
6. Press Play to test!

Contexts

Contexts group related actions and control when they're active. A game might have "Gameplay", "UI", and "Vehicle" contexts.

• Priority — Higher priority contexts process input first
• Sink — When enabled, blocks input from reaching lower-priority contexts
• Default — One context can be marked as default; it auto-enables when the game starts

Manage contexts via Context > Manage Contexts in the menu bar, or use the context dropdown in the top bar.

Bindings

Keyboard & Gamepad

Expand an action row and click "+ Keyboard" or "+ Gamepad" to add a binding. The plugin enters Listen Mode — press a key or button and it's bound immediately. You can also add bindings manually from a dropdown.

Touch

InputPro doesn't generate touch UI — you design your own buttons in StarterGui, then link them to actions in the plugin. This gives you full control over your mobile UI design.

How to link a touch button

1. Create a TextButton or ImageButton in your ScreenGui (StarterGui)
2. Select an action in the plugin, then click + Touch
3. Select the button in the Explorer — the plugin validates it's a GuiButton
4. The link appears as a touch pill on the action row, showing the button name and path

On export, each linked button is stored as attributes (TouchButtonPath, TouchButtonName) on the InputAction instance. At runtime, InputProService resolves the path in PlayerGui, creates an InputBinding with its UIButton property set to your button, and Roblox automatically wires tap events to the action's Pressed/Released signals.

Analog Triggers

R2/L2 gamepad triggers support custom pressed/released thresholds. Click the binding's edit button to configure when the trigger registers as pressed or released (0.0–1.0 range).

Export & Import

File > Export Config creates the full instance hierarchy in StarterGui/InputPro/<name> and:

• Auto-installs the runtime to ReplicatedStorage/InputProRuntime/
• Creates a bootstrap LocalScript in StarterPlayerScripts/
• Optionally sets the exported config as active (so the bootstrap loads it)

File > Import Config reads an existing export back into the editor for modification.

Code Generation

InputPro can generate boilerplate code for your actions and insert it directly into your scripts.

How to use

1. Select a LocalScript in the Explorer
2. Go to Edit > Insert Code (or click the code icon on an action row)
3. Choose an action from the dropdown
4. Select which events to generate: Pressed, Released, StateChanged
5. Preview the code, then click Insert

The generated code includes:

• The require block for InputProService (auto-skipped if already present)
• BindPressed / BindReleased callbacks (Bool actions only)
• BindStateChanged callback (all action types)

-- Example generated code for a "Jump" action:
local ReplicatedStorage = game:GetService("ReplicatedStorage")
local InputProService = require(ReplicatedStorage
    :WaitForChild("InputProRuntime")
    :WaitForChild("InputProService")
)

InputProService.BindPressed("Jump", function()
    -- Handle Jump pressed
end)

InputProService.BindReleased("Jump", function()
    -- Handle Jump released
end)

Troubleshooting

Runtime API Free

InputProService is a client-side module that reads exported configs and provides a clean API for input handling.

Installation

If you're using the plugin, the runtime is auto-installed on export. For manual installation:

1. Download InputProService.luau from the GitHub repository
2. Place it in ReplicatedStorage/InputProRuntime/InputProService
3. Require it from a LocalScript

-- In a LocalScript (e.g. StarterPlayerScripts)
local InputProService = require(
    game:GetService("ReplicatedStorage")
    :WaitForChild("InputProRuntime")
    :WaitForChild("InputProService")
)

-- Initialize from an exported config
InputProService.Init("MyGameInput")

-- Or initialize for manual/code-only setup
InputProService.InitManual()

Initialization

Actions

-- Bool action: Jump
InputProService.BindPressed("Jump", function()
    character:FindFirstChildWhichIsA("Humanoid"):ChangeState(Enum.HumanoidStateType.Jumping)
end)

-- Direction2D action: Move (returns Vector2)
InputProService.BindStateChanged("Move", function(value)
    -- value is a Vector2 with X and Y components (-1 to 1)
    moveDirection = Vector3.new(value.X, 0, value.Y)
end)

Contexts

-- Exclusive switch: only Gameplay is active
InputProService.SetContext("Gameplay", true)

-- Additive: enable UI alongside Gameplay
InputProService.SetContext("UI", false)

-- Disable a specific context
InputProService.DisableContext("UI")

-- Listen for context changes
InputProService.ContextChanged:Connect(function(name, enabled)
    print(name, enabled and "ON" or "OFF")
end)

Device Detection

Input Images

Prompt Hints

-- Add a key hint badge to an inventory slot
local hint = InputProService.CreatePromptHint("OpenInventory", inventoryButton, {
    Corner = "BottomRight",
    Size = 28,
    Offset = Vector2.new(4, 4),
})

-- hint.Frame   — the UI frame instance
-- hint.Update() — force refresh
-- hint.Destroy() — cleanup

Manual Setup No Plugin

You can use InputProService without the plugin by creating contexts, actions, and bindings in code.

Manual Creation API

Complete Example

-- ManualSetup.client.luau (place in StarterPlayerScripts)
local ReplicatedStorage = game:GetService("ReplicatedStorage")
local InputProService = require(
    ReplicatedStorage:WaitForChild("InputProRuntime"):WaitForChild("InputProService")
)

-- Initialize without a config file
InputProService.InitManual()

-- Create contexts
InputProService.CreateContext("Gameplay", 1, false)
InputProService.CreateContext("UI", 2, true) -- higher priority, sinks input

-- Create actions
InputProService.CreateAction("Gameplay", "Jump", Enum.InputActionType.Bool)
InputProService.CreateAction("Gameplay", "Sprint", Enum.InputActionType.Bool)
InputProService.CreateAction("Gameplay", "Move", Enum.InputActionType.Direction2D)
InputProService.CreateAction("UI", "CloseMenu", Enum.InputActionType.Bool)

-- Bind keys
InputProService.CreateBinding("Jump", Enum.KeyCode.Space)
InputProService.CreateBinding("Jump", Enum.KeyCode.ButtonA)          -- Gamepad A
InputProService.CreateBinding("Sprint", Enum.KeyCode.LeftShift)
InputProService.CreateBinding("Sprint", Enum.KeyCode.ButtonL2, nil, {
    PressedThreshold = 0.3,
    ReleasedThreshold = 0.2,
})
InputProService.CreateBinding("Move", Enum.KeyCode.W)                -- Forward
InputProService.CreateBinding("Move", Enum.KeyCode.S)                -- Backward
InputProService.CreateBinding("Move", Enum.KeyCode.A)                -- Left
InputProService.CreateBinding("Move", Enum.KeyCode.D)                -- Right
InputProService.CreateBinding("Move", Enum.KeyCode.Thumbstick1)      -- Gamepad stick
InputProService.CreateBinding("CloseMenu", Enum.KeyCode.Escape)
InputProService.CreateBinding("CloseMenu", Enum.KeyCode.ButtonB)

-- Enable the default context
InputProService.SetContext("Gameplay", true)

-- Connect events
InputProService.BindPressed("Jump", function()
    print("Jump!")
end)

InputProService.BindPressed("Sprint", function()
    print("Sprint started")
end)

InputProService.BindReleased("Sprint", function()
    print("Sprint ended")
end)

InputProService.BindStateChanged("Move", function(value)
    print("Move direction:", value)
end)

-- Context switching example
InputProService.BindPressed("CloseMenu", function()
    InputProService.SetContext("Gameplay", true) -- exclusive: back to gameplay
end)

-- Device detection
InputProService.ActiveDeviceChanged:Connect(function(device)
    print("Switched to:", device) -- "Keyboard", "Gamepad", or "Touch"
end)

Action Types

Action types determine what kind of value an InputAction produces. Choose the type that matches your gameplay need.