Take backups before you update just in case test thoroughly before throwing on a production server!

New Features:

• Added the ability to require a permission to open a crate.
  • This feature was labeled to be added a while ago but I don't know why it didn't get added. #594
  • New Message:
    • No-Crate-Permission: '&cYou do not have permission to use that crate.'
  • New Permissions:
    • crazycrates.open.<crate_name>
    • crazycrates.open.* which defaults to true. Set this to false and use the permission above to start blocking crates.
• Added multiple internal placeholders related to how many times a player has opened a crate or crates
• %crate_opened% ( Shows a singular crate, it's used in Per-Crate inside messages.yml )
  • This placeholder can also be used in in /crates in the lore when you hover over the item.
• %crates_opened% ( Shows the total amount of crates opened and is used in the /keys header )
• All placeholders will return 0 if data not found so that is normal.
• Added 2 new placeholderapi placeholders
  • %crazycrates_<crate-name>_opened ( Shows how many times a player has opened a singular crate. )
  • %crazycrates_crates_opened% ( Shows the total amount of crates a player has opened. )
• Added the ability to run commands when a crate is opened, It defaults to false.

  Crate:
    opening-command:
        # If the commands should be sent or not.
        toggle: false
        # The commands to run when the crate opens.
        # Supports all placeholderapi placeholders
        # Supports %prefix which returns our prefix, %player% which uses the player name
        commands:
            - 'put your command here.'
  

• Added the ability to pick whether you can have random schematics or a single schematic for QuadCrates.

  Crate:
     # This section is related to .nbt files.
     structure:
       # If it should randomly use an .nbt file.
       random: true
       # The file to use inside schematic's folder.
       file: 'classic.nbt'
  

Changes:

• Added plugin-config.yml
  • Migrated Settings.Toggle-Metrics and Settings.Prefix to plugin-config.yml, It will automatically move your old values to the new config.
  • Metrics actually shuts down when you reload the plugin after turning off metrics.
• The plugin prefix is no longer automatically appended, You must add %prefix% to every message.
• Added new config options related to gui-customizer and sounds in config.yml
  • Need-Key-Sound-Toggle which defaults to true, Make sure to set it to false if you don't want it.
  • GUI-Customizer-Toggle which defaults to true, Make sure you set it to false if you don't want it.
• Added extra comments/headers to messages.yml & config.yml

New placeholders:

Old placeholders do still work as they serve a purpose for when you don't need to supply a player.

• %crazycrates_<player>_opened% -> Returns the total amount of crates opened.
• %crazycrates_<player>_<crate>_opened% -> Returns the amount of this particular crate opened.
• %crazycrates_<player>_<crate>_physical% -> Returns the amount of physical keys a player has in their inventory.
• %crazycrates_<player>_<crate>_virtual% -> Returns the amount of virtual keys a player has.
• %crazycrates_<player>_<crate>_total% -> Returns the total amount of virtual and physical keys a player has.

Fix:

• Cosmic Crates should no longer error. #599
• Fixed a bug where it would overwrite the total-crates in data.yml if adding a new crate and other overwriting issues. ( Found in beta testing )
  • You should probably join the beta tester team in our discord... I like direct feedback :)
• Check if the crate type is cosmic before marking it as "open", We want the key to be taken before being marked as open so people can't abuse it.

Developers:

• Added a crate open event.

Deprecation Notice:

• com.badbones69.crazycrates.api inside the "core" module is marked for removal and is deprecated.
• An alternative has been added that you can migrate to.
  • us.crazycrew.crazycrates:crazycrates-api:0.1
  • https://github.com/Crazy-Crew/ExamplePlugin - An example of how to use the new API for CrazyCrates, It only handles adding, fetching and removing keys etc at the moment. We don't have any proper documentation explaining the limitations but I will add some soon.
• All methods under com.badbones69.crazycrates.api.CrazyManager have been deprecated, Please use the API above!
• Warnings will show up in your IDE when you go to view or compile your project but backwards compatibility is a thing for now.
• A fair bit of code cleanup.

Other:

• Feature Requests
• Bug Reports