HomeSoul v0.1.0 — Beta
Part of the HomeSuiteHome suite by Blodwedd Mallory
===============================================================================

QUICK START
-----------
1. Mark tab: name your mark, choose Emote or Toy, set your timing.
2. Click Start Mark, walk to the spot in-world, click Place Here.
3. Soul tab: your mark is live. Pause, clone, or delete any time.


THE TWO MARK TYPES
------------------
EMOTE MARKS — shown with a gold square on the Soul tab.
Choose from the dropdown (Bed - sleep, Bar - drink, etc.). The emote
fires automatically when you walk into the mark radius.

TOY MARKS — shown with a green square on the Soul tab.
Choose a toy from your collection. On zone entry a prompt appears:
Use [Toy Name]? Click Yes to fire it. WoW requires a direct player
click for toy use — HomeSoul cannot fire toys automatically.
The prompt auto-dismisses in 10s and is suppressed if the toy is
on cooldown.


TIMING MODES
------------
LOOP    Holds one pose continuously — sleeping in a bed, sitting in a chair.

TIMER   Repeats on a clock — every N seconds, optionally stopping after
        N fires. Use Fires + interval for a multi-emote burst on entry.

ONCE    Fires the first time you enter the zone per session, then stays
        quiet until you reload or re-enable it.


SOUL TAB — MANAGING YOUR MARKS
-------------------------------
The Soul tab is your mark list. Each row shows the mark name, a type
swatch (gold = emote, green = toy), and timing mode.

Checkbox:  Pause a mark without deleting it. Paused marks stay saved
           but won't fire until re-enabled. Paused rows dim automatically.

Clone:     Duplicate a mark and re-place it at a new location.

Del:       Permanently removes the mark.

Filter bar: All / Emotes / Toys to narrow the list.
Overview bar: shows total active and paused counts.


FLAVOR TEXT
-----------
Optional /me text that fires alongside the mark trigger.
Works for both emote and toy marks.
By default fires once per zone entry even if Fires > 1.
Check Repeat to send the flavor text with every fire in the burst.


TOY PICKER
----------
Favorites Only (Options tab): the picker shows only toys you have
hearted in your Toy Box.
If the list is empty: open your Toy Box, heart the toys you want
to use, then re-open the picker. Uncheck Favorites Only to see all.


TROUBLESHOOTING
---------------
Toy picker is empty:
  Toy data may not be cached yet. Try /reload and check again.

Marks not firing:
  Confirm you are in your own home instance. HomeSoul only fires
  marks when you are the housing owner.

Toy prompt doesn't appear:
  Check that the mark is enabled (checkbox on the Soul tab) and
  that you entered the zone radius.


COMING SOON
-----------
- Chained emote sequences (eat > drink > eat...)
- Guest broadcasting — marks and flavor text visible to visitors
- Polygon zone shapes for room boundaries


COMMANDS
--------
/homesoul   open or close this window
/hs         same


===============================================================================
HomeSoul is in active beta. Feedback welcome.
                                                                         