A hologram-based gacha (loot crate) system — no boring chest GUI. Players navigate a fully in-world animated menu with a real-feeling virtual cursor, watch a 3D open animation, then flip cards to reveal rewards.

✨ WHY CRADGACHA?

Most crate plugins are a flat chest inventory. CradGacha renders the whole menu in 3D in front of the player — banner, buttons, cursor, cards, live pity bar — with a spectator camera-lock and owner-only visibility: a whole crowd can open crates at the same spot without seeing each other's UI, bodies, or locator dots.

🌟 FEATURES

Menu
• 3D cursor-driven UI — real-mouse feel via client-side glide (motion at full frame rate), in-game speed/smoothing settings
• Owner-only & crowd-safe — others are hidden while you browse; they see you standing normally (packet body-double)
• Clean stage — the area is cleared to air client-side (no teleport, world untouched)
• 3D open animation via BetterModel OR ModelEngine, picked by the rarest reward, per-rarity animations
• Card-flip reveal · x1 / x10 / Open All / Open Again

Gacha
• Weighted rarities, fully configurable
• Hard pity + soft-pity ramp (per-crate override) with an animated pity bar + level-up sound
• Wishlist — players target a reward and steer their luck
• Pull suspense drum-roll · server-wide broadcast fired only AFTER the flip (no spoilers)
• Duplicates reveal as "+N ✦ Spark" right on the card

Economy & retention
• Duplicate → Spark + Spark Exchange shop · Token Shop (renameable currency)
• Costs: ITEM, MONEY (Vault), TOKEN, PLAYERPOINTS, NONE · multi-cost
• /gacha history per player
• Bulletproof reward safety — rewards survive ESC / disconnect / death / crash (on-disk pending + recovery), dupe-proof economy flow

Customization
• Fully theme-able (theme.yml): every element as glyph/item/text — position, scale, hitbox · multiple themes (clone/switch)
• Multi-crate, per-crate banner/rewards/shop/wishlist · time-limited crates
• Per-reward glow, size, message & title · PlaceholderAPI · translatable language file

⚡ ONE-COMMAND SETUP

/gacha setup detects your item provider and installs everything — UI pack, config, and it auto-merges the ModelEngine pack into your provider's resource pack. Re-runs never overwrite files you customized (setup force restores defaults). No item plugin? Vanilla mode ships its own pack and the plugin HOSTS it for you, auto-sent on join.

💎 PREMIUM (OPTIONAL UPGRADE JAR)

Drop in the Premium jar, restart — edit 100% in-game, no YAML.
• Reward & Settings editor — /gacha edit: rewards, cost, pity, drops, keys… set items from hand or pick from inventory
• Crate Creator — /gacha create, fully in-game
• Live Layout editor — /gacha layout [theme]: drag/resize/duplicate, create text, set images from the button Library, assign click functions
• Config editor — /gacha config with hover descriptions on every setting
• Stats dashboard + 1,000-roll simulator · Rate-Up events · VIP luck · Crate keys
• Developer API (events + facade) · Unlimited crates (Free = 3)

🎨 WORKS WITH ANY PACK SYSTEM

Nexo, ItemsAdder, Oraxen, or vanilla (self-hosted pack). The ready-made CradGacha UI pack ships for all of them, each with a matching pre-set config — drag-and-drop and go. A bundled converter (GUI + .exe) moves your art between systems.

📦 INCLUDED

• CradGacha (Paper 1.21+), Free + optional Premium jar
• CradGacha animated UI pack (Nexo / IA / Oraxen / vanilla)
• Pack converter tool · Full wiki (EN+TH) with changelog

⚙️ REQUIREMENTS

• Paper 1.21+ (tested 1.21.4 – 1.21.11) · packetevents (required)
• Optional: Vault, PlaceholderAPI, PlayerPoints, ModelEngine or BetterModel (Java 25), Nexo/IA/Oraxen

📚 LINKS & SUPPORT

• Discord: Discord Click
• Wiki / Documentation: Wiki Click
• Made by 3BSTUDIO