AzerothForge Goldspark

# ✨ AzerothForge Goldspark 2.2.5
## 💎 Make your next discovery shine!

An ore vein beside the road, a herb hidden among the trees, or a treasure chest waiting to be opened: **AzerothForge Goldspark** helps you spot recognized finds in **World of Warcraft: Forever**. Golden world sparkles and matching minimap icons accompany your adventures across Azeroth. ⚔️🌍

## 🌟 Features

### ⛏️ Ore & 🌿 Herbs
Golden sparkles highlight the interaction target provided by the game. They brighten when you move within interaction range and turn grey when the target cannot be gathered.

### 🗝️ Treasures & Chests
Recognized treasure chests and crates can receive world sparkles and a matching chest icon over an existing minimap marker. A dedicated setting lets you toggle this category.

### 🧭 Matching Minimap Icons
Mining, herbalism, and treasure chest icons mark recognized finds. Compact round icons with a fine gold border follow movement, minimap zoom, and rotation when the client supplies the required position data.

An occasional missed query no longer immediately removes a marker. Finds are removed after several complete scans fail to confirm them.

### ✨ Customize Your Sparkles
- **Individual glint duration:** choose between 1 and 10 seconds.
- **Continuous sparkles:** prevents dark animation gaps while a valid target remains available.
- **Requested range:** adjustable from 5 to 60 yards, subject to the client's actual limits.
- **Separate toggles:** quest item effects, ore, herbs, nearby quest objects, and treasures & chests.

### 🏰 A WoW-Style Settings Window
Dark marble, golden accents, and side tabs bring the interface in line with our AzerothForge addons. Open your settings through the movable minimap button or **`/goldspark`**. Window position and preferences are saved.

## 🌍 16 Languages – Your Choice!

🇩🇪 German · 🇬🇧 English · 🇫🇷 French · 🇪🇸 Spanish  
🇷🇺 Russian · 🇰🇷 Korean · 🇯🇵 Japanese · 🇨🇳 Simplified Chinese  
🇵🇹 Portuguese · 🇹🇷 Turkish · 🇮🇹 Italian · 🇸🇪 Swedish  
🇳🇴 Norwegian Bokmål · 🇵🇱 Polish · 🇳🇱 Dutch · 🇨🇿 Czech

Choose a language manually or let automatic selection follow your game client language. The active language is shown in the window, and settings text switches immediately.

## 🛠️ Improvements in 2.2.5

- 🛡️ Additional safeguards for invalid saved settings.
- 🧭 Existing minimap markers survive individual query errors.
- ✅ Disabled options remain disabled after updates.
- 🔧 Safer restoration of game settings managed by the addon.

## 📦 Installation

1. Close WoW and extract the ZIP file.
2. Copy the included **`ForeverFunkel`** folder into **`World of Warcraft/_classic_beta_/Interface/AddOns/`**. When updating, replace the existing addon folder.
3. Launch WoW and enable **AzerothForge Goldspark** in the addon list.
4. Open settings with **`/goldspark`** or the minimap button. Activate the appropriate in-game tracking for ore or herbs.

The technical folder name **ForeverFunkel** is retained to preserve existing settings. You do not need to delete SavedVariables when updating.

## 💬 Useful Commands

| Command | Action |
| --- | --- |
| `/goldspark` | Toggle the settings window |
| `/goldspark language` | Open language selection |
| `/goldspark minimap` | Show or hide the addon button |
| `/goldspark reset` | Reset the minimap button position and show it |
| `/goldsparkmap` | Toggle resource and treasure minimap icons |
| `/goldsparkstatus` | Display minimap detection status |

## ℹ️ Good to Know

Additional world sparkles follow the interaction target supplied by the client: **one target at a time**. Even with a requested range of 60 yards, the Forever client may drop the target at approximately 15 yards. Continuous sparkles keep the animation visible on a valid target; they do not retain effects on objects that disappear or have been gathered. Additional world sparkles and minimap detection pause during combat.

Minimap icons require find markers that the client actually exposes. The addon does not reveal hidden resources or treasure. Object recognition covers known names; special Forever objects may require additional name mappings. The 16 settings languages do not automatically extend the list of recognized object names.

The original pickaxe above ore remains the game's interaction icon. Disabling native quest item effects may require a full game restart.

Avoid running multiple addons that modify the same soft-target settings.

## 📜 License

GPL-3.0-or-later. Required copyright and third-party notices are included in the package. Bundled fonts include their respective OFL license files.

---

**⛏️ Gather. 🌿 Explore. 💎 Shine. – AzerothForge Goldspark**