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, heals (see Healing Strategy) before continuing.

3. Walk to plant room -- your EV plant location.

4. 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 -- casts it if not.
   • At least one of Heal or Regenerate is active -- rebuffs via buff plantheal if needed (Heal + Adaptive Curing strategy only).
   • 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.

   If the hug reports no empathic bond, or the plant "appreciates the sentiment", the script releases and recasts EV and tries the hug again (up to 3 tries).

5. Heal -- always runs after the hug, even if at a limit (see Healing Strategy).

6. 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, plant disappeared, a stale plant noun ("Hug what?"), or the hug retries ran out. The state at the time is printed just before this message.

7. Repeat.

The script picks how to heal you at startup, from the spells you know:

The startup message says which one it chose.

• Must be an Empath with the Embrace of the Vela'Tohr spell.
• A valid plantheal waggle_set must be defined containing an Embrace of the Vela'Tohr spell entry (see Waggle Sets). If you know Heal and Adaptive Curing, it must also contain a Heal or Regenerate entry.
• Unless you know Heal and Adaptive Curing, the healme script must be configured and working. (It is also the fallback for the passive strategy.)

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
  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).

If you know Heal and Adaptive Curing, this waggle_set must also contain a Heal or Regenerate entry: the script runs buff plantheal to keep one of them active and heals you passively instead of running healme (see Healing Strategy). Blood Staunching can go here too.

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.

Older versions pre-cast a separate plant_heal waggle_set when use_adc: true. Both are gone: put Heal or Regenerate (and Blood Staunching, if you like) in the plantheal waggle_set instead. A leftover plant_heal waggle_set or use_adc setting is ignored.

waggle_sets:
  plantheal:
    Embrace of the Vela'Tohr:
      mana: 20
      recast: 60
      focus: emerald charm
    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 a manual cast backfires, the script prepares and casts again, up to 3 attempts in all, then gives up with "EV backfired 3 times -- giving up."

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.

plant_adc (and use_adc) are no longer read; see plant_heal.

Uses hometown NPC empath room, safe_room for healing, 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

For an Empath who knows Heal and Adaptive Curing: heals passively in place, with healme in healing_room only as a fallback.

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

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

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_touch_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 is no longer read; see Healing Strategy):
plant_adc: true
plant_total_touch_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:
  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
pick healing strategy: Heal + Adaptive Curing known? --yes--> passive (needs Heal/Regenerate in plantheal)
  |                                                   --no---> healme
  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--> heal -> (loop back)
|       |
|       no
|       |
|       v
|     walk_to(plantroom)
|       |
|       v
|     hug_plant_once (one hug per cycle; recast EV and retry, up to 3 tries,
|       |             on "no empathic bond" or "appreciates the sentiment")
|       v
|     heal (always runs after hugging):
|       passive -> buff plantheal if no Heal/Regenerate, wait up to 120s,
|                  then walk_to(healingroom) -> healme if still wounded
|       healme  -> walk_to(healingroom) -> healme
|       |
|       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 (cast EV if not active)
  6. ensure_healing_spells (passive strategy: buff plantheal 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