✓ Heaven Stones 2.6.2

Basic Description

HS (HeavenStones) is a plugin that adds more end-game content to minecraft. HS adds "Heaven Stones" to the game, these can be found by killing mobs/players and mining blocks. Heaven Stones can be used with the unique upgrade system to add "Heavenly Improvements" to the armor or weapon. Heavenly improvements on weapons give increased attack damage, heavenly improvements on armor give reduced damage taken.
HeavenStones will give a new and unique end-game experience to all your players. There are also Scrolls Of Blessing, which can be used to protect your items from breaking when upgrading.

Complete Feature List

• Configure what entities drop heaven stones, configure the drop chance and drop amount.
• Configure what blocks drop heaven stones, configure the drop chance and drop amount and if silk touch is allowed or not.
• Block worlds from dropping heaven stones.
• Cool particle effects when a heaven stone drops.
• Easily execute upgrades inside an anvil.
  
• When upgrading, there can be 4 different outcomes:
  • Successful, the heaven stone is consumed, and the item is now one Heavenly Improvement higher. (Default: 50% chance)
  • Failed-Destroyed, the heaven stone is consumed, and the item is gone/destroyed. (Default: 10% chance)
  • Failed-Downgraded, the heaven stone is consumed, and the item is now one Heavenly Improvement lower. (Default: 10% chance)
  • Failed-Keep, the heaven stone is consumed, and the item hasn't changed. (Default: 20% chance)
• Upgrading weapons or armor will always be successful until +2 (Configurable)
• Special announcements in chat when a player manages to upgrade an item to a configurable level.
• There are unique sounds and particle effects for every outcome of an upgrade attempt.
• Upgrading can be done at any anvil, or in the upgrade panel you get from the command "/hs upgrade". This upgrade panel is not a normal anvil and can only be used for heaven stone upgrades. (this feature requires latest spigot version)
• When people are holding a heavenly improved weapon in their hands, depending on how much it is upgraded, there will be particle effects at the player their feet. These can be configured.
• When people have a fully upgraded armor set, depending on the level the upgraded armor set is, there will be special particle effects on the body of the player. These can be configured.
• Players can turn off their own particle effects with a command. (Other players will still be able to see that persons particles)
• The percent heavenly improvements increase or decrease damage can be configured.
• All messages are 100% configurable by changing messages.yml file, which is in the same location as your config.yml file.
• Change the names and lores of the heaven stones, heavenly improvement upgrades and scrolls of blessing as much as you like in the config.
• Disabled chosen armor/weapons from being upgradable.
• Compatible with spigot 1.8 and spigot 1.7 w/ protocol hack.
• NEW! Scroll Of Blessings! While this item is in the player his/here inventory, it will be consumed when upgrading an item. When a scroll was consumed, an item will not break or downgrade. (But the upgrade is not guaranteed to be successful.)
• Players can get a scroll of blessings when upgrading items. (configurable)

Commands

• /heavenstone or /hs
  • Show a basic explanation of heaven stones, and show how much increased/decreased damage the player has duo to his currently equipped items with heavenly improvements on them.
    • permission: heavenstones.cmd.info
    • default: true
• /hs particles or /hs p
  • This will toggle if the player wants to see their own particle effects or not. (Default: on)
    • permission: heavenstones.cmd.particles
    • default: true
• /hs upgrade or /hs up
  • This will open an upgrade panel which players can use to upgrade with heaven stones. Players can not use this as a normal anvil. (Requires latest spigot version.)
    • permission: heavenstones.cmd.guiupgrade
    • default: true
• /hs [give|giveScroll] <playerName> <amount>
  • This command can be used to give a specified amount of heaven stones or scrolls of blessings to the specified player. This can also be used by the console, for example, when you want to sell bundles of heaven stones to donators.
    • permission: heavenstones.cmd.give
    • default: op
• /hs freeupgrade <amount>
  • This command will set the "Heavenly Improved +<amount>" on the item that is in your hand.
    • permission: heavenstones.cmd.freeupgrade
    • default: op
• /hs reload
  • Reload all the settings from the config file and all the messages in the messages.yml file.
    • permission: heavenstones.cmd.reload
    • default: op
  Permissions
  Giving these permissions to players will reduce their break chance with 25%, 50% or 75%.
  
  Example:
  A normal player has 10% break chance and 20% keep chance.
  A player with the permission "heavenstones.breakchance.onefourth" willl have 2.5% break chance and 27.5% keep chance.
  
  Code (Text):
  
  heavenstones.breakchance.onefourth:
  default: false
  description: One fourth of the break chance is added to the fail-keep chance.
  heavenstones.breakchance.half:
  default: false
  description: Half of the break chance is added to the fail-keep chance.
  heavenstones.breakchance.threefourth:
  default: false
  description: Three fourth of the break chance is added to the fail-keep chance.
  
  
  
  
  Configuration file with explanations
  The configuration file provides FULL control over the plugin. Almost anything is configurable.
  BUT if you don't feel like doing any configurations, you can just keep the defaults.
  The default values are balanced and provide a fun game experience.
  Note: If you have a small server (5-20 players), you might want to increase the heaven stone drop chance slightly.
  Tip: copy paste this into notepad to read it better.
  Code (Text):
  
  items:
  scrollofblessing: # The name and lore description of the Scrolls Of Blessing can be configured here.
  name: '&9Scroll Of Blessings'
  lore: '&7Keep this in your inventory to prevent your items from breaking or downgrading
  when upgrading them with heaven stones.'
  heavenstone:
  name: '&6Heaven Stone'
  lore: '&2&oThis stone can be used to upgrade armor and weapons. ("/hs" for info)'
  improved:
  lore: '&6Heavenly Improved +'
  #All % values are ranged from 0 to 1. Example: 0.50 = 50%, 0.001 = 0.1%
  chances:
  weapon: #- The total off all weapon chances should always be 1
  succeed: 0.5 #- The chance of a weapon upgrade succeeding.
  fail-keep: 0.2 #- The chance of a weapon upgrade failing, but keeping the item.
  fail-destroy: 0.1 #- The chance of a weapon upgrade failing, and destroying the item.
  fail-downgrade: 0.2 #- The chance of a weapon upgrade failing, and downgrading the item.
  armor: #- The total off all armor chances should always be 1
  succeed: 0.65 #- The chance of an armor upgrade succeeding.
  fail-keep: 0.2 #- The chance of an armor upgrade failing, but keeping the item.
  fail-destroy: 0.05 #- The chance of an armor upgrade failing, and destroying the item.
  fail-downgrade: 0.1 #- The chance of an armor upgrade failing, and downgrading the item.
  on-upgrade:
  get-scrollofblessing: 0.015625 #- The chance to get a scroll of blessing during an upgrade.
  armor:
  save-upgrade-to:
  level: 2 #- The level up to a piece of armor can be upgraded risk free.
  max-upgrade:
  level: 10 #- The maximum level a piece of armor can be upgraded to. (Any item with a higher improved level than the maximum, will only have the effect of this maximum level)
  weapon:
  save-upgrade-to:
  level: 2 #- The level up to a weapon can be upgraded risk free.
  max-upgrade:
  level: 10 #- The maximum level weapon can be upgraded to. (Any item with a higher improved level than the maximum, will only have the effect of this maximum level)
  boost:
  weapon:
  damage-percent-per-upgrade: 0.04 #- The percent increase of damage per heavenly improvement on your weapon.
  armor:
  defense-percent-per-upgrade: 0.0125 #- The percent increase of damage per heavenly improvement on your armor.
  show-chances:
  succeed: true #- If the success chance of an upgrade should be previewed on the item in the output slot of an anvil.
  fail-keep: false #- If the fail-keep chance of an upgrade should be previewed on the item in the output slot of an anvil.
  fail-destroy: true #- If the fail-destroy chance of an upgrade should be previewed on the item in the output slot of an anvil.
  fail-downgrade: false #- If the fail-downgrade chance of an upgrade should be previewed on the item in the output slot of an anvil.
  announce:
  weapon:
  starting-at-level: 9 #- Starting at this level, successful upgrades will be announced globally.
  armor:
  starting-at-level: 9 #- Starting at this level, successful upgrades will be announced globally.
  effects:
  enabled: true #- If weapon and armor glow effects should be enabled or not.
  weapon:
  #You can add as many tiers as you want here.
  #Example: If you hold a +2 improved weapon, you won't have any particles.
  #Example: If you hold a +6 improved weapon, you belong to the tier2, which will give you 25 particles at your feet.
  #Example: If you hold a +10 improved weapon, you belong to the tier4, which will give you 100 particles at your feet.
  tier1:
  level: 3
  particles: 10
  tier2:
  level: 5
  particles: 25
  tier3:
  level: 7
  particles: 50
  tier4:
  level: 9
  particles: 100
  full-armor-set:
  #You can add as many tiers as you want here.
  #Example: If wear 3 armor pieces +6 and one armor piece +4, you will have a level 4 glow.
  # This means you belong to tier1 and you will have 10 particles around your body.
  #Example: If you wear 2 armor pieces of +8 and 2 armor pieces of +10, you will have a level 8 glow.
  # This means you belong to tier3 and you will have 50 particles around your body.
  #Example: If you wear 4 armor of +10, you will have a level 10 glow.
  # This means you belong to tier4 and you will have 100 particles around your body.
  tier1:
  level: 3
  particles: 10
  tier2:
  level: 5
  particles: 25
  tier3:
  level: 7
  particles: 50
  tier4:
  level: 9
  particles: 100
  particle:
  armor:
  material: STAINED_GLASS
  byte: 0
  weapon:
  material: SPONGE
  byte: 0
  drops:
  chances:
  #You can add for every EntityType a custom drop chance.
  #If the EntityType isn't in the list, the default drop chance will be used.
  #You can only use the Entity names that bukkit uses.
  #Full list of names: https://hub.spigotmc.org/javadocs/spigot/org/bukkit/entity/EntityType.html
  default:
  #This is the default drops chance, 0.2%. An item stack of 1 to 3 heaven stones will be dropped.
  chance: 0.002
  min-amount: 1
  max-amount: 3
  player:
  #This is a custom drop chance for creepers.
  chance: 0.01
  min-amount: 1
  max-amount: 4
  creeper:
  #This is a custom drop chance for creepers.
  chance: 0.01
  min-amount: 1
  max-amount: 4
  wither:
  #This is a custom drop chance for withers.
  chance: 0.8
  min-amount: 2
  max-amount: 6
  blockbreak-chances:
  #You can add a custom drop chance for every Material type, when a block gets broken.
  #If the Material Type isn't in the list, the default drop chance will be used.
  #You can only use the Material names that bukkit uses.
  #Full list of names: https://hub.spigotmc.org/javadocs/spigot/org/bukkit/Material.html
  default:
  #This is the default drops chance, 0.05%. An item stack of 1 to 3 heaven stones will be dropped.
  chance: 5.0E-4
  min-amount: 1
  max-amount: 3
  #The player may have silk touch on his used item to mine the block.
  without-silk-only: false
  diamond_ore:
  #This is a custom drop chance for diamond_ore. (2% chance)
  chance: 0.02
  min-amount: 2
  max-amount: 4
  #The player may not have used silk touch, this is to prevent infinitely replacing the diamond ore.
  without-silk-only: true
  emerald_ore:
  #This is a custom drop chance for emerald_ore. (5% chance)
  chance: 0.05
  min-amount: 2
  max-amount: 4
  #The player may not have used silk touch, this is to prevent infinitely replacing the emerald ore.
  without-silk-only: true
  enabled: true #- If heaven stone drops should be enabled or not.
  enable-blockdrops-in-creative: false #- If blocks should drop heaven stones for creative people or not
  disabled-worlds: #- world names in which no heaven stones should drop.
  - world_blah
  - another_example
  #A list of disabled materials that should not be upgradable.
  #Any item with an heavenly improvement put on before it got added here, will stop working.
  #Only use material names that Bukkit uses.
  #Full list of names: https://hub.spigotmc.org/javadocs/spigot/org/bukkit/Material.html
  disabled-materials:
  - EXAMPLE
  - WOOD_SPADE
  - GOLD_HOE
  disable-heavenstone-glow: false #- if you are using older clients (1.7.x), then put this on true to prevent client-side crashes
  heavenstone-material: PRISMARINE_SHARD
  
  Here is some simulation data based on the default config settings:
  Spoiler
  
  How to include Heaven Stones or items with Heavenly Improvements in an essential kit
  Code (Text):
  
  HeavenStones:
  
  prismarine_shard 1 name:&l&e&a&0&r<NameOfChoiceHere> lore:<LoreOfChoice>
  Or
  quartz 1 name:&l&e&a&0&r<NameOfChoiceHere> lore:<LoreOfChoice>
  Default:
  name:&l&e&a&0&r&6Heaven_Stone
  
  Heavenly Improved Lore:
  
  lore:&a&c&n&e&r<ImprovedTextOfChoice>
  Default:
  lore:&a&c&n&e&r&6Heavenly_Improved_+
  
  Scroll Of Blessings:
  
  paper 1 name:&c&0&a&l&r<NameOfChoiceHere> lore:&7<LoreOfChoiceHere>
  Default:
  paper 1 name:&c&0&a&l&r&9Scroll_Of_Blessings lore:&7<LoreOfChoiceHere>