ResurrectionChest Config And Permissions

Permissions

Permission	Purpose	Default
resurrectionchest.use	Lets a player register a chest and have death drops routed into it	true
resurrectionchest.model.free	Lets a player use the free FreeMinecraftModels chest visuals	true
resurrectionchest.model.premium	Lets a player use the premium FreeMinecraftModels chest visuals	op

resurrectionchest.use is the important one for actual chest behavior. The model permissions only affect optional visuals.

Config Surface

config.yml currently exposes these user-facing settings:

• sign trigger text
• chest creation, destruction, missing-chest, death, and removal messages
• world blacklist
• storeXP
• xpPercentageKept
• death-chest nametag text for FreeMinecraftModels visuals
• free and premium model-name settings
• particle-effect settings
• high-compatibility mode
• durability-loss settings

XP Handling

When storeXP is enabled:

• ResurrectionChest tracks the player's current total XP during play
• on death, it stores tracked total XP * xpPercentageKept
• it sets dropped XP to 0
• it gives the stored XP back when the owner next opens their registered chest

Important exceptions:

• If keepInventory is active, ResurrectionChest does nothing.
• If keepLevel is active, the XP-storage branch exits early and leaves vanilla level handling alone.

Overflow Handling

If the chest has no free slot for an item:

• that item stays in the normal death-drop list
• the player gets a warning that the chest was full

FreeMinecraftModels Integration

If FreeMinecraftModels is installed, ResurrectionChest can spawn a visual chest prop on top of the real chest.

Current behavior:

• premium visuals are preferred when the player has resurrectionchest.model.premium
• otherwise the free visual is used when the player has resurrectionchest.model.free
• the visual model switches between single and double variants based on chest size
• the real chest is still the storage backend

If FreeMinecraftModels is missing or the model cannot be spawned, the underlying chest still works normally.

Source-Backed Caveats

The current source also shows a few config entries that are exposed in config.yml but not clearly used elsewhere in this repo:

• high-compatibility mode
• durability-loss settings
• particleEffect1
• particleEffect2

By contrast, particleEffect3 is the particle setting with an obvious live use in the current code.