TreasureSpawn | Random Treasure Chests & Mimic Traps [1.21+]

What is TreasureSpawn?
TreasureSpawn spawns random treasure chests in the world around your online players as they explore. Each chest rolls a tier (Common → Mythic), fills itself from your custom loot tables, and can float a hologram above it. Open it and you might strike gold… or trigger a mimic trap that screams, launches you, poisons you or blows up. It turns ordinary walking around into a constant treasure hunt — zero commands needed from players.
A chest is one use: take what you want and, the moment you close it, it is gone along with anything left inside. Opening one "just to look" costs you the whole thing.
Everything is fully configurable and translated into 4 languages.
✨ Features

• Automatic random chests — every player has their own spawn timer. When it expires and they are out exploring, a chest appears near them at a min–max distance. No player command needed, and nobody is waiting in a queue behind everyone else.
• Chest tiers — Common, Rare, Legendary, Mythic (add your own): each with its own weighted chance, loot table, block (barrel, chest, shulker box…), roll count and colored title.
• Custom loot tables — per-item drop chances, amount ranges, and MMOItems support for RPG servers.
• Mimic traps — a % of chests are traps. Mix and match effects: ghast scream, launch player, potion effects, instant-explode creepers, lightning, explosions, ignite, cage the player, random teleport, Vault money penalty, fake-loot troll, run console commands — or a LUCKY mimic that rewards instead of punishing.
• Holograms — a floating label above each chest (via DecentHolograms), fully formatted, showing the tier.
• Ownership & protection — chests can be private to the player they appeared for, either for as long as they last or only for a while, after which anyone who walks past can claim them. Breaking them and using them as trash cans can be blocked too.
• AFK-proof — a player has to have actually moved recently to be included, so parked alt accounts collect nothing overnight. Configurable, and you can switch it off.
• WorldGuard aware — don't spawn where players can't build, a strict "no regions at all" mode, and a per-region treasurespawn flag.
• Smart spawn control — enabled worlds, surface / underground / anywhere height modes, Y limits, max chests per world, a cap on how many may appear at once (anti-lag) and an unclaimed-chest despawn timer.
• VIP cooldown reductions — give a permission and that player's spawn cooldown drops by a %. Halve it and they genuinely get twice the chests, which makes it something worth selling with a rank.
• Spawn effects — configurable sound + particles when a chest appears.
• Admin GUI — manage everything from /tsadmin, no need to touch YAML.
• Persistent cooldowns — SQLite (zero setup) or MySQL for networks; cooldowns survive relogs and restarts.
• 4 languages included and fully editable (English, Spanish, French, Chinese).

Dependencies
None are required — TreasureSpawn runs on its own. Every integration below is optional and turns on automatically only if that plugin is installed:

• WorldGuard — respect region build permissions when spawning. https://dev.bukkit.org/projects/worldguard
• DecentHolograms — floating labels above chests. https://www.spigotmc.org/resources/96927/
• MMOItems (+ MythicLib) — put MMOItems in your loot tables. https://www.spigotmc.org/resources/39267/
• Vault + any economy — the money-penalty mimic effect. https://www.spigotmc.org/resources/vault.34315/

⌨️ Commands
Base: /treasurespawn · aliases /ts, /treasure, /randomchest

• /ts spawn — force-spawn a random chest near you (admin)
• /ts give <tier> [player] — give / place a chest of a tier
• /ts reload — reload the config & languages
• /ts ver — version & author
• /tsadmin — open the admin GUI

Permissions

• treasurespawn.spawn — chests can spawn near this player (default: true)
• treasurespawn.admin — admin commands & GUI (default: op)
• treasurespawn.bypass.cooldown — ask for a chest by hand without waiting for the cooldown (default: false)
• treasurespawn.cooldown.<name> — a % cooldown reduction you define in config (for VIPs)

⚙️ Configuration
One clean, commented config.yml plus a loot.yml for your loot tables. Define as many tiers and loot tables as you want, tune every spawn rule, and enable exactly the mimic effects you like — each has its own chance. Most of it can also be done from the /tsadmin GUI, and new options from an update land in your file on their own, with their documentation, leaving your edits alone.
Installation

1. Drop TreasureSpawn.jar into your /plugins folder.
2. Restart the server (Java 21).
3. (Optional) Install WorldGuard, DecentHolograms, MMOItems or Vault for the extra features.
4. Edit config.yml / loot.yml or use /tsadmin, then /ts reload.

Full guide & configuration: https://infinity3113.mc-paradise.com/plugins/treasurespawn/
Licence & Terms
TreasureSpawn is free, but it is not public domain. It remains the work of infinity3113.
You MAY:

• Use it on any server or network, public or private, with no player limit.
• Use it on a server that charges its players (ranks, donations, shops). What you may not charge for is the plugin itself.
• Edit the configuration and language files however you like.
• Translate the language files and share those translations.

You MAY NOT:

• Re-upload or mirror the plugin on any site, marketplace, Discord, forum or file host. Please link to this page instead.
• Sell it, or include it in any paid package, bundle, "plugin pack", server setup or hosting offer.
• Decompile, deobfuscate, reverse-engineer or republish its source code.
• Remove or alter the author credits, the plugin name or the licence notice.
• Claim authorship of it, or present a modified copy as your own work.

TreasureSpawn is an original work. It is not a fork, port or modification of any other plugin.
Provided "as is", without warranty of any kind. The author is not liable for any damage, downtime or data loss arising from its use.
Full terms: infinity3113.mc-paradise.com/plugins/terminos.html
More plugins by infinity3113
https://infinity3113.mc-paradise.com/plugins