Skip to content

Configuration

DeadChest - Configuration

Make sure you have installed the plugin before editing the configuration.

For Pro's pro.yml, languages and feature permissions, see Pro configuration and permissions.

You can edit configuration directly in config.yml or in game with /dc config.

DeadChest now uses a structured config.yml (schema version 2) since v5.0.0. /dc config set and /dc config reset apply changes immediately. If you edit config.yml manually, run /dc reload.

Console behavior:

  • /dc config, /dc config get, /dc config set, and /dc config reset can be executed from the server console.
  • /dc config edit is player-only because it opens a GUI.

Global

Key Type Default Description
config-version integer 2 Configuration schema version.

Localization

Key Type Default Description
localization.language string en Language file loaded from plugins/DeadChest/localization/<language>.json (ex: en, fr, es, de, pt-br, pl, it, zh-cn).

Updates

Key Type Default Description
updates.auto-check boolean true Enable automatic update checks at startup.

Chest

Key Type Default Description
chest.owner-only-open boolean true During the private phase: only owner can open chest (except deadchest.chestPass).
chest.duration-seconds integer 300 Duration of the private phase in seconds. 0 = infinite private phase.
chest.indestructible boolean true Protect chest block from destruction/explosions.
chest.max-per-player integer 15 Max active chests per player. 0 = unlimited.
chest.recovery-mode string inventory-then-ground inventory-then-ground or ground-drop.
chest.block-type string chest chest, player-head, barrel, shulker-box, ender-chest.
chest.drop-items-on-timeout boolean false Legacy one-phase timeout behavior when chest.loot.enabled=false: drop items (true) or remove contents (false).

Chest - Public Loot Phase

Key Type Default Description
chest.loot.enabled boolean false Enable a second public loot phase after the private phase ends.
chest.loot.public-duration-seconds integer 300 Duration of the public phase in seconds. 0 = infinite public phase.
chest.loot.drop-items-on-timeout boolean false At the end of the public phase: drop items (true) or remove contents (false).
chest.loot.public-access.owner boolean true During public phase, allow the owner to recover the chest.
chest.loot.public-access.killer boolean true During public phase, allow the PvP killer to loot the chest.
chest.loot.public-access.other-players boolean true During public phase, allow any other player to loot the chest.

The timeout model is therefore:

  • Phase 1: private phase controlled by chest.duration-seconds.
  • Phase 2: optional public phase controlled by chest.loot.*.
  • If chest.loot.enabled=false, the chest expires directly after the private phase and uses chest.drop-items-on-timeout.
  • If chest.loot.enabled=true, the chest enters the public phase after the private phase, then expires using chest.loot.drop-items-on-timeout.

Permissions

Key Type Default Description
permissions.require-generate boolean false Require deadchest.generate to create chest on death.
permissions.require-claim boolean false Require deadchest.get to claim/retrieve chest.
permissions.require-list-own boolean false Require deadchest.list.own for /dc list.

Maintenance

Key Type Default Description
maintenance.cleanup-on-startup boolean false Remove all DeadChests on server startup.

Generation Rules

Key Type Default Description
generation.allow-in-creative boolean true Allow chest generation on death in Creative mode.
generation.allow-on-lava boolean true Allow generation when death occurs in lava.
generation.allow-on-water boolean true Allow generation when death occurs in water.
generation.allow-on-rails boolean true Allow generation when death occurs on rails.
generation.allow-in-minecart boolean true Allow generation when death occurs in minecart.
generation.allow-in-end-worlds boolean true Allow generation in The End worlds.

Messages

Key Type Default Description
messages.display-position-on-death boolean true Send chest coordinates to player on death.

XP

Key Type Default Description
xp.store-on-death boolean false Store XP in chest instead of normal orb drop.
xp.store-percentage integer 100 XP percent stored when enabled (0 to 100, values >100 duplicate XP).

PvP

Key Type Default Description
pvp.keep-inventory-on-player-kill boolean false On PvP death: keep inventory and skip DeadChest generation.

Integrations

Key Type Default Description
integrations.worldguard.enabled boolean false Enable WorldGuard region checks.
integrations.worldguard.default-allow boolean false Default region policy if no DeadChest flag is set.

Durability

Key Type Default Description
durability.loss-on-death-percent integer 0 Durability loss on death (percentage of max durability). 0 disables.

Logging

Key Type Default Description
logging.deadchest-create-to-console boolean false Log each chest creation in console.

Visuals - Effect Animation

Key Type Default Description
visuals.effect-animation.enabled boolean true Enable orbit particles around active DeadChests.
visuals.effect-animation.style string ender Effect style: soul, flame, ender.
visuals.effect-animation.radius number 0.8 Orbit radius around chest center.
visuals.effect-animation.speed number 1.1 Orbit speed multiplier.

DeadChest holograms now use three lines when available:

  • top line: access state (PRIVATE, OPEN, PUBLIC, KILLER, OWNER, SHARE)
  • middle line: owner name
  • bottom line: remaining time

The access-state line reflects both the private/public phase and the configured access rules during the public phase.

Visuals - Pickup Animation

Key Type Default Description
visuals.pickup-animation.enabled boolean true Enable animation when a player claims a chest.
visuals.pickup-animation.particle string FIREWORK Bukkit particle name used for pickup animation.
visuals.pickup-animation.count integer 22 Number of particles spawned.
visuals.pickup-animation.offset-x number 0.45 Particle spread on X axis.
visuals.pickup-animation.offset-y number 0.5 Particle spread on Y axis.
visuals.pickup-animation.offset-z number 0.45 Particle spread on Z axis.
visuals.pickup-animation.speed number 0.08 Particle extra/speed value.
visuals.pickup-animation.y-shift number 0.55 Vertical center offset from block base.

Visuals - Pickup Sound

Key Type Default Description
visuals.sound.pickup.enabled boolean true Enable sound on chest pickup.
visuals.sound.pickup.name string ENTITY_PLAYER_LEVELUP Bukkit sound name.
visuals.sound.pickup.volume number 1.2 Sound volume.
visuals.sound.pickup.pitch number 1.0 Sound pitch.

Filters

Key Type Default Description
filters.excluded-worlds list Example values Worlds where DeadChest generation is disabled.
filters.excluded-items list Example values Items that are not stored in DeadChest.
filters.ignored-items list Example values Items ignored by DeadChest storage; they keep vanilla death behavior.

/dc config uses canonical YAML paths, so command usage stays aligned with this file:

  • /dc config get localization.language
  • /dc config set chest.duration-seconds 600
  • /dc config set filters.excluded-worlds world,world_nether
  • /dc config reset visuals.sound.pickup.name
  • /dc config edit filters.ignored-items

/dc config edit currently supports only filters.ignored-items.

filters.ignored-items, /dc config edit filters.ignored-items, and deprecated /dc ignore use the same source of truth:

  • filters.ignored-items is the canonical list in config.yml.
  • /dc config edit filters.ignored-items edits that same list through a GUI.
  • /dc ignore remains as a deprecated compatibility alias.
  • A rule can be either a Bukkit Material name or a serialized ItemStack.
  • Serialized ItemStack rules preserve custom meta and are written automatically by the interactive editor.
  • Ignored items are not saved in a DeadChest and are left to vanilla death handling or other plugins.

Permission reference

  • deadchest.admin: admin commands and bypass for /dc config
  • deadchest.config: use /dc config get|set|reset|edit
  • deadchest.generate: generate chest on death (if required)
  • deadchest.get: claim/retrieve chest (if required)
  • deadchest.list.own: list own chests (if required)
  • deadchest.list.other: list another player's chests
  • deadchest.remove.own: remove own chests
  • deadchest.remove.other: remove another player's chests
  • deadchest.giveback: give back another player's items
  • deadchest.chestPass: bypass owner-only chest access
  • deadchest.infinityChest: create infinite chests