sCrates — Advanced Crate System ⭑ 26.3 ✅

★ About
sCrates is a feature-complete crate plugin built to give your players a premium crate experience without giving you a headache. Every crate opens in three sequential phases — world effects, a cinematic main animation and a reward reveal — with real-time holograms through DecentHolograms, a deep rarity system, an in-game visual reward editor and a public developer API for third-party integrations.
Every crate lives in its own YML file and everything reloads live: no server restart, no downtime, no players yelling at you.

★ Features

• ✔ Unlimited crates — each with its own YML configuration file
• ✔ 43 opening animations in CSGO / CrazyCrates style (3 sequential phases)
• ✔ 13 ambient idle effects (Circle, Spiral, Astroid and more) that play continuously when nobody is opening
• ✔ Physical, virtual and hybrid keys with a secure transaction system
• ✔ Real-time multiline holograms via DecentHolograms with configurable height
• ✔ 3D item display rendering for animations (1.19.4+, automatic fallback on older versions)
• ✔ Configurable 3D scale, spin speed and billboard mode per crate
• ✔ Custom blocks with Custom Model Data (1.14+) & optional glowing crate blocks
• ✔ Rarity system: Common / Rare / Special / Legendary / Unique
• ✔ Reward types: ITEM / MONEY / EXPERIENCE / COMMAND
• ✔ In-game visual reward editor — edit GUIs in real time, no restarts
• ✔ Reward preview before opening & reward selection mode with reroll support
• ✔ Shift + Right-click bulk opening (opens all available keys at once)
• ✔ Configurable broadcast on crate open with customizable per-crate events
• ✔ Per-IP anti-abuse limit & anti-dupe protection during animations
• ✔ Per-player opening statistics, history & global top leaderboard
• ✔ OfflinePlayer support in commands and statistics
• ✔ 30+ included languages — every message fully customizable
• ✔ SQLite & MySQL backends — JDBC libraries auto-loaded, zero extra downloads
• ✔ Persistent crate locations — placed crates survive server restarts
• ✔ Bedrock support via Geyser / Floodgate
• ✔ WorldGuard region protection & Vault economy
• ✔ PlaceholderAPI placeholders
• ✔ Public developer API for third-party plugins
• ✔ Automatic update checker with admin join notifications
• ✔ Full tab-completion on every subcommand & hierarchical permission nodes
• ✔ Fully customizable sounds, particles and messages

★ Crate Types

• PHYSICAL — a physical block in the world that requires a key to open
• VIRTUAL — opened from command or menu, no physical block required
• HYBRID — a physical block that can also be opened remotely via command

★ Reward Types

• ITEM — custom items with enchantments, lore and Custom Model Data
• MONEY — money via Vault (requires Vault installed)
• EXPERIENCE — experience points
• COMMAND — runs console commands with the %player% placeholder

★ Rarity System
Every reward belongs to a rarity tier that controls its display, colors and feel:

• Common — the everyday rewards
• Rare — a nice step up
• Special — limited or seasonal items
• Legendary — the chase items players grind for
• Unique — one-of-a-kind rewards for special events

★ Animation System
Every crate opens in three sequential phases — pick one effect from each:

• Phase 1 — pre-open world effects (blasting, lightning, rainbow, sonic-boom...)
• Phase 2 — main animation with 3D item display (csgo-gui, snake-gui, swirl, spinner...)
• Phase 3 — reward reveal (firework, helix, fire-spiral, physical-item...)
• Idle — 13 ambient effects that play continuously above the crate when nobody is opening

★ 3D Model Support
Per crate in its YML:

• enabled — toggle 3D item display rendering for animations
• scale — uniform scale multiplier (1.0 = normal, 2.0 = double size)
• spin-speed — continuous rotation in degrees per tick
• billboard — whether the 3D item should always face the player

On Paper 1.19.4+ animations render as real 3D floating items; older versions automatically fall back to the classic rendering — no configuration needed.

★ Player Interaction

• Left-click — preview rewards
• Right-click — open the crate (consumes a key)
• Shift + Right-click — bulk open (opens all available keys at once)
• /scrates open — open virtual crates remotely

★ Commands
Main command: /scrates — aliases: /crates, /crate
The -s flag (where applicable) silently suppresses the target player's notification. All commands support intelligent tab-completion — your fingers will thank you.

★ Permissions

★ Placeholders (PlaceholderAPI)
Main identifier: %scrates_<provider>_<params>%

• %scrates_player_name% • %scrates_player_uuid% — player info
• %scrates_keys_<crate_id>% — amount of virtual keys of that crate
• %scrates_<crate_id>_name% — display name of the crate
• %scrates_<crate_id>_type% — crate type (PHYSICAL / VIRTUAL / HYBRID)
• %scrates_<crate_id>_animation% — ID of the configured animation
• %scrates_<crate_id>_rewards% — amount of configured rewards

Hologram tags (used inside crate hologram text): {crate_name}, {crate_id}, {rewards_count}, {opens_count}, {online_players}, {current_date}, {current_time}

★ Configuration
One file per job — all of them live in plugins/sCrates/:

File	Purpose
config.yml	General configuration (database, prefix, performance)
animations.yml	Animation definitions
keys.yml	Key configuration
effects/ambient.yml	Ambient idle effects
effects/open.yml	Opening effects
messages.yml	Global messages
crates/<id>.yml	One crate per file
locations.yml	Persistent placed crate locations (auto-managed)
lang/<locale>.yml	Language files

★ Setup (60 seconds)

1. Drop the jar in /plugins (make sure DecentHolograms is installed too) and restart the server.
2. Create your first crate: /scrates create <name>.
3. Look at a block and run /scrates attach <name>.
4. Run /scrates reload — and you're done.
5. Players right-click to open, left-click to preview.

★ Networks & Storage
SQLite works out of the box with zero configuration — a local file, nothing to install. For BungeeCord / Velocity networks, switch to MySQL in config.yml on every server pointing to the same database: keys and statistics sync instantly across your whole network.
JDBC libraries are automatically loaded via the libraries field in plugin.yml, so you don't have to download anything extra.

★ Developer API
sCrates exposes a public API that lets other plugins:

• ✔ Register crates dynamically
• ✔ Hook custom rewards
• ✔ Listen to opening events
• ✔ Access the KeyManager and CrateManager
• ✔ Integrate their own placeholders

★ Update Checker
sCrates automatically checks for updates on startup by querying the Spigot API. Admins ( scrates.admin) are notified on join when a new version is available. You can also manually check with /scrates update.

★ Compatibility

• Paper 1.12.x → 26.x — all major Paper forks supported
• No NMS — public Bukkit / Spigot API only
• Java 21 or higher
• 3D Display entities on 1.19.4+ (automatic fallback on older versions)

★ Dependencies

• DecentHolograms — required (holograms)
• Vault — optional (MONEY rewards)
• PlaceholderAPI • WorldGuard • Geyser / Floodgate — optional

★ Languages
30+ locales included: en_US, es_ES, es_AR, es_MX, pt_BR, fr_FR, de_DE, it_IT, nl_NL, ru_RU, uk_UA, pl_PL, sv_SE, no_NO, da_DK, fi_FI, cs_CZ, el_GR, ro_RO, hu_HU, tr_TR, ar_SA, he_IL, hi_IN, ja_JP, ko_KR, zh_CN, zh_TW, th_TH, vi_VN, in_ID — every single message fully customizable.