ExcellentCrates it is a modern, feature-rich, modular crate & lootbox plugin with an intuitive in-game GUI editor and smooth animations. Easily set up custom rewards, batch openings, portable crates, and fine-tuned limits without touching config files.
Features
IN-GAME EDITOR
Create your own crates, keys, and rewards using an intuitive GUI editor! All features are split into separate menus/categories, every action has its own button, and modern dialog popups handle text input and options!
MODULARITY & EXTENSIBILITY
Almost every feature is fully optional! Disable whatever you don’t like or need, and it won’t bother you again!
Thanks to our modular architecture, developers can hook their custom content into almost any plugin system - from animations to custom crate components!
KEYS
Create infinite keys for your crates! You can even assign multiple keys to the exact same crate!
And with our GUI editor, turning existing in-game items into new keys takes literally a couple of clicks!
REWARDS
Create unlimited rewards for your crates, complete with commands and custom items support! Set up global and per-player limits and cooldowns.
Broadcast to the entire server when someone lands a legendary or special drop - with customizable chat messages based on reward rarity!
ANIMATIONS
Treat players to cool opening animations and reward rollouts, making the whole process way more fun and engaging!
Create custom animation profiles for registered types, tweaking their parameters and visuals. A full developer API is available to create and register your own custom animations.
BLOCKS, EFFECTS AND HOLOGRAMS
Place crates anywhere in one click - just put the crate block where you want it! Configure holograms, particle effects, and custom click actions for each crate block!
Built-in automatic holograms for your crates! Just type in your text and adjust the offset if needed - everything else is ready to go!
Bring your crates to life with particle effects and unique shapes! Almost all vanilla particle types are supported!
BULK OPENING
Got a dozen keys on hand, but opening them one by one is too slow or boring? Open them all at once with bulk opening, picking the exact amount you want to unlock!
A smart GUI will show all available options. If there are none, well, there's nothing to choose from, hehe (the GUI won't even show up).
FAST OPENING
Tired of watching opening animations? Don't want to pick keys or amounts every single time? Just hold Shift-click - and the plugin will do everything instantly!
PAYMENT / KEY SELECTION
If a crate accepts different keys or payment methods, players get to choose how to pay.
The GUI displays all available payment methods, showing player balances and the exact number of crates they can afford.
PORTABLE CRATES
Turn crates into portable lootboxes - give them straight to player inventories or drop them in the world as pickup items!
PREVIEW
"Cool crate! What's inside?"
Toggle reward preview individually per crate and pick its visual style!
Control exactly what shows up in reward icons: lore, rarity, drop chances, cooldowns, limits, and more - with full placeholder support!
Create custom preview profiles for registered types, tweaking their look and settings!
OPENING HISTORY
Track what players open, which keys they use, locations, and dropped loot - with console output and a dedicated log file!
Getting Started
Please view the documentation for installation instructions
Releases
Please see the changelog for more details about a given release.
Donate
If you like my work or enjoy using my plugins, feel free to Buy me a coffee :) Thank you! 🧡
All Versions
+ Add Version
- ExcellentCrates 7.1.0** significantly streamlines and polishes the reward editor and crate block workflow.
[Click here to read the full changelog.](https://nightexpressdev.com/excellentcrates/releases/v7-1-0/)
[Click to read the full changelog.](https://nightexpressdev.com/excellentcrates/releases/v7-0-0/)
- Fixed key/currency cost dialogs not worked.
- Added
Post-Open Commandssetting for crates. Runs specific commands after a crate was opened. - Added
Open Amount Limitsetting for crates that limits amount of crates can be opened per player for a time frame instead of just an overall cooldown. - Added
Mass Creationbutton to the rewards editor. - Added
Arrange Modebutton to the rewards editor. - Added **PlaceholderAPI** placeholder indicating amount of remaining crate openings based on the
Open Amount Limitsetting. - Changed the
Commandsinput dialog field for command rewards to make it easier to edit. - Max. length for the
Namedialog input field was increased from100to300. - Max. length for the
Descriptiondialog input field was increased from500to600. - Force remove
max_stack_sizeattribute from key/crate item if stacking is allowed. - Fixed command validation complaining on valid commands.
- Fixed visual bug when using multiple reward spinners in the same GUI opening.
- Fixed the backup folder bug.
- Added
-massflag for the/crate openforcommand. - Added a few customization options for crate holograms, such as:
background color,shadow,opacity,billboard. - Added missing
Enabledfield for the Crate Effect dialog. - Added missing lang entries to the lang config.
- Fixed a bug, where reward conversion from
6.3.xwas broken in some cases for some item providers. - Fixed a bug, where commands for rewards not saved properly.
- Fixed a bug, where command rewards false complains on "invalid" commands.
- Added new lang entry for crate's rewards "result", so you can use reward placeholders there.
- Reimplemented
%crate_open_cost%internal placeholder. - Fixed reward limits not worked correctly.
- YOU MUST UPDATE [NightCore](https://modrinth.com/plugin/nightcore) to v2.9.1**
- Added config option to toggle Costs GUI appearing if there is only cost option available. Disabled by default.
- Added config option to toggle Mass Opening use by sneaking. Enabled by default.
- Fixed
openforcommand don't used cost options properly. - Fixed crate animation not displayed when opening from the Amount GUI.
- Fixed placeholder displays wrong amount of possible openings.
- Fixed opening options has no effect at all.
- Fixed cost entries displayed as available in the Costs GUI.
- Fixed Costs GUI title to wrap the
%crate_name%placeholder into inner color tag. - Fixed Costs GUI displayed disabled cost options.
- Now supports **1.21.8** and above only.
- New Opening Cost System**:
- Crates now can require certain number of a key to open it.
- Crates now can contain multiple different cost options.
- Crates cost options now can contain multiple entries, aka Keys + Money, Key A + Key B, etc.
- Added new placeholder
openings_availablethat вisplays the maximum number of times the crate can be opened, taking into account all available cost options. - The
keysplaceholder now acts the same way as theopenings_availableone for compatibility reasons. It will be removed in the future. - Editor GUI Overhaul**:
- Replaced all chat inputs with dialogs.
- Added more robust options.
- Reward Limits**:
- Finally fixed and reworked reward limits.
- Cooldown is works properly now.
- Cooldown get 2 types tp chose from: Daily and Custom.
- Cooldown step was removed.
- Amount of reward rolls is not reset with the cooldown anymore.
- Added config option to toggle the Mass Opening feature.
- Fixed a bug, where players with open cost bypass permissions get refunded when cancelling crate opening.
- Fixed
latest_openerandlatest_rolled_rewardplaceholders not working without player context. - Merged multiple messages for rewards obtained from a single opening into one message.
- Added more detailed problem reporter.
- Added async task for crate and key changes writing.
- Removed reward limit bypass permission.
- Slightly improved performance for crate items.
- Crate's name and lore are properly translated into text components now.
- Performance improvements.
- REQUIRES nightcore v2.7.10**
- NEW:**
- Selective Rewards. Select rewards from the crate without gambling!
- ADDED:**
- Config option to disable Holograms entirely.
- IMPROVED:**
- Improved reward prediction for ALL openings. It's way more accurate now.
- Improved performance for GUI openings.
- Improved hologram behavior.
- CHANGED:**
- "Selection" settings for the GUI openings were removed and replaced by native Selective Openings feature.
- FIXED:**
- A bug, where data synchronization doesn't work properly in some cases.
- API:**
- Breaking changes in the Openings API. Check source code for details.
- FIXED:**
- A bug, where item lore not transferred to crate's description on crate item change.
- A bug, where command reward does not display their name and lore properly.
- IMPORTANT:**
- Requires nightcore v2.7.6
- IMPROVED:**
- Make crates and keys to inherit item's name when changed in editor.
- FIXED:**
- A bug, where crate openings using GUI animations works incorrect in some cases.
- A bug, where it says item parsing error for freshly added items.
- ITEM SAVE METHOD:**
- Added a GUI where you select a save method for custom items: By NBT or By Item ID.
- By NBT saves the entire item NBT data to the config file with a compatibility for newer MC versions and possible NBT changes. However, it does not reflect any changes made in its original plugin's configuration.
- By Item ID saves the unique item ID from its original plugin and always reflects all changes made in its original plugin's configuration. However, it does not save any changes made out of said item configuration file.
- This GUI will appear on: crate item change, key item change, reward creation, adding item(s) to Item Reward.
- ADDED:**
- Missing lang entries for editor GUI titles.
- Command flag '-sf' to disable command feedback to the command sender.
- IMPORTANT:**
- Requires nightcore v2.7.5.2
- ADDED:**
- Ascending/descending options for reward sorting in the editor.
- Missing lang entries for some placeholder's output.
- Config setting to define time format type for crate cooldown placeholder.
- PlaceholderAPI placeholder: '%excellentcrates_openings_raw_[crate]%'.
- FIXED:**
- False item errors on plugin loading.
- Bugs in item handling.
- IMPORTANT:**
- Requires nightcore v2.7.5
- ADDED:**
- Preview option for Item Rewards. You MUST enable "Custom Icon" option in the editor of said reward(s) for this feature to appear.
- ADDED:**
- Setting 'ItemStackable' for crates and keys. Controls whether crate/key item is stackable.
- FIXED:**
- A bug, where command reward don't inherit item's lore on creation.
- A bug, where Adventure gamemode triggers crate preview together with crate opening on certain blocks.
- A bug, where plugin takes first suitable crate key from player's inventory instead of ones from player's hand.
- A bug, where virtual crate keys can't be refunded on plugin/server reload in some cases due to incorrect key detection on crate opening.
- A bug, where holographic item in 'simple_roll' animation can fly away because of the Hologram Offset setting.
- An error in key inspect command if no player specified.
