DustPlanner is a read-only companion for Hearthstone. This document states, in one place, what the project will and will not do with the game client, so that anyone auditing the code (or deciding whether to run it) knows where the line is.
- No input automation. DustPlanner never sends clicks, key presses, or any other input to the Hearthstone client. It never scripts the collection manager, never disenchants, never crafts. Every change to your collection is made by you, by hand, in the game.
- No memory reading of its own. DustPlanner does not read, scan, or hook
the Hearthstone process. It ships no native code, no
DllImportof process-inspection APIs, and no copy of HearthMirror. - No injection. Nothing is loaded into the game process.
- No network calls to Blizzard services. The only remote resource the tool fetches is the public card catalog from HearthstoneJSON, and only when you run a command that needs it.
- No scraping of third-party sites for meta data. Meta signals come from deck codes you paste into a local file.
- The HDT exporter is a standard Hearthstone Deck Tracker
plugin. It uses only HDT's public plugin API (
IPlugin,GameEvents,CollectionHelpers,HearthMirror.Reflection.Client) to read the data HDT already holds in memory, and writes it to JSON files on your disk. It adds no new access path to the game beyond what HDT itself performs. - The log tracker reads
Power.log, a plain-text file the game writes when logging is enabled inlog.config— the same mechanism every deck tracker uses. It opens the file read-only and shared, never the process. The only file it can write outside its own data folder is Blizzard'slog.config, and only when you rundustplanner games log-config --apply: it adds or completes the[Power]section (the settings HDT itself writes) and leaves every other line untouched. - Everything else (planner, store, MCP server, overlay host) works on local files and a local SQLite database.
If you believe any part of the code base violates the policy above, open an
issue titled policy: with the file and line. Pull requests that add input
automation, memory reading, or scraping will not be merged.
Hearthstone Deck Tracker itself reads the game client's memory (through HearthMirror) and has been tolerated by Blizzard for years, including in official tournaments under the Tournament Player Handbook. DustPlanner relies on that existing, well-known mechanism and does not extend it. Using HDT is your decision; review Blizzard's current End User License Agreement before you do.