![⚜️ HyperStones [1.8-1.20.4] ⚜️ | Upgrade your items - Economy - ✨ Particles ✨](/data/resource_icons/0/232.jpg?1714069856){kind=icon}
- Minecraft Versions
- 1.8, 1.9, 1.10, 1.11, 1.12, 1.13, 1.14, 1.15, 1.16, 1.17, 1.18, 1.19, 1.20
- Languages Supported
- All messages are configurable!
HyperStones is an extremely configurable item upgrade plugin that introduces special shards that can be used to upgrade weapons and armors inside the anvil.
The shards are dropped with a configurable chance by mobs or by mined blocks. Inserting a weapon/armor and a shard inside an anvil you will be able to upgrade the item until a maximum level. Some upgrades are safe, others have a chance to fail, downgrade or destroy your item.
During a successful upgrade you have a chance of getting some shields,
that, if kept in your inventory during an upgrade, are going to prevent your item from breaking. Shields can also be configured also to be dropped by mobs or blocks (like the Shards).
Upgraded Armors will grant greater protection, and upgraded Weapons will grant greater damage.
Mobs and blocks can also drop LuckGems, which can increase the upgrade success chance by a certain percentage depending on the gem type.
HyperStones is compatible with: Vault, ItemsAdder, Oraxen.
/hs help - Show the plugin commands.
/hs info - Show the plugin infos.
/hs stats - Show the hand held item infos.
/hs toggleparticles - Toggle particles displaying while holding an upgraded item.
/hs setlevel [level] - Set the upgrade level of the hand held item.
/hs setdamage [damage] - Set the damage of the hand held item.
/hs giveshard [player] <amount> - Give shards to a player.
/hs giveshield [player] <amount> - Give shields to a player.
/hs giveluckitem [luckBoost] [player] <amount> - Give luck items with a certain luck boost to a player.
/hs reload - Reload the config and lang files.
(ALIAS: stones, stone, hyperstone, hyperstones, hypershard, hypershards)
hyperstones.* - Give access to every command.
hyperstones.use - Give access to upgrade items.
hyperstones.help - Give access to the plugin command list.
hyperstones.info - Give access to the plugin infos.
hyperstones.stats - Give access to display infos of the hand held item.
hyperstones.toggleparticles - Allows to toggle particles displaying while holding an upgraded item.
hyperstones.specialattack - Allows a player to use the special attack (if enabled).
hyperstones.setlevel - Give access to set the upgrade level of the hand held item.
hyperstones.setdamage - Give access to set the damage of the hand held item.
hyperstones.giveshard - Give access to give shards to players.
hyperstones.giveshield - Give access to give shields to players.
hyperstones.giveluckitem - Give access to give luck items to players.
hyperstones.reload - Give access to reload the plugin config file.
hyperstones.tabcompletion - Give access to tab completion while typing commands.
YAML:
items:
hyperstone:
name: '&3&nHyperShard'
lore:
- "&3&l* &7Use this inside an anvil"
- "&7with a weapon or an armor"
- "&7to upgrade it."
item-type: PRISMARINE_SHARD
glow: true
min-drop-amount: 1
max-drop-amount: 4
hypershield:
name: '&e&nHyperShield'
lore:
- "&e&l* &7Keep this in your"
- "&7inventory while upgrading"
- "&7to prevent breaking the item."
item-type: PAPER
glow: true
min-drop-amount: 1
max-drop-amount: 2
luckitem:
name: '&a&nLuckGem'
lore:
- "&a&l* &7Keep this in your"
- "&7inventory while upgrading"
- "&7to increase the success chance."
- "&aLuck boost: {luck_boost}%"
item-type: EMERALD
glow: true
min-drop-amount: 1
max-drop-amount: 2
min-luck-boost: 10 #%
max-luck-boost: 20 #%
upgraded-item-preview:
safe-upgrade:
lore:
- "&aSafe Upgrade"
# - "&dXp required: {xp_required}"
# - "&eMoney required: {money_required}"
unsafe-upgrade:
enabled-chances-lore: true
chances-lore:
- "&aSuccess chance: {success_chance}%"
- "&eFail chance: {fail_chance}%"
- "&cDowngrade chance: {downgrade_chance}%"
- "&4Break chance: {break_chance}%"
- "&dXp required: {xp_required}"
- "&eMoney required: ${money_required}"
no-chances-lore:
- "&cUnsafe Upgrade"
# - "&dXp required: {xp_required}"
# - "&eMoney required: {money_required}"
max-lvl-reached:
lore:
- "&6Max Upgrade Level"
upgraded-item:
show-level-in-displayname: false
# This option can be set to: 'start' (same as 0), 'end' (dynamically calculated), raw number (ex. '0', '2' ...)
level-lore-line-index: end
level-displayname-pattern: '+{level}'
level-lore-line: '&b➥ HyperPower: +{level}'
damage-boost-lore-line: '&c➥ Damage: {damage}'
protection-addition-lore-line: '&6➥ Protection: +{protection}%'
upgrade-levels:
# Hoes, Shovels and Pickaxes
tool:
safe-upgrade-until-level: 5
max-upgrade-level: 12
upgrade-announce-start-at-level: 8
# Swords, Axes, Bows, Crossbows and Trident
weapon:
safe-upgrade-until-level: 5
max-upgrade-level: 12
upgrade-announce-start-at-level: 8
armor:
safe-upgrade-until-level: 5
max-upgrade-level: 12
upgrade-announce-start-at-level: 8
# Toggle broadcast message on upgrade
broadcast-on-upgrade: true
chances:
# NOTE: chances have to be expressed with decimal numbers (1 = 100%).
default-chances:
hypershields-on-upgrade-drop-chance: 0.02
# WARNING: in order to work correctly, the sum of the following upgrade chances must be 1.
upgrade-success: 0.6
upgrade-fail: 0.15
upgrade-fail-downgrade: 0.15
upgrade-fail-destroy: 0.1
# Per level chances will override the default-chances and bypass the "auto-chance-progression" if enabled
# NOTE: Do not specify any level if you want to use default-chances
per-level-chances:
6:
upgrade-success: 0.6
upgrade-fail: 0.15
upgrade-fail-downgrade: 0.15
upgrade-fail-destroy: 0.1
7:
upgrade-success: 0.6
upgrade-fail: 0.15
upgrade-fail-downgrade: 0.15
upgrade-fail-destroy: 0.1
auto-chance-progression:
enabled: false
# The "speed" with which the success chance decreases and the fail chance increases (i suggest to keep this value low)
# Note: set this to 0 to disable this feature
chance-progression: 0.3
# The minimum success chance reachable
minimum-success-chance: 0.05
# NOTE: boosts have to be expressed with decimal numbers (1 = 100%).
# Equation to get the total damage (same for defence): baseDmg + upgradeLvl * (baseDmg * boost)
boosts:
# Swords, Axes, Hoes, Shovels and Pickaxes
melee-weapons:
dmg-percent-addition-per-level: 0.02
# Bows, Crossbows and Trident
ranged-weapons:
dmg-percent-addition-per-level: 0.02
armor:
def-percent-addition-per-level: 0.02
# You can find all the block types here: https://hub.spigotmc.org/javadocs/spigot/org/bukkit/Material.html
# You can add as many blocks as you want, just follow the following layout:
#
# block_type:
# stones-drop-chance: [value from 0 to 1]
# shields-drop-chance: [value from 0 to 1]
# luckitem-drop-chance: [value from 0 to 1]
#
# NOTE: USE blacklist.yml TO DISABLE QUICKLY BLOCKS FROM DROPPING ANY KIND OF ITEM (stones, shields and luck items)
blocks:
# Disable drops for shards and shields if you are digging with an item enchanted with silk touch.
disable-silk-touch-drops: false
drop-only-on-survival-gamemode: true # i suggest to keep this true
# Default chances are active for each block not specified
default: # DO NOT delete the default section.
stones-drop-chance: 0.1
shields-drop-chance: 0.02
luckitem-drop-chance: 0.01
grass_block:
stones-drop-chance: 0 # value '0' means disabled drop
shields-drop-chance: 0
luckitem-drop-chance: 0
# You can find all the mob types here: https://hub.spigotmc.org/javadocs/spigot/org/bukkit/entity/EntityType.html
mobs:
default: # DO NOT delete the default section.
stones-drop-chance: 0.15
shields-drop-chance: 0.07
luckitem-drop-chance: 0.01
pig:
stones-drop-chance: 0.2
shields-drop-chance: 0.1
luckitem-drop-chance: 0.5
xp:
xp-required: true
xp-required-for-safe-upgrades: false
min-xplvl-required-to-upgrade: 5
xplvl-increment-per-upgrade: 2
remove-xplvls-on-upgrade: false
anti-spam-not-enough-xp-msg: true
money:
money-required: true
money-required-for-safe-upgrades: false
min-money-required-to-upgrade: 500
money-increment-per-upgrade: 1000
remove-money-on-upgrade: false
anti-spam-not-enough-money-msg: true
# You can find all the latest particle types here: https://hub.spigotmc.org/javadocs/spigot/org/bukkit/Particle.html
# legacy particle types: https://www.spigotmc.org/wiki/particle-list-1-8-8/
####### LEGACY DEFAULT SETUP #######
# upgrade-success: FIREWORKSSPARK
# upgrade-fail: SMOKE
# upgrade-fail-downgrade: SMOKE
# upgrade-fail-destroy: SMOKE
# mob-drop-shard: WITCHMAGIC
# mob-drop-shield: WITCHMAGIC
# mob-drop-luckitem: WITCHMAGIC
# block-drop-shard: WITCHMAGIC
# block-drop-luckitem: WITCHMAGIC
# block-drop-shield: WITCHMAGIC
# charging-ability: WITCHMAGIC
####################################
particles:
upgrade-success: FIREWORKS_SPARK
upgrade-fail: SMOKE_NORMAL
upgrade-fail-downgrade: SMOKE_NORMAL
upgrade-fail-destroy: SMOKE_NORMAL
mob-drop-shard: SPELL_WITCH
mob-drop-shield: SPELL_WITCH
mob-drop-luckitem: SPELL_WITCH
block-drop-shard: SPELL_WITCH
block-drop-luckitem: SPELL_WITCH
block-drop-shield: SPELL_WITCH
charging-ability: SPELL_WITCH
# Particles which are displayed while holding an upgraded weapon
# >> Available particle shapes: CIRCLE, HALO, DNA <<
per-upgrade-level-particles:
# If disabled any kind of particles (default and level-specific) is not going to work
global-enabled: true
default:
# If particles should be spawned for each upgrade level keep this true
enabled: true
type: SPELL_WITCH
# The amount of particles will be (by default) the HyperLevel * Multiplier
multiplier: 2
max-particle-amount: 50
particle-shape: dna
# NOTE: level-specific particles will override default ones
# Here you can setup particle spawning for a certain upgrade level, using the following format:
#
# <upgradeLevel>:
# type: <particleType>
# amount: <particleAmount>
# particle-shape: <particleShape>
1:
type: FLAME
amount: 20
particle-shape: dna
# You can find all the sound types here: https://hub.spigotmc.org/javadocs/spigot/org/bukkit/Sound.html
sounds:
upgrade-success: ENTITY_PLAYER_LEVELUP
upgrade-fail: BLOCK_ANVIL_LAND
upgrade-fail-downgrade: BLOCK_ANVIL_LAND
upgrade-fail-destroy: ENTITY_BAT_TAKEOFF
upgrade-max-lvl-reached: ENTITY_VILLAGER_NO
not-enogh-xp-to-upgrade: ENTITY_VILLAGER_NO
not-enogh-money-to-upgrade: ENTITY_VILLAGER_NO
# A special attack that can be used while holding an upgraded weapon
special-attack:
enabled: true
upgrade-lvl-needed: 12
charging-time: 5 # seconds
cooldown-time: 600 # seconds
explosion: true
dash-forward: true
# Potion effect format: Effect#Level#Duration
self-potion-effects:
- SPEED#2#30
nearby-enemy-potion-effects:
enabled: true
range: 20
effects:
- SLOW#2#20
# Show blood particles when an upgraded item hits an entity
blood-on-upgraded-item-hit: true
# Hide default text inside item lore like: "When in main hand: ....", "Protection: ..."
hide-item-attributes-on-upgrade: false
# Items that cannot be upgraded.
# NOTE: by default all armors, swords, axes and bows are enabled.
disabled-items:
- "example_item"
# Worlds in which hyperstones won't work.
disabled-worlds:
- "world1"
- "world2"
# If you are using ItemsAdder plugin, you can make some custom items from that plugin upgradable
# by writing here their name.
itemsadder:
upgradable-items:
- "ItemsAdderItem1"
- "ItemsAdderItem2"
YAML:
Prefix: '&8[&b&oHyperStones&8] '
MsgUpgradeSuccess: '&7You upgraded your item to &bHyperPower +{upgrade_level}&7.'
MsgUpgradeFail: '&7The upgrade failed.'
MsgUpgradeFailDowngrade: '&7The upgrade failed and your item''s level has downgraded
to &bHyperPower +{upgrade_level}&7.'
MsgUpgradeFailDestroy: '&7The upgrade failed and your item was destroyed.'
BroadcastUpgradeSuccess: '&b{player}&7 has upgraded &b&n{item}&7 to &bHyperPower +{upgrade_level}&7.'
MsgNotEnoughXpToUpgrade: '&cYou can''t afford this upgrade, you must be level &e{required_level}&c.'
MsgNotEnoughMoneyToUpgrade: '&cYou can''t afford this upgrade, you must must have
&e${required_money}&c.'
MsgShieldPreventItemBreaking: '&7The upgrade failed but your item has been saved by
an {shield_name}&7!'
MsgOnGiveShards: '&7Given x{amount} {shard_name}&7 to &b{player}&7.'
MsgOnReceiveShards: '&7You received x{amount} {shard_name}&7 from &b{giver}&7.'
MsgOnGiveShields: '&7Given x{amount} {shield_name}&7 to &b{player}.'
MsgOnReceiveShields: '&7You received x{amount} {shield_name}&7 from &b{giver}&7.'
MsgOnDropShields: '&7You found x{amount} {shield_name}&7 while upgrading an item.'
MsgDisabledWorld: '&cHyperstones is disabled in this world ({world}).'
MsgNoPermission: '&cYou don''t have the permission to execute this command.'
ChargingAttack:
Title: ''
Subtitle: '&bAbility charging: &f{time}'
ChargingAttackCanceled:
Title: ''
Subtitle: '&bAbility charging: &ecanceled'
