# DynamicKeepInv<\/p>\n
  <\/p>\n
**DynamicKeepInv** is a sophisticated plugin that revolutionizes how the keepInventory gamerule works on Minecraft servers. Instead of a simple global toggle, it dynamically controls inventory loss based on in-game time, death causes, territory protection, and economy.<\/p>\n
It is designed for modern servers (1.20.4+) and features full native support for **Folia** region threading.<\/p>\n
—<\/p>\n
## Why use DynamicKeepInv?<\/p>\n
Vanilla Minecraft forces server administrators to choose between “Too Easy” (keepInventory true) or “Too Hard” (keepInventory false).<\/p>\n
**DynamicKeepInv** bridges this gap by offering a configurable balance:
\n* **Day\/Night Cycle:** Players feel safe during the day but must survive the night without protection.
\n* **PvP vs PvE:** Make PvP high-stakes (drop items) while keeping PvE casual (keep items), or vice-versa.
\n* **Economy Sink:** Allow players to pay a fee to save their items upon death via an interactive GUI.
\n* **Land Integration:** Respects claims from Lands and GriefPrevention (e.g., keep items in your own base).<\/p>\n
—<\/p>\n
## Key Features<\/p>\n
### Time-Based Rules
\n* Automatically enables keepInventory during the day.
\n* Disables it at night based on configurable start and end ticks.
\n* Plays sounds and sends titles when the status changes.<\/p>\n
### Advanced Death Rules
\n* **PvP vs PvE:** Configure separate rules for Item Loss and XP Loss based on the killer.
\n* **By World:** Set different rules for the Overworld, Nether, and End.
\n* **Permission Bypass:** Players with `dynamickeepinv.bypass` never lose items.<\/p>\n
### Economy & Death GUI
\n* **Death Confirmation GUI:** When a player dies, a GUI appears asking them to **PAY** to keep items or **DROP** them.
\n* **Auto-Pay:** Players can toggle `\/dki autopay` to automatically deduct the fee and skip the GUI.
\n* **Persistence:** If a player disconnects while dead, their pending death is saved to a database and the GUI reopens upon rejoin.
\n* *(Requires Vault)*<\/p>\n
### Player Statistics
\n* Tracks death history for every player.
\n* **In-Game GUI:** Run `\/dki stats` to view:
\n * Total Deaths, Saved Deaths, and Lost Deaths.
\n * Money spent on keeping inventory.
\n * Death cause breakdown (Day, Night, PvP, etc.).
\n* **PlaceholderAPI:** Display these stats on scoreboards or chat.<\/p>\n
### Plugin Integrations
\n* **Lands:** Configure rules for “Own Land”, “Enemy Land”, and “Wilderness”.
\n* **GriefPrevention:** Similar support for claims.
\n* **GravesX \/ AxGraves:** If a player chooses to drop items (or cannot afford to pay), they are placed into a Grave instead of scattering on the ground.
\n* **Folia:** 100% thread-safe region scheduling.<\/p>\n
—<\/p>\n
## Logic Hierarchy<\/p>\n
When a player dies, the plugin decides whether to keep or drop items based on this priority order (highest to lowest):<\/p>\n
1. **Bypass Permission** (`dynamickeepinv.bypass`)
\n * *If player has this permission, they always keep items.*
\n2. **Claim Protection** (Lands \/ GriefPrevention)
\n * *Is the player in their own claim? Use claim settings.*
\n3. **Death Cause** (PvP \/ PvE)
\n * *Did another player kill them? Use PvP settings.*
\n4. **Wilderness Settings**
\n * *If enabled, use specific settings for unclaimed land.*
\n5. **Time-Based** (Day \/ Night)
\n * *Fallback: Is it currently Day or Night?*<\/p>\n
—<\/p>\n
## Installation<\/p>\n
1. Download the latest JAR from the Releases page.
\n2. Place it into your server’s `plugins\/` folder.
\n3. **(Optional)** Install Vault and an Economy plugin for paid features.
\n4. Restart the server.<\/p>\n
—<\/p>\n
## Commands & Permissions<\/p>\n
| Command | Permission | Description |
\n| :— | :— | :— |
\n| `\/dki status` | `dynamickeepinv.admin` | View current status (Time, World, Enabled). |
\n| `\/dki reload` | `dynamickeepinv.admin` | Reload configuration and messages. |
\n| `\/dki toggle` | `dynamickeepinv.admin` | Toggle the plugin on\/off globally. |
\n| `\/dki stats [player]` | `dynamickeepinv.stats` | View death statistics GUI. |
\n| `\/dki confirm` | `dynamickeepinv.use` | Re-open the Death Confirmation GUI (if pending). |
\n| `\/dki autopay` | `dynamickeepinv.use` | Toggle auto-payment mode. |<\/p>\n
**Other Permissions:**
\n* `dynamickeepinv.bypass`: User always keeps inventory.
\n* `dynamickeepinv.stats.others`: View other players’ stats.<\/p>\n
—<\/p>\n
## Configuration<\/p>\n
A snippet of `config.yml` demonstrating the advanced economy mode:<\/p>\n
“`yaml
\nadvanced:
\n enabled: true<\/p>\n
# Economy Settings
\n economy:
\n enabled: true
\n cost: 100.0
\n mode: “gui” # Options: charge-to-keep, charge-to-bypass, gui
\n gui:
\n timeout: 30 # Seconds to decide
\n expire-time: 300 # Seconds to save data on disconnect<\/p>\n
# Death Cause Rules
\n death-cause:
\n enabled: true
\n pvp:
\n keep-items: false
\n keep-xp: false
\n pve:
\n keep-items: true
\n keep-xp: true
\n““<\/p>\n
—–<\/p>\n
## Placeholders<\/p>\n
Requires **PlaceholderAPI**.<\/p>\n
* `%dynamickeepinv_isday%` – Returns `true` or `false`.
\n * `%dynamickeepinv_period%` – Returns “Day” or “Night”.
\n * `%dynamickeepinv_stats_save_rate%` – Player’s save percentage.
\n * `%dynamickeepinv_economy_cost%` – Current death cost.<\/p>\n
—–<\/p>\n
## License<\/p>\n
This project is licensed under the Apache 2.0 License.<\/p>\n
“`
\n“`<\/p>\n","protected":false},"excerpt":{"rendered":"
Dynamically controls keepInventory based on day\/night cycle, protection plugins, and death causes.<\/p>\n","protected":false},"featured_media":60379,"template":"","meta":{"_minecraft_slug":"dynamickeepinv","_minecraft_project_id":"mLgWaMK8","_minecraft_author":"alexisbinh","_minecraft_license":"Apache-2.0","_minecraft_downloads":93,"_minecraft_follows":1,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"dynamickeepinv.zip","_minecraft_size_bytes":520173,"_minecraft_version_count":12,"_minecraft_updated_at":"2026-05-15T19:50:42.488421Z","_minecraft_date_created":"2025-11-22T10:10:50.107477Z","_minecraft_date_modified":"2026-03-26T15:42:51.768045Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/dynamickeepinv","_minecraft_icon_attachment_id":60379,"_minecraft_imported_at":"2026-06-03T12:29:55+00:00","_minecraft_import_hash":"4aed9dee58221587d7dbabe2e3104c82","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[125,89,90,127,129,92],"mod_loader":[131,132,134],"minecraft_version":[94,101,102,62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-60378","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-folia","mod_category-game-mechanics","mod_category-optimization","mod_category-paper","mod_category-spigot","mod_category-utility","mod_loader-folia","mod_loader-paper","mod_loader-spigot","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","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"],"yoast_head":"\n