Updated for release 26.1++

Same features as KeepInvPlus-3.0 but updated for version 26.1+

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
• SUICIDE — 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 SUICIDE 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|SUICIDE> <APPLY|SKIP>
/kip set xp exception remove <PVP_DEATH|SUICIDE>

/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|SUICIDE> <REPLENISH|DENY>
/kip set hunger exception remove <PVP_DEATH|SUICIDE>

/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|SUICIDE> <APPLY|SKIP>
/kip set items exception remove <PVP_DEATH|SUICIDE>

/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)

Keep Inventory Plus

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 logic:

Tier 1 — Conditions: All active conditions must pass for the default outcome to apply.
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.
If all conditions pass, exceptions are skipped entirely.

---

Features

⚔️ XP Penalties

Stack multiple penalties applied in the order they were added:

• SUBTRACT — lose a configurable number of levels (negative values grant levels)
• 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

• GAMBLE — each non-gear item has a configurable chance of being lost on death
• LOSE_NON_GEAR — lose all items except tools and armor

🔀 Exceptions (XP, Hunger & Items)

All three attributes support a shared exception system as a fallback when conditions fail:

XP & Items exceptions (APPLY / SKIP):

• PVP_DEATH — trigger when killed by another player
• SUICIDE — trigger when the player kills themselves

Hunger exceptions (REPLENISH / DENY):

• PVP_DEATH — being killed by another player can force full replenishment
• SUICIDE — self-kills can force hunger denial regardless of other results

Exceptions are evaluated in the order they were added — last matching exception wins, giving server admins fine-grained control over edge cases.

---

Example Configurations

Hardcore economy server: Subtract 10 levels on death, skip penalty 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: Grant levels on death to incentivise fighting.

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

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 SUICIDE DENY

---

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|SUICIDE> <APPLY|SKIP>
/kip set xp exception remove <PVP_DEATH|SUICIDE>

/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|SUICIDE> <REPLENISH|DENY>
/kip set hunger exception remove <PVP_DEATH|SUICIDE>

/kip set items enabled <true|false>
/kip set items type <NONE|GAMBLE|LOSE_NON_GEAR>
/kip set items gamble_chance <0.0-1.0>
/kip set items exception add <PVP_DEATH|SUICIDE> <APPLY|SKIP>
/kip set items exception remove <PVP_DEATH|SUICIDE>

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

Permissions

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

Requirements

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

Additional Remarks

• Plugin tested on Paper 1.21.11 server. Might not work on Spigot/Bukkit/Other platforms.
• Enjoy :)

Version 2.0 updated support for Elytra persistence (v1.0 did not keep players' elytra's in their inventories upon death)

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 logic:

Tier 1 — Conditions: All active conditions must pass for the default outcome to apply.
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.
If all conditions pass, exceptions are skipped entirely.

---

Features

⚔️ XP Penalties

Stack multiple penalties applied in the order they were added:

• SUBTRACT — lose a configurable number of levels (negative values grant levels)
• 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

• GAMBLE — each non-gear item has a configurable chance of being lost on death
• LOSE_NON_GEAR — lose all items except tools and armor

🔀 Exceptions (XP, Hunger & Items)

All three attributes support a shared exception system as a fallback when conditions fail:

XP & Items exceptions (APPLY / SKIP):

• PVP_DEATH — trigger when killed by another player
• SUICIDE — trigger when the player kills themselves

Hunger exceptions (REPLENISH / DENY):

• PVP_DEATH — being killed by another player can force full replenishment
• SUICIDE — self-kills can force hunger denial regardless of other results

Exceptions are evaluated in the order they were added — last matching exception wins, giving server admins fine-grained control over edge cases.

---

Example Configurations

Hardcore economy server: Subtract 10 levels on death, skip penalty 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: Grant levels on death to incentivise fighting.

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

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 SUICIDE DENY

---

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|SUICIDE> <APPLY|SKIP>
/kip set xp exception remove <PVP_DEATH|SUICIDE>

/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|SUICIDE> <REPLENISH|DENY>
/kip set hunger exception remove <PVP_DEATH|SUICIDE>

/kip set items enabled <true|false>
/kip set items type <NONE|GAMBLE|LOSE_NON_GEAR>
/kip set items gamble_chance <0.0-1.0>
/kip set items exception add <PVP_DEATH|SUICIDE> <APPLY|SKIP>
/kip set items exception remove <PVP_DEATH|SUICIDE>

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

Permissions

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

Requirements

• Paper 1.21+ (Plugin tested on Paper server. COULD be compatible with Spigot/Bukkit but you'd have to try and see.
• Java 21+
• keepInventory gamerule must be enabled (/gamerule keepInventory true)