Random Character Entry and Exit Cue Plan Generator

Description

Build fictional cast-presence traces with exits before entries, role-doubling checks, simultaneous performer limits, and complete cue ledgers.

A structured creative brief combines a supplied bank of fictional material with explicit sequencing, timing, or compatibility rules. IDs and tags make those constraints inspectable; they do not assess the artistic meaning or quality of a scene.

Build fictional cast-presence traces with exits before entries, role-doubling checks, simultaneous performer limits, and complete cue ledgers.

When to use this tool

Use this generator to create reproducible character exit entry cues cases from the supplied model or bank. Inspect the returned evidence before using cases in a test or exercise.

How to use the tool and how it works

Supply cast, scenes, maximumSimultaneousPerformers in the field shapes below. Set seed when you need an explicit replay.
Run the tool and correct any input error. For generated controls, distinguish a successful fixture containing an invalid case from failure to generate the fixture.
Read scenes, finalPresence, rehearsalGroups. Use the conventions below. Keep answer-bearing fields separate when presenting an exercise.

Validate each scene's role cast against simultaneous performer capacity and actor double-booking. At every transition, shuffle and apply required exits before entries, returning present-role snapshots, scene cues, and final presence.^[1]

Input field	Meaning and units	Accepted input
cast	Cast	Required. Array of Object; no unknown keys.; minimum items 1; maximum items 32.
cast[].roleId	Role Id	Required. Text; minimum UTF-16 length 1; maximum UTF-16 length 64.
cast[].performerId	Performer Id	Required. Text; minimum UTF-16 length 1; maximum UTF-16 length 64.
scenes	Scenes	Required. Array of Object; no unknown keys.; minimum items 1; maximum items 32.
scenes[].id	Literal identifier used independently of display labels.	Required. Text; minimum UTF-16 length 1; maximum UTF-16 length 64.
scenes[].requiredRoleIds	Required Role Ids	Required. Array of Text; minimum UTF-16 length 1; maximum UTF-16 length 64.; minimum items 0; maximum items 32.
maximumSimultaneousPerformers	Maximum Simultaneous Performers	Required. Safe integer; minimum 1; maximum 32.
seed	Optional numeric seed; takes precedence over context randomness. Without either, use the fixed tool.io default seed.	Optional. Safe integer.

Output field	Interpretation	Returned shape
scenes	Scenes	Required. Array of Object; no unknown keys.; minimum items 1; maximum items 32.
scenes[].sceneId	Scene Id	Required. Text; minimum UTF-16 length 1; maximum UTF-16 length 64.
scenes[].before	Before	Required. Array of Text; minimum UTF-16 length 1; maximum UTF-16 length 64.; minimum items 0; maximum items 32.
scenes[].cues	Cues	Required. Array of Object; no unknown keys.; minimum items 0; maximum items 64.
scenes[].cues[].kind	Kind	Required. Text; one of "exit", "enter".
scenes[].cues[].roleId	Role Id	Required. Text; minimum UTF-16 length 1; maximum UTF-16 length 64.
scenes[].cues[].performerId	Performer Id	Required. Text; minimum UTF-16 length 1; maximum UTF-16 length 64.
scenes[].cues[].presentAfter	Present After	Required. Array of Text; minimum UTF-16 length 1; maximum UTF-16 length 64.; minimum items 0; maximum items 32.
scenes[].after	After	Required. Array of Text; minimum UTF-16 length 1; maximum UTF-16 length 64.; minimum items 0; maximum items 32.
finalPresence	Final Presence	Required. Array of Text; minimum UTF-16 length 1; maximum UTF-16 length 64.; minimum items 0; maximum items 32.
rehearsalGroups	Rehearsal Groups	Required. Array of Array of Text; minimum UTF-16 length 1; maximum UTF-16 length 64.; minimum items 1; maximum items 4.; minimum items 1; maximum items 8.
randomness	Replay source and normalized 32-bit seed, or null seed for an advancing context source.	Required. Object; no unknown keys.
randomness.seed	Optional safe-integer replay seed; normalization and precedence are explained below.	Required. Safe integer. or Null.
randomness.source	Source	Required. Text; one of "context", "seed".

An explicit safe-integer seed takes precedence over injected context randomness and is normalized to an unsigned 32-bit integer. With no seed and no context source, replay uses the fixed tool.io default seed. A context source must return finite values from zero inclusive to one exclusive; its advancing state must be retained separately. randomness records the source and normalized seed, or null for context. These generators are not cryptographic random sources.

json

{
  "input": {
    "cast": [
      {
        "roleId": "m",
        "performerId": "a"
      },
      {
        "roleId": "i",
        "performerId": "b"
      }
    ],
    "scenes": [
      {
        "id": "s1",
        "requiredRoleIds": [
          "m"
        ]
      },
      {
        "id": "s2",
        "requiredRoleIds": [
          "i"
        ]
      }
    ],
    "maximumSimultaneousPerformers": 1,
    "seed": 42
  },
  "output": {
    "scenes": [
      {
        "sceneId": "s1",
        "before": [],
        "cues": [
          {
            "kind": "enter",
            "roleId": "m",
            "performerId": "a",
            "presentAfter": [
              "m"
            ]
          }
        ],
        "after": [
          "m"
        ]
      },
      {
        "sceneId": "s2",
        "before": [
          "m"
        ],
        "cues": [
          {
            "kind": "exit",
            "roleId": "m",
            "performerId": "a",
            "presentAfter": []
          },
          {
            "kind": "enter",
            "roleId": "i",
            "performerId": "b",
            "presentAfter": [
              "i"
            ]
          }
        ],
        "after": [
          "i"
        ]
      }
    ],
    "finalPresence": [
      "i"
    ],
    "rehearsalGroups": [
      [
        "s1",
        "s2"
      ]
    ],
    "randomness": {
      "seed": 42,
      "source": "seed"
    }
  }
}

Limitations and assumptions

Roles unchanged across scenes remain present. Final actors are not automatically exited after the last scene. This is symbolic cue bookkeeping rather than movement paths, quick-change feasibility, or physical stage-safety planning.
A replay requires the same complete input and implementation. The stated sampling convention applies within its eligible space. A finite draw does not exhaust all possible outputs; repeats remain possible unless a distinct-selection rule is explicit.
The field tables state structural bounds; cross-field constraints and bounded search or output budgets also apply. Unknown keys are rejected where the object contract disallows them. Input errors are distinct from null fields and deliberate invalid controls in a successful output.

Alternative or Complementary methods

For a supplied example, inspect the returned construction or delegated check directly. To evaluate a consumer, also test cases chosen for its own boundaries; a generated finite corpus does not establish exhaustive coverage.

References

Tool behavior and example: Random Character Entry and Exit Cue Plan Generator — tool.io

Similar or alternative tools

Random Character Objective Conflict Matrix Generator
Assign distinct supplied fictional objectives and construct a symmetric conflict matrix from explicit incompatibility tags and caller-provided resolutions.
Random Character Relationship Web Generator
Generate a fictional symmetric relationship graph from supplied characters with exact edge count, degree bounds, and optional connectivity using bounded search.