# ExcellentCrates v7.0.0 The **v7 Major Update** brings a completely fresh experience to ExcellentCrates! Every single system has been rewritten from scratch, featuring true **modularity**, massive **performance boosts**, and, of course, fixes for all known bugs. ## Crate Blocks There were plenty of complaints about the old block binding system, so here's a much better solution for everyone. Block binding is now handled by an **optional Blocks module**. Instead of manually "linking" crates to existing blocks, you now just grab the crate block itself via the in-game GUI editor or the `/crate getblock` command, and place it down wherever you want! This gives you way more control, lets the system detect block positions with pinpoint accuracy, simplifies setup, and cuts down on weird bugs. - **Modular feature!** If you don't plan on placing physical crate blocks in your world, feel free to disable this module entirely. - **Inverted workflow:** Instead of linking a crate to a block, you just place the specific block (default, custom, or furniture) for that crate right into the world. Quick and painless! - Added explicit support for **Nexo** custom blocks and furniture. Interactions are handled properly now. - Added explicit support for **ItemsAdder** custom blocks and furniture. Interactions are handled properly now. ## Holograms - Added `Scale` and `LineWidth` settings for holograms via **PacketEvents**. - **Dropped ProtocolLib support** for holograms due to its half-dead state. Please use **PacketEvents** instead. ## Fast Opening Fast Opening - previously tucked inside "Mass Opening" - is now its own standalone feature. Opening a crate **while sneaking** automatically triggers **Fast Open** mode. - **Modular feature!** You can fully disable it in the main **crates.core.yml** config, and it won't affect opening behavior at all. - **Fast Open** skips all menus, automatically choosing the highest amount or whatever option is currently available. - Skips animations entirely and grants rewards instantly. - Key/currency selection is handled automatically, picking any available payment method. ## Batch (Bulk Opening) Mass Opening is now simply called **Batch**. Backed by a brand-new codebase, it runs significantly smoother. - **Modular feature!** Completely toggleable in the main **crates.core.yml** config file. - Added a clean **GUI selector** to choose exactly how many crates you want to open in one go. - The available amount automatically adjusts based on active cooldowns, costs, keys, and other limits. - If a player can only afford 1 opening, the selector GUI is skipped completely. - Opening via **Fast Open** always defaults to the maximum possible amount. ## Rarity Let's be honest: having a separate rarity system that also altered reward drop chances was a bit overkill. It's gone now, making reward chances much easier to balance for everyone. - The `Weight` option under `Rarity` no longer affects reward drop chances. - Added a `Color` setting that modules and features can use to color-code reward rarities. ## Reward Commands Rewards can now have multiple command "bundles", each with its own commands and settings. There are now **3 execution modes** controlling how these bundles are rolled and executed. - **Modular feature!** You can completely disable the reward commands component. All related features disappear cleanly, without losing any data if you re-enable it later. - Added a toggle switch in the GUI editor so you can pause command execution on win without deleting your setup. - Added 3 command execution modes: `NORMAL`, `WEIGHT`, and `CHANCE`. - `NORMAL` mode executes all bundles sequentially. - `CHANCE` runs bundles in order, but only if each one passes its individual chance roll. - `WEIGHT` picks and runs a single bundle based on configured weights. - Added an **iterations option** for command bundles. For example, paired with `WEIGHT`, you can trigger a guaranteed number of bundles, rolling each one by weight. ## Reward Roll Count A heavily requested feature - especially for non-GUI animations (which are the only ones right now anyway, haha) - is finally here! You can now configure any crate to roll multiple rewards per single opening. - Added the `Required Amount` option in the crate editor's `Rewards` menu. - Players will see as many reward animations as specified by `Required Amount`, multiplied by the chosen **Batch** count. - Animations play out sequentially, one after another. ## Selectable Rewards The non-gambling reward selection feature got some long-overdue love. You can even combine it with the Batch feature now! Pretty sweet. - **Modular feature!** You can completely toggle this off so it never interferes with regular reward rolling. - Moved to a **dedicated editor section**. Instead of the old workaround where it acted like a crate "opening mode", it's now just a clean toggle switch in the editor. - The number of pickable rewards is governed by the same `Required Amount` setting. - **Batch support!** Players can now pick as many rewards in one go as their keys/funds allow. - **Quota support!** Players can instantly see how many of each reward they can claim based on cooldowns, limits, etc. Maxed-out rewards are hidden from the selection menu. - Players can now select the same reward multiple times in one session (as long as their quota allows it). ## Editor Fast Mode - Bulk reward adding has been renamed to **Fast Mode**. - Fast Mode settings now persist until you log off and are unique to each editor session. - Adding rewards in Fast Mode now requires a **double-click** instead of a single click to prevent accidental additions. ## Reward Broadcast - **Modular feature!** You can turn off reward broadcast alerts completely. - The crate editor now has a dedicated button opening a menu to toggle alerts per reward. More options might land here later. - Broadcast messages now live in their own dedicated config - `rewards.broadcast.yml` - instead of being shoehorned into the lang file. - Added **Rarity support** so you can configure custom announcements for each rarity tier. - Sound effects can now be tuned per broadcast. ## Keys ### Commands Added a dedicated `/cratekey` command for much cleaner key management. ### Redeem Significantly improved the unclaimed key system, complete with dedicated redeem commands. - Added `/cratekey redeem` to claim physical keys that were granted while a player was offline. - Added the `excellentcrates.keys.auto.redeem` permission to automatically grant unclaimed keys on login. ...and a ton of other minor tweaks & fixes under the hood!