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	Opens the first-time setup menu with /resurrectionchest initialize	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 forcereinstallcontent <package|all>	resurrectionchest.*	Re-downloads a content pack (or every downloaded pack) even when the installed version is already current. Package names tab-complete to the Nightbreak slugs wooden-chest and angelic-chest, plus all
/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.

Plugin Files

Path	Purpose
plugins/ResurrectionChest/config.yml	Every setting in the table below
plugins/ResurrectionChest/playerData.yml	One entry per registered chest, keyed by player UUID: the chest location, the chestModel prefix picked when the chest was registered, and a trackedBlockSchemaVersion used to migrate older registrations onto the current block-ownership tags
plugins/ResurrectionChest/content_packages/	The wooden_chest.yml / angelic_chest.yml content-pack definitions (name, description, download link, version, isEnabled, category)
plugins/ResurrectionChest/nightbreak-changelogs.yml	Read/dismissed state for the shared changelog inbox behind /resurrectionchestchangelog. See Changelog Notifications
plugins/ResurrectionChest/imports/	Manual import drop folder. Anything left here is unpacked on startup — model files are routed into FreeMinecraftModels and FreeMinecraftModels is refreshed automatically. See Manual imports vs in-game management

Do not hand-edit playerData.yml while the server is running; ResurrectionChest rewrites it whenever a chest is registered or removed.

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!
Chest protected region message	string	&8[ResurrectionChest] &cYou can't create a Death Chest here - this area is protected!
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).

Region Protection

Registering a death chest is treated as building: before the sign is accepted, ResurrectionChest asks MagmaCore's shared LocationQueryRegistry whether the player may build at the chest block.

• WorldGuard and GriefPrevention are wrapped automatically; if neither is installed there is no extra restriction and registration behaves exactly as before.
• If a protection plugin denies the build, the registration is refused and the player is sent Chest protected region message.
• If a protection adapter throws an error, the query fails closed (the registration is refused) rather than silently bypassing protection.

The adapters are attached during startup, so any attach failure shows up in the boot log instead of on the first chest registration.

Armor Durability Penalty

Lower worn armor's durability on death (default true) and Amount of durability to lower on death (default 100) are applied to the player's worn armor as it is being routed into the death chest:

• each worn armor piece that appears in the death drops has Amount of durability to lower on death added to its damage value
• if that would take the piece to or past its maximum durability, the piece is removed from the drops entirely (it is destroyed rather than stored)
• otherwise the damaged piece is what gets placed in the chest

The penalty only runs on deaths that ResurrectionChest actually handles — it is skipped when keepInventory is on, when the world is blacklisted, when the player lacks resurrectionchest.use, and when the registered chest is missing.

High Compatibility Mode

Enable high compatibility / low security mode for plugin conflicts (default false) controls how strictly ResurrectionChest verifies a block before acting on it.

• When false, a sign or chest is only treated as ResurrectionChest's if it still carries the owner tag the plugin writes into the block's persistent data.
• When true, a missing ownership tag is accepted at a tracked location. A conflicting owner tag is still rejected, and a tracked chest must still be a chest block.

Use this mode when another plugin removes ResurrectionChest's ownership tags. It relaxes the missing-tag check; it does not allow arbitrary replacement blocks or conflicting ownership tags.

XP Handling

When storeXP is enabled:

• ResurrectionChest tracks the player's total XP during play, but reads the player's live total at the moment of death, so XP granted straight through another plugin's API is still counted
• on death, it stores total XP * xpPercentageKept
• it sets dropped XP to 0
• it gives the stored XP back when the owner next opens their registered chest (either half of a double chest counts)
• dying again before collecting adds to the stored amount rather than replacing it

xpPercentageKept is clamped into the 0-1 range when the config is read, so values above 1 behave as 1 and negative or invalid values behave as 0.

Important exceptions:

• If keepInventory is active, ResurrectionChest does nothing.
• If keepLevel is active, the XP-storage branch is skipped and vanilla level handling is left alone.
• Stored XP is held in memory only. It is not written to playerData.yml, so a server restart, a /resurrectionchest reload, or a plugin reload discards any XP that has not been collected yet. The items already inside the chest are unaffected.

Overflow Handling

Items are inserted into the chest one stack at a time and partial insertion is allowed:

• whatever fits is stored, including topping up an existing stack
• only the leftover amount stays in the normal death-drop list at the death location
• 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

The model choice is made once, when the chest is registered, and is stored in playerData.yml as that chest's chestModel. Two consequences:

• if FreeMinecraftModels was not installed at registration time, the chest is recorded with no model and stays a plain vanilla chest even after FreeMinecraftModels is installed
• a permission change afterwards does not retroactively upgrade or downgrade an existing chest

In both cases the player has to re-register the chest (break it and place the sign again) to pick up the new model.

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:

• 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: it is resolved once on load (falling back to PORTAL with a console warning if the name is not a valid particle) and then spawned every tick while the chest's chunk is loaded. Setting Enable particle effects for death chests to false cancels that per-tick task entirely, which is the cheapest option on servers with many registered chests. 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.

Two more command-surface caveats:

• /resurrectionchest initialize opens the first-time setup menu and requires resurrectionchest.initialize. /resurrectionchest setup opens the content, update, and recommended-plugin controls.
• /resurrectionchest clear is not scoped to one player. It wipes every registered chest on the server in one pass.