ResurrectionChest Config And Permissions

Permissions

Permission	Purpose	Default
resurrectionchest.*	Gives admins access to the setup, initialize, downloadall, updatecontent, 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 (Wooden Chest)	true
resurrectionchest.model.premium	Lets a player use the premium FreeMinecraftModels chest visuals (Angelic Chest)	op

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

Commands

Command	Permission	Purpose
/resurrectionchest	resurrectionchest.*	Prints a short info blurb pointing to the setup flow
/resurrectionchest setup	resurrectionchest.setup	Opens the content setup menu (browse and toggle chest packs)
/resurrectionchest initialize	resurrectionchest.initialize	Opens the first-time setup menu
/resurrectionchest downloadall	resurrectionchest.setup	Downloads every available pack from Nightbreak
/resurrectionchest updatecontent (alias updateall)	resurrectionchest.setup	Re-downloads only outdated installed packs
/resurrectionchest reload	resurrectionchest.*	Reloads ResurrectionChest

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 (Angelic Chest) are preferred when the player has resurrectionchest.model.premium and the premium model is actually loaded
• otherwise the free visual (Wooden Chest) is used when the player has resurrectionchest.model.free
• if neither permission grants a usable model, no prop is spawned and the vanilla chest is used as-is
• 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 yellow warning instead of destroying the chest

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

Content Packs

ResurrectionChest ships with two content packs that wrap the FreeMinecraftModels chest models:

• Wooden Chest (free): provides resurrectionchest_free_single / resurrectionchest_free_double. Used by resurrectionchest.model.free.
• Angelic Chest (premium): provides resurrectionchest_angelic_single / resurrectionchest_angelic_double. Used by resurrectionchest.model.premium.

Each pack lives under FreeMinecraftModels' models folder when installed and models_disabled when uninstalled. Toggling them through /resurrectionchest setup moves the files between those folders and reloads FreeMinecraftModels automatically.

Source-Backed Caveats

The current source shows a few config entries that are exposed in config.yml but not referenced anywhere 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
• freeDoubleDeathChestModelName and premiumDoubleDeathChestModelName (the plugin internally hardcodes the model-name prefixes resurrectionchest_free and resurrectionchest_angelic, then appends _single or _double based on chest size, so the "Double" config keys do not currently affect chest visuals)

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). freeSingleDeathChestModelName and premiumSingleDeathChestModelName are used to verify the model file exists before assigning the premium prefix.