Help

Installation instructions and fixes for common problems.

How it works

The addon is your in-game binder. It records your cards and collection history as you play.

The companion app runs on Windows. It reads the saved collection after a reload or logout, sends updates to the server and writes the update file the addon loads.

The server keeps your synced collection and provides the public ladder. You choose whether your collection is public or private when you sign in.

Install the addon

Download the addon
Get the ZIP from the download page (or the project's GitHub releases). Its checksum is listed beside it if you want to check the file.
Put it in your AddOns folder
Close the game and extract AzerothCardBinder into Interface/AddOns inside your Forever installation. The addon folder should contain its .toc file directly, without another nested copy of the folder.
Enable it in game
Start the game and enable World of Warcards in the character screen's AddOns list. Choose Ranked before collecting if you want to join the ladder. A new binder selects Ranked automatically once the companion has finished its setup. Without the companion, the addon asks you to choose Ranked or Casual before your first card. Open the binder from its minimap button or type /acb.

If it does not appear in the AddOns list, check that you installed it into the Forever game folder you actually launch.

Set up the companion app

Install the companion
Download the Windows installer from the download page. It installs for your user without administrator rights. It is not code-signed yet, so Windows may warn about an unknown publisher: choose More info, then Run anyway. The companion tells you when a newer version of itself or of the addon is available and can install it for you.
Sign in with Discord
Choose whether to join the public ladder or keep your collection private. Continue in your browser to complete Discord sign-in.
Choose your game folder
Use Find my game or Choose folder. Select the installation containing WTF and Interface.
Sync your collection
With the addon enabled, use /reload or log out. Wait for the companion to sync, then reload again to load the server update into the binder. If you closed the game, start it again instead. Check that the binder says RANKED / Ready before collecting for the ladder. Casual is an explicit choice and its drops cannot count towards Ranked later.

Planning to collect for the ladder? Read the Ranked rules before you start. A collection containing Casual drops is not eligible for the Ranked ladder.

Installation problems

Setup says Warcards is running, but I cannot find it

Closing the window normally leaves the companion in the system tray. Choose Quit there, or check Task Manager for World of Warcards. If it is already closed, cancel setup and restart Windows before trying again. Keep the downloaded installer in Downloads or another temporary download folder.

I moved the app, or setup cannot write a file

Moving the installed folder manually can leave Windows pointing at its old location. Download the latest installer and use its installation-folder page to choose a dedicated folder you can write to. Try the default location if a folder on another drive refuses writes. Cancel a failed installation rather than choosing Ignore. Do not delete %APPDATA%\World of Warcards or the game's WTF folder: they hold your account settings and binder saves.

If setup still fails, send the full error and the chosen installation path when reporting the problem. Do not send your key files.

Sync problems

The app can’t find my binder

Check the selected game folder, confirm the addon is enabled, then log into a character and use /reload. The app needs a saved collection before it can display an account. Try Sync collection after that.

The app can’t reach the server

Check the server status page and your internet connection. The app retries uploads automatically. Once the connection returns, try Sync collection. Your saved addon data is the upload queue.

Discord sign-in didn’t finish

Return to the companion and read its message. If you cancelled or the request timed out, try signing in again. If the app reports that its sign-in port is in use, close any other copy of the companion before retrying.

The game and server saves do not match

Choose Repair sync in the companion. It refreshes the sync data and looks for a usable saved backup. If one can be restored safely, the app asks you to close the game and approve the restore. Original files and current settings are kept. If no safe backup is available, keep your files and ask for help. Only choose to start a new binder if you deliberately want to start over.

My collection synced, but I’m not on the ladder

Check that you chose public visibility, that your collection has no Casual drops and that the companion reports a successful sync. The public page may take about a minute to update. The Ranked rules explains eligibility and review.

Cards and drops

Check the source on the card in your binder. Each card has its own rarity, and a few are especially elusive chase cards. Bad-luck protection runs in the background as eligible attempts are recorded.

If kills or loots do not seem to count, type /acb diag, loot a matching source, then check /acb log. Include the relevant diagnostic lines when reporting the issue, together with the creature's name and what you looted.

Wanted cards and trading

Mark cards as wanted in the binder’s Wanted tab. Target another player and choose Check my target to see what they want. Viewing their binder and sharing lists in a trade also lets you compare wanted cards.

Wanted lists stay in the addon and are shared directly with other players. They are not published on this website. Both players need the addon, and the other player must allow viewing in Settings.

Report a problem

When reporting an issue, include the addon and companion versions, the exact message, what you were doing and the steps that reproduce it. A screenshot of the affected screen is helpful.

Report it on the project's GitHub issue tracker (a free GitHub account is needed). The templates there ask for exactly these details. For anything private, such as a suspected security problem, use the repository's Security tab instead of a public issue.

Share relevant error lines rather than your full account or app data files, which can contain personal information.

Check server status