CrazyCrates

Changes 🔨

• Improved performance when checking placeholders via PlaceholderAPI
  • This has also lessened maintenace burden internally!
• Improved updating the examples folder.
• Removed LegacyItemBuilder as 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
• 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.

Crate Changes

• 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-open or 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-layout is set to true now.
  • Existing servers with an up-to-date config will not have to change anything.

Item Changes

• 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-system toggle, 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_axe allows you to use this format. Third Note: You can still use emerald_helmet as 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

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.

  # Should the item glow?
  # Available Types: add_glow, remove_glow, none
  Glowing: "none"

Hidden Components

If you are using Hidden-Components 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
    • #9919 CMI's issue on Zrips repository that is closed by a stupid bot.
• /crazycrates debug was not working properly.
• 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

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()

/**
 * 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

• ChestLines has been renamed to Rows in the crate config files, 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
  • 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
• 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

Bugs Fixed 🐛

• Fixed an error with WonderCrate.yml on first install, because a prize was lacking an Items section.
• Fixed a potential memory leak caused by using double brace initializers.
• Fixed multiple bugs with PlaceholderAPI support.
• Fixed a typo in CosmicCrateManager. #873
• Fixed a typo with %crate_opened_raw%.
  • 1ef6553
• Fixed an issue with items dropping on Folia. #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
• 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

fde1b0e Update {prefix} replacement for messages

2e73bce Replace all double brace initializers with immutable maps, or new HashMap/List when needed

b92b47f Fix placeholders requiring a player name

5cfc069 Add missing item reward to prize #2 on first startup

1ef6553 Fix placeholder typo

496e4d0 Allow server owners to manually pick CMI

You must downgrade to at least 9.8.2.0, as it seems to still work there.

Automatic enabling of CMI is disabled.