ItemGPS

ItemGPS — Find it. Farm it. Finish it.

You just got a crafting recipe that needs 200 Storm Dust. Two questions immediately follow: WHERE does that even drop? And once you're farming... how long is this going to take?

ItemGPS answers both. It is a complete farming companion built around one workflow: look an item up, learn exactly where it comes from, set it as a goal, and watch your progress tick up in real time while you farm.

— PART 1: THE ITEM DATABASE (where does it come from?) —

Type any item name — one of more than 174,000 items, every expansion from Classic to Midnight — and ItemGPS tells you every known source:

- Which mobs drop it, with drop rates and the best zones.
- Which vendors sell it, and where they stand.
- Which quests reward it.
- Where the mining/herbalism nodes are concentrated, zone by zone.
- Whether it comes from skinning, fishing, pickpocketing, chests, or a profession craft.

You never alt-tab to a website again. It also works the other way around: mouse over any item in your bags, the auction house, or a loot window, and its sources appear right in the tooltip.

- Search window with instant, accent-insensitive search (search "epee", find "Épée").
- Shift-click any result to link it in chat.
- Tooltip integration is configurable (number of source lines, on/off).

— PART 2: THE GOAL TRACKER (am I done yet?) —

Once you know where to farm, tell ItemGPS what you're aiming for: "200 Storm Dust", "50,000 gold", "3,000 Timewarped Badges". A compact, movable tracker window then follows you around while you play:

- Live progress bar for each goal, updated the instant loot hits your bags.
- Farming speed, computed from your actual session: "34/hour".
- Estimated time remaining: "about 1h20 left" — decide whether to push on or log off.
- A satisfying completion sound when a goal is done (optional).
- Track items, gold, and any in-game currency; goals can be per-character or account-wide.
- Add a goal by searching ANY of the game's items by name — with autocompletion — not just what is already in your bags.

INTENDED EXPERIENCE
ItemGPS is made for collectors, crafters, mount/transmog hunters and gold makers: the players whose to-do list is always "get N of X". The database tells you WHERE, the tracker tells you HOW LONG. The addon stays out of the way in dungeons and raids — it is a farming tool, not a combat tool.

COMMANDS
/tt (or /trouvetout) — item source search window
/tt options — settings panel
/fg (or /farmgoals) — goal tracker window
/fg add — add a goal (window with full-game item search)
/fg options — tracker settings

NOTES
- Fully localized in English and French (item name search works in both).
- One settings panel in Options > AddOns > ItemGPS, with a GoalDigger sub-panel.
- Existing GoalDigger users: remove the old standalone GoalDigger addon — this project now includes it. To keep your existing goals, copy the contents of WTF/Account/<account>/SavedVariables/FarmGoals.lua to the end of TrouveTout.lua in the same folder (game closed).
- Bulletproof: every Blizzard API call is error-shielded (Midnight 12.0 ready), the databases load in chunks so the game never freezes.

==================== FRANÇAIS ====================

ItemGPS — Trouvez. Farmez. Finissez.

Vous venez d'obtenir une recette qui demande 200 Poussières de tempête. Deux questions se posent aussitôt : OÙ est-ce que ça tombe ? Et une fois sur place... combien de temps ça va prendre ?

ItemGPS répond aux deux. C'est un compagnon de farm complet, construit autour d'un seul flux : chercher un objet, savoir exactement d'où il vient, le définir comme objectif, et regarder sa progression monter en temps réel pendant qu'on farme.

— PARTIE 1 : LA BASE DE DONNÉES (d'où ça vient ?) —

Tapez n'importe quel nom d'objet — plus de 174 000 objets, toutes les extensions de Classic à Midnight — et ItemGPS vous donne toutes les sources connues :

- Quels monstres le lâchent, avec les taux de butin et les meilleures zones.
- Quels vendeurs le vendent, et où ils se trouvent.
- Quelles quêtes le donnent en récompense.
- Où les gisements et les plantes sont concentrés, zone par zone.
- S'il vient du dépeçage, de la pêche, du vol à la tire, de coffres ou d'un métier.

Fini les alt-tab vers un site web. Et ça marche aussi dans l'autre sens : survolez n'importe quel objet dans vos sacs, à l'hôtel des ventes ou dans une fenêtre de butin, et ses sources s'affichent directement dans l'infobulle.

- Fenêtre de recherche instantanée, insensible aux accents (cherchez « epee », trouvez « Épée »).
- Maj-clic sur un résultat pour le lier dans le chat.
- Infobulle configurable (nombre de lignes de sources, activable/désactivable).

— PARTIE 2 : LE SUIVI D'OBJECTIFS (c'est bientôt fini ?) —

Une fois le bon spot trouvé, dites à ItemGPS ce que vous visez : « 200 Poussières de tempête », « 50 000 po », « 3 000 Insignes distordus ». Une petite fenêtre de suivi déplaçable vous accompagne ensuite en jeu :

- Barre de progression en direct pour chaque objectif, mise à jour dès que le butin arrive dans vos sacs.
- Vitesse de farm calculée sur votre vraie session : « 34/heure ».
- Temps restant estimé : « environ 1h20 » — de quoi décider si on continue ou si on se déconnecte.
- Un son de victoire quand un objectif est terminé (désactivable).
- Suivez objets, or et n'importe quelle monnaie du jeu ; objectifs par personnage ou partagés sur le compte.
- Ajoutez un objectif en cherchant N'IMPORTE QUEL objet du jeu par son nom — avec autocomplétion — pas seulement ceux de vos sacs.

EXPÉRIENCE VISÉE
ItemGPS s'adresse aux collectionneurs, artisans, chasseurs de montures/transmo et farmeurs d'or : les joueurs dont la liste de choses à faire est toujours « obtenir N fois X ». La base de données dit OÙ, le suivi dit COMBIEN DE TEMPS. L'addon se fait oublier en donjon et en raid — c'est un outil de farm, pas un outil de combat.

COMMANDES
/tt (ou /trouvetout) — fenêtre de recherche des sources d'objets
/tt options — panneau de réglages
/fg (ou /farmgoals) — fenêtre de suivi des objectifs
/fg add — ajouter un objectif (fenêtre avec recherche parmi tous les objets)
/fg options — réglages du suivi

REMARQUES
- Entièrement localisé en français et en anglais (la recherche fonctionne dans les deux langues).
- Un seul panneau de réglages dans Options > Addons > ItemGPS, avec un sous-panneau GoalDigger.
- Utilisateurs de GoalDigger : supprimez l'ancien addon GoalDigger — ce projet l'inclut désormais. Pour conserver vos objectifs, copiez le contenu de WTF/Account/<compte>/SavedVariables/FarmGoals.lua à la fin de TrouveTout.lua dans le même dossier (jeu fermé).
- Blindé : chaque appel d'API Blizzard est protégé contre les erreurs (prêt pour Midnight 12.0), les bases de données chargent par paquets pour ne jamais figer le jeu.