> For the complete documentation index, see [llms.txt](https://hypersoftware.gitbook.io/hyperstones/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://hypersoftware.gitbook.io/hyperstones/what-is-it.md).

# What is it?

HyperStones is an extremely configurable item **upgrade** plugin that introduces special items that can be used to upgrade weapons and armors inside the anvil.

**Spigot Version required**: 1.8.x - 1.20.x

## Upgrades

Upgraded Armors will grant greater protection, while upgraded Weapons will grant greater damage.\
Upgrades can be configured to require XP or Money (Vault required).

## Items

### Shards

Shards are dropped with a configurable chance by mobs or mined blocks. Inserting an upgradable item (weapon or armor) and a shard inside an anvil you will be able to upgrade your item.

### Shields

Shields are dropped with a configurable chance by mobs, mined blocks or during an upgrade. Shields will prevent your item from breaking during an unsafe upgrade.

### Luck Gems

Luck Gems are dropped with a configurable chance by mobs or mined blocks. They will contain a random luck boost percentage. If kept in the inventory while upgrading, Luck Gems will increase your success chance by the specified percentage.