ResurrectionChest Config And Permissions

Permissions

Permission	Purpose	Default
resurrectionchest.*	Gives admins access to the setup, content, update, reload, and clear commands	op
resurrectionchest.setup	Gives admins access to /resurrectionchest setup, recommendedplugins, downloadallcontent, and updatecontent	op
resurrectionchest.initialize	Reserved admin permission for the first-time setup flow	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 setup menu (browse/toggle chest packs, check plugin updates, see recommended plugins, toggle automatic updates)
/resurrectionchest recommendedplugins	resurrectionchest.setup	Opens (or, for the console, lists) the recommended companion plugins for ResurrectionChest
/resurrectionchest downloadall	resurrectionchest.*	Downloads the plugin update (if any) and every available content pack from Nightbreak
/resurrectionchest downloadallcontent	resurrectionchest.setup	Downloads every available content pack from Nightbreak
/resurrectionchest updatecontent (alias updateallcontent)	resurrectionchest.setup	Re-downloads only outdated installed content packs
/resurrectionchest downloadpluginupdate	resurrectionchest.*	Downloads a ResurrectionChest plugin update if one is available
/resurrectionchest reload	resurrectionchest.*	Reloads ResurrectionChest
/resurrectionchest clear	resurrectionchest.*	Clears every tracked ResurrectionChest block; drops each tracked chest's inventory and removes the chest and sign blocks

Downloaded plugin updates are placed in the server's update folder and only take effect after the next server restart.

Config Surface

config.yml currently exposes these user-facing settings:

Config Key	Type	Default
setupDone	boolean	false
nightbreak.autoDownloadPluginUpdates	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

Automatic Plugin & Content Updates

nightbreak.autoDownloadPluginUpdates is a shared Nightbreak/MagmaCore setting that ships inside ResurrectionChest. It defaults to false.

• When false (the default), nothing is downloaded automatically. ResurrectionChest still checks for a plugin update on boot (and roughly once per hour) so the in-game update button can show the result, but you trigger any actual download yourself.
• When true, ResurrectionChest downloads an available plugin update and outdated content packs on startup. Downloaded plugin and content updates are only used after the server restarts.
• Automatic plugin downloads require a valid Nightbreak account token and an active supporter membership.

You can flip this setting in-game from the Automatic Updates toolbar toggle inside /resurrectionchest setup, or edit config.yml directly.

The setup menu also exposes a Plugin Update entry (shows the installed/available version and downloads an update on click) and a Recommended Plugins entry (the same list as /resurrectionchest recommendedplugins).

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
• left-click the prop to destroy the registration (only the owner can do this; a non-owner who left-clicks gets a red message and nothing is destroyed)

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
• freeSingleDeathChestModelName
• 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). premiumSingleDeathChestModelName is used to verify the premium model file exists before assigning the premium prefix; the free model file's existence is not checked separately.