Shadow Buddy

**ShadowBuddy is a tiny, squishy shadow companion that lives on your screen.** It blinks, watches your cursor, reacts to what happens in your game, chats in its own voice, wears silly hats and quietly tells you about mail, whispers and invites. Drag it anywhere, poke it, dress it up. It never gets in your way.

## Alive, not annoying

- Breathes, blinks, glances around and follows your cursor with its eyes.
- Reacts to the moments that matter and rests between reactions, so it never spams you.
- Falls asleep when you go AFK. Optional: hide when idle, and reduced motion.
- Squishy: drag it and it stretches like jelly. Poke it too often and it gets annoyed, then dizzy.

## Reacts to your adventures

- **Loot by quality:** a smile for common items, a cheer for green, blue stars for rare, purple confetti for epic and a jackpot for legendary.
- **Gold** turns its eyes into dollar signs.
- **Combat:** it swings its weapon (if it has one) when a fight starts and sighs with relief when you survive.
- **Death:** it holds up a cheeky sign, like "I'm with stupid", until you are back on your feet.
- **And more:** level-ups, quests, achievements, boss kills and wipes, dungeons, raids and battlegrounds, low health, long fights, new zones, inns, mounts and flight paths.
- **Mirrors your emotes:** /dance, /sleep, /cheer, /laugh, /cry, /flex, /bow, /shy, /eat, /drink, /salute and many more.

## So many feelings

Happy, in love, surprised, angry, dizzy, sleepy, sad and shy. Its eyes turn into hearts, stars, spirals or happy little arcs when the moment calls for it.

## It talks

- Over 850 lines in English (and as many in Turkish), written separately for three personalities: **Cheerful**, **Grumpy** and **Calm**.
- It never repeats a line until it has used them all.
- Choose how talkative it is: Quiet, Normal or Chatty.
- Morning, evening and night greetings, plus an optional break reminder every two hours.

## Keeps you posted

Friendly notification balloons with an icon, a title and buttons:

- New mail, whispers (showing the message text is optional) and your name in guild or group chat
- Ready checks and queue pops; group, duel and calendar invites
- Low durability (with a reminder at the repair vendor) and full bags

Turn each type on or off, hold notices until combat ends, and choose whether they play a sound.

## Dress it up

- **5 hats:** top hat, witch hat, cowboy hat, pirate hat and a rose ribbon
- **6 face items:** round spectacles, golden spectacles, druid half-moons, pirate eye patch, tinker goggles and spiked shades
- **4 capes, 5 belts and 4 weapons**
- Fine-tune the position, size and angle of every item.

**Friendship:** your buddy grows fond of you as you play together, pet it, play rock-paper-scissors, finish quests and earn achievements. New friendship levels (up to 20) unlock new items. Want everything right away? Turn on "Unlock every item".

## Make it yours

- Round dark hands, round white hands or painted gloves
- Eye size, spacing and shape, pupils, eyelashes, blush, brows and mouth
- Four balloon and sign themes: Parchment / wood, Dark iron, Royal red / gold and Soft
- A size slider with a live, real-size preview in the settings

## Getting started

- **Right-click** the buddy, or type `/shadowbuddy`, to open the settings.
- **Drag** it with the left mouse button to move it.
- Handy commands:
  - `/shadowbuddy show` and `/shadowbuddy hide`
  - `/shadowbuddy reset`
  - `/shadowbuddy scale 1.4`
  - `/shadowbuddy language enUS`, `trTR` or `auto`
  - `/shadowbuddy wardrobe` and `/shadowbuddy face`
  - `/shadowbuddy rps` for a game of rock-paper-scissors
  - `/shadowbuddy preview` for a little animation show

## For addon authors

ShadowBuddy has a public API, so your addon can make the buddy talk, react or ask a question:

```lua
local buddy = _G.ShadowBuddy
if buddy then
    buddy:Say("Hello from my addon!", 4)
    buddy:Play("cheer")
    buddy:Notify({source = "MyAddon", title = "Done!", text = "Your task is finished."})
    buddy:Ask("Start now?", {"Yes", "No"}, function(choice) end, {source = "MyAddon"})
end
```

You can also add your own accessories, skins and speech lines, and register your addon as a notification source so players can mute it in the settings.

## Languages

English and Turkish. "Auto" follows your game language and falls back to English.

## Feedback

This is the first public release. Bug reports and ideas are very welcome in the comments. If something breaks, turn on Lua errors with `/console scriptErrors 1` and include the error text.

## Credits

The Patrick Hand font is by Patrick Wagesreiter, used under the SIL Open Font License 1.1 (the licence is included with the addon).