CratesPro

OVERVIEW

DadaCratesPro is a complete and highly customizable crate system designed for Minecraft servers.

Create unlimited crates, configure rewards, generate secure custom keys, place physical crates in your worlds and manage almost everything directly in-game through intuitive GUIs.

DadaCratesPro is designed to provide powerful customization while remaining simple and fast to manage.

Main Features:

• Unlimited configurable crates
• Complete in-game crate editor
• Secure plugin-generated keys
• Item and command rewards
• Configurable reward chances
• Reward preview GUI
• Opening animations
• Picker-style openings
• Idle particle effects
• Custom holograms
• Physical crate locations
• Custom crate blocks
• Individual crate permissions
• Protected physical crates
• Anti-double-opening protection
• Safe reward delivery
• Persistent crate locations
• Configurable messages
• No resource pack required




MAIN CRATE MENU

Use:

to open the main DadaCratesPro interface.

The main menu provides quick access to the complete crate system.

Administrators can access:

• Crate management
• Player previews
• Plugin information
• Reload tools
• Command help

Everything is designed to be managed directly inside Minecraft.




FULL CRATE EDITOR

Every crate has its own complete configuration menu.

This allows every crate to use completely different rewards, keys, permissions, blocks, animations, particles and holograms.

From the crate editor you can manage:

• Rewards
• Custom Key
• Reward Preview
• Opening Animation
• Idle Particles
• Hologram
• Permission
• Physical Locations
• Crate Block
• Display Item
• Additional crate settings




CREATE CUSTOM CRATES

Create a new crate using:

Example:

Then open:

and configure the crate directly from the GUI.

Each crate can have its own:

• Name
• Display Item
• Physical Block
• Key
• Rewards
• Reward Chances
• Animation
• Particles
• Hologram
• Permission
• Locations


SECURE CUSTOM KEYS

DadaCratesPro uses secure plugin-generated crate keys.

Keys are not identified only by their Minecraft material.

Every official DadaCratesPro key contains internal plugin data that identifies the crate it belongs to.

For example, if the base key item is a Diamond:

Keys can contain:

• Custom Material
• Custom Display Name
• Lore
• Enchantment Glint
• Internal Crate Identifier
• Picker Information

One physical key equals one crate opening.

The correct key is consumed when a valid opening begins.


Picker Mode

DadaCratesPro also supports picker-style crate openings.

In picker mode, players can select rewards during the crate opening.

The configured Uses / Picks value determines how many reward selections the player can make.

It does not mean that the same physical key can be reused multiple times.


REWARDS

Crates can contain both item rewards and command rewards.

Reward options include:

• Item Rewards
• Command Rewards
• Reward Chance
• Item Amount
• Custom Item Data
• Broadcast Messages

Supported ItemStacks can preserve:

• Display Name
• Lore
• Enchantments
• Quantity
• CustomModelData
• Item Metadata

If the player's inventory is full, remaining rewards are safely dropped instead of disappearing.


REWARD PREVIEW

Players can preview possible rewards before spending a key.

Use:

Example:


OPENING ANIMATIONS

DadaCratesPro includes configurable opening animations.

Animation options can include:

• Animation Type
• Speed
• Duration
• Close Delay
• Sounds
• Visual Effects

Once an opening session begins, the player cannot bypass the process simply by closing the inventory.

The opening remains controlled until the crate process has completed.


IDLE PARTICLES

Physical crates can display configurable particle effects while idle.

Each crate can use different particle settings.

Available options include:

• Particle Type
• Shape
• Radius
• Height
• Point Amount
• Update Behaviour


HOLOGRAMS

Physical crates can display configurable holograms above them.

Example:

Hologram position can also be adjusted using configurable offsets.


PHYSICAL CRATES

DadaCratesPro supports real physical crate locations directly inside your Minecraft worlds.

Every crate can use its own configurable Minecraft block.

To configure and place a crate:

1. Open `/crate admin`
2. Select the crate
3. Open the Crate Block editor
4. Select the desired block
5. Confirm it
6. Look at a block in the world
7. Use:

Example:

The block you are looking at is replaced with the selected crate block and automatically registered as a physical crate.




CRATE BLOCK SELECTOR

The physical block editor uses a simple three-part configuration system.

LEFT - CANCEL

Cancel without saving the change.

CENTER - BLOCK INPUT

Place the Minecraft block you want to use here.

RIGHT - CONFIRM

Save the selected block.

The selected block will then be used when placing the crate using:


ADMIN GUI

Use:

to open the complete DadaCratesPro administration interface.

From the Admin GUI you can manage:

• Crates
• Rewards
• Keys
• Animations
• Particles
• Holograms
• Permissions
• Locations
• Crate Blocks
• Display Items
• Player Preview
• Plugin Reload


COMMANDS



/crate

Opens the main crate interface.


/crate preview CRATE

Opens the reward preview for a crate.

Example:


/crate admin

Opens the complete Admin GUI.


/crate create ID

Creates a new crate.

Example:


/crate setblock CRATE

Replaces the block you are looking at with the configured physical crate block and registers the location.


/crate removeblock

Removes the registered physical crate location you are looking at.


/crate key PLAYER CRATE [amount] [mode] [picks]

Gives an official DadaCratesPro key to a player.

Example:


/crate rewardcommand CRATE REWARD COMMAND

Configures a command reward for a crate.


/crate reload

Reloads DadaCratesPro configuration and stored systems.


PERMISSIONS

Main permission nodes:

dadacrates.use

Allows normal access to the crate system.


dadacrates.admin

Allows access to administrative crate management.


dadacrates.bypasskey

Allows opening crates without consuming a key.

Important:

The admin permission does not automatically grant key bypass.

Only give `dadacrates.bypasskey` when you intentionally want a player or staff member to open crates without keys.


dadacrates.open.*

Allows opening every configured crate.


dadacrates.open.CRATE

Allows opening one specific crate.

Examples:


CRATE PROTECTION

Registered physical crate blocks are protected by DadaCratesPro.

The opening system also includes protections designed to prevent problems such as:

• Double Openings
• Repeated Clicks
• Multiple Reward Execution
• Escaping Active Animations
• Incorrect Key Consumption


INSTALLATION

1. Stop your Minecraft server.

2. Put:

inside:

3. Start your server.

4. Open:

5. Create or select a crate.

6. Configure its rewards.

7. Configure its key.

8. Select its physical crate block.

9. Configure animation, particles and hologram if desired.

10. Look at a block in the world and use:

Your crate is ready.


UPDATING

When updating DadaCratesPro:

• Stop the server completely
• Back up the DadaCratesPro plugin folder
• Remove the previous DadaCratesPro jar
• Add the new jar
• Keep your existing configuration and data files
• Start the server normally

Do not use `/reload` to replace plugin jars.


REQUIREMENTS

• Paper / Spigot
• Minecraft 1.20+
• Java 17+
• No resource pack required


VERSION HISTORY

Version 1.1.2

• Secure custom key identification
• Normal Minecraft items can no longer work as crate keys
• Fixed physical key consumption
• Admin permission no longer automatically bypasses keys
• Improved physical crate placement
• Improved `/crate setblock`
• GUI-selected physical crate blocks
• Improved crate protection
• Improved opening sessions
• Improved reward safety


Version 1.1.1

• Restored original Uses / Picks behaviour
• Improved picker opening system
• Active opening animations cannot be bypassed by closing the GUI
• Added physical crate block selection GUI


Version 1.1.0

• Major GUI improvements
• Safer GUI sessions
• Physical crate protection
• Improved reward handling
• Anti-double-opening improvements


SUPPORT

Website

https://dadasmp.it

Discord Support

Join the DadaSMP Discord