Automatically consumes mushroom stew from your hotbar when health drops below a configurable threshold. Seamlessly switches to soup, consumes it, and returns to your original slot—all without interrupting combat flow.
Set a health threshold between 1 and 20 HP (half-hearts). The module monitors your health each tick and only triggers when you drop below this value. This prevents wasting soup at full health and ensures healing exactly when needed.
The system remembers your original hotbar slot before switching to soup. After consumption, it automatically returns you to that exact slot. This happens in a single tick, making the entire process nearly invisible during heated exchanges.
After consuming soup, you're left with an empty bowl. You can choose to drop it automatically (enabled by default) or keep it in your inventory. Dropping clears the slot for more soup, essential for extended fights where inventory space matters.
Monitor current HP vs threshold each tick
Locate first available mushroom stew slot
Swap to soup slot and right-click to consume
Drop bowl (optional) and return to original slot
The module uses a simple but effective state machine to prevent bugs and double-eating:
→ Idle: Monitoring health, no action taken.
→ Switching: Moving to soup slot, storing previous slot.
→ Eating: Right-clicking to consume soup.
→ Returning: Moving back to original slot after bowl drops.
Each state transition happens cleanly to avoid inventory desync or failed swaps.
When Drop = true:
After soup consumption, the empty bowl is automatically dropped using player.dropOneItem(true). This drops the entire stack of bowls if multiple exist, clearing the slot completely.
When Drop = false:
The empty bowl remains in your hotbar. This is useful if you plan to refill soups later, but be aware it occupies a slot that could hold another full soup during combat.
→ Hotbar organization: Keep soups in slots 1-9 in any order. The module scans left-to-right and uses the first one found.
→ Health threshold: Set based on game mode. For Soup PvP, 14-16 HP is common. For survival, 10-12 HP gives more buffer.
→ Multiple soups: The module will consume soups repeatedly as long as health stays below threshold and soups remain in hotbar.
Conservative / Survival: Health = 10-12, Drop = true
Aggressive / Soup PvP: Health = 14-16, Drop = true
Inventory Conservation: Health = 12-14, Drop = false
Maximum Healing: Health = 18-19, Drop = true
Higher thresholds mean more frequent soup consumption but better health maintenance. Lower thresholds conserve soups but risk dying to burst damage.