Skip to main content
unofficial.voyage wiki
Builder

AI

Character Background

The aiInstructions task that generates the player character's backstory and appearance during character creation.

Editor
AI Tasks → Character Background
Edit via
Graphical form (labeled textareas)
{
  "aiInstructions": {
    "generateCharacterBackground": {
      "prompt": "Write a character profile in two sections.\n\nBackground (6–8 sentences): Who they are now, where they're from, what shaped them, how they gained their abilities. End with forward momentum.\n\nAppearance (3 sentences): Height and build, coloration, one distinctive permanent feature. No clothing, gear, or interpretive language ('wise-looking', 'mysterious').",
      "custom": "## Tone\nHeroic optimism. Frame hardship as a source of strength. These are characters at the start of their story, not the end of it."
    }
  }
}

Fields

prompt

The full background generation prompt. Three states:

StateEffect
Omit promptUse the engine default
Set to your custom stringReplace the default wholesale
Set to " " (a single space)Disable the default without replacing it

custom

Appended AFTER prompt as additional guidance. Does not replace the default, regardless of what prompt contains.

What it does

This task generates the player character's backstory and appearance during character creation.

Legacy keys (backwards-compatible, do not use in new worlds): character_profile_generator, character_profile_background, character_profile_appearance, do_not_include, style, structure, context, final_notes. These are accepted by the engine for older worlds but should not be authored in new content.

Size limits

LimitValue
Each string leaf under a task (`aiInstructions.<task>.<key>`)5000
Per task (`aiInstructions.<task>` total, sum of instruction chars)20000

Related