-
Notifications
You must be signed in to change notification settings - Fork 1
Advanced Configuration
Alexteens24 edited this page Dec 13, 2025
·
4 revisions
These settings give you fine-grained control over keep inventory behavior.
⚠️ Note: You must setadvanced.enabled: trueto use any of these features.
When a player dies, the plugin checks settings in this order:
1. Bypass Permission → Always keep (if player has permission)
↓
2. Claimed Area → in-own-land / in-other-land settings
↓
3. Death Cause → PvP or PvE settings
↓
4. Wilderness → Outside claimed areas (if use-death-cause: false)
↓
5. Time-based → Day or night settings
The first matching rule is applied. Higher rules override lower ones.
advanced:
enabled: true # REQUIRED for any advanced featureadvanced:
bypass-permission: truePlayers with dynamickeepinv.bypass will always keep their inventory, ignoring all other rules.
Use case: Give this to staff or donators.
For servers using the Lands plugin:
advanced:
protection:
lands:
enabled: true
override-lands: false
in-own-land:
keep-items: true
keep-xp: true
in-other-land:
keep-items: true
keep-xp: true
wilderness:
enabled: true
use-death-cause: false
keep-items: false
keep-xp: false| Setting | Description |
|---|---|
enabled |
Enable Lands integration |
override-lands |
true = override Lands' built-in keep inventory. false = let Lands handle it |
in-own-land |
Settings for land you own or are trusted in |
in-other-land |
Settings for someone else's land |
wilderness.enabled |
Enable wilderness rules |
wilderness.use-death-cause |
true = use PvP/PvE rules in wilderness. false = use wilderness settings |
Let Lands control its areas, plugin controls wilderness:
advanced:
protection:
lands:
enabled: true
override-lands: false # Let Lands handle its areas
wilderness:
enabled: true
use-death-cause: true # Use PvP/PvE rules outside LandsFor servers using GriefPrevention:
advanced:
protection:
griefprevention:
enabled: true
in-own-claim:
keep-items: true
keep-xp: true
in-other-claim:
keep-items: false
keep-xp: false
wilderness:
enabled: true
use-death-cause: false
keep-items: false
keep-xp: falseSame logic as Lands - in-own-claim is claims you own or are trusted in.
For servers using GravesX, this plugin can automatically create graves when items are lost.
advanced:
gravesx:
enabled: true- If a player keeps their inventory (due to any rule above), no grave is created.
- If a player loses their inventory (due to night, PvP, etc.), a grave is created containing their items and XP.
-
Note: If
keep-xpis true butkeep-itemsis false, the grave will contain items but 0 XP (since you kept the XP).
If you use the Death Confirmation GUI and GravesX:
- Player dies -> GUI opens.
- Player clicks Pay -> Keeps items (no grave).
- Player clicks Drop (or timeout) -> Items are sent to a grave instead of dropping on the ground.
Different rules based on how the player died:
advanced:
death-cause:
enabled: true
pvp: # Killed by another player
keep-items: true
keep-xp: true
pve: # Everything else (mobs, fall, lava, etc.)
keep-items: false
keep-xp: true- Direct player kill (sword, bow, etc.)
- Player's wolf/pet kills
- Mob kills (zombie, skeleton, creeper, etc.)
- Environmental (fall damage, lava, drowning, fire)
- Commands (
/kill)
| Scenario | Result |
|---|---|
| Player A kills Player B | PvP settings apply |
| Zombie kills player | PvE settings apply |
| Player falls into lava | PvE settings apply |
| Player dies in wilderness to mob | Wilderness or PvE (depending on config) |
Charge players to keep their inventory. Requires Vault + an economy plugin.
advanced:
economy:
enabled: true
cost: 100.0
mode: "charge-to-keep"
gui:
timeout: 30 # Seconds to decide (default: 30)
expire-time: 300 # Store pending death if disconnected (default: 300 = 5 minutes)| Mode | When charged | Behavior if can't pay |
|---|---|---|
charge-to-keep |
When player would keep items | Keeps items for free (no penalty) |
charge-to-bypass |
When player would lose items | Loses items (can't afford protection) |
gui |
Player chooses via GUI | Items dropped if timeout or player clicks Drop |
Example - charge-to-bypass:
- Player dies at night (would lose items)
- Has $100? → Pay and keep items
- No money? → Lose items as normal
The gui mode opens a confirmation GUI when a player dies, letting them choose whether to pay to keep their items or drop them.
advanced:
economy:
enabled: true
cost: 100.0
mode: "gui"
gui:
timeout: 30 # Seconds to decide (default: 30)
expire-time: 300 # Store pending death if disconnected (default: 300 = 5 minutes)- Player dies and respawns.
- A 27-slot GUI appears with 3 options:
- Pay (Green) - Pay the cost and keep items.
- Info (Yellow) - Shows item count, cost, and time remaining.
- Drop (Red) - Drop items at death location.
- If player doesn't choose within
timeoutseconds, items are dropped (or put in a grave if GravesX is enabled). - If player disconnects, their pending death is saved for up to
expire-timeseconds.
┌─────────────────────────────────────────┐
│ [ ] [ ] [ ] [ ] [ ] [ ] [ ] [ ] [ ] │
│ [ ] [ ] [P] [ ] [I] [ ] [D] [ ] [ ] │
│ [ ] [ ] [ ] [ ] [ ] [ ] [ ] [ ] [ ] │
└─────────────────────────────────────────┘
- P: Pay button (Green wool) - Click to pay and restore items.
- I: Info display (Yellow wool) - Hover to see details.
- D: Drop button (Red wool) - Click to drop items immediately.
-
/dki confirm: Reopens the GUI if it was closed or if the player wants to access it again (while pending death is still active). -
/dki autopay: Toggles auto-payment on death. If enabled, the player will automatically pay and keep items without seeing the GUI, provided they have enough funds.
- Curse of Vanishing: Items with this enchantment are explicitly destroyed and will never be dropped, restored, or put into a grave.
- Exact Location: The plugin stores the exact X, Y, Z coordinates of death. Drops will appear exactly where the player died.
- Duplicate Prevention: The plugin manually handles drops in GUI mode. It temporarily clears drops to prevent vanilla mechanics from duplicating items.
- Folia Support: On Folia servers, the plugin uses region schedulers to ensure drops and grave creation happen safely on the correct thread.
- Asynchronous Data: Database operations (saving/loading pending deaths) are performed asynchronously to prevent server lag.
| Scenario | Result |
|---|---|
| Player closes GUI | Warning message, GUI can be reopened with /dki confirm. |
| Player disconnects | Death saved, GUI shown on rejoin if within expire-time. |
| Timeout expires | Items dropped at death location automatically (or to grave). |
| Not enough money | Player sees insufficient funds message, can still click Drop. |
| Economy unavailable | Items dropped automatically (no GUI shown). |
Show players what happened to their inventory:
advanced:
death-message:
enabled: true
chat: true # Show in chat
action-bar: false # Show above hotbarMessages show:
- Whether items/XP were kept or lost
- The reason (PvP, PvE, time-based, etc.)
Separate control over items and XP:
advanced:
day:
keep-items: true
keep-xp: true
night:
keep-items: false
keep-xp: true # Keep XP but lose items at nightNo item loss in PvP, but PvE is punishing:
advanced:
enabled: true
death-cause:
enabled: true
pvp:
keep-items: true
keep-xp: true
pve:
keep-items: false
keep-xp: falseKeep items in claimed areas, lose them in wilderness:
advanced:
enabled: true
protection:
lands:
enabled: true
override-lands: false
in-own-land:
keep-items: true
keep-xp: true
in-other-land:
keep-items: true
keep-xp: true
wilderness:
enabled: true
use-death-cause: true # Use PvP/PvE rules
death-cause:
enabled: true
pvp:
keep-items: true # No penalty for PvP in wilderness
keep-xp: true
pve:
keep-items: false # Lose items to mobs in wilderness
keep-xp: truePay to keep items:
advanced:
enabled: true
economy:
enabled: true
cost: 500.0
mode: "charge-to-bypass"
night:
keep-items: false
keep-xp: false- Basic Configuration - Time and world settings
- Permissions - Permission nodes
- FAQ - Common questions