KeepInvPlus

A highly configurable death penalty plugin for Paper servers that adds meaningful consequences on top of the keepInventory gamerule — without taking everything away.

Overview

Vanilla keepInventory is all-or-nothing. KeepInvPlus lets server admins define nuanced death penalties across three attributes: XP levels, hunger, and items — all configurable live via commands with no server restart required.

Every attribute shares the same powerful two-tier evaluation logic:

Tier 1 — Conditions: All active conditions must pass for the default outcome to apply. If all pass, exceptions are skipped entirely.

Tier 2 — Exceptions: If any condition fails, exceptions are checked in the order they were added. The last matching exception wins. If no exception matches, the penalty applies.

---

Features

⚔️ XP Penalties

Stack multiple penalties applied in the order they were added:

• SUBTRACT — lose a configurable number of levels (negative values grant levels on death)
• HALVE — levels cut in half
• REMOVE_ALL — lose all levels
• PERCENTAGE — lose a configurable percentage of current levels
  • Negative percentage grants levels on death
  • Values over 100% can push levels into the negative
  • Optional zero_cap prevents levels from going below 0

🍖 Hunger System

Rather than punishing death, KeepInvPlus rewards good play. Players respawn with their pre-death hunger unless they meet all configured replenishment conditions:

• TIME_ALIVE — must have survived a minimum number of seconds
• BAR_CONSUMED — must have consumed at least one hunger bar before dying

🎒 Item Penalties

Stack multiple item penalty types:

• LOSE_NON_GEAR — lose all items except tools and armor (uses Minecraft's built-in item tags, automatically supports new items in future versions)
• GAMBLE — each non-gear item has a configurable chance of being lost
• CUSTOM — explicit per-item override layer that takes precedence over all other types:
  • custom_keep — items always kept regardless of other types
  • custom_drop — items always dropped even if tags would protect them
  • Use ALL as a special keyword in custom_drop to drop everything not explicitly in custom_keep

🔀 Exceptions (XP, Hunger & Items)

All three attributes support a shared exception system as a fallback when conditions fail. Exceptions are evaluated in order — last matching exception wins.

XP & Items use APPLY / SKIP

Hunger uses REPLENISH / DENY

Available exception types for all attributes:

• PVP_DEATH — triggers when killed by another player
• ✨ — triggers when the player kills themselves

---

Example Configurations

Hardcore economy server — lose 10 levels on death, but not if killed by a player:

/kip set xp enabled true
/kip set xp type add SUBTRACT
/kip set xp subtract_amount 10
/kip set xp exception add PVP_DEATH SKIP

PvP event server — players gain levels on death to incentivise fighting:

/kip set xp enabled true
/kip set xp type add SUBTRACT
/kip set xp subtract_amount -5

Brutal server — halve levels AND take a percentage on top:

/kip set xp enabled true
/kip set xp type add HALVE
/kip set xp type add PERCENTAGE
/kip set xp percentage 25
/kip set xp zero_cap false

Survival server — replenish hunger only if you survived long enough and ate well:

/kip set hunger enabled true
/kip set hunger condition add TIME_ALIVE
/kip set hunger condition add BAR_CONSUMED
/kip set hunger min_seconds_alive 120
/kip set hunger exception add PVP_DEATH REPLENISH
/kip set hunger exception add ✨ DENY

Keep only one specific item — drop everything except END_STONE (e.g. for a mini-game):

/kip set items enabled true
/kip set items type add CUSTOM
/kip set items custom keep add END_STONE
/kip set items custom drop add ALL

Fine-tune LOSE_NON_GEAR — keep gear but force drop DIAMOND_SWORD, always keep TOTEM_OF_UNDYING:

/kip set items enabled true
/kip set items type add LOSE_NON_GEAR
/kip set items type add CUSTOM
/kip set items custom drop add DIAMOND_SWORD
/kip set items custom keep add TOTEM_OF_UNDYING

Skip item penalty entirely on PvP death:

/kip set items enabled true
/kip set items type add LOSE_NON_GEAR
/kip set items exception add PVP_DEATH SKIP

---

Commands

/kip set xp enabled <true|false>
/kip set xp type add <SUBTRACT|HALVE|REMOVE_ALL|PERCENTAGE>
/kip set xp type remove <SUBTRACT|HALVE|REMOVE_ALL|PERCENTAGE>
/kip set xp subtract_amount <number>
/kip set xp percentage <number>
/kip set xp zero_cap <true|false>
/kip set xp exception add <PVP_DEATH|✨> <APPLY|SKIP>
/kip set xp exception remove <PVP_DEATH|✨>

/kip set hunger enabled <true|false>
/kip set hunger condition add <TIME_ALIVE|BAR_CONSUMED>
/kip set hunger condition remove <TIME_ALIVE|BAR_CONSUMED>
/kip set hunger min_seconds_alive <seconds>
/kip set hunger exception add <PVP_DEATH|✨> <REPLENISH|DENY>
/kip set hunger exception remove <PVP_DEATH|✨>

/kip set items enabled <true|false>
/kip set items type add <NONE|GAMBLE|LOSE_NON_GEAR|CUSTOM>
/kip set items type remove <NONE|GAMBLE|LOSE_NON_GEAR|CUSTOM>
/kip set items gamble_chance <0.0-1.0>
/kip set items custom keep add <MATERIAL|ALL>
/kip set items custom keep remove <MATERIAL|ALL>
/kip set items custom drop add <MATERIAL|ALL>
/kip set items custom drop remove <MATERIAL|ALL>
/kip set items exception add <PVP_DEATH|✨> <APPLY|SKIP>
/kip set items exception remove <PVP_DEATH|✨>

/kip get <xp|hunger|items|all>
/kip reload

Permissions

Permission	Description	Default
keepinvplus.admin	Access to all /kip commands	OP

Requirements

• Paper 1.21+
• Java 21+
• The keepInventory gamerule must be enabled (/gamerule keepInventory true)