Inventory Totem

# Inventory Totem

**Keep your shield equipped. Let your inventory totems save you.**

Inventory Totem lets a Totem of Undying activate from any slot in your main
inventory or hotbar. When a supported hit would kill you, the add-on consumes
one totem and applies its rescue effects. Your offhand item stays where it belongs.

## Features

- **Free offhand:** use your shield or another offhand item without automatic swapping.
- **Automatic protection:** keep a totem in your inventory; no sneaking tricks or manual activation needed.
- **One totem per rescue:** after use, another available totem is selected automatically.
- **Full-inventory support:** no empty slot is needed to park your shield.
- **Damage-based activation:** reacts to lethal damage instead of predicting nearby threats.
- **Rescue effects:** restores one red heart and grants Regeneration II, Fire Resistance and two absorption hearts.
- **Totem feedback:** includes sound, particles and a custom on-screen totem animation.
- **Quiet gameplay:** no debug chat messages or status overlays.

Totems you hold in your main hand or offhand continue to work through vanilla
Minecraft. Inventory activation uses the add-on's own rescue logic and custom
visuals; it is not the native hand-held totem animation.

## Requirements and installation

- Minecraft Bedrock **26.10 or later**, compatible with Script API 2.6.0
  (manifest engine version: 1.26.10).
- Import **InventoryTotem.mcaddon** and enable both included packs.
- No cheats, commands or experimental toggles are required.

## Achievements

**Built with an achievement-friendly design:** uses stable APIs, requires no cheats
or experimental toggles, and does not change world eligibility settings.

Use a Survival world with cheats and experiments disabled. Achievement eligibility
can vary with the Minecraft version and world history; check your world's eligibility
when enabling the pack. It does not restore achievements in worlds that are already ineligible.

## Compatibility and limitations

- Protects Survival and Adventure players; Creative and Spectator are ignored.
- Void and forced-kill damage are excluded.
- A totem must be in your player inventory; totems inside containers do not count.
- Other packs that replace the HUD or use screen titles may conflict with the animation.
- If the selected totem disappears during the brief rescue transaction, the lethal
  outcome proceeds without consuming a different totem. Original attacker attribution
  is not guaranteed in this exceptional case.

## Configuration

Advanced users can edit `BP/scripts/config.js` to adjust rescue health, effect
durations and animation visibility before repackaging. No in-game setup is needed.