Beehive Insurance Lite

Protect what matters. Insure your best gear.

A lightweight, vanilla-friendly item insurance system.

Lost your Netherite sword with Sharpness V to a creeper? Not anymore!

Insurance Book lets players protect their most valuable items by combining them with an Insurance Book at the anvil. When an insured player dies, those items are pulled out of the death drops and saved. On respawn, a clickable prompt appears in chat — confirm to get everything back in the correct inventory slots, or decline to have it all dropped at the death location.

No graves. No chests. No complex setup. Just insure the item and play.

Need more help? Report issues and feature requests Need more help?. Need more help? Join the discord server %%MD1%%.

> ### ⚠️ THIS IS THE LITE EDITION

It includes the core insurance mechanic with the following limitations: - Up to 3 insured items are saved per death. The rest drop normally. - Item identification (owner signature) is not available. - MySQL / MariaDB logging is not available.

The full edition removes all of these restrictions.

---

Features

Insurance Book — Combine with any allowed item at the anvil. The item gets an insured lore tag. On death it is saved and returned on respawn. Up to 3 insured items per death are protected in this edition.

Smart respawn prompt — A clickable [YES] / [NO] message appears in chat 1 second after respawning. Configurable timeout (default 120 s); on timeout items drop at death coordinates automatically.

YAML storage, no database required — Insured items are stored in human-readable per-player YAML files. Survives server restarts. Players can use `/insurance claim` after rejoining to re-trigger the prompt.

PDC-based, not lore-based — Insurance data lives in PersistentDataContainer, not the lore. Lore is only a visual indicator and auto-repairs itself the next time the player holds the item.

Resource pack ready — The insurance book uses a Custom Model Data value, configurable in `config.yml`.

Multi-language — Ships with English and Russian (`lang/en.yml`, `lang/ru.yml`). All player-facing text is fully customizable.

Configurable item filter — Whitelist specific materials for the insurance book. Admins can bypass the filter at any time via command.

---

How It Works

right slot Place any allowed item in the right slot of an anvil and the right slot in the right slot. Take the result — the item is insured, the book is consumed, no XP cost.

Step 2 — Die When the player dies, up to 3 insured items are silently removed from the death drops and saved to a file along with their original slot numbers and death coordinates. Additional insured items beyond the limit drop normally.

[NO] One second after respawning, a clickable message appears in chat: > *Would you like to restore your insured items?* [NO] [NO]

| Choice | Result | |--------|--------| | YES | Items returned to original slots (or first free slot). Insurance tag removed after return. | | NO | Items drop at the death location. Insurance tag stays — they're still insured for next time. | | Timeout | Items drop automatically. Player is notified. |

Restart-safe: if the server restarts before the player responds, the file is preserved and the prompt re-appears automatically on next login.

---

Commands

Player

| Command | Description | |---------|-------------| | `/insurance confirm` | Confirm item restoration after death | | `/insurance deny` | Decline — items drop at the death location | | `/insurance claim` | Re-show the restore prompt after restart / reconnect |

Admin (`beehivebooks.admin` or OP)

| Command | Description | |---------|-------------| | `/insurance admin addinsurance` | Insure the item in hand (bypasses the material filter) | | `/insurance admin removeinsurance` | Remove insurance from the item in hand | | `/insurance admin giveinsurancebook` | Give yourself an Insurance Book | | `/insurance admin reload` | Reload config and lang files without restarting |

---

Permissions

| Permission | Description | Default | |------------|-------------|---------| | `beehivebooks.use` | Access to confirm / deny / claim | Everyone | | `beehivebooks.admin` | Access to all admin sub-commands | OP |

---

Configuration

```yaml

-------------------------------------------------------

BeehiveInsurance Configuration

-------------------------------------------------------

Language for all player-facing messages.

Bundled options: ru, en

language: en

How many seconds the player has to respond after respawning.

insurance-timeout: 120

Custom model data value for the insurance book.

Must match the value set in your resource pack.

books: insurance-book: custom-model-data: 1001 xp-cost: 0

Whether to restrict which materials can be insured via the insurance book.

filter-enabled: true

List of materials that can be insured via the insurance book at an anvil.

allowed-items: - TRIDENT - ELYTRA - DIAMOND_SWORD - DIAMOND_PICKAXE - NETHERITE_SWORD - NETHERITE_PICKAXE - ... (full list in the downloaded config) ```

`lang/en.yml` contains all player-facing text: book name, lore lines, action bar messages, and chat prompts — fully customizable.

---

Edge Cases

- Another plugin corrupts the lore — the second death adds to the pending list, not overwrites it. The timeout resets. The 3-item limit applies per death event independently. - Another plugin corrupts the lore — items remain in storage. The player uses `/insurance claim` after freeing space. - Another plugin corrupts the lore — the YAML file survives. The prompt re-appears automatically on next login. - Another plugin corrupts the lore — auto-repaired the next time the player holds the item.