SpecializedCrates

SpecializedCrates ships 25 crate animations, each different from the others, and lets you create new ones without programming knowledge. Animations are defined in the configuration files, so a new animation is a config entry rather than a Java plugin. Placed crates can also run one of 8 particle animations while they wait to be opened.

• 25 Built-In Animations — Every animation is a distinct sequence, not a recolour of the same one
• Config-Driven Builder — Describe any animation you want in the configuration files, no code required
• 8 Particle Animations — Particle effects around placed crates, any of 8 styles per crate
• Missing a Setting? — Open a ticket on Discord and the option gets added to the builder

Every crate setting can be edited in-game through a GUI. Custom items are saved from your inventory straight into the configuration file, and the reward preview menus are laid out in the same editor, across as many pages as you need.

• Edit Everything In-Game — Open the editor with /scrates edit <crate> and change any setting from a GUI
• Save Items from Your Hand — Custom items go from inventory to the config file without hand-writing YAML
• Custom Preview Menus — Design multi-page reward previews exactly the way you want them shown
• Errors Shown In-Game — /scrates errors lists every crate error in-game

Rewards can be guaranteed so every opening hands them out, and any reward can carry a fallback for players who already own it — a rank reward, for example, falls back to something else instead of being wasted. Items from the common custom-item plugins are supported as rewards, NBT tags included.

• Guaranteed Rewards — Rewards that are always given to the player
• Fallback Rewards — If a player already has the reward, they win a different one instead
• Custom Items & NBT — ItemsAdder, Oraxen, AdvancedEnchantments, MMOItems and Head Database items as rewards
• Reward History — /scrates listHistory shows the crate history of an online player

Beyond the classic key-and-block crate, players can find crates while mining, pay money to open a crate, or open crates through an NPC. Keys and crates exist in physical and virtual form, so a player can hold and send keys without an item in the inventory.

• Lucky / Miner Chests — Crates appear when players mine the blocks you choose — a natural fit for prison servers
• Economy Crates — Let players pay money to open a crate
• NPC Crates — Open crates through Citizens NPCs (Citizens v2 required)
• Crate Holograms — Floating labels above crates via DecentHolograms or CMI
• Virtual Keys & Crates — Give keys and crates with -v, let players check and send them with /scrates virtualkeys
• Claim Menu — Players collect pending rewards from the /scrates claim menu

Everything runs under /scrates (specializedcrates.admin covers all of it), with per-command permission nodes for staff roles. PlaceholderAPI exposes cooldowns, virtual key counts and last-opened information for scoreboards and holograms.

• Crate Management — setcrate, spawnCrate <crate> <world> <x> <y> <z>, deleteCrate, delAllCrateType, listCrates, reload
• Giving & Opening — giveKey / giveCrate <crate> <player> <amount> [-v], open <crate> (player), forceOpen <crate> <player|all>
• Player Commands — virtualCrates, virtualkeys [<crate> <player>], virtualkeys send <player> <crate> (amount), claim
• Toggles & Info — luckyChest, toggleParticles, config, edit <crate>, info, errors, listHistory
• Permission Nodes — specializedcrates.config, .give, .history, .listcrates, .info, .luckychestcommand, .virtualcrates, .claim, .virtualkeys (.other, .send)
• PlaceholderAPI — %specializedcrates_cooldown_<crate>%, _virtual_keys_<crate>%, _virtual_keys_total%, _virtual_crates_<crate>%, _placedcrates%, _last_crate_opened%, _last_crate_opened_rewards%, _last_player_<crate>%, _last_reward_<crate>%, _last_reward_name_<crate>%