Keep Inventory Plus

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: items, items, and items — all configurable live via commands with no server restart required.

Every attribute shares the same powerful two-tier logic:

Tier 2 — Exceptions: 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|all> /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 server 1.21.11 - COULD be compatible with Spigot/Bukkit/Other platforms mentioned but try at your own risk - Have fun :)