Sueta
FA

Fantasy Crates

2019-07-05

Easy to use and to setup crates with animations.

·Plugin


What is Fantasy Crates?

Fantasy Crates is an easy to use crate plugin which supports animation. The whole idea of Fantasy Crates is to make players enjoy opening their crates, and this is achievable by adding customizable animation and effects to the crates!

Commands and permissions:

Commands and permission nodes

The permission node for all of the commands is: fantasycrates.admin

/fantasycrates help - help command which displays all available commands and their correct formats.

/fantasycrates gk <user name> <crate name> <amount> - gives user a crate specified by the crate name. The name for the crate is not the crate's displayname, but the crate name that you set in the config!

/fantasycrates gk @all <crate name> <amount> - gives every online player a crate.

/fantasycrates rl - reloads the config. If config has been setup incorrectly, the config will reset itself.

Default config and setup help

Default config:

Fantasycrates: 

  crates: 
    example: 
      key: 
        type: DIAMOND_BLOCK 
        lore: 
        - Mabushi is lonely 
        display-name: '&cOperation Mabushi crate of wonder' 
        duplication-protection: true 
      animation: 
        angle: 
          x: 0.2 
          y: 0.2 
          z: 0.2 
        item-material: ENDER_CHEST 
      rewards: 
        item1: 
          displayname: Excalibur 
          material: DIAMOND_SWORD 
          enchanted: true 
          chance: 10.2 
          commands: 
          - msg %player% you won something 
          - broadcast %player% just won something, woah! 
          finalAnimation: 
            angle: 
              x: 0.2 
              y: 0.2 
              z: 0.2 
        item2: 
          displayname: Holy Block of Emeraldy 
          material: EMERALD_BLOCK 
          enchanted: true 
          chance: 14 
          commands: 
          - msg %player% you won something 
          - broadcast %player% just won something, woah! 
          finalAnimation: 
            angle: 
              x: 0.2 
              y: 0.2 
              z: 0.2

What are all these different things?

Animation and angles

Angels are responsible for how the animation looks like and their speed, by changing the angels, you can adjust the speed and the animation.
The X, Y, and Z cords each have their angel, setting the angel to 0 will make it so it won't move in that coordinate.

The first animation section decides on how the crate should move untill it's time to display the prize to the player. Once that's over, the finalAnimation section will decide on how to animate the prize.

Duplication protection:
The plugin identifies a crate by it's lore, display name, and material type.
If a player has access to the material type, for example a diamond block, and they have access to add lore to an item and change their display name, they can duplicate the crates by making an identical item.
The duplication protection prevents that for servers who give players these privileges by adding a secret enchant to the item.

Did you find a bug? Do you need help setting up your config? Do you have any suggestions on what to add next? Then feel free to join my discord server by clicking here

Similar projects

Plugin →