GokilCrates

Crates with milestone & shop gacha, seasonal timers, anti-dupe keys and a full in-game editor

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.

Milestone Gacha

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.

Shop Gacha

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.

Seasonal Crates

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.
VIP crate countdown in game

Features

Feature overview

  • 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.
Crate block with particles and hologram

In-game editor

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.

Installation

  1. Put the GokilCrates jar in your plugins folder and start the server (Spigot / Paper 1.20.4+, Java 21+).
  2. Run /gcrates editor and click Create crate (or edit ExampleCrate).
  3. Look at a block and run /gcrates set <crate> to make it a crate block.
  4. Give keys: /gcrates give virtual <crate> 1 <player>. Done!

Optional: PlaceholderAPI, DecentHolograms, Nexo, MythicMobs. No other plugins are required.

Commands

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

Permissions

  • 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

PlaceholderAPI

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

Support

Found a bug or have an idea? Post it in the Comments tab.

Made with love by Gokilcraft

GokilCrates Team

profile avatar
  • 1
    Projects
  • 11
    Downloads