Wait

Description#

'wait [time]'

The wait action pauses script execution for a specified amount of time or until the player interacts. Once the time has passed (or the player clicks), the game automatically continues to the next statement.

Action ID: Wait

Reversible: Yes

Requires User Interaction: Optional (required if no time specified)

Parameters#

Behavior#

With Time Parameter#

When a time value is provided, the game:

1. Blocks all user interaction
2. Waits for the specified duration
3. Automatically advances to the next statement

monogatari.script({
    'Start': [
        'Hello there! I want you to wait 5 seconds now',
        'wait 5000',
        'Wow, that was a long time!',
        'end'
    ]
});

In this example, after the first dialog is shown and the player clicks to continue, the game waits for 5 seconds (5000 milliseconds) before showing the next dialog.

Without Time Parameter#

When no time is provided, the game pauses and waits for user interaction:

monogatari.script({
    'Start': [
        'Hello there!',
        'wait',
        'You clicked to continue!',
        'end'
    ]
});

This is useful for creating pause points where you want the player to manually advance.

Time Conversion#

The wait action accepts time in milliseconds. Common conversions:

Error Handling#

If an invalid (non-numeric) time value is provided, the engine will display an error:

// This will show an error
'wait abc'

The error message will indicate the invalid time value and the location in your script.

Examples#

Dramatic Pause#

monogatari.script({
    'Start': [
        'y The truth is...',
        'wait 2000',
        'y I\'ve always loved you.',
        'end'
    ]
});

Scene Transition Delay#

monogatari.script({
    'Start': [
        'show scene black with fadeIn',
        'wait 1000',
        'show scene bedroom with fadeIn',
        'y Where am I?',
        'end'
    ]
});

Timed Event Sequence#

monogatari.script({
    'Start': [
        'play sound thunder',
        'wait 500',
        'show scene lightning with flash',
        'wait 200',
        'show scene dark_room',
        'y What was that?!',
        'end'
    ]
});

Technical Details#

• During a timed wait, the block global is set to true, preventing user interaction
• When the time elapses, block is set back to false
• The action uses setTimeout internally for timing

Related Actions#

• End - End the game
• Jump - Jump to another label