Vamooses Companions

## [Unreleased]

================================================================================
Vamoose's Companion - Changelog
================================================================================

Version 1.1.0 (2026-04-07)

MODEL PIPELINE:
- Unified model loading pipeline following Blizzard's canonical pattern
  (destroy actor, fresh create, Hide -> Callback -> Load -> Show)
- Fixed model positioning bug on first load and companion/variant switching
- Fixed talking head model auto-fit (callback was being overwritten)
- Fixed portrait scale not applying to model on reload
- AutoFitActor now accounts for effective UI scale
- Portrait facing calculated upfront in opts (no post-callback overwrite)
- 5s login defer for clean ModelScene initialization

PORTRAIT FRAME STYLES:
- New Display setting: Classic / Ornate / Minimal
- Classic: Barbershop atlas frame (default)
- Ornate: Filigree portrait frame with parchment talking head and gold text
- Minimal: No frame, no bond pips, no mood wash
- Bond pips and mood bar adjust position per frame style
- Style persists across sessions

ORNATE TALKING HEAD:
- Custom toast frame at natural aspect ratio (600x255)
- Dark brown parchment text with warm shadow
- Larger model viewport with adjusted positioning
- NineSlice and drop shadow hidden in ornate/minimal modes

SETTINGS PANEL:
- Steampunk copper title texture replaces MORPHEUS font text
- Theme color swatches (VPP-style clickable chips with tooltip)
- New Info tab with Discord link, Buy Me a Coffee, and about text
- Forge-Background atlas on companion preview
- Sidebar simplified: name only (removed title, bond bar, mood)
- Sidebar preview cards: square, camera zoom for small creatures
- All fonts switched from Arial Narrow to Friz Quadrata
- Companion preview mood bar removed

THEME AWARENESS:
- 36+ new VC.Theme:Register() calls across Settings and Companion page
- New ThemeEngine skinners: DimText, AccentText, Separator
- Sidebar background, separators, labels all update on theme change
- Sidebar hover closures read scheme at call time (not build time)
- ColorblindSafe theme added (13 themes total)

QUOTE DATABASE:
- 75 rep "loss" quotes rewritten as "gain" (WoW has no rep decrease)

MODEL VARIANTS:
- Removed duplicate variants across all companions
- Removed toucan and mechanical parrot from Patches
- Patches portraitZ and toast scale tuned

Version 1.0.0 (2026-04-07)
--------------------------------------------------------------------------------

First public release.

COMPANIONS:
- 4 companions: Vamoose, Scurry, Gazlowe, Patches
- Each with a unique personality, chat color, theme accent, and 3D model
- Multiple model variants per companion with a browsable Model Viewer

REACTIVE QUOTE ENGINE:
- 30+ event types: boss kills, achievements, deaths, quests, gold, zones,
  level ups, housing milestones, M+ completions, pet battles, crafting,
  fishing, transmog, reputation, scenarios, and more
- 4-tier quote quality (common / uncommon / rare / epic / legendary)
- Weighted random selection with history deduplication
- Priority scoring and per-category cooldowns to prevent spam
- 4 chattiness levels (Minimal / Relaxed / Chatty / Maximum)
- Per-event-type toggles across 5 groups

TALKING HEAD DISPLAY:
- Cinematic popup with 3D companion model and typewriter text reveal
- Quality-tier visual effects (colored borders, sheen on epic/legendary)
- Click to dismiss or auto-hide after configurable duration
- Chat mode available as alternative (or both simultaneously)

ANIMATED PORTRAIT:
- Draggable portrait frame with live 3D companion model
- Context-aware animations: idle, walking, running, mounted, flying,
  swimming, combat, fishing, sleeping, AFK, and more
- Auto-facing toward screen center
- Bonding pips and mood ring on portrait border
- Scalable from 60% to 160%

BONDING SYSTEM:
- Rapport builds through gameplay (quests, boss kills, achievements, logins)
- 5 bond levels: Stranger, Acquaintance, Companion, Trusted, Soulbound
- Login streaks build rapport; absences apply gentle penalty
- Bond level-ups trigger special companion-specific quotes

MOOD TRACKING:
- Session mood influenced by gameplay (achievements boost, deaths lower)
- Visualized as color wash on portrait border

PORTRAIT FRAME STYLES:
- Classic: Barbershop atlas frame (default)
- Ornate: Filigree portrait frame with parchment talking head and gold text
- Minimal: No frame, no bond pips, no mood wash -- just the model
- Style applies to both portrait and talking head

SETTINGS PANEL:
- 4-tab layout: Companion, Display, Events, History
- Portrait Frame selector (Classic / Ornate / Minimal)
- Model variant browser with clickable grid
- Quote history with quality indicators and replay button
- Slipstream Dark theme

SLASH COMMANDS:
- /vc -- Show help
- /vc companion <name> -- Switch companion
- /vc mute / unmute -- Toggle muting
- /vc test [category] -- Fire test quote
- /vc status -- Show companion status

================================================================================