DynamicKeepInv

DynamicKeepInv turns keepInventory from a simple on/off gamerule into a configurable rule engine.

Instead of choosing between fully safe or fully punishing deaths, you can decide whether players keep items and XP based on:

• day or night
• PvP or PvE
• claims, regions, or towns
• economy rules
• first-death leniency
• repeated-death protection

Built for 1.20.4+ servers with Java 21 and full Folia support.

---

Why Use It?

Vanilla keepInventory is too blunt for most servers.

DynamicKeepInv lets you build setups like:

• safe day, dangerous night
• casual PvE, punishing PvP
• keep items in your own land, lose them in enemy territory
• pay to keep items through a death GUI
• forgive a player's first death or a brutal death streak

---

Highlights

• Day/night keep-inventory rules with separate item and XP control
• PvP vs PvE overrides
• Per-world enable list and per-world item overrides
• Lands, GriefPrevention, WorldGuard, and Towny integration
• Economy support with charge-to-keep, charge-to-bypass, or gui
• Death confirmation GUI and player auto-pay toggle
• First-death leniency and death-streak protection rules
• Grave integration with GravesX / AxGraves and fallback handling
• Player stats GUI plus PlaceholderAPI support
• Admin diagnostics with /dki status and /dki test [player]

---

Optional Integrations

Plugin	What it adds
Vault	Economy-based keep-inventory modes
PlaceholderAPI	Player/server placeholders
Lands	Own-land / other-land / wilderness rules
GriefPrevention	Own-claim / other-claim / wilderness rules
WorldGuard	Own-region / other-region / wilderness rules
Towny	Own-town / other-town / wilderness rules
GravesX / AxGraves	Graves instead of normal drops
MMOItems	Protected tag handling for soulbound-style items

---

Rule Order

When a player dies, the plugin evaluates rules in this order:

1. BypassPermissionRule
2. FirstDeathRule if enabled
3. DeathStreakRule if enabled
4. ProtectionRule for Lands / GriefPrevention / WorldGuard / Towny
5. DeathCauseRule for PvP vs PvE
6. WorldTimeRule for day/night fallback

The first rule that returns a result wins.

This means high-priority safety rules like bypass, first-death, and streak protection can override the final day/night fallback.

---

Requirements

• Java 21+
• Minecraft server 1.20.4+
• Paper, Spigot, Purpur, or Folia

Optional plugins:

• Vault for economy features
• PlaceholderAPI for placeholders
• Lands / GriefPrevention / WorldGuard / Towny for protection-aware rules
• GravesX / AxGraves for graves instead of ground drops
• MMOItems for protected tag handling

---

Quick Start

1. Download the latest JAR from Releases.
2. Place it in your server's plugins/ folder.
3. Install any optional integrations you want.
4. Start the server.
5. Edit plugins/DynamicKeepInv/config.yml.
6. Run /dki reload after config changes.

Config migration runs automatically on startup and reload.

---

Default Behavior

Out of the box:

• day keeps items and XP
• night drops items and XP
• stats are enabled
• optional integrations are disabled until you enable them in config

---

Commands

Command	Permission	Description
/dki status	dynamickeepinv.admin	Show current plugin state, world state, and active rule chain
/dki reload	dynamickeepinv.admin	Reload config, messages, integrations, GUI, and stats systems
/dki enable	dynamickeepinv.admin	Enable the plugin globally
/dki disable	dynamickeepinv.admin	Disable the plugin globally
/dki toggle	dynamickeepinv.admin	Toggle global enabled state
/dki test [player]	dynamickeepinv.admin	Diagnose which rule would apply to a player
/dki stats [player]	dynamickeepinv.stats / dynamickeepinv.stats.others	Open stats GUI
/dki confirm	dynamickeepinv.use	Reopen pending death GUI in gui mode
/dki autopay	dynamickeepinv.use	Toggle auto-pay in gui mode

Useful permissions:

• dynamickeepinv.bypass
• dynamickeepinv.stats.others

---

Example Config

rules:
  day:
    keep-items: true
    keep-xp: true
  night:
    keep-items: false
    keep-xp: false
  death-cause:
    enabled: true
    pvp:
      keep-items: false
      keep-xp: false
    pve:
      keep-items: true
      keep-xp: true
  first-death:
    enabled: true
    keep-items: true
    keep-xp: true
  streak:
    enabled: true
    threshold: 3
    window-seconds: 300
    keep-items: false
    keep-xp: false

integrations:
  worldguard:
    enabled: true
    in-own-region:
      keep-items: true
      keep-xp: true
    in-other-region:
      keep-items: false
      keep-xp: false
  towny:
    enabled: true
    in-own-town:
      keep-items: true
      keep-xp: true
    in-other-town:
      keep-items: false
      keep-xp: false

economy:
  enabled: true
  cost: 100.0
  mode: "gui"
  gui:
    timeout: 30
    expire-time: 300

---

Common Use Cases

Safe Day, Dangerous Night

rules:
  day:
    keep-items: true
    keep-xp: true
  night:
    keep-items: false
    keep-xp: false

Keep Items On First Death

rules:
  first-death:
    enabled: true
    keep-items: true
    keep-xp: true

Pay To Keep Items

economy:
  enabled: true
  cost: 250.0
  mode: "gui"

Claimed Areas Are Safe, Wilderness Is Not

integrations:
  lands:
    enabled: true
    in-own-land:
      keep-items: true
      keep-xp: true
    in-other-land:
      keep-items: false
      keep-xp: false

---

Placeholders

Requires PlaceholderAPI.

• %dynamickeepinv_enabled%
• %dynamickeepinv_keepinventory_formatted%
• %dynamickeepinv_period%
• %dynamickeepinv_economy_cost%
• %dynamickeepinv_stats_total_deaths%
• %dynamickeepinv_stats_save_rate%

See the wiki pages for full details.

---

Documentation

Full documentation lives in the wiki:

• Home
• Installation
• Basic Configuration
• Advanced Configuration
• Commands
• Permissions
• Stats
• Placeholders

GitHub Wiki:

• https://github.com/Alexteens24/DynamicKeepInv/wiki

---

License

This project is licensed under the Apache 2.0 License.