HyperCrates - Speedgot

HyperCrates -----

A feature-rich, animated crate system for Minecraft servers with custom keys and interactive opening

Test Server

Code (Text):

dev.cracked-mc.net

An advanced crate plugin for Spigot/Paper servers that allows for unlimited, fully customizable crate types. With multiple opening modes, stunning animations, virtual and physical keys, lootbox mechanics, and comprehensive GUI management, HyperCrates provides the ultimate reward experience for your players.

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

messages.yml

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"

Crate Configuration Files

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!"

Lootbox Configuration Example

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!"

Crate Types Explained

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