ExcellentCrates

ExcellentCrates 7.1.0 significantly streamlines and polishes the reward editor and crate block workflow. Click here to read the full changelog.

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. Click to read the full changelog.

· Fixed key/currency cost dialogs not worked.

· Added Post-Open Commands setting for crates. Runs specific commands after a crate was opened. · Added Open Amount Limit setting for crates that limits amount of crates can be opened per player for a time frame instead of just an overall cooldown. · Added Mass Creation button to the rewards editor. · Added Arrange Mode button to the rewards editor. · Added PlaceholderAPI placeholder indicating amount of remaining crate openings based on the Open Amount Limit setting. · Changed the Commands input dialog field for command rewards to make it easier to edit. · Max. length for the Name dialog input field was increased from 100 to 300. · Max. length for the Description dialog input field was increased from 500 to 600. · Force remove max_stack_size attribute 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 -mass flag for the /crate openfor command. · Added a few customization options for crate holograms, such as: background color, shadow, opacity, billboard. · Added missing Enabled field for the Crate Effect dialog. · Added missing lang entries to the lang config. · Fixed a bug, where reward conversion from 6.3.x was 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 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 openfor command 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_available that вisplays the maximum number of times the crate can be opened, taking into account all available cost options. · The keys placeholder now acts the same way as the openings_available one 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_opener and latest_rolled_reward placeholders 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.

Minor update to recent nightcore and packetevents versions.

Hotfix for some openings generating rewards without actual chance check.

Fixed page bug in selective opening.

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 Preview" 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.

FIXED: · An error in key inspect command if no player specified.

IMPORTANT: · Backup your ExcellentCrates folder and test before use in production! · You must upgrade to v5.3.5 first to install v6.0.0 · You need EconomyBridge for full and proper custom item support in crates, keys and rewards. · Now supports only version 1.21.3 and above. · Update nightcore to v2.7.3.2. · Openings config structure has been changed. You will need to update your custom openings. · Hologram Template config path and structure a bit changed to allow future additions. REWARD TYPES I have seen a lot of people having issues with setting up crate rewards. So the following changes were made: · Split rewards on Item and Command rewards. · Commands option now available for Command Rewards only. · Item Content option now available for Item Rewards only. · Display Name and Preview options now available for Command Rewards only. · Item Rewards will use name and icon of the first item stored in it as Display Name and Preview options. NEW: · Added new non-GUI crate openings with API. · Required Permissions reward option. Sets which permissions player must have to be able to obtain the reward. ADDED: · Finally a proper support for custom item plugins! Including: Nexo, Oraxen, ItemsAdder, ExecutableItems, MMOItems and ExcellentCrates itself! · Description (lore) option for Command Rewards. · Description option for Crates. · PlaceholderAPI placeholder for latest opener name, latest rolled reward. · New GUI opening animation 'storm'. IMPROVED: · Added better inspection for crates, rewards and keys. Prints all problems in console and in editor GUI. · Reward Limit reset time (cooldown) now can be set to never reset (-1). · Added explicit delete buttons in GUI editor with confirmation. · Added reward creation GUI, where you select reward type. · Added explicit config entries for 'Enabled' state of crate's preview and animation options. · Crate data with latest opener/reward info migrated from crate config files to the database. · Increased line width for crate holograms, no ugly wraps anymore! CHANGED: · Split rewards to Item Rewards and Command Rewards. GUI Editor will show different options depends on reward type. · Reward Limit datas now stored in one table in the database. · Reward Limit "cooldown" is now "reset time" for amount of obtained rewards. · Permission to bypass reward limits now applies on both, global and personal limits. FIXED: · A bug, where crate data of one server gets removed on another one when connected to the same database. · A bug, where crate open cost settings gets removed from the config if EconomyBridge wasn't installed. · A bug, where preview cooldown applied even if crate has preview disabled. · A bug, where crate effects works incorrect in some cases. · A few mistakes in default lang config. · A lot of code flaws, issues, potential bugs and errors. · Multiple bugs related to reward limits.

AS OF v5.3.5 YOU NEED JAVA 21 OR NEWER. YOU NEED EconomyBridge PLUGIN FOR THE OPEN COST FEATURE NOW. ADDED: · EconomyBridge support. Provides even more currencies for the crate open cost feature. FIXED: · Minor issue related to crate holograms and fast player reconnection.

FROM VERSION v5.3.4 PLUGIN REQUIRES nightcore v2.7.0 OR NEWER! YOU MUST UPDATE (IF INSTALLED) CoinsEngine TO v2.4.0 TO USE v5.3.4 OR NEWER. Updated CoinsEngine integration.

Fixed cooldown not applied properly

ADDED: · PacketEvents support for crate holograms. · Config option to limit visibility distance of crate particles and holograms. · PlaceholderAPI placeholders for crate milestones. FIXED: · Cooldown issue #210 · Holograms & particles code improvements. REMOVED: · Dropped 1.18.2 version support. · DecentHolograms support (just use ProtocolLib or PacketEvents).

Fixed a few bugs in internal holograms.

Update to the latest nightcore

ADDED: · Permission for the /crate key giveall command, which allows server owners to exclude certain players (namely alt accounts) from getting crate keys via the command. LOCALIZATION: · Updated Spanish translation. Updated Chinese translation. FIXED: · Another bug with crate opening stuck in Creative gamemode. · Minor bug in rewards editor, where you can put items directly to the GUI using shift-click. · Added exception catch for ProtocolLib.

FIXED: · A bug, where players stuck in mass opening if crate has no opening animation set.

FIXED: · A duplication bug when multiple keys are assigned to a crate #186 · Crate Mass Opening no more plays hundreds of sounds. #179

You must update nightcore to v2.5.2.1 Fixed some possible glitches related to crate openings. Should be perfect now.

FIXED: · Possible visual issues with reward preview items. · Enchantments are not displayed for rewards. · Mass Opening does not trigger rewards for some openings.

Fixed some possible opening glitches

IMPROVED: · Allowed recipes with crate keys. FIXED: · A possible stutter when closing inventory while opening.

Fixed error when creating keys.

IMPORTANT​ ==================================================== This update introduces new crate openings config structure. Your current custom openings will NOT work! You need nightcore over NexEngine to run the plugin now. DO BACKUP OF YOUR CURRENT EXCELLENTCRATES DO BACKUP OF YOUR CURRENT EXCELLENTCRATES DO BACKUP OF YOUR CURRENT EXCELLENTCRATES DO BACKUP OF YOUR CURRENT EXCELLENTCRATES DO BACKUP OF YOUR CURRENT EXCELLENTCRATES DO [U]BACKUP[/U] OF YOUR CURRENT EXCELLENTCRATES ==================================================== ADDED: · Command '/crate openfor' to open crates for specified players. · Config option to limit amount of possible mass crate openings. · Crate option to toggle key requirement without removing all keys. · Button type 'OPEN' for crate preview menu. Allows you to open crates right from the preview GUI! · Global reward win limit & cooldown. Now you can limit amount of rewards and set their cooldown for the whole server. · Option to set reward cooldown after certain amount of wins. · Internal crate placeholders support for reward commands & items. · PlaceholderAPI support for preview GUIs. · Command flag '-nosave' for key commands. · XP Levels as a currency. IMPROVED: · Command '/crate open' now only simulates a regular crate opening (with all key, cost, permission checks) for the player who used the command. · Openings Overhaul. Now even more flexible and customizable. · 'Prevent Opening Skip' option now works for all openings. · Reward 'Actual Chance' value now includes reward's rarity weight as well. · Players will receive their keys back if the server or plugin were reloaded during crate opening, or if there was not reward spins. · Players will be refunded properly for crates they refuse to open or if opening was cancelled by the server. · Added support for internal crate placeholders in opening GUI titles. · Added a GUI to edit particle data in a user-friendly way. · Added even more fool proof. CHANGED: · Rarities are moved out to the config.yml from rarity.yml. · Hologram Y offset reverted back as per crate option. FIXED: · A bug, where key name not saved when changed in editor. · A bug, where Internal hologram handler conflicts with some other plugins. · A bug, where assigning crate to blocks works incorrect sometimes. · A possible opening bug, where it can roll the same reward even if it has only 1 possible amount or cooldown. · A lot of minor, possible bugs. · Performance improvements. REMOVED: · HolographicDisplays support since it's abandoned.

BEFORE UPDATE: · Update NexEngine · Do backup of the plugin folder. · Current crate 'Open Cost' settings will be lost. ADDED: · CoinsEngine support for crate open cost feature. · Permission for the Mass Open feature (given by default). #116 · Reward win logs. #89, #115 · Drop key command: '/crates dropkey' #55 · Internal crate placeholders: '%crate_last_opener%' and '%crate_last_reward%'. #129 · Internal hologram handler. Requires ProtocolLib and 1.19.4 or newer. · Config option to select hologram handler. IMPROVED: · Revisited editor GUI. Now clean & compact. Simplified mouse key actions. · Rewards editor now reflect crate preview layout so you can organize your reward positions more easier. · Protection/claim plugins should not prevent crate interactions anymore. · Overall open cost system refactor and improvements. CHANGED: · Crate hologram Y offset option has been moved to the main config file, and is global for all crates now. · Crate hologram text option has been moved to the main config file. You can create multiple text templates for different crates as before. FIXED: · A bit optimized player keys check. · A bug, where players can only one reward when using mass open on crates with openings having 2+ rewards. #114 · A bug, where if you hit Escape to skip the animation, and the reward is death, the plugin will give you two rewards instead of one. #94 · A bug, where invalid preview config being created as empty file. · A bug, where reward items become different sometimes when given to players. · Added auto-removal of invalid crate/reward limit data. #102 · Minor memory usage optimizations.

You must update NexEngine to install this update. - Engine update.

ADDED: · Internal (!) placeholder: '%reward_real_chance%' to display actual reward chance (related to chances of other rewards). FIXED: · A bug, where /crate key inspect command permission check works incorrect.

[New] Milestones Feature! Allows you to setup per-crate milestones to reward players for opening crate certain amount of times. [Fixed] Crate Rewards with 0 chance no more displayed in crate previews.

Command /crate key inspect is back! Updated translations. Minor bug fixes.

[New] Mass Open Feature! Use the 'CRATE_MASS_OPEN' type in the config.yml under 'Crate.Click_Actions' section. [Fixed] A bug, where 'menu' command always wants you to provide menu id instead of using default one.

Make sure to update NexEngine [Added] Silent flag '-s' to 'key', 'give', 'open' commands (it will not notify players about execution). [Added] PlaceholderAPI placeholder for amount of player's crate openings. [Improved] Default messages and colors in them. Added sounds. [Improved] Crate Menu format reworked and simplified. Added default examples. [Changed] Command to give keys to all online players now is '/crate key giveall'. [Changed] Command 'forceopen' renamed to 'open' command. Added force '-f' flag. [Fixed] A bug, where giving keys to all online players may result in memory leak and server crash because of independent user data save threads. [Fixed] A bug, where menus were half-working due to late crates loading. [Fixed] Internal crate cooldown placeholder will display correct values for one-timed and zero cooldown now.

[New] Rarity Feature. Create custom rarities and assign them to your rewards. Each rarity also has a roll chance, so you can split your rewards into categories! [Added] Crate Effect Models: 'Spiral', 'Sphere', 'Heart'. [Added] Reward editor option to set Display Name on Preview Item. [Improved] Now uses single task for crate effects (Reduced memory & cpu usage).

No more Citizens integration at all. I'm tired of reports from people who can't repair installation of that plugin. Assign commands to your NPCs if you want them to open or preview crates.

Update NexEngine to new release (04/04/23)! [Fixed] Inaccurate reward chances algorhythm.

Fixed minor bug in editor and with virtual keys

[Added] An option to require players to hold keys in main hand to open crates. [Added] An option for crate cooldown time formatter. [Added] An option to toggle holographic reward display above crate block. [Added] An option to set close time for opening animation when completed. [Added] PlaceholderAPI support for reward commands. [Fixed] A bug, where crate effects played in unloaded chunks causes them to be loaded again. [Fixed] A bug in Keys editor where keys are not displayed. [Fixed] Outdated format in default GUI configs. [Fixed] Errors with DecentHolograms.

Support for 1.19.4 + Engine Update (UPDATE IT)

[Dev] Added 'CrateObtainRewardEvent' event. [Fixed] A minor bug, where crate containers can be opened when interact with items on cooldown (e.g. goat horn).

[Added] Chinese language. [Improved] Now you can skip crate opening animation. [Fixed] Added opening sounds to default configs. [Fixed] A bug, where crate opening GUI not closed when all rewards are given.

!!! Update NexEngine !!! [Fixed] A bug, where reward sorting by chance works incorrect.

[Fixed] A bug, where reward deletion does not saves changes to the crate config immediately. [Fixed] Improved MySQL synchronzation between multiple servers.

[Added] 'Tick_Sound' option for the crate opening configs to both 'Rewards' and 'Animations' sections. [Fixed] A bug, where crate preview does not changes until plugin reload.

!!! Download the latest NexEngine !!! Update Notes: - New opening animations are stored in the /openings/ folder instead of /animations/ - Old animations will not work anymore. Make sure to reassign them to your crates. - GoldenCrates converter is not a thing anymore. [New] Crate Opening Animation System. Now more flexible, faster, less buggy, and even smoothly! [Added] Fast reward creation option for the 'Create Reward' button. [Added] PlaceholderAPI support for reward item's name and lore. [Improved] All editor GUIs were improved with a new layout and button descriptions. [Changed] Some placeholders in messages were changed. Mostly it's '%player%' -> '%player_name%'. [Fixed] Console error related to crate block effects that appears sometimes. [Fixed] Removed unnecessary code.

Fixed weird console errors on opening crates sometimes.

[Fixed] A bug, where crates keys not taken from playes. [Fixed] Console errors/warns.

[Fixed] An Engine bug, where custom head crate items throws an error when trying to be given to player's inventory.

[Improved] Commands 'givekey', 'takekey', 'keys' were replaced by the 'key' command with 'give', 'set', 'take', 'show' sub-commands. [Changed] Permissions for the 'key' command were changed. See docs for details. [Fixed] Minor code improvements.

NexEngine compatibility fixes Added Spanish translation

Support for the GoldenCrates database data migration. Potential fix for the reward itemstack amount.

[Fixed] A bug, where players can take out items from the crate opening GUIs. Again.

[Fixed] A bug, where players can take out items from the crate opening GUIs.

Fixed console errors caused by invalid sound implementation.

[Fixed] DecentHolograms errors. [Fixed] A bug, where crate hologram can not be disabled. [Fixed] A bug, where player can open any crate with any key. [Fixed] A bug, where rewards order in editor does not saves. [Fixed] A bug, where plugin can take incorrect keys from player inventory.

!!! UPDATE FROM GoldenCrates IS NOT POSSIBLE ATM, DO A CLEAN INSTALL !!!​ ​ [New] Now crate rewards can give multiple items at the same time. [New] Reward win limits! Now you can set how many times a certain crate reward can be won by a player with a cooldown. For example, you can make one-timed rewards, daily rewards, etc. [New] Now you can assign multiple keys to the same crate. [New] Now when you close the GUI while crate animation is played, animation will be cancelled and a random reward(s) will be given instantly. [Added] Configurable crate actions on certain clicks. By default Left click to preview crate, Right click to open crate. [Added] Per crate 'Particle.Data' option for block particle effects. (Some effects are requiring colors or material names, now you can specify them). [Added] Per crate option to set the crate block hologram Y offset. [Added] Per reward 'Broadcast' option instead of global one. [Added] 'preview' command to open crate preview. [Added] 'forceopen' command to make players open certain crate(s) without key, cost and permission checks. [Added] 'takekey' command to take keys from players instead of using negative amount in 'givekey' command. [Added] 'resetlimit' command to reset player's reward win limits for certain crates and rewards. [Added] 'resetcooldown' command to reset player's cooldown for certain crates. [Added] 'player' argument for 'menu' command and permission to execute this command on other players. [Added] Separate permissions for each command. [Added] Separate permissions for each crate open cost type. [Added] Permissions to bypass crate reward win limits. [Added] Support for DecentHolograms. [Changed] Crate 'Exp' open cost changed from total player experience to exp levels. [Changed] Crate cooldown now can accept negative values to make crate one-timed. [Changed] Crate visual reward display now handled by hologram plugins. [Fixed] A bug, where 'barrier' crate blocks does not react on clicks. [Fixed] A bug, where crate block pushback worked only for key checks. [Fixed] A bug, where crate preview not changed until the plugin reload. [Fixed] Now you will see 'No Key' error when trying to open a crate with invalid key ids specified. [Fixed] A lot of minor fixes and improvements. [Removed] Spigot 1.15 support. [Removed] Min. and max. rewards amount crate option. Now regulated by animation configs.

Fixed engine errors