Home Guide GitHub

Companion Avatar

Your interactive animated companion with speech bubbles, triggers, and AI features

Overview

The Companion Avatar is an animated character that provides interactive feedback, displays speech bubbles, and can react to your activities. It can be attached to the main window or float freely on your screen.

💬
Speech Bubbles

Interactive messages

🔄
Detachable

Float freely anywhere

âš¡
Trigger Mode

Random trigger phrases

🤖
AI Chat

Patreon feature

Avatar Features

Detachable Sprite

The avatar can be detached from the main window to float freely:

  • Right-click the avatar to access the context menu
  • Select Detach to make it float freely
  • Drag the detached avatar to any position on any monitor
  • Select Attach to reattach it to the main window

Speech Bubbles

The avatar displays speech bubbles in response to various events:

  • Idle chatter - When you've been away
  • Activity reactions - Context-aware with Window Awareness (Patreon)
  • Trigger phrases - In Trigger Mode
  • AI responses - When chatting (Patreon)
💡 Dismissing Bubbles

Click on any speech bubble to dismiss it immediately.

Companions

Choose from multiple companions, each with unique bonuses and personalities. Companions have their own levels that increase as you use them.

Companion Unlock Level Bonus
Synthetic Blowdoll Level 50 +XP based on Pink Filter opacity - the pinker, the faster!
Perfect Fuckpuppet Level 100 +50% XP when Takeover Mode triggers actions
Brainwashed Slavedoll Level 125 Drains 5 XP/minute - can you outpace it?
Platinum Puppet Level 150 -50% XP without Strict, +100% with No Escape, -25 XP on attention fail
💡 Companion Levels

Each companion has their own level (max 100). XP earned only goes to your currently active companion. Switch companions to level them all!

AI Personalities (Prompts)

Customize how your AI companion behaves and speaks using community prompts. Each companion can have a different personality assigned.

Installing Prompts

  1. Go to Settings → AI Settings
  2. Click Browse Community Prompts
  3. Select and install prompts you like
  4. Click Activate to use a prompt

Assigning to Companions

Each companion can have its own AI personality:

  1. Go to the Companion tab
  2. Find the companion you want to customize
  3. Click the 🎭 (Personality) button
  4. Select a prompt to assign
💡 Auto-Switch

When you switch companions, the app automatically activates their assigned personality prompt. No need to manually switch!

Creating Custom Prompts

You can create your own personality prompts:

  1. Click Create New Prompt in AI Settings
  2. Give it a name and description
  3. Write your system prompt (defines how the AI behaves)
  4. Save and activate

Available Prompt Types

Type Description
Strict Domme Commanding and demanding personality
Chaotic Gremlin Playful, mischievous, unpredictable
Gentle Guide Soft, encouraging, supportive
Custom Create your own unique personality!

Context Menu

Right-click the avatar to access quick options:

Option Description
Detach/Attach Toggle floating mode
Trigger Mode Enable random trigger phrases
Random Bubble Enable random floating bubbles
Slut Mode Enable explicit AI responses (Patreon)
Mute Avatar Silence speech and sounds
Mute Whispers Mute subliminal audio
Pause Browser Pause browser audio/video
Chat with Bambi Open AI chat (Patreon)
Dismiss Avatar Hide the avatar

Trigger Mode

Trigger Mode displays random conditioning phrases at set intervals.

Setting Description
Enable Trigger Mode Show random trigger phrases
Trigger Interval Seconds between triggers (10-600s)
Edit Triggers Customize trigger phrases

How It Works

  1. Avatar displays random trigger phrases from your list
  2. If Audio Whispers is enabled, matching audio clips play
  3. Audio files should be in Resources/sub_audio/ named to match triggers
🎯 Trigger + Audio

For the trigger "Good Girl" to play audio, place a file named GOOD GIRL.mp3 in Resources/sub_audio/

Avatar Interactions

Action Result
Single Click Dismiss speech bubble
Double Click Open AI Chat (if enabled, Patreon)
Right Click Open context menu
Drag (detached) Reposition avatar
20 Rapid Clicks Unlock "Neon Obsession" achievement!

Companion Settings

Access the Companion tab for detailed settings:

Companion Settings

Setting Description
Show Companion Toggle avatar visibility
Detach Float avatar freely on screen
Idle Giggle Interval Seconds between idle messages (60-600s)

Quick Controls

Control Description
Mute Avatar Silence avatar speech and sounds
Mute Whispers Toggle subliminal audio on/off
Pause Browser Pause all browser audio/video