====== Weapon Upgrades ======

Weapon upgrades are enhancement levels that increase the base stats of weapons in Remixed Dungeon.

==== Upgrade Mechanics ====
Weapons can be upgraded to improve their performance:

  * **Positive Upgrades** - Each positive level increases damage output and may improve other stats
  * **Negative Upgrades** - Each negative level decreases damage output and performance
  * **Curses** - Negative effects that can be applied to weapons (removed when upgrading)

==== Positive Upgrades ====
Each positive upgrade level provides:
  * Increased damage range (specific formula varies by weapon type)
  * No change to attack speed (DLY property remains constant)
  * Better overall performance
  * Higher chance of success when fighting enemies

==== Negative Upgrades ====
Negative upgrades result in:
  * Reduced damage output
  * No change to attack speed
  * Lower overall performance

==== Acquisition ====
  * **Scroll of Upgrade** - Applies a single upgrade level to any upgradable item (weapon, armor, ring)
    * Also removes curses from the item
    * Does not add enchantments to weapons
  * **Scroll of Weapon Upgrade** - Applies a single upgrade level specifically to weapons
    * Also removes curses from the weapon
    * May add a random enchantment to the weapon when upgraded
  * **Shop purchases** - Occasionally found in higher-level shops
  * **Treasure drops** - Higher-level weapons may spawn upgraded

==== Code References ====
  * Java Class: [[https://github.com/NYRDS/remixed-dungeon/blob/master/RemixedDungeon/src/main/java/com/watabou/pixeldungeon/items/Item.java#L338-L370|Item.upgrade() and Item.degrade() methods and related level methods]]
  * Weapon Upgrade: [[https://github.com/NYRDS/remixed-dungeon/blob/master/RemixedDungeon/src/main/java/com/watabou/pixeldungeon/items/weapon/Weapon.java#L184-L196|Weapon.upgrade(boolean enchant) method]]
  * Armor Upgrade: [[https://github.com/NYRDS/remixed-dungeon/blob/master/RemixedDungeon/src/main/java/com/watabou/pixeldungeon/items/armor/Armor.java#L70-L82|Armor.upgrade() methods]]
  * Scroll of Upgrade: [[https://github.com/NYRDS/remixed-dungeon/blob/master/RemixedDungeon/src/main/java/com/watabou/pixeldungeon/items/scrolls/ScrollOfUpgrade.java|ScrollOfUpgrade.java]]
  * Scroll of Weapon Upgrade: [[https://github.com/NYRDS/remixed-dungeon/blob/master/RemixedDungeon/src/main/java/com/watabou/pixeldungeon/items/scrolls/ScrollOfWeaponUpgrade.java|ScrollOfWeaponUpgrade.java]]
  * Ring Upgrade: [[https://github.com/NYRDS/remixed-dungeon/blob/master/RemixedDungeon/src/main/java/com/watabou/pixeldungeon/items/rings/Ring.java#L89-L92|Ring.upgrade() method]]
  * Internal mechanics: [[https://github.com/NYRDS/remixed-dungeon/blob/master/RemixedDungeon/src/main/java/com/watabou/pixeldungeon/items/Item.java#L373-L377|visiblyUpgraded() method]]

==== Strategy ====
  * Balance upgrade level with your strength requirements (STR stat needed to wield)
  * Prioritize upgrading your main weapon for maximum impact
  * For weapons with high upgrade levels, ensure you can meet strength requirements
  * Consider that upgrading a weapon with an enchantment might remove the enchantment

==== Preservation ====
  * **Scroll of Remove Curse** - Can remove curses but doesn't directly downgrade items
  * Upgrading removes curses from items automatically

==== See Also ====
  * [[en:rpd:scroll_of_upgrade_item|Scroll of Upgrade]]
  * [[en:rpd:scroll_of_weapon_upgrade_item|Scroll of Weapon Upgrade]]
  * [[en:rpd:enchantments|Enchantments]]
  * [[en:rpd:armor_upgrades_mechanic|Armor Upgrades]]
  * [[en:rpd:items|Items]]
  * [[en:rpd:ring_upgrades_mechanic|Ring Upgrades]]
  * [[en:rpd:weapon_augmentation_mechanic|Weapon Augmentation]]
  * [[en:rpd:upgradeable_items|Upgradeable Items]]
  * [[en:rpd:scrolls|Scrolls]]

{{tag> rpd items upgrades weapons }}