ResurrectionChest Config And Permissions

Permissions

Permission	Purpose	Default
resurrectionchest.*	Gives admins access to the setup, initialize, Nightbreak content, and reload commands	op
resurrectionchest.setup	Gives admins access to the /resurrectionchest setup command	op
resurrectionchest.initialize	Gives admins access to the /resurrectionchest initialize command	op
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 admin and model permissions only affect commands and optional visuals respectively.

Config Surface

config.yml currently exposes these user-facing settings:

Config Key	Type	Default
setupDone	boolean	false
Input name for death chest	string	[DeathChest]
Enable high compatibility / low security mode for plugin conflicts	boolean	false
Lower worn armor's durability on death	boolean	true
Amount of durability to lower on death	int	100
Chest creation message	string	&8[ResurrectionChest] &aYou've created your Death Chest!
Chest destruction message	string	&8[ResurrectionChest] &cYour Death Chest has been destroyed!
Chest missing message	string	&8[ResurrectionChest] &4Your Death Chest is missing!
Death message	string	&8[ResurrectionChest] &aYour items have been moved to your Death Chest!
deathChestRemovedMessage	string	&8[ResurrectionChest] &cYour Death Chest has been removed!
Enable particle effects for death chests	boolean	true
Particle effect 1	string	ENCHANTMENT_TABLE
Particle effect 2	string	ENCHANTMENT_TABLE
Particle effect 3	string	PORTAL
blacklistedWorlds	list	[none]
storeXP	boolean	true
xpPercentageKept	double	0.75
deathChestNameTag	string	$playerName's &fResurrection Chest
freeSingleDeathChestModelName	string	resurrectionchest_free_single
freeDoubleDeathChestModelName	string	resurrectionchest_free_double
premiumSingleDeathChestModelName	string	resurrectionchest_angelic_single
premiumDoubleDeathChestModelName	string	resurrectionchest_angelic_double

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

When a custom model prop is active, players can interact with it directly:

• right-click the prop to open the underlying chest inventory
• sneak + left-click the prop to destroy the registration (only the owner can do this)
• left-clicking without sneaking shows a warning instead of destroying the chest

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

Source-Backed Caveats

The current source shows a few config entries that are exposed in config.yml but not referenced outside DefaultConfig:

• Enable high compatibility / low security mode for plugin conflicts
• Lower worn armor's durability on death and Amount of durability to lower on death
• Particle effect 1
• Particle effect 2

By contrast, Particle effect 3 is the particle setting with an obvious live use in the current code (spawned every tick while the chest's chunk is loaded).