ShadowCrates

# 🌏 **ShadowCrates** **ShadowCrates** is a fully customizable **Crate System** for Minecraft Fabric servers. It allows server administrators to create, configure, and manage crates that players can open using special crate keys. With customizable animations, sounds, and rewards! ## 📜 **Features:** - ✅️ **Fully Configurable Crates** - Define crates in JSON format, including rewards, animations, sounds, particle effects, and key items. - ✅️ **Custom Enchantment & NBT Support** - Rewards retain all item properties, including enchantments, custom model data, and atributes. - ✅️ **Configurable Animations** - Set the number of animation steps and intervals for crate opening effects. - ✅️ **Particle Effects** - Choose different particle effects per crate for a visually appealing opening sequence. - ✅️ **Permission-Based Access** - Restrict specific crates using LuckPerms or any permission plugin. - ✅️ **Command Execution** - Run custom commands when a player wins a reward. - ✅️ **Custom Sounds** - Play unique sounds when opening a crate or winning a reward. - ✅️ **Language & Message Customization** - Edit all messages, GUI titles, and lore with full RGB color support. - ✅️ **Crate Location System** - Assign crates to specific blocks in the world, allowing physical crate locations. - ✅️ **Backup System** – Automatic & manual backup creation in `/config/shadowcrates/backups/`, with JSON restore support. - ✅️ **Database Support** – Use SQLite or MySQL to store all crate data (keys, prizes, crate blocks). Auto migration + backup included. - ✅️ **Powerful GUI System** – Preview crates, claim stored prizes, and view virtual keys with fully customizable menus. - ✅️ **Virtual Key System** – Players can store keys virtually, preventing duplication exploits. - ✅️ **Support for Cobblemon Items** – Render Pokémon items (e.g. pokemon:abra) as prize icons and display items in GUIs. ## ⚙️ **Commands:** <details> <summary>Spoiler</summary> - `/crate create <name>` ➜ Create a new crate. - `/crate delete <name>` ➜ Delete an existing crate. - `/crate reload` ➜ Reload all config files. - `/crate set <name>` ➜ Set crate on targeted block. - `/crate unset <name>` ➜ Remove crate from block. - `/crate key give <crate> <amt> <player>` ➜ Give virtual or physical keys. - `/crate key storage` ➜ View your stored keys. - `/crate storage` ➜ Claim prizes stored items. - `/crate clearstorage <player>` ➜ Deleting items from storage. - `/crate backup now` ➜ Manually create a backup. - `/crate backup restore` ➜ Restore from the latest backup. - `/crate key clear <player>` ➜ Clear keys for player. - `/crate key count <player> <crate>` ➜ See stored key count. - `/crate key giveall <amount> <player>` ➜ Give all keys to a player. </details> ## 🔒 **Permissions:** <details> <summary>Spoiler</summary> - `crate.create` ➜ for /crate create - `crate.delete` ➜ for /crate delete - `crate.reload` ➜ for /crate reload - `crate.set` ➜ for /crate set - `crate.unset` ➜ for /crate unset - `crate.storage` ➜ for /crate storage - `crate.clearstorage` ➜ for /crate clearstorage - `crate.key.give` ➜ for /crate key give - `crate.key.storage` ➜ for /crate key storage - `crate.key.clear` ➜ for /crate key clear - `crate.key.count` ➜ for /crate key count - `crate.key.giveall` ➜ for /crate key giveall - `crate.backup` ➜ for /crate backup now & /crate backup restore </details> ## 🎞 **Animations:** List of animation formats for opening crate: <details> <summary>Spoiler</summary> - `default` - `instant` - `csgo` - `slots` - `vortex` - `wheel` - `pick` - `meteor` </details> List of animation formaats for idle particles: <details> <summary>Spoiler</summary> - `orbit` - `dual_orbit` - `ring` - `pulse` - `spiral` - `spring` - `flower` - `star` - `rays` - `rain` - `stack` - `sparkle` - `meteor_rain` - `ring_vertical` - `burst` - `comet` </details> ## 📂 **Configuration Files:** - 📁`/config/shadowcrates/config.json` – General settings, messages, and toggles. - 📁`/config/shadowcrates/crates/*.json` – Crate definitions including items, commands, probabilities, and keys. - 📁`/config/shadowcrates/menu_preview.json` – Preview GUI configuration. - 📁`/config/shadowcrates/menu_storage.json` – Crate reward storage GUI. - 📁`/config/shadowcrates/menu_key_storage.json` – Virtual key storage GUI. - 📁`/config/shadowcrates/data/` – Stores crate block locations. - 📁`/config/shadowcrates/backups/` – Auto/manual backup folders !(https://cdn.modrinth.com/data/f136wypQ/images/63ad7ccb10cfe1567733839fa822b8d367993cb1.gif)