Crate settings

Information regarding crate specific special customizations / features

OnlyPlaceable - crate setting that once set to true makes it so the crate (as a crate item) can't be opened via right-clicking the crate item in the air. By default users can open crates by placing down the crate item (if its a block) on the ground or by right-clicking it in the air (can be a non-block item in this case).

OnlyPlaceableAtLocations - configuration which allows the crate plugin be configurated so the crates as place-able blocks can be only placed in specific locations (specified by coordinates) usually reserved for such places like /warp crates Example:

OnlyPlaceableAtLocations: 
  - "-270,78,-2" #x,y,z

ShiftInstantlyOpen - if set to true, if the player is crouching when starting to open a crate, they will instantly open the crate (skip the animation)

RewardsDontRepeat - if set to true, the plugin will pick a reward that wasn't yet picked in that specific crate opening session. If the crate reward size is bigger than there are available rewards, this function will not work.

ClosedCrateText - list type configuration used to create holograms above stationary key crate blocks. Example:

ClosedCrateText:
  - "&7&l[&d&lRound&7&l] &f&lCrate"
  - "&7(&dRight-click &fto open crate&7)"
  - "&7(&dLeft-click &fto preview rewards&7)"

An internal placeholder made specifically for the ClosedCrateText configuration can be used to get the individual users virtual keys:

%virtualkeys_available%

MiddleAnimationItem - Set the material name for the item block that is displayed in the middle of the animation, works for Cosmic and Contraband animations

Crate Key

Crate keys are customized inside the crate file. Crate keys can be customized with all of the same configurations like any reward (for example CustomModelData, Lores etc.)

Example:

KeyCrate:
  Require: true
  KeysRequired: 1
  Material: TRIPWIRE_HOOK
  Name: "&4&lRound Crate Key"
  Enchanted: true
  #CustomModelData: 0
  Lores:
  - ""
  - "&7Opens a Round Crate"
  - "&7Open crates at /warp crate"

Crate size

All crate animations except Round2 animation use the Size configuration as the crate's prize amount. Round2 animation has 2 configurations, Size and PrizeSize. Size is used to describe how many holograms with rewards are displayed in the animation while PrizeSize is used to specify how many rewards will be given out. Reminder - case is only for Round2 animation, for all other animations Size configuration is also the configuration that specifies the amount of rewards given.

Random crate reward size

Pyramid and Contraband animations currently have an additional feature - MinPrizeSize and MaxPrizeSize which allows for a random amount of rewards given on every opening defined between the set bounds. In the future the feature will work for most if not all animations.

Crate custom skin

You can quickly apply any custom Minecraft head skin as your crate key / crate block using the in game editor. Down below is a shown demonstration on how to do so.

Setting a custom skin