GokilCrates

Crates your players will actually love opening.
Physical and virtual keys, Milestone Gacha, Shop Gacha, Seasonal Crates
and a full in-game GUI editor, all in one lightweight plugin.
No website. No external service. No file editing needed.

No more endless bad luck. Set a reward on any spin number and players always get it when their spin count reaches it.
- FORCE: that exact spin lands on the reward (e.g. spin 50 = the Legendary Sword).
- BONUS: the player gets the reward on top of the normal roll.
- Once only or loop: start counting again from 0 after the last milestone.
- Players see their progress, the next milestone and its reward in a dedicated milestone menu, in holograms and through PlaceholderAPI.
- Optional broadcast when someone reaches a milestone.

Duplicates are never wasted. Every crate has its own coin, and players spend those coins in the crate's shop.
- Mark special prizes as 1x win: the first win gives the item, every duplicate turns into coins instead.
- Optional coins for every opening, too.
- Name the coin anything (e.g. "Dragon Coins") and build the shop in the editor: price, limit per player, slot.
- Link a shop item to a prize (a 1x prize then counts as owned when bought), or sell your own item or commands.

Event crates that run themselves. Christmas, Halloween, weekend-only or happy-hour crates, no restarts and no manual switching.
- Season: a start and end date, or the same dates every year (e.g. 12-01 to 01-01).
- Weekdays (e.g. only Friday - Sunday) and daily hours (e.g. 19:00 - 23:00, even across midnight).
- While closed the crate stays visible and previewable, so players can look forward to it.
- Live countdown ("Opens in 2d 4h") in holograms, menus and PlaceholderAPI. Your own timezone.
- Different particles while the crate is closed, set right from the editor.
In game: a VIP crate counting down to its season, with per-player access shown in the hologram.


- Physical & virtual keys: choose per crate. Keys of one crate stack automatically, offline players get them when they join, and a full inventory can drop them or turn them virtual.
- Anti-dupe: SERIAL mode signs every key and keeps a ledger of issued and used keys. Duplicated or forged keys are removed and staff get an alert.
- 4 opening animations: CSGO scrolling row, Wheel, Roulette or Instant. Mass open up to 64 at once (sneak-click the crate block or use the menu button).
- Particles: 22 premade effects (Halo, Christmas tree, Aurora, Stardust, Vortex, Snowfall, Hearts ...) and 8 open bursts, drawn only near players with a global particle budget.
- Holograms: DecentHolograms or vanilla text displays, picked automatically, with per-player lines (e.g. "Can you open it: Yes / No").
- Rank crates: lock up to 3 crates to a permission (e.g. VIP only). Every crate also gets its own gokilcrates.open.<crate> permission.
- Any item: vanilla items with full NBT, item models, custom model data, textured player heads, Nexo and MythicMobs items.
- Storage: YAML, SQLite or MySQL/MariaDB (share data across servers).
- Safe updates: new settings are added to your config files automatically, without touching what you changed (a backup is kept).
- Bedrock friendly: every action is a plain button click, so it works through Geyser too.
In game: crate block with particles and a hologram that tells each player if they can open it.

Run /gcrates editor and set up everything in game:
- Prizes: drag & drop an item onto the menu to make it a prize, or add a command prize by typing the command in chat. Weight and chance are shown live.
- Milestones & Shop: pick a prize, drag in your own item, or use commands as the reward.
- Seasonal timer: season, yearly repeat, weekdays and hours, all by clicking.
- Crate menu layout: arrange the crates in /crates by clicking: move, hide, change the number of rows.
- Crate options: animation, key item (just hold it and click), hologram, permission, keys per open, preview, broadcasts, sounds, particles with live preview.
- Global settings: storage, keys, anti-dupe, clicks, cooldowns, mass open, holograms, particles and more.
Two example crates (a normal one with milestones and a shop, and a VIP rank crate) are included, so you can see everything working right away.

- Put the GokilCrates jar in your plugins folder and start the server (Spigot / Paper 1.20.4+, Java 21+).
- Run /gcrates editor and click Create crate (or edit ExampleCrate).
- Look at a block and run /gcrates set <crate> to make it a crate block.
- Give keys: /gcrates give virtual <crate> 1 <player>. Done!
Optional: PlaceholderAPI, DecentHolograms, Nexo, MythicMobs. No other plugins are required.

Players
- /crates [crate]: open the crate menu
Admins (/gcrates, /gcr)
- /gcr give <physical|virtual> <crate> <amount> <player|all> [-s]: give keys (-s = silent)
- /gcr take <physical|virtual> <crate> <amount> <player> [-s]: take keys
- /gcr keys [player]: key balances
- /gcr open <crate> [player] [-f]: open a crate (-f = without a key)
- /gcr massopen <crate> <amount> [player]: open many at once
- /gcr preview|milestones|shop <crate> [player]: open a crate menu
- /gcr menu [player]: the crate list
- /gcr set <crate> / /gcr remove: place / remove the crate block you look at
- /gcr coins <give|take|set|check> <player> <crate> [amount]: shop coins
- /gcr spins <set|reset|check> <player> <crate> [amount]: milestone progress
- /gcr owned reset <player> <crate>: reset 1x wins and shop limits
- /gcr schedule <crate> [...]: seasonal timer
- /gcr particles list / /gcr particles <crate> [...]: particles (incl. live preview)
- /gcr editor [crate]: the GUI editor
- /gcr list / /gcr reload

- gokilcrates.use (everyone): /crates and crate blocks
- gokilcrates.open.<crate> (everyone): open that crate; negate it to lock one crate for a group
- gokilcrates.open.* (everyone): open every crate
- gokilcrates.admin (op): every admin command and the editor
- gokilcrates.command.<sub> (op): one admin sub-command, e.g. gokilcrates.command.give
- gokilcrates.command.* (op): every admin sub-command
- gokilcrates.alerts (op): anti-dupe alerts
Rank crates: set a crate's permission (e.g. gokilcrates.rank.vip) in Options and give it to the rank:
/lp group vip permission set gokilcrates.rank.vip true

%gokilcrates_<key>_<crate>% with <key>:
keys, virtual_keys, physical_keys, coins, currency, currency_singular, spins, progress_spins, opened, next_milestone, next_milestone_in, next_milestone_reward, owned, prizes, crate, status, countdown, schedule_line, opens_in, closes_in, season_start, season_end, open_hours, open_days, access, permission, rank_crate
Also: %gokilcrates_total_opened%, %gokilcrates_rank_crates%, %gokilcrates_rank_crates_max%, %gokilcrates_rank_crates_list%
Menus, chat messages and reward commands run PlaceholderAPI too, so placeholders from other plugins work everywhere.

Found a bug or have an idea? Post it in the Comments tab.
Made with love by Gokilcraft
Comments