Skip to content

Latest commit

 

History

50 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

FarmMap

A lightweight World of Warcraft gathering addon that automatically records the location of every herb, ore, fish and wood node you harvest — no manual input. Pins appear on your minimap and world map so you can build your own farming routes over time.

Download on CurseForge

Features

  • Automatic node recording on harvest — herbs, ores, fish and wood
  • Pins on both the minimap and the world map, with filter buttons per resource — Shift-drag to move the bar, Shift-right-click to flip it horizontal / vertical, and a slider to fade it out when the cursor is elsewhere
  • Primordial / abundant node support with a distinct visual style
  • Optional floating text on harvest: quantity, tier, total bag count, and the value of what you gathered — value display contributed by buseQ; it needs Auctionator, an optional dependency, with its auction house database already scanned once
  • Multiple icon styles, including colorblind-friendly presets (Deuteranopia, Protanopia, Tritanopia)
  • Minimap button — left click for the options, right click for the debug window
  • Export / import to share your node database with other players
  • Harvest statistics per resource type
  • English, French, Korean, Simplified Chinese and Russian, auto-detected from the game client with a manual override in the options — Korean by Crazyyoungs, Simplified Chinese by buseQ, Russian by ZamestoTV

Installation

Copy the FarmMap folder into World of Warcraft\_retail_\Interface\AddOns\, then restart the game client. A /reload is not enough when the file list changes — the .toc is only read at startup.

Slash commands

Command Description
/fm help Show all available commands
/fm debug Show/hide the debug window
/fm export Open the database export window
/fm import Open the database import window
/fm clear Wipe the node database (settings are preserved)
/fm stats Display harvest statistics in chat
/fm migrate Manually run database migrations
/fm atlas Open the icon atlas calibrator (for icon pack creators)
/fm default Switch back to your game client's language
/fm version Display the current addon version

/fm is a short prefix and other addons claim it — FocusMarker registers it too, and addons load alphabetically, so whichever sorts last wins. FarmMap detects this at login, names the addon that took it, and switches every command it prints to /farmmap, which always works. Nothing to configure.

Translations

FarmMap is translated by its community. Adding a language takes one file and no programming knowledge — copy lang/enUS.lua, translate the text between the quotes, and the language appears in the addon options on its own. Any key left untranslated falls back to English, so a partial translation never breaks anything.

The easiest route needs no file at all: phrases can be translated directly in the browser at legacy.curseforge.com/wow/addons/farmmap/localization — use the website, not the CurseForge desktop app, which does not offer that page.

The full step-by-step guide for the file route is in lang/README.md.

Locale Language Translator
enUS English Kroosstii
frFR Français Kroosstii
koKR 한국어 Crazyyoungs
zhCN 简体中文 buseQ (signs bluse)
ruRU Русский Hubbotu (signs ZamestoTV)

Pull requests adding a language are welcome, and translators are credited both in-game and here. You can also send your file on the FarmMap Discord if you would rather not use git.

Contributors

A good part of what FarmMap does today arrived from the people using it.

  • buseQ, who signs his translations bluse, wrote the harvest value display and sent it as pull request #4: the floating text can now show what the items you just gathered are worth, read from Auctionator through its public API and declared as an optional dependency. The idea and the code are entirely his, and it was merged unchanged. He also contributed the Simplified Chinese translation, and pull request #1 before that. Thank you.
  • Hubbotu, who signs ZamestoTV, contributed the entire Russian localization as pull request #2 — a complete locale, every single key, with the colour codes and escapes carried over untouched. Russian was not on any roadmap; it exists because he wrote it. Thank you.
  • Crazyyoungs asked for the world map filter bar to be movable and to fade out, so it stops colliding with other addons that use the same corner of the map. That request became the Shift-drag and the opacity slider. He also maintains the Korean translation, and has twice translated new strings within the hour, before anyone thought to tell him they existed. Thank you.

Icon packs

FarmMap exposes a public API so separate addons can register their own icon styles. Existing packs:

The in-game /fm atlas calibrator helps find the correct icon coordinates after a game patch shifts Blizzard's atlas layout.

Development

FarmMap's Lua code is written with AI assistance (Claude Opus 5, by Anthropic). Every change is reviewed and tested in game by the author before it is released.

This concerns the code only. The artwork is not AI-generated — see the License section below for how the two differ.

License

FarmMap's own source code is released under the GNU General Public License v3.0 — see LICENSE.

The GPLv3 does not extend to everything shipped in this repository:

  • Icon textures (Textures/atlas-blip-farmmap-*.tga) are modified versions of Blizzard's in-game Interface\Minimap\ObjectIconsAtlas, into which the author's own hand-made artwork has been added — colorblind-friendly, vivid and white-outline variants. The underlying Blizzard artwork remains the property of Blizzard Entertainment and is not the author's to relicense; only the author's own additions and modifications are his. They are bundled so the addon can display icons consistent with the game.
  • Bundled libraries in Libs/ keep their own licenses — see THIRD-PARTY-NOTICES.txt.

No AI-generated assets are used in this addon. Every asset added by the author was made by hand.

World of Warcraft and Blizzard Entertainment are trademarks or registered trademarks of Blizzard Entertainment, Inc. This addon is not affiliated with or endorsed by Blizzard Entertainment.

About

FarmMap is a lightweight gathering addon that automatically records the location of every herb, ore, fish, and wood node you harvest — no manual input needed. As you gather, pins appear on your minimap and world map so you can build your own personal farming routes over time.

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages