Death Behavior¶
CuriosPaper provides configurable behavior for what happens to a player's equipped accessories when they die.
Configuration¶
Modes¶
| Mode | Behavior |
|---|---|
Always |
Players always keep their curio inventory on death, regardless of the keepInventory gamerule |
Auto |
Follows the vanilla keepInventory gamerule — keep items if true, drop if false (default) |
Never |
Players always drop their curio inventory on death, regardless of the keepInventory gamerule |
How It Works¶
When a player dies, the PlayerDeathListener checks the configured mode:
- Always: Accessories remain in their curio slots. Nothing is added to the death drops.
- Auto: Checks
event.getKeepInventory()(which reflects thekeepInventorygamerule and any plugins that modify it). Iffalse, all accessories are added to the death drops list and cleared from the curio slots. - Never: All accessories are forcibly added to the death drops list and cleared from curio slots, even if
keepInventoryistrue.
Dropped Items¶
When accessories are dropped on death:
- Each non-empty accessory item from all slot types is added to
event.getDrops() - Items appear as ground drops at the player's death location
- All curio slots are cleared after dropping
Use Cases¶
| Scenario | Recommended Mode |
|---|---|
| Casual / Creative server | Always |
| Vanilla survival | Auto |
| Hardcore / PvP server | Never |
| Different behavior per world | Use a plugin to modify keepInventory per-world, then use Auto |
Example: PvP Arena Integration¶
If you use a PvP arena plugin that sets keepInventory per-region, use Auto mode. CuriosPaper will automatically follow whatever the arena plugin decides:
Never Mode
When using Never mode, players will always lose their accessories on death, even in creative mode or when keepInventory is enabled. Use with caution.