DeluxePouches (Unique Animations, Effects & WorldGuard Support) [1.8-1.18] Update - v1.1.4

A Truly Deluxe Pouches plugin with Animations, Effects & Developer API to create your own!
dp.png
Type
  1. Economy
  2. Other
Supported software
  1. Bukkit
  2. Spigot
Supported versions
  1. 1.8
  2. 1.9
  3. 1.10
  4. 1.11
  5. 1.12
  6. 1.13
  7. 1.14
  8. 1.15
  9. 1.16
  10. 1.17
  11. 1.18
Tags
Tags
animations moneypouch plugin pouch plugin pouches unique
v0tX34H.png

rixH7GT.gif
VgCCbJi.gif


bB0p6jy.png
  • Unqiue Animations with particles.
  • Various Opening Effects.
  • Fully customisable messages/settings.
  • Paginated GUI to display and get pouches.
  • Unlimited Pouches.
  • WorldGuard 6 & 7 support to disable use of Pouches in specfic regions.
  • Supports any type of pouch (Money, Tokens, EXP, etc).
  • Developer API to create custom animations or effects.
  • Actions based system upon opening a pouch.
  • No external dependencies required (Vault is recommended).
  • Send titles, actionbar, holograms and chat messages upon opening.
  • Configuration comments to help understand what each part does.
m98Y5Du.png

  • /deluxepouches
    • Description: Displays help message
    • Permission: deluxepouches.admin
  • /deluxepouches reload
    • Description: Reload the configuration and messages file
    • Permission: deluxepouches.admin
  • /deluxepouches give <tier> <player> <amount>
    • Description: Gives a specific player a pouch
    • Permission: deluxepouches.admin
  • /deluxepouches list
    • Description: List all available pouches in chat
    • Permission: deluxepouches.admin
  • /deluxepouches gui
    • Description: Display all available pouches in a GUI
    • Permission: deluxepouches.admin
CnpYMGu.png
Actions for "open-events:"
  • [message] <MESSAGE> - Sends a message to the player
  • [broadcastmessage] <MESSAGE> - Broadcasts a message to the server
  • [actionbar] <MESSAGE> - Sends a actionbar message to the player
  • [title] <MAIN TITLE>;<SUBTITLE>;<FADE IN TIME>;<STAY>;<FADE OUT TIME> - Sends a title message to the player
  • [command] <COMMAND> - Executes a command from the player
  • [consolecommand] <COMMAND> - Executes a command from console (Use {player} for the player name)
  • [sound] <SOUND NAME> - Plays a specific sound
  • [vaultadd] <AMOUNT> - Gives money to the player via Vault (Vault is required for this).

config.yml
Code:
# ________     ______                  ________                   ______
#  ___  __ \_______  /___  _____  _________  __ \_________  __________  /_
#  __  / / /  _ \_  /_  / / /_  |/_/  _ \_  /_/ /  __ \  / / /  ___/_  __ \
#  _  /_/ //  __/  / / /_/ /__>  < /  __/  ____// /_/ / /_/ // /__ _  / / /
#  /_____/ \___//_/  \__,_/ /_/|_| \___//_/     \____/\__,_/ \___/ /_/ /_/
#            
#----------------------------------------------------------------------------
# By ItsLewizzz
#
#~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
# VALID OPENING ANIMATIONS:
#   - NONE
#   - SPIRAL
#   - ENVOY
#
#~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
# VALID ENDING EFFECTS:
#   - NONE
#   - EXPLODE
#   - LIGHTNING
#   - FIREWORK
#
#~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
# VALID OPEN EVENT ACTIONS:
#   - [message] - Sends a message to the player
#   - [broadcastmessage] - Broadcasts a message to all online players (Use {player} to display the player who opened)
#   - [actionbar] - Sends an actionbar message to the player
#   - [title] - Sends an title message to the player (FORMAT: <MAIN_TITLE;SUBTITLE;FADE_IN_TIME;STAY;FADE_OUT_TIME)
#   - [sound] - Plays a sound to the player
#   - [command] - Executes a command from the player
#   - [consolecommand] - Executes a command from console (Use {player} to display the player who opened)
#   - [vaultadd] - Gives money via Vault
#
#~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

settings:
  # WorldGuard Hook (it must be installed!)
  worldguard:
    enabled: true
    # You can disable the use of pouches in specific WG regions
    # Format: <WORLD NAME>:<WORLDGUARD REGION>
    blacklisted-regions:
    - worldname;worldguardregion
  pouches-menu:
    gui-name: "Pouches (Click to Collect)"
    next-page: "&6&lNext Page"
    current-page: "&f&lPage &b&l{currentPage} &f&lof &b&l{maxPages}"
    previous-page: "&c&lPrevious Page"

tiers:
  tier1_money:
    # Material for the pouch item and be used in the animation
    material: ENDER_CHEST
    # Name of the pouch item
    name: '&e&lTier I Money Pouch &r&7(Right Click)'
    # Lore of the pouch item
    lore:
      - '&7Place a Money Pouch to receive a'
      - '&7mystery reward of money!'
      - ''
      - '&6&l* &eTier &f1'
      - ''
      - '&6&l* &eReward'
      - '&8- &f$1,000 - $10,000'
      - ''
      - '&7&o(( Place down to open! ))'
    # Minimum amount to be given
    reward-min: 1000
    # Maximum amount to be given
    reward-max: 10000
    # Opening animation when the pouch is being opened
    # Check the list at the top of the config to see all animations
    # Set it to 'NONE' to disable opening animations
    opening-animation: NONE
    # Ending effect when the pouch has revealed the reward
    # Check the list at the top of the config to see all effects
    # Set it to 'NONE' to disable ending effects
    ending-effect: EXPLODE
    # Hologram to be displayed over the pouch item
    hologram:
      enabled: true
      lines:
      - "&e&lMONEY POUCH"
      - "&7&oYou have won ${amount} from this pouch!"
    # Open events trigger when the pouch has fully opened
    # Check the list at the top of the config to see all actions
    open-events:
      - "[message] &8&m----------------------------"
      - "[message] &bYou won &f${amount} &bfrom this pouch!"
      - "[message] &8&m----------------------------"
      - "[actionbar] &eYou have been rewarded &a&l${amount}"
      - "[title] &r;&a&l+${amount};1;3;1"
      - "[vaultadd] {amount}"
  tier2_money:
    material: ENDER_CHEST
    name: '&e&lTier II Money Pouch &r&7(Right Click)'
    lore:
      - '&7Place a Money Pouch to receive a'
      - '&7mystery reward of money!'
      - ''
      - '&6&l* &eTier &f2'
      - ''
      - '&6&l* &eReward'
      - '&8- &f$10,000 - $20,000'
      - ''
      - '&7&o(( Place down to open! ))'
    reward-min: 10000
    reward-max: 20000
    opening-animation: SPIRAL
    ending-effect: LIGHTNING
    hologram:
      enabled: true
      lines:
      - "&e&lMONEY POUCH"
      - "&7&oYou have won ${amount} from this pouch!"
    open-events:
      - "[message] &8&m----------------------------"
      - "[message] &bYou won &f${amount} &bfrom this pouch!"
      - "[message] &8&m----------------------------"
      - "[actionbar] &eYou have been rewarded &a&l${amount}"
      - "[title] &r;&a&l+${amount};1;3;1"
      - "[vaultadd] {amount}"
  tier1_diamond:
    material: DIAMOND_BLOCK
    name: '&b&lTier I Diamond Pouch &r&7(Right Click)'
    lore:
      - '&7Place a Diamond Pouch to receive a'
      - '&7mystery reward of diamonds!'
      - ''
      - '&6&l* &eTier &f1'
      - ''
      - '&6&l* &eReward'
      - '&8- &f1 - 20 diamonds'
      - ''
      - '&7&o(( Place down to open! ))'
    reward-min: 10
    reward-max: 20
    opening-animation: SPIRAL
    ending-effect: FIREWORK
    hologram:
      enabled: true
      lines:
      - "&e&lMONEY POUCH"
      - "&7&oYou have won {amount} diamonds from this pouch!"
    open-events:
      - "[message] &8&m----------------------------"
      - "[message] &bYou won &f{amount} diamonds &bfrom this pouch!"
      - "[message] &8&m----------------------------"
      - "[actionbar] &eYou have been rewarded &a&l{amount} diamonds"
      - "[title] &r;&a&l+${amount};1;3;1"
      - "[sound] ENTITY_ENDERMAN_TELEPORT"
      - "[consolecommand] minecraft:give {player} diamond {amount}"

lang.yml
Code:
messages:
  already-opening: "&cYou must wait for your previous box to open first!"
  blacklisted-region: "&cYou are not allowed to use a Pouch here!"
  received-pouch: "&6&l[!] &eYou have received {amount} &6&n{pouch}&r &epouch(s)."
  config-reloaded: "&6&l[!] &eThe configuration has been reloaded!"

QK98moF.png

( Make sure to add this plugin as a dependency )
Events
Code:
@EventHandler
public void onPouchOpen(PouchOpenEvent event) {
        Player player = event.getPlayer(); // Returns the player who is about to open
        Pouch pouch = event.getPouch(); // Returns the pouch object
        event.setCancelled(true); // Cancels the event
}

Creating your own Animations
An example class can be found below for a simple rising animation. Make sure to register your animation (see code below class).
Code:
// Animation class MUST extend Animation
public class TutorialAnimation extends Animation {
 
    // Constructor with the name of the animation used for the configuration
    public TutorialAnimation() {
        super("TUTORIAL");
    }
 
    @Override
    public void start(Location l, Pouch pouch, Player p, Block b) {
 
        // Get the final reward amount, the getReward() method should only be called once in this class
        int reward = pouch.getReward();
 
        // Create random ID for holograms
        String name = RandomStringUtils.randomAlphabetic(12);
 
        // Sort out positioning
        if(b.getState().getData().getData() == 4) {
            l.setYaw(90);
        } else if(b.getState().getData().getData() == 3) {
            l.setYaw(0);
        } else if(b.getState().getData().getData() == 5) {
            l.setYaw(-90);
        } else if(b.getState().getData().getData() == 2) {
            l.setYaw(180);
        }
 
        // Creating a new item hologram, this does not display text
        ItemHologram itemHolo = getItemHologram(name, pouch, l);
 
        // BukkitRunnable for animation
        new BukkitRunnable() {
            int times = 0;
 
            @Override
            public void run() {
 
                /*
                 * Checks if the animation has completed and give rewards and display completion.
                 * Time is in ticks.
                 */
                if(times == 60) {
                    // Play effect for that animation, if exists
                    playEffect(p, itemHolo.getStand().getLocation(), getEffect(pouch));
 
                    // Display text hologram for pouch
                    Hologram textHolo = getTextHologram(name, pouch, reward, itemHolo.getStand().getLocation());
 
                    // Remove both holograms, this method removes them after 3 seconds.
                    removeHologram(itemHolo, textHolo, name);
                    // Cancel task
                    this.cancel();
                    // Call end method to execute actions and allow user to open another pouch
                    end(p, pouch, reward);
                    return;
                }
 
                /*
                 * Adds 0.03 to the Y axis of the hologram each tick and adds 1 to the times variable
                 */
                ArmorStand stand = itemHolo.getStand();
                stand.teleport(stand.getLocation().add(0, 0.03, 0));
                times++;
 
            }
        }.runTaskTimer(DeluxePouches.getInstance(), 0L, 1L);
    }
}

Make sure to register your animation in your onEnable() method:
Code:
final DeluxePouches pouches = (DeluxePouches) Bukkit.getPluginManager().getPlugin("DeluxePouches");
pouches.registerAnimation(new TutorialAnimation());

If you are running into any issues, please send a DM to XER0GRAVITY.

Latest updates

  1. Update - v1.1.4

    Added 1.17 and 1.18 support Fixed minor console error seen on newer versions
  2. Update - v1.1.3

    Fix startup NPE error on default config.
  3. Update - v1.1.2

    v1.1.2 Added "{pouch_display_name}" placeholder to the pouch received message to display it's...

Latest reviews

10/10 plugin. Support is great couldn't ask for anything better.
XER0GRAVITY
XER0GRAVITY
Thank you for the review, glad you enjoy it :)
Amazing Plugin. Helps a lot on my server and it is worth getting!
XER0GRAVITY
XER0GRAVITY
Thank you for the review :)
Great plugin, couldnt ask for more, creative etc.
XER0GRAVITY
XER0GRAVITY
Thank you for the review :)
As Norska had said, it's the most customizable and feature-packed pouch plugin out there! It's absolutely fantastic, and the author, even though I had a couple silly questions, was absolutely willing to help out. Couldn't be happier!
XER0GRAVITY
XER0GRAVITY
Thank you for the review :)
idk it's cool i guess
XER0GRAVITY
XER0GRAVITY
Thanks for the review :)
very nice very nice very nice
XER0GRAVITY
XER0GRAVITY
Thank you for the review :)
Very promising plugin, it's the most customizable and feature-packed pouches plugin out there as of now. Would recommend.
XER0GRAVITY
XER0GRAVITY
Thank you for the kind words <3

Author

Author
XER0GRAVITY
Downloads
93
Type
Digital product
License duration
Unlimited
Price
7.50 USD
Views
5,973
First release
Last update
Rating
5.00 star(s) 7 ratings
Top
You need to upgrade!
Our dark style is reserved for our Premium members. Upgrade here.