Visual Novel › World

Characters

A character is one cast member: a name, a set of sprites, a way of speaking, and a bag of numbers that the story changes. This page covers everything you author on a character. It does not cover what they say — that is Dialogue and stage.

Creating a character

Two ways, same result:

  • Create > Beasty VN > Characters > Character Definition in the Project window.
  • Open Tools > Beasty VN > Editor, go to the Characters tab, Cast sub-tab, and press + New Character. This is the way you will normally use, because the character is added to the shared context for you.

The Characters tab is also available on its own through Tools > Beasty VN > Content > Character Database. It has four sub-tabs: Cast (identity, aliases, expressions, delivery styles, portraits), Variables (stats), Quests and Talk Menu. The list and the selected character stay side by side at any window width, with a divider you drag; its width is remembered.

The Characters tab, Cast sub-tab, with a character selected

Identity

The identity block of a character: id, display name, colours, category and tags

FieldWhat it is
IdThe stable name the whole engine uses (maya). Auto-filled from the asset name as a lower-case slug, and editable.
Display nameThe name the player reads. Plain text, not translated. It may contain [tokens].
Name colorThe accent colour of the nameplate.
Text colorThe default colour of this character’s body text. A delivery style (below) can override it.
Player can renameIf on, the player may rename this character at runtime, and their name wins over yours.
CategoryMain or Secondary. Groups the cast in the editor.
TagsFree-form labels (feminine, a faction, a chapter). They group and filter the cast list in the editor. Add them with + Tag.

The id is what everything else points at: blocks, conditions, quests, routines. The display name is only presentation, and it can change during the game. Rename the id and the editor cascades the rename; see Validation and ids.

Note The display name is NOT translatable, on purpose. It is the character’s name. If it must differ by language, put a [token] in it and set the token per language, or use the Character name block described below.

Expressions and portraits

Two separate sprite sets, because they are two different pictures.

The expressions and portraits lists, sharing their keys

  • Expressions are the stage sprites — the full body or bust the player sees on the backdrop. Add them with + Add expression: it asks for a name — happy, sad, angry, whatever you want; there is no fixed list — and then whether the expression is a Single sprite or Layered. A layered expression is built from parts in the Expression Composer; see Layered expressions.
  • Portraits are the small UI icons shown next to the dialogue box. Add them with + Add portrait. They use the same keys as the expressions, so a sad line can show a sad head icon.

The default expression

The first expression in the list is the character’s default, whatever its name, Single or Layered. Its row is tagged default. To choose another, use the row’s ⋮ menu: Make default, Move up, Move down.

The default expression is used wherever no expression is named, or the named one does not exist: a Show character block with no expression, a block naming a missing expression, and the character’s spots in free roam. The fallback chain:

expression asked for  ->  default expression (first in the list)
portrait asked for    ->  first portrait  ->  no portrait

The first portrait stands in for every expression without one of its own. A character with no portraits at all speaks without one: the dialogue box hides the portrait panel.

Clothes

Wardrobe…, under the expression list, opens the character’s wardrobe: the clothes they can wear on top of layered expressions. See Wardrobe and outfits.

Delivery styles

A delivery style is how a character sounds when they are in a particular state. Add one with + Add delivery style and pick the state it applies to.

A delivery style with its font, colour, size multiplier and text effect

The built-in states are Normal, Whisper, Shout and Thinking. You may type any other key you like and use it as the delivery state on a Dialogue block; there is nothing special about the four built-ins.

Each style sets:

SettingEffect
FontThe TextMeshPro font used for this state. Empty = the default TMP font.
Override text color + Text colorForce a body-text colour for this state instead of the character’s default.
Font size multiplierMultiplies the body font size. 1 = unchanged, 1.3 = shouting.
Name prefix / Name suffixDecorate the nameplate for this state, e.g. a suffix of " (thinking)".
Text effectAn animated decoration on the body text: None, Wave, Shake, Fade or Pulse.

Anything you leave alone falls back to the character’s own defaults. A character that defines no style for a state speaks normally in it — you never have to fill in all four.

Aliases: showing a different name

An alias is another name for the same character. Use it when the player does not know who they are talking to yet.

A character's alias list

Add aliases with + Add alias — they are plain strings (“The Stranger”, “The Voice”). Then:

  • For one line only: on a Dialogue block, set its display-name alias. The nameplate reads “The Stranger” for that line and nothing else changes. The character’s id, variables and sprites are untouched. In the text script this is maya as "The Stranger" "...".
  • For good: use the Character name block (palette category State). It changes the displayed name from that point on, and the change is saved and rewinds like any other state.

The Character name block takes the new name from one of four sources:

SourceUse it for
AliasPromote one of the character’s aliases to be their name from now on.
TextA name you type. Optionally a localization key instead of plain text.
VariableThe current value of a variable or dictionary token — for example a name the player typed.
Reset to baseDrop the override and go back to the display name on the asset.

The reveal (“the stranger was Maya all along”) is therefore a single block: Character name -> Reset to base.

To let the player name a character themselves, use the Ask -> character name block (palette category Input). It shows a question and an input field, and stores the answer as that character’s name.

Character variables (stats)

A character variable is a number or a flag the character carries: affection, met, trust. They come from two places, and a character has both:

The Variables sub-tab: universal schema fields and this character's own

  1. The Character Variable Schema — the fields every character has. One asset per project (Create > Beasty VN > Characters > Character Variable Schema). Declare affection there once and the whole cast has it. Edit it in Characters › Variables › Global, under + Add universal field.
  2. The character’s own fields — declared on that one character, in Characters › Variables › Per character › Own fields. Use these for things only this character has.

Characters › Variables has two tabs. Global holds what applies to every character: the project’s Enable walkthrough switch, the universal fields, and the default visibility of the character list. Per character lists the cast beside the selected character’s three pages: Own fields, Global field defaults (this character’s overrides of the universal fields) and Character list. The split is visual only: nothing is stored differently. The tab and divider widths are remembered.

Every field has:

FieldWhat it does
KeyThe field name, no brackets: affection.
TypeInt counter, Float value or Bool flag.
Default valueThe starting value, before anything sets it.
Show on statsShow this field on the character’s stats screen. Off by default.
Display nameThe name the player reads for this field — on the stats screen, in notifications and in hints. Empty = the key. Translated in Localization › Game UI. Shown while any of Show on stats, Notify changes in gameplay or Show in walkthrough is on.
Notify changes in gameplayShow a stat notification when the value changes during play. Off by default.
Show in walkthroughGive this field automatic walkthrough hints on choices. Off by default.
EditableLet the player change it from the stats screen (+/- for numbers, a toggle for bools). Off = read-only.
Clamp + Min / MaxKeep the value inside a range when the player edits it.
StepHow much each +/- press adds or subtracts.

Every presentation flag starts off. A new field is game state first; putting it in front of the player is a decision you make on purpose.

Overriding a schema default for one character

Everyone starts at affection = 0, but Maya starts at 10 because she is your sister. You do not need a second field for that. In the character’s Variables sub-tab, override the universal field’s default value for this character only, in Per character › Global field defaults. You can also override, for this character, whether that one field shows on the stats screen, notifies changes and shows in the walkthrough, without touching the schema.

Changing a character variable from the story is the Character variable block (palette category State): pick the character, pick the field, pick the operation. Reading one in a condition is maya.affection > 5. Both are explained in Variables and conditions.

The free-roam sprite

The free-roam sprite field, with the show-location and show-routine toggles

The Free Roam Sprite field holds the sprite used when the character stands in a room, placed there by their routine. Leave it empty and the character’s default expression is used instead; when that expression is layered, the room shows its layered look. Where they stand and how big they are is decided by the room prefab, not here — see Character routines.

Two related toggles control what the player may see about the character’s whereabouts:

  • Show current location — show the room the character is in right now on their stats screen.
  • Show routine — allow opening this character’s routine calendar.

Appearing in the cast list

The in-game cast list is an overlay screen listing the characters the player has met. Two settings decide who is on it:

  • Listed — off means this character is never listed, whatever any condition says. Use it for a character the player is never meant to browse.
  • Shown when — a condition. By default every character uses one shared condition, written once with the @self placeholder: a condition of @self.met == true reveals each character as soon as their own met flag is set. Turn on the per-character override to give one character its own condition instead — a story-critical villain who appears only after chapter 3, for example.

An empty condition means “always shown”. @self is explained in Variables and conditions, and the screens themselves in Character screens.

The talk menu

Each character has a talk menu: the list of things the player can say to them right now. It is authored in the Characters > Talk Menu sub-tab, and the quest steps that point at this character are added to it automatically, and the menu ends with a Leave option. See The talk menu.

See also