====== Boomerang ======

{{ rpd:images:boomerang_sprite.png|Boomerang }}

A curved throwing weapon that returns to the thrower after being thrown. It's a unique ranged weapon with returning properties.

==== Description ====
When thrown at the enemy this flat, curved, wooden missile will return to the hands of its thrower. The Huntress starts with this unique upgradeable weapon.

==== Stats ====
  * **Damage:** 1-4 (base) - scales with upgrades
  * **Strength Required:** 10
  * **Durability:** Returns after use (effectively unlimited)
  * **Special Property:** Returns after being thrown
  * **Price:** 100 gold
  * **Is Upgradable:** Yes
  * **Degrade Effect:** MIN -= 1, MAX -= 2 per degradation level
  * **Equip Time:** 0 (instant equip)
  * **Flight Type:** Curved path, fast rotating

==== Special Properties ====
  * **Returning:** Automatically returns to the thrower after hitting a target or missing
  * **Ranged Attack:** Can be used to attack distant enemies
  * **Reusable:** Does not require retrieval like other thrown weapons
  * **Upgradable:** Can be upgraded like other weapons
  * **Not for Reforge:** Cannot be used with the ShortSword reforge action
  * **Flight Path:** Flies in a curved path rather than straight (isFliesStraight() returns false)
  * **Rotation:** Spins rapidly while flying (isFliesFastRotating() returns true)
  * **Slot Restoration:** As of December 2025, returns to the original inventory slot where it was equipped (if it was in an equipment slot)
  * **Quickslot Restoration:** As of December 2025, also returns to the original quickslot position if it was thrown from a quickslot

==== Upgrading ====
  * Each upgrade: MIN += 1, MAX += 2
  * The only missile weapon that can be upgraded

==== Enchantments ====
  * Cannot naturally receive Piercing or Swing enchantments (enchant method filters these)
  * Other enchantments work normally

==== Notes ====
  * The boomerang is the starting weapon for the [[rpd:huntress|Huntress class]]
  * It will automatically return to the player's inventory or quickslot after being thrown
  * As of December 2025, it returns to the original inventory slot where it was equipped and restores quickslot position if thrown from a quickslot
  * This weapon is unique in that it combines ranged attack capability with unlimited durability
  * It's the only throwable weapon that starts the game already equipped
  * Has special mechanics for placement back in inventory/quickslot after use

==== Content Verification ====
* Information source: Java class [[https://github.com/NYRDS/remixed-dungeon/blob/master/RemixedDungeon/src/main/java/com/watabou/pixeldungeon/items/weapon/missiles/Boomerang.java|Boomerang.java]]
* Updated for recent changes: December 2025 update includes slot restoration features - returns to original inventory slot and quickslot position
* Last updated: December 2025, source: Remixed Dungeon 1.9.3

==== Source Code References ====
  * Java class: [[https://github.com/NYRDS/remixed-dungeon/blob/master/RemixedDungeon/src/main/java/com/watabou/pixeldungeon/items/weapon/missiles/Boomerang.java|Boomerang.java]]

{{tag> rpd items weapons throwing melee }}