CartoMapper

Unified Map Enhancement Addon for World of Warcraft: Wrath of the Lich King (3.3.5a)

---

Features

CartoMapper replaces several heavy map addons with a single, lightweight, high-performance package. It combines fog clearing, scroll zooming, coordinate display, group icons, points of interest, waypoints, instance maps, and battlefield minimap enhancements into one unified experience.

Feature	Description
Fog of War Clear	Reveals unexplored world map regions as removable or fully transparent overlays, with optional color tinting
Scroll-to-Zoom & Drag-to-Pan	Smooth mousewheel zoom (up to 10x) with cursor-centered scaling and click-and-drag navigation
Coordinates	Real-time cursor and player position coordinates at the bottom of the map, with optional player speed and waypoint ETA
Waypoints	TomTom-style waypoint system with a navigation arrow, cross-zone routing, and automatic path gate management
Class-Colored Group Icons	Party/raid members displayed with class colors, subgroup numbers, and pulsing visual indicators (dead, in combat, AFK)
Points of Interest	Dungeon/raid portals, flight paths, spirit healers, clickable zone-crossing arrows, and extended flight masters for Northrend zones
Instance & Battleground Maps	View dungeon, raid, and battleground maps offline from the continent/zone dropdowns
Battlefield Minimap	Enhanced Shift+M map with configurable size, opacity, unlock, and zoom levels
Zone Level Info	Recommended level ranges and minimum fishing skill shown on zone map tooltips
Compatibility	Exposes a TomTom API shim (TomTom.lua) so third-party addons expecting TomTom can register waypoints through CartoMapper's native waypoint system, without forcing users to install the original TomTom
Borderless / Click-Through Map	Hides default frame borders for a clean overlay; optional click-through mode; controls reappear on hover
Ctrl + Scroll Scaling	Scale the windowed map frame size on the fly
Per-Character Settings	Override global settings on a per-character basis

---

Installation

1. Download the latest release or clone this repository.
2. Copy the CartoMapper folder into your WoW addon directory:

   World of Warcraft\Interface\AddOns\
   

3. Ensure the folder is named exactly CartoMapper (not CartoMapper-main).
4. Log in and type /cm to open the configuration panel.

Note

CartoMapper targets WoW 3.3.5a (Wrath of the Lich King). It requires the Interface: 30300 API.

---

Slash Commands

Command	Description
/cm / /cartomapper	Toggle the configuration panel
/cm status	Print the current state of all modules to chat
/cm toggle <option>	Toggle a specific module on or off

Available toggle options:

• zoom — Scroll-to-zoom and drag-to-pan
• coords — Cursor and player coordinates
• coordsSpeed — Player speed and waypoint ETA readout
• battleMap — Enhanced battlefield minimap
• groupIcons — Class-colored group icons
• fogClear — Fog of war reveal
• pois — Points of interest
• flightMasters — Extended flight master dataset for Northrend and other zones
• transportRoutes — Extended boat/zeppelin/portal pickup points (Northrend)
• borderless — Borderless windowed map
• minimapButton — Minimap shortcut button

Example: /cm toggle fogclear

Waypoints

Command	Description
/way [x] [y] [desc]	Add a waypoint in the current zone
/way [zone] [x] [y] [desc]	Add a waypoint in a specific zone
/way clear	Clear all active waypoints
/wayback / /wayb	Bookmark your current position
/cway / /closestway	Set the nearest waypoint as active

Tip

Some toggles require a /reload to take full effect. The configuration panel marks these with an asterisk (*).

---

Configuration Panel

Open with /cm or by clicking the minimap button. The panel has seven tabs:

General

• Minimap button visibility
• Remember zoom level across map openings
• Show zone level and fishing skill info on tooltips

Map Window

• Borderless mode (hides frame borders)
• Click-through mode (interact through the map)
• No fade on cursor hover
• Hide town/city icons on continent maps
• Map window scale (0.5x – 4.0x)
• Stationary and moving opacity (0.1 – 1.0)

Zoom / Pan

• Enable/disable scroll-to-zoom
• Center map on player automatically
• Maximum zoom scale (1x – 10x)
• Player arrow and group icon sizes

Fog Clear

• Enable/disable fog reveal
• Fog tint style: Normal (overlay grid) or Custom colored tint
• Fog transparency (0.1 – 1.0)
• Custom color picker

Points of Interest

• Master toggle for all POIs
• Extended flight master dataset for Northrend zones (Borean Tundra, Howling Fjord, Dragonblight, Grizzly Hills, Zul'Drak, Sholazar Basin, Storm Peaks, Icecrown, Crystalsong Forest, Wintergrasp)
• Individual filters: dungeons & raids, same-faction flights, opposing-faction flights, spirit healers, zone crossings

Battlefield

• Enable/disable enhanced battlefield map
• Unlock for dragging
• Center on player
• Group and player arrow sizes
• Battlefield map size and opacity
• Maximum zoom limit

Group Icons

• Class-colored icons with subgroup numbers (1–8)
• Visual states: dead (grey), in-combat (red), AFK (purple)

Waypoints

• Enable/disable waypoint system
• Arrival distance threshold
• Arrow scale and alpha
• Show estimated time of arrival (ETA)

---

Per-Character Settings

CartoMapper supports per-character setting overrides. Enable the Per-Character Settings checkbox in the configuration panel header to create a separate profile for the current character. Changes made while this checkbox is active will only affect that character.

---

Architecture

The addon is modular. Each feature is a separate Lua file that registers itself with the core:

Module	File	Description
Core	CartoMapper.lua	Initialization, module loader, minimap button, slash commands
Database	DB.lua	SavedVariables management, per-character profiles, migration
Zone Info	ZoneInfo.lua	Zone level ranges, fishing skill data, town/city icon hiding
Coordinates	Coords.lua	Cursor and player coordinate display
Fog Clear	FogClear.lua	Unexplored area overlay rendering
Battle Map	BattleMap.lua	Battlefield minimap customization
Group Icons	GroupIcons.lua	Class-colored party/raid icons
Zoom	Zoom.lua	Scroll-to-zoom, drag-to-pan, frame scaling
POIs	POIs.lua	Points of interest database and rendering
Flight Masters	FlightMasters.lua	Extended flight master data layer (Northrend and other zones; data sourced from Carbonite, GPL)
Instance Maps	InstanceMaps.lua	Offline dungeon, raid, and battleground map viewing
Waypoints	Waypoints.lua	Navigation arrow, cross-zone routing, and path gates
TomTom Shim	TomTom.lua	Globals TomTom object with AddZWaypoint/RemoveWaypoint/etc. so third-party addons can hook CartoMapper without requiring real TomTom
Transport Routes	TransportRoutes.lua	Northrend boat/zeppelin/portal pickup-point pins (data sourced from Carbonite, GPL)
Config	Config.lua	Options panel GUI

---

Key Bindings

You can bind the Toggle Options Panel command to a key in the game's Key Bindings menu, under the CartoMapper header.

---

Credits

CartoMapper was built by analyzing and integrating database/coordinate work from these addons:

• Mapster — Overlay database format
• Magnify-WotLK — Zoom/pan framework
• Leatrix Maps — Coordinate system
• MozzFullWorldMap — Fog reveal data
• Carbonite (GPL) — Flight master coordinate dataset, used purely as static reference data; also referenced for player speed formula (yards per coordinate unit) and Northrend transport pickup points

---

Support the Project

If CartoMapper makes your WoW experience better and saves you time, please consider buying me a coffee to support its ongoing development!

Buy Me A Coffee

Your support is highly appreciated and directly helps keep the addon updated, optimized, and packed with new features. Thank you!

---

License

This project is published under a proprietary Copyright Notice and Limited Personal Use license (c) 2026 Zendevve. All rights reserved.

Permitted:

• Download, study, fork, and install for personal, non-commercial use within World of Warcraft.
• Any copying is permitted only as technically necessary for downloading, viewing, forking, installing, backing up, or using the software as distributed by the copyright holder.

Not permitted without prior written permission:

• Modify, rename, redistribute, re-upload, bundle, or incorporate source code or assets into other projects.
• Sell, sublicense, or include in commercial offerings.
• Remove copyright notices or claim authorship.

Forking is permitted only for personal viewing, study, backup, or installation. Forks may not be modified, redistributed, or published as derivative works without prior written permission.

For full terms, read the LICENSE file at the root of the repository.