HomeJavaModsItemRewards | Private and Public Item Bombs! [1.8-1.16]
ItemRewards | Private and Public Item Bombs! [1.8-1.16]
ModsJava

ItemRewards | Private and Public Item Bombs! [1.8-1.16]

⬇ Download on Spigot
[​IMG]
What can I do with ItemRewards?
This plugin works as an Item Bomb creator. People can buy and throw these bombs to give the entire server an Item Reward, if the bomb type is set to Global. In the other case, if the bomb type is set to Private, just the user who throw it will get the reward.

These item rewards are fully configurable, you can set the items to win, their probabilities, the amount of prizes to win, the cost, animation and more!

Example: A user buys a Global Item Reward and throws it. A message will appear on the chat and all connected users on the server can click on it to get the reward.

[​IMG]

[​IMG]

- Item Rewards GUI Shop
- Item Rewards Use GUI
- Create your own Rewards:

- Create your own Items:
  • Name, Lore.
  • Enchantments.
  • Potion Effects.
  • Leather Armor Color.
  • Book Enchantments.
  • Written Books.
  • Fireworks Attributes.
  • Banner, Shields Attributes.
  • Skull Textures.
  • Item Flags.
  • Unbreakable Tag.
  • Attributes Modifiers.
  • Random Amount
  • Command Rewards instead of Items

- /ir save Commmand to save Items in a very easy way (Without touching the config)
- /ir open Command to give and open an Item Reward directly to a player.
- /ir give Command to give a specified reward to a player
- Plugin enabled in certain worlds
- Works in 1.8+
- Messages.yml file for translation
- Works in Craftbukkit and Spigot


[​IMG]

1) Download ItemRewards and Vault from here: https://dev.bukkit.org/projects/vault and place both files in plugins folder.
(If you are using another Economy plugin, tell me and I can try to add compatibility with it)
2) Start your server an wait until ItemRewards folder is created.
3) Open config.yml file and follow these tutorials below:

Spoiler: Config.yml Main Section Tutorial
#Here you can define the inventory items, use IDs instead of item names.
SINCE MINECRAFT 1.13 CHANGED ALL IDS YOU NEED TO USE MATERIAL NAMES FROM THIS PAGE (SAME FOR SOUNDS):
Materials: https://hub.spigotmc.org/javadocs/spigot/org/bukkit/Material.html
Sounds: https://hub.spigotmc.org/javadocs/spigot/org/bukkit/Sound.html


menu-decoration-id: "160:13"
main-menu-id: "262"
item-id: "54"


#Here you can define the sounds that some events will have.
If you are using a 1.8.X server use these Sounds:
https://github.com/Attano/Spigot-1.8/blob/master/org/bukkit/Sound.java

If you are using a 1.9-1.12 server use these Sounds:
http://www.theredengineer.com/1.9-playsound-list.html

global_reward_sound: BLOCK_NOTE_PLING
animation1_sound: BLOCK_NOTE_HAT


#Set this to true if you want to spawn a firework when a user receives an Item Reward.
firework_on_reward: true

#Here you can define in which worlds the plugin will be enabled
enabled-worlds:
- world
- world_nether
- world_the_end

#Enables or disables the Shop feature. If you set this to false, the only inventory the plugin will open is the Use Item Rewards (when using /ir)

buy-item-rewards-enabled: true

Spoiler: Config.yml Creating Items
Code (Text):
Items:
        helmet_1:
            id: 306
            name: "&6Guardian &8Helmet"
            amount: 1
            lore:
            - "&8With this item in your possession"
            - "&8you'll be a person to be reckoned with"
            enchants:
            - PROTECTION_ENVIRONMENTAL;7
            - PROTECTION_EXPLOSIONS;7
        diamonds:
            id: 264
            amount: 1-30
As you can see in the example, there are two Items created: helmet_1 and diamonds. These will be the items that you can win on a Item Reward. Of course you can add as many as you want, just remember to save them with different names.

[​IMG]


You can use the command: /ir save <name> to save the item you have in your hand, and store their properties automatically on this section of the config. I strongly recommend you using this feature when your item have a lot of properties, like a lot lines of lore, enchantments, attributes, etc..

If you want to do it manually, here is how you can do it:

#ID of the item to craft. Here you can find all IDs: http://www.minecraftinfo.com/idlist.htm
id: 306

#Here you can set a custom name for the item. You can use color codes. You can remove this section if you don't want a custom name for the item.
name: "&6Guardian &8Helmet"

#Here you can set the amount of the item to receive. You can place a line "-" between two numbers to give the player a random amount of items.
amount: 1
or
amount: 1-30

#Here you can set a custom lore for the item. You can use color codes. You can add as many lines as you want. You can remove this section if you don't want a custom lore for the ite,.
lore:
- "&8With this item in your possession"
- "&8you'll be a person to be reckoned with"



#Names of the enchantments that the item will have with the level of the enchant respectively. Here you can find a list with all the enchantments: https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/enchantments/Enchantment.html You can remove this section if you don't want enchantments for the item.
enchants:
- PROTECTION_ENVIRONMENTAL;7
- PROTECTION_EXPLOSIONS;7


#With this you can hide some ItemFlags like the attributes, enchants and more. You can find all the flags names here: https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/inventory/ItemFlag.html
hide-flags:
- HIDE_ATTRIBUTES


#If you add this section, that means that the player will receive commands rewards instead of an item. The item created on this section will only be placed on the reward inventory, but it will not be given to the player. You can add as many commands as you want, and remember that these commands are executed from the console.
command-reward:
- pex user %player% group set VIP
- "broadcast &a&l%player% won a &4&lVIP RANK &a&lon an Item Reward!"


#Here you can decide if the item should be unbreakable. Set this to true or false
unbreakable: true

#Here you can set the owner of a skull. For this option to work you need to set the ID of the item to: 397:3.
skull-owner: Ajneb

#You can also add a head with texture from sites like http://heads.freshcoal.com/ or https://minecraft-heads.com/
skull-texture: eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvOTA4Yjc3MmVjYWVlNzA2MjM1ZDFhZGJmMGI5YTI5YjU4YmE5YzBlZDYwZGU2ZjEwZWZiMWE3Zjg2ZDllIn19fQ==
skull-id: ec62ea75-402c-44fb-8f71-bef0015a4634

Spoiler: Config.yml Creating Rewards
Code (Text):
Rewards:
        reward1:
            name: "&aCommon &2Item Reward &7[&e%star%&7]"
            lore:
            - "&7The most basic Item Reward"
            - ""
            - "&2Cost: &a$1000"
            - ""
            - "&8[&6Click to Buy&8]"
            cost: 1000
            prizes_to_win: 1
            type: private
            animation_type: 1
            items:
            - diamonds;80
            - chestplate_1;15
In this section, you'll be able to create the item rewards that users will buy. The name and lore works as the same way that in the Items section. You can use the variable %star% to add a star symbol (✮) to the name of the reward.

[​IMG]

#Here you need to define the cost of the Item Reward. Remember that this plugin uses Vault for managing economy.
cost: 1000

#Here you can set the amount of prizes the players will win on this reward. The number you put in here, will change animations, so you can set just 1, 2 or 3 prizes per reward.
prizes_to_win: 1

#You can define a permission to buy the reward
permission: itemrewards.buy.reward1

#Here you need to select the type of this reward. If you set "private" that means that only the user who bought the reward will receive it. If you set "global" instead, that means that everyone connected to the server will receive the reward by clicking on a message on chat, as you can see on the picture.
type: global

[​IMG]


#Here you need to select the animation type the reward will have when receiving the items. Currently there are 2 animations types so you need to put "1" or "2" on this section. Don't worry, more animations are coming :)
animation_type: 1

[​IMG]

#Finally, you need to set them possible items to win for this reward. Obviously you need to create them first in the Items Section. For this to work you just need to put the name of the created item + ";" + the probability. You can set more than 100 if you want, and that will give the player more probabilities to win that item.
items:
- helmet_1;5
- emeralds;50
- diamonds;70

When you finish editing the config, remember to use the /ir reload command and you are ready to go! Below you can find the config.yml and messages.yml file

Spoiler: Config.yml
Code (Text):
#If you need a tutorial you have one on the plugin page:
Config:
    menu-decoration-id: "160:13"
    main-menu-id: "262"
    item-id: "54"
    global_reward_sound: BLOCK_NOTE_PLING
    animation1_sound: BLOCK_NOTE_HAT
    animation2_sound: BLOCK_LAVA_POP
    animation2_sound2: ITEM_SHIELD_BREAK
    animation2_sound3: ENTITY_GENERIC_EXPLODE
    get_reward_sound: ENTITY_FIREWORK_LAUNCH
    firework_on_reward: true
    new-version-reminder: true
    enabled-worlds:
    - world
    - world_nether
    - world_the_end
    Items:
        helmet_1:
            id: 306
            name: "&6Guardian &8Helmet"
            amount: 1
            lore:
            - "&8With this item in your possession"
            - "&8you'll be a person to be reckoned with"
            enchants:
            - PROTECTION_ENVIRONMENTAL;7
            - PROTECTION_EXPLOSIONS;7
        diamonds:
            id: 264
            amount: 1-30
        emeralds:
            id: 388
            amount: 1-5
        wood:
            id: "17:3"
            amount: 32-64
        chestplate_1:
            id: 299
            name: "&cAdventurer &4Chestplate"
            amount: 1
            color: 1096984
        command_1:
            id: '351:14'
            amount: 1
            name: "&4&lVIP RANK"
            command-reward:
            - pex user %player% group set VIP
            - "broadcast &a&l%player% won a &4&lVIP RANK &a&lon an Item Reward!"
    Rewards:
        reward1:
            name: "&aCommon &2Item Reward &7[&e%star%&7]"
            lore:
            - "&7The most basic Item Reward"
            - ""
            - "&2Cost: &a$1000"
            - ""
            - "&8[&6Click to Buy&8]"
            cost: 1000
            permission: itemrewards.buy.reward1
            prizes_to_win: 1
            type: private
            animation_type: 1
            items:
            - diamonds;80
            - chestplate_1;15
        reward2:
            name: "&9Rare &2Item Reward &7[&e%star%%star%&7]"
            lore:
            - "&7A rare Item Reward"
            - ""
            - "&2Cost: &a$5000"
            - ""
            - "&8[&6Click to Buy&8]"
            cost: 5000
            prizes_to_win: 2
            type: global
            animation_type: 2
            items:
            - helmet_1;5
            - emeralds;50
            - diamonds;70
            - chestplate_1;40
            - wood;60
           

Spoiler: Messages.yml
Spoiler: English
Code (Text):
# Here you can find the messages of the plugin.
Messages:
    prefix: '&8[&aItem&2Rewards&8]'
    errorGive: '&cTo give an Item Reward use: &7/ir give <player> <item reward> <amount>'
    noPermissions: '&cYou don''t have permission to use this command!'
    playerNotOnline: '&cThat player is not online.'
    rewardNotExists: '&cReward &a%reward% &cdoesn''t exists on the config.'
    rewardReceived: '&aYou have received &7x%amount% %name%'
    rewardPlayerReceived: '&aPlayer &e%player% &ahas received &7%amount% %name%'
    commandNotExists: '&cThat command doesn''t exists!'
    configReloaded: '&aConfig Reloaded'
    itemrewardsInventoryName: '&2&lItem Rewards &6&lMenu'
    buyItemRewardsInventoryName: '&2Buy &4Item Rewards'
    useItemRewardsInventoryName: '&2Use &4Item Rewards'
    useItemRewardLore:
    - "&7Type: %type%"
    - "&7Prizes to Win: &6%prizes%"
    - "&7Amount: &a%amount%"
    - ""
    - "&8[&eClick to Use&8]"
    privateType: "&4&lPRIVATE"
    globalType: "&b&lGLOBAL"
    mainMenuItemName: "&7Main Menu"
    buyItemRewardsItemName: '&2&lBUY &4&lITEM REWARDS'
    buyItemRewardsItemLore:
    - "&7Here you can buy some objects called &4Item Rewards"
    - "&7You can use or throw Item Rewards to give &aspecial items &7to"
    - "&7all connected people on the server."
    useItemRewardsItemName: '&a&lUSE &4&lITEM REWARDS'
    useItemRewardsItemLore:
    - "&7Here you can throw or use your &4Item Rewards"
    errorNoMoney: '&cYou don''t have the sufficient amount of money to buy this reward.'
    itemRewardBought: '&aYou have bought a %name% &afor &2%cost% &a!'
    useItemRewardGlobalMessage:
    - "&a» &6%player% &ahas thrown an Item Reward! &8[%name%&8]"
    - "&a» &8[&eClick Here to claim it!&8]"
    rewardAlreadyReceived: "&cYou have already received that reward."
    rewardInventory: "&1&lYOUR REWARD"
    fullInventoryError: "&cYou can't receive this reward because your inventory is full."
    errorNoItemInHand: "&cYou need a item in your hand to use this command."
    errorSave: "&cTo save an item on the config use: &7/ir save <name>"
    errorSaveAlreadyExists: "&cThat name already exists in the config!"
    itemSaved: "&aItem saved correctly!"
Spoiler: Spanish
Code (Text):
# Here you can find the messages of the plugin.
Messages:
  prefix: '&8[&aItem&2Rewards&8]'
  errorGive: '&cPara dar una Recompensa de Items: &7/ir give <jugador> <recompensa> <cantidad>'
  noPermissions: '&cNo tienes permiso para usar ese comando!'
  playerNotOnline: '&cEse jugador no esta conectado.'
  rewardNotExists: '&cLa Recompensa &a%reward% &cno existe en la config.'
  rewardReceived: '&aHas recibido &7x%amount% %name%'
  rewardPlayerReceived: '&aEl Jugador &e%player% &aha recibido &7x%amount% %name%'
  commandNotExists: '&cEse comando no existe!'
  configReloaded: '&aConfig Recargada'
  itemrewardsInventoryName: '&6&lMenu de &2&lRecompensas'
  buyItemRewardsInventoryName: '&2Compra &4Recompensas'
  useItemRewardsInventoryName: '&2Usa &4Recompensas'
  useItemRewardLore:
  - '&7Tipo: %type%'
  - '&7Total de Premios: &6%prizes%'
  - '&7Cantidad: &a%amount%'
  - ''
  - '&8[&eClick para Usar&8]'
  privateType: '&4&lPRIVADO'
  globalType: '&b&lGLOBAL'
  mainMenuItemName: '&7Menu Principal'
  buyItemRewardsItemName: '&2&lCOMPRAR &4&lRECOMPENSAS'
  buyItemRewardsItemLore:
  - '&7Aqui puedes comprar objetos llamados &4Recompensas de Items'
  - '&7Puedes usar o tirar estas recompensas para dar &aitems especiales &7a'
  - '&7todas las personas conectadas al servidor.'
  useItemRewardsItemName: '&a&lUSAR &4&lRECOMPENSAS'
  useItemRewardsItemLore:
  - '&7Aqui puedes usar o tirar tus &4Recompensas de Items'
  errorNoMoney: '&cNo tienes suficiente dinero para comprar esta recompensa.'
  itemRewardBought: '&aHas comprad un %name% &apor &2%cost% &a!'
  useItemRewardGlobalMessage:
  - '&a» &6%player% &aha tirado una Recompensa de Items! &8[%name%&8]'
  - '&a» &8[&eClick para reclamarla!&8]'
  rewardAlreadyReceived: '&cYa has recibido esa recompensa.'
  rewardInventory: '&1&lTU RECOMPENSA'
  fullInventoryError: '&cNo puedes recibir esta recompensa porque tu inventario esta lleno!'
  noPermissionBuy: '&cNo tienes permisos para comprar esa recompensa!'

VIDEOS:
Spanish (By Me)


English (By ServerMiner)


Russian (By @MrJaycob )


[​IMG]

-/ir Plugin Inventory to buy and use item rewards
-/ir give <player> <item reward> <amount> Gives item rewards to a specified player
-/ir open <player> <item reward> Opens an item reward directly to a specified player
-/ir save <name> Saves the current item you have in your hand, in the config
-/ir help Shows this message
-/ir info Show plugin info
-/ir reload Reload plugin config

[​IMG]

Just one: itemrewards.admin

[​IMG]

Spoiler: Screenshots
[​IMG]
Spoiler: Save Item Feature
[​IMG]

Please avoid posting bad ratings before asking. If you have problems or bugs with the plugin contact with me or post on the plugin discussion and I will take a look at it.

Commands

Plugin details

Read from the plugin's own plugin.yml.

Quick facts

Install steps are the general flow for this file type — How to install Minecraft Java mods & modpacks walks through it step by step.

ItemRewards | Private and Public Item Bombs! [1.8-1.16] is a free Minecraft Java mod. Compatible with Minecraft 1.8, 1.9, 1.10, 1.11 and newer. Downloaded 13,356 times (via Spigot). Download it and open it directly in the game.

Explore more