Test Server
Code (Text):
dev.cracked-mc.net
Features
Unlimited Crate Types: Create as many crates as you want, each with its own unique configuration file for rewards, permissions, animations, and appearance.
Three Crate Modes:
- VIRTUAL: Access crates through the `/keys` command with a virtual key system
- PHYSICAL: Place crates in the world that players can interact with directly
- LOOTBOX: Special items that players can place and activate for explosive opening animations
Advanced Key System:
- Virtual Keys: Stored in player data, accessible via GUI
- Physical Keys: Actual items that players can hold and trade
- Hybrid Support: Each crate can use both virtual and physical keys
Multiple Animation Types:
- GUI Animations: ROULETTE, CASCADE, EXPAND, SHUFFLE
- Block Animations: EXPLOSION, SPIRAL, FOUNTAIN, LIGHTNING
- Customizable Duration: Set animation length per crate type
Physical Crate Interactions:
- Right-click: Open one crate with a key
- Left-click: Preview available rewards
- Shift + Right-click: Open all keys you have for that crate type
Jackpot System: Special jackpot rewards for lootbox crates with configurable chances and broadcast messages.
Hologram Support: Integration with DecentHolograms for floating text above physical crates.
Comprehensive GUI System:
- Virtual keys menu with customizable layout
- Preview GUIs for each crate type
- Fully configurable GUI elements and layouts
PlaceholderAPI Support: Integrate with PlaceholderAPI to display crate and key information in other plugins.
Custom Model Data Support: Full compatibility with resource packs for custom textures on all items.
Advanced Reward System:
- Item rewards with custom names, lore, and enchantments
- Command execution rewards
- Weighted chance system
- Broadcast notifications for rare rewards
Commands & Permissions
The base permission `hypercrates.*` grants access to all features.
| Command | Description | Permission |
|---|---|---|
| /keys | Opens the virtual keys GUI where players can manage and use their keys. | `hypercrates.keys` |
| /crates | Alias for `/keys`. | `hypercrates.keys` |
| /hypercrates help | Shows the help menu with all available commands. | `hypercrates.use` |
| /hypercrates reload | Reloads all configuration files and crate types. | `hypercrates.reload` |
| /hypercrates give <player> <cratetype> <amount> [virtual/physical] | Gives a player keys for a specific crate type. | `hypercrates.give` |
| /hypercrates create <cratetype> | Creates a physical crate block at your location. | `hypercrates.create` |
| /hypercrates set <cratetype> | Sets the block you are looking at as a physical crate location. | `hypercrates.set` |
| /hypercrates lootbox <cratetype> [amount] | Gives you lootbox items for the specified crate type. | `hypercrates.give` |
Additional Permissions
| Permission | Description | Default |
|---|---|---|
| `hypercrates.use` | Basic permission to use crates | `true` |
| `hypercrates.preview` | Permission to preview crate contents | `true` |
| `hypercrates.admin` | Administrative access to all commands | `op` |
Configuration
HyperCrates is configured through several YAML files located in the `plugins/HyperCrates/` directory.
config.yml
This file controls global settings for the plugin.
Code (YAML):
# HyperCrates Configuration
# A highly customizable crate plugin for Minecraft servers
# General Settings
general :
# Check for updates on startup
check-updates : true
# Enable debug mode
debug : false
# Default animation duration (in ticks)
default-animation-duration : 60
# Sound Settings
sounds :
# Enable sounds
enabled : true
# Opening sounds
crate-open : "BLOCK_CHEST_OPEN"
key-use : "ITEM_ARMOR_EQUIP_LEATHER"
reward-received : "ENTITY_PLAYER_LEVELUP"
# Particle Effects
particles :
# Enable particles
enabled : true
# Particles for crate opening
opening-particles : "FIREWORKS_SPARK"
# Particles for rewards
reward-particles : "VILLAGER_HAPPY"
# Broadcast Settings
broadcast :
# Broadcast rare rewards
enabled : true
# Minimum chance to broadcast (percentage)
min-chance : 5.0
# Jackpot Settings (Only for LOOTBOX type crates)
jackpot :
# Maximum jackpot items per crate opening
max-jackpot-items-per-crate : 1
# Always give at least one jackpot item
jackpot-always : false
# Animation Types Available
animations:
gui :
- "ROULETTE" # Classic spinning roulette
- "CASCADE" # Items cascade from top
- "EXPAND" # Items expand from center
- "SHUFFLE" # Items shuffle randomly
block :
- "EXPLOSION" # Explosive particle effect
- "SPIRAL" # Spiral particle effect
- "FOUNTAIN" # Fountain of particles
- "LIGHTNING" # Lightning strike effect
# Hologram Settings
holograms :
# Enable holograms above crate blocks
enabled : true
# Height offset from block
height-offset : 2.0
This file allows you to customize all user-facing messages.
Code (YAML):
# HyperCrates Messages Configuration
# General Messages
prefix : "&6[&cHyperCrates] "
no-permission : "{prefix}&cYou don't have permission to do that!"
player-only : "{prefix}&cThis command can only be used by players!"
reload-success : "{prefix}&aConfigurations reloaded successfully!"
# Crate Messages
crate-not-found : "{prefix}&cCrate type not found!"
crate-created : "{prefix}&aCreated {crate} crate at your location!"
no-keys : "{prefix}&cYou don't have any keys for this crate!"
# Key Messages
keys-given-virtual : "{prefix}&aGave {amount} virtual {crate} keys to {player}!"
keys-given-physical : "{prefix}&aGave {amount} physical {crate} keys to {player}!"
lootbox-given : "{prefix}&aGave {amount} {crate} lootbox(es) to you!"
# Reward Messages
reward-received : "{prefix}&aYou received: &e{reward}"
reward-broadcast : "&6{player} &7received &e{reward} &7from a &6{crate} &7crate!"
# Jackpot Messages
jackpot-won : "{prefix}&6&lJACKPOT! &eYou won: &6{reward}"
jackpot-broadcast : "&6&l*** JACKPOT *** &e{player} &7won &6{reward} &7from a &c{crate} &7lootbox! &6&l***"
# GUI Messages
keys-gui-title : "&6&lVirtual Keys"
preview-gui-title : "{crate} Preview"
Each crate type has its own configuration file in the `crates/` folder. Here's an example:
Code (YAML):
# Example Crate Configuration - VIRTUAL Type
# Basic Settings
display-name : "&aCommon Crate"
permission : ""
# Crate Type: VIRTUAL, PHYSICAL, or LOOTBOX
type : "VIRTUAL"
# Key Settings
keys :
# Use virtual keys (accessible via /keys menu)
virtual : true
# Use physical keys (items in inventory)
physical : false
# Key item configuration
item:
material : "TRIPWIRE_HOOK"
name : "&aCommon Key"
lore :
- "&7A key to open Common Crates"
glowing : false
# Virtual Crate GUI Item (for /keys menu)
virtual-item:
material : "CHEST"
name : "&aCommon Crate"
lore :
- "&7A common crate with basic rewards"
- "&7Click to open with your keys"
# Opening Settings
opening :
# Opening types available: GUI, BLOCK, INSTANT
types :
- "GUI"
# Default opening type
default : "GUI"
# Allow players to preview rewards
preview : true
# Animation type: ROULETTE, CASCADE, EXPAND, SHUFFLE
animation : "ROULETTE"
# Animation duration in ticks
animation-duration : 80
# Hologram Settings (for physical crates)
hologram:
enabled : true
lines :
- "&a{crate_name}"
- "&7Left click to preview"
- "&7Right click to open"
height-offset : 2.0
# Rewards Configuration
rewards:
iron_ingots:
type : "ITEM"
chance : 25.0
display-name : "&7Iron Ingots"
display-item:
material : "IRON_INGOT"
amount : 5
name : "&7Iron Ingots"
item:
material : "IRON_INGOT"
amount : 5
message : "&aYou received 5 Iron Ingots!"
experience:
type : "COMMAND"
chance : 15.0
display-name : "&bExperience Points"
display-item:
material : "EXPERIENCE_BOTTLE"
name : "&bExperience Points"
commands :
- "xp add {player} 100"
message : "&aYou gained 100 experience points!"
For lootbox-type crates, you can configure special jackpot rewards:
Code (YAML):
# Lootbox Crate Configuration
display-name : "&6Legendary Lootbox"
type : "LOOTBOX"
# Lootbox item that players receive
lootbox-item:
material : "ENDER_CHEST"
name : "&6Legendary Lootbox"
lore :
- "&7Place this item on the ground"
- "&7to activate the lootbox!"
glowing : true
# Animation for lootbox opening
opening:
animation : "EXPLOSION"
animation-duration : 100
# Regular rewards
rewards :
# ... regular rewards here
# Special jackpot rewards (only for lootboxes)
jackpot-rewards:
ultra_rare:
type : "COMMAND"
chance : 0.1
display-name : "&d&lUltra Rare Reward"
commands :
- "give {player} netherite_sword 1"
message : "&d&lJACKPOT! You won an Ultra Rare reward!"
VIRTUAL Crates:
- Accessed through `/keys` command
- Keys stored in player data
- GUI-based opening with animations
- Perfect for server-wide events and rewards
PHYSICAL Crates:
- Placed as blocks in the world
- Players interact directly with the block
- Support holograms for information display
- Great for spawn areas and special locations
LOOTBOX Crates:
- Items that players can place and activate
- Explosive opening animations with particles
- Support jackpot reward system
- Ideal for tradeable rare items
Animation System
HyperCrates features 8 unique animations split between GUI and block-based:
GUI Animations (Virtual/Physical):
- ROULETTE: Classic spinning wheel effect
- CASCADE: Items fall from top to bottom
- EXPAND: Items expand outward from center
- SHUFFLE: Items randomly shuffle positions
Block Animations (Lootbox):
- EXPLOSION: Dramatic explosion with particles
- SPIRAL: Magical spiral effect with enchantment particles
- FOUNTAIN: Water fountain effect with drops
- LIGHTNING: Lightning strike with thunder sounds
Dependencies
HyperCrates has soft dependencies on the following plugins:
- PlaceholderAPI: For using placeholders in messages and other plugins
- DecentHolograms: For hologram support above physical crates
Installation
1. Download the latest version of HyperCrates.jar
2. Place the file into your server's `plugins` folder
3. (Optional) Install PlaceholderAPI and/or DecentHolograms for additional features
4. Restart your server - the plugin will generate all necessary configuration files
5. Configure your crates in the `plugins/HyperCrates/crates/` folder
6. Customize messages in `messages.yml` and global settings in `config.yml`
7. Use `/hypercrates reload` to apply your changes
8. Give players keys with `/hypercrates give` and enjoy!
Support & Community
Join our Discord community for support, updates, and to share your crate configurations with other server owners!
Quick facts
- Edition: Minecraft Java
- File type: .jar
- Minecraft versions listed: 1.20, 1.20.6, 1.21
- How to install: Install the matching mod loader (Forge, Fabric or NeoForge) for your Minecraft version. → Download the .jar. → Put it in the .minecraft/mods folder and launch that loader profile.
- Where to get it: Opens on Spigot — not every file is mirrored on our own servers.
Install steps are the general flow for this file type — How to install Minecraft Java mods & modpacks walks through it step by step.
HyperCrates is a free Minecraft Java mod. Compatible with Minecraft 1.20, 1.20.6, 1.21. Downloaded 154 times (via Spigot). Download it and open it directly in the game.