🌟 StreamSprite Settings

Configure your desktop pet, stats, and integrations

🔌 Integration offline

⚠️ Only loopback hosts (127.0.0.1, localhost) are allowed — Streamer.bot is local-only. Tunnel through tailscale/ssh and point this back at 127.0.0.1 if you need a remote bridge.

Found in StreamElements Dashboard → Account → Channel → Show Secrets

🐾 Pet

Folder name inside /assets/

Plays sounds from assets/<pack>/sfx/

📊 Stats

⌨️ Command Mappings

Commands/redeems that replenish stats. Quick-start a config for common Twitch flows below, or build your own mappings.

Quick-start templates (click to ADD; existing mappings preserved):

🐣 Care Companion

The personality, progression, and viewer-memory layers. Each toggle can be flipped independently — the pet still runs without them.

Wellbeing drives action choice, speed, emote palette.

Tracks per-viewer feed counts.

Show +30 💧 @user above the pet on each replenish.

Streamer click on the sprite → affection bump.

Egg → Baby → Adult, gated by cumulative care time.

Wake-up sequence after long absences.

Current stage: egg
Cumulative care time: 0 min · Bond level: 0 / 1000

Min seconds between top-caretaker shoutouts.

Bond gained when streamer clicks the pet.

Gap that triggers the wake-up ritual.

🧬 Personality

Four traits set on hatch that bias the pet's behavior. Auto-rolled the first time. Re-roll for a fresh personality, or fine-tune the dials manually.

Lazy ↔ energetic

Anxious ↔ confident

Homebody ↔ explorer

Quiet ↔ dramatic

🤝 The Friend
Traits: balanced · Day phase: afternoon

💭 Desires

Periodically the pet wants something — food, play, attention. Viewers satisfying a desire give a big mood boost. Unsatisfied desires expire and slightly drop the pet's bond.

No desire pending.

⚔️ Adventure Mode

The pet earns XP from being fed, clicks, and surviving drain ticks. It also embarks on adventures — short timed quests with XP and loot rewards. Crossing a level grants +2 max to every stat.

Pet leaves to adventure on its own when conditions are met.

Min cooldown between auto-adventures.

Level 1
0 XP · 0 total earned · 0 adventures (0 successful)

🌟 Favorite Stat

The pet has a hidden favorite stat. Replenishing it gives a 1.5× multiplier, a sparkle reaction, and bigger bond gain. After a few hits, the favorite is revealed in a news banner.

Hidden — feed every stat to discover
Hits so far: 0 · Reveal at: 5

👒 Wardrobe

Cosmetic accessories layered on top of the pet sprite. PNG art at assets/<pack>/accessories/<id>.png is used when available; otherwise the emoji fallback is drawn directly.

💬 Speech Phrases

Short text bubbles the pet "says" during idle time. Frequency scales with the pet's expressiveness trait.

Expressiveness multiplies this (0.5× for dramatic, 3× for quiet).

🏅 Milestones

Achievements that fire as news banners across the top of the overlay. Each milestone fires once, then is logged for reference.

🎬 Test Triggers

Sends a synthetic event to the open overlay tab so you can preview pet reactions, stat replenish flashes, and event alerts without going live. The overlay must be open in another tab for these to do anything.

⚙️ Advanced Settings

Timing

For "Rotate" display mode

For "On-Change" display mode

Stat Level Thresholds

Bar percentages that trigger each color/desaturation level. Defaults: high > 60, mid > 30, low > 10, critical ≤ 10.

Stat Animations

Chance for the pet to play an animation when stats change.

🩸 Drain % → wince, shiver
💀 Empty % → collapse, cry
✨ Gain % → cheer, sparkle

Structures (Walls & Scaffolding)

Walls are impassable. Scaffolding is permeable — the pet may pass through. Click two points on the canvas below to draw a line.

Custom Emote Bubbles

The pet shows these as thought bubbles. Place images in assets/<pack>/emotes/.

Settings saved!

Import preset?

What this changes