# KeepInvPlus<\/p>\n
A highly configurable death penalty plugin for Paper servers that adds meaningful
\nconsequences on top of the `keepInventory` gamerule \u2014 without taking everything away.<\/p>\n
## Overview
\nVanilla `keepInventory` is all-or-nothing. KeepInvPlus lets server admins define
\nnuanced death penalties across three attributes: **XP levels**, **hunger**, and **items** \u2014
\nall configurable live via commands with no server restart required.<\/p>\n
Every attribute shares the same powerful two-tier logic:<\/p>\n
**Tier 1 \u2014 Conditions:** All active conditions must pass for the default outcome to apply.
\n**Tier 2 \u2014 Exceptions:** If any condition fails, exceptions are checked in the order they
\nwere added. The last matching exception wins. If no exception matches, the penalty applies.
\nIf all conditions pass, exceptions are skipped entirely.<\/p>\n
—<\/p>\n
## Features<\/p>\n
### \u2694\ufe0f XP Penalties
\nStack multiple penalties applied in the order they were added:
\n– `SUBTRACT` \u2014 lose a configurable number of levels (negative values *grant* levels)
\n– `HALVE` \u2014 levels cut in half
\n– `REMOVE_ALL` \u2014 lose all levels
\n– `PERCENTAGE` \u2014 lose a configurable percentage of current levels
\n – Negative percentage grants levels on death
\n – Values over 100% can push levels into the negative
\n – Optional `zero_cap` prevents levels from going below 0<\/p>\n
### \ud83c\udf56 Hunger System
\nRather than punishing death, KeepInvPlus **rewards good play**. Players respawn with
\ntheir pre-death hunger unless they meet all configured replenishment conditions:
\n– `TIME_ALIVE` \u2014 must have survived a minimum number of seconds
\n– `BAR_CONSUMED` \u2014 must have consumed at least one hunger bar before dying<\/p>\n
### \ud83c\udf92 Item Penalties
\n– `GAMBLE` \u2014 each non-gear item has a configurable chance of being lost on death
\n– `LOSE_NON_GEAR` \u2014 lose all items except tools and armor<\/p>\n
### \ud83d\udd00 Exceptions (XP, Hunger & Items)
\nAll three attributes support a shared exception system as a fallback when conditions fail:<\/p>\n
**XP & Items exceptions** (`APPLY` \/ `SKIP`):
\n– `PVP_DEATH` \u2014 trigger when killed by another player
\n– `SUICIDE` \u2014 trigger when the player kills themselves<\/p>\n
**Hunger exceptions** (`REPLENISH` \/ `DENY`):
\n– `PVP_DEATH` \u2014 being killed by another player can force full replenishment
\n– `SUICIDE` \u2014 self-kills can force hunger denial regardless of other results<\/p>\n
Exceptions are evaluated in the order they were added \u2014 **last matching exception wins**,
\ngiving server admins fine-grained control over edge cases.<\/p>\n
—<\/p>\n
## Example Configurations<\/p>\n
**Hardcore economy server:** Subtract 10 levels on death, skip penalty if killed by a player.
\n“`
\n\/kip set xp enabled true
\n\/kip set xp type add SUBTRACT
\n\/kip set xp subtract_amount 10
\n\/kip set xp exception add PVP_DEATH SKIP
\n“`<\/p>\n
**PvP event server:** Grant levels on death to incentivise fighting.
\n“`
\n\/kip set xp enabled true
\n\/kip set xp type add SUBTRACT
\n\/kip set xp subtract_amount -5
\n“`<\/p>\n
**Survival server:** Replenish hunger only if you survived long enough and ate well.
\n“`
\n\/kip set hunger enabled true
\n\/kip set hunger condition add TIME_ALIVE
\n\/kip set hunger condition add BAR_CONSUMED
\n\/kip set hunger min_seconds_alive 120
\n\/kip set hunger exception add PVP_DEATH REPLENISH
\n\/kip set hunger exception add SUICIDE DENY
\n“`<\/p>\n
—<\/p>\n
## Commands \/kip set hunger enabled \/kip set items enabled \/kip get ## Permissions ## Requirements ## Additional remarks Nerfed keep inventory in minecraft. Modifications to how experience, hunger and items are handled upon death<\/p>\n","protected":false},"featured_media":89906,"template":"","meta":{"_minecraft_slug":"keep-inventory-plus","_minecraft_project_id":"chMMWrGM","_minecraft_author":"gyasca","_minecraft_license":"LicenseRef-All-Rights-Reserved","_minecraft_downloads":212,"_minecraft_follows":2,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"keep-inventory-plus.zip","_minecraft_size_bytes":126511,"_minecraft_version_count":4,"_minecraft_updated_at":"2026-05-16T12:38:29.282993Z","_minecraft_date_created":"2026-03-04T23:05:44.758142Z","_minecraft_date_modified":"2026-04-09T15:18:53.022199Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/keep-inventory-plus","_minecraft_icon_attachment_id":89906,"_minecraft_imported_at":"2026-06-05T03:13:44+00:00","_minecraft_import_hash":"247e5b75acb73a8bc60b66b076e0aa5e","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,125,127,128,129],"mod_loader":[130,131,132,133,134],"minecraft_version":[62,37,40,41,73,74,38,78,79,80,81,82,83,167,163],"class_list":["post-89905","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-bukkit","mod_category-folia","mod_category-paper","mod_category-purpur","mod_category-spigot","mod_loader-bukkit","mod_loader-folia","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9","minecraft_version-26-1","minecraft_version-26-1-1","minecraft_version-26-1-2"],"yoast_head":"\n
\n“`
\n\/kip set xp enabled
\n\/kip set xp type remove
\n\/kip set xp subtract_amount
\n\/kip set xp percentage
\n\/kip set xp zero_cap
\n\/kip set xp exception remove
\n\/kip set hunger condition remove
\n\/kip set hunger min_seconds_alive
\n\/kip set hunger exception add
\n\/kip set hunger exception remove
\n\/kip set items gamble_chance <0.0-1.0>
\n\/kip set items exception add
\n\/kip set items exception remove
\n\/kip reload
\n“`<\/p>\n
\n| Permission | Description | Default |
\n|—|—|—|
\n| `keepinvplus.admin` | Access to all \/kip commands | OP |<\/p>\n
\n– Paper 1.21+
\n– Java 21+
\n– `keepInventory` gamerule must be enabled (`\/gamerule keepInventory true`)<\/p>\n
\n– Plugin tested on Paper server 1.21.11
\n– COULD be compatible with Spigot\/Bukkit\/Other platforms mentioned but try at your own risk
\n– Have fun \ud83d\ude42<\/p>\n","protected":false},"excerpt":{"rendered":"