# 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 26.3+ - Java 25+ - The `keepInventory` gamerule must be enabled (`/gamerule keepInventory true`)

# 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`)