On this page
  1. Scripting Reference
    1. Public API (Alphabetical)
      1. WhisperContextMinimal(_subject, _location)
      2. WhisperContextSimple(_subject, _location, _story = undefined)
      3. WhisperDebugMatch(_storylet, _ctx = undefined, _now = undefined, _filter = undefined)
      4. WhisperDebugQuery(_ctx = undefined, _now = undefined, _filter = undefined)
      5. WhisperFilter()
      6. WhisperGetRunId()
      7. WhisperAddInsert(_key, _value, _lang = "en")
      8. WhisperInsertResolve(_key, _lang = "en")
      9. WhisperInsertSetList(_key, _array, _lang = "en")
      10. WhisperLineExplicit( _pool_id, _storylet_id, _text, _tags = undefined, _weight = 1, _once_only = false )
      11. WhisperLineSimple( _pool_id, _text, _tags = undefined, _weight = 1, _once_only = false )
      12. WhisperNewRun()
      13. WhisperNow()
      14. WhisperPick(_ctx = undefined, _now = undefined, _filter = undefined)
      15. WhisperPickAndFire(_ctx = undefined, _now = undefined, _filter = undefined)
      16. WhisperPickAndFireOr(_ctx = undefined, _now = undefined, _filter = undefined, _fallback_fn = undefined)
      17. WhisperPickOr(_ctx = undefined, _now = undefined, _filter = undefined, _fallback_fn = undefined)
      18. WhisperPoolDebugQuery(_pool_id, _ctx = undefined, _now = undefined, _filter = undefined)
      19. WhisperPoolPick(_pool_id, _ctx = undefined, _now = undefined, _filter = undefined)
      20. WhisperPoolPickAndFire(_pool_id, _ctx = undefined, _now = undefined, _filter = undefined)
      21. WhisperPoolPickAndFireOr(_pool_id, _ctx = undefined, _now = undefined, _filter = undefined, _fallback_fn = undefined)
      22. WhisperPoolPickOr(_pool_id, _ctx = undefined, _now = undefined, _filter = undefined, _fallback_fn = undefined)
      23. WhisperPoolQuery(_pool_id, _ctx = undefined, _now = undefined, _filter = undefined)
      24. WhisperQuery(_ctx = undefined, _now = undefined, _filter = undefined)
      25. WhisperResetAll()
      26. WhisperSaySimple(_pool_id, _ctx = undefined, _lang = "en")
      27. WhisperSayTaggedSimple( _pool_id, _tags_any, _ctx = undefined, _lang = "en" )
      28. WhisperSayTextSimple( _pool_id, _ctx = undefined, _lang = "en", _fallback_text = undefined )
      29. WhisperSetRunId(_id)
      30. WhisperAddVerb(_name, _func)
      31. WhisperStateBuild()
      32. WhisperStateClear(_reset_auto_ids = false)
      33. WhisperStateLoad(_filepath = "")
      34. WhisperStateLoadJSON(_json_data)
      35. WhisperStateSave(_filepath = "")
      36. WhisperStorylet(_id)
        1. AddToPool(_pool_id): Add this storylet to the named pool.
        2. CanFire(_ctx, _now): Determine whether the storylet can currently fire.
        3. DebugAvailability(_ctx, _now, _filter = undefined): Debug this storylet’s availability given context and filters.
        4. Fire(_ctx, _now): Fire this storylet, running on_fire and updating usage/cooldown.
        5. HasTag(_tag): Check whether this storylet has a given tag.
        6. SetAvoidImmediateRepeat(_flag = true): Avoid picking this storylet twice in a row (per pool).
        7. SetCooldown(_cooldown): Set cooldown duration (uses the same units as _now).
        8. SetMaxUses(_max_uses): Set max total uses (ever). Use < 0 for unlimited.
        9. SetMaxUsesPerRun(_max_uses): Set max uses per run/session; < 0 for unlimited.
        10. SetOnAvailable(_func): Set hook called when the storylet is eligible during query.
        11. SetOnFire(_func): Set hook called when the storylet fires (after selection).
        12. SetOnResolved(_func): Alias for SetOnFire.
        13. SetOnSelected(_func): Set hook called when the storylet is selected by a pick.
        14. SetOnce(): Convenience: set max uses to 1 (ever).
        15. SetPredicate(_func): Set predicate function used for custom availability rules.
        16. SetWeight(_weight): Set base selection weight (must be > 0).
        17. SetData(_data): Set arbitrary user data on this storylet.
        18. SetDataCloned(_data): Set arbitrary user data on this storylet, cloned via variable_clone.
        19. GetData(): Get the user data stored on this storylet (may be undefined).
        20. AddTag(_tag): Add a tag to this storylet.
        21. AddTagsArray(_tags_array): Add multiple tags (skips duplicates already present).
        22. SetTags(_tags_array): Replace the entire tag array.
        23. AddText(_string, _verb = undefined, _lang = "en"): Add text variation to the main body.
        24. GetText(_lang = "en"): Convenience: get just the text of a random variation.
        25. TextResolve(_lang = "en"): Resolve content to { id, text, events, data } for this storylet’s body.
      37. WhisperTick(_dt)
      38. WhisperTickManual(_enabled)
      39. WhisperTickReset()
      40. WhisperTickSet(_num)
      41. WHISPER_VERB.AddVerb(_name, _func)
      42. WhisperVerbInsert(_name)
      43. WhisperVerbRunRange(_events, _from_pos, _to_pos, _ctx)

Scripting Reference

This page documents the public Whisper API.

Everything here is listed in alphabetical order so you can Cmd+F your way to victory.

Public API (Alphabetical)

WhisperContextMinimal(_subject, _location)

Create a minimal context with subject + location only.

Arguments

  • _subject Any Main subject (player, NPC, etc.).
  • _location Any Location identifier.

Returns: Struct

WhisperContextSimple(_subject, _location, _story = undefined)

Create a simple Whisper context struct (subject/location/story fields).

Arguments

  • _subject Any Main subject (player, NPC, etc.).
  • _location Any Location identifier.
  • [_story] Struct,Undefined Optional story/state struct.

Returns: Struct

WhisperDebugMatch(_storylet, _ctx = undefined, _now = undefined, _filter = undefined)

Debug a single storylet match (returns reasons for failure/success).

Arguments

  • _storylet Struct.__WhisperStorylet,Any Storylet struct or storylet id.
  • [_ctx] Struct,Undefined Context struct passed to predicates and hooks.
  • [_now] Real,Undefined Time value used for cooldown checks.
  • [_filter] Struct,Undefined Filter struct ({ tags_all, tags_any, tags_not, tags_prefer, prefer_weight, custom }).

Returns: Struct

WhisperDebugQuery(_ctx = undefined, _now = undefined, _filter = undefined)

Debug a global query (returns details about candidates and why they matched/failed).

Arguments

  • [_ctx] Struct,Undefined Context struct passed to predicates and hooks.
  • [_now] Real,Undefined Time value used for cooldown checks.
  • [_filter] Struct,Undefined Filter struct ({ tags_all, tags_any, tags_not, tags_prefer, prefer_weight, custom }).

Returns: Array<Struct>

WhisperFilter()

Convenience builder for Whisper filter structs.

Arguments

  • None.

Returns: Struct

  • Additional details:

    • This returns a plain struct with fields Whisper understands:

      • tags_all: array of tags the storylet must have all of
      • tags_any: array of tags the storylet must have at least one of
      • tags_not: array of tags the storylet must not have
      • tags_prefer: array of tags to prefer when choosing (soft preference)
      • prefer_weight: optional weight multiplier when a preferred tag matches
      • custom: optional function function(_storylet, _ctx) -> Bool for custom filtering

WhisperGetRunId()

Get the current run/session id.

Arguments

  • None.

Returns: Real

WhisperAddInsert(_key, _value, _lang = "en")

Register an insertion value for a key.

Arguments

  • _key String Insertion key (no brackets).
  • _value String Replacement text.
  • [_lang] String Language code.

Returns: Undefined

WhisperInsertResolve(_key, _lang = "en")

Resolve a single insertion key for a given language.

Arguments

  • _key String Insertion key.
  • [_lang] String Language code.

Returns: String,Undefined

WhisperInsertSetList(_key, _array, _lang = "en")

Register an insertion list for a key, used for random selection.

Arguments

  • _key String Insertion key.
  • _array Array<String> List of possible replacement strings.
  • [_lang] String Language code.

Returns: Undefined

WhisperLineExplicit( _pool_id, _storylet_id, _text, _tags = undefined, _weight = 1, _once_only = false )

Create a storylet with an explicit id and add it to a pool (track).

Arguments

  • _pool_id Any Pool / track identifier (e.g. “npc_bridge”).
  • _storylet_id Any Storylet identifier (e.g. “npc_bridge_hello_1”).
  • _text String Text for this line (may include verbs and inserts).
  • _tags Array<String>,String,Undefined Tags for filtering (array or single string).
  • _weight Real,Undefined Relative selection weight (> 0).
  • _once_only Bool,Undefined If true, this line can fire only once ever.

Returns: Struct.__WhisperStorylet

WhisperLineSimple( _pool_id, _text, _tags = undefined, _weight = 1, _once_only = false )

Create a simple storylet and add it to a pool (track), with an auto generated id.

Arguments

  • _pool_id Any Pool / track identifier (e.g. “npc_bridge”).
  • _text String Text for this line (may include verbs and inserts).
  • _tags Array<String>,String,Undefined Tags for filtering (array or single string).
  • _weight Real,Undefined Relative selection weight (> 0).
  • _once_only Bool,Undefined If true, this line can fire only once ever.

Returns: Struct.__WhisperStorylet

WhisperNewRun()

Start a new run/session. This resets per-run usage tracking.

This also clears pool repeat-suppression state (the last picked storylet), so a new run does not remember previous picks.

Arguments

  • None.

Returns: Undefined

WhisperNow()

Simple time helper for Whisper cooldowns and usage.

By default, this returns seconds since game start.

If manual ticking is enabled via WhisperTickManual(true), this returns the current manual tick counter. The counter is seeded to the current time (seconds since game start) the first time it is used, unless you explicitly set it with WhisperTickReset() or WhisperTickSet(num).

Arguments

  • None.

Returns: Real

WhisperPick(_ctx = undefined, _now = undefined, _filter = undefined)

Pick a storylet from the global storylet list (does not fire it).

Arguments

  • [_ctx] Struct,Undefined Context struct passed to predicates and hooks.
  • [_now] Real,Undefined Time value used for cooldown checks.
  • [_filter] Struct,Undefined Filter struct ({ tags_all, tags_any, tags_not, tags_prefer, prefer_weight, custom }).

Returns: Struct.__WhisperStorylet,Undefined

WhisperPickAndFire(_ctx = undefined, _now = undefined, _filter = undefined)

Pick and immediately fire a storylet (updates usage/cooldown).

Arguments

  • [_ctx] Struct,Undefined Context struct passed to predicates and hooks.
  • [_now] Real,Undefined Time value used for cooldown checks.
  • [_filter] Struct,Undefined Filter struct ({ tags_all, tags_any, tags_not, tags_prefer, prefer_weight, custom }).

Returns: Struct.__WhisperStorylet,Undefined

WhisperPickAndFireOr(_ctx = undefined, _now = undefined, _filter = undefined, _fallback_fn = undefined)

Pick and fire a storylet or call a fallback function when nothing matches.

Arguments

  • [_ctx] Struct,Undefined Context struct passed to predicates and hooks.
  • [_now] Real,Undefined Time value used for cooldown checks.
  • [_filter] Struct,Undefined Filter struct ({ tags_all, tags_any, tags_not, tags_prefer, prefer_weight, custom }).
  • _fallback_fn Function,Undefined Function called when no storylet matches.

Returns: Struct.__WhisperStorylet,Any,Undefined

  • Additional details:

    • _fallback_fn is only called when nothing matches. Signature: function() -> Any.

WhisperPickOr(_ctx = undefined, _now = undefined, _filter = undefined, _fallback_fn = undefined)

Pick a storylet or call a fallback function when nothing matches.

Arguments

  • [_ctx] Struct,Undefined Context struct passed to predicates and hooks.
  • [_now] Real,Undefined Time value used for cooldown checks.
  • [_filter] Struct,Undefined Filter struct ({ tags_all, tags_any, tags_not, tags_prefer, prefer_weight, custom }).
  • _fallback_fn Function,Undefined Function called when no storylet matches.

Returns: Struct.__WhisperStorylet,Any,Undefined

  • Additional details:

    • _fallback_fn is only called when nothing matches. Signature: function() -> Any.

WhisperPoolDebugQuery(_pool_id, _ctx = undefined, _now = undefined, _filter = undefined)

Debug a pool query (returns details about candidates and match results).

Arguments

  • _pool_id Any Pool identifier.
  • [_ctx] Struct,Undefined Context struct passed to predicates and hooks.
  • [_now] Real,Undefined Time value used for cooldown checks.
  • [_filter] Struct,Undefined Filter struct ({ tags_all, tags_any, tags_not, tags_prefer, prefer_weight, custom }).

Returns: Array<Struct>

WhisperPoolPick(_pool_id, _ctx = undefined, _now = undefined, _filter = undefined)

Pick a storylet from a pool (does not fire it).

Arguments

  • _pool_id Any Pool identifier.
  • [_ctx] Struct,Undefined Context struct passed to predicates and hooks.
  • [_now] Real,Undefined Time value used for cooldown checks.
  • [_filter] Struct,Undefined Filter struct ({ tags_all, tags_any, tags_not, tags_prefer, prefer_weight, custom }).

Returns: Struct.__WhisperStorylet,Undefined

WhisperPoolPickAndFire(_pool_id, _ctx = undefined, _now = undefined, _filter = undefined)

Pick and fire a storylet from a pool (updates usage/cooldown).

Arguments

  • _pool_id Any Pool identifier.
  • [_ctx] Struct,Undefined Context struct passed to predicates and hooks.
  • [_now] Real,Undefined Time value used for cooldown checks.
  • [_filter] Struct,Undefined Filter struct ({ tags_all, tags_any, tags_not, tags_prefer, prefer_weight, custom }).

Returns: Struct.__WhisperStorylet,Undefined

WhisperPoolPickAndFireOr(_pool_id, _ctx = undefined, _now = undefined, _filter = undefined, _fallback_fn = undefined)

Pick and fire a storylet from a pool or call a fallback function when nothing matches.

Arguments

  • _pool_id Any Pool identifier.
  • [_ctx] Struct,Undefined Context struct passed to predicates and hooks.
  • [_now] Real,Undefined Time value used for cooldown checks.
  • [_filter] Struct,Undefined Filter struct ({ tags_all, tags_any, tags_not, tags_prefer, prefer_weight, custom }).
  • _fallback_fn Function,Undefined Function called when no storylet matches.

Returns: Struct.__WhisperStorylet,Any,Undefined

  • Additional details:

    • _fallback_fn is only called when nothing matches. Signature: function() -> Any.

WhisperPoolPickOr(_pool_id, _ctx = undefined, _now = undefined, _filter = undefined, _fallback_fn = undefined)

Pick a storylet from a pool or call a fallback function when nothing matches.

Arguments

  • _pool_id Any Pool identifier.
  • [_ctx] Struct,Undefined Context struct passed to predicates and hooks.
  • [_now] Real,Undefined Time value used for cooldown checks.
  • [_filter] Struct,Undefined Filter struct ({ tags_all, tags_any, tags_not, tags_prefer, prefer_weight, custom }).
  • _fallback_fn Function,Undefined Function called when no storylet matches.

Returns: Struct.__WhisperStorylet,Any,Undefined

  • Additional details:

    • _fallback_fn is only called when nothing matches. Signature: function() -> Any.

WhisperPoolQuery(_pool_id, _ctx = undefined, _now = undefined, _filter = undefined)

Query eligible storylets inside a specific pool.

Arguments

  • _pool_id Any Pool identifier.
  • [_ctx] Struct,Undefined Context struct passed to predicates and hooks.
  • [_now] Real,Undefined Time value used for cooldown checks.
  • [_filter] Struct,Undefined Filter struct ({ tags_all, tags_any, tags_not, tags_prefer, prefer_weight, custom }).

Returns: Array<Struct.__WhisperStorylet>

WhisperQuery(_ctx = undefined, _now = undefined, _filter = undefined)

Query eligible storylets using the global storylet list.

Arguments

  • [_ctx] Struct,Undefined Context struct passed to predicates and hooks.
  • [_now] Real,Undefined Time value used for cooldown checks.
  • [_filter] Struct,Undefined Filter struct ({ tags_all, tags_any, tags_not, tags_prefer, prefer_weight, custom }).

Returns: Array<Struct.__WhisperStorylet>

WhisperResetAll()

Destroy and recreate all Whisper singletons (manager, verbs, inserts).

Arguments

  • None.

Returns: Undefined

WhisperSaySimple(_pool_id, _ctx = undefined, _lang = "en")

Pick and fire a line from a pool and resolve its text. Returns { id, text, events, data } or undefined.

Arguments

  • _pool_id Any Pool / track identifier.
  • [_ctx] Struct,Undefined Context struct (optional).
  • [_lang] String,Undefined Language code.

Returns: Struct,Undefined

WhisperSayTaggedSimple( _pool_id, _tags_any, _ctx = undefined, _lang = "en" )

Pick and fire a line from a pool using simple tag filters. Returns { id, text, events, data } or undefined.

Arguments

  • _pool_id Any Pool / track identifier.
  • _tags_any Array<String>,String,Undefined At least one of these tags must be present.
  • [_ctx] Struct,Undefined Context struct (optional).
  • [_lang] String,Undefined Language code.

Returns: Struct,Undefined

WhisperSayTextSimple( _pool_id, _ctx = undefined, _lang = "en", _fallback_text = undefined )

Pick and fire a line from a pool and return only the text.

Arguments

  • _pool_id Any Pool / track identifier.
  • [_ctx] Struct,Undefined Context struct (optional).
  • [_lang] String,Undefined Language code.
  • [_fallback_text] String,Undefined Fallback text when no line matches.

Returns: String,Undefined

WhisperSetRunId(_id)

Explicitly set the current run/session id.

Arguments

  • _id Real New run identifier.

Returns: Undefined

WhisperAddVerb(_name, _func)

Register a verb callback.

Arguments

  • _name String Verb name.
  • _func Function Callback taking (_ctx, _event).

Returns: Undefined

WhisperStateBuild()

Build a Whisper save payload (JSON-ready struct).

This is intended for embedding into your own save system.

Arguments

  • None.

Returns: Struct

WhisperStateClear(_reset_auto_ids = false)

Clear Whisper runtime state (usage counters, run state, tick state, and pool repeat suppression).

This keeps your storylets and pools; it only resets runtime counters/state.

Arguments

  • [_reset_auto_ids] Bool If true, resets the auto id counter used by WhisperLineSimple.

Returns: Undefined

WhisperStateLoad(_filepath = "")

Load Whisper state from a file in the sandbox (or a custom path).

If _filepath is "", this defaults to "whisper_state.json".

Arguments

  • [_filepath] String File path (relative to sandbox, or an absolute path on supported platforms).

Returns: Bool

WhisperStateLoadJSON(_json_data)

Load a Whisper save payload from JSON.

You can pass either a JSON string, or a struct (for example, produced by json_parse).

Arguments

  • _json_data String,Struct JSON string or parsed struct.

Returns: Bool

  • Additional details:

    • This restores runtime state only (usage counters, run id, tick state, and pool repeat suppression). It does not restore storylet content (text/tags/predicates), pool memberships, verbs, or insertions.
    • Loading merges into the current runtime state: entries not present in the payload are not removed.

WhisperStateSave(_filepath = "")

Save Whisper state to a file in the sandbox (or a custom path).

If _filepath is "", this defaults to "whisper_state.json".

Arguments

  • [_filepath] String File path (relative to sandbox, or an absolute path on supported platforms).

Returns: Bool

WhisperStorylet(_id)

Public factory to create or fetch a Whisper storylet.

Arguments

  • _id Any Storylet identifier.

Returns: Struct.__WhisperStorylet

  • Additional details:

    • The returned struct type is named __WhisperStorylet in code. Even though it has __ in the name, it is intended to be the public storylet handle you configure and fire.

Public methods

  • AddToPool(_pool_id): Add this storylet to the named pool.

    • Arguments:

      • _pool_id Any Pool identifier.

    • Returns: Struct.__WhisperStorylet

  • CanFire(_ctx, _now): Determine whether the storylet can currently fire.

    • Arguments:

      • _ctx Struct Context struct passed to predicate.
      • _now Real Current time value for cooldown checks.

    • Returns: Bool

  • DebugAvailability(_ctx, _now, _filter = undefined): Debug this storylet’s availability given context and filters.

    • Arguments:

      • _ctx Struct Context struct passed to predicates.
      • _now Real Current time value for cooldowns.
      • _filter Struct,Undefined Filter struct ({ tags_all, tags_any, tags_not, tags_prefer, prefer_weight, custom }).

    • Returns: Struct

  • Fire(_ctx, _now): Fire this storylet, running on_fire and updating usage/cooldown.

    • Arguments:

      • _ctx Struct Context struct passed to hooks.
      • _now Real Current time value for cooldowns.

    • Returns: Bool

  • HasTag(_tag): Check whether this storylet has a given tag.

    • Arguments:

      • _tag String Tag to look for.

    • Returns: Bool

  • SetAvoidImmediateRepeat(_flag = true): Avoid picking this storylet twice in a row (per pool).

    • Arguments:

      • [_flag] Bool,Undefined Enable/disable.

    • Returns: Struct.__WhisperStorylet

  • SetCooldown(_cooldown): Set cooldown duration (uses the same units as _now).

    • Arguments:

      • _cooldown Real Cooldown amount.

    • Returns: Struct.__WhisperStorylet

  • SetMaxUses(_max_uses): Set max total uses (ever). Use < 0 for unlimited.

    • Arguments:

      • _max_uses Real Max uses (< 0 means unlimited).

    • Returns: Struct.__WhisperStorylet

  • SetMaxUsesPerRun(_max_uses): Set max uses per run/session; < 0 for unlimited.

    • Arguments:

      • _max_uses Real Max uses per run (< 0 means unlimited).

    • Returns: Struct.__WhisperStorylet

  • SetOnAvailable(_func): Set hook called when the storylet is eligible during query.

    • Arguments:

      • _func Function,Undefined Callback signature: function(_ctx, _storylet).

    • Returns: Struct.__WhisperStorylet

  • SetOnFire(_func): Set hook called when the storylet fires (after selection).

    • Arguments:

      • _func Function,Undefined Callback signature: function(_ctx, _storylet).

    • Returns: Struct.__WhisperStorylet

  • SetOnResolved(_func): Alias for SetOnFire.

    • Arguments:

      • _func Function,Undefined Callback signature: function(_ctx, _storylet).

    • Returns: Struct.__WhisperStorylet

  • SetOnSelected(_func): Set hook called when the storylet is selected by a pick.

    • Arguments:

      • _func Function,Undefined Callback signature: function(_ctx, _storylet).

    • Returns: Struct.__WhisperStorylet

  • SetOnce(): Convenience: set max uses to 1 (ever).

    • Arguments:

      • None.

    • Returns: Struct.__WhisperStorylet

  • SetPredicate(_func): Set predicate function used for custom availability rules.

    • Arguments:

      • _func Function,Undefined Callback signature: function(_ctx) -> Bool.

    • Returns: Struct.__WhisperStorylet

  • SetWeight(_weight): Set base selection weight (must be > 0).

    • Arguments:

      • _weight Real New base weight.

    • Returns: Struct.__WhisperStorylet

  • SetData(_data): Set arbitrary user data on this storylet.

    • Arguments:

      • _data Any Data payload (any type).

    • Returns: Struct.__WhisperStorylet

  • SetDataCloned(_data): Set arbitrary user data on this storylet, cloned via variable_clone.

    • Arguments:

      • _data Any Data payload (any type).

    • Returns: Struct.__WhisperStorylet

  • GetData(): Get the user data stored on this storylet (may be undefined).

    • Arguments:

      • None.

    • Returns: Any

  • AddTag(_tag): Add a tag to this storylet.

    • Arguments:

      • _tag String Tag to add.

    • Returns: Struct.__WhisperStorylet

  • AddTagsArray(_tags_array): Add multiple tags (skips duplicates already present).

    • Arguments:

      • _tags_array Array<String> Tag list to add.

    • Returns: Struct.__WhisperStorylet

  • SetTags(_tags_array): Replace the entire tag array.

    • Arguments:

      • _tags_array Array<String> Tag list.

    • Returns: Struct.__WhisperStorylet

  • AddText(_string, _verb = undefined, _lang = "en"): Add text variation to the main body.

    • Arguments:

      • _string String Raw template string (may contain markers).
      • [_verb] String,Undefined Verb to trigger on completion.
      • [_lang] String Language code.

    • Returns: Struct.__WhisperStorylet

  • GetText(_lang = "en"): Convenience: get just the text of a random variation.

    • Arguments:

      • _lang String Language code.

    • Returns: String,Undefined

  • TextResolve(_lang = "en"): Resolve content to { id, text, events, data } for this storylet’s body.

    • Arguments:

      • _lang String Language code.

    • Returns: Struct,Undefined

WhisperTick(_dt)

Advance manual cooldown time by the provided tick amount (no-op unless manual ticking is enabled).

Arguments

  • _dt Real Tick amount (delta-time).

Returns: Real,Undefined

WhisperTickManual(_enabled)

Enable or disable manual ticking for WhisperNow().

When enabled, cooldown time only advances when you call WhisperTick(_dt).

Arguments

  • _enabled Bool If true, enable manual ticking.

Returns: Undefined

WhisperTickReset()

Reset the manual tick counter used by WhisperNow() to 0.

Arguments

  • None.

Returns: Undefined

WhisperTickSet(_num)

Set the manual tick counter used by WhisperNow() to an explicit value.

Arguments

  • _num Real New manual tick value.

Returns: Undefined

WHISPER_VERB.AddVerb(_name, _func)

Register a verb callback.

Arguments

  • _name String Verb name.
  • _func Function Callback taking (_ctx, _event).

Returns: Undefined

  • Additional details:

    • Verb callbacks run as function(_ctx, _event).
    • _event includes at least: name, position, trigger, meta.args.

WhisperVerbInsert(_name)

Build an inline verb marker string for the given verb name, but only if it’s registered. Returns “” if the verb isn’t registered.

Arguments

  • _name String Verb name.

Returns: String

WhisperVerbRunRange(_events, _from_pos, _to_pos, _ctx)

Run verb events whose positions fall between the previous and new cursor.

Arguments

  • _events Array<Struct> Events array from resolved text.
  • _from_pos Real Previous cursor position (exclusive lower bound).
  • _to_pos Real New cursor position (inclusive upper bound).
  • _ctx Struct Context passed to verb callbacks.

Returns: Undefined

  • Additional details:

    • This is mainly for typewriter text. As your cursor moves forward, call this to fire any verbs that were crossed.