Character Reference Binding
1. Activation & Scope
- Status: Inactive by default.
- Activation Command: Activated strictly upon explicit user command (e.g., “Use character reference mapping”, “Bind actor references”, “Include multimodal character mapping”).
- Scope: Governs how reference tags (
@actor,@image,@audio) are assigned, bound to narrative personas, and structured within the script without contaminating downstream prompt blocks.
2. Reference Binding Syntax in [INTENT]
Bind multimodal assets directly to character personas exclusively in the opening definition:
- Format:
@actor1 as NAME, [brief profession / archetype / trait](or@image1 as NAME...) - Examples:
@actor1 as SAMIRA, an exhausted artist hiding deep depression@actor2 as FELIX, her gentle, reliable long-time friend@image1 as MARK (voice: @audio1), a frustrated junior mathematics professor
- Mandate: Always assign a concrete character name and a clear profession, archetype, or role to every referenced material.
3. Strict Scope Rule: Tag Isolation in [INTENT] Only
- Intent-Only Declaration: Use
@actor/@imagetags exclusively inside[INTENT]. - Downstream Usage: In all subsequent blocks—
[LOGIC],[AESTHETIC],[OPENING], and[EXECUTION]—refer to characters strictly by their established character names (e.g.,Samira,Felix,Mark,Robert). - Never Repeat Reference Tags: Never write
@actor1or@actor2inside[LOGIC],[AESTHETIC],[OPENING], or[EXECUTION]. Once bound in[INTENT], the name is the sole canonical identifier across the entire script.
4. Placement Standards
Reference declarations can be structured in one of two ways based on scene complexity:
Standard Approach (Inline in [INTENT])
For standard scenes (1–3 characters), embed bindings directly into the flowing introductory sentence of [INTENT]: [INTENT] Create a cinematic drama scene featuring @actor1 as SAMIRA, an exhausted painter, and @actor2 as FELIX, her loyal studio partner, inside a rain-soaked laundromat...
Dedicated Block Approach ([CHARACTERS] or [REFERENCES])
When directing large ensembles (4+ characters) or complex character sheets with distinct reference attributes, insert a dedicated block before [AESTHETIC] or [OPENING]:
[CHARACTERS]
@actor1 as EVAN: 30s explorer, weathered features, weary posture.
@actor2 as FELIX: 20s scholar, wire-rimmed glasses, gentle demeanor.
@image1 as THE BEAST: Colossal petrified skeletal stag with obsidian antlers.
(Even when using a [CHARACTERS] block, downstream blocks [LOGIC], [AESTHETIC], [OPENING], and [EXECUTION] must use only the character names Evan, Felix, The Beast).
5. Multimodal Assignment Rules
- One Explicit Role Per Material: Assign each reference material to exactly one narrative subject. Do not overload a single asset across multiple active characters.
- Cardinality Alignment: A single-person reference image must represent only one person on screen. Use multi-person references only when the reference image itself depicts an established group.
- Preserve User Reference Labels: Never alter user-supplied reference identifiers (e.g., if user writes
@actor1, preserve@actor1exactly). - Declaration of Unused Materials: If multiple reference assets are provided but only a subset are active in the scene, list unused assets under an
[Unused Materials]block or footnote to prevent downstream AI hallucination.
6. Directorial Integration & Reference Exhibits
- intent.md — Structural block specification for
[INTENT]and reference tag isolation. - block_rules.md — Open Block registry and optional
[CHARACTERS]block placement. - seedance25_dialogue_script.md — Verified production script demonstrating
@actor1 as SAMIRAand@actor2 as FELIXin production.