sCrates — Advanced Crate System ⭑ 26.3 ✅

sCrates
Premium crates with cinematic 3-phase animations, holograms & a full in-game editor
Paper | 1.12.x → 26.x | Java 21+

★ 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/:

★ 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.

display-name: "&#F39C12&lVote Crate"
type: PHYSICAL
rarity: RARE
hologram:
  enabled: true
  height: 1.8
  lines:
    - "&#F39C12&l%crate_name%"
    - "&7Requires a &fVote Key"
block:
  glowing: true
  custom-model-data: 1001
display-3d:
  enabled: true
  scale: 1.5
  spin-speed: 3.0
  billboard: true
animations:
  first: fire
  second: csgo-gui
  third: firework
  ambient: spiral
rewards:
  diamonds:
    type: ITEM
    chance: 40.0
    display-name: "&bDiamonds x16"
    items:
      - "DIAMOND:16"
  vip-rank:
    type: COMMAND
    chance: 10.0
    commands:
      - "lp user %player% parent settemp vip 30d"

★ 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.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Need help? Join our Discord
discord.gg/fNHvsWFaGZ