DynamicKeepInv

# DynamicKeepInv !(https://img.shields.io/badge/Java-17%2B-orange) !(https://img.shields.io/badge/Server-Paper%20%7C%20Spigot%20%7C%20Folia-blue) !(https://img.shields.io/badge/License-Apache%202.0-green) **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. It is designed for modern servers (1.20.4+) and features full native support for **Folia** region threading. --- ## Why use DynamicKeepInv? Vanilla Minecraft forces server administrators to choose between "Too Easy" (keepInventory true) or "Too Hard" (keepInventory false). **DynamicKeepInv** bridges this gap by offering a configurable balance: * **Day/Night Cycle:** Players feel safe during the day but must survive the night without protection. * **PvP vs PvE:** Make PvP high-stakes (drop items) while keeping PvE casual (keep items), or vice-versa. * **Economy Sink:** Allow players to pay a fee to save their items upon death via an interactive GUI. * **Land Integration:** Respects claims from Lands and GriefPrevention (e.g., keep items in your own base). --- ## Key Features ### Time-Based Rules * Automatically enables keepInventory during the day. * Disables it at night based on configurable start and end ticks. * Plays sounds and sends titles when the status changes. ### Advanced Death Rules * **PvP vs PvE:** Configure separate rules for Item Loss and XP Loss based on the killer. * **By World:** Set different rules for the Overworld, Nether, and End. * **Permission Bypass:** Players with `dynamickeepinv.bypass` never lose items. ### Economy & Death GUI * **Death Confirmation GUI:** When a player dies, a GUI appears asking them to **PAY** to keep items or **DROP** them. * **Auto-Pay:** Players can toggle `/dki autopay` to automatically deduct the fee and skip the GUI. * **Persistence:** If a player disconnects while dead, their pending death is saved to a database and the GUI reopens upon rejoin. * *(Requires Vault)* ### Player Statistics * Tracks death history for every player. * **In-Game GUI:** Run `/dki stats` to view: * Total Deaths, Saved Deaths, and Lost Deaths. * Money spent on keeping inventory. * Death cause breakdown (Day, Night, PvP, etc.). * **PlaceholderAPI:** Display these stats on scoreboards or chat. ### Plugin Integrations * **Lands:** Configure rules for "Own Land", "Enemy Land", and "Wilderness". * **GriefPrevention:** Similar support for claims. * **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. * **Folia:** 100% thread-safe region scheduling. --- ## Logic Hierarchy When a player dies, the plugin decides whether to keep or drop items based on this priority order (highest to lowest): 1. **Bypass Permission** (`dynamickeepinv.bypass`) * *If player has this permission, they always keep items.* 2. **Claim Protection** (Lands / GriefPrevention) * *Is the player in their own claim? Use claim settings.* 3. **Death Cause** (PvP / PvE) * *Did another player kill them? Use PvP settings.* 4. **Wilderness Settings** * *If enabled, use specific settings for unclaimed land.* 5. **Time-Based** (Day / Night) * *Fallback: Is it currently Day or Night?* --- ## Installation 1. Download the latest JAR from the (https://github.com/Alexteens24/DynamicKeepInv/releases) page. 2. Place it into your server's `plugins/` folder. 3. **(Optional)** Install Vault and an Economy plugin for paid features. 4. Restart the server. --- ## Commands & Permissions | Command | Permission | Description | | :--- | :--- | :--- | | `/dki status` | `dynamickeepinv.admin` | View current status (Time, World, Enabled). | | `/dki reload` | `dynamickeepinv.admin` | Reload configuration and messages. | | `/dki toggle` | `dynamickeepinv.admin` | Toggle the plugin on/off globally. | | `/dki stats ` | `dynamickeepinv.stats` | View death statistics GUI. | | `/dki confirm` | `dynamickeepinv.use` | Re-open the Death Confirmation GUI (if pending). | | `/dki autopay` | `dynamickeepinv.use` | Toggle auto-payment mode. | **Other Permissions:** * `dynamickeepinv.bypass`: User always keeps inventory. * `dynamickeepinv.stats.others`: View other players' stats. --- ## Configuration A snippet of `config.yml` demonstrating the advanced economy mode: ```yaml advanced: enabled: true # Economy Settings economy: enabled: true cost: 100.0 mode: "gui" # Options: charge-to-keep, charge-to-bypass, gui gui: timeout: 30 # Seconds to decide expire-time: 300 # Seconds to save data on disconnect # Death Cause Rules death-cause: enabled: true pvp: keep-items: false keep-xp: false pve: keep-items: true keep-xp: true