- Tested Minecraft Versions:
- Source Code:
- Tigerkatze, Plajer
- Languages Supported:
- English, Polski, Français, Deutsch, Nederlands, Español
Join our pinata discord server today!
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
- 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
[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
- 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)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.
- language.yml (default) ( English en-GB) (always latest)
- language_pl.yml ( Polski pl-PL) (version 9)
- language_fr.yml ( Français fr-FR) (version 9) (thanks to @OzaX_0maZa)
- language_de.yml ( Deutsch de-DE) (version 9) (thanks to @Elternbrief)
- language_nl.yml ( Nederlands nl-NL) (version 9) (thanks to @TomTheDeveloper)
- language_es.yml ( Español es-AR) (version 9) (thanks to @adolfo_garolfo)
- language_hu.yml ( Hungarian hu) (version 11) (thanks to montlikadani)
(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!
Code (YAML):#Pinatas configuration file
#Should we use permission for each pinata?
#Notify about plugin updates?
#You can modify default locale of plugin here.
#en - English (default)
#pl - Polish / Polski
#fr - Français
#de - German / Deutsch
#nl - Nederlands
#es - Español
#hu - Hungarian / Magyar
#In this worlds you can create pinata only by console or '/pinata create' admin command.
- 'cASe SenSItIve wORLD namE'
#Exclusions of creating pinatas using crates or signs in disabled worlds
#false = blocked, true = unlocked
#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.
#Crate particle refresh time.
#Time in seconds.
#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.
#Because you can't set command item, you need to use configured item.
#Because you can't set money item, you need to use configured item.
#Because you can't set gun item, you need to use configured item.
#Enable halloween special pinata effects?
Pinata creation is explained itself in pinata_storage.yml, but if you want to know more or you don't understand something PM meCode (YAML):storage:
- ==: org.bukkit.inventory.ItemStack
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:
Since v2.2.7 config is updated automaticallyCode (YAML):halloween-mode: true
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!
Piñata [1.9-1.13] 3.0.1
Break pinata and get drops! | Crates, GUI's, drops preview, API, very configurable.