sCrates — Advanced Crate System ⭑ 26.3 ✅

sCrates v1.6 Daily bonus system, live updater NPE fix, and a new free-keys feature. New Feature · Daily Bonus System — Players can now claim free keys every 24h via /scrates daily. The system includes: · Streak bonus — bonus keys grow every N days (configurable milestone, default 7) · Streak reset — missing a day (more than 2x cooldown elapsed) resets the streak to 1 · Auto-notification — players are notified on join when their daily bonus is available · Info command — /scrates daily info shows current streak, total claims, next reward amount, and cooldown remaining Configuration (config.yml): Code (Text): daily-bonus: enabled: false cooldown-hours: 24 key-id: common_key base-amount: 1 streak-bonus: 1 streak-milestone: 7 max-streak-bonus: 5 New permission: Code (Text): scrates.daily (default: true) Bug Fixes · Hologram Live Updater NPE on Disable — The 30-second hologram refresh task could throw a NullPointerException during plugin shutdown if crateManager was already nulled. Added guards to skip execution if the plugin is disabled or any manager is null. Performance · New database table scrates_daily_bonus created automatically on first launch (both SQLite and MySQL providers). Thank you for using sCrates. If you enjoy the plugin, please consider leaving a review.​

sCrates v1.5 Hologram cleanup, item-stealing fix, bulk-open cap, and lock leak prevention. Improvements · Orphaned Hologram Cleanup — On every reload, sCrates now automatically removes holograms whose crates no longer exist (e.g. after a YML file is deleted or renamed). No more "ghost holograms" floating in the world. · Global Bulk-Open Cap — A new max-bulk-keys setting in config.yml lets you set a server-wide limit for sneak + right-click bulk opens. Per-crate limits can still override this with a smaller value, but never a larger one. Bug Fixes · Item Stealing via Shift-Click — Fixed a loophole where players could shift-click items from their own inventory INTO a sCrates GUI (preview, list, editor) and effectively clone display items into their inventory. All shift-clicks from the bottom inventory are now cancelled while a sCrates GUI is open. · Pending-Open Lock Leak — If an unexpected exception occurred during the async key-consume chain (e.g. database timeout), the player's "pending open" lock was never released, permanently locking them out of opening crates. A safety net now force-releases the lock after 10 seconds if the player is not actually animating. New Configuration Code (Text): # config.yml interaction: # Global cap for bulk-open (sneak + right-click). Per-crate max-bulk-keys can # override this with a SMALLER value, but never a larger one. Default 64. max-bulk-keys: 64 Thank you for using sCrates. If you enjoy the plugin, please consider leaving a review.​

sCrates v1.4 MiniMessage color format, bStats metrics, new placeholders, and a bug fix. New Features New Placeholders (PlaceholderAPI) · %scrates_player_total_opens% — Total crates opened by the player · %scrates_player_rank% — Leaderboard rank of the player (1-based, 0 if unranked) · %scrates_<crate_id>_opens% — Total openings of that specific crate Bug Fixes · Fixed InventoryClickEvent not being cancelled during animations — players could previously move items in their inventory while a crate was opening, leading to potential item duplication or animation glitches. Configuration Example (metrics.yml) Code (Text): # plugins/sCrates/metrics.yml enabled: true server-uuid: <auto-generated> Thank you for using sCrates. If you enjoy the plugin, please consider leaving a review.​

sCrates v1.3 ItemsAdder integration, live hologram placeholders, and bug fixes. New Features · ItemsAdder Support — Crate blocks and keys can now use custom 3D items from ItemsAdder via namespace IDs (e.g. Code (Text): itemsadder:custom_chest ). Falls back to vanilla materials automatically when ItemsAdder is not installed. · Live Hologram Placeholders — Placeholders like {online_players}, {current_time} and {opens_count} now refresh automatically every 30 seconds without needing a reload. Bug Fixes · Fixed /scrates place silently overwriting existing crates or destroying non-air blocks at the target location. · Fixed /scrates givecrate sometimes leaving the target's inventory in a stale state until the player clicked. Improvements · Crate location saves are now debounced and async — placing or breaking multiple crates in quick succession only writes to disk once per second, reducing I/O overhead. · ItemsAdder added as a soft-dependency in plugin.yml. Configuration Example (ItemsAdder) Code (Text): # In crates/<id>.yml block: "itemsadder:custom_chest" # In keys.yml keys: my_key: material: "itemsadder:custom_key" Thank you for using sCrates. If you enjoy the plugin, please consider leaving a review.​

sCrates v1.2 3D animation support, new admin commands, firework optimization, and persistent crate locations. New Features · 3D Animation Support — Animations like CSGO-gui and spinner now use the Bukkit Display API (ItemDisplay) with configurable scale, continuous spin, and billboard mode. Requires Paper 1.19.4+; automatically falls back to particle-only mode on older servers. · Persistent Crate Locations — Placed crates are now saved to locations.yml and automatically restored on server restart. · 12 New Admin Commands — Full control over crate placement, key management, reward distribution, and cooldowns. · Firework Optimization — Switched to ThreadLocalRandom and reduced sparkle count per burst, lowering CPU overhead on populated servers. · Holograms Survive Reloads — Holograms are re-spawned automatically for every placed crate when /scrates reload is executed. New Commands · /scrates place <crate> <world> <x> <y> <z> [facing] — Place a crate at specific coordinates · /scrates attach <crate> — Attach a crate to the targeted block · /scrates detach — Detach a crate from the targeted block · /scrates setkey <key> <player> <amount> — Set a player's exact virtual key count · /scrates takekey <key> <player> [amount] [-s] — Take virtual or physical keys from a player · /scrates checkkeys <player> — Inspect all virtual keys of a player · /scrates givecrate <crate> <player> [amount] [-s] — Give a physical crate item to a player · /scrates givecrateall <crate> [amount] [-s] — Give a physical crate item to every online player · /scrates resetcooldown <crate> <player> [-s] — Reset a player's open-cooldown for a crate · /scrates givereward <crate> <reward> <player> — Give a specific crate reward to a player · /scrates giverandom <crate> <player> [-s] — Give a random crate reward to a player · /scrates info <crate> — View detailed information about a crate The -s flag (where applicable) silently suppresses the target player's notification message. All commands support intelligent tab-completion. New Configuration (per crate) Code (Text): models-3d: enabled: true scale: 2.0 spin-speed: 12.0 billboard: true New Permissions · scrates.place — Place a crate at coordinates (default: op) · scrates.attach — Attach a crate to the targeted block (default: op) · scrates.detach — Detach a crate from the targeted block (default: op) · scrates.setkey — Set a player's virtual key count (default: op) · scrates.takekey — Take virtual keys from a player (default: op) · scrates.checkkeys — Inspect a player's virtual keys (default: op) · scrates.givecrate — Give a physical crate item (default: op) · scrates.givecrateall — Give a crate item to all online players (default: op) · scrates.resetcooldown — Reset a player's crate cooldown (default: op) · scrates.givereward — Give a specific crate reward (default: op) · scrates.giverandom — Give a random crate reward (default: op) · scrates.info — View detailed crate information (default: op) Thank you for using sCrates. If you enjoy the plugin, please consider leaving a review.​

sCrates v1.1 Hologram placeholders, leaderboard system, opening history, automatic update checker, and multiple bug fixes. New Features · Hologram Placeholders — Display live crate information directly in holograms with the following placeholders: · {crate_name} — Crate display name · {crate_id} — Crate identifier · {{rewards_count}} — Number of configured rewards · {opens_count} — Total openings of the crate · {online_players} — Current online player count · {current_date} / {current_time} — Server date and time · Leaderboard Command — /scrates top [limit] Shows the top openers across all crates with medal indicators (gold, silver, bronze). · History Command — /scrates history [player] [limit] Displays recent openings for yourself or other players (requires scrates.history.others to view others). · Update Checker — Automatic notifications The plugin now queries the Spigot API on startup to detect new versions. Admins (scrates.admin) are notified on join when an update is available. · Manual Update Check — /scrates update Force-check for updates with this new admin command. Improvements · Default hologram text redesigned with separators, instructions, and live statistics · Welcome banner now displays update status on startup · Height configuration is now applied live on reload (no need to break and replace the crate) · Holograms are updated in-place via DecentHolograms API (no recreation flicker) Bug Fixes · Fixed a race condition where rapidly clicking a non-GUI crate could consume two keys at once · Fixed /scrates keyall not properly delivering keys to online players in some cases · Fixed hologram height being ignored on reload New Permissions · scrates.top — View the leaderboard (default: true) · scrates.history — View own opening history (default: true) · scrates.history.others — View other players' history (default: op) Database Added new statistics tables and queries: · getCrateOpenCount — Total openings per crate · getTopOpeners — Leaderboard query · getPlayerHistory — Recent openings per player Compatible with both SQLite and MySQL/MariaDB backends.