Commands

---

There is one base command: /gacha. Tab-completion is built in, so you can press Tab to see the available sub-commands and arguments (admin sub-commands only appear for admins).

Command	What it does	Permission
/gacha	Open the crate-select menu.	everyone
/gacha open <crate> [1|10]	Open a crate directly without the menu (charges cost + cooldown).	everyone
/gacha history	Your own recent pulls + current pity per crate (needs reward-log.enabled).	everyone
/gacha fix [player]	Unstick yourself (or a player) — resets view/camera/gamemode if a menu left you stuck.	self · cradgacha.admin for others
/gacha debug	Toggle the cursor-coordinate overlay (the menu must be open).	everyone
/gacha reload	Reload config.yml, crates.yml, cursor.yml, theme.yml and the menu.	cradgacha.admin
/gacha doctor	Run a setup health-check (packetevents, ItemsAdder, glyphs, Vault, crates, resource pack, and optional Nexo/Oraxen/ModelEngine/BetterModel).	cradgacha.admin
/gacha token <player> · give/take/set <player> <amount>	Show / grant / remove / set a player's token balance.	cradgacha.admin

Premium commands

These only exist in the Premium version (the free jar shows an upsell notice):

Command	What it does	Permission
/gacha edit <crate>	Open the in-game reward + settings editor.	cradgacha.admin
/gacha create <id>	Create a new crate in-game and open the editor on it.	cradgacha.admin
/gacha key give <player> <crate> [amount]	Give a crate's key item (opens the crate free, bypassing cost).	cradgacha.admin
/gacha stats [crate]	Drop-distribution dashboard + top openers (from the reward log).	cradgacha.admin
/gacha layout [theme]	Live layout editor — drag menu elements, retype text, set images from the Library, and assign click functions. With a theme name it switches to and edits that theme.	cradgacha.admin
/gacha config	In-game global config editor — mouse speed, cursor bounds, UI scale, effects, rarities (incl. glow) — no YAML. Hover any setting's label for a description of what it does.	cradgacha.admin
/gacha import <url> [name]	Download a PNG or GIF straight into the active pack (a GIF is auto-sliced into animation frames). See Animations.	cradgacha.admin
/gacha import file <filename> [name]	Same, but from a file dropped in plugins/CradGacha/import/ (for servers with no outbound internet).	cradgacha.admin

Examples

Open the menu:

/gacha

Open the starter crate ten times directly:

/gacha open starter 10

Give a player 100 tokens (works from the console too — useful for store/donation hooks):

/gacha token give Steve 100

Check a player's balance:

/gacha token Steve

Reload after editing a YAML file:

/gacha reload

Notes

• /gacha open still respects the cost, cooldown, inventory-space check, and the "must be on the ground" rule (see Configuration). Opening from the menu skips the ground check, because the player is temporarily a spectator.
• The token sub-commands can be run from the server console, which is how online stores (Tebex, donation plugins, etc.) grant tokens automatically — have them run gacha token give {player} <amount> on purchase.
• /gacha token give works even when the target player is offline.

---

Next: Permissions →