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

QUICK START
-----------
1. Mark tab: name your mark, choose a type (Emote, Toy, Consumable, or Chain).
2. Set your timing mode (Loop, Timer, or Once).
3. Click Start Mark, walk to the spot in your house, click Place Here.
4. Soul tab: your mark is live. Pause, clone, or delete any time.


MARK TYPES
----------
EMOTE MARKS — gold square on the Soul tab.
Choose an emote from the dropdown (sleep, drink, dance, etc.). Fires
automatically when you walk into the mark radius.

TOY MARKS — 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.

CONSUMABLE MARKS — orange square on the Soul tab.
Like toy marks, but for food, drinks, and other usable items.
Prompts on zone entry the same way toy marks do.

CHAIN MARKS — purple square on the Soul tab.
A sequence of emotes, toys, or consumables with configurable delays
between each step. Use chains for complex multi-action sequences
like a full meal routine or an arrival ritual.


TIMING MODES
------------
LOOP    Holds one pose continuously — sleeping in a bed, sitting in a chair.
        Fires every 30 seconds while you stay in the zone.

TIMER   Repeats on a clock — fires N times, X seconds apart, then stops
        until next zone entry. Use for multi-emote bursts.

ONCE    Fires once per zone visit. Re-triggers each time you leave and
        re-enter the zone radius.


AREAS TAB — ROOM BOUNDARIES
----------------------------
Areas give each mark a spatial home to prevent bleed (marks firing in
the wrong room). Each area represents a room or named space in your house.

Default areas are provided (Bedroom, Kitchen, Living Room, etc.). You can
rename, delete, and add your own.

Drawing a boundary:
  Polygon — walk each corner of the room and click Add Point (minimum 3).
             Click Close Polygon when done.
  Radius  — stand at the room center, click Set Center. Walk to the nearest
             wall, click Set Edge Point. Click Save.

Floor assignment:
  Select the floor your room is on. Click + Add Floor to add floors beyond
  the default two. The floor setting is required for accurate boundary
  detection in multi-floor houses.

Boundaries are shown as subnotes under each area name:
  "No boundary defined"
  "Polygon - 6 points, Floor 1"
  "Radius - 4.4 yds, Floor 1"

To edit a boundary, click Edit on the area and redraw it.
Note: area detection (firing marks only when inside a boundary) is coming
in the next update. Boundaries set now will be active automatically when
the feature ships.


SOUL TAB — MANAGING YOUR MARKS
-------------------------------
The Soul tab is your mark list, organized by area. Each row shows the
mark name, type swatch, and timing mode.

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

Edit:      Opens the mark form to change name, type, timing, or area.

Clone:     Duplicates a mark. Re-place it at a new location.

Del:       Permanently removes the mark.

Move & Re-place: Moves the mark's trigger position to your current location.
           Use this if a mark stops firing after moving furniture or if the
           mark was placed in a different housing session.


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


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

CONSUMABLE PICKER
-----------------
Shows items currently in your bags. If a consumable mark fires and
the item is not in your inventory, the prompt will still appear but
the item cannot be used.


TROUBLESHOOTING
---------------
Marks not firing:
  Confirm you are in your own home instance. HomeSoul only fires
  marks when you are the housing owner.
  If you logged in while already inside your house, walk outside and
  back in once to initialize the owner check.

Mark stopped firing after a patch or new session:
  Use Move & Re-place on the mark. Position data can become stale
  between sessions. Re-placing writes fresh coordinates.

Toy or consumable prompt doesn't appear:
  Check that the mark is enabled (checkbox on Soul tab) and that you
  are standing within the mark radius.

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


COMING SOON
-----------
- Area detection — marks fire only when inside their assigned room boundary
- Zones — sub-areas within rooms for proximity-specific triggers
- House section dividers on the Soul tab
- Guest broadcasting


COMMANDS
--------
/homesoul   open or close this