Piñata [1.9-1.13] 3.0.1

Break pinata and get drops! | Crates, GUI's, drops preview, API, very configurable.

  1. Plajer
    Tested Minecraft Versions:
    • 1.9
    • 1.10
    • 1.11
    • 1.12
    • 1.13
    Source Code:
    https://github.com/Plajer-Lair/Pinata
    Contributors:
    Tigerkatze, Plajer
    Languages Supported:
    English, Polski, Français, Deutsch, Nederlands, Español
    [​IMG]
    [​IMG] [​IMG] [​IMG] [​IMG][​IMG]

    [​IMG] Join our pinata discord server today!
    Invite:
    https://discord.gg/UXzUdTP

    [​IMG]

    [​IMG]

    [​IMG]
    Note: GIFs are with enabled full blindness effect​

    This is a unique pinata plugin! You can buy or spawn configured pinatas and break them to get drops.
    Plugin is very customizable and allows you to create many types of pinatas (e.g. food/money pinata).
    You can use several types of drops such as item, command, gun or money. Pinata mob can be any mob type (if it's sheep it can be dyed for 16 different colors).
    Wanna use it as pinata crate plugin? No problem! You can create pinata crates since 2.0.0 version.

    Note: If you wanna send me suggestion feel free to send me a PM. Any bugs should be reported first! Please don't make bad reviews due to bugs/errors. Thanks a lot :)

    Optional dependencies: Holographic Displays, Vault, CrackShot

    [​IMG]
    • Holographic Displays support (Optional since v2.0.4)
    • Vault support (Optional)
    • CrackShot support (Optional)
    • Permission-based pinatas
    • Custom mob type for pinata (v.2.3.0+)
    • Per player pinata and global pinata types (v1.2.0+)
    • GUI for drops preview and pinatas list (v1.2.2+)
    • Most of the messages are configurable
    • Buyable pinatas (requires Vault)
    • Pinata validator (never create your pinata wrong)
    • 4 types of drops (item, command, money, gun)
    • 16 dye colors for a sheep (see Creating pinata section)
    • Disabled worlds feature (v2.2.10+)
    • 1.9 -1.13 support
    • API for plugin (v1.3.0+)
    • Pinata crates (v2.0.0+)
    • Blindness effect for realistic pinata breaking (v2.2.7+)
    • Multiple languages support (locale - l12n) (v2.6.0+)
    • Edit command to edit pinatas InGame (v3.0.0+)
    • Pinata create gui via edit command (v3.0.0+)
    • Pinata & drops color support (v3.0.0+)
    • Unique plugin on SpigotMC
    [​IMG]
    [​IMG]
    [​IMG]
    [​IMG]
    [​IMG]

    [​IMG]
    [required argument], <optional argument>
    • /pinata new [pinata] - Create a new pinata
    • /pinata create [pinata] <target player> - Create existing pinata
      or /pinata create [world] [x loc] [y loc] [z loc] [pinata] - Create pinata at custom location
    • /pinata edit [pinata] - Edit Pinata
    • /pinata buy [pinata] - Buy existing pinata (Vault required)
    • /pinata list - List of all pinatas
    • /pinata preview [pinata] - Preview pinata drops
    • /pinata reloadconfig - Reload configuration files
    • /pinata setcrate - Set pinata crate at specific location
    • /pinata cratelist - Prints you all created crates
    • /pinata setchance - Set chance of an pinata drop
    [​IMG]
    • pinata.* - Permission pack for all pinata commands and permissions (admin commands too)
    • pinata.player.* - Crate and commands permissions pack
    • pinata.player.crate - Gives you permission to use crates
    • pinata.player.sign - Permission to use pinata signs
    • pinata.command.* - Gives you permission to use all commands
    • pinata.command - Main permission to use /pinata command
    • pinata.command.list - Permission for list command
    • pinata.command.buy - Permission for buy command
    • pinata.command.preview - Permission for preview command
    • pinata.admin.* - Gives you all admin permissions
    • pinata.admin.reload - Permission for reloadconfig command
    • pinata.admin.create - Permission for create command
    • pinata.admin.create.others - Permission for creating pinatas to other players
    • pinata.admin.notify - Permission for notify about plugin updates after joining server
    • pinata.admin.freeall - Permission to buy all pinatas for free
    • pinata.admin.crate.destory - Permission to destroy crates
    • pinata.admin.crate.list - Permission to cratelist command
    • pinata.admin.crate.set - Permission to setcrate command
    • pinata.admin.sign.set - Permission to set pinata signs
    • pinata.admin.sign.destroy - Permission to destroy pinata signs
    • pinata.admin.newpinata - Permission for creating new pinata
    • pinata.admin.edit - Permission for editing pinatas
    • pinata.use.default - Permission to use preconfigured "default" pinata (You can edit permissions for each pinata)
    [​IMG]
    Translation messages files (current file version: 11)
    The higher the "version" number is, the less outdated the translation is.
    (2.6.0+) Usage of this translations is now deprecated. Plugin has implemented locales support.

    (3.0.0+) Plugin has re-implemented locales support. You can send me updated or new languages and I will add it as soon as possible.

    Wanna add here new language / update current language? Click here!

    [​IMG]
    Code (YAML):
    #Pinatas configuration file

    #Should we use permission for each pinata?
    using-permissions
    : true

    #Notify about plugin updates?
    Update-Notifier
    :
      Enabled
    : true
      Notify-Beta-Versions
    : true

    #You can modify default locale of plugin here.
    #Available locales:
    #en - English (default)
    #pl - Polish / Polski
    #fr - Français
    #de - German / Deutsch
    #nl - Nederlands
    #es - Español
    #hu - Hungarian / Magyar
    locale
    : en

    #In this worlds you can create pinata only by console or '/pinata create' admin command.
    disabled-worlds
    :
    - 'cASe SenSItIve wORLD namE'

    #Exclusions of creating pinatas using crates or signs in disabled worlds
    #false = blocked, true = unlocked
    disabled-worlds-exclusions
    :
      crates
    : false
      signs
    : false

    #Requires Holographic Displays
    #Crate hologram refresh time.
    #Warning! Do not set this value to big because destroying crate cause hologram update in this refresh time
    #Time in seconds.
    hologram-refresh
    : 2

    #Crate particle refresh time.
    #Time in seconds.
    particle-refresh
    : 2

    #How many hearts should EVERY damage of pinata take?
    #0.0 = disabled, 1 = 0.5 heart
    #Useful if you're creating public types, players won't kill pinatas with their OP swords that fast.
    damage-modifier
    : 0.0

    #Because you can't set command item, you need to use configured item.
    command-item
    : paper

    #Because you can't set money item, you need to use configured item.
    money-item
    : diamond

    #Because you can't set gun item, you need to use configured item.
    gun-item
    : iron_barding

    #Enable halloween special pinata effects?
    halloween-mode
    : false

    Debug
    : false

    File-Version-Do-Not-Edit
    : 6
     

    Code (YAML):
    storage:
      default
    :
        display-name
    : default
        timer-display
    : 5
        color
    : WHITE
        permission-string
    : pinata.use.default
        crate-buy-cost
    : -1
        pinata-access-type
    : PRIVATE
        blindness-activated
    : true
        blindness-duration
    : 15
        full-blindness-activated
    : false
        crate-display-time-alive
    : 10
        health-amount
    : 5.0
        mob-entity-type
    : SHEEP
        items-drop-type
    : DEATH
        drops
    :
        - ==
    : org.bukkit.inventory.ItemStack
          type
    : PAPER
        other-drops
    : []
     
    Pinata creation is explained itself in pinata_storage.yml, but if you want to know more or you don't understand something PM me :D

    [​IMG]
    Where can I report bug/suggestion?
    Click here to send me PM :)

    My pinata doesn't spawn!

    Make sure that any plugin (for example WorldGuard) doesn't block mob spawning at your location. If so make sure you allow mob spawning there.

    Are there any placeholders?

    You can use %player% placeholder in command drop and hologram names.

    Are you going to update this plugin?
    Yes! I've added update notifier so when the update comes you'll be notified!

    How can I use Pinata API? (v1.3.0+)
    For events and methods please look this java docs: https://jd.plajer.xyz/minecraft/pinata/

    How to use pinata crates? (v2.0.0+)
    1.
    Place chest at the selected location.
    2. Type command /pinata setcrate <crate name> while looking at placed chest.
    3. Done! Now you can buy pinatas in crates!
    (to remove crate just destroy it, do not use WorldEdit etc. to remove crate!!)

    How to disable/enable Halloween mode? (v2.1.0+)
    By default Halloween mode is disabled, you can enable it in config.yml.
    1. Just add this line to your config.yml:
    Code (YAML):
    halloween-mode: true
    Since v2.2.7 config is updated automatically
    2. Type /pinata reloadconfig and that's all!

    How can I create pinata sign? (v2.4.0+)
    To set pinata sign type those messages in following lines:
    1st line - [Pinata]
    2nd line - all/pinata name
    all - Pinata GUI with all pinatas will be opened
    pinata name - Pinata with specified name will be purchased (price configurable in pinata_storage.yml)

    How can I spawn pinata at random custom location? (v2.5.1+)
    Just use ~ character in X, Y or Z coord.
    For example: /pinata create world 14~50 80 100 default
    It will create pinata at random X coord between 14 and 50, 80 Y coord and 100 Z coord.

    How can I change plugin locale and how many locales are there? (v2.6.0+)
    There are currently: English, Polish, German, French, Spanish and Dutch locales.
    To enable locale edit locale value in config.yml to the following prefix:
    English - en
    Polish - pl
    German - de
    French - fr
    Spanish - es
    Dutch - nl

    The plugin is using bStats to send anonymous data. Please do not disable it as it keeps developers motivated!
    [​IMG]
    [​IMG]

    Copyright ⓒ 2019 - Plajer's Lair, Pinata Project maintained by @Tigerkatze, @Plajer and contributors
    Toldi, WaxtzCraft, cli and 9 others like this.

Recent Reviews

  1. DaviPatrick
    DaviPatrick
    5/5,
    Version: 3.0.1
    Amazing plugin, congratulations to the developer who strives to make the plugin, no bugs found!
    1. Plajer
      Author's Response
      Thanks :)
  2. Plajer
    Plajer
    5/5,
    Version: 3.0.1
    Very nice plugin, good dev :)
    1. Plajer
      Author's Response
      Thank you for review. You are also a good dev ;)
  3. xNekio
    xNekio
    5/5,
    Version: 2.6.5
    Perfect plugin for perks/voteparty, etc.. too many possibilities, thanks you for making this!
    1. Plajer
  4. Haileykins
    Haileykins
    5/5,
    Version: 2.6.4
    Another crazy unique plugin by the plajer! Keep it up! I'm loving them! My server will too!
    1. Plajer
  5. adolfo_garolfo
    adolfo_garolfo
    5/5,
    Version: 2.5.2
    Great idea! One of the most original authors i've ever seen. Great support, excellent plugin.
    1. Plajer
      Author's Response
      Thanks for review and your translation! :)
  6. TheLucXas
    TheLucXas
    5/5,
    Version: 2.5.0.1
    Excellent complement! the only bad thing is that I would like to put items with enchantments so the plugin would be perfect! but very good plugin
    pd: Sorry my bad english
    1. Plajer
      Author's Response
      Thanks for the review! I don't know right now when I'm gonna add enchantment support.
  7. MrHumblePie
    MrHumblePie
    5/5,
    Version: 2.2.11
    A really fun and cute plugin. The developer is active and open to discussion about new features which is always great to see. I think my players will enjoy this.
    1. Plajer
      Author's Response
      Thanks for the review ;)
  8. Przexmen
    Przexmen
    4/5,
    Version: 2.2.11
    You should add some effects like sparks etc.
    Also why you banned me from discord?
  9. Przexmen
    Przexmen
    5/5,
    Version: 2.2.8.1
    I saw everything.
    I tried everything.
    And for now, I don't see problems in this plugin and any bugd, so I will give that, what you wanted and you will get from me, 5 stars.



    PS. You can also see my PM.
    1. Plajer
      Author's Response
      Thanks for the review :)
  10. SirPrixx
    SirPrixx
    5/5,
    Version: 2.2.8.1
    Awesome plugin man! This plugin is so much fun :) Definitely would recommend it! Greetings
    1. Plajer
      Author's Response
      Thank you very much <3!