CradGacha

---

What is CradGacha?

CradGacha is a gacha (loot crate) plugin for Paper 1.21+ Minecraft servers.

Instead of a normal chest GUI, it shows a floating hologram menu in the world and gives the player a virtual mouse cursor they can move with their mouse to point and click — just like a real game UI. Players pick a crate, open x1 or x10, flip cards to reveal rewards, and can Open Again without leaving the screen.

It is the cursor-only spin-off of an earlier project, rebuilt to be clean and focused.

What is it for?

• Running loot crates / gacha pulls on your server.
• Giving players a polished, modern UI that feels like a custom client — but works on a normal vanilla client (with a resource pack), no client mod required.
• Selling pulls for money (Vault) or a built-in token currency you top up from your store.

Who is it for?

• Server owners who want a good-looking crate/gacha system.
• New admins — you only edit a few YAML files; this wiki walks you through every step.
• Any server — with ItemsAdder / Nexo / Oraxen for the fanciest look, or none at all (the bundled vanilla pack renders the whole menu on MC 1.21.4+).

---

Features

Feature	What it does
Cursor gacha menu	A hologram menu with a virtual mouse cursor (point & click in the world).
Hologram / Display UI	Built from Minecraft Display entities (text, items, images) — no chest windows.
Crate selection	A vertical list of crates on the left; click one to select it.
Open x1 / x10	Open a single card or ten at once. The amount is configurable (max-open).
Result cards	Cards flip over with a Y-axis animation to reveal what you won.
Open All (x10 only)	On a 10-pull, reveal every remaining card at once.
Open Again	Re-roll using the same count as before (still charges the cost).
Back button	Returns to the crate menu — but on a 10-pull it only unlocks after all 10 are revealed.
Economy / cost	Each crate costs NONE, an ITEM, MONEY (via Vault), or TOKEN (built-in points).
Reward system	Rewards can give an item, run commands, or both — with per-rarity drop weights and a pity system.
Tokens	A built-in top-up currency stored in tokens.yml, managed with /gacha token ….
Theme system	A theme.yml lets you move/restyle every button and label without touching code.
Self-diagnostics	/gacha doctor checks your setup (packetevents, ItemsAdder, glyphs, Vault, crates, resource pack).
Reward safety	Rolled rewards are saved to disk immediately, so nothing is lost on crash/disconnect/death.

⭐ Premium adds an in-game editor & crate creator, rate-up events, VIP luck, crate keys, a stats dashboard, a live layout editor and the Developer API (and removes the 3-crate limit). See the Premium page.

---

Quick start (the short version)

1. Install packetevents (required), plus Vault if you sell pulls for money. An item provider (ItemsAdder / Nexo / Oraxen) is optional.
2. Drop the CradGacha jar into your plugins/ folder and start the server.
3. Run /gacha setup — it installs the resource pack for your provider (or vanilla if you have none).
4. Run /gacha doctor to confirm everything is green, then /gacha to open the menu.

The plugin bundles the resource pack and unpacks it on first run — just run /gacha setup. Full details are on the Installation and First Setup pages.

---

Next: Installation →