Empathy training script for DragonRealms. Automates the Embrace of the Vela'Tohr (EV) plant healing loop to train the Empathy skill.

The script runs a simple cycle: hug once, heal, repeat until either hug_count total hugs or empathy_threshold mindstate is reached (whichever comes first).

Each cycle:

1. Check exit conditions -- exits if hug_count total hugs reached OR empathy_threshold mindstate reached (unless heal_past_ml is true). If cast_room is set, casts a community EV for others before exiting.
2. Wound score check -- verifies DRCH.check_health['score'] is 0 (no existing wounds). If wounds are detected, walks to the healing room and runs healme before continuing.
3. Pre-cast healing spells (optional ADC) -- casts the plant_heal waggle_set (e.g. Heal, Blood Staunching).
4. Walk to plant room -- your EV plant location.
5. Hug plant once -- transfers wounds via hug. Before hugging, the script runs a pre-hug check that verifies:
   • Not bleeding (bleeding?) -- if bleeding, stops and proceeds to heal.
   • Total hugs < hug_count -- stops if hug limit reached.
   • Empathy mindstate < threshold -- stops if threshold reached.
   • Wound score is 0 -- if wounds detected, heals to full first.
   • EV is active -- recasts if needed.
   • At least one of Heal or Regenerate is active -- rebuffs if needed.
   • Plant noun is re-resolved from DRRoom.room_objs -- ensures the correct noun is used even if the plant morphology changed (e.g. another empath's briar merged into a thicket). If the plant disappears entirely, stops.
6. Walk to healing room -- returns to heal yourself.
7. Run healme -- executes the healme script (always runs, even if at limit).
8. Zero-hug check -- if the hug didn't succeed, exits with a context-specific message:
   • No plant found -- EV recast failed or plant_room is misconfigured.
   • Plant fully healed -- plant has no wounds to transfer; cast a new EV.
   • Stopped early -- bleeding, hug_count, threshold, or plant disappeared.
9. Repeat.

• Must be an Empath with the Embrace of the Vela'Tohr spell.
• The healme script must be configured and working.
• A valid plantheal waggle_set must be defined containing an Embrace of the Vela'Tohr spell entry (see Waggle Sets).

All settings nest under plantheal_settings: in your YAML profile.

plantheal_settings:
  hug_count: 3
  plant_room: null
  healing_room: null
  prep_room: null
  cast_room: null
  empathy_threshold: 24
  heal_past_ml: false
  use_adc: false
  ev_cast_mana: 600
  ev_extra_wait: 15
  focus_container: null

The script has three operating modes controlled by heal_past_ml:

The plantheal waggle_set is required and must contain an Embrace of the Vela'Tohr spell entry. The script validates this at startup and exits with an informative error if the waggle_set is missing or doesn't contain the expected spell key.

All spell data -- mana, focus item, and focus handling mode (worn/tied/sheathed) -- is drawn from this entry. Fields not explicitly defined are filled by dependency from base-spells.yaml, so a minimal entry only needs the spell name as the key.

If no prep_room is set, the script delegates EV casting to the buff script via this waggle_set. If prep_room is set, the script casts EV manually (the buff script has no concept of prepping in one room and casting in another).

waggle_sets:
  plantheal:
    Embrace of the Vela'Tohr:
      mana: 20
      recast: 60
      ritual: true
      focus: emerald charm
      worn_focus: false
      tied_focus: false
      sheathed_focus: false
      prep_time: 30
      # ...

Minimal entry (dependency fills basic spell data from base-spells.yaml, but focus must be configured):

waggle_sets:
  plantheal:
    Embrace of the Vela'Tohr:
      mana: 800
      worn_focus: true
      focus: emerald charm
      recast: 15

Focus handling: Focus options (focus, worn_focus, tied_focus, sheathed_focus) are not inherited from base-spells.yaml -- only basic spell data like abbrev and ritual are inherited via dependency. You must explicitly configure your focus item and storage method in your waggle_set. DRCA handles focus retrieval/stowing automatically via find_focus/invoke/stow_focus, supporting all storage modes equally.

Focus handling modes (must be explicitly configured):

Focus modes are mutually exclusive. Precedence: worn > tied > sheathed > focus_container > generic get.

A waggle_set containing your healing spells to pre-cast before hugging the plant. Typically includes Heal and/or Regenerate, and optionally Blood Staunching.

When this waggle_set is defined, the script also ensures at least one of Heal or Regenerate is active before every hug. If both have expired mid-cycle, the script automatically rebuffs via buff plant_heal.

waggle_sets:
  plant_heal:
    Heal:
      abbrev: HEAL
      mana: 15
      # ...
    Blood Staunching:
      abbrev: BS
      mana: 10
      # ...

The script chooses between two EV casting strategies:

Manual casting is necessary because DRCA.ritual() (used internally by buff) performs prepare -> focus -> invoke -> wait -> cast all in the current room. There is no room-switching support in the waggle_set infrastructure.

If you have settings from older versions of plantheal.lic, they will be automatically migrated with a deprecation warning. The new plantheal_settings hash takes priority if both are defined.

Uses hometown NPC empath room, safe_room for healing, no ADC, no community cast. Focus must be explicitly configured (not inherited from base-spells).

plantheal_settings:
  hug_count: 3

waggle_sets:
  plantheal:
    Embrace of the Vela'Tohr:
      mana: 20
      recast: 60
      focus: emerald charm

plantheal_settings:
  hug_count: 5
  plant_room: 1234
  healing_room: 5678
  use_adc: true
  empathy_threshold: 30

waggle_sets:
  plant_heal:
    Heal:
      abbrev: HEAL
      mana: 15
    Blood Staunching:
      abbrev: BS
      mana: 10
  plantheal:
    Embrace of the Vela'Tohr:
      mana: 20
      recast: 60

For when you need to prep EV in a different room (e.g. Dokt's).

plantheal_settings:
  hug_count: 3
  plant_room: 1234
  healing_room: 5678
  prep_room: 9999
  cast_room: 4444
  ev_cast_mana: 600
  ev_extra_wait: 15
  heal_past_ml: true
  focus_container: backpack

waggle_sets:
  plantheal:
    Embrace of the Vela'Tohr:
      mana: 20
      recast: 60

waggle_sets:
  plantheal:
    Embrace of the Vela'Tohr:
      mana: 20
      recast: 60
      focus: armband
      worn_focus: true

If you previously used the flat settings from plantheal.lic:

# OLD -- still works but will show deprecation warnings:
plant_drop_room: 1234
plant_healing_room: 5678
plant_prep_room: 9999
plant_total_hug_count: 3
plant_empathy_threshold: 24
plant_heal_past_ML: false
cast_room: 4444
ritual_focus_container: "backpack"
ritual_ev_mana: 600
ritual_ev_extra_wait: 15

# NEW -- migrate to this:
plantheal_settings:
  plant_room: 1234
  healing_room: 5678
  prep_room: 9999
  hug_count: 3
  empathy_threshold: 24
  heal_past_ml: false
  cast_room: 4444
  ev_cast_mana: 600
  ev_extra_wait: 15
  focus_container: backpack

waggle_sets:
  plantheal:
    Embrace of the Vela'Tohr:
      mana: 20
      recast: 60
      focus: emerald charm

If you previously used the flat settings from the original custom plantheal.lic:

# OLD -- still works but will show deprecation warnings:
plant_adc: true
plant_total_hug_count: 3
plant_custom_room: 1234
plant_healing_room: 5678
plant_prep_room: 9999
plant_heal_past_ML: false
plant_empathy_threshold: 24

# NEW -- migrate to this:
plantheal_settings:
  use_adc: true
  hug_count: 3
  plant_room: 1234
  healing_room: 5678
  prep_room: 9999
  heal_past_ml: false
  empathy_threshold: 24

waggle_sets:
  plantheal:
    Embrace of the Vela'Tohr:
      mana: 20
      recast: 60
      focus: emerald charm

start
  |
  v
validate plantheal waggle_set (must have "Embrace of the Vela'Tohr" entry)
  |
  v
stow_hands
  |
  v
+---> check_exit_conditions:
|       - [total_hugs >= hug_count?] --yes--> cast_for_others? --> exit
|       - [empathy >= threshold?] --yes--> cast_for_others? --> exit
|       |
|       (both no, unless heal_past_ml is true)
|       |
|       v
|     [wound score > 0?] --yes--> walk_to(healingroom) -> healme -> (loop back)
|       |
|       no
|       |
|       v
|     [use_adc?] --yes--> buff plant_heal
|       |
|       v
|     walk_to(plantroom)
|       |
|       v
|     hug_plant_once (one hug per cycle)
|       |
|       v
|     walk_to(healingroom)
|       |
|       v
|     healme (always runs after hugging)
|       |
|       v
|     [hug succeeded?] --no--> context-specific exit message:
|       |                      :no_plant     -> "No plant found in room after EV recast."
|       |                      :fully_healed -> "Plant fully healed — no wounds to transfer."
|       |                      :stopped_early-> "Stopped before hugging (see logs)."
|       |                      --> exit
|       |
|       yes
|       |
+-------+  (loop back to check_exit_conditions)

pre_hug_check (runs before hug, returns noun or false):
  1. bleeding? -> if yes, stop and go heal
  2. total_hugs >= hug_count? -> if yes (and heal_past_ml=false), stop
  3. empathy >= threshold? -> if yes (and heal_past_ml=false), stop
  4. heal_between_hugs if wound score > 0
  5. ensure_ev (recast EV if not active)
  6. ensure_healing_spells (rebuff plant_heal if neither Heal nor Regenerate active)
  7. resolve plant noun from DRRoom.room_objs -> if no plant, stop

Script exits when FIRST of:
  - total_hugs reaches hug_count
  - empathy mindstate reaches threshold