Settings

Settings

Edit tabs/settings.json.

Power Level Framework

Characters progress through four power levels based on skill proficiency:

The balanced values below support this progression curve.

Required Fields by Category

Attribute Settings

Skill Settings

Skill XP Rewards

Location Settings

Item Settings

Combat Settings

NPC Health (otherSettings)

Player HP scaling lives on the health resource (resourceSettings.health.maxValue and gainPerLevel), not in otherSettings. See the ai-instructions skill for the Resource schema.

Character Progression (progressionSettings)

Required section. Character XP and level-up configuration lives here (legacy configs with XP fields in otherSettings migrate automatically).

All numeric fields must be positive whole numbers except extraRequiredXPPerCharacterLevel (non-negative).

World-Specific Fields

These must be configured per-world:

worldVoices

Optional record of voice presets keyed by an id you choose. Each preset pairs a display label with one of the character voice tags (voiceTag), plus optional delivery instructions, a speed, and audio effects. NPCs and premade characters point at a preset with worldVoiceId; the id must exist in worldVoices. Set exposeInCharacterCreation: true on presets players may pick for their own character at character creation; presets without it can still be assigned to NPCs and premades.

effects is a partial object of sub-effects (pitch, reverb, echo, eq, distortion, output), each with an enabled flag plus its own parameters. Omit any sub-effect you do not use. The engine trims labels and tags and clamps out-of-range values (speed to 0.5-2, pitch to -12..12 semitones, mixes to 0-1, and so on), and the catalog size is capped, so keep the list to voices the world actually uses.

lowAttributeTraits Format

Each entry follows this structure: "You have a weak [domain]. [What skill types this affects]. [Effect on learning and usage]."

• Sentence 1: State the weakness plainly ("You have a weak X")
• Sentence 2: Name the skill types powered by this attribute and state the consequence
• Sentence 3: Describe the practical effect on learning and reliability
• Reference skill/ability type names, not individual skill names
• Not every attribute needs an entry; omit attributes where a low value doesn't make narrative sense

Schema

interface Settings {
  attributeSettings: AttributeSettings
  skillSettings: SkillSettings
  locationSettings: LocationSettings
  itemSettings: ItemSettings
  combatSettings: CombatSettings
  otherSettings: OtherSettings
  progressionSettings: ProgressionSettings
  characterCreationMusic?: 'fantasy' | 'nonfantasy'
  imageModelSource?: 'falai-gpt-image-2-low' | 'falai-gpt-image-2' | 'google-nano-banana-lite' | 'google-nano-banana-pro' | 'falai-flux-2-dev'
  worldVoices?: Record<string, WorldVoice>
}

interface OtherSettings {
  npcHealthPerLevel: number
  npcMinHealth: number
  visualNovelModeByDefault?: boolean
}

interface WorldVoice {
  label: string
  voiceTag: string
  instructions?: string
  speed?: number
  effects?: {
    pitch?: { enabled: boolean, semitones: number }
    reverb?: { enabled: boolean, space: 'room' | 'hall' | 'cavern', mix: number }
    echo?: { enabled: boolean, delayMs: number, feedback: number, mix: number }
    eq?: {
      enabled: boolean
      highPass: { enabled: boolean, frequency: number }
      lowShelf: { enabled: boolean, frequency: number, gainDb: number }
      bell1: { enabled: boolean, frequency: number, gainDb: number, q: number }
      bell2: { enabled: boolean, frequency: number, gainDb: number, q: number }
      highShelf: { enabled: boolean, frequency: number, gainDb: number }
      lowPass: { enabled: boolean, frequency: number }
    }
    distortion?: { enabled: boolean, drive: number }
    output?: { enabled: boolean, gainDb: number, compressor: boolean }
  }
  exposeInCharacterCreation?: boolean
}

Reference

For detailed documentation, see settings-reference.md.