TimedInput for Godot

Adds a node type that monitors an input action for long holds, short taps and multiple taps. Can emit signals or send InputEventActions. Which events are monitored and what is done in response are configurable.

The included demo covers much of the functionality of the addon. Try out the demo at https://hatmix.itch.io/godot-timed-input

(Feb 2025 update) I probably won't be maintaining this addon and will use G.U.I.D.E instead.

TimedInput types

Tap

An action input pressed and released before too long (see Action Hold Delay).

Multitap

One or more taps quickly following an initial tap (see Action Multitap Timeout).

Hold

An action input continuously pressed for at least a minimum time.

Configuration options

Action

Name of an action from the input map to be timed

Action Hold Delay

How many seconds an action button/key must be held before it is a "hold" instead of a "tap"

Action Multitap Timeout

How many seconds after a tap can the next tap be part of a consecutive chain (multitap)

Emit Signals

Enable to emit signals for TimedInput types

Send Events

Enable to send events for TimedInput types

Process Tap, Process Multitap, Process Hold

Enable or disable each to react to or ignore the related TimedInput type

Emit Holding Signal

Enable to emit the holding signal with current total time held each physics frame, e.g. for easy progress bar updates.

Strength Scale

InputEventAction strength is used for the count of multitaps and duration of holds. Strength has a range of 0.0 to 1.0, so count and duration are multiplied by this scale value to get a valid strength. This is only needed in events as signals pass the actual values.

Signals

tapped (duration: float)
multitapped (count: int)
hold_started
holding (current_duration: float)
hold_finished(total_duration: float)

Events

When enabled, input actions will be added based on the action being monitored.

[action name]_tap
[action name]_multitap
[action name]_hold_started
[action name]_hold_finished

Note that events are experimental and more likely to receive breaking changes.

Motivation

This addon grew out of coding my entry for the 1-Button Jam, OBMG (One Button Mini-Golf).

Attribution

• imjp94/gd-plug used for plugin management
• bitwes/GUT used for testing
• Stopwatch icon made by Lorc. Available at game-icons.net.