—<\/p>\n
## \ud83d\udce6 SafeChest v0.0.5 \u2014 The Ultimate Player Safety & Server Management System<\/p>\n
> **Tired of losing everything when you die?** SafeChest automatically saves your entire inventory, armor, and off-hand item into a chest at your death location. Recover it easily \u2014 no more rage-quitting after falling into lava!
\n>
\n> **Version 0.0.5 is a REVOLUTION.** We\u2019ve added professional admin tools, sound effects, animated holograms, PlaceholderAPI integration, pagination, live GUI updates, and fixed critical performance bugs. This isn\u2019t just a Death Chest plugin \u2014 it\u2019s the **ultimate safety net and server management suite** for your players and staff.<\/p>\n
—<\/p>\n
## \u2728 Key Features \u2014 v0.0.5 Edition<\/p>\n
\ud83d\udee1\ufe0f **Auto-Protection & Anti-Griefing**
\nOnly you (or admins) can open or break your chest. Configurable protection from entity\/block explosions. **Breaking your own chest now instantly restores your inventory \u2014 no more misclicks!**<\/p>\n
\u23f3 **Live Multi-Line Animated Hologram Timer**
\nFloating display shows your name, item count, and real-time countdown. **Survives server restarts.**
\n\u2728 **NEW:** Holograms now **blink in red\/yellow** when time is running out (configurable threshold and colors).
\n\u2728 **NEW:** Option to blink **only the `{time}` placeholder** for subtle, elegant alerts.<\/p>\n
\ud83e\udded **`\/sctp` \u2014 Teleport to Chest (Index Support)**
\nOne click, and you\u2019re back at your death spot. Use `\/sctp 2` to teleport to a specific chest from your list. Configurable “force teleport” if no safe spot is found.
\n\ud83d\udd0a **NEW:** Play a configurable sound on teleport.<\/p>\n
\ud83e\uddf2 **`\/scfetch` \u2014 Bring Chest to You**
\nPerfect for deaths in the void, lava, or caves. The chest (and its hologram) move with you.
\n\ud83d\udd0a **NEW:** Play a configurable sound on fetch.<\/p>\n
\ud83d\udc41\ufe0f **`\/scpreview` \u2014 Live Peek Inside (Auto-Refresh & Close Button)**
\nView chest contents without moving \u2014 safe and read-only. Fully customizable GUI.
\n\u2728 **NEW:** GUI **auto-refreshes every 5 seconds** from the database. If the chest expires while you\u2019re viewing it, the GUI closes automatically.
\n\u2728 **NEW:** Dedicated **BARRIER close button** in slot 44 for explicit closure.<\/p>\n
\ud83d\udccb **`\/sclist` \u2014 All Active Chests (With Pagination!)**
\nClickable list of all your chests. Teleport to any instantly. Sort by time, filter by world, show UUIDs.
\n\u2728 **NEW:** Results are now **paginated (5 per page)** with clickable `[Previous]` and `[Next]` buttons. Use `\/sclist 3` to jump to page 3.<\/p>\n
\ud83d\udcb0 **Vault Economy Support (With Logging)**
\nCharge players for `\/sctp` or `\/scfetch` \u2014 configurable per group. Action Bar feedback on payment.
\n\ud83d\udcdd **NEW:** All payments and chest interactions are now **logged to the server console** for auditing and debugging.<\/p>\n
\ud83d\udc65 **Group-Based Configuration (With Custom Chest Materials!)**
\nDefine custom rules for `default`, `vip`, `admin` \u2014 different durations, limits, prices, **and even chest materials** (e.g., VIPs get Barrels, Admins get Shulker Boxes).
\n> \ud83d\udca1 Players are assigned to the **first group** they have permission for.<\/p>\n
\ud83d\udcac **Interactive Death Messages (With Dynamic Cost & Time)**
\nAfter dying, get clickable buttons: **[TP]**, **[FETCH]**, **[PREVIEW]**. **Fully configurable per button.**
\n\u2728 **NEW:** Hover text for buttons now shows **dynamic placeholders** like `{cost}` and `{time}`. Example: `”Cost: 50 coins. Expires in: 2m 30s.”`<\/p>\n
\ud83d\udcbe **Persistence & Auto-Restoration**
\nSupports **SQLite or MySQL** storage. **Chests and holograms are restored on server start.**
\n\u26a0\ufe0f **IMPORTANT:** Table name changed from `angelchests` to `safechests` \u2014 **manual migration required** on update.<\/p>\n
\u2699\ufe0f **Ultra-Configurable**
\nControl **everything**: particle types, action bar messages, GUI titles, button visibility, world restrictions, explosion protection, **sounds, hologram animations, and much more** \u2014 all editable in `config.yml`.<\/p>\n
\ud83d\udd04 **`\/safechestreload`**
\nReload configs without restarting the server \u2014 essential for live admins. Safer than `\/reload`.<\/p>\n
\ud83c\udfa8 **Visual & Audio Feedback**
\n\u2764\ufe0f Configurable particles on creation. \u2728 Configurable particles on recovery. Optional Action Bar messages.
\n\ud83d\udd0a **NEW:** Configurable **sounds** on creation, restore, teleport, and expiration.<\/p>\n
\ud83c\udf10 **Multi-World Support**
\nEnable or disable the plugin in specific worlds. Filter `\/sclist` to show only the current world.
\n\u2728 **IMPROVED:** Configuration now uses `behavior.disabled-worlds` (a blacklist) for clearer logic.<\/p>\n
\ud83e\udde0 **PlaceholderAPI Integration**
\n\u2728 **BRAND NEW:** Use placeholders like `%safechest_time_left%`, `%safechest_item_count%`, `%safechest_location%` in **any plugin that supports PlaceholderAPI** (scoreboards, chat, menus, etc.).<\/p>\n
\ud83d\udee0\ufe0f **Admin Command Suite (`\/safechestadmin`)** \u26a0\ufe0f **Critical Bug Fixes:** —<\/p>\n ## \ud83d\udcd8 Wiki: How to Use SafeChest v0.0.5<\/p>\n ### \ud83e\udded 1. Basic Usage (For Players)<\/p>\n #### \ud83d\udc80 When You Die #### \ud83d\udce5 To Recover Your Items #### \ud83d\udc40 Preview Your Chest (No Movement Needed) #### \ud83d\udccb List All Your Active Chests (Paginated!) —<\/p>\n ### \u2699\ufe0f 2. Configuration (For Server Admins)<\/p>\n #### \ud83d\udcc1 Files You Can Customize<\/p>\n – `config.yml` \u2014 **Main settings**: storage, chest material, hologram text, particle types, death message buttons, GUI options, world restrictions, explosion protection, **sounds, hologram animations, logging, and much more**. #### \ud83c\udfaf Example: Creating a VIP Group<\/p>\n In `groups.yml`:<\/p>\n “`yaml Then, give players the permission: > \ud83d\udca1 Players are assigned to the **first group** they have permission for.<\/p>\n #### \ud83d\udd8b\ufe0f Customizing the Hologram & Death Message<\/p>\n In `config.yml`:<\/p>\n “`yaml # \u2705 NEW SECTION: HOLOGRAM ANIMATION death-message: Placeholders (for `hologram-text`, `lang.yml`, and death message hovers): > \u2705 **Multi-line holograms are now fully supported and restored on server restart.**<\/p>\n #### \ud83c\udfae Customizing the Player Experience<\/p>\n In `config.yml`:<\/p>\n “`yaml # \u2705 NEW SECTION: SOUNDS commands: aclist: #### \ud83d\udee1\ufe0f Advanced Behavior Control<\/p>\n In `config.yml`:<\/p>\n “`yaml —<\/p>\n ### \ud83d\udcb0 3. Economy Setup<\/p>\n SafeChest integrates with **Vault**. Make sure you have a compatible economy plugin installed (e.g., EssentialsX, CMI).<\/p>\n #### \ud83d\udcb5 Charging for Commands<\/p>\n In `groups.yml` or `config.yml`, set prices:<\/p>\n “`yaml Players will be charged automatically when using `\/sctp` or `\/scfetch`.<\/p>\n > \u2705 If Vault is not installed, these features are silently disabled \u2014 no errors. (`softdepend: [Vault]`).<\/p>\n —<\/p>\n ### \ud83d\udd04 4. Reloading Configurations<\/p>\n As an admin, you can reload all configurations **without restarting the server**:<\/p>\n “`bash **Required Permission:** `safechest.reload`<\/p>\n This command: > \ud83d\udeab **Warning:** Avoid using `\/reload` during heavy server activity. `\/safechestreload` is much safer.<\/p>\n —<\/p>\n ### \ud83d\udee1\ufe0f 5. Permissions (Renamed!)<\/p>\n | Permission | Description | Default | > \u2705 Use LuckPerms, PermissionsEx, or any other permission manager to assign these.<\/p>\n —<\/p>\n ### \u2753 6. FAQ & Troubleshooting \u2014 v0.0.5<\/p>\n **Q: Why aren\u2019t my items being saved?** **Q: The hologram disappeared after a restart!** **Q: I get \u201cInitializing… try again later\u201d.** **Q: Can I change the chest to a Barrel or Shulker Box?** **Q: How do I disable the death message buttons?** **Q: My players are complaining about double drops!** **Q: How do I make `\/sctp` work even if there\u2019s no \u201csafe spot\u201d?** **Q: How do I upgrade from v0.0.4?** **Q: How do I see server stats?** **Q: How do I delete a specific chest?** —<\/p>\n","protected":false},"excerpt":{"rendered":" Never lose your items again! SafeChest automatically saves your inventory in a protected chest when you die. Teleport or fetch it back with simple commands.<\/p>\n","protected":false},"featured_media":135243,"template":"","meta":{"_minecraft_slug":"safechest","_minecraft_project_id":"7CmPGtjq","_minecraft_author":"SicklySurgeon","_minecraft_license":"MIT","_minecraft_downloads":218,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"safechest.zip","_minecraft_size_bytes":583304,"_minecraft_version_count":7,"_minecraft_updated_at":"2026-05-16T12:30:52.915002Z","_minecraft_date_created":"2025-09-10T01:59:02.464142Z","_minecraft_date_modified":"2026-03-14T00:00:28.743733Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/safechest","_minecraft_icon_attachment_id":135243,"_minecraft_imported_at":"2026-06-07T23:38:05+00:00","_minecraft_import_hash":"5cb5e624a72bc089218d1af0ed1fc09f","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,89,127,128,129,91,92],"mod_loader":[130,132,133,134],"minecraft_version":[110,111,112,113,114,115,116,117,118,119,120,46,47,48,49,50,51,52,53,54,55,56,57,58,59,36,60,93,94,101,102,62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-135242","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-bukkit","mod_category-game-mechanics","mod_category-paper","mod_category-purpur","mod_category-spigot","mod_category-storage","mod_category-utility","mod_loader-bukkit","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","minecraft_version-1-14","minecraft_version-1-14-1","minecraft_version-1-14-2","minecraft_version-1-14-3","minecraft_version-1-14-4","minecraft_version-1-15","minecraft_version-1-15-1","minecraft_version-1-15-2","minecraft_version-1-16","minecraft_version-1-16-1","minecraft_version-1-16-2","minecraft_version-1-16-3","minecraft_version-1-16-4","minecraft_version-1-16-5","minecraft_version-1-17","minecraft_version-1-17-1","minecraft_version-1-18","minecraft_version-1-18-1","minecraft_version-1-18-2","minecraft_version-1-19","minecraft_version-1-19-1","minecraft_version-1-19-2","minecraft_version-1-19-3","minecraft_version-1-19-4","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n
\n\u2728 **BRAND NEW:** A powerful toolkit for server staff:
\n* `inspect
\n* `delete
\n* `purge`: Manually purge all expired chests from the database.
\n* `stats`: Show server-wide statistics (total active\/expired chests, players with chests, etc.).<\/p>\n
\n* **\ud83d\udc1e Fixed: Deadlock on Chest Interaction\/Breaking** \u2014 No more server freezes when clicking or breaking chests. Operations are now fully asynchronous.
\n* **\ud83d\udc1e Fixed: Hologram Timer Inactive on Restart** \u2014 Holograms now start their countdown timer correctly after a server reboot.
\n* **\ud83d\udc1e Fixed: Economy Errors Not Logged** \u2014 Payment failures are now logged to the server console for easy debugging.<\/p>\n
\n– A chest will automatically appear at your death location.
\n– All your items (inventory, armor, off-hand) are stored inside.
\n– You\u2019ll receive a **configurable** chat message with clickable buttons:
\n – **[TP]** \u2192 `\/sctp` \u2014 Teleports you to the chest. Hover shows cost and time remaining.
\n – **[FETCH]** \u2192 `\/scfetch` \u2014 Brings the chest to you. Hover shows cost and time remaining.
\n – **[PREVIEW]** \u2192 `\/scpreview` \u2014 Shows chest contents without moving. Hover shows time remaining.<\/p>\n
\n– **Walk to the chest** and **right-click it** to restore your inventory.
\n– Or use **`\/sctp`** to teleport to it.
\n– Or use **`\/scfetch`** to bring it to you.<\/p>\n
\n“`bash
\n\/scpreview
\n“`
\n– Opens a virtual inventory showing all your stored items.
\n– Completely safe \u2014 you can\u2019t take or modify anything.
\n– The GUI **updates live** every 5 seconds. If the chest expires, the GUI closes automatically.
\n– Click the **red BARRIER** in the bottom row to close it manually.<\/p>\n
\n“`bash
\n\/sclist
\n“`
\n– Shows all your active chests in pages of 5.
\n– **Configurable**: Filter by current world, sort by expiration time, show UUID in hover.
\n– Click any entry to teleport directly to that chest (if you have permission).
\n– Use `\/sclist 2` to jump to page 2.<\/p>\n
\n– `groups.yml` \u2014 Define player groups (e.g., `default`, `vip`, `admin`) with custom durations, chest limits, command prices, **and chest materials**.
\n– `lang.yml` \u2014 Translate or customize every message in the plugin, including **new messages for pagination, admin commands, and logging**.<\/p>\n
\nvip:
\n safechest-duration: 600 # 10 minutes
\n max-allowed-safechests: 10 # Can have up to 10 active chests
\n price-teleport: 50.0 # Costs 50 coins to teleport
\n price-fetch: 100.0 # Costs 100 coins to fetch
\n material: “BARREL” # \u2705 NEW: VIPs get Barrels instead of Chests!
\n“`<\/p>\n
\n`safechest.group.vip`<\/p>\n
\nangelchest:
\n hologram-text: “&a&l[SafeChest]&rn&b{player}n&7{items} items \/ {time}”<\/p>\n
\nhologram-animation:
\n enabled: true
\n threshold-seconds: 10 # Start blinking when 10 seconds or less remain
\n color-on: “RED”
\n color-off: “YELLOW”
\n blink-only-time-placeholder: true # Only blink the {time} part<\/p>\n
\n enabled: true
\n show-buttons: true
\n show-button-tp: true
\n show-button-fetch: false # Disable fetch globally
\n show-button-preview: true
\n“`<\/p>\n
\n– `{player}` \u2014 Player\u2019s name.
\n– `{items}` \u2014 Total number of items in the chest.
\n– `{time}` \u2014 Time remaining until expiration.
\n– `{cost}` \u2014 Cost of the action (for death message hovers).<\/p>\n
\nmessages:
\n use-action-bar: true # Show “Chest Created!” in action bar instead of chat
\n use-particles: true
\n particle-on-create: “HEART”
\n particle-on-restore: “END_ROD”<\/p>\n
\nsounds:
\n enabled: true
\n on-create: “ENTITY_PLAYER_LEVELUP”
\n on-restore: “ENTITY_ENDERMAN_TELEPORT”
\n on-teleport: “ENTITY_ENDERMAN_TELEPORT”
\n on-expire: “ENTITY_ITEM_BREAK”<\/p>\n
\n preview-gui:
\n title: “&6My Items – SafeChest” # Change the GUI title
\n info-item-material: “BOOK” # Change the info item
\n force-close-only-with-esc: true # Only close preview with ESC key<\/p>\n
\n show-only-current-world: true # Only show chests in the player’s current world
\n sort-by-expiration: true # Show expiring chests first
\n show-uuid-in-hover: false # Hide UUID (useful for debugging if true)
\n“`<\/p>\n
\nbehavior:
\n # \u2705 RENAMED: From ‘enabled-worlds’ to ‘disabled-worlds’
\n disabled-worlds: [“world_the_end”] # Disable plugin in The End
\n protect-from-entity-explosions: true # Protect from Creepers
\n protect-from-block-explosions: false # Allow TNT to destroy chests
\n force-clear-drops-on-death: true # Fix double-drop bug
\n“`<\/p>\n
\nprice-teleport: 50.0
\nprice-fetch: 100.0
\n“`<\/p>\n
\n\/safechestreload
\n“`<\/p>\n
\n– Reloads `config.yml`, `groups.yml`, and `lang.yml`.
\n– Clears expired chests from cache.
\n– Reinitializes the plugin container.
\n– **Does NOT break active chests or holograms.**<\/p>\n
\n|————|————-|———|
\n| `safechest.use` | Allows using the Death Chest system | `true` |
\n| `safechest.protect` | Allows protecting your chest from others | `true` |
\n| `safechest.protect.ignore` | Allows opening SafeChests protected of other players | `op` |
\n| `safechest.tp` | Allows using `\/sctp` | `true` |
\n| `safechest.fetch` | Allows using `\/scfetch` | `true` |
\n| `safechest.group.
\n| `safechest.reload` | Allows using `\/safechestreload` | `op` |
\n| `safechest.admin` | \u2705 **NEW:** Allows using `\/safechestadmin` | `op` |<\/p>\n
\nA: Make sure you have permission `safechest.use`. Also, check if the world is **NOT** listed in `behavior.disabled-worlds` in `config.yml`.<\/p>\n
\nA: **Fixed in v0.0.3 and perfected in v0.0.5!** Holograms are now automatically restored and their timers are restarted on server start. If they\u2019re still missing, check server logs for errors.<\/p>\n
\nA: The database is still loading. Wait a few seconds and try again.<\/p>\n
\nA: Yes! In `config.yml`, set globally:
\n“`yaml
\nmaterial: “BARREL”
\n“`
\nOr per-group in `groups.yml`:
\n“`yaml
\nvip:
\n material: “SHULKER_BOX”
\n“`<\/p>\n
\nA: In `config.yml`, set `death-message.show-buttons: false`, or disable individual buttons like `show-button-fetch: false`.<\/p>\n
\nA: Enable `behavior.force-clear-drops-on-death: true` in `config.yml` to fix this.<\/p>\n
\nA: Set `commands.teleport-unsafe-behavior: “force”` in `config.yml`.<\/p>\n
\nA: **CRITICAL:** You must **rename your database table** from `angelchests` to `safechests` before starting the server. Also, update all permissions and commands from `angelchest` to `safechest`.<\/p>\n
\nA: Use the new admin command: `\/safechestadmin stats`.<\/p>\n
\nA: Use `\/safechestadmin delete