Skip to main content

ResurrectionChest Setup

First Boot​

The first time an admin with resurrectionchest.* joins, ResurrectionChest posts a one-time first-boot message ten seconds after login. The message confirms the plugin is ready to use, points to /resurrectionchest setup, and reminds you how to register a chest (place a chest and put a sign that says [DeathChest] on it — or whatever you set Input name for death chest to).

ResurrectionChest works out of the box with vanilla chests, so there is nothing you must do here. The reminder stops appearing once setupDone is true in config.yml. Opening /resurrectionchest setup flips setupDone to true automatically, which permanently dismisses the message.

Setup Menu​

/resurrectionchest setup

Opens the Nightbreak setup menu. From there, admins can:

  • view all ResurrectionChest content packs (Wooden Chest, Angelic Chest)
  • install or uninstall packs (which moves model files between FreeMinecraftModels' models and models_disabled folders)
  • filter packs by Free or Premium
  • check for and download a plugin update via the Plugin Update entry
  • open the Recommended Plugins list (the same view as /resurrectionchest recommendedplugins)
  • turn Automatic Updates on or off (the nightbreak.autoDownloadPluginUpdates setting — see Config and Permissions)
  • read installation instructions and open relevant Nightbreak links via the info button

When a pack is installed or uninstalled, ResurrectionChest reloads FreeMinecraftModels automatically so the chest props refresh.

/resurrectionchest downloadall downloads the plugin update (if any) and every available ResurrectionChest content pack from Nightbreak in one go (requires a linked Nightbreak account). /resurrectionchest downloadallcontent downloads only the content packs, and /resurrectionchest updatecontent (alias updateallcontent) re-downloads only the content packs that are outdated.

If a pack's files got damaged or deleted while the version number still reads as current, /resurrectionchest forcereinstallcontent <package|all> re-downloads it anyway. The package argument tab-completes to all, wooden-chest, and angelic-chest; use all to redo every pack that is already downloaded, or name the slug directly if a pack's files went missing entirely.

Manual Imports​

Downloads land in, and hand-placed packages can be dropped into:

plugins/ResurrectionChest/imports

Leave package archives intact. ResurrectionChest unpacks the folder on startup, routes model files into FreeMinecraftModels, and refreshes FreeMinecraftModels automatically when models were installed. See the shared guide: Manual imports vs in-game management.

Registering A Chest​

  1. Place a chest.
  2. Place a wall sign attached to that chest.
  3. Write the configured trigger text on line 1 or line 2 of the sign.

The default trigger text is:

[DeathChest]

When the sign is accepted, ResurrectionChest:

  • rewrites the sign (line 1 is cleared, line 2 shows the trigger text in purple, line 3 shows the player's display name, line 4 is cleared)
  • stores that chest for the player
  • removes the player's previous registered chest entry if they already had one, including deleting that old chest's setup sign (the old chest block and its contents are left alone)
  • tags the chest and sign blocks with an ownership marker on the following tick, so the plugin can tell its own blocks apart from look-alikes later

There is no command-based chest-registration flow.

Setup Rules​

  • The player needs resurrectionchest.use.
  • Setup is blocked in blacklisted worlds.
  • The accepted sign must be a wall sign attached to a chest.
  • Any wall-sign material works because the code checks for wall-sign block types, not one specific sign material.
  • The block behind the sign must be a plain chest. Trapped chests, barrels, and other containers are rejected.
  • The chest must not already be registered to another player. If it is (either half of a double chest counts), the sign is left as ordinary text and the player is told the chest belongs to someone else.
  • The player must be allowed to build at the chest block. ResurrectionChest routes this through MagmaCore's shared WorldGuard / GriefPrevention lookup, so registering a chest inside a region the player cannot build in is refused with the Chest protected region message text. With no protection plugin installed there is no extra restriction — see Config and Permissions.

Single And Double Chests​

  • A normal single chest works immediately.
  • If a registered chest later becomes part of a double chest, ResurrectionChest detects the change one tick after the block is placed, tags the newly joined half (and any signs on it), and swaps the prop to the double-chest model.
  • If that newly joined half already belongs to a different player's registration, the whole registration is discarded rather than absorbing the other player's chest.
  • Death drops can fill both sides of a double chest inventory.
  • On death, every half of the chest must still carry this player's ownership tag. If one half was replaced out from under the plugin, the chest counts as missing.

Removal Behavior​

Breaking either of these removes the registration:

  • the registered chest
  • an attached sign belonging to that registered chest

When a registration is removed (by any trigger — breaking the chest, breaking the sign, or destroying it through the FreeMinecraftModels prop), the plugin also removes any wall signs still attached to that chest block. Those signs are deleted, not dropped as items.

A registration is also dropped automatically when the plugin can no longer prove the blocks are its own: if any chest half at a stored location has lost its ownership tag, or now carries someone else's, the registration is discarded on the next startup, chunk load, or model refresh and a warning naming the owner's UUID and the chest coordinates is written to the console. The chest block itself is left in place. Sign tags are only re-checked when the plugin re-tags its blocks — when a double chest half is joined, and when an older registration is migrated onto the current ownership tags. Set Enable high compatibility / low security mode for plugin conflicts to true if another plugin on your server strips that block data — see Config and Permissions.

The plugin also cancels attempts to edit the registered setup sign in place.

If a custom chest prop is active, left-click on the prop also removes the registration (only the chest's owner can do this — see Config and Permissions).

Admins can wipe every registered chest at once with /resurrectionchest clear. For each tracked chest it drops the chest's inventory on the ground, then removes the chest and any attached setup signs and clears the stored registration.

Protection Warning​

ResurrectionChest is not a protection plugin.

  • It does not stop other players from opening the physical chest.
  • It does not stop other players from breaking the physical chest or sign if your server protection setup allows that.

Use region protection or another chest-protection solution if you need access control.