Visual Novel Name Boxes: What to Show Before a Mystery Character Appears
A name box should follow what the current story path has established, rather than pull directly from a character's name in production notes. This fictional example tracks “Visitor → Clock Repairer → Shen Yan” in a name-box disclosure table that includes story triggers and dialogue history rules.
Introduction
An unknown character's name box should display a label supported by the story so far. A character appearing on screen means only that readers can see him, not that they know his name. Nor should the real name already entered in production notes automatically appear above his dialogue. One workable rule is to keep the internal identity fixed, update the visible label after an explicit introduction or identification event, and preserve the label shown with each line in the dialogue history.
Decide whose knowledge the name box reflects
Before writing the rules, decide what knowledge the name box draws on. This example uses information readers have received on the current path, excluding secrets known only to the author. If a work instead follows the protagonist's knowledge, you also need to check whether the protagonist heard the introduction. Either approach can work, but do not switch between them within a scene without explanation.
The characters, dialogue, and sequence below are an original, fictional teaching example. They are not a real user case, measured findings, a firsthand test log, or a DramaFork product feature, and they do not depend on a particular engine.
The scene takes place in a clock shop at night. Production notes identify the person outside as “Character A, Shen Yan, clock repairer.” Readers first hear a voice behind the door, then see him step into the light, and finally hear him introduce himself. The deliverable is a name-box disclosure table for this one character, not an explanation of why he is hiding his identity.
The internal identity connects the character to dialogue, character sprites, and story state. The current display label tells readers who is speaking. The two are related, but they need not be identical. Using the internal name as the default display value turns a production convenience into an unplanned identity reveal.
Record the three stages in a name-box disclosure table
Establish the visible evidence before filling in the label. Do not decide that stage two should say “Clock Repairer” and then assume readers have confirmed his occupation simply because he carries a toolbox.
| Internal identity | Current display label | Evidence available to readers | Change trigger | Label in dialogue history |
|---|---|---|---|---|
| Character A / Shen Yan | Visitor | Someone outside knocks and speaks; neither a name nor an occupation has been established | Enter this stage when he first speaks; entering the shop alone does not advance it | Lines from this stage retain “Visitor” |
| Character A / Shen Yan | Clock Repairer | The shopkeeper says in his presence, “This is the clock repairer I sent for,” clearly referring to the newcomer | After the shopkeeper's introduction has been fully presented, use this label from the newcomer's next line | Lines from this stage retain “Clock Repairer” |
| Character A / Shen Yan | Shen Yan | The newcomer introduces himself by saying, “My name is Shen Yan,” connecting that name to the person present | After the self-introduction has been fully presented, use this label from his next line | New lines use “Shen Yan”; earlier entries are not retroactively changed |
“Fully presented” here means the complete name information has reached the reader. Production must define exactly what counts as the end of a line. The self-introduction itself still appears under “Clock Repairer,” so the name box does not reveal the name before the dialogue does. Writing only “update during the introduction” is not precise enough: one person might change the label at the start of the introduction, while another waits until the next line.
When reusing this table, add the relevant scene and dialogue position for each change. If you cannot identify a specific line or clear event that supports the label, keep the previous stage. Facts revealed later cannot serve as evidence for what readers know now.
Follow the sequence from a voice behind the door to a self-introduction
The first line is “Visitor: Excuse me, is the clock shop still open?” The door has not opened, and the label does only the minimum needed to identify the speaker. After the protagonist answers, the person outside says, “I can wait a little.” The label remains “Visitor”; there is no need to change it to “Unfamiliar Voice” merely to create mystery.
If someone else speaks in between, there needs to be evidence connecting the returning voice to the earlier speaker. For example, narration might say, “The person outside the door picked up where he had left off,” while the name box continues to show “Visitor.” This establishes continuity of the speaker without revealing his name. If the voice is disguised and the narrative deliberately prevents readers from recognizing it, reusing the same label must not quietly confirm that the two voices belong to one person.
Next, he pushes the door open and steps into the light. His face is now visible, but the name box still reads “Visitor.” The shopkeeper says, “This is the clock repairer I sent for.” The newcomer replies, “Let me first see where the mechanism has stopped.” Only this reply uses “Clock Repairer.” His appearance and the introduction of his occupation are two adjacent events; only the latter supports this label change.
Third, he says, “I haven't introduced myself. My name is Shen Yan.” This line still uses “Clock Repairer.” The protagonist answers, “Mr. Shen, this way, please,” and his subsequent “Thank you” appears under “Shen Yan.” The protagonist's spoken form of address does not require the name box to change immediately to “Mr. Shen.” Forms of address in dialogue can reflect relationships, while the name box follows the stable wording agreed in the table.
If a branch skips the self-introduction, subsequent lines continue to use “Clock Repairer.” If another path has the shopkeeper say “Shen Yan” first and clearly identify him as the person being named, that line can be an independent trigger. There is no reason to mechanically wait for the self-introduction. The trigger checks whether the name has been connected to the person, not whether a fixed passage of dialogue has played.
Weigh the trade-offs of preserving earlier labels in the history
This example leaves earlier dialogue unchanged. When readers open the history after the reveal, the first line still says “Visitor,” the line about examining the stopped mechanism still says “Clock Repairer,” and only later lines say “Shen Yan.” This preserves the information readers had at each moment and makes it easier to check exactly when the identity was disclosed.
The cost is that one person has three labels in the history. For easier searching in a long work, you could separately design an explanation that becomes visible only after the reveal, such as “Visitor and Clock Repairer both refer to Shen Yan.” This is an additional reading aid. It should neither overwrite the original labels of earlier entries nor appear prematurely on a path where the name has not been revealed. Support for such a display would need to be implemented separately.
Another possible design is to standardize the labels in earlier history entries after the reveal. That choice should acknowledge how it changes the experience of rereading earlier scenes, and specify when it takes effect and which entries it affects. This example prioritizes revisiting the unfolding mystery, so it preserves the original labels. You cannot require the history to faithfully reflect what was known at the time while silently rewriting it with a name learned later.
When returning to a save or story position before the reveal, the current name box should also revert to the corresponding stage. Readers may personally remember the real name even though the current path has not introduced it; these two facts do not conflict. How the history is restored when going back should be defined alongside the scope of the work's dialogue history.
Use two counterexamples to check for disclosure errors
Counterexample one: the first line from behind the door appears directly under “Shen Yan.” Even if the dialogue does not state his name, the name box has already connected the voice to it. If readers have previously heard rumors about Shen Yan, they will make that connection earlier as well. The correction is to return to “Visitor,” unless the author explicitly intends the name box to reveal the name ahead of the dialogue.
Counterexample two: the name box still shows “???” after the self-introduction. Readers may take this to mean that the introduction was not accepted, the name is questionable, or the person still cannot be identified. If the story does not intend any of these implications, update the label according to the table. Displaying a self-reported name does not guarantee that it is the character's real name. If an alias is involved, write a separate correction trigger; do not treat a character's statement as identity verification.
Before handing off the work, check the dialogue line by line along three paths: the normal introduction, a skipped introduction, and a return to before the introduction. For each, verify where the current label gets its support, which line begins the change, and whether earlier history entries follow the agreed rules. Then hide the internal identity column and read only the scene text. Any label that can be explained only through production notes needs to revert to the previous stage or receive supporting evidence in the story.
