Equipment
The Equipment System in Valley of Heroes allows players to mint, upgrade, and manage powerful NFT equipment items that enhance heroes' capabilities.
🎯 Overview
Equipment are NFT items that can be minted using BONES tokens and upgraded using HONOR tokens. Each equipment has a type, rarity level, and upgradeable level (up to level 30).
🗡️ Equipment Types
There are 5 equipment types, each corresponding to a specific rarity:
- Berserker's Ring (Common) - Ring equipment
- Vampiric Blade (Rare) - Weapon equipment
- Shadowdancer's Charm (Epic) - Amulet equipment
- Warlord's Battleplate (Mythic) - Armor equipment
- Immortal Conqueror (Legendary) - Full set equipment (with type advantage)
⭐ Rarity Levels
Equipment come in 5 rarity levels, matching the hero rarity system:
- Common (N) - Gray
- Rare (R) - Blue
- Epic (E) - Purple
- Mythic (M) - Pink
- Legendary (L) - Gold
Rarity Distribution
When minting equipment, the rarity is randomly determined with the following probabilities:
- Common: 60%
- Rare: 30%
- Epic: 7%
- Mythic: 2.5%
- Legendary: 0.5%
💰 Minting Equipment
Requirements
- BONES Token: Equipment is minted using BONES tokens
- Max Supply: 3,000 equipment NFTs total
- Random Rarity: Rarity is randomly determined at mint time
Minting Process
- Acquire BONES tokens (earn from Titan Boss battles)
- Visit the Bones Market page
- Pay the equipment price in BONES
- Receive a random equipment NFT with random rarity
⬆️ Upgrading Equipment
Equipment can be upgraded from level 1 to level 30 using HONOR tokens.
Upgrade Costs
Upgrade costs vary by rarity and increase with each level:
| Rarity | Base Cost | Growth Rate |
|---|---|---|
| Common | 10 HONOR | 8% per level |
| Rare | 15 HONOR | 9% per level |
| Epic | 20 HONOR | 10% per level |
| Mythic | 25 HONOR | 11% per level |
| Legendary | 30 HONOR | 20% per level |
Upgrade Formula
The cost to upgrade from level L to L+1 is calculated as:
Cost = BaseCost × (1 + GrowthRate)^(L-1)
Bulk Upgrade
You can upgrade multiple levels at once using the upgradeEquipmentMultiple function, which:
- Saves gas costs by combining multiple upgrades into a single transaction
- Validates total cost to ensure accuracy
- Updates level in a single operation
Example Costs
Common Equipment (8% growth):
- Level 1 → 2: 10.8 HONOR
- Level 5 → 6: 13.6 HONOR
- Level 10 → 15.0 HONOR
- Level 20 → 21.6 HONOR
- Level 29 → 30: 86.3 HONOR
Legendary Equipment (20% growth):
- Level 1 → 2: 36.0 HONOR
- Level 5 → 6: 74.6 HONOR
- Level 10 → 11: 185.8 HONOR
- Level 20 → 21: 1,154.6 HONOR
- Level 29 → 30: 6,644.2 HONOR
📊 Equipment Stats
Each equipment has:
- Equipment Type: Determined by rarity (1:1 mapping)
- Rarity: Common, Rare, Epic, Mythic, or Legendary
- Level: Current level (1-30)
- Type Advantage: Only Legendary (Immortal Conqueror) has type advantage
🎮 Strategic Considerations
Investment Priority
- Legendary Equipment: Highest priority - best stats but most expensive to upgrade
- Mythic Equipment: Good balance of rarity and upgrade costs
- Epic Equipment: Decent for mid-game progression
- Rare/Common: Use for early game or as backup equipment
Upgrade Strategy
- Early Levels: Focus on getting equipment to level 10-15 for good stat boosts
- Mid Game: Invest in higher rarity equipment (Epic/Mythic)
- End Game: Max out Legendary equipment for maximum power
- Bulk Upgrades: Use bulk upgrade feature to save gas when upgrading multiple levels
Cost Management
- Higher rarity = higher upgrade costs
- Legendary equipment costs significantly more to upgrade (20% growth vs 8-11% for others)
- Plan your HONOR spending based on your equipment collection
- Consider the long-term investment when choosing which equipment to upgrade
🔗 Related Systems
- BONES Token: Used to mint equipment
- HONOR Token: Used to upgrade equipment
- Titan Boss: Earn BONES tokens by fighting Titan Boss
- Hero Upgrades: Similar upgrade system for heroes
⚠️ Important Notes
- Equipment rarity is permanently assigned when minted
- Equipment level starts at 1 (not 0)
- Maximum level is 30
- Equipment can be traded on secondary markets (ERC721 standard)
- All equipment upgrades use HONOR tokens (6 decimals)
- Bulk upgrades are more gas-efficient than individual upgrades