Selvax Crates

A premium, crate plugin system built for Paper servers. A complete reward system featuring animated GUIs, custom ability items, holograms, unique crate keys, KeyAll, and deep configuration.

---

✨ Features

• 🕯️ Auto key — Every 1 hour or 60 min player get 1 Starter key.
• 🎰 5 Crate Types — Starter, Elite, Legendary, Prismatic & Mythic.
• 🎬 Animated Crate GUI — Smooth reward shuffle with configurable duration.
• ✅ Confirmation System — Confirm before claiming; canceled openings return the key.
• 🛡️ Custom Ability Items — Exclusive Prismatic weapons, tools, armor & consumables with unique abilities.
• 🧱 Spawner Rewards — Configurable mob spawners with reliable entity preservation.
• 🎨 Fully Customizable — GUIs, keys, messages, animations, rewards & ability stats.
• 🔒 Anti-Exploit — Opening protection, key verification, drag protection & overflow handling.

---

📦 Crate Types & Rewards

Crate	Key	Rewards	Theme
Starter	🟢 Green Candle	Diamond Gear	Entry-level
Elite	🔵 Cyan Candle	Netherite Gear	Mid-game
Legendary	🟡 Yellow Candle	Mob Spawners	Economy
Prismatic	🟣 Purple Candle	Custom Ability Items	Special
Mythic	🔴 Red Candle	Max-Enchanted Netherite	End-game

---

🔴Note after do /scrates set <crate> place your block like chest or shulker box ...

---

Footage

!crate preview

!crate reward preview !1 !crate confirm preview

---

🎮 Commands

Command	Description	Permission
/scrates	Open the help menu	selvaxcrates.command.help
/scrates help	Show help	selvaxcrates.command.help
/scrates give <player> key <crate> [amount]	Give crate keys	selvaxcrates.command.give
/scrates give all key <crate> [amount]	Give keys to all online players	selvaxcrates.command.give
/scrates set <crate>	Set the targeted block as a crate	selvaxcrates.command.set
/scrates remove	Remove the targeted crate	selvaxcrates.command.remove

Alias: /selvaxcrates

Tab Completion: Commands, players, crate types and key amounts are fully supported.

---

🔐 Permissions

Permission	Description	Default
selvaxcrates.admin	Access to all admin commands	OP
selvaxcrates.command.help	Access help	Everyone
selvaxcrates.command.give	Give crate keys	OP
selvaxcrates.command.set	Set crates	OP
selvaxcrates.command.remove	Remove crates	OP

Players need no permission to open crates.

⚙️ Configuration

Selvax Crates generates 4 configuration files:

config.yml

Controls:

• GUI layout & reward slots
• Crate appearance & keys
• KeyAll timer & rewards
• Animation settings
• Ability stats

messages.yml

• Customize all player-facing messages and placeholders such as %key%, %player%, %crate%, %reward% and %time%.

crates.yml

• Stores crate locations and Legendary spawner configurations.

playtime.yml

• Automatically stores player playtime for the KeyAll system.

---

🔧 How It Works

For Players

Right-click a crate with its matching key. Watch the animated reward GUI. Select a reward. Confirm to claim it or cancel to keep the key. Full inventories safely drop rewards nearby.

For Administrators

Place a block. Use /scrates set <CrateType>. A hologram is created automatically. Give keys with /scrates give. Customize the plugin through the configuration files.

---

🖥️ Compatibility

Platform	Version
Paper	1.21.4+
Java	21+
Dependencies	None

Standalone — powered entirely by the Paper API.

---

📁 Generated Files

plugins/SelvaxCrates/
├── config.yml
├── messages.yml
├── crates.yml
└── playtime.yml

---

📌 Quick Setup

1. Put SelvaxCrate-1.xx.jar in plugins/.
2. Restart the server.
3. Configure config.yml and messages.yml.
4. Set crates with /scrates set <CrateType>.
5. Give keys with /scrates give <player> key <CrateType>.
6. Players can now open crates with their keys.

---

Author: MrEmrald or gimsaad0711

Platform: Paper

Website: selvax.netlify.app

---

© Selvax — All rights reserved.