Description
Gallery
Changelog
Versions
Installation
- Download the update from modrinth/hangar for your version of Minecraft.
- You must be using at least https://papermc.io
- The file you downloaded goes in the
pluginsfolder. - Restart the server.
- Create new files in the
cratesfolder, and look at the existing files in there to help figure out how to use the plugin. - Test prizes using
/crazycrates debug <crate>. - View the documentation @ https://docs.crazycrew.us/mods/crazycrates/
Quick Builds
Get the latest builds for every commit!
Features
Contributing
Support
All support for the plugin is provided on Discord! If a question cannot be answered on the wiki, The next best place is to ask it in the Discord.
Data Collection
We collect anonymous statistics on how the plugin is used at https://bstats.org/plugin/bukkit/CrazyCrates/4514 and is visible to the public.
If you do not want this anonymous data sent, You currently have to go to the bStats folder, and set that to false.
Apex Hosting (ad)
We're sponsored by Apex Hosting, Click here to get 25% off your first purchase with the code APEX25 at checkout for Minecraft servers, Satisfactory servers, and more!
All Versions
+ Add Version| Name | Game version | Platforms | Published | Downloads | Actions |
|---|---|---|---|---|---|
| 21h ago | 1 | ||||
| 21h ago | 1 | ||||
| 21h ago | 1 | ||||
| 21h ago | 1 | ||||
| 21h ago | 1 | ||||
| 21h ago | 1 | ||||
| 21h ago | 1 | ||||
| 21h ago | 1 | ||||
| 21h ago | 1 | ||||
| 21h ago | 1 | ||||
| 21h ago | 1 | ||||
| 21h ago | 1 | ||||
| 21h ago | 1 | ||||
| 21h ago | 1 | ||||
| 21h ago | 1 | ||||
| 21h ago | 1 | ||||
| 21h ago | 1 | ||||
| 21h ago | 1 | ||||
| 21h ago | 1 | ||||
| 21h ago | 1 | ||||
| 21h ago | 1 | ||||
| 21h ago | 1 | ||||
| 21h ago | 1 | ||||
| 21h ago | 1 | ||||
| 21h ago | 1 | ||||
| 21h ago | 1 | ||||
| 21h ago | 1 | ||||
| 21h ago | 1 | ||||
| 21h ago | 1 | ||||
| 21h ago | 1 | ||||
| 21h ago | 1 | ||||
| 21h ago | 1 | ||||
| 21h ago | 1 | ||||
| 21h ago | 1 | ||||
| 21h ago | 1 | ||||
| 21h ago | 1 | ||||
| 21h ago | 1 | ||||
| 21h ago | 1 | ||||
| 21h ago | 1 | ||||
| 21h ago | 1 | ||||
| 21h ago | 1 | ||||
| 21h ago | 1 | ||||
| 21h ago | 1 | ||||
| 21h ago | 1 | ||||
| 21h ago | 1 | ||||
| 21h ago | 1 | ||||
| 21h ago | 1 | ||||
| 21h ago | 1 | ||||
| 21h ago | 1 | ||||
| 21h ago | 1 | ||||
| 21h ago | 1 | ||||
| 21h ago | 1 | ||||
| 21h ago | 1 | ||||
| 21h ago | 1 | ||||
| 21h ago | 1 | ||||
| 21h ago | 1 | ||||
| 21h ago | 1 | ||||
| 21h ago | 1 | ||||
| 21h ago | 1 | ||||
| 21h ago | 1 | ||||
| 21h ago | 1 | ||||
| 21h ago | 1 | ||||
| 21h ago | 1 | ||||
| 21h ago | 1 | ||||
| 21h ago | 1 | ||||
| 21h ago | 1 | ||||
| 21h ago | 1 | ||||
| 21h ago | 1 | ||||
| 21h ago | 1 | ||||
| 21h ago | 1 | ||||
| 21h ago | 1 | ||||
| 21h ago | 1 | ||||
| 21h ago | 1 | ||||
| 21h ago | 1 | ||||
| 21h ago | 1 | ||||
| 21h ago | 1 | ||||
| 21h ago | 1 | ||||
| 21h ago | 1 | ||||
| 21h ago | 1 | ||||
| 21h ago | 1 | ||||
| 21h ago | 1 | ||||
| 21h ago | 1 | ||||
| 21h ago | 1 | ||||
| 21h ago | 1 | ||||
| 21h ago | 1 | ||||
| 21h ago | 1 | ||||
| 21h ago | 1 | ||||
| 21h ago | 1 | ||||
| 21h ago | 1 | ||||
| 21h ago | 1 | ||||
| 21h ago | 1 | ||||
| 21h ago | 1 | ||||
| 21h ago | 1 | ||||
| 21h ago | 1 | ||||
| 21h ago | 1 | ||||
| 21h ago | 1 | ||||
| 21h ago | 1 | ||||
| 21h ago | 1 | ||||
| 21h ago | 1 | ||||
| 21h ago | 1 | ||||
| 21h ago | 1 | ||||
| 21h ago | 1 | ||||
| 21h ago | 1 | ||||
| 21h ago | 1 | ||||
| 21h ago | 1 | ||||
| 21h ago | 1 | ||||
| 21h ago | 1 | ||||
| 21h ago | 1 | ||||
| 21h ago | 1 | ||||
| 21h ago | 1 | ||||
| 21h ago | 1 | ||||
| 21h ago | 1 | ||||
| 21h ago | 1 | ||||
| 21h ago | 1 | ||||
| 21h ago | 1 | ||||
| 21h ago | 1 | ||||
| 21h ago | 1 | ||||
| 21h ago | 1 | ||||
| 21h ago | 1 | ||||
| 21h ago | 1 | ||||
| 21h ago | 1 | ||||
| 21h ago | 1 | ||||
| 21h ago | 1 | ||||
| 21h ago | 1 | ||||
| 21h ago | 1 | ||||
| 21h ago | 1 | ||||
| 21h ago | 1 | ||||
| 21h ago | 1 | ||||
| 21h ago | 1 | ||||
| 21h ago | 1 | ||||
| 21h ago | 1 | ||||
| 21h ago | 1 | ||||
| 21h ago | 1 | ||||
| 21h ago | 1 | ||||
| 21h ago | 1 | ||||
| 21h ago | 1 | ||||
| 21h ago | 1 | ||||
| 21h ago | 1 | ||||
| 21h ago | 1 | ||||
| 21h ago | 1 | ||||
| 21h ago | 1 | ||||
| 21h ago | 1 | ||||
| 21h ago | 1 | ||||
| 21h ago | 1 | ||||
| 21h ago | 1 | ||||
| 21h ago | 1 | ||||
| 21h ago | 1 | ||||
| 21h ago | 1 | ||||
| 21h ago | 1 | ||||
| 21h ago | 1 | ||||
| 21h ago | 1 | ||||
| 21h ago | 1 | ||||
| 21h ago | 1 | ||||
| 21h ago | 1 | ||||
| 21h ago | 1 | ||||
| 21h ago | 1 | ||||
| 21h ago | 1 | ||||
| 21h ago | 1 | ||||
| 21h ago | 1 | ||||
| 21h ago | 1 | ||||
| 21h ago | 1 | ||||
| 21h ago | 1 | ||||
| 21h ago | 1 | ||||
| 21h ago | 1 | ||||
| 21h ago | 1 | ||||
| 21h ago | 1 | ||||
| 21h ago | 1 | ||||
| 21h ago | 1 | ||||
| 21h ago | 1 | ||||
| 21h ago | 1 | ||||
| 21h ago | 1 | ||||
| 21h ago | 1 | ||||
| 21h ago | 1 | ||||
| 21h ago | 1 | ||||
| 21h ago | 1 | ||||
| 21h ago | 1 | ||||
| 21h ago | 1 | ||||
| 21h ago | 1 |
[26.1.2-ba1cc9b] 26.1.2-ba1cc9b
by Unknown on Oct 12, 2026
Download
[ba1cc9b](https://github.com/Crazy-Crew/CrazyCrates/commit/ba1cc9b) Fix potential issues with hologram validation/deletion.
[26.1.2-d132bde] 26.1.2-d132bde
by Unknown on Oct 12, 2026
Download
[d132bde](https://github.com/Crazy-Crew/CrazyCrates/commit/d132bde) Remove hikaricp's internal log4j so that the already provided log4j instance can be used.
[26.1.2-da371c5] 26.1.2-da371c5
by Unknown on Oct 12, 2026
Download
[da371c5](https://github.com/Crazy-Crew/CrazyCrates/commit/da371c5) Fix issue with worlds renamed through server.properties level-name
This also fixes other issues by running the legacy world names from locations.yml through the old getWorld() method and saving/using that key from that instead.
This also fixes other issues by running the legacy world names from locations.yml through the old getWorld() method and saving/using that key from that instead.
[26.1.2-51524f5] 26.1.2-51524f5
by Unknown on Oct 12, 2026
Download
## Commit ID
[#51524f5](https://github.com/Crazy-Crew/CrazyCrates/commit/51524f5) A big boi update.
## Warning
These will be one of the last builds for 26.1.2-26.2 respectfully, so please make sure you find time to update server if you haven't already.
### Sqlite Support.
CrazyCrates now supports SQLite for handling locations, You can enable this by going to the config.yml, and changing https://github.com/Crazy-Crew/CrazyCrates/blob/main/common/src/main/resources/config.yml#L42 to "sqlite"
SQLite will replace storing data in yml files as the default in the coming updates as I migrate player data to it.
#### How do I migrate my existing locations.yml?
You run /crazycrates migrate -mt DatabaseMigration (while the option in config.yml is set to "yaml")
Once the migration is confirmed to be completed, You must change the value from "yaml" to "sqlite" then restart your server.
If the locations.yml does not exist, the migration will not perform clearly.
### Location Format Changes.
Minecraft changed dimension formatting (and Paper made adoption changes for it)
In the Bukkit land, it's
Existing locations.yml should work under the hood, but new entries will use
### Other Changes
As always, Report 🐛 to https://github.com/Crazy-Crew/CrazyCrates/issues
[#51524f5](https://github.com/Crazy-Crew/CrazyCrates/commit/51524f5) A big boi update.
## Warning
These will be one of the last builds for 26.1.2-26.2 respectfully, so please make sure you find time to update server if you haven't already.
### Sqlite Support.
CrazyCrates now supports SQLite for handling locations, You can enable this by going to the config.yml, and changing https://github.com/Crazy-Crew/CrazyCrates/blob/main/common/src/main/resources/config.yml#L42 to "sqlite"
SQLite will replace storing data in yml files as the default in the coming updates as I migrate player data to it.
#### How do I migrate my existing locations.yml?
You run /crazycrates migrate -mt DatabaseMigration (while the option in config.yml is set to "yaml")
Once the migration is confirmed to be completed, You must change the value from "yaml" to "sqlite" then restart your server.
If the locations.yml does not exist, the migration will not perform clearly.
### Location Format Changes.
Minecraft changed dimension formatting (and Paper made adoption changes for it)
In the Bukkit land, it's
world, world_the_end, world_nether but adapting to vanilla is not a bad idea.Existing locations.yml should work under the hood, but new entries will use
minecraft:overworld etc.### Other Changes
- Updated the ExcellentCrates migrator
BrokeLocationsobject was removed as it was not used internally anymore.- locations.yml no longer loads if the file type is set to another storage type.
As always, Report 🐛 to https://github.com/Crazy-Crew/CrazyCrates/issues
[26.1.2-c7fab16] 26.1.2-c7fab16
by Unknown on Oct 12, 2026
Download
[c7fab16](https://github.com/Crazy-Crew/CrazyCrates/commit/c7fab16) Add support for v3 fancy holograms (#938)
v3 Fancy Holograms is in active development, and using it in production is at your own risk.
You should take a backup before hand otherwise you cannot go back to v2.
You can set hologram-plugin in config.yml to FancyHologramsV3 if you want to use it.
As always, if you have any bugs.. submit an issue or ping Ryder Belserion!
v3 Fancy Holograms is in active development, and using it in production is at your own risk.
You should take a backup before hand otherwise you cannot go back to v2.
You can set hologram-plugin in config.yml to FancyHologramsV3 if you want to use it.
As always, if you have any bugs.. submit an issue or ping Ryder Belserion!
[26.1.2-3726eba] 26.1.2-3726eba
by Unknown on Oct 12, 2026
Download
[3726eba](https://github.com/Crazy-Crew/CrazyCrates/commit/3726eba) Fix invalid if check which fixes [#937](https://github.com/Crazy-Crew/CrazyCrates/issues/937)
[26.1.2-01d78f5] 26.1.2-01d78f5
by Unknown on Oct 12, 2026
Download
[01d78f5](https://github.com/Crazy-Crew/CrazyCrates/commit/01d78f5) Fix issue with war crate gui not opening.
[26.1.2-37fff31] 26.1.2-37fff31
by Unknown on Oct 12, 2026
Download
[37fff31](https://github.com/Crazy-Crew/CrazyCrates/commit/37fff31) Wrap identifier in HologramManager#name()
[26.1.2-07cfb3e] 26.1.2-07cfb3e
by Unknown on Oct 12, 2026
Download
[07cfb3e](https://github.com/Crazy-Crew/CrazyCrates/commit/07cfb3e) Fix holograms not being removed when breaking a location.
[26.1.2-1ed5eac] 26.1.2-1ed5eac
by Unknown on Oct 12, 2026
Download
[1ed5eac](https://github.com/Crazy-Crew/CrazyCrates/commit/1ed5eac) Fix cosmetic issue with the inventory title not updating on the client side during the cosmic crate animation
[26.1.2-1d2392d] 26.1.2-1d2392d
by Unknown on Oct 12, 2026
Download
[1d2392d](https://github.com/Crazy-Crew/CrazyCrates/commit/1d2392d) Switch boolean from true to false which loops through the whole inventory for /crates mass-open
[26.1.2-5d62a13] 26.1.2-5d62a13
by Unknown on Oct 12, 2026
Download
[5d62a13](https://github.com/Crazy-Crew/CrazyCrates/commit/5d62a13) Fixed an issue in specific situations with custom items plugins
[26.1.2-beb9423] 26.1.2-beb9423
by Unknown on Oct 12, 2026
Download
[beb9423](https://github.com/Crazy-Crew/CrazyCrates/commit/beb9423) Improves loading offline player keys while fixing a few issues
- PlayerReceiveKeyEvent was not reflecting the correct amount added.
- Giving keys on player join event now respects the config options like "crate.keys.inventory-settings.give-virtual-keys" and "crate.keys.inventory-settings.send-message" which decide whether keys drop on the ground or not, or if a player should be notified if inventory is not empty.
- Baktus79 created a pull request which did fix an issue [#930](https://github.com/Crazy-Crew/CrazyCrates/pull/930) as the first contribution, yet something hit me like truck-kun... and this is the result.
[26.1.2-3a11073] 26.1.2-3a11073
by Unknown on Oct 12, 2026
Download
[3a11073](https://github.com/Crazy-Crew/CrazyCrates/commit/3a11073) Added missing dye/potion support for tipped arrows.
- Updated the CratesExample.yml to how to use
DisplayPotionsfor the Muscle Man potion. - Fixed an issue where the wrong true/false options were used when adding a potion effect leading to minor cosmetic issues.
- Added "type" field to potions where you now define the potion type instead. Existing configurations should work, but please migrate to the new format as soon as possible.
- Fixed potion colors not applying to display items.
[26.1.2-063f0c3] 26.1.2-063f0c3
by Unknown on Oct 12, 2026
Download
[063f0c3](https://github.com/Crazy-Crew/CrazyCrates/commit/063f0c3) Fix multiple issues with trying to set Menu type locations.
- The plugin tried to create holograms when setting Menu Type locations, however the data for it wasn't present.
- /crates list tried to fetch data from the Menu Type that did not exist.
[26.1.2-ff9a9f1] 26.1.2-ff9a9f1
by Unknown on Oct 12, 2026
Download
[ff9a9f1](https://github.com/Crazy-Crew/CrazyCrates/commit/ff9a9f1) Use the correct message when a player has no keys when running /keys
[26.1.2-ab23adf] 26.1.2-ab23adf
by Unknown on Oct 12, 2026
Download
[ab23adf](https://github.com/Crazy-Crew/CrazyCrates/commit/ab23adf) Add extra care to the other crate types that may not work very well in /crates, or at physical locations like CrateOnTheGo
- If the crate type is CrateOnTheGo, and it's a physical location set via /crates editor, or /crates set. It will open the preview menu.
- If the crate type is FireCracker, QuickCrate, or QuadCrate... and it's interacted with via /crates, It will try to open the preview menu while informing the player that it can't be used as a virtual crate.
- If the preview is disabled, it sends a preview disabled messages.
[26.1.2-c409b6f] 26.1.2-c409b6f
by Unknown on Oct 12, 2026
Download
[c409b6f](https://github.com/Crazy-Crew/CrazyCrates/commit/c409b6f) Check if the crate type is QuadCrate or QuickCrate before checking for active locations.
- QuadCrate spawns a schematic, and that can get messy.... *flashbacks to the world turning to stone*
- QuickCrate will only prevent location use *if* the config option to show the display item is enabled.
[26.1.2-798bebf] 26.1.2-798bebf
by Unknown on Oct 12, 2026
Download
[798bebf](https://github.com/Crazy-Crew/CrazyCrates/commit/798bebf) Check if location from nexo/oraxen is a valid location.
[26.1.2-0339f8a] 26.1.2-0339f8a
by Unknown on Oct 12, 2026
Download
[0339f8a](https://github.com/Crazy-Crew/CrazyCrates/commit/0339f8a) Fix holograms not updating on plugin reload
[26.1.2-d9188a1] 26.1.2-d9188a1
by Unknown on Oct 12, 2026
Download
[d9188a1](https://github.com/Crazy-Crew/CrazyCrates/commit/d9188a1) Fix saving location with y value twice causing holograms to move.
[26.1.2-eef5c93] 26.1.2-eef5c93
by Unknown on Oct 12, 2026
Download
[eef5c93](https://github.com/Crazy-Crew/CrazyCrates/commit/eef5c93) - Set interaction values to true by default.
- Remove doesnt-exist message as it's spammy when just casually building.
[26.1.2-98ad8b7] 26.1.2-98ad8b7
by Unknown on Oct 12, 2026
Download
[98ad8b7](https://github.com/Crazy-Crew/CrazyCrates/commit/98ad8b7) Fix crate locations... teleporting? lol
[26.1.2-1773a7b] 26.1.2-1773a7b
by Unknown on Oct 12, 2026
Download
[1773a7b](https://github.com/Crazy-Crew/CrazyCrates/commit/1773a7b) - Fixed an issue where you could open another crate mid-animation if quick enough.
- Added /crates delete which deletes the crate location you are looking at.
- Improved location checking internally (readability as well) by using a map paired with the chunk's PersistentDataContainer.
- Added a new message sent if a physical crate doesn't exist when trying to break blocks.
- Refunds keys for Cosmic Crate if you exit while the animation is mid-shuffle. Please let me know if you find issues with this.
- Added UUID value to locations.yml (which auto adds if not found)
- Removed an extra check for if a world is disabled.
- Fix respin menu for CrateOnTheGo.
[26.1.2-3fa5077] 26.1.2-3fa5077
by Unknown on Oct 12, 2026
Download
[3fa5077](https://github.com/Crazy-Crew/CrazyCrates/commit/3fa5077) Fix using the wrong message in the /keys command
[26.1.2-e58fa51] 26.1.2-e58fa51
by Unknown on Oct 12, 2026
Download
[e58fa51](https://github.com/Crazy-Crew/CrazyCrates/commit/e58fa51) Fix an issue where only one location was loaded at a time. Closes #926
[5.2.0] CrazyCrates 5.2.0
by Unknown on Oct 12, 2026
Download
## Changes
#### Configuration Changes
All existing options in the
#### CrazyCrates API has been bumped to 1.0.0
### Known Issues
### Removed
### Fixes
- Ability to add slot based items to the crate previews.
- https://docs.crazycrew.us/mods/crazycrates/reference/menus/buttons/
- All instances where a crate is opened will now respect when you disable a world.
Settings.Border.Glass-Border.Airis now a config option.- If the value is set to false, AIR is not set to these slots which allows pagination to use the bottom row.
- This is in unique scenarios where you never exceed 27 slots, and pagination effectively won't function properly.
- Improved message handling internally.
- Replaced ConfigMe with our own "copy-cat" system of it wrapped around Configurate
- You will notice in the config.yml that comments are preserved, and there is extra lines added as result which I cannot change this currently!
- Automatic migration for very old config files has not been coded yet.
- The files will automatically apply comments, and add missing/new config options.
- Improved location storage, and loading locations on startup. Existing locations should continue to work.
- Locations are now stored with random uuids, which removes the need to weirdly increment a number like before.
- If crate locations are broken, the names of them will be printed to console on startup or reload.
- /crazycrates fix is now a command, and has replaced the automatic variant of fixing crate locations on startup.
- Added {broken_locations} as a placeholder for /crazycrates list.
#### Configuration Changes
All existing options in the
config.yml will be respected first if they exist. You can find update examples in examples/crates for updated usage! crate.knock-backinconfig.ymlcan now be configured per crate, and no longer is added toconfig.ymlin new setups.crate.disabled-worldsinconfig.ymlcan now be configured per crate, and no longer is added toconfig.ymlin new setups.crate.quad-crate.timerinconfig.ymlcan now be configured per crate, and no longer is added toconfig.ymlin new setups.crate.types.csgo.cycling-materialinconfig.ymlcan now be configured per crate, and no longer is added toconfig.ymlin new setups.crate.types.csgo.finished-materialinconfig.ymlcan now be configured per crate, and no longer is added toconfig.ymlin new setups.crate.keys.key-sound.toggle&crates.keys.key-sound.nameinconfig.ymlcan now be configured per crate, and no longer is added toconfig.ymlin new setups.
#### CrazyCrates API has been bumped to 1.0.0
- ISettings has been removed from the CrazyCrates API
- You can rely on the ConfigManager class through CratesProvider#api()#getConfigManager(), but it is subject to be refactored at any point.
- I did not like the impl of
ISettings, and with how I do configurations. It's best to interface directly for now. - IServer is deprecated, and marked for removal. Please use CrazyCrates instead of IServer
- IServer usage should still work(you will lack anything new). Please let me know if it doesn't
### Known Issues
- FireCracker is not working properly.
### Removed
use-different-randomhas been removed from the config.yml as internally it did not make a difference.
### Fixes
- Fixed incorrect spelling of netherite_chestplate in the AdvancedExample.yml.
- Fixed recursion depth not working in fusion.yml.
- Fixed damage component being applied to an item when not told to.
- This causes issues with plugins that prevent damaged items from interacting with their plugins.
- No longer trying to action bar messages if the sender is console sender.
- No longer allow people to constantly exit the editor mode
- Adds a new message to tell the player they are not in editor mode.
- No longer checking if the items of a prize are empty when running /crates debug <crate>.
[5.1.0] CrazyCrates 5.1.0
by Unknown on Oct 12, 2026
Download
## Changes 🔨
### Key Changes
#### Crate Types
### Item Layout
## Removals
### Permissions
## Additions
### Key Placeholders
### Plugin Support
### New Commands
### Other
## Configuration Changes
### Glowing
Use correct variables when logging messages. Fix multiple issues with custom heads/skulls not being built. Use correct message when a player has no keys when doing /keys. Fixed an issue with mass-open where if any of the rows were null, or the tiers were empty. the keys you would've spent would've been lost. They get refunded now. Message responses when running commands not being sent to console.
As always, Report 🐛 to https://github.com/Crazy-Crew/CrazyCrates/issues
- Improved performance when checking placeholders via PlaceholderAPI
- This has also lessened maintenace burden internally!
- Improved updating the
examplesfolder. - Removed
LegacyItemBuilderas maintaining 2 ItemBuilders was not fun. - There should be no need to change configurations unless you use
HideItemFlags: true - If you do use
HideItemFlags, [Click Me](https://docs.crazycrew.us/mods/crazycrates/faq/#2-hideitemflags-no-longer-works-what-do-i-use-now) - Improved migration types by looping through the folders instead of the FileManager cache which led to unnecessary checks.
- Improved verbose logging across the plugin.
- Improved placeholder migrations in config migrator.
- Improved
/crazycrates teleport <crate_id>. - Improved placeholder parsing throughout the plugin.
- Replaced
{key_amount}from the not_enough_keys message with{amount}. {key_amount}is no longer usable.- Placeholders that normally could've only been used in the DisplayName of items can now be used in DisplayLore as well.
- Cleaned up code related to sending messages to the player, or broadcasting messages to the server.
- Removed an unnecessary prize loop for Cosmic Crate, if we do the math right initially... we shouldn't need this.
- Switched to using StringUtils#tryParseInt which uses an optional for better verbosity instead of Integer#parseInt.
- Updated default configuration files.
- Improved tracking code for crates.
- Improved performance & readability when building crate objects.
- Improved performance when loading/adding crate locations.
- Improved cleaning up crate tasks, and other caches when a crate opening ends.
- This should fix a few other weird issues.
### Key Changes
- Fixed a logical issue with taking keys using
/crazycrates mass-openor sneaking on QuickCrate after giving the prizes, it should be the other way around to minimize the free loot gain if something happens. - In addition to this, if they are keys *not* taken for any reason like your inventory being full, they should be refunded to you.
#### Crate Types
- CrateOnTheGo now passes through the openCrate method, so things like Required Keys, and other features the other crates have are now respected.
### Item Layout
- By default,
use-different-items-layoutis set to true now. - Existing servers with an up-to-date config will not have to change anything.
- Removed the option to configure the spawner preview.
- This is pointless, because they all look the same in crate menus.
- Updated glow configuration, Glowing now accepts values like "add_glow", "remove_glow", or "none"
- Existing true/false should work, but you should update it as soon ass possible.
## Removals
### Permissions
- Removed the
use-new-permission-systemtoggle, and keep the original behaviour everyone liked.
## Additions
### Key Placeholders
- Added shorthand formatting to key placeholders, so 1,000 would become 1k and so on.
### Plugin Support
- Note: replace
<item_id>with the correct identifier from the custom item plugins.** - Second Note: Any place you can input
diamond_axeallows you to use this format.** - Third Note: You can still use
emerald_helmetas in direct ids as well**
- Added support for HMCWraps.
DisplayItem: hmcwraps@<item_id>- This introduces new formats for other plugins like Oraxen, Nexo, CraftEngine, and ItemsAdder
DisplayItem: nexo@<item_id>DisplayItem: oraxen@<item_id>DisplayItem: itemsadder@<item_id>DisplayItem: craftengine@<item_id>
### New Commands
- Added /crates version which includes the git commit, previous git commit, and current version.
- If any value is not found, it will return "N/A"
### Other
- Added custom item support in areas that didn't have it.
- Added text shadow support for FancyHolograms.
- [#890](https://github.com/Crazy-Crew/CrazyCrates/pull/890)
## Configuration Changes
### Glowing
- Glowing no longer is true/false, however existing configurations using true/false will still work as we look for that internally as well.
yaml
# Should the item glow?
# Available Types: add_glow, remove_glow, none
Glowing: "none"
`
### Hidden Components
If you are using or Components in places, It has been replaced by flags.components, Existing configurations will still work.
## Bugs Fixed 🐛
- Fixed a bugs with incorrect messages being used for things, or variables in places.
- Fixed a bug with the log method when the uuid is null causing a console error to appear.
- getPrize not filtering out invalid weights properly leading to weird prize winnings.
- We did the correct check for the totalWeight variable, but when looping through prizes. Prizes with -1 weight were still present.
- If you add -1 to a value, it increases the value which can cause issues with prize chances.
- Any value with 0.0, 0, or numbers less than 0 will be considered filler items.
- Paginated guis creating a second page despite there not being enough items for it.
- Log messages potentially not being saved.
- Updated the ExcellentCrates migrator which fixed a few migration bugs
- Fixed an important issue with
/crazycrates transfer.If you cannot update, I recommend denying the permission to use this command. Fixed issues with /crazycrates take/give & /crazycrates mass-open by clamping the amount to be a required amount.CMI in recent updates, whether it's CMI Lib or CMI API, in short. the API broke, and I forked it, compiled it, published it to my repo... and it seems to work for now It seems I shall be maintaining it until the heat death of the universe. [#876](https://github.com/Crazy-Crew/CrazyCrates/issues/876) [#9919](https://github.com/Zrips/CMI/issues/9919) CMI's issue on Zrips repository that is closed by a stupid bot. /crazycrates debug` was not working properly.As always, Report 🐛 to https://github.com/Crazy-Crew/CrazyCrates/issues
[5.0.0] CrazyCrates 5.0.0
by Unknown on Oct 12, 2026
Download
## Changes 🔨
### New API
CrazyCrates API has been bumped to 0.9.0
#### A new class has been added.
Key Manager class, which allows you to check Items that players are holding.
You can fetch this by doing CratesProvider#get()#getKeyManager()
``Fixed a potential memory leak caused by using double brace initializers. Fixed multiple bugs with PlaceholderAPI support. Fixed a typo in CosmicCrateManager. [#873](https://github.com/Crazy-Crew/CrazyCrates/commit/876f3a7) Fixed a typo with %crate_opened_raw%. [1ef6553](https://github.com/Crazy-Crew/CrazyCrates/commit/1ef6553) Fixed an issue with items dropping on Folia. [#856](https://github.com/Crazy-Crew/CrazyCrates/pull/856) Fixed an issue by using #runNow instead of #run which calls the internal void method. Fixed multiple issues with migration types. Fixed multiple issues on Folia due to not using schedulers when needed. [0e139f6](https://github.com/Crazy-Crew/CrazyCrates/commit/0e139f6) Fixed an issue with potion color not applying with the new items section. Fixed an issue with the shield banners using the new item format. Fixed an issue with the tier chance per prize not properly showing. Fixed crates debug command.
As always, Report 🐛 to https://github.com/Crazy-Crew/CrazyCrates/issues
### New API
CrazyCrates API has been bumped to 0.9.0
#### A new class has been added.
Key Manager class, which allows you to check Items that players are holding.
You can fetch this by doing CratesProvider#get()#getKeyManager()
``
java
/**
- A class for the KeyManager, It handles checking physical keys, and anything else we might need soon.
- @author Ryder Belserion
- @version 0.9.0
- @since 0.9.0
- /
public abstract class KeyManager<I> {
/**
- The default constructor for {@link KeyManager<I>}.
- @author Ryder Belserion
- @since 0.9.0
- /
public KeyManager() {}
/**
- Checks if the item is a valid key.
- @param item the ItemStack
- @return true or false
- @since 0.9.0
- /
public abstract boolean isKey(@NotNull final I item);
/**
- Checks if an item matches another item.
- @param item the initial ItemStack
- @param comparing the ItemStack to compare
- @return true or false
- @since 0.9.0
- /
public abstract boolean isMatchingKey(@NotNull final I item, @NotNull final I comparing);
/**
- Gets the name of the crate the key belongs to.
- @param item the ItemStack
- @return the name of the crate
- @since 0.9.0
- /
public abstract String getKey(@NotNull final I item);
}
`
### Configuration changes
has been renamed to Rows in the crate config files, [5eec53b](https://github.com/Crazy-Crew/CrazyCrates/commit/5eec53b)All existing configurations should continue to work, You can run /crazyrates migrate -mt CratesDeprecated to change this, or simply use Find and Replace.
### Other Changes
- Added the ability to customize the row/column of the back/next and menu button.
- Added the ability to customize the CSGO animation to either have the top/bottom be static or dynamic. [95de51e](https://github.com/Crazy-Crew/CrazyCrates/commit/95de41e)
- If you run /crazycrates migrate -mt CratesDeprecated, The existing options you need will generate.
- Please refer to the
examples/crates/CrateExample.yml folder for a full example of how to do it.It supports the same structure as the new way to do items in the Items section which can be found on the documentation.Run the command on click in the Crate Menu, instead of on open. [6c580b1](https://github.com/Crazy-Crew/CrazyCrates/commit/6c580b1) Added %chance% / %weight% to the prize/default message. Added command syntax suggestions to all existing commands. Return "N/A" if the file is empty, because files#getFirst() throws an error because no element found. Utilize built in methods from CMI/DecentHolograms to handle coloring the messages for better compatibility with their plugins. This will maybe also allow other plugin specific features like CMI's countless other features for holograms. Remove the brackets from custom name for the item displayed above QuickCrate. Fill the bottom border with air to prevent item overfill with the buttons. Added toggle to disable opening tracking crate. [76625ba](https://github.com/Crazy-Crew/CrazyCrates/commit/76625ba961367be51a75fc907faa75ad87676b79)
## Bugs Fixed 🐛
- Fixed an error with WonderCrate.yml on first install, because a prize was lacking an
Items` section.As always, Report 🐛 to https://github.com/Crazy-Crew/CrazyCrates/issues
[1.21.8-fde1b0e] 1.21.8-fde1b0e
by Unknown on Oct 12, 2026
Download
[fde1b0e](https://github.com/Crazy-Crew/CrazyCrates/commit/fde1b0e) Update {prefix} replacement for messages
