TurboWarp Extended Notification

A TurboWarp extension for waiting on custom notifications or key presses with optional timeouts.

Purpose

The extension provides a small, reusable synchronization mechanism for TurboWarp projects. Input-specific logic such as pose recognition, speech recognition, or sprite click detection remains in controller sprites, which emit named extended notifications.

Blocks

send extended notification [MESSAGE]

Sends a named notification to every script currently waiting for that name.

| Property | Value | |---|---| | Type | Command | | Opcode | sendNotification | | MESSAGE | String, default: next |

wait until extended notification [MESSAGE] is received

Pauses the current script until the named notification is received.

| Property | Value | |---|---| | Type | Command | | Opcode | waitForNotification | | MESSAGE | String, default: next |

extended notification [MESSAGE] received before [SECONDS] seconds

Returns true when the named notification arrives before the timeout, otherwise false.

| Property | Value | |---|---| | Type | Boolean | | Opcode | waitForNotificationOrTimeout | | MESSAGE | String, default: next | | SECONDS | Number, default: 5 |

wait until [KEY] key is pressed

Pauses the current script until the selected key is pressed.

| Property | Value | |---|---| | Type | Command | | Opcode | waitForKey | | KEY | String, default: space, menu: keyMenu |

[KEY] key pressed before [SECONDS] seconds

Returns true when the selected key is pressed before the timeout, otherwise false.

| Property | Value | |---|---| | Type | Boolean | | Opcode | waitForKeyOrTimeout | | KEY | String, default: space, menu: keyMenu | | SECONDS | Number, default: 5 |

The timeout-enabled Boolean blocks return true when the notification or key press occurs first and false when the timeout occurs first.

Development

npm install
npm run check

Regenerate block documentation after changing src/block-definitions.json:

npm run docs

For continuous rebuilding:

npm run dev

The Vite build creates:

dist/extended-notification.js

Load this file as a TurboWarp custom extension and enable Run extension without sandbox.

Design

Notifications are not retained. An emitted notification resumes every script that is currently waiting for the same name. See docs/specification.md for the complete behavior.

License

MPL-2.0