# GWToolbox++ — full documentation

> Tools for Guild Wars. Generated from https://www.gwtoolbox.com. Each section below is one documentation page.

# Frequently Asked Questions

Source: https://www.gwtoolbox.com/docs/faq/

## General

### Is this for Guild Wars or Guild Wars 2?
GWToolbox++ is a tool for the **original Guild Wars** released in 2005 — the campaigns Prophecies, Factions, Nightfall, and the Eye of the North expansion — which some of the community also refer to as *Guild Wars Reforged*. It hooks the original `Gw.exe` client and does **not** work with Guild Wars 2 in any way. We have no plans to port it: GW2 is a completely separate engine and game, and there are already dedicated tools and overlays for it elsewhere. If you ended up here looking for a GW2 utility, this isn't it.

### Does Toolbox work with the Guild Wars Reforged mobile app?
No, and there are no plans to make it work. The mobile build is **compiled separately** from the Windows client — the function addresses, memory layouts, and game structures that Toolbox attaches to on the desktop client simply do not exist in the mobile binary. **No iOS or Android version of GWToolbox++ is planned.**

### Will I get banned for using GWToolbox++?
GWToolbox++ is a third party tool that can automate aspects of gameplay for a range of uses including auto-responding to incoming whispers using the `/afk` command, automatically maintaining pcons in an explorable area, loading hero team builds and salvaging/purchasing items in bulk.

Although many of these automations can be seen as quality-of-life improvements to the game, **this software goes against part of the [ArenaNet Code of Conduct](https://www.arena.net/en/legal/code-of-conduct)**:

"You may not use any third-party program (such as a "bot") to automate gameplay functions, including playing, chatting, interacting, or gathering items within our Games"

"You will not attempt to interfere with, hack into, or decipher any transmissions to or from the servers or other facilities running the Services."

...and is also mentioned in the [ArenaNet User Agreement](https://www.arena.net/en/legal/user-agreement):

"We do not permit the use of any third-party software, tools, or programs that interact with the Services that give one player an unintended, unnatural, or unfair advantage over another player. Such prohibited third-party software, tools, or programs include those that alter Game-balance in favor of one player over another, automate actions within the Services, promote unattended gameplay, or have an adverse effect on other users of the Services. Prohibited third-party programs will be determined at our sole discretion."

However, ArenaNet has indicated that GWToolbox++ from the official source is **acceptable to use in PvE areas, by itself (without other mods)**. See the [May 2024 game update notes](https://wiki.guildwars.com/wiki/Feedback:Game_updates/20240514) on the Guild Wars Wiki for details.

**Use this software at your own risk.**

### My antivirus detects toolbox as a virus! Are you hacking me?
The detection is a false positive, and it is caused by some techniques that GWToolbox needs to use. Most notably, toolbox has to run into another program and manipulate its memory at runtime (note: no modification is permanent). Toolbox is open source, so if you don't trust me you can read through the source code and compile directly from the source yourself.

**Can't even download it?** Chromium-based browsers (Chrome, Edge, Brave, etc.) often block `GWToolbox.exe` while it downloads, for the same false-positive reason. Lower your browser's Safe Browsing level before re-downloading — paste `chrome://settings/security` (or `edge://settings/privacy` on Edge) into the address bar, switch **Safe Browsing** to **Standard protection** (or turn it off temporarily), then download again. See the [troubleshooting page](/docs/troubleshooting/#your-browser-blocked-the-download) for the full steps.

### Can I run Toolbox with other programs such as Multi client Launchers, TexMod, uMod, or a screen recording software?
TexMod, uMod, screen recording software (in game capture mode) and Toolbox all use similar techniques to capture and display information on the screen. Because of this, they may interfere with each other. Also note that when you use more than one of the above programs Guild Wars may crash when you close any of them.

* Running Toolbox with multiple Guild Wars clients open is not a problem, Toolbox will ask which one to use.
* GWMultiLaunch is not supported and may have issues. [GW Launcher](https://github.com/GregLando113/gwlauncher/releases) and the Daybreak launcher are supported.
* TexMod or uMod may have issues. Use gMod instead.
* Screen recording software *should* work. You probably want to launch them last, after Toolbox. We recommend using "window capture" and not "game capture".

### I have a feature request or non-bug issue with GWToolbox++. Where can I voice it?
We are always open to comments and criticism about Toolbox++. If you have features or opinions of features you would like to voice to the developers, please leave your input on the [repository issue tracker](https://github.com/gwdevhub/GWToolboxpp/issues).

### Why does GWToolbox++ require Admin privileges?
GWToolbox++ needs admin privileges if Guild Wars has admin privileges. Guild Wars can be indirectly started with those privileges if it was started by a program that was run as admin. TexMod, uMod, GWML, GW Launcher, or Daybreak typically require admin privileges so we decided for Toolbox to require admin privileges by default, to avoid issues.

You can find a version of the launcher that doesn't require admin privileges [here](https://github.com/gwdevhub/GWToolboxpp/releases/tag/2.14_Release).

## Issues launching GWToolbox

### I run the launcher and then nothing happens / Guild Wars closes / crashes
There may be different reasons for this. Try the following, in no particular order:

* Launch both Guild Wars and Toolbox as administrator.
* Launch Toolbox while Guild Wars is running in windowed mode, not minimized or fullscreen.
* Avoid using other programs that interact with Guild Wars (TexMod, uMod, MultiLaunch, screen recording software, game overlays such as steam, fraps, etc)
* Add GWToolbox.exe and gw.exe to your antivirus whitelist. Although usually not needed, you may want to also add `GWToolbox.dll` to your whitelist. You can find it in the [settings folder](/docs/settings/#storage) (`C:\Users\[Username]\Documents\GWToolboxpp`).

### I run the launcher and I get the message "GWToolbox.dll was not loaded, unknown error" or "exit code 0"
This error typically means that some security feature is preventing Toolbox to access Guild Wars. It might be caused by any of the following:

* Data Execution Prevention. It is disabled by default but if enabled you need to add gw.exe to its whitelist.
* Security programs such as Windows Defender or any particularly zealous antivirus software. You typically need to add both GWToolbox.exe and gw.exe to its whitelist.

### Toolbox isn't working. What should I try before reporting a bug?

Please follow each of the steps below before asking for help. If something is still not working, do not hesitate to ask for help — but please provide accurate problem descriptions, how you can reproduce them, and post full error messages.

1. Re-download the exe from [https://gwtoolbox.com/](https://gwtoolbox.com/) and run it to make sure you have the latest version.
2. **Do not use any Toolbox plugins or other mods** — disable them and test again.
3. Try launching the game without GW Launcher/Daybreak.
4. Make sure you are running the latest version. Older Toolbox versions are **not supported**.
5. Toolbox only works in PvE areas. The Guild Hall is a PvP area and Toolbox will not load there.
6. Try running GWToolbox as administrator.
7. Make sure your antivirus is not interfering with GWToolbox. Add an exception for the GWToolboxpp folder to allow it to run without issues.
   - Windows Defender may block GWToolbox. To fix: Open **Windows Security** → **Virus & threat protection** → **Manage settings** → scroll to **Exclusions** → **Add or remove exclusions** → add the GWToolbox folder.
8. Go to your GWToolbox folder by navigating to `%USERPROFILE%\Documents\GWToolboxpp` in a File Explorer window.
   - Is there a `GWToolboxdll.dll`? Is there a folder named after your computer?
   - If there is no `GWToolboxdll.dll`, download the latest dll from [the releases page](https://github.com/gwdevhub/GWToolboxpp/releases), put it in the GWToolbox folder, and retry launching.
9. If you are getting a font can't be loaded error, download [Font.ttf](https://github.com/gwdevhub/GWToolboxpp/blob/master/resources/Font.ttf) and put it in the `GWToolboxpp\<Computername>` folder.

If you have a crash dump file, zip it up and attach it to your issue or send it to a developer on Discord.

### GWToolbox++ just crashed. How do I send a crash dump to the team?
When Toolbox crashes it writes a **crash dump** — a `.dmp` file — that the developers can use to pinpoint the problem. To send it:

1. Open a File Explorer window, paste `%USERPROFILE%\Documents\GWToolboxpp` into the address bar, and press enter.
2. Open the folder named after your computer, then open the **`crashes`** folder.
3. Find the most recent `.dmp` file (sorted by date), **zip it up**, and attach it either to a [new issue on the bug tracker](https://github.com/gwdevhub/GWToolboxpp/issues) or to a developer on Discord.
4. Please also describe what you were doing in game when it crashed, and confirm which Toolbox version you were running.

**Note:** the `GWToolbox.error.log` file that sits next to `GWToolbox.exe` is **not** the crash dump — it is the launcher's log and is usually 0 KB, which is normal. The file the team needs is the `.dmp` in the `crashes` folder above.

If there is no recent `.dmp` file, Toolbox skipped creating one on purpose. In a crash, Toolbox will **not** write a dump if you are running an outdated version or have plugins loaded — update to the latest version from [gwtoolbox.com](https://gwtoolbox.com/) and disable plugins, then reproduce the crash to get a usable dump.

## In-game issues and how-to

### Can I bind the same hotkey to perform multiple actions?
You sure can! Just create a second hotkey for the second action and assign the same key bind. When you press the key, you will perform all of the assigned actions in the order the hotkeys appear in the list.

You can also bind multiple keys to the same action, again by creating extra hotkeys, this time with the same action and different key binds.

### The icons on the [Pcons](/docs/pcons/), [Materials](/docs/materials/), and Toolbox window aren't showing up. How do I get them back?
This is a bug that causes the Toolbox launcher to not download the icons. Delete your `GWToolbox.exe` and replace it with [this one](https://github.com/gwdevhub/GWToolboxpp/releases/download/2.0-launcher/GWToolbox.exe).

### Toolbox cannot load font upon launch. How do I get it to load the font?
`Font.ttf` can be found in the GitHub repository in the resource folder. Download [this file](https://github.com/gwdevhub/GWToolboxpp/blob/master/resources/Font.ttf) and navigate to `C:\Users\[Username]\AppData\Local\GWToolboxpp` and copy it to that folder.

### I am missing icons in my Completion window. Help?
Missing icons are most likely not downloaded into your `C:\Users\%USERNAME%\Documents\GWToolboxpp\%COMPUTERNAME%\img` folder. All of the icons can be found in the [resources folder](https://github.com/gwdevhub/GWToolboxpp/tree/master/resources) in the GitHub repository where you can download them. By navigating to a single file, you will in most cases find a download button to download the individual file. If you are missing a lot of icons, you can download the repository from the [main page](https://github.com/gwdevhub/GWToolboxpp). Click *Code* and Download *Zip*. From the .zip-file, navigate to `GWToolboxpp-master.zip\GWToolboxpp-master\resources\` and drop the needed icon folder into `C:\Users\[Username]\AppData\Local\GWToolboxpp\img`.

### Why isn't Toolbox remembering my settings when I restart! Help?
Toolbox settings are saved to the files in the [settings folder](/docs/settings/#storage) when you close Toolbox or click "Save Now" at the bottom of the [Settings window](/docs/settings/). Settings are loaded from those files when you launch Toolbox or click "Load Now".

* Sometimes, closing Guild Wars without first closing Toolbox will result in settings not saving. To prevent this from happening, either use the "Save Now" button, or close Toolbox before Guild Wars.
* If you adjust settings and then load another copy of Toolbox before saving, it will load the old settings. If you then close the first copy of Toolbox, thus saving the new settings, the second copy will still have the old settings loaded. When you close that copy, the old settings will be saved, overwriting the new ones. Prevent this by loading the new settings onto the second copy of Toolbox before you close.

### My Toolbox is not showing! Help?
There are a few different things that could have happened. Here's how to fix them:

* Enter `/tb reset` and `/show settings`, in case you just moved the windows off-screen or hid all windows.
* Enter `/tb exit` to close Toolbox, open the `theme.ini` file in `C:\Users\%USERNAME%\Documents\GWToolboxpp\%COMPUTERNAME%`, and delete the line that says `GlobalAlpha`. Save the file and restart Toolbox.

### One of my windows has collapsed! I can only see the title bar. How do I get the window back?
You probably minimized it by accident. Double-click on the title bar to expand it, or to collapse it again.

### My urgoz door timer is not showing! Help?
The urgoz timer shows "Open" or "Closed", along with the time remaining, **under** the usual timer. If you cannot see it, it is usually because of any of the following reasons:

* You are not in Urgoz explorable. The timer only shows in the *explorable* urgoz map, not in the outpost.
* You have your timer on the bottom of the screen, the urgoz timer is off-screen. Move the timer up vertically.
* Your timer window is too small, the urgoz timer is not being shown. Go in settings, tick "Unlock Move All" and increase the size of the timer window.

---

# Troubleshooting

Source: https://www.gwtoolbox.com/docs/troubleshooting/

Most problems launching GWToolbox++, loading its add-ons, or saving a crash dump come down to **security software** — Windows Defender, third-party antivirus, **Controlled Folder Access**, or **Smart App Control** — blocking Toolbox from reading Guild Wars' memory, writing to your Documents folder, or loading a `.dll`. This page explains how to fix those, with direct links you can share.

If you are not sure which section you need, the error message Toolbox showed you links straight to the relevant section below.

## Before you start

Work through these first — they resolve the majority of issues:

1. **Update to the latest version.** Re-download `GWToolbox.exe` from [gwtoolbox.com](https://gwtoolbox.com/) and run it. Old versions are not supported.
2. **Disable plugins and other mods** and test again. Toolbox will not write a crash dump while plugins are loaded.
3. **Launch Guild Wars in windowed mode**, not minimized or fullscreen, before starting Toolbox.
4. **Run as administrator** if Guild Wars itself is running as administrator (for example when started by a launcher).
5. **Avoid other programs that hook Guild Wars** at the same time (TexMod, uMod, multi-client launchers, screen/game overlays).

If you are still stuck after this, the cause is almost always security software — keep reading.

## Your browser blocked the download

Chromium-based browsers (Chrome, Edge, Brave, Opera, and others) increasingly block `GWToolbox.exe` **before it even finishes downloading**, showing a warning like *"This file isn't commonly downloaded"* or *"Failed – Virus detected"* with no obvious way to keep it. This is **Safe Browsing** reacting to an unsigned, infrequently-downloaded executable — the same false positive your antivirus makes — not a real threat.

If your browser will not let you keep the file, lower its Safe Browsing level, download, then turn it back up if you like:

1. Paste this into your browser's address bar and press Enter:
   - Chrome / Brave / Opera: `chrome://settings/security`
   - Edge: `edge://settings/privacy`
2. Find **Safe Browsing** (Edge calls it **Microsoft Defender SmartScreen**).
3. Switch it from **Enhanced protection** to **Standard protection**, or temporarily turn it **Off** / to **No protection**.
4. Re-download `GWToolbox.exe` from [gwtoolbox.com](https://gwtoolbox.com/).

You may still see a "keep anyway" prompt on the download — that one you *can* dismiss to keep the file. Once you have `GWToolbox.exe`, you can set Safe Browsing back to its previous level.

> **Note:** managed browsers (a work or school computer, or an enterprise antivirus that locks browser settings) can grey this out entirely. If so, download on a personal device, or ask whoever manages the machine to allow it.

## Antivirus exclusions

Toolbox has to inject into `Gw.exe` and read its memory, which looks like the behaviour antivirus software is built to stop — so antivirus (including Windows Defender) frequently flags it as a **false positive** and blocks it. The fix is to add an **exclusion** for your GWToolbox folder.

**Windows Defender (Windows Security):**

1. Open **Windows Security** (press Start, type *Windows Security*, press Enter).
2. Go to **Virus & threat protection**.
3. Under **Virus & threat protection settings**, click **Manage settings**.
4. Scroll to **Exclusions** and click **Add or remove exclusions**.
5. Click **Add an exclusion → Folder**.
6. Choose your GWToolbox folder: `%USERPROFILE%\Documents\GWToolboxpp`.

You can do the same in one step from PowerShell:

```powershell
Add-MpPreference -ExclusionPath ([Environment]::GetFolderPath('MyDocuments') + '\GWToolboxpp')
```

If you use a **third-party antivirus** (Avast, AVG, Bitdefender, Kaspersky, Malwarebytes, Norton, etc.), add the same folder — and ideally `Gw.exe` and `GWToolbox.exe` — to *its* exclusion/allow list. The wording differs per product, but every one of them has an "exclusions", "allow list", or "exceptions" screen.

After adding the exclusion, re-download `GWToolbox.exe` (your antivirus may already have quarantined it) and launch again.

## Controlled Folder Access

**Controlled Folder Access** is a Windows ransomware-protection feature. When it is on, it blocks programs it does not recognise from writing to protected folders — and your **Documents** folder is protected by default. Because Toolbox keeps its settings and crash dumps in `Documents\GWToolboxpp`, Controlled Folder Access can stop Toolbox from saving settings or **writing a crash dump**, and it can block reads in a way that looks like a crash.

An antivirus exclusion alone does **not** cover this — Controlled Folder Access is a separate setting, and you have to allow Guild Wars and Toolbox through it explicitly:

1. Open **Windows Security**.
2. Go to **Virus & threat protection**.
3. Under **Ransomware protection**, click **Manage ransomware protection**.
4. Make sure you can see **Controlled folder access**. If it is **On** and you want to keep it on, click **Allow an app through Controlled folder access**.
5. Click **Add an allowed app → Browse all apps**.
6. Add **`Gw.exe`** and **`GWToolbox.exe`**.

You can do the same from an **administrator** PowerShell window — allow both apps through Controlled Folder Access (replace the `Gw.exe` path with your own Guild Wars install), or turn the feature off entirely:

```powershell
# Allow Guild Wars and Toolbox to write to protected folders
Add-MpPreference -ControlledFolderAccessAllowedApplications 'C:\Path\To\Gw.exe'
Add-MpPreference -ControlledFolderAccessAllowedApplications ([Environment]::GetFolderPath('MyDocuments') + '\GWToolboxpp\GWToolbox.exe')

# ...or turn Controlled Folder Access off completely
Set-MpPreference -EnableControlledFolderAccess Disabled
```

If you do not rely on Controlled Folder Access, you can instead turn it **Off** on the same screen.

## Smart App Control

**Smart App Control** is a Windows 11 security feature that blocks apps it does not recognise as trusted — and because Toolbox is a small, frequently-updated tool that is not signed by a big publisher, Smart App Control will silently block `GWToolbox.exe` from running at all. If you have worked through the steps above and Toolbox still will not start, this is the likely cause.

1. Open **Windows Security**.
2. Go to **App & browser control**.
3. Under **Smart App Control**, click **Smart App Control settings**.
4. Set Smart App Control to **Off**.

> **Important:** Once you turn Smart App Control **off**, Windows will not let you turn it back on without **resetting or reinstalling Windows**. This is by design — only disable it if you are comfortable with that trade-off. (Smart App Control also has an "evaluation" mode that turns itself off automatically over time.)

After disabling it, re-download `GWToolbox.exe` from [gwtoolbox.com](https://gwtoolbox.com/) and launch again.

## Toolbox can't read Guild Wars' memory

If the launcher reports **"Couldn't find character name RVA"** or that it **found Guild Wars but couldn't read its memory**, security software is almost always blocking Toolbox from reading the `Gw.exe` process — not a Toolbox bug.

- Add an [antivirus exclusion](#antivirus-exclusions) for your GWToolbox folder, and allow `Gw.exe`/`GWToolbox.exe` if your antivirus has an app allow list.
- If you have [Controlled Folder Access](#controlled-folder-access) on, allow Guild Wars and Toolbox through it.
- Then re-launch. If it still fails *after* you have done both, and you are on the latest version, report it — at that point it may be a genuine signature break from a Guild Wars update.

If antivirus is intercepting the injection itself, excluding the two processes from scanning (in an **administrator** PowerShell window) can also help:

```powershell
Add-MpPreference -ExclusionProcess 'Gw.exe','GWToolbox.exe'
```

## Crash dump errors

When Guild Wars crashes, Toolbox tries to write a **crash dump** (`.dmp`) into `Documents\GWToolboxpp\<ComputerName>\crashes`. If a popup says Toolbox **couldn't find your Documents folder**, **couldn't create the crash file**, or that the dump **disappeared after being written**, something is blocking that folder:

- This is most often [Controlled Folder Access](#controlled-folder-access) protecting your Documents folder — allow Guild Wars and Toolbox through it.
- It can also be [antivirus](#antivirus-exclusions) quarantining the dump as it is written — add an exclusion for the GWToolbox folder.

The popup also shows the **original error** that caused the crash. If you report the issue, include that text (or a screenshot of the whole popup) so the team can see the root cause even when no dump file could be saved.

Once a dump is written, see the FAQ for [how to send a crash dump to the team](/docs/faq/#gwtoolbox-just-crashed-how-do-i-send-a-crash-dump-to-the-team).

## Blocked or quarantined files

If the launcher says a file such as `GWToolboxdll.dll`, `gwca.dll`, or `gMod.dll` **"did exist, but now it doesn't"**, or a plugin/texture mod fails to load, antivirus has quarantined or deleted that file:

- Add an [antivirus exclusion](#antivirus-exclusions) for the GWToolbox folder so the files are not removed again.
- Re-download `GWToolbox.exe` from [gwtoolbox.com](https://gwtoolbox.com/) and re-launch so the missing files are restored.

If Windows Defender quarantined the files, you can restore them from an **administrator** PowerShell window instead of re-downloading (add the exclusion above first, or they may be quarantined again):

```powershell
Restore-MpThreat
```

When Windows Defender blocks one of these files, recent Toolbox versions read the Defender event log and show you the exact block reason in the error popup — include that text when you ask for help.

## Cursor rendering issues (disappearing or corrupted cursor)

If your mouse cursor **disappears**, flickers, or renders incorrectly in-game, this is a known rendering issue tied to the **Guild Wars cursor size** option in Toolbox's cursor scaling feature — it only reliably renders at its default size.

1. Open the Toolbox settings and go to **Settings → Mouse Settings**.
2. Set **Guild Wars cursor size** back to its default of **32**, or click the **Reset** button next to it.
3. If the cursor is currently missing, right-click once in-game to make it reappear.

This is a workaround, not a fix — the underlying rendering bug with non-default cursor sizes is still open and being investigated.

## Missing images in Toolbox

If item, armor, skill, or map images show up **blank** in Toolbox — for example in the Armory, the skills list, or item tooltips — and Toolbox logs a message about not finding image data in `Gw.dat`, the cause is almost always an **incomplete local game install**, not a Toolbox bug.

Guild Wars can run from a partial `Gw.dat` and **stream** the rest of its data from ArenaNet's servers on demand as you play — the **Steam** release does this by default, so a fresh install only has the data you have actually seen in-game. Toolbox reads images straight from that `Gw.dat` on disk: whatever the game hasn't downloaded yet simply isn't there for Toolbox to load, which is why images you own or have seen appear while others stay blank.

The fix is to download **all** game data once, with the `-image` command-line option. Guild Wars will fetch the complete `Gw.dat` (several GB — it can take a while), after which every image is available to both the game and Toolbox.

**Steam:**

1. In your Steam **Library**, right-click **Guild Wars** and choose **Properties**.
2. On the **General** tab, find **Launch Options**.
3. Enter `-image` in the box.
4. **Launch** Guild Wars and leave it running until the download completes (there is a progress bar; it may take a long time on a slow connection).
5. Close Guild Wars, reopen **Properties → Launch Options**, and **remove** `-image` so it doesn't re-check every launch.

**Standalone client (`Gw.exe`):**

- Add `-image` to the end of your shortcut's **Target** (right-click the shortcut → **Properties**), e.g. `"C:\Path\To\Gw.exe" -image`, launch it, let it finish, then remove the `-image` again — or just run it once from a command prompt: `Gw.exe -image`.

Once the download has finished, restart Guild Wars (and Toolbox) and the images will load. If a specific image is *still* missing after a full `-image` download, that one may be genuinely absent from your client version — report it on the [Discord](https://discord.gg/ZpKzer4dK9).

## Still stuck?

If you have worked through the sections above and Toolbox still will not run:

- Note the **exact** error message (a screenshot is ideal).
- Confirm your **Toolbox version** and that you re-downloaded the latest `GWToolbox.exe`.
- Describe what you were doing when it happened, and whether any other game tools/overlays were running.

Then ask on the [Discord](https://discord.gg/ZpKzer4dK9) or open an issue on the [bug tracker](https://github.com/gwdevhub/GWToolboxpp/issues). See also the [FAQ](/docs/faq/) for more specific situations.

---

# Launcher Command-Line Arguments

Source: https://www.gwtoolbox.com/docs/launch_options/

`GWToolbox.exe` is the small launcher that installs, updates, and injects the Toolbox DLL into a running copy of Guild Wars. It accepts a handful of command-line arguments, which are useful when scripting startup, running from a third-party launcher, or working with a local build.

You can pass these by editing your shortcut's **Target** field, calling the exe from a batch/PowerShell script, or running it from a terminal. On Linux/Wine, append them after the exe path in your `wine start` command.

## Arguments

| Argument | Effect |
| --- | --- |
| `/?`, `/help` | Print the list of arguments and exit. |
| `/version` | Print the launcher version and exit. |
| `/quiet` | Run without any user interaction — no prompts or dialogs. Useful for scripted/silent launches. |
| `/install` | Create the necessary folders and download `GWToolboxdll.dll`, then exit. |
| `/uninstall` | Remove all data used by GWToolbox, then exit. |
| `/reinstall` | Do a fresh installation (uninstall, then install), then exit. |
| `/asadmin` | Relaunch as administrator if not already elevated. |
| `/noupdate` | Don't check for or download an updated DLL on launch. |
| `/noexecheck` | Don't check GitHub for a newer `GWToolbox.exe`. |
| `/noinstall` | Don't offer to install the DLL if it's missing. |
| `/localdll` | Inject the `GWToolboxdll.dll` sitting next to `GWToolbox.exe` instead of the installed copy. Implies `/noupdate` and `/noinstall`. |
| `/pid <process id>` | Inject into the Guild Wars process with the given PID instead of searching for one. |

## Notes

- `/install`, `/uninstall`, and `/reinstall` are mutually exclusive — pass at most one.
- `/quiet` requires Toolbox to already be installed; it will error out rather than prompt you to install.
- `/localdll` is mainly for developers running a local build — it loads the DLL from the launcher's own directory and skips updating and installing entirely.

## Examples

Launch silently using a locally-built DLL, without updating or installing:

```text
GWToolbox.exe /noupdate /noinstall /quiet /localdll
```

Run without ever checking for updates (e.g. to stay on a specific release):

```text
GWToolbox.exe /noupdate
```

> **Note:** `/noupdate` only stops the *launcher* from updating the DLL at startup. The Toolbox DLL has its own update setting (Toolbox **Settings → Updater → Update mode**) which may be set to check for and apply updates on its own. To stay on a specific release, also set that to **Do not check for updates**.

Inject into a specific Guild Wars process:

```text
GWToolbox.exe /pid 12345
```

---

# Linux Install Guide

Source: https://www.gwtoolbox.com/docs/linux/

> **GWToolbox++ does not officially support Linux or any non-Windows host.** Guild Wars itself runs well on Linux through Wine, and Toolbox can run alongside it, so this guide is provided purely as a convenience for anyone who wants to give it a go. Running outside Windows is unsupported and offered as-is — please don't expect help through the usual support channels if something here doesn't work.

GWToolbox++ is a Windows DLL. The walkthrough below is a short summary — for the full, authoritative reference (including troubleshooting, performance tuning, optional DXVK setup, sound, DirectSong, and more) please use the excellent guide maintained by [**ChthonVII**](https://github.com/ChthonVII): [guildwarslinuxinstallguide](https://github.com/ChthonVII/guildwarslinuxinstallguide).

If you hit anything that isn't covered here, that guide is the place to look first.

## Pick the right Wine

Toolbox needs Wine's process-injection features to load the DLL. Which build you want depends on your kernel:

- **Kernel ≥ 6.14** with a stock distro kernel — official **WineHQ** packages (`wine`, `wine-devel`, or `wine-staging`) work out of the box.
- **Kernel ≥ 6.14** with custom/backport kernels — a **TkG** build (e.g. [Kron4ek/Wine-Builds](https://github.com/Kron4ek/Wine-Builds)) with **NTSYNC** enabled.
- **Kernel < 6.14** — TkG/custom builds with **FSYNC** or **ESYNC**, or an older Wine (pre-10.16).
- **Avoid** running Guild Wars through **Steam Proton** or **Lutris**. They sandbox the wine prefix in ways that make installing Toolbox (and DirectSong) more painful than it needs to be.

## Install 32-bit support

Guild Wars is a 32-bit game. Either:

- Add multi-arch packages — on Debian/Ubuntu: `sudo dpkg --add-architecture i386 && sudo apt update`, then install the 32-bit graphics driver libraries that match your GPU (e.g. `libglx-mesa0:i386`, `mesa-vulkan-drivers:i386`, `libgl1-mesa-dri:i386` for AMD/Intel; `nvidia-driver-libs:i386` for nVidia), or
- Use Wine ≥ 10.2 with `WINEARCH=wow64` to skip the 32-bit packages entirely. (Note: see the pitfall section below.)

Optional but recommended: `gstreamer1.0-libav:i386` (and the equivalent 32-bit gstreamer plugins for your distro) for in-game audio.

## Install Guild Wars

Pick a dedicated wine prefix so Guild Wars doesn't share state with anything else:

```bash
export WINEARCH=win64        # or 'win32' on older wine
export WINEPREFIX="$HOME/.wine-gw"
winecfg                      # creates the prefix, lets you set Win 10 mode

mkdir -p "$WINEPREFIX/drive_c/temp"
# download the official installer (GwSetup.exe) into the temp dir, then:
wine start /d "C:\\temp" "C:\\temp\\GwSetup.exe"

# launch Guild Wars once to confirm it works
wine start /d "C:\\Program Files (x86)\\Guild Wars" \
              "C:\\Program Files (x86)\\Guild Wars\\Gw.exe"
```

## Install GWToolbox++

1. [Download the launcher](https://github.com/gwdevhub/GWToolboxpp/releases/latest) and run it inside the same prefix — it auto-downloads `GWToolboxdll.dll` into `~/Documents/GWToolboxpp/`.
2. **Launching Toolbox** — pick one of:
   - **Launcher UI** — run `GWToolbox.exe` before or after starting Guild Wars; it finds the running `Gw.exe` and injects the DLL.
   - **Silent injection** (recommended for scripts/launchers):
     ```bash
     wine start /d "C:\\Program Files (x86)\\GWToolbox" \
                   "C:\\Program Files (x86)\\GWToolbox\\GWToolbox.exe" /quiet
     ```
   - **Generic injector** — e.g. `Injectory`, useful if you don't want the launcher running at all:
     ```bash
     injectory.x86.exe -l Gw.exe -i GWToolboxdll.dll
     ```

## Common pitfalls

- **`wow64` mode + injection** — under `WINEARCH=wow64`, injecting into a running Guild Wars sometimes crashes the process. Workarounds: install the 32-bit driver libraries instead, or use the launcher's pre-launch path so the DLL is in place before Guild Wars finishes loading.
- **FPS-related teleporting** — frame rates well above ~144 fps can cause characters and NPCs to "teleport" briefly. Cap the frame rate with the in-game `-fps` flag (e.g. `Gw.exe -fps 144`) or via Toolbox's `/fps 144` command.
- **Don't run through Steam** — see the "Avoid" note above. If you've already installed under Proton, the simplest fix is to set up a fresh standalone wine prefix and re-install there.
- **Performance** — install [**DXVK**](https://github.com/doitsujin/dxvk) into the prefix for a big DirectX 9 performance jump, and make sure your Wine build is using NTSYNC/FSYNC/ESYNC. ChthonVII's guide covers both in detail.

---

*This page is a short summary written to live in the GWToolbox docs. The authoritative reference is **ChthonVII**'s [guildwarslinuxinstallguide](https://github.com/ChthonVII/guildwarslinuxinstallguide) — please consult it for anything not covered above, and consider starring the repo if it helped you.*

---

# Anonymous Analytics

Source: https://www.gwtoolbox.com/docs/analytics/

GWToolbox++ can send anonymous gameplay data to third-party services to help improve those services for the Guild Wars community. This is **opt-in by default via the "Send anonymous gameplay stats" checkbox** in [Settings](/docs/settings/#toolbox-settings) and can be disabled at any time.

No account name or IP address is ever included in these transmissions. Some transmissions include character names or an account UUID as described below.

## Opting out

Open **Settings → Toolbox Settings** and uncheck **Send anonymous gameplay stats**. All analytics transmissions described below will stop immediately.

## Data sent and when

### gwmarket.net — purchase analytics

**When it happens:** You click the **Whisper** button on a listing in the [Market Browser](/docs/market_browser/) and then send a whisper to that same player within 60 seconds.

**What is sent:** A single HTTP POST to `https://gwmarket.net/api/shop/purchase/` containing:

| Field | Value |
|-------|-------|
| `name` | Item name (e.g. `"Glob of Ectoplasm"`) |
| `orderType` | `0` for a sell order, `1` for a buy order |
| `price.type` | Currency: `0` = Platinum, `1` = Ecto, `2` = Zkeys, `3` = Arms |
| `price.price` | Quoted price |
| `price.quantity` | Quoted quantity |

**Why it is useful:** gwmarket.net uses this to track which listings result in completed trades, helping it surface more accurate pricing data for the community.

### party.gwtoolbox.com — outpost party information

**When it happens:** While you are in an outpost, Toolbox periodically sends party search listings visible to you (and parties of nearby players) to party.gwtoolbox.com via a WebSocket connection.

**What is sent:**

The WebSocket connection headers include your **account UUID** (`X-Account-Uuid`) and the current Toolbox version as an API key. Your account UUID is a persistent identifier derived from your Guild Wars account; it is not your account name or email address.

Each party listing payload contains:

| Field | Value |
|-------|-------|
| `s` | **Character name** of the party leader |
| `ms` | Party search message (the text the player typed) |
| `t` | Search type (hunting, mission, quest, trade, guild) |
| `p` / `sc` | Primary and secondary profession |
| `ps` | Party size (omitted if 1) |
| `hc` | Hero count |
| `hm` | Hard mode flag |
| `dl` / `dn` | District language and number |
| `l` | Level (omitted if 20) |
| `map_id` | Current map (outpost) |
| `district_region` | Server region |

Character names sent here are the same names publicly visible to all players in the outpost via the in-game party search panel.

**Why it is useful:** This powers the cross-client "party search" feature so players can find groups in the same outpost.

---

# Privacy Policy

Source: https://www.gwtoolbox.com/docs/privacy/

GWToolbox++ is free, open-source software that runs locally on your computer. It does not require an account, and it does not collect personal information such as your name, email address, or IP address. This page explains the limited data the software does send, when it is sent, and how to turn it off.

## What we do not collect

- No account name, email address, or password.
- No IP address logging by GWToolbox++.
- No advertising or third-party tracking.
- The GWToolbox++ website (gwtoolbox.com) uses no analytics, cookies, or tracking scripts.

## Anonymous gameplay data (opt-in toggle)

GWToolbox++ can send **anonymous gameplay data** to third-party services to power community features. This is controlled by the **"Send anonymous gameplay stats"** checkbox in **Settings → Toolbox Settings** and can be disabled at any time, which stops all such transmissions immediately.

No account name or IP address is ever included. Some transmissions include character names (which are already publicly visible in-game) or a persistent **account UUID** that is derived from your Guild Wars account and cannot be reversed into your account name or email.

The two services involved are:

- **gwmarket.net** — when you whisper a seller/buyer from the Market Browser, an anonymous record of the item, price, and order type is sent so the service can track completed trades.
- **party.gwtoolbox.com** — while you are in an outpost, the party-search listings already visible to you are relayed so other players can find groups across clients.

A full field-by-field breakdown of exactly what is sent, and when, is on the [Anonymous Analytics](/docs/analytics/) page.

## Update checks

The launcher and the Toolbox DLL contact GitHub's public release API to check for and download updates. These are ordinary web requests to GitHub; GitHub may log them under [its own privacy policy](https://docs.github.com/en/site-policy/privacy-policies/github-general-privacy-statement). GWToolbox++ sends no additional data with these requests.

## Crash dumps

When GWToolbox++ crashes it may write a crash dump file to your local `Documents\GWToolboxpp` folder. These files stay on your computer and are **not** uploaded automatically. You may choose to share one with the developers (for example, on Discord or GitHub) when reporting a bug.

## Contact

Questions about this policy can be raised on our [GitHub issue tracker](https://github.com/gwdevhub/GWToolboxpp/issues) or [Discord](https://discord.gg/pGS5pFn).

---

# Version History

Source: https://www.gwtoolbox.com/docs/history/

Previous releases are available on Github as dll files. There is no support for older releases. If you are looking for
the latest version, go to the [Home Page](./) instead.

## Version 8.33
* [New] Cartographer widget: helps you finish the Cartographer titles. It shades the parts of the world map you still have to uncover, and — using the game's own cartography rules — marks the exact squares you need to *stand in* to clear them, rather than just the fog itself. Reachability is derived from real pathing (travel portals count as walls, so it won't suggest a square you can only reach by zoning), the whole continent is shown rather than just your current map, and hovering a fog patch names the map you have to travel to in order to uncover it. Squares you can get close to but still can't uncover are drawn in grey.
* [New] Armory: 830 additional weapon models, found by scanning `Gw.dat`, are now available to preview. **NOTE: There are loads of unnamed weapons/items now - not all of them are actually weapons, and might be in the wrong place, but I've left them in so the community can help label them/filter them for us**
* [New] Splash Screen module: replaces the Guild Wars startup splash artwork with an image of your own.
* [New] Game Settings: separate name colours for Friends, Guild Members and Other Players (In My Party), on top of the existing name colouring.
* [New] Toolbox is no longer disabled in guild halls. It remains disabled in PvP maps.
* [New] World map: elite skill capture icons can now have profession-coloured borders, using the profession colours configured in Minimap settings. The option is enabled by default, and the icon tooltip also shows the profession icon.
* [Minor] Nicholas item counts are now the total needed for all 5 trades everywhere, instead of Nicholas the Traveler showing the total while Nicholas Sandford showed the amount for a single trade. Sandford item tooltips now read "collects 25 of these" rather than 5, and the Daily Quests window counters for both Nicholases count towards a full set of gifts (and turn green once you have it).
* [New] Loot Beacons: beacon drops by name. Add your own list of text/colour pairs — any drop whose name contains the text gets a beacon in that colour, whatever its rarity or trader value, so things like scrolls, dyes or a specific green can be picked out at a glance. Name rules are checked before the value and rarity rules, and the first matching rule wins.
* [Fix] `/dialog` (including `/dialog take` and `/dialog 0`) works again. A Guild Wars update stopped Toolbox from noticing when a conversation window closed, so the command still believed you were talking to the previous NPC: it would no longer start a conversation with your current target, and queued steps — such as taking a quest and then accepting its reward — stalled for a few seconds and were dropped instead of being sent. Conversations that the game ends part-way through a sequence are also reopened again.
* [Fix] Minimap: Custom Agents size edits now apply to other party members/players — previously the per-allegiance sizes (Ally, Neutral, Ally (NPC), Ally (Spirit/Pet), Ally (Minion)) set in the Custom Agents list had no effect on players, who always fell through to a legacy field that could no longer be changed from the UI.
* [Fix] Loot Beacons: each beacon now always matches the colour of the item's name tag, and the per-rarity colour pickers have been removed — the rarity colours were also realigned to the game's own item palette so beacons read the same as the drop text.
* [Fix] Salvage: items the game has no salvage formula for — such as Stalker's Ration and other bundle-style items — are no longer treated as salvageable, so "Salvage All" stops queueing them up. Previously only one hard-coded formula was excluded, which let these items through: the kit would pause on them and then report a salvage failure for that slot.
* [Fix] Title Tracker: the old, no-longer-obtainable versions of the Treasure Hunter and Wisdom title tracks (and the pre-hard-mode Skill Hunter) no longer appear in the widget's title list or the `/title` command.
* [Fix] Trader window: the per-order "Whisper" buttons no longer share a click target when order descriptions are blank, so whispering a specific seller works reliably.
* [Fix] Price Checker: rune and insignia tooltips while in pre-searing now show pre-searing prices, sourced from presearing.com's community price sheet, instead of the unrelated post-searing Kamadan Trading Post price for the same item.
* [Minor] Bonds: the refrain checkboxes in the bond monitor's settings (Heroic, Burning, Mending, Bladeturn, Hasty and Aggressive Refrain) now have a help tooltip explaining that refrains can only be shown on yourself and your own heroes — Guild Wars doesn't tell your client about refrains you maintain on other players, so they can't be displayed.
* [Minor] Filters you type by hand now accept a regular expression anywhere: wrap the line in slashes, e.g. `/(wtb|wts).*ecto/`. This works in the chat filter's keyword and author lists, trade and party-search alert keywords, the trade window's search box and the new loot beacon name rules; flags go after the closing slash, and matching is case-insensitive unless you add `I` — the chat filter's dedicated regex list keeps its existing case-sensitive default. Filters written as plain text behave exactly as before.
* [Fix] Quest paths: the leading segment of the path is now re-anchored to your position every frame, and recalculating a quest or marker path no longer routes you back through a waypoint you already passed.
* [Fix] In-world overlays (quest paths, rings, beacons) are lifted slightly off the ground, so they no longer flicker against the terrain they are draped on.
* [Fix] Mission map: "Draw all minimap lines" no longer overrides the individual Toolbox line toggles.
* [Fix] Mouse fix: a bitmap was leaked on every cursor change, which could eventually degrade or break cursor rendering. A workaround for the symptom has also been added to [Troubleshooting](/docs/troubleshooting/).
* [Fix] Game Settings: "Remember my online status" is honoured again, and the legacy Enter Mission button is restored when the party leader changes.
* [Fix] Completion window: map-specific checks now resolve the map info for the map being asked about instead of the map you are standing in, and title progress can be checked against your primary profession only.
* [Fix] Text to Speech: the API key field is wide enough to see what you pasted, and both the key and user id accept longer values without being truncated.
* [Fix] Crash handler: C runtime failures are now routed through the crash handler, and dumps triggered by Guild Wars itself record the real exception code instead of a placeholder. Additional safety checks were added around `/rr`, quest removal, the party window and in-game-thread ImGui access, from reported crash dumps.
* [Perf] Large in-world overlays are substantially cheaper: navmesh point location is indexed instead of scanned, and path re-anchoring is throttled.
* [Perf] The Objective Timer no longer saves and restores the full Direct3D state every frame while idle, which was a significant framerate cost in dungeons and missions.
* [Perf] The Friend List, the Settings window's section lists, ImGui's window clamping and a number of hot container lookups no longer redo their work every frame.
* [Minor] Weather: automatic weather is now off by default (the module is still available and can be enabled), and climate chances are shown as percentages.
* [Minor] Settings search: only settings the Settings window actually draws are offered, and the pet/hero auto-flag entry's search label matches its checkbox.
* [Minor] Alcohol widget: recognises Juniberry Gin, Vabbian Wine and Zehtuka's Jug, and no longer counts Battle Isle Iced Tea as alcohol.
* [Minor] Launcher: the Linux guide URL in the error dialog is clickable, the Defender failure dialog has a "don't ask again" checkbox, and the star request dialog has an "I've already starred" option.
* [Minor] The [Flag Hero hotkey](/docs/hotkeys/#flag-hero) is properly documented: its Degree/Distance/Hero fields, the fact that the angle is measured from the line between you and your target when you have one (and from your facing direction otherwise), that pressing the hotkey again unflags, and how to build hero formations out of a handful of them.

## Version 8.32
* [Perf] In-world overlays that drape on the ground — quest paths, Skill Range Rings, Loot Beacons, Danger Rings and Weather — now read the terrain height straight from the game's heightfield instead of asking the game to recalculate it once per vertex every frame. Large overlays that used to drag the framerate down are now a fraction of the cost.
* [Fix] Skill Range Rings: fixed severe FPS drops while hovering a skill. The rings were re-projected onto the terrain every frame; the draped geometry is now cached and only recomputed when you or your target moves, so inspecting a skill's range no longer tanks the framerate.
* [Fix] Guild Wars no longer crashes when you exit the game with Toolbox loaded.
* [Fix] Quest paths (both custom markers and quest markers) no longer sometimes fail to appear after changing maps — previously this could require a Toolbox restart to recover.
* [Fix] World map: quest markers and other icons no longer show up as blank white squares when Toolbox is injected before Guild Wars has finished opening its data file.
* [Fix] Account Inventory: reduced the delay when loading into the game with the module enabled. Item icons are now loaded from `Gw.dat` on demand as they are displayed, rather than decoding an icon for every stored item on every map load — which flooded Toolbox's texture-loading threads and stalled load-in.
* [Fix] Domain of Anguish: quest pathing now rebuilds its navigation mesh when moving between the outpost and the explorable area, so paths are correct in both.
* [Fix] In-world overlays now draw correctly beneath the in-game interface.
* [Fix] Fixed a crash and cloth/hair physics glitches that could occur when a rotating 3D character model was on screen (such as the hero or character-select panel) with in-world overlays enabled.
* [Fix] Mission map: overlays no longer lag behind the map while you drag it.
* [Fix] Objective Timer: added the Forsaken Tunnels dungeon, fixed the Cathedral of Flames level list, and corrected dungeon level numbering (levels now count from 1 instead of 0).
* [Fix] Added extra safety checks to prevent occasional crashes across the enemy, party statistics and target info windows and in skill handling.
* [Minor] Weather: Sandstorm now only appears automatically in true desert climates (Crystal Desert, Desolation, Istan) instead of all arid regions, and is disabled by default like Fog since it heavily obscures vision.
* [Minor] Pathfinding settings are now found by the settings window's search box.
* [Minor] Launcher: warns when Guild Wars is running under ARM/CPU emulation (e.g. an Apple Silicon or ARM Windows machine), which is unsupported and known to crash texture-pack hooking.
* [Minor] Launcher: the update changelog now shows line breaks correctly instead of stray box characters.
* [Minor] Save and open file dialogs now pre-fill the suggested file name.

## Version 8.31
* [New] Danger Rings: draws enemy ground AoE effects (Meteor Shower, Maelstrom, traps, and more) as rings on the ground in the 3D game world — depth-tested against the terrain and drawn under the interface. Ring thickness, fill/rim opacity and whether rings are hidden behind terrain are configurable.
* [New] Loot Beacons: marks dropped loot worth grabbing with a pillar of light in the game world, selectable by item rarity (white/blue/purple/gold/green) and/or trader value, with an option to also beacon items reserved for other party members.
* [New] Skill Range Rings: hover any skill (skillbar, skills window, template previews) to see its ranges drawn on the ground — cast/use range around you, the AoE radius around your target or yourself, earshot for shouts and chants, and spirit/constant-effect range.
* [New] When an item icon isn't present in your local `Gw.dat` — common on the Steam release, which downloads game data on demand — the Armory now shows a warning and explains the fix: launch Guild Wars once with the `-image` command line option to download all game data. A new [Troubleshooting](/docs/troubleshooting/#missing-images-in-toolbox) section walks through the setup for Steam and standalone installs.
* [New] Mission Map: minimap overlays can now be drawn directly on the in-game mission map frame — toggle "Show minimap on mission map" in Mission Map settings, then individually enable agents, range rings, pings, AoE effects, background, terrain pmap and symbols. All layers default off.
* [New] Mission Map: new "Show walkable terrain" overlay shades walkable vs non-walkable terrain on the mission map, independent of the vanquish overlay, with configurable fill and border colours.
* [New] Quest paths can now be drawn on the 3D game terrain — draped along the ground at correct heights including bridges and steps — in addition to the minimap and world map. Quest paths are also drawn on the in-game mission map by default. Both are configurable in Quest module settings.
* [New] Armory: right-clicking any armor or weapon piece now opens a context menu with "Copy chat command" (copies the `/armory` command with current dye slots to clipboard) and "Guild Wars Wiki" to look up the piece.
* [New] Minimap: added "Show props on minimap" option in minimap settings to display map objects (barrels, containers, environment props) as dots on the minimap.
* [New] Game Settings: added options to disable the camera's built-in mouse-movement smoothing and controller-movement smoothing independently, for snappier camera response.
* [New] Game Settings: added option to suppress the sparkle/glow particle effect that plays on newly dropped items.
* [New] Game Settings: added options to block the full-screen popup shown when completing a vanquish and when opening a dungeon chest.
* [New] Audio Settings: added "Blocked In-Game Sounds" section to permanently mute specific audio files from playing in-game; an optional "In-Game Sound Log" records every sound as it plays so you can identify files to block.
* [New] Launcher: the character-selection window now checks for exe and dll updates in the background and shows status inline with an Update button, so updates can be applied without closing the dialog.
* [Fix] Fixed occasional crashing.
* [Fix] Fixed layout bugs with the party window position module.
* [Fix] Camera unlock: fixed a vanilla Guild Wars hang when dying while in first-person camera mode (camera unlock active) and then resurrecting — a NaN camera pitch left by the death-orbit transition caused the game's terrain ray-march to loop forever, hanging the render thread until you died again.
* [Minor] Launcher: Windows Defender exclusion prompt now includes a "don't ask again for this version" option, suppressing repeat nags on the same build.
* [Minor] Launcher: the launch window now uses per-monitor DPI awareness for correct layout on HiDPI and 4K displays.

## Version 8.30
* [New] Item icons are now shown in the item's applied dye colour — including combined multi-dye colours — wherever Toolbox draws an item icon, such as the item info window and the Armory piece previews.
* [Fix] Item and skill icons now load directly from the game's `Gw.dat` file, so they keep working across Guild Wars updates that shift the game's memory (which broke the previous method).
* [Fix] Fixed a crash when opening a skill trainer — the merchant "hold Ctrl for a bulk quote" hint mistook the trainer window for a merchant window and read the wrong field.
* [Fix] Fixed a crash when using `/chest` or `/xunlai` to close the Xunlai storage window.
* [Fix] The hero command panel position-memory option added in 8.29 is temporarily disabled — it caused UI drawing glitches and could crash.
* [Fix] Launcher now verifies Windows Defender folder permissions before injecting, so a blocked injection is caught up front with a clear prompt instead of failing quietly.
* [Fix] Toolbox now resolves your Documents folder correctly when Windows Defender Controlled Folder Access is enabled, so settings and crash dumps save to the right place.

## Version 8.29
* **[New] Weather module: draws weather — rain, snow, ash, fog and overhead clouds — into the 3D game world, occluded by terrain and able to dim the scene with an overcast. Ships with presets (Heavy/Light Rain, Snow, Ashfall, Fog, Sandstorm, Blizzard) and lets you author your own. Optional automatic weather picks conditions from the climate of the region you're in; the new `/weather` and `/climate` chat commands control it.**
* [New] Skills: added an "Export HD skill icons as DDS" button to save high-resolution skill icons to image files.
* [New] Launcher: can now allow GWToolbox.exe and Guild Wars through Windows Defender Controlled Folder Access during install, so Toolbox can still write settings and crash dumps to your Documents folder when ransomware protection is on.
* [New] Chat: added `/dropitem <model_id> [quantity]` to drop inventory items matching a model id, stack by stack — drops up to the given quantity, or every matching stack when no quantity is given. Only works in an explorable area and skips equipped/customized items.
* [New] Hero command panel: you can now choose whether remembered panel positions track the party slot (new default) or follow a specific hero, via a radio in Party Settings.
* [New] Defender detection now extends to gMod and plugin load failures — if Windows Defender blocks one from loading, you get an exclusion prompt instead of a silent failure.
* [Fix] Launcher: the "Couldn't find character name RVA" error is no longer shown when anti-virus / Controlled Folder Access blocks Toolbox from reading the Guild Wars process. You now get a clear anti-virus message pointing at the real cause instead of being told to update the launcher.
* [Fix] Launcher: re-downloading GWToolbox.exe from the website now also updates the installed copy used by desktop shortcuts, so a stale exe is properly replaced.
* [Fix] Launcher: self-update now verifies the new GWToolbox.exe actually landed (and wasn't silently restored or quarantined by anti-virus) instead of re-prompting to update on every launch.
* [Fix] Health widget: the absolute HP readout now uses the agent's own max HP, so it shows a value immediately instead of "-" until a party member damages or heals the target.
* [Fix] Mission map: fixed a crash when the minimap overlay drew while the Minimap module was turned off; mission-map options that require the Minimap are now disabled (with a tooltip) while it's off.
* [Fix] Game Settings: the "hide window buttons" option now applies in every non-windowed mode, not only borderless and fullscreen.
* [Fix] Settings migration: custom minimap agent colours and your friend list now carry across correctly when upgrading from the old `.ini` settings.
* [Minor] World map: shows a "Calculating path…" indicator while a cross-map route is still being calculated.
* [Minor] Release builds are now code-signed, which should reduce false antivirus warnings over the long run.
* [Minor] Launcher dialogs now show the launcher version in their title bar.
* [Minor] Crash-file write failures now report the actual cause (missing folder, full disk, permissions) instead of only a raw error code.
* [Minor] Plugins: plugin-load error messages now display non-ASCII (e.g. Korean) file paths correctly.
* [Minor] Docs site: headings now have hover-to-copy permalink anchors.
* [Fix] Quest paths now follow raised ground correctly — bridges, monuments, steps and similar props — instead of cutting straight through them at floor height.
* [Fix] Navmesh overlay: fixed phantom walls drawn across flat, walkable seams where two map layers meet, and overlay edges now sit on the terrain (steps included) at their true height.
* [New] Navmesh overlay: added a "Terrain sample spacing" setting controlling how closely the overlay hugs the floor (lower = tighter detail).
* **[Perf] Quest pathing is much faster now — try turning "Path recalc distance" (Pathfinding settings) down for a near-instant quest path that keeps up as you move. New installs default to 5.**

## Version 8.28
* [New] Launcher: GWToolbox.exe now updates itself from GitHub (separately from the DLL) and offers to restart into the new version once the download finishes.
* [New] Launcher: failed injections are now diagnosed — you get a clear Windows Defender / anti-virus prompt (with the folder to exclude) instead of a generic crash, and Wine/Proton/Lutris details are reported when launching on Linux.
* [New] Toolbox now detects when anti-virus quarantines its components at load time and shows an exclusion prompt instead of crashing.
* [Fix] Fixed compatibility with the latest Guild Wars update.
* [Fix] Texture packs (gMod/uMod/Texmod) are no longer lost on restart when stored in the new JSON settings.
* [Minor] Docs site: the search box is now focused automatically when you open it, and the Linux page notes that non-Windows hosts are unsupported.

## Version 8.27
* [New] Chat: added a block list to hide messages from specific players by name (Chat Settings → "Hide any messages from these players").
* [New] Minimap: opened and closed locked chests now have separate colour and size settings.
* [New] Game Settings: added an option to hide the window buttons (minimise/restore/close) in borderless and fullscreen modes.
* [Fix] Multi-map pathing now routes to the nearest map break, and portal/pathing diagnostic messages no longer appear in chat.
* [Fix] Multi-map pathing no longer fails when the portal connection data isn't sitting next to the DLL — the data is now bundled inside Toolbox.
* [Fix] Party damage monitor no longer shows a "0" for members who haven't dealt damage or healing.

## Version 8.26
* [New] Multi-map pathfinding — quest paths now route across map boundaries. The path to a quest in another area is drawn on the world map and continues seamlessly once you zone in.
* [New] Added Backup module to archive and restore your Toolbox settings.
* [New] Added a feature to combine the floating damage/heal numbers that stack over an agent's head, to reduce on-screen noise (toggle in Game Settings).
* [New] World map: added campaign filter buttons above the profession buttons.
* [New] Minimap: added a setting to target gadgets (chests, levers, etc.) when clicking the minimap.
* [New] Minimap: hero flag circle colour and thickness are now customisable.
* [New] Minimap layers (markers and lines) now render on the in-game mission map frame.
* [New] Hero command panel positions are now remembered and restored on map load.
* [New] `/target` now supports `|` as an OR separator to match any of several search terms.
* [New] Added `/pref resolution` chat command.
* [Fix] Fixed compatibility with the latest Guild Wars update.
* [Fix] Fixed salvage confirmation not being auto-accepted after the recent gw update; salvage-all flows work again.
* [Fix] Fixed various quest pathing bugs — quest paths now recalculate when you change quest in the log, route to the destination map's marker when it points off the current map, and back off cleanly when a marker is unreachable instead of retrying every frame.
* [Fix] Custom quest markers are now plotted at their exact world-map position.
* [Fix] Fixed quest path corruption when routes were built concurrently.
* [Fix] Fixed slider-related `/pref` settings not working, e.g. `/volume`.
* [Fix] Fixed a bug preventing targeting of valid agents near an opened locked chest.
* [Fix] Fixed a bug preventing some module settings from showing in the Toolbox settings window.
* [Fix] Fixed some UI elements being drawn twice.
* [Fix] Texmod module no longer shows an error when no texmods are selected.
* [Fix] Fixed a crash/freeze and other bugs in chat command handling after the move to shared encoded-string pointers.
* [Minor] Settings files are now stored as `.json` in the `configs` folder. Existing `.ini` settings are migrated automatically; the migration path stays in place until 9.0.
* [Minor] `/pref` name matching is now more forgiving and gives a clearer error on an unknown name.
* [Minor] `/target` accumulates pending searches across hotkeys triggered in quick succession.
* [Minor] Performance improvements to pathfinding — skips redundant DAT re-reads, and bounds memory with an LRU cache and lazily-built visibility graphs.
* [Minor] Minimap custom-line buffer rebuilds are throttled to reduce CPU use.
* [Minor] Vanquish overlay map grid is now rebuilt on a worker thread to avoid frame hitches.
* [Minor] Hero Builds: the load button is disabled when the party is full and the hero isn't already in the party.
* [Minor] Added Tunnels of the Forsaken to the Objective Timer window.
* [Minor] Performance window can now stream per-second timings to a CSV file (opt-in).
* [Minor] Enforced a minimum interval between quote requests in the Materials window to avoid spamming the trader.
* [Minor] Added anonymous gwmarket purchase analytics when whispering a seller/buyer (see the Anonymous Analytics docs page for what is sent).

## Version 8.25
* [Minor] The texmod module now works with pre-loaded instances of gMod

## Version 8.24
* [Fix] Fixed an imgui bug causing some elements to be duplicated

## Version 8.23
* [Fix] Various bug fixes
* [New] Added texmod module to load texmods without needing to pre-launch umod/texmod/gmod

## Version 8.22
* [Fix] Fixed a crash when trying to bulk sell items

## Version 8.21
* [Fix] Fixed a crash when trying to custom sort party members

## Version 8.20
* [Fix] Fixes for gw 38618

## Version 8.19
* [Fix] Fixed hotkey groups not being saved/loaded correctly to ini.
* [Minor] Entire hotkey groups can now be triggered the same way normal hotkeys can, so you can activate more than one hotkey at a time.
* [Fix] Fixed hero panels popping up on map travel due to gw's async settings saving mechanism

## Version 8.18

* [New] Added `/tb save [profile]` and `/tb load [profile]` chat commands to save/load Toolbox settings to disk with optional profile names
* [New] Vanquish map overlay now detects and visualises unreachable areas (blocked gates, impassable terrain) using BFS pathfinding — distinct colours distinguish blocked vs reachable areas
* [New] Daily Quests window: added toggle to show pre-searing dailies while in post-searing (and vice versa, including Vanguard Quest and Nicholas Sandford)
* [New] Travel window: added option to show/hide the Zaishen daily quest buttons
* [New] Travel window: custom destination buttons — add, remove and reorder your own travel destinations directly from the Travel window settings
* [New] Travel window: improved nearest outpost algorithm using the full map adjacency graph via BFS for smarter outpost selection
* [New] Hero Builds window: added checkbox to filter builds to only show those matching your primary profession
* [New] Minimap: per-agent-type size controls for hostile, neutral, ally, ally NPC, ally NPC with quest marker, and ally spirit agents
* [New] Minimap: profession-based colour customisation for agents on the minimap
* [New] Game Settings: added option to prevent dervish avatar elites from changing your character's appearance
* [New] Title Tracker widget: hover tooltip now shows current rank number, next tier name and point requirement
* [New] Added `/resignlog pending` (or `/resignlog notresigned`) to filter the resign log to players who haven't resigned yet
* [New] Added settings cog button to Toolbox window title bars for quick access to that window's settings (can be disabled in Toolbox Settings)
* [New] Armory window: added many new weapon and offhand item model IDs (axes, bows, daggers, hammers, shields, scythes, focus items)
* [New] Added Bounty Kill Tracker widget — overlays a kill counter on active bounty effect icons, similar to the vanquish counter on the Hard Mode effect icon
* [New] Pcons window: optional enabled/disabled status indicator (green tick or red cross) shown in the collapsed window title bar
* [New] Hotkeys — Use Item: new "Use by Slot" mode to trigger the item in a specific bag/slot position, regardless of what item it is
* [New] `/transmo` NPC list is now fully user-configurable in settings — add your current target as a named entry, edit or remove existing entries, and reset to built-in defaults; also added `/transmo model NPC_ID MODEL_FILE_ID MODEL_FILE FLAGS [SCALE]` subcommand for direct model specification
* [New] Inventory Sorting: new `/sortinventory` and `/sortstorage` chat commands to sort character or storage inventory from chat; sorting now automatically deprioritises Nicholas The Traveller collectibles until the week they are needed
* [New] Notifications: added Team Chat as an option for toast notifications and window flash; new "Change window title on notification" option — the GW window title changes to show pending unread notifications when the game is minimised or running in the background
* [New] Effects Monitor widget: new option to track nearby spirit effect timers (Bloodsong, Vampirism, etc.) and display their remaining duration alongside your own effects
* [New] Item Drops: new "Always hide items for player" and "Always hide items for party" lists — items on these lists are always hidden from the drop overlay regardless of rarity or other filter settings
* [New] Added `/disableheroskill <hero_number> <slot_number> [0|1]` chat command to enable or disable a specific hero's skill slot from chat
* [New] Added `/custommarker <x> <y>` chat command to place a custom quest marker at exact world coordinates; `/custommarker clear` removes it
* [New] Account Inventory window: Ctrl+Click on an item to move it to your current inventory
* [Fix] Corrected model file IDs for dervish avatar forms in the Armory window
* [Fix] Fixed title tracker using a deprecated API for bounty title detection
* [Fix] Fixed auto-assigned quests overriding the player's manually chosen active quest
* [Fix] Improved reliability of character auto-selection on the character select screen
* [Fix] Trade window: messages from players on your ignore list are now filtered from trade chat
* [Fix] Chat Filter: "Target is immune to Spells" (Vow of Silence) is now correctly blocked when the "Invalid target" filter is enabled
* [Minor] Completion window now hides empty categories when "hide completed" filters are active
* [Minor] Custom quest markers are now correctly preserved across map loads
* [Minor] Added a hint that warns you when a hero is set to "Avoid Combat" while you are in Junundu (Desert Wurm) form

We've tackled over 80 issues for this release, so I've probably missed loads more. Let us know on discord or with a github issue if you have bugs.

And there will be bugs - sorry about that.

"Progress just means bad things happen faster." -- Terry

## Verion 8.17

* [Fix] Fixed disconnect on reroll when gw was started with -character arg
* [Fix] Fixed crashing on withdrawing/depositing gold, trading players and viewing/saving templates, equipping items
* [Fix] World map widget showing up again
* [Fix] Fixed font sizes not working properly with some widgets
* [Fix] Armory widget colours working properly
* [Fix] Fixed messed up fonts
* [Minor] Builds from gwtoolbox are also saved to the Guild Wars / Templates / Builds folder to be able to access them in-game without running tb
* [Minor] Added performance window to see in real time how shit our code is

## Verion 8.16

* [Fix] Working with 38511
* [Fix] Fixed bug preventing /useskill working for stances/shouts/pet attacks if you've got a skill queued.
* [Fix] Removed Wintersday LA from completion window
* [Fix] Fixed crash in hero builds window related to new heroes
* [Fix] Fixed bug preventing targetting message from being filtered when checked
* [Fix] Fixed bug hiding damage percent
* [Fix] TB remembers last login status on login screen again
* [Fix] Various other bug fixes and mem leak fixes
* [Minor] Added support for forsaken tunnels
* [Minor] Global font scale renders text better
* [Minor] Re-added reconnect qol fix
* [Minor] Improvements to vanquish widget improve FPS
* [Minor] Added Althea to hero list
* [New] Added Account Inventory window to track items across characters

## Version 8.15

* [Fix] Fixed various features not working since gw 38359 e.g. tick as toggle, /enter command
* [Fix] Fixed bug causing minimap clicks to read in the wrong place when the minimap isnt square
* [Fix] Fix hero names not showing up properly in hero builds
* [Fix] Fix quest markers not showing for all quests after zone change
* [Fix] Fix minimap cardinal behaviour on pan/zoom.
* [Fix] Fixed /addhenchman not working if henchmen are out of compass range
* [Fix] Marked targets on minimap now inherit the custom size/shape that was given
* [Fix] Fixed bug showing title tracks when the player doesn't have any progress on it in the hero window
* [Fix] Fixed crashing on machines with non ascii characters in the GWToolbox path
* [Fix] Fixed a freeze/deadlock issue related to TTS module
* [Fix] Fixed nearest outpost logic to use campaign; fixes issues when travelling to eotn from proph an vice versa
* [Fix] Revisited minimap key modifier code to fix bugs related to custom modifier keys
* [Fix] Keg of age is used correctly in pcons module
* [Fix] Fixed toolbox colouring rare items yellow
* [Minor] Added a few more dialog options to /dialog take
* [Minor] Reduced FPS hit when rendering minimap on-screen
* [Minor] Added some more NPCs to TTS module
* [Minor] Fixed bug preventing /useskill to be used as a toggle, and factored behavior to allow /useskill without args to print usage instead
* [New] Added vanquish monitor to mission map widget
* [New] Added favor widget to show current favor of the gods on-screen
* [New] Added option to show healing on the damage monitor widget
* [New] Added option to set colours for salvage, price checker, nicholas info
* [New] Added "/camera distance" command and settings to set max camera distance from your character
* [New] Added "/travel outpost" command to travel to the nearest unlocked outpost to wherever you are
* [New] Added feature to link toolbox windows or widgets to some GW in-game UI components when "Lock position" is unticked - helps to avoid toolbox ui position getting borked on window resize.

## Version 8.14

* [Fix] Working with 38219
* [Fix] Fixed bug causing a player's active quest to change on map load
* [Fix] Fixed bug preventing edited builds from pinging in chat
* [Fix] Fixed crash when deleting a teambuild
* [Fix] Fixed bug causing automatic screenshots being done on reroll
* [Minor] Adjusted ui for salvage info, and all rune trader and dye sale prices are shown instead of just some of them now
* [New] Added an option to clear the chat input when hiding the chat window
* [New] Added optional message under the name tag of a locked chest in-game to tell you how many lockpicks you have
* [New] Stops GW from grabbing controller input if the game isn't in focus
* [New] Added widget to track number of exploitable corpses in range
* [New] Added option to hide in-game store advertisement on char select screen
* [New] Added /addhenchman, /addhero and /leave chat commands
* [New] Added hotkey option to block later hotkeys when its triggered
* [New] Optimised storage sorting to take much less time
* [New] Added optional context menu button to search for an item on gwmarket

## Version 8.13
* [Fix] Fixed tolbox failing to inject for people without vcredist

## Version 8.12
* [Fix] Fixed toolbox for gw 38127
* [Fix] Fixed occasional incorrect path generation
* [Fix] Fixed minimap markers not loading unless toggled on and off
* [Minor] Adjusted spirit ranges to new patch
* [Minor] Added support for self-hosted Kokoro TTS

## Version 8.9
* [Fix] Fixed crash when trying to save a skillbar in-game whilst toolbox is running
* [Fix] Fixed issues with title display/use after gw update 38106
* [Fix] Fixed issue causing minimap to reset position on map load
* [Fix] Fixed title sort order not doing anything in the title widget
* [Fix] Tengu/imperial summoning stones now match their skill properly when the setting is enabled
* [Fix] Fixed bug preventing rerolling if you have an empty character slot in some situations
* [Fix] Fixed bug causing some NPC dialogue messages from being processed twice for TTS
* [Fix] Fixed some issues preventing quest markers for non-active quests from being displayed on world map when enabled
* [Fix] Fixed bug preventing the "salvage all" feature from working with a lesser kit on purple/gold items
* [Fix] Automatic screenshots now include the UI when taken; was previously emulating the shift+screenshot functionality
* [Minor] Changed ui for managing items that you want to hide from the merchant - you can't add via model id anymore, but you can add via item context menu instead.
* [New] Added item context menu option to prevent some items from being salvaged accidentally - you can remove these entries in inventory settings

## Version 8.8
* [Fix] Updated to work with GW 38092
* [Fix] Fixed more compass related display and flagging issues
* [Fix] Fixed occasional crash on shutdown and start related to minimap code
* [Fix] Fixed gwtoolbox settings not saving to disk when closing gw via close button in top right
* [Fix] Fixed repeated prompts to update toolbox caused by filesize rounding error
* [Fix] Fixed occasional delayed loading caused by networking issues
* [Fix] Fixed crash when trying to travel to nearest outpost and failing to find a suitable unlocked outpost
* [Minor] Only play TTS when GW is in focus
* [Minor] "Automatically cancel unyielding aura when re-casting" now also applies to heroes
* [Minor] Added elite skills on world map for GW Beyond, and lots of other community amends for the elite skill locations on the world map :)
* [New] Added options in game settings to automatically screenshot on vq/mission/title max
* [New] Added camera unlock module; re-introduces stuff like camera speed and vertical movement from previous version of tb, but in a separate module.

## Version 8.7
* [Fix] Fixed bug preventing gamepads from working as intended when toolbox is running (again)
* [Fix] Fixed crash when using the reroll feature in some situations
* [Fix] Fixed client freezing when toolbox is closed from the char select screen
* [Fix] Fixed a bug with pathing that caused paths to cut through impassable terrain
* [Fix] Fixed a bug causing the currently typed chat message to be cleared when a chat command is triggered by toolbox
* [Fix] Fixed some issues hiding/showing compass when the relevent minimap options are enabled
* [Fix] Fixed a bug preventing guild wars hotkeys like "logout" from working
* [Fix] Fixed issues flagging heroes using the toolbox minimap
* [Fix] Fixed crash when printing resign log for some players
* [Fix] Fixed bug preventing compass drawings from other players showing up on minimap
* [Fix] Fixed memory leak caused by the item drops feature
* [Fix] Fixed title tracker widget showing wrong counts for some titles
* [Fix] Fixed bug causing heroes to drop bundles when calling a target with toolbox
* [Minor] Added Frozen Soil to spirit effects
* [Minor] "Automatically cancel unyielding aura when re-casting" now also applies to heroes
* [Minor] Added elite skills on world map for GW Beyond, and lots of other community amends for the elite skill locations on the world map :)
* [New] Added free text-to-speech api https://tts.gwtoolbox.com - allows the Text-to-speech module to be used for free.
* [New] Added Market Browser window, allowing players to browse items from https://v2.gwmarket.net
* [New] Added Inventory Sorting module - settings to organise inventory are in Inventory Settings

## Version 8.6
* [Fix] Fixed bug preventing window positions from being saved on close
* [Fix] Fixed flagging cursor not being cleared when flagging on the minimap
* [Fix] Fixed hanging process when kamadan trade chat isn't responding
* [Fix] Fixed crash when removing a player name from a hotkey
* [Fix] Fixed crash when trying to load a build that doesn't match your primary profession
* [Fix] Fixed agent colours not correctly being assigned on minimap due to agent model id changes
* [Fix] Fixed crash when trade with another player is completed
* [Fix] Fixed crash when in-game hints are displayed via toolbox
* [Minor] Extended unlocked elites on world map to use completion window
* [Minor] Added piken square to pre searing travel window
* [New] Added LiveSplit websocket to objective timer, wip

## Version 8.5
* [New] Added directx texture list to info window for exporting textures to gMod easily
* [Fix] Working with gw build 38015
* [Fix] Fixed bug preventing gamepads from working as intended when toolbox is running (again)
* [Fix] Fixed decimal point issue when showing title progress widget
* [Fix] Fixed more issues identifying items in error
* [Fix] Fixed /call command not working
* [Fix] Fixed toolbox settings not being saved when closing the game via new F12 menu

## Version 8.4
* [Fix] Fixed crash on launch reported by some users (restarting windows usually fixed it!)
* [Fix] Drop gold hotkey working again
* [Fix] Fixed crashes related to quest pathing
* [Fix] Fixed bugs related to gw settings not loading/saving properly
* [Fix] Fixed bug preventing minimap from showing if compass was hidden
* [Fix] Fixed bug preventing gamepads from working as intended when toolbox is running
* [Fix] Fixed bug preventing white items from being identified when toolbox is running
* [Fix] Fixed costume previews not working in armory
* [Fix] Fixed bug preventing "flag all" from working when in an explorable area with only henchmen
* [Minor] Removed checkbox to hide email address on login screen (this is part of the game now)
* [Minor] Added chat commands to hide armor pieces via armory
* [New] Ordered Jon a new keyboard because all these bug fixes have broken his ctrl key

## Version 8.3
* [New] Added extra settings to hotkeys to trigger in controller mode or not
* [New] Added extra setting to camera smoothing in game settings to turn off in controller mode
* [Minor] Hide non-elite skills when capturing from a boss now has a setting to turn it off
* [Minor] Updated gwtoolbox.exe to stop using registry for settings - use command line args instead
* [Fix] Fixed double click to travel not working
* [Fix] Fixed an issue preventing bonds monitor clicking from working

## Version 8.1
* [Fix] Fixes to work with reforged
* [Fix] Launcher updated to work with reforged
* [Fix] Fixed items not moving to storage tabs when dropped
* [Fix] Fixed crash when bulk id'ing when "reuse kit" options are enabled

## Version 7.14
* [New] Added weapon skins to Armory window
* [New] Added `/armory` chat command to set armor pieces on map load
* [New] Added "Preview Item" to item context menu for trying on weapons and armor before buying/trading
* [New] Added `/button` chat command
* [New] Added Steam module to allow steam to recognise gw as a running game properly.
* [New] Added TitleTrackerWidget for monitoring title progress
* [New] Added module to sort account titles in a useful way
* [New] Added elite skill capture locations to world map
* [New] Added auto party sorting by map and/or party size
* [New] Added feature to log, block and play music based on events
* [New] Added strict key combo setting to only trigger hotkeys with exact key combinations
* [New] Added bulk consume context menu for Krytan Brandy and similar items
* [New] Added option to change experience bar label to show experience progress rather than level
* [New] Added extra text indicators for bulk buying/selling at traders
* [New] Added world position location to agent info in info window
* [New] Added tooltip on build names in builds window
* [New] Prefill build code when adding builds in builds window
* [New] Added an option to Inventory Settings to auto re-use id/salvage kit to avoid having to double click it every time
* [Minor] Extended `/target <name>` to check items and gadgets as well as NPC names
* [Minor] Auto re-open tome when a skill is learned
* [Minor] "Only show learned skills" now works with skill trainers
* [Minor] Hide non-elite skills when capturing from a boss
* [Minor] Open Xunlai Chest hotkey now toggles chest on/off
* [Minor] UseItem hotkey/command can now be used for kits
* [Minor] Don't use positional audio for GUI TTS
* [Minor] Check system volume to reduce TTS credit usage
* [Minor] "Show all areas" now completely reloads world map on change
* [Minor] Removed level cap check for experience bar label
* [Minor] Tidied up click handling logic in inventory manager
* [Minor] Removed xunlai storage patch - this was fixed in a recent gw update
* [Minor] Exposed GetPartyWindowHealthBars functionality
* [Minor] Updated cast struct definitions
* [Fix] Fixed armory chat command bug
* [Fix] Fixed close signal not firing in some contexts
* [Fix] Fixed crash when observing matches with Toolbox running
* [Fix] Fixed some miniatures showing incorrectly in completion window
* [Fix] Fixed crash with large number values in NPC voice module
* [Fix] Fixed login screen connection issues
* [Fix] Fixed bug preventing materials window from bulk selling/buying in some situations
* [Fix] Fixed bug preventing quest marker path checkboxes from working in quest module
* [Fix] Fixed bug preventing objective names showing up on objective timer for DoA
* [Fix] Fixed bug causing wrong overall time to show for FoW/UW runs
* [Fix] Fixed bug preventing correct profession icon on hover for character completion
* [Fix] Fixed bug preventing EotN locations being identified on world map when right-clicking in Prophecies areas and vice versa
* [Fix] Fixed raw input assertion errors when using emulation software e.g. wine
* [Fix] Code tweak to avoid early assertion failure on exit
* [Fix] Reduced spam from target info window when GWW is unresponsive
* [Fix] Reverted some modules not being loaded by default

## Version 7.13
* [Fix] Fixed crashing on startup for some players
* [Fix] Fixed flagging hotkeys not working for players that don't have the in-game gw compass displayed
* [Fix] Fixed bug preventing "show all areas" from working when the world map is shown for the first time since tb launch
* [Fix] Fixed disconnect issue when selecting a character from char select screen in some cases
* [Fix] Fixed a bug preventing the "hide gw quest marker" setting from working in some cases
* [Fix] Fixed some edge cases for pcon counts not being correct
* [Fix] Fixed clock font size being remembered after toolbox restart
* [Fix] Fixed bug causing some in-game volume preferences to be mixed up when being set via toolbox
* [Minor] Added logic to make sure that the text for effect countdowns/vanquish progress isn't larger than the icon its overlaying in Effect Monitor
* [New] Added option to hide gold items from merchant in Toolbox Settings > Inventory Settings
* [New] Added context menu option to store all/withdraw all unidentified golds in item context menu
* [New] Added option to further scale the in-game interface size to be smaller or larger than the value set in the F11 settings window in Toolbox Settings > UI Scaler

## Version 7.11
* [Fix] Rebased code fixes for June update to fix bugs
* [Fix] Fixed bug preventing hero builds from loading
* [Fix] Fixed bug preventing quest log double click to trave feature

## Version 7.9
* [Fix] Compatibility with Guild Wars after the 17.06.2025 update

## Version 7.8
* [Fix] Fixed trade alerts no longer working
* [Fix] Fixed bug preventing player speech bubbles from showing
* [Fix] Fixed crash in npc voice module when processing some speech bubbles in explorable areas
* [Fix] Fixed bug causing updater to get stuck on "checking"
* [Fix] Fixed crash when whispering an offline player with "redirect whispers" enabled
* [Fix] Fixed /fps command not working after gw update
* [Fix] Fixed "trade whole stacks by default" not working after gw update
* [Fix] Fixed issues interacting with world map widgets after gw update
* [Minor] NPC voice module checks dialog volume to avoid sending API requests when its off
* [Minor] Char sort order preference is no longer being messed with when rerolling or auto-login via toolbox

## Version 7.7
* [Fix] Fixed crash when talking to some faction donation NPCs
* [Fix] Fixed hanging on toolbox launch caused by poor internet connection
* [Minor] Added a set of default toolbox window module buttons; previously only showed settings when launching toolbox for the first ever time
* [New] Added option to armory module to globally dye armor pieces
* [New] Added Google and Play.ht API options to NPC voice module

## Version 7.6
* [Fix] Fixed gw sometimes crashing when toolbox is closed
* [Fix] Fixed bug with nicholas item info not always being correct
* [Fix] Fixed GW's built in 180 fps limit to allow higher framerates (up to your fastest monitors max refresh rate)
* [Fix] Fixed enter mission "are you sure" popup not automatically proceeding when triggered from an NPC dialog button
* [Fix] Fixed item price being shown twice when hovering materials
* [Fix] Fixed bug preventing ally npc chat being sent to emote channel
* [Fix] Fixed materials window not working
* [Fix] Fixed ctrl + request quote not working
* [Fix] Ctrl + X will no longer trigger X hotkey too.
* [Fix] Item filter no longer blocks some nightfall mission item
* [Fix] /enter uw|fow now works from Zin Ku Corridor and Chanty of Secrets too
* [Fix] prompt if mission is already completed no longer causes crash in some situations in Nightfall
* [Fix] Fixed a bug causing filtered trade chat messages to show up
* [Fix] Fixed crash when running send chat hotkey whilst chat is focussed
* [Fix] Fixed bug preventing the new miniatures from being flagged as collected in completion window
* [Minor] Updated pcon settings ui
* [Minor] Vastly improved regex performance, watch out for bugs though
* [Minor] Added "skills offered" section to target info
* [Minor] Improved TargetInfo window performance
* [Minor] Unlock all option now affects all widgets too
* [Minor] Added a warning message in chat if toolbox is launched in a pvp area
* [New] ChatSettings: setting to hide all friendly speech bubbles
* [New] /pref command now supports 'textlanguage' and 'audiolanguage'
* [New] TargetInfo window now has a setting to automatically hide if no suitable target is selected
* [New] PconWindow settings: option to block air of superiority messages
* [New] /hero target [hero_name] added
* [New] Setting not to draw toolbox during loading screens
* [New] Game world quest path can now be shown independently from Minimap (settings for it are still in Minimap settings)
* [New] /spawnblockeditems to spawn all items the Item Filter settings currently have blocked
* [New] /config chat command - see help > chat commands
* [New] Added Hero Equipment module - an inventory icon is shown in the title bar of a hero skill bar
* [New] Added NPC Voice module - add an API key in settings > NPC Voice to enable in-game text to speech

## Version 7.3
* [Fix] Fix keys being stuck when you hold them as you open an imgui modal

## Version 7.2
* [Fix] Fixed bug causing hotkeys not to trigger
* [Fix] Fixed crash when font paths contained cyrillic or chinese characters
* [Fix] Fixed crash when changing targets through Toolbox UI controls
* [Fix] Fixed skipping factions character name input not working
* [Fix] Fixed bug preventing chat commmands /wiki /report and /help when triggered through toolbox
* [Fix] Fixed bug preventing shouts to be listed in the Target Info window
* [Fix] Fixed bug causing right click weirdness after placing a marker on the world map
* [Minor] Changed visibility checkbox for widgets and windows to eye / eye-slash symbols.
* [New] /transmo model command (see website)
* [New] /tp quest command
* [New] option to identify and salvage all (gold and lower rarity) items in your inventory on ctrl + click
* [New] option to set different colour for non-active quest markers (Minimap - Symbols)
* [New] option to show all quests on the world map, even when the minimap setting is disabled
 
## Version 7.1
* [Fix] Fixed crash in combination with steam overlay
* [Fix] Fixed problem where chat messages from ignored players would still be seen
* [Fix] Fixed /call command
* [Fix] Fixed /fps command crash
* [Fix] Fixed /fps command crash
* [Fix] Fixed changing secondary profession
* [Fix] Fixed salvage all uncommon showing a popup
* [Fix] Fixed crash after equipping a weapon in game when armory was no longer active
* [Fix] Fixed weapon skill incorrectly showing on normal enchantments
* [Fix] Fixed completion window not properly loading completions on startup
* [Fix] Fixed skip entering character name when donating faction
* [Fix] Fixed /tp interpreting district numbers as single digit
* [Fix] Hopefully fixed linux loading issue
* [Minor] Skillbar widget can shrink to any size now
* [Minor] Completion window dropdown is ordered now
* [New] Skillbar widget has new option to outline the recharge text
* [New] Options for Distance and Health widgets to not show the header name, introduce font sizes for these and Timer too
* [New] Feature to set target for all heroes and pets on target call
* [New] Added quest markers to worldmap (game has these, but they were so small that you couldn't see them)
* [Removed] Removed /zoom and /cam fov as they had no effect due to gw updates

## Version 7.0
* [Fix] Fixed occasional crashing when disabling or enabling modules whilst toolbox is running
* [Fix] Fixed bug mixing up messages if a previous message is received (and blocked) from an ignored player
* [Fix] Fixed issue preventing compass drawing
* [Fix] Fixed issue preventing world map widget from being shown
* [Fix] Fixed crash when trying to use a skill tome with "only show non learned skills" setting checked
* [Fix] Fixes crash when loading settings whilst toolbox is running
* [Fix] Fixed bug preventing salvaging via right click menu from working
* [Fix] Fixed bug preventing identifying via right click menu from working
* [Fix] Fixed skill warmup setting not working
* [Fix] Fixed /cam fog working the wrong way round
* [Fix] Fixed crash when using /reinvite command
* [Fix] Fixed custom markers not showing immediately by default
* [Fix] Fixed disconnect on map load when using an equip item hotkey on map entry
* [Fix] Fixed bug preventing custom map marker from checking current map
* [Fix] Fixed crash when targetted enemy is despawned
* [Fix] Fixed materials window now working as expected
* [Fix] Fixed /age2 on /age and /age on vanquish not working
* [Fix] Fixed bug causing travel to deep/urgoz when using `/tp` to visit the nearest outpost
* [Fix] Fixed crash caused by armory module clearing currently held weapon when tb is closed
* [Fix] Fixed some items being incorrectly labelled as tomes when right clicking
* [Minor] Added "That skill is still recharging" message block when invalid target messages are filtered
* [Minor] Removed "Ping Build" hotkey, added `/pingbuild` command instead
* [Minor] Removed "Disable loading screen fade animation" - unstable
* [Minor] Challenge mission outposts work with /travel now
* [Minor] Re-enabled cursor fix module
* [Minor] Allowed more fine grained control over text size for skillbar, clock and effect monitor widgets
* [Minor] Added auto resize option for all widgets and windows
* [Minor] Show/Hide position and size settings when lock position/size is checked
* [Minor] Addded campaign name to skill description tooltip
* [New] Added option to disable pcons on mission complete, vanquish complete and dungeon complete
* [New] Added option to assign multiple character names to a single hotkey
* [New] Added custom marker context menu to mission map
* [New] Added option to skip "You have characters from another campaign" prompt when entering a mission
* [New] Added option on chat settings to change colour of highlighted text items e.g. rarity, skill and quest descriptions
* [New] Added an option in game settings to prevent weapon spell skin showing on player weapons
* [New] Added audio settings section to access gw window to change rolloff etc in Audio Settings section
* [New] Added feature to log and block in-game sounds in Audio Settings section
* [New] Added option to block the vanquish complete popup

## Version 6.25
* [New] Code overhaul to GWCA and GWToolbox to work with vs2022 compiler update
* [New] Added pathing to mission map
* [New] Added ability to trigger hotkeys on key up instead of key down
* [Fix] Fixed bug causing the "are you sure" dialog for entering a mission to show in error - added an option to disable this feature
* [Fix] Fixed crash when dropping zaishen coins with salvage info module enabled
* [Fix] Fixed occasional crashes when using any widget that is snapped to the party health bars
* [Fix] Fixed a bug causing incoming messages getting mixed up with other messages that have been blocked by toolbox
* [Fix] Fixed text glitches for text sizes > 16
* [Fix] Fixed bugs with quest markers not showing or showing incorrectly
* [Fix] Fixed autologin not working when injecting via gwlauncher
* [Removed] Removed option specifically related to holding a button down to toggle mouse walking - use `/pref disablemousewalking [0|1]` in combination with hotkey key up/down
* [Removed] Removed Pathfinding window from release, not used.

## Version 6.24
* [New] Slightly optimised GW's dat loading ccode
* [New] Added EnemyWindow (party window but for enemies)
* [New] Added party broadcast module to anonymously send outpost party info to https://party.gwtoolbox.com 
* [New] Added `/duncan` chat command to share your quest progress
* [New] Quests (markers) now have different colors
* [New] Added option to show the path to the current quest in the 3d world via Toolbox Settings > Quest Module
* [New] Added option to show the path to the current quest in the toolbox minimap via Toolbox Settings > Quest Module
* [New] Added tickbox option on the world map to show toolbox minimap lines
* [New] Added context menu with right clicking anywhere on the world map to place a custom marker when WorldMapWidget is enabled. Custom markers create a quest in the gw quest log called "Map Travel" to allow you to plot a route.
* [New] Added message to nicholas items when he will collect them
* [New] Added hover tooltip for daily quests and completion window to easily check who needs an area or skill
* [New] Added option in item context menu to store all nicholas items if you're hovering one
* [New] Double clicking on a quest in the GW quest log will now take you to the nearest unlocked outpost to that quest
* [New] When sending a whisper to another player whilst offline, toolbox will let you know in chat and suggest changing your FL status
* [New] Daily quests window now checks your inventory for nick items to show you how many you already have
* [New] Added tooltip to build codes in builds and hero builds windows ot show you the build at a glance without having to view it
* [New] Added "are you sure?" prompt if you try to enter a mission in NM/HM that you've already completed fully on that character
* [Minor] /useskill now toggles that skill on/off, you can still only have ONE skill active at a time
* [Minor] added option in HotkeyWindow to change the autoclicker clicker speed
* [Minor] changed /prefs command to allow changing almost all preferences by english setting name
* [Minor] When ctrl-spacing enemy whilst holding an item, the game will call the target instead of "I'm following <enemy>"
* [Minor] Added `/travel nick` to travel to Nicholas the Traveller's nearest unlocked outpost
* [Minor] Adjusted the nearest outpost calc to add some special exceptions when the nearest outpost by world coords isn't the closest by foot
* [Minor] Some toolbox info messages are now "temporary", meaning they will not stay in the chat log, and will be removed when changing map
* [Minor] Added more Prophecies NPCs to party window module by default
* [Minor] Added notification when an invite via party search window is received
* [Minor] Salvage info now fetches from in-game memory instead of asking GWW; armor items now also show salvage info when hovered
* [Minor] Salvage info now also shows on hover for items listed the "Salvage All" window
* [Minor] Completion window automatically removes deleted characters, and doesn't show pre searing or pvp chars
* [Fix] Fixed party window related widgets (damage monitor etc) from not moving when the main gw window is moved
* [Fix] Fixed bug causing armory module to display equipped weapons on your character when in an outpost
* [Fix] fixed autoclicker potentially rendering your guild wars unresponsive for a short while after using it
* [Fix] /title applies asuran title in some asura missions now that previously defaulted to your default title
* [Fix] fixed rare crash that could occur when activating pcons during a loading screen
* [Fix] fixed /tp command to correctly teleport to explorable areas that start with "The"
* [Fix] Active quest widget works in non-latin languages now
* [Fix] fixed toolbox minimap being hard to ping
* [Fix] fixed friend list alias in whispers
* [Fix] Fixed bug preventing player from moving the gw compass if toolbox minimap is enabled
* [Fix] Fixed bug preventing friend aliasing from working when receiving or sending whispers
* [Fix] Fixed crash when trying to set ready status outside of an outpost
* [Fix] Fixed party damage widget not recording stats until shown
* [Fix] Fixed bug preventing minimap drawing when spectating someone else outside of your own character's compass range
* [Fix] Fixed working with gw build 37503
* [Removed] removed chat log module because it led to too many issues

## Version 6.22
* [New] Added highlight info and right click menu to daily quests window to make doing dailies easier
* [New] Added option to hide gw compass when toolbox minimap is active
* [Minor] Changed UI layout of travel window
* [Minor] /tp [zm, zv, zb] now does the same as /zm take or /zm travel
* [Fix] Fixed compass being hidden when toolbox starts
* [Fix] Fixed alcohol being spammed too much
* [Fix] Fixed rounding issues for SkillMonitor width causing wrong pixel offsets
* [Fix] Fixed crash when offering an item to trade that is already already offered

## Version 6.21
* [Fix] Party widgets do not disappear when party members are out of compass range
* [Fix] Minimap does not disappear when spectating
* [Fix] /deposit works with model ids now
* [Fix] open chest hotkey now works (still, prefer using the setting to automatically open locked chests in GameSettings)
* [Fix] fixes update mode showing as unticked if you selected "never update"
* [Removed] open locked chest hotkeys. Use the "automatically open chests with keys (or lockpicks)" in GameSettings instead.
* [New] Added /wanted take, /zb take, /zm take, /zc take, /zv take to take Zaishen/daily quests and travel to the next quest outpost
* [New] Added salvage info and nicholas info to item
* [New] Added option to hide gw compass flagging controls
* [New] Automatically send a party invite when a party search invite is sent

## Version 6.20
* [Minor] Added warning message when rerolling to a character that is currently in a map that toolbox won't work in e.g. guild hall
* [Minor] `/tb load` now dynamically enables/disables modules when run
* [Minor] Fixed some layout errors when Party damage widget is snapped to the in-game UI.
* [Minor] Fixed some layout errors when Skill monitor widget is snapped to the in-game UI.
* [Minor] Fixed some layout errors when Bond monitor damage is snapped to the in-game UI.
* [Minor] Fixed some layout errors when Effect monitor is snapped to the in-game UI.
* [Minor] Force Party damage/skill/bond/effect monitor snapped to in-game UI.
* [Minor] Added option to turn the whisper redirect feature of the friend list window module off.
* [Minor] Added missing deldrimor paragon armor to armory module
* [Minor] Added option to exclude nicholas items from bulk salvage
* [Minor] Updated `/deposit` command to allow more options; see chat commands section in help.
* [New] Added nicholas info when hovering an applicable item
* [New] Added option to bypass item quantity selection when dropping/moving/trading items (hold shift to prompt when enabled)
* [New] Added ability to create a Hero build template from current setup via the Hero build window
* [New] Added `/call` command to ping current target
* [Fix] Fixed toolbox not loading up on first run due to missing fonts
* [Fix] Fixed hotkeys being triggered by typing keys before map change
* [Fix] Fixed crash caused by triggering hotkeys just before map change
* [Fix] Fixed bugs related to the whisper redirect feature of the friend list window module.
* [Fix] Fixed bug causing layout errors for snapped UI widgets when screen is small.
* [Fix] Fixed spammy errors caused by issues fetching salvage info for hovered items
* [Fix] Fixed crash caused by spectating heroes when you're dead
* [Fix] Fixed bug causing items offered in trade to be removed when hovering
* [Fix] Fixed crash when trading with "hide item descriptions" enabled

## Version 6.18
* [Removed] Toolbox no longer works in Guild Halls. This is intentional.
* [New] Salvage information module added
* [Minor] TravelWindow: Renamed minimize_on_travel to collapse_on_travel, default false
* [Minor] Toolbox now respects fetch_salvage_info checkbox
* [Minor] Removed outdated move_to_cast help
* [Fix] Show All Areas (world map widget) no longer disables guild/ally chat buttons
* [Fix] replying to Twitch (TwitchModule) correctly sends to twitch chat now
* [Fix] Fixed option to flash gw window when player is pinged
* [Fix] Fixed show notification/flash window on invite not saving
* [Fix] Fixed crash when trying to withdraw to character without unlocked bags
* [Fix] ChatFilter blocking ally drops no longer blocks drop messages for the player
* [Fix] Fixed bug preventing URLs being sent as templates in whispers
* [Fix] Fixed bug causing "I'm following X" messages from ignored players to still be shown
* [Fix] Fixed bug preventing `/offline` chat command from working
* [Fix] Fixed bug showing the wrong points for devotion in the completion window

## Version 6.17
* [New] Added a release channel option to the toolbox updating functionality
* [New] Draw all quests option (Minimap) now offers to draw non-active quests in a different colour
* [Minor] /target <name> can now target players, previously it required /target player <name>
* [Minor] Minimap targetting is now able to target locked chests again
* [Minor] You can now create multiple chat aliases with the same alias, i.e. `/hi !sayinghello` and `/hi /wave`
* [Minor] Disable camera smoothing now works while reverse camera is active
* [Minor] /marktarget can now highlight other players
* [Fix] Hide city pcons in explorable areas now saves and loads
* [Fix] Real time timer no longer resets on entering explorables if never reset is ticked
* [Fix] Minimap drawing is fluent again
* [Fix] Travelling to a pvp outpost while mouse hovers over toolbox windows no longer blocks left clicks
* [Fix] Draw all quests no longer switches your active quest around
* [Fix] reroll confirmation now waits for a separate enter press, rather than a forced wait of 500ms

## Version 6.16
* [Minor] `/dialog take` can now be used the take bounties
* [Minor] Current character is highlighted in Reroll window now
* [Minor] Added option to colour outgoing whispers blue, instead of always doing so
* [Fix] Fixed dialog hotkeys
* [Fix] Fixed salvaging and storing functionality
* [Fix] Disabled toolbox in PvP explorables as well
* [Fix] Fixed bug preventing minimap flag buttons from working
* [Fix] Capitalised chat aliases work again
* [Fix] Fixed autoclicker not being possible to turn off
* [Fix] Completionwindow EotN is correctly tracked again
* [Fix] Fixed urls not being turned into templates when sending to chat
* [Fix] Fixed tb not being disabled fully in pvp
* [Fix] Fixed crash on world map when toggling "view all areas" in cantha

## Version 6.13
* [Update] Compatibility with GW Version 37.363
* [Removed] Toolbox no longer works in PvP. This is intentional.
* [New] Added option to show quest markers for all quests on the minimap
* [New] Added /bonds chat command
* [New] Added XP scrolls to pcon window
* [Minor] Completion window stores mission state
* [Minor] Added texture creation tracking to info window
* [Minor] Added lockpicks to pcons window
* [Minor] Fixed skill monitor cast indication for half-casttime casts
* [Minor] Reordered the armory window pieces to ingame order
* [Fix] Fixed gw crash when using /chat without an argument
* [Fix] Fixed bonds not showing for allies like summoning stones
* [Fix] Fixed minimap not taking inputs when it was snapped to compass, but size and position were unlocked

## Version 6.12
* [Fix] You can search in the TravelWindow again
* [Minor] Added Festive Winter Hood to ArmoryWindow

## Version 6.11

* [New] Added item upgrade unlocks to completion window
* [New] Added option in FriendlistWindow to replace friends character names in chat with their alias.
* [New] Added chat filter for dropped ashes
* [New] Added option to remove the 1.5 second minimum for a cast bar to show up for your own casts (Gamesettings).
* [New] Added GameWorldRenderer to render lines, circles and polygons on the game terrain. This isn't fully fleshed out
  yet and draws even on parts that are behind walls or agents - might be enhanced in the future.
* [New] Loading and saving multiple configs (/tb load <configname>, /tb save <configname>) now saves and loads all
  settings.
* [New] Rewrite of Armory window to use icons instead of dropdowns, fixed bugs, added costumes and missing head pieces.
* [Minor] Added watchful intervention to bond monitor
* [Minor] Added default values for the Minimap position if you've never moved the in-game compass
* [Minor] Toolbox widgets now all remember their lock_move and lock_size settings
* [Minor] Added option to auto use keys on chests (prioritised before lockpicks)
* [Minor] Added option to get notified when resurrected
* [Minor] Adjusted height of damage/bonds monitors against party window to cater for HM/NM buttons in outpost
* [Minor] Minimap markers will now draw in outposts, unless there's an explorable version with the same ID (e.g. DoA)
* [Minor] Added "toggle" command to /tb which toggles visibility. E.g. /tb pcons toggle
* [Minor] Damage monitor, bonds widget and cast widget now account for the different party member height in outposts
* [Minor] Skill and image icons now load from the GW DAT file instead of downloading from GWW
* [Minor] Dropdown list of missing outposts added to travel window
* [Fix] Fixed option to auto-login when no character name parameter is passed to gw. Requires you to launch with GW
  Launcher
* [Fix] Removed copy hero build button when no builds existed.
* [Fix] Fixed CompletionWindows mission counting
* [Fix] Fixed bug preventing secondary profession switch on tome use.
* [Fix] Fixed rerolling to characters when you had empty char slots
* [Fix] Fixed trade window timestamps
* [Fix] Fixed bug preventing some minimap colours/symbols from being changed until tb restart.
* [Removed] Removed obfuscator for the time being as it was unstable. Might be re-added later.
* [Developers] Plugins have been reworked in order to more closely integrate into Toolbox. You will have to update your
  plugins in order for them to load.

## Version 6.10

* [New] Added option in party settings to automatically flag pet to attack pinged target
* [Fix] Fixed pet behavior hotkey not working properly
* [Fix] Fixed skillbars not loading that contain skills but not attributes for a secondary profession
* [Fix] Fixed bugs caused by toolbox no longer being able to grab in-game preferences due to change in 37059 gw update

## Version 6.9

* [New] Added command pet hotkey
* [Minor] Added logic to swap primary with secondary when trying to load a build through toolbox that belongs to another
  primary profession but has no dependency on that profession.
* [Fix] Fixed hero builds not loading via toolbox
* [Fix] Removed SSL certificate verification when fetching third party data e.g. trade chat, wiki resources
* [Fix] Fixed crash when completing the last quest in the quest log
* [Fix] Fixed bug preventing item images from loading when game is not in English

## Version 6.8

* [New] Added extended regex options to Chat Filter
* [New] Added option to keep current quest active when accepting a new quest,
* [New] Added shift click to collapse or expand all quest log entries
* [New] Added Guild Wars Settings Module (allowing you to export and import your game settings). Experimental for now.
* [New] Added Chat command aliases (Game Settings)
* [New] Added auto retry function to /travel
* [New] Added feature to exclude character names in Reroll Module
* [New] Added option to filter character list to the current logged in account in Completion window
* [Minor] Fixed "is typing" check to avoid triggering hotkeys when inputting text anywhere in the game
* [Minor] Added agressive refrain to bond monitor
* [Minor] Removed duplicate flash_gw_on_pm settings
* [Minor] Keep last hovered skill id in info window
* [Minor] Added info description to Custor Size under Mouse Settings
* [Minor] Improved chat filter to match accented or special characters
* [Minor] Added feature to re-order Pcons Window
* [Minor] `/quest` command shows the direct wiki url via quest id rather than search term
* [Fix] Fixed map travel outpost matching bug
* [Fix] Fixed friend list crash
* [Fix] Fixed minor minimap range render bug
* [Fix] Fixed missing options for Collector's Edition dance emotes
* [Fix] Fixed bug preventing minimap from showing agents if entering and area without any NPCs
* [Fix] Fixed bug preventing the player from choosing the last option of a dialog when talking to some Nightfall NPCs
* [Fix] Fixed minimap bug related to showing random vertices, usually seen with shadow step skills
* [Fix] Fixed skill monitor history setting not saving
* [Fix] Fixed bug causing skill templates to be continuously loaded in some cases
* [Fix] Fixed crash when assigning equip hotkey to an item with a lot of mods

## Version 6.7

* [New] Added `/chat [all|guild|team|trade|alliance|whisper|close]` to toggle chat tabs
* [Fix] Fixed crash on start related to gwarmory
* [Fix] Fixed imgui theme not being loaded on some starts

## Version 6.6

* [Minor] Separate modules, widgets and windows in toolbox settings
* [Minor] Rename warrior obsidian armor in armory module
* [Minor] Added some hover descriptions to module tickboxes in toolbox settings
* [Fix] Fixed bug causing duplicate module settings if re-enabled within the same runtime
* [Fix] Hide empty keyboard settings tab in settings window
* [Fix] Fixed occasional repeat update prompt when already on latest version
* [Fix] Fixed crashes caused by dupe window bugs
* [Fix] Fixed crashes caused by adding non-existent characters to friendlist.
* [Fix] Fixed occasional crash when right clicking items or changing character with obfuscator on

## Version 6.5

* [New] Enabled plugin system for public use
* [New] Duping Window for solo doa players
* [New] Disables gw automatically adding en-US keyboard layout
* [New] Added TS5 module; use /teamspeak to share current channel info to chat
* [New] Enabled plugin system for public use
* [New] Added marked targets to minimap; use /marktarget to highlight on current target on minimap
* [New] Added GwArmory window
* [Minor] Move To hotkey has an option to go to target or location, and to move a certain distance away from location
* [Minor] Added mission bundles to item filter
* [Minor] Added missing doa tendril
* [Minor] Added honeycomb, pumpkin cookie, gitb and mobstopper to pcons
* [Fix] Fixed honor section of completion window not showing accurate title achievements
* [Fix] Fixed issue causing persistent update notification even if you're on the latest version
* [Fix] Fixed crash related to chat log
* [Fix] Fixed crash when using party stats window before party is ready
* [Fix] Fixed crash related to skill images failing to render on-screen
* [Fix] Fixed crashes caused by adding non-existent characters to friendlist.
* [Fix] Fixed occasional crash when right clicking items or changing character with obfuscator on

## Version 6.4

* [Fix] Fixed crashes caused when saving toolbox settings for the first time

## Version 6.3

* [New] Added option to show notification/flash window when whole party is ready
* [Fix] Fixed right click context menu not working if mouse fix it turned off
* [Fix] Fixed crash when trying to load or save theme on toolbox open or close
* [Minor] Added props to minimap in debug
* [QoL] Changed behavior of the close button when in fullscreen borderless to gracefully close GW

## Version 6.2

* [New] Added `/withdraw <quantity> <model_id1> [<model_id2 ...]` chat command
* [New] Added options to hide skill descriptions on hover
* [New] Added /fps command
* [New] Added /pref command
* [New] Added option for hotkeys to trigger when gw gains/loses focus
* [New] Added grouping to hotkeys
* [New] Added option to set in-game cursor size
* [New] Added windows toast notifications for some triggers
* [New] Added warning in chat when you're last to resign
* [New] Added option to show quest givers on minimap as stars
* [New] Added option to hide or show agents on the gw compass
* [New] Added extra argument to /load command to tell gwtoolbox to load a certain config
* [New] Added notifications for last to tick
* [New] Added options to block map entry message
* [New] Festival hats added to completion window
* [Fix] Restore Windows 7 support
* [Fix] Fixed potential crash when loading custom markers
* [Fix] Fixed crash when item description is blocked when talking to merchant
* [Fix] Fixed skip character name when donating Luxon faction not working
* [Fix] Fixed bug sometimes causing all pcons to be enabled when logging into a character
* [Fix] Fixed hero builds not always loading secondary profession
* [Fix] Fixed bug preventing gw input in a cinematic
* [Fix] Fixed bugs/crashes related to loading the wrong theme
* [Fix] Fixed bugs with party stats window
* [Fix] Fixed bug preventing hotkeys in range of npc from working on map load
* [Minor] Removed dialogs window
* [Minor] Disable ctrl click storage when not in outpost
* [Minor] Added file size check to updater
* [Minor] Obfuscator also hides mercenary hero names
* [Minor] Don't block quest items or minipets in item filter
* [Minor] Reduced auto clicker interval from 50ms to 7ms
* [Minor] Added extra quest related dialog type when using `/dialog take`
* [Minor] GWToolbox modules are toggleable at runtime and don't require a restart
* [Minor] Bump up MSVC toolkit version to 143
* [QoL] Fixed GW bug preventing reconnect dialog when re-running GW using the -charname parameter ( requires gwtoolbox
  to be loaded before login e.g. gwlauncher)
* [QoL] Removed requirement for the -charname parameter to auto login ( requires gwtoolbox to be loaded before login
  e.g. gwlauncher)

## Version 6.0

* [New] GWToolbox no longer requires installation, you can immediately execute the exe or inject the dll manually
* [New] `/target ally` and `/target enemy` added
* [New] Added option to hide merchant items (selling only) in Inventory Settings module
* [New] Added option to disable item descriptions on hover (hold ALT to reveal them)
* [New] Added option to hide/show ally skills in the Skill Monitor Widget
* [New] Added option to only show effects lasting less than N seconds in Effect Monitor Widget
* [New] Added option to snap minimap to in-game compass position
* [New] Added option to hide e-mail on login screen
* [New] Added custom block rules for the Item Filter
* [New] Added option to hide items from the sell window at merchants
* [New] Hall of Monuments integrated into Completion Window
* [Minor] Obfuscate player name in Hall of Monuments
* [Minor] Obfuscate account name in Hero > Account window
* [Minor] Obfuscate player name in cinematics
* [Minor] Hovered item in Info Window stays available after mouse is moved away from item
* [Minor] Added option to hold shift when toggling pcons to turn pcons off/on by group
* [Minor] Minimap circles are more circle-shaped now
* [Minor] Dialog module Take and Reward combined into one button
* [Minor] Disable ImGui keyboard navigation
* [Minor] Added grog messages to alcohol speech bubble filter list
* [Minor] Can change Minimap modifiers now when both clickthrough options are selected
* [Fix] Fixed bugs with wrong Effect Monitor offset when loading toolbox with minions
* [Fix] Fixed crash dialog sometimes showing when GW is closed whilst toolbox is running
* [Fix] Fixed bugs causing wrong or missing skills to be loaded when trying to load a skill bar with toolbox running
* [Fix] Fixed some non-salvagable items being shown as salvagable when using Salvage All function
* [Fix] Fixed re-invite not working on current player
* [Fix] Fixed rare loading screen freeze
* [Fix] Fixed Skillbar and Minimap potentially being off by 1 pixel when pinned to ingame window
* [Fix] Reapply title defaults to Lightbringer again
* [Fix] Fixed camera sometimes jumping/glitching when looking around with RMB pressed

## Version 5.16

* [New] Added option in game settings to suppress overhead info for experience/faction gained
* [Minor] `/dialog take` now also takes quest rewards
* [Fix] Fixed bug preventing access to skill purchases or trader navigation
* [Fix] Fixed bug preventing drawing or pings on the toolbox minimap being sent to the server
* [Fix] Fixed bug causing gwtoolbox to auto update regardless of user preference
* [Fix] Fixed bug stopping shadow walk marker from being shown on minimap
* [Fix] Fixed ownership logic in ItemFilter module
* [Fix] Fixed bug causing rerolling to log out completely rather than to char select screen

## Version 5.15

* [New] Item and skills images now load on demand from Guild Wars Wiki instead of being compiled inside toolbox
* [New] Added Preferred Skill Ordes window via settings > builds
* [New] Added option to override default nametag colour for in-game agents via game settings
* [New] Added option to manage summoning stones in the pcons window via pcons settings
* [New] Show prompt to switch secondary profession when trying to use a tome for a different profession
* [New] Option to override default title used when `/title` doesn't apply to the current map
* [New] Exposed a `Terminate` function for other third party dll's to close toolbox
* [New] `/volume` chat command
* [New] Enabled/fixed the use of third party dll plugins
* [New] Auto reject invitations and chat messages from ignored players
* [New] Option to only trigger hotkey in range of NPC
* [New] Added SkillMonitor widget to see what allies are casting
* [New] Added ItemFilter module
* [New] Added `/hom` chat command, added info to info window
* [Minor] Added dialog hotkey option to auto accept first available quest
* [Minor] Added option to remove imperial guard summons
* [Minor] Added option whether to change back to previous character on a failed reroll
* [Minor] Added option to auto use lockpick
* [Minor] Removed ability to target hidden agents
* [Minor] Removed ability to use dialogs that aren't given by the server
* [Minor] Preventing `/chest` command form opening locked chests from afar
* [Minor] Black borders on agents in minimap
* [Minor] Custom agent circle colors
* [Minor] Map info on discord is always in English
* [Minor] Ensure wiki link searches for English item name when accessing via context menu
* [Minor] Save preference to hide completed areas in the completion window module
* [Minor] GWToolboxpp folder moved to `%USERPROFILE%/Documents/<Computername>
* [Minor] Various fixes to GWToolbox launcher
* [Minor] Added GW Hotkey commands for hero 9 to 12
* [Minor] Added GW Hotkey commands for per/hero commander
* [Minor] Added more maps for default `/title` option
* [Minor] Added target title tier info
* [Minor] Option to toggle reverse minimap when reverse camera is pressed
* [Fix] Fixed bug on effect monitor being messed up when moving between 2 spirits of the same type
* [Fix] Fixed chat filter option for "player x is away" from being saved to file
* [Fix] Fixed some objective timer bugs
* [Fix] Fixed Discord blocking main thread then updating server
* [Fix] Removed option to toggle gw hotkeys on map change due to the game not being ready to receive the command
* [Fix] Fixed UI checkboxes for position and size lock on main window
* [Fix] Fixed various crashes/bugs in party statistics window module
* [Fix] Fixed not being able to use mouse where the toolbox minimap is located on screen when in world map view
* [Fix] Fixed discord dll not being unloaded when closing toolbox

...and loads of other stuff I've forgotten to write down

## Version 5.14

* [New] Added Party Statistics Module
* [New] Added GW Key Hotkeys to be able to bind modifier keys to in-game controls
* [Fix] Fixed bug with some messages in the hints module
* [Fix] Fixed issue preventing toolbox from guessing material storage stack size
* [Fix] Fixed some player names not showing in the reroll window
* [Fix] Vanquish count overlay moved to correct place
* [Fix] UI tweaks to friend list window
* [Minor] More districts recognised when using `/tp` command e.g. int1, ae4
* [Minor] Reroll function now kicks all heroes before re-inviting to former party
* [Minor] Added option to limit signets of capture on skills window to 10

## Version 5.13

* [Fix] Fixed chat related crash when using obfuscator
* [Fix] Fixed `/reroll` command not working unless reroll window is visible
* [Minor] Automatically ignore trade requests and party invites from ignored players

## Version 5.12

* [Fix] Fixed crash when using `/t` command without any other args
* [Fix] Fixed occasional crash talking to NPCs
* [Fix] Fixed crash when loading chat log without a valid timestamp
* [New] Added `/reroll` and `/rr` commands
* [New] Added Reroll Window module
* [New] Added option to hide unsellable items when talking to a merchant
* [Minor] Chat logs now save on map change
* [Minor] Greyed out mission names for maps that aren't unlocked yet in completion window
* [Minor] Revisited clickthough settings in minimap widget
* [Minor] Crash dialogs are handled exclusively by gwtoolbox, and contain more debug info

## Version 5.11

* [Fix] Fixed crash when completing and objective that hasn't started in objective timer
* [Fix] Fixed issues connecting to twitch

## Version 5.10

* [New] Added option to specify player name for hotkeys
* [New] Hotkeys are now able to be triggered for more than 1 map id
* [New] Hotkeys are now able to be triggered for more than 1 profession
* [Minor] Added list view for completion window
* [Minor] Added option to hide completed missions and vanquishes on completion window
* [Minor] Any Guild Wars crash automatically creates a GWToolbox crash dump with all related info.
* [Minor] Added vc142 to installer msi file
* [Minor] Split extra timer options in Timer widget out for better control
* [Fix] Fixed layout issues with checkboxes on smaller window sizes; most checkboxes are now responsive
* [Fix] Further fixes to objective timer window should address recent issues with instance timer not resetting
  properly/invalid times
* [Fix] Fixed occasional crashes related to incoming chat messages

## Version 5.9

* [New] Added `/morale` chat command
* [Minor] Added bulb icon in settings for hints
* [Minor] Rewrite ctrl+click bahaviour for storing materials
* [Fix] Fixed bug crashing on map change related to chat log
* [Fix] Fixed effect monitor widget drawing in wrong place for players who have their effects in the default position on
  screen
* [Fix] Fixed bug causing vanquish icons to not change when selecting character in completion window
* [Fix] Fixed crash when loading gwtoolbox whilst in an outpost and triggering hotkeys on load
* [Fix] Fixed bug preventing friend list messages from displaying in the current map that toolbox is loaded in
* [Fix] Fixed out of memory error after closing toolbox from the char select screen

## Version 5.8

* [New] Added option in Party Settings to rename tengu/imperial guard summons to their elise skill
* [New] Completion overhaul; added hero tracking, hard mode toggle, character selector
* [New] `/travel` command checks explorable areas if no matching outpost is found, tp's the player to closest unlocked
  outpost
* [New] Added Effects Monitor overlay widget
* [New] Added `/quest` chat command to send current quest details to team chat
* [New] Added Chat Log module to keep a record of chat history and sent message logs even if logged out
* [New] Added Hints module to start showing useful hints via the GW hints panel
* [Minor] Added healthbar, energybar, experiencebar, compass and chat to `/toggle | /hide | /show` command to easily
  show/hide some GW UI bits
* [Fix] Fixed bugs with pcon refilling and warning messages in chat
* [Fix] Minimap agent damaged modifier saves and loads correctly
* [Fix] Fixed some bugs related to item moves with ctrl and shift click
* [Fix] Fixed bug causing "move item to current storage pane" to store materials in material storage first
* [Fix] Fixed bug preventing mouse interaction on char select
* [Fix] Fixed bugs with objective timer showing wrong start time for runs

## Version 5.7

* [Fix] Fixed crashing related to stack overflow issues on string decoding
* [Fix] Fixed bug causing wrong outpost teleport when clicking some EotN vanquish icons in completion window
* [Fix] Fixed bug causing crash for players who had a character without any skills (e.g. expired trial account)
* [Fix] Fixed bug causing pcons to refill when disabled

## Version 5.6

* [Minor] Hide pointless quest marker for zaishen scout in all outposts
* [Minor] Renamed Missions window to Completion window
* [New] "Enter new stack size" prompt is now shown when ctrl + shift clicking an item in inventory/chest
* [New] Prophecies/Factions dupe skills are checked and swapped in when loading a skillbar
* [New] Kurzick/Luxon skills are checked and swapped in when loading a skillbar based on title progress
* [New] Added PvE skill tracker to Completion window
* [New] Added Elite skill tracker to Completion window
* [New] Added extra context menu option to withdraw or store all of the same item
* [New] Disable hotkeys on pvp characters by default; added a tickbox to re-enable a hotkey when playing a pvp only
  character
* [New] Added `/toggle` command as a shortcut to `/hide` or `/show` depending on UI
* [New] Added `/toggle helm, custome, costume_head, cape`
* [New] Added `/pcons refill` and `/pcons refill <pcon_name>`
* [New] Added `/target [name|model_id] [index]` to target nth NPC by name or model_id oin distance order
* [Fix] Fixed ctrl + shift + h and shoft + print scrn not hiding toolbox UI
* [Fix] Fixed crashing on character select, map load, and talking to NPCs for some clients
* [Fix] Fixed bug causing `/target` command to target dead NPCs
* [Fix] Fixed bug when using `/target` to target signposts

## Version 5.5

* [Fix] Removed unusable settings for world map widget
* [Fix] Enabled mission window module for release
* [Fix] Fixed jittery movement when camera smoothing is disabled
* [Fix] Fixed bug in toolbox settings related to controls sharing the same ID

## Version 5.4

* [Minor] Don't credit NPC kills in observer module
* [Minor] Added option to show distance widget in percentage and/or absolute value
* [Minor] Added option to show health widget in percentage and/or absolute value
* [Minor] Added extra check for aftercast when using equip item hotkey
* [Minor] Added support for french GWW when accessing wiki links
* [Minor] Added hint to in-game trader window for bulk buy/sell
* [New] Added `/target player [1-12|nearest|name]` command
* [New] Added `/target priority [1-12]` command
* [New] Extended `/target` command to allow partial NPC names instead of model id's e.g. `/target merchant`
* [New] Added `/target item [model_id|nearest|name]` command
* [New] Added custom name label color to minimap custom agents
* [New] `/wiki` command to redirect to `/wiki <current map name>` to make it actually useful
* [New] `/wiki quest` command to redirect to `/wiki <current quest name>`
* [New] `/wiki target` command to redirect to `/wiki <current target name>`
* [New] Extended equip item hotkey to choose specific items to equip instead of just by slot
* [New] Added "Show All Areas" and "Hard Mode" toggles to world map view
* [New] Added Missions module to track in-game vanquish/mission/dungeon progress
* [New] Added option to focus GW when toolbox is launched
* [New] Added option to copy a teambuild instead of having to recreate it manually
* [New] Dialog hotkey now opens dialog with the target NPC when triggered
* [New] Added option to color friend name tags differently when in an outpost
* [New] Added `/ping [build]` chat command
* [New] Added option to Ctrl + click a party member's damage in the damage monitor to print to chat
* [Fix] Fixed bug causing minimap to sometimes show dead enemies as still alive
* [Fix] Fixed bug causing item context menu wiki link to include item quantity when opening the website
* [Fix] Fixed some NPC dialogs still mentioning the player name when obfuscator is on

## Version 5.3

* [Fix] Fixed some map load crashes when using obfuscator
* [Fix] Fixed blank pcon icons caused by d3d errors loading from disk

## Version 5.1

Please note that a lot of changes have been made in this version in an effort to hide player names in-game in response
to the recent bans, so there may be bugs with it. Please raise an issue on GitHub or the Toolbox Discord if you find
one!

* [New] Obfuscate setting added to Game Settings to hide player name(s) in-game
* [Minor] Added option to disable Auto-cancel Unyielding Aura in Game Settings
* [Minor] Clicking wiki link in context menu whilst playing in German will load https://www.guildwiki.de/ instead
  of https://wiki.guildwars.com/
* [Minor] Further improvements to Observer windows
* [Fix] Fixed issues preventing resign log from working properly
* [Fix] Hotfixes for some players on 5.0

## Version 4.11

* [New] Observer module (and windows) added for pvp
* [Fix] Fixed bugs after GW update 37121
* [Fix] Fixed crashing issues from 4.10

## Version 4.9

* [Minor] Added option to disable right click context menu in outpost/explorable
* [Minor] Added option to disable wiki link on context menu
* [Minor] Tweak info window to show relative speed of an agent
* [Fix] Fixed ctrl+click not storing in current storage pane if set
* [Fix] Fixed foundry room 4 not being triggered in objective timer
* [Fix] Fixed exhaustion room not being triggered in Urgoz' Warren
* [Fix] Fixed crashes when using /tell, /whisper, /t and /w
* [Fix] Fixed GWToolbox not working after GW update 37112

## Version 4.8

* [New] Added "Seek Party" to top of trade window when in Kamadan to avoid having to use party search window to buy/sell
* [New] Right click context menu for materials shows option to store all into chest
* [New] Added context menu option to store all materials, tomes and upgrade mods when right clicking those item types
* [New] Added context menu option to go to Guild Wars Wiki on right click
* [New] Added chat filter for player item pickup and salvage messages
* [New] Automatically cancel UA if already maintained when recasting
* [Minor] Added option to disable item sparkles without texmod
* [Minor] Double clicking an item in chest whilst trading now automatically withdraws it into inventory
* [Minor] `/useskill` limited to 1 skill instead of being able to chain skills.
* [Minor] Clicking on your status on the friend list widget will change it in-game
* [Fix] Fixed issue preventing some DoA objectives not being flagged as done when a run is completed.
* [Fix] Fixed bugs related to printing timestamps on objective timer window
* [Fix] Fixed occasional rupt/energy waste when using move-to-cast
* [Fix] Fixed bug preventing GWToolbox from closing gracefully when closing GW window
* [Fix] Fixed right click not always working when clicking on an item
* [Fix] Fixed bug that showed the bulk buy option when using materials window whilst ctrl is held

## Version 4.7.1

* [New] Double click to send items to trade window when trade is open; works with material storage and chest items
  without having to withdraw them
* [New] Added option to move entire stacks to trade window by default
* [New] Ctrl + click working on material storage pane
* [New] Added option to block animations for bottle rockets, party poppers, transmogs, snowmen and sweet points
* [New] Right click context menu for materials shows option to store all into chest
* [Minor] Taking a screenshot in-game will copy to clipboard
* [Minor] Screenshot filename in chat opens the screenshot directory
* [Minor] Hide toolbox on world map
* [Minor] Added setting to set default minimap agent shape
* [Minor] Added Select All" to salvage dialog
* [Minor] Removed URL for daily quests from chat window
* [Minor] Right clicking items also opens context menu
* [Fix] Fixed a bug preventing toolbox from reacting to window focussing mouse click
* [Fix] Fixed bug preventing `/tp kama ae1` from travelling to district 1
* [Fix] Fixed bug causing objectives to start before timer was reset

## Version 4.6

* [New] Added `/herobuild` command to load hero teambuild
* [New] Timer improvements and new options.
* [Fix] Fixed a crash bug with the objective timer in Deep

## Version 4.5

* [Fix] Fixed a crash issue with withdrawing gold from chest
* [Fix] Fixed some issues with the objective timer
* [Fix] Fixed some issues with `/reinvite`

## Version 4.4

* [New] Timer and objective timer now tracks real-time since (first) loading screen. Added options to have the old
  behavior.
* [New] Added more detailed timers for DoA in the objective timer.
* [New] Added option to hide player speech bubbles
* [New] Added /reinvite command - use when targetting someone in your party window to reinvite player/hero/henchman
* [New] Added instance type option for hotkeys (explorable/outpost)
* [New] Added option to block messages from chat channels that you have turned off in-game
* [New] QoL fix to allow hero flagging hotkeys even if you have GW compass disabled
* [New] Added option to attach bond monitor to party window to avoid having to move/resize it manually
* [New] Added option to attach damage monitor to party window to avoid having to move/resize it manually
* [New] Added option to attach skillbar widget to skillbar to avoid having to move/resize it manually
* [Minor] Ctrl + click from storage to inventory tops up any existing stack instead of moving entire stack
* [Fix] Fixed bug preventing chat filter form blocking some player title achievement messages
* [Fix] Fixed bug with flagging hotkeys/buttons not working properly after an initial flagging action

## Version 4.3

* [New] GWToolbox now saves ImGui window positions into Layouts.ini - if you bork up your window size, just "Load Now"
  to fix it
* [New] Target nearest item (default `;`) will avoid targeting a chest if there are non-green assigned items next to it
* [New] Added more visibiltiy over GW's "Auto target ID" - minimap highlights friendly NPCs, items and gadgets to show
  what pressing space will do
* [Minor] Added `/tick` command
* [Minor] Stopped enhanced move-to-cast from double-calling a target
* [Minor] Lockpicks are now identified as "rare" items for purposes of the chat filters
* [Minor] Removed hint text relating to being able to `/salvage all`, as this no longer works
* [Minor] Added "Load Defaults" for minimap settings that didn't have any
* [Minor] Reverse camera button also reverses minimap
* [Minor] Fixed an issue stopping toolbox from storing full item stacks with ctrl-click when the stack is split across
  more than 1 receiving slot
* [Fix] Fixed twitch emotes causing crash
* [Fix] Fixed hero flagging not always working
* [Fix] Re-enabled tick as toggle
* [Fix] Fixed issues with certain alcohol types not triggering alcohol timer correctly
* [Fix] Fixed issue with friend list widget layout when viewing more than 1 column on-screen
* [Fix] Fixed crash when using enhanced move-to-cast just as an enemy (or ally) becomes untargetable
* [Fix] Fixed bug causing windows to open only partially on-screen for the first time due to recent ImGui update
* [Fix] GWToolbox.exe 2.1.0.0 no longer shows console on-screen when launching

## Version 4.2

* [New] Support for multi-column skillbar layouts in the skillbar widget
* [New] Modified launcher to show available GW instances that don't have a character name but do have an email address (
  e.g. login window)
* [Minor] Fixed slow map load times due to new icons
* [Minor] Changed look and feel of nested dropdowns to make them easier to click on
* [Minor] Changed ordering of "enabled features" in settings window
* [Minor] Revisited skillbar widget settings
* [Minor] All color picker swatches now also display transparency alpha channel
* [Minor] Flag All option now available if you're able to control the heroes/henchmen of a disconnected party member
* [Fix] Fixed not being able to move around when camera is unlocked and camera smoothing is disabled
* [Fix] Fixed bug with effects lasting > 180 seconds now showing duration on effect monitor
* [Fix] Fixed various issues relating to flagging heroes in minimap
* [Fix] Fixed some missing window options for Trade Window
* [Fix] Fixed potential crashes in health widget and travel widget relating to fetching map names
* [Fix] Re-fixed click to move on minimap when autorunning after recent GW update
* [Fix] Fixed issue with alcohol not being popped at the right time
* [Fix] Fixed bug preventing hero flagging when observing another player whilst dead

## Version 4.1

* [Fix] Fixed GWToolbox not working for Windows 7/8 users
* [Fix] Fixed wrong character name in window title
* [Fix] Re-fixed click to move on minimap when autorunning after recent GW update
* [Fix] Fixed wrong icon for faction leaderboard in toolbox main window
* [Fix] Fixed "Hello (null)!" message when starting toolbox without being in a map

## Version 4.0

* [New] Added option to improve move-to-cast to better avoid getting aggro when auto-moving to cast range for a spell
* [New] Updated icons for all widgets and windows
* [New] Configurable minimap range circle thickness
* [New] Minimap can now be toggled between square and circular (default circular)
* [New] Added skillbar timer widget, shows time until skill is recharged in an overlay, among other things
* [New] Added `/hero <attack|guard|avoid>` command
* [New] Added hero flagging hotkey - allows hero formations
* [New] Added res aggro and chain aggro ranges to minimap
* [New] Added whisper redirect for all players, not just friends
* [New] Extended `/enter` chat command to trigger challenge mission entries, option to cancel during a countdown
* [New] Hero builds not include option to show/hide hero panel, and change behaviour on load
* [New] Added `/tp <window_name> [hide|show|mini|maxi]` command
* [New] Added option to disable/enable camera smoothing in-game
* [New] Added option to disable/enable minimap smoothing to match compass smoothing
* [New] Added custom polygon option to minimap, with option to color enemies within the polygon differently
* [New] Added `/tb save` and `/tb load`
* [New] Added Teamspeak module, `/ts` to send connected server info to chat
* [Minor] Better crash reporting with issues related to ImGui
* [Minor] Added item model_id to info window
* [Minor] Added tick toggle hotkey
* [Minor] Added background color option to minimap
* [Minor] Re-added configurable modifiers for minimap clicks (e.g. change ctrl + click behaviour)
* [Minor] Prevent weapon set items from being auto salvaged via context menu
* [Minor] Switched project to use CMake for development
* [Minor] Typo fixes
* [Minor] Added Ben Wolfson to special NPC list
* [Minor] Deferred option loading for objective timer and friend list to avoid slow toolbox start time
* [Minor] Disable `/resignlog` in an outpost
* [Minor] Minimap now responds to compass flagging
* [Minor] Added option to consider materials in storage when buying materials for cons via Materials Window
* [Fix] Fixed crash with alcohol widget if no alcohol has ever been used
* [Fix] Fixed bug preventing bond widget showing on screen if effect array is empty
* [Fix] Fixed infinite loop when trying to update toolbox causing crash on closing GW
* [Fix] Fixed a bunch of settings not being loaded/saved correctly
* [Fix] Fixed bug causing minimap to highlight BigCircle agents
* [Fix] Fixed `/tp deep` and `/tp urgoz` not working when in an explorable with disconnected players
* [Fix] Fixed issue preventing toolbox from loading if Font.ttf is not found
* [Fix] Fixed a crash caused by damage monitor when target isn't found in memory
* [Fix] Fixed minimap click-to-move and move hotkeys from working correctly whilst auto running
* [Fix] Fixed Pahnai salad triggering alcohol timer
* [Fix] Fixed discord status updating with wrong character when viewing another party member whilst dead
* [Fix] Fixed issues sending and receiving Twitch messages in chat with `<` and `>` characters
* [Fix] Fixed bond monitor showing bonds on your player that you didn't cast
* [Fix] Fixed a crash when trying to travel to embark beach without it unlocked via `/tp` command

## Version 3.8.1

* [New] Added DoA cave timer to timer widget
* [Minor] Removed salvage/identify chat commands
* [Minor] Hotkeys will now only trigger if GW window is in focus
* [Minor] Some chat commands will now only trigger if GW window is in focus
* [Minor] Hide bonds widget when no relevent skill is equipped
* [Minor] Added Toolbox version information to DLL properties
* [Minor] Modified runtime assertions to crash and create a minidump
* [Fix] Fixed bug causing Toolbox to set window title even if the setting was off
* [Fix] Fixed bug showing resizable option for damage monitor
* [Fix] Fixed bug preventing minimap hero flagging when mouse clickthrough is enabled
* [Fix] Fixed flickering minimap drawings when timeout is reached
* [Fix] Fixed potential crash when viewing advanced item info in InfoWindow
* [Fix] Fixed buffer overflow crash when moving district in Deep/Urgoz
* [Fix] Fixed crash when closing Guild Wars in Windows 8

## Version 3.7

* [Fix] Fixed bug preventing materials from being ctrl+clicked to store when storage is > 250
* [Fix] Fixed crashes when using `/useskill`
* [Fix] Fixed crashes when observing PvP matches
* [Fix] Fixed crash when entering Slavers' Exile dungeon
* [Minor] Added `/tp kc` for Kaineng Center

## Version 3.6

* [New] Added dungeons to objective timer
* [New] Added refrains to bond monitor
* [New] Added wiki buttons to items in the salvage window
* [New] Added auto-target highlighting to toolbox minimap when no current target is selected
* [New] Added option to show/hide hero panels when loading hero builds
* [New] Added Signpost and Item targeting to target hotkey
* [New] Added `/target item 123`, `/target gadget 123`, `/target 123` commands
* [New] Added option to hide build window(s) when entering an explorable area
* [New] Added option to hide settings when entering an explorable area
* [New] Added option to only show 1 teambuild at a time
* [New] Added options to hide dungeon chest popup
* [New] Added option to stop screen shake on environmental effects or skills like Aftershock
* [Minor] Crash dumps now write to /crashes folder
* [Minor] Added scroll icon to Urgoz/Deep in Travel window
* [Minor] Don't maintain Trade chat connection if trade channel is turned off in-game
* [Minor] Disable native chat timestamps in-game if toolbox timestamps are enabled
* [Fix] Fixed layout bugs with Twitch module
* [Fix] Fixed bug preventing zooming out when in first person view
* [Fix] Crash/disconnect when trying to close GWToolbox when minimap is enabled
* [Fix] Fixed bug when using `/tp` to go to the wilds
* [Fix] Fixed builds not loading correctly on heros when loading from Hero Builds window
* [Fix] Fixed `Show past runs` not loading setting from file
* [Fix] Fixed crash when triggering drop/use buff hotkey via UI
* [Fix] Fixed crash when triggering open xunlai chest hotkey via UI
* [Fix] Ensure Toolbox window is visible on first run
* [Fix] Fixed quantity calculation bug when buying Res scrolls via Materials window
* [Fix] Fixed zero health bug on some mobs caused by a bug in Party Window module
* [Fix] Fixed bug preventing "show close button" settings from being available for tb windows
* [Fix] Ignore perfect salvage kits when using the salvage feature

## Version 3.4.2

* [Fix] Reverted custom markers appearing in outposts. Fault Misty.

## Version 3.4

* [New] Changed all color inputs to use a slightly different control; now able to click on the color swatch to choose
  instead of inputting RGBA manually
* [New] Added available dialog IDs to dialog section of info window when talking to an NPC
* [New] Added color thresholds to health widget and distance widget
* [New] Modified/tidied up "Settings" window to make stuff easier to find, see following changes:
* [Minor] Merged "Chat Filter" section into "Chat Settings" section
* [Minor] Merged "Inventory Management" section into "Inventory Settings" section
* [Minor] Merged "Toolbox" section into "Toolbox Settings" section
* [Minor] Merged "Party Window" section into "Party Settings" section
* [Minor] Moved party related function from "Game Settings" into "Party Settings"
* [Minor] Copied lunar and alcohol related settings from "Pcons" into "Game Settings"
* [Minor] Moved chat related options from "Game Settings" into "Chat Settings"
* [Minor] Merged "Discord" and "Twitch" sections into "Third Party Integration" section
* [Minor] Alphabetised all window and widget sections inside "Settings" window
* [Minor] Alphabetised all module checkboxes inside "Toolbox Settings" section, set into columns to better use space
* [Minor] Moved inventory related options from "Game Settings" into "Inventory Settings"
* [Minor] Added chat filter checkbox for "Not enough energy/adrenaline" messages
* [Fix] Fixed bug preventing "show enable" pcons button to load setting from file
* [Fix] Fixed bug preventing custom minimap markers in outposts
* [Fix] Fixed potential crash when cancelling salvage process
* [Fix] Fixed trophies not appearing as salvage options
* [Fix] Fixed bug preventing hero builds being sent to chat in explorable areas
* [Fix] Fixed a bug causing alcohol to be spammed when the alcohol widget is disabled in toolbox

## Version 3.2

* [New] Added DirectX distributable check inside GWToolbox at runtime; will now display a message with a link to the
  DirectX download page instead of just not launching at all.
* [New] Added option to hide bond monitor in outpost (default showing)
* [New] Added option to save objective timer runs to disk (default save)
* [New] Added option to hide date/time of objective timer runs (default hidden)
* [New] Added option to hide runs from previous days (default hidden)
* [Minor] Don't maintain Trade Chat websocket connection when the window is collapsed
* [Minor] Objective timer runs now save to `%localappdata%/GWToolboxpp/runs` to avoid cluttering the main folder
* [Minor] Added option to only use superior salvage kits when using `/salvage` command
* [Minor] Added on-hover item descriptions to "Salvage all?" dialog
* [Minor] Removed extra new line when `/tp` error message is displayed in chat
* [Minor] Fixed a display bug in minimap aor effect colors showing as RGBA instead of ARGB
* [Minor] Don't print target hotkey to emote chat by default
* [Minor] Removed option to swap functionality of Ctrl + Click on minimap; caused issues when shift was held
* [Minor] Disable Pcons on map change set to off by default
* [Minor] Pcon refillers hidden by default
* [Minor] Added option to hide city pcons in explorable areas (default visible)
* [Minor] Removed DoA snakes from default party window NPCs
* [Fix] Re-added in-game option to manually check for updates
* [Fix] Fixed `auto age2 on /age` setting being the same as `auto /age2 on vanquish` setting
* [Fix] Fixed bug causing salvage all process to only salvage the first item in a stack
* [Fix] Fixed bug causing identify blue/purple/gold to identify other rarities
* [Fix] Fixed bug causing salvage all crash when inventory is full
* [Fix] Fixed bug causing salvage all to identify unsalvagable trophies as salvagable
* [Fix] Fixed potential crash when displaying the "Salvage all?" dialog
* [Fix] Fixed crash when adding a new custom minimap agent whilst the matching NPC is within range.
* [Fix] Fixed IRC timeout after 3 minutes when connected to Twitch

## Version 3.1

* [Fix] Fix bug where the launcher would ask everytime to download the toolbox.

## Version 3.0

* [New] Merged [3vcloud](https://github.com/3vcloud) fork and added him as maintainer to GWToolbox. The following
  changes are made to GWToolbox.
* [New] `/loadbuild` command added, allows player to load builds from the GWToolbox Builds window by name or build code.
  See help section of GWToolbox in-game for more info.
* [New] `/pingitem` command added, allows player to ping any currently equipped item. See help section of GWToolbox
  in-game for more info.
* [New] `/transmo` command updated to allow players to transform into a list of pre-defined NPCs by name instead of just
  the one target. "/transmo reset" will remove the current NPC skin on the player. See help section of GWToolbox in-game
  for more info.
* [New] `/transmoparty` command added, similar syntax to `/transmo`.
* [New] `/transmotarget` command added, similar syntax to `/transmo`.
* [New] `/dance` adds Collector's Edition glow to player hands.
* [New] `/dancenew` on Factions/NF professions shows Collector's Edition dance emote instead of standard one.
* [New] Added "Check for Updates" button to Toolbox Settings section. If enabled, it will auto-check every 10 minutes
  instead of just the first load.
* [New] Added "Emotes" and "Other" to Chat Colors section of Game Settings.
* [New] Added "show alias on whisper" to Friend List window, adds player alias in brackets when sending or receiving a
  whisper (default false).
* [New] Added "You gain x faction" chat filter option.
* [New] Added `/addfriend <character_name>` and `/removefriend <character_name|alias>` chat commands.
* [New] Added `/online`, `/away`, `/busy`, `/dnd`, `/offline` chat commands - see Help section for details.
* [New] Added `/target hos` and `/target ee` commands, see help section for info.
* [New] Added 24h Deep module - use /deep24h command to toggle.
* [New] Added `/identify all`, `/identify blue`, `/identify purple`, `/identify gold` chat commands.
* [New] Added `/pc <search_term>` chat command to do a price check from chat.
* [New] Added `/salvage all`, `/salvage blue`, `/salvage purple` chat commands.
* [New] Added ability to view a player's guild info via Target section of Info Window.
* [New] Added AoE circles for Maelstrom, Chaos storm, Lava font, Savannah heat, Breath of fire, Bed of coals, Churning
  earth.
* [New] Added auto-accept party invites when ticked option for faster party reorder.
* [New] Added auto-accept party join requests when ticked option for faster party reorder.
* [New] Added boss by profession color to Minimap.
* [New] Added challenge mission chat filter option.
* [New] Added ctrl + click context menu to Salvage and ID kits - allows user to salvage/identify groups of items at
  once.
* [New] Added Flame Trap, Spike Trap and Barbed Trap to aoe effects on minimap.
* [New] Added option in Game Settings to change Guild Wars window title to name of current character.
* [New] Added option to add player number to player names in explorable areas.
* [New] Added option to hide bonds, health, party damage and instance timer widgets in outpost.
* [New] Added option to show hidden NPCs on Minimap.
* [New] Added option to skip entering character name when donating faction.
* [New] Added option to trigger a hotkey on entering explorable/outpost.
* [New] Added pcons per character option, default turned on.
* [New] Added pcons to GWToolbox Builds window; pcons can now be assigned to a particular build and auto-enabled when
  loaded.
* [New] Added seconds to the clock widget.
* [New] Added spirit timers to Timer widget; default is EoE and QZ. Other spirit timers available in settings.
* [New] Automatic `/age` on vanquish option.
* [New] Automatic `/age2` on `/age` option.
* [New] Better crash handling; more GWToolbox related crashes will be caught and dumped in the GWToolboxpp folder, and
  will show a message on-screen.
* [New] Ctrl + enter to whisper targeted player.
* [New] Friend List window/module added.
* [New] Modified trade alerts; added option to only show trade alerts in chat when in Kamadan ae1.
* [New] Objective timer now saves runs to disk in json format, and auto-collapses previous runs when a new one starts.
* [New] Support for Chinese character set; add "Font_ChineseTraditional.ttf" to GWToolboxpp folder to load
  automatically.
* [New] Support for Japanese character set; add "Font_Japanese.ttf" to GWToolboxpp folder to load automatically.
* [New] Support for Korean character set; add "Font_Korean.ttf" to GWToolboxpp folder to load automatically.
* [New] Support for Russian character set; add "Font_Cyrillic.ttf" to GWToolboxpp folder to load automatically.
* [New] Trade Window changes: removed dependency on kamadan.decltype.org - players can now use this window as normal
  when in Kamadan ae1 even if decltype.org stops working.
* [New] Trade window now uses [https://kamadan.gwtoolbox.com](https://kamadan.gwtoolbox.com) for incoming trade chat.
  Rebased this module to be similar to vanilla.
* [New] Updater module re-enabled; will now give update notifications for this version of toolbox.
* [Minor] `/tb <window_name>` now matches partial window names.
* [Minor] `/tp gh` and `/gh` now check whether you're already in GH before leaving/entering as applicable.
* [Minor] Added "morah" and "surmia" `/tp` commands.
* [Minor] Added client-side checks before trying to travel e.g. same district, to avoid the need for packet sending.
* [Minor] Added current online status to top of friend list.
* [Minor] Added daily quest chat command help section.
* [Minor] Added date/time to headers in Objective timer, and [Failed] to identify failed runs.
* [Minor] Added debug info about current camera position to info window.
* [Minor] Added option to hide friends list when in outpost/explorable.
* [Minor] Added option to only show alcohol widget when using alcohol.
* [Minor] Added option to toggle ctrl + click functionality on minimap. (e.g. ctrl + click to ping, click to target)
* [Minor] Changed `/pingitem` and `/armor` descriptions to include armor rating, infused and +1 stacking attribute if
  applicable.
* [Minor] Fixed `/tp` errors not always displaying on-screen.
* [Minor] Fixed a bug causing some trade messages to be blocked in Kamadan when filtered using the trade window.
* [Minor] Friend list is now amended when saved, not overwritten. This allows multiple accounts to maintain details
  about mutual friends.
* [Minor] Hide `/deep24h` setting from settings window when not enabled.
* [Minor] Performance tweaks and housekeeping for chat filters.
* [Minor] Performance tweaks to resign log and trade window, removed some redundant code blocks.
* [Minor] Remove "I'm wielding" text when pinging weapons with GWToolbox.
* [Minor] Removed "n platinum, n gold" from pinged item descriptions.
* [Minor] Removed armor descriptions when using `/pingitem` command. Will add headpiece +1 info in a later release.
* [Minor] Removed threading code from Friend list, a bit more stable now.
* [Minor] Removed threading code with refilling pcons, a bit more stable now.
* [Minor] Reverted Trade Window to vanilla 2.27. Tweaks to layout widths, fixed bug when trying to whisper player's with
  unicode chars in their name.
* [Minor] Stability changes and shutdown fixes.
* [Minor] Stability/failover changes for Updater module. Will update current dll wherever it is on disk, not just from
  GWToolboxpp folder.
* [Fix] Adjusted AoE range for churning earth from adjacent to nearby.
* [Fix] Fixed a crash when trying to click on Minimap whilst observing PvP matches.
* [Fix] Fixed an issue that didn't do a fresh reload from ini file when clicking "Load Now" in tb settings.
* [Fix] Fixed issues with loading and saving to file.
* [Fix] Fixed trade alerts by regex not working.
* [Fix] Fixes resign log not working when player numbers are turned on in an explorable area.
* [Fix] Reduced flashing GW window spam when being invited to a party.

## Version 2.35

* [Fix] Fixes following April 22 update.

## Version 2.34

* [Fix] Fix crashes with enemies count in info window.

## Version 2.33

* [Fix] Fix crashes when trying to drop gold coins.
* [Fix] Fix a long due bug that caused random crashes, often when using the minimap.

## Version 2.32

* [Fix] Fix crashes caused because of bad header values.

## Version 2.31

* [Fix] Fixes following February 14 update.

## Version 2.30

* [Fix] Fix bug with launcher asking to download every time.
* [Fix] Main window options are now accessible again.
* [Fix] Fixed crash dump generation.

## Version 2.29

* [New] Added Discord 'Rich Presence' integration.
* [Fix] Fixes following December 13th update.
* [Fix] Pcons are not used in cinematic anymore.
* [Minor] Minor improvements to `/tp <town name>` command.
* [Minor] Guild Wars will ask permission to travel when in a group with other players.
* [Minor] Vanquish Widget can now be ctrl+clicked to print the vanquish information to group chat.
* [Minor] Now, '/resignlog' only prints name of players who didn't resigned yet.

## Version 2.27

* [New] Added support for adrenaline skill with /useskill command.
* [New] Added /resignlog command.
* [New] You can now use the command /tp and /to with the prefix of an outpost to teleport to the outpost.
* [Fix] Reduced the connection spams to kamadan.decltype.org when the site is down.
* [Fix] Fixed bug when game process name wasn't "Gw.exe".
* [Fix] Fixed bug related to player status introduced in recent game update.
* [Minor] Several improvements in GWCA and updated 3rd party libraries.

## Version 2.26

* [Fix] Fixed bug with friend status message.

## Version 2.25

* [New] Added option to disable minimap mouse capture in outpost.
* [Fix] Fixed bugs related to GW June 12th update.

## Version 2.24

* [Fix] Fixed several crash bugs related to GW May 1st update.
* [Note] Toolbox borderless functionality is current disabled. It might be fixed or removed in the future. For now,
  please use the in-game borderless that you can find in GW Options -> Graphics -> Resolution.

## Version 2.23

* [New] Added an option to disable the prompt when selling green and gold items.
* [New] Added an option to show a notification when a friend comes online or goes offline.
* [Fix] Fixed ctrl+click with new storage panels.
* [Fix] Fixed bug when selling rare materials with a quantity smaller than 10.
* [Minor] Extended `/flag` command to flag at a given coordinate.
* [Minor] Added more bosses to the minimap.
* [Minor] Added map ids of the event versions of Kamadan to disable the trade chat.

## Version 2.22.1

* [Fix] Material buying and auto-manage gold

## Version 2.22

* [Fix] General fixes for the February 5th update.
* [Fix] Pcons not finding proper quantities
* [Fix] Ctrl+Click storage/inventory item quick-move

## Version 2.21

* [Fix] Added Year of the Pig lunars to lunar pop list.
* [New] Added an option to ctrl+click on target health (widget) to print it.

## Version 2.20

* [Fix] Fixed a bug with the bond monitor.
* [New] The old `click to use` option in bond monitor is now split into `click to cast` and `click to drop`.
* [New] `Item not found` message will now show in the Emotes chat channel.
* [New] `/afk` will now remove the message set by `/afk message`.
* [New] Added an option to not set normal or hard mode when loading hero builds.

## Version 2.19

* [New] Reapply Title hotkey now applies the appropriate title for the area, not just Lightbringer title.
* [New] Added an option to allow mouse clickthrough in the minimap.
* [New] Added an optional timer for dungeon traps.
* [Fix] Fixed a bug where toolbox would consider "Alt" key down after alt-tabbing.
* [Fix] Kegs now are correctly counted in the alcohol counter.
* [Fix] Quest marker animation now adapts to the framerate.
* [Fix] Removed Deep and Urgoz travel buttons, as they are not longer possible.
* [Fix] Fixed bug with bond monitor where it would not update to party size.
* [Fix] Fixed bug where Jora and Keiran were inversed in hero builds.

## Version 2.18

* [New] `/tb`, `/hide` and `/show` do not require quotes for windows with multiple names.
* [New] Added an option (in Game Settings) to only show non-learned skills when using a tome.
* [New] Added an afk message to `/afk <message>`. Toolbox will automatically reply with that message if you get PMd
  while afk.
* [New] Toolbox will now not render during cinematics.
* [New] Added an option to automatically skip cinematics.
* [New] Added an option to alt+click on the minimap to move to that location.
* [New] Added an option to reduce the visual impact in the minimap when agents get spam pinged.
* [New] Added an optional timer for Deep Aspects. You can enable it in Timer settings.
* [Fix] Fixed a bug where the bond monitor would not properly update the party size.
* [Fix] Fixed a bug where toolbox could only control 7 heroes.
* [Fix] Fixed the Dhuum start trigger in the Objective Timer.
* [Fix] Fixed bug where Recall line would not know where to go after your Recall target despawned.

## Version 2.17

* [New] Options to change game messages color. (Under GameSettings)
* [Fix] The "x" in Objective Timer will now delete the record.
* [Fix] Crash bug when zoning into an explorable.
* [Fix] Bug were Materials window wouldn't save his settings.
* [Minor] You can now choose which column to show in Objective Timer.

## Version 2.16

* [New] Objective timer for DoA, UW, FoW
* [New] Option to automatically withdraw and deposit gold while buying materials. (disable by default)
* [New] Option to ctrl+click on instance timer to `/age`. (disable by default)
* [New] Command `/resize width height` to resize Guild Wars window. (Only works with borderless)
* [Fix] Bug were GWToolbox UI was reseted when opening Guild Wars.
* [Fix] Materials window won't stop buying materials anymore.
* [Fix] Bug with "Tick is a toggle" that required a restart to work.
* [Fix] Bug where toolbox wouldn't get input if UI was disable.
* [Fix] "All flag" will be shown even if you only have henchmans in your group.
* [Minor] Chat timestamps will work for older messages. (pre-inject)
* [Minor] The real name of mercenary hero will be used in hero builds instead of "Mercenary Hero X".

## Version 2.15

* [Fix] Fixed toolbox functionality after June 07 2018 game update.
* [New] GWToolbox will hide itself if you hide the game user interface. Will also work with "Shift+Print Screen".
* [New] You can now send whisper with hotkeys. In the message text field use the format: ```<target name>,<message>```.

## Version 2.14

* [Fix] Fixed toolbox functionality after May 9 2018 game update.
* [Fix] Fixed bug with ctrl+click & dyes.

## Version 2.13

* [Fix] Fixed toolbox functionality after May 9 2018 game update.
* [New] The damage report will now print the names of the npcs.
* [Minor] You can now use iso alpha 2 country codes for district with the command `/tp`.
* [Minor] You can now target player with the command `/target "Player Name"`. (with quotes)

## Version 2.12.1

* [Fix] Removed Borderless Windowed mode, use official implementation instead :)
* [Fix] Fixed crash bug on toolbox start.

## Version 2.12

* [Fix] Fixed toolbox functionality after April 30 2018 game update.
* [New] Added an option in the chat filter to match messages with regular expressions.
* [New] Improved custom agent rendering functionality.
* [Fix] Empty lines in the chat filter will not ignore everything any more.

## Version 2.11

* [New] Added the option to set custom color for specific agents in the minimap.
* [Fix] Fixed toolbox functionality after April 23 2018 game update.
* [Fix] Improved overall robustness.
* [Fix] Improved ctrl+click (move items) behaviors.

## Version 2.10

* [Fix] Fixed toolbox functionality after April 2 2018 game update.

## Version 2.9

* [Fix] Fixed toolbox functionality after March 23 2018 game update.
* [New] Added a new Trade chat window containing Kamadan Trade Chat. Powered by `https://kamadan.decltype.org/`.
* [New] Added a Soul Tormentor counter to the Info window.
* [New] Improved camera unlock movement functionality and added an option to keep camera height fixed while moving.
* [New] Minimap targeting (Control+Click) now ignores all but the targetable minipets.
* [New] Added an option to move items to/from chest by Control+click.
* [New] Added an option to maintain `/cam fov` after a map change.
* [New] Each `/useskill` will now reset the skills to use, not add to the previous ones.
* [Fix] Fixed `/flag` functionality. Added `/flag all` and `/flag clear`.
* [Fix] Fixed a bug where hero flags would not show in the minimap. Reduced size of the circle of individual hero flag.
* [Fix] Fixed a bug where settings would not be loaded/saved properly on systems with a username containing non-standard
  characters.
* [Fix] Fixed a bug where pcons would sometimes not be used if the player had no other effects.
* [Fix] Fixed a crash bug when sending Hero Builds to <No Hero>.

## Version 2.8

* [Fix] Fixed a crash bug in the hero build window.

## Version 2.7

* [New] Can now omit the town in `/tp [town] [district] to change district.
* [Fix] Fixed the "Close other windows..." option.

## Version 2.6

* [New] You can now add or remove any window to the main toolbox window - check Settings -> Toolbox Settings.
* [New] Added a new Window to create and load hero team builds.
* [New] Added support for the new Lunars (year of the dog).
* [New] Added cursor fix: mouse should no longer jump between monitors when right clicking.
* [New] You can now use multiple skills with `/useskill`.
* [New] Added rings of fortune messages to the chat filter.
* [Fix] Alcohol monitor is now only visible in explorable areas.
* [Fix] You can now once again set up hotkeys on mouse buttons x1 and x2 (forward and back).
* [Fix] Fixed various small issues.

## Version 2.5

* [Fix] Fixed bug where toolbox window positions would reset when restoring from an alt-tabbed fullscreen GW.

## Version 2.4

* [Fix] Fixed bug where GW would freeze when launching Toolbox while in fullscreen mode.

## Version 2.3

* [New] Added `/load <build name>` command to load builds from your saved templates.
* [New] Added an option to display chat message timestamps.
* [New] Added an option to retain chat history after changing map.
* [New] Added an option to restore GW window from mimized state and bring to focus when zoning into explorables.
* [New] Added an alcohol duration widget.
* [Fix] Fixed several minor bugs.

## Version 2.2

* [New] You can now /tp gh [tag] to any guild in your alliance.
* [New] Added options to make Guild Wars flash in the taskbar when invited to a party or when your party zones.
* [New] Added options to automatically set away after a delay and/or online when back.
* [New] "Use item" hotkey can now use items from the chest in outposts.
* [Fix] VQ counter now only appears in areas that can be vanquished.
* [Fix] /tp fav now starts counting at 1 instead of 0.
* [Fix] Automatically changing URLs to templates now also works in PMs.
* [Fix] Fixed bug where hotkeys would not save properly.
* [Fix] Quest marker will now appear correctly on the minimap.
* [Fix] Fixed several typos and minor issues.

## Version 2.1

In this patch we change the update server to GitHub and fix minor bugs from 2.0 and add a Vanquish counter.

* [New] Toolbox can now self-update (or not). Check the options in Settings->Toolbox Settings
* [New] Added a vanquish counter
* [New] /scwiki now accepts parameters, (e.g. /scwiki doa)
* [New] you can now /tp fav to any number of favorites (e.g. /tp fav5).
* [New] Added an option to flash your guild wars taskbar when receiving a private message
* [New] Added an option to automatically add [;xx] to links you write in chat, but only if they are in their own
  message!
* [Fix] Custom dialog now works properly
* [Fix] Fixed several typos and minor issues

## Version 2.0 - New interface

* [New] Rewrote interface
* [New] Materials Panel
* [New] Chat filter by content
* [New] Custom Minimap markers
* [New] Can completely disable individual toolbox features
* [New] Clock
* [New] Notepad

## Version 1.11

* [Minor] Added support for Year of the Rooster Lunars
* [Minor] Added lunar usage messages to the chat filter
* [Minor] Added “No one hears you…” message to the chat filter
* [Fix] Improved precision of drawings and pings on the minimap
* [Fix] Improved rendering order in the minimap, players should now be more visible

## Version 1.10

* [Fix] Toolbox and timer now show on top and handle clicks on top of the minimap

## Version 1.9 – Minimap Update

**IMPORTANT:** GWToolbox does no longer support GWMultiLaunch. Using GWToolbox on clients launched by GWMultiLaunch will
probably cause crashes or unexpected behavior. Check https://github.com/GregLando113/gwlauncher/releases for an
alternative.

* [New] Added minimap, more info here: tools.fbgmguild.com/gwtoolbox/info/minimap/
* [Minor] Edit Build panel will save whether it’s moved on top or not
* [Minor] Toolbox will now wait for you to log in into a character, so it can be launched early with no issues.
* [New] Added a hotkey for reapplying Lightbringer title (Execute… hotkey)
* [Fix] Toolbox will not make you pm Toolbox when you press delete after a Toolbox message. Toolbox won’t mind the lack
  of pms, don’t worry.
* [Fix] Fixed some crash bugs

## Version 1.8

* [Fix] Fixed a crash bug related to Borderless Window

## Version 1.7

* [New] Added an option to turn Guild Wars into Borderless fullscreen window.
* [New] Added a simple /useskill command to use a skill on recharge.
* [New] Added an option to hide server chat spam such as item drop, pick-up, 9-rings spam and “skills updated to pvp”.
* [New] Added an option to enable or disable Toolbox adjusting widget positions on window resize.
* [Minor] General user interface improvements.
* [Minor] Target hotkey will not target dead agents anymore (e.g. a dead Boo).
* [Minor] Added a few known ferry dialogs.

## Version 1.6

* [Minor] Added support for Lunars [Year of the Monkey]

## Version 1.5

* [Fix] /tp to ae1, ee1 and eg1 will actually port to district 1
* [Fix] Fixed bug where tb would crash on initialization in char selection screen
* [Minor] increased coindrop interval to 500ms (from 400)

## Version 1.4

* [New] Added chat commands
* [New] Added an option to enable or disable opening of template links
* [New] The “Tick” functionality in the default party window now acts as a toggle
* [New] Implemented an anchor system. Toolbox windows will stick to left/center/right and top/center/bottom when gw
  window is resized. Added a setting to enable or disable this functionality.
* [Minor] Party damage window now works with heroes
* [Fix] Party damage window now ignores damage inflicted to allies (e.g. from Life Bond)
* [Fix] Toolbox now properly resize its drawing area after a gw window resize

## Version 1.3

* [Fix] Better fix on crash bug by toggling pcons on loading and char selection screen, added flag in launcher to check
  update messages

## Version 1.2

* [Fix] Fixed a problem with enabling pcons while on a loading screen crashing the client

## Version 1.1

* [New] Toolbox will now detect GWA2 on launch and notify the user instead of crashing the client
* [Fix] Fixed bug where toolbox would not save an empty build or template

## Version 1.0

First GWToolbox++ Release! Rewrote Toolbox from AutoIt to C++ with in-game rendering. Reimplemented most existing
features with several improvements.

* [New] Pcons
* [New] Hotkeys
* [New] Builds
* [New] Fast Travel
* [New] Dialogs
* [New] Info, Distance, Health, Timer

---

# Credits

Source: https://www.gwtoolbox.com/docs/credits/

**[HasKha](https://github.com/HasKha)**
* Original creator of GWToolbox++.

**[KAOS](https://github.com/GregLando113)**
* Original creator of the GW API used, reverse engineering work.
* Several minor additions.

**[Ziox](https://github.com/reduf)**
* Implementation of the vast majority of the chat-based features, such as custom chats and the chat timestamps.
* Major contributor to the GW API used, reverse engineering work.

**[Jon](https://github.com/3vcloud)**
* Implemented many new features and improvements.
* Major contributor to the GW API used, reverse engineering work.
* Current maintainer of the project.

**[Marc](https://github.com/henderkes)**
* Implemented many new features and improvements.
* Code quality improvements.

**Itecka**
* Original creator of a damage monitor, which inspired the toolbox damage monitor.
* Created the original implementation of the Cursor Fix.

**[Misty](https://github.com/Hour-of-the-Owl) / [DarkManic](https://github.com/DarkManic)**
* Extensive work on the site and documentation.

**Everyone who [proposed a PR](https://github.com/gwdevhub/GWToolboxpp/pulls?q=is%3Apr+is%3Amerged)**

**and everyone suggesting ideas!**

All images in `resources/icons` are from [flaticon.com](https://www.flaticon.com).

## Sponsors

<p>
  <img src="https://resources.jetbrains.com/storage/products/company/brand/logos/jb_beam.png" alt="JetBrains Logo" width="96" />
</p>

**[JetBrains](https://github.com/JetBrains)** provides core contributors with [OSS Development Licenses](https://www.jetbrains.com/community/opensource).

---

# Donate

Source: https://www.gwtoolbox.com/docs/donate/

GWToolbox++ — together with the [LFG board](https://lfg.gwtoolbox.com/),
the free [text-to-speech API](https://tts.gwtoolbox.com/), and the
[Kamadan](https://kamadan.gwtoolbox.com/) and
[Ascalon](https://ascalon.gwtoolbox.com/) trade-chat archives — is built and
run by a handful of volunteers in their spare time. There is no company
behind any of it; nobody is paid; nothing is monetised inside the game.

What that means in practice:

* **Servers cost money.** The LFG board, the trade archives, and the TTS
  API all run on small VPSes that someone is paying for out of pocket each
  month. The same goes for the build infrastructure that turns each
  commit into a signed Toolbox release.
* **Time is the bottleneck.** Reverse-engineering the Guild Wars client,
  porting features as new patches land, and answering bug reports happens
  on evenings and weekends. New features land when one of the maintainers
  has a quiet night to write them.

If GWToolbox or any of the related tools has been useful to you and you
would like to chip in, the project is on Open Collective:

<p style="margin: 1.5rem 0;">
  <a href="https://opencollective.com/gwdevhub_collective"
     target="_blank"
     rel="noopener">
    https://opencollective.com/gwdevhub_collective
  </a>
</p>

Open Collective is a transparent funding platform — every contribution is
public and every expense the project pays for (server bills, domain
renewals, code-signing certificates) is itemised on the same page, so you
can see exactly where the money goes.

Donations are entirely voluntary and have **no effect** on what features
land in Toolbox, what gets prioritised in the bug tracker, or how anyone
in the Discord is treated. Reporting a good bug, contributing a fix, or
helping someone in `#help` is just as valuable.

Thanks for using the tools.

---

# Windows

Source: https://www.gwtoolbox.com/docs/windows/

Unlike [Widgets](/docs/widgets/), windows are designed to be opened when needed, and hidden when not in use.

All windows have options in [Settings](/docs/settings/) to specify the exact co-ordinates of their on-screen position, prevent the window from being moved around or re-sized, and to remove the close button.

## General Interface
* `Double click` on the title bar to collapse a window.
* Click and drag on the lower right corner to re-size a window.
* Click and drag on any empty space to move a window.
* `Mouse wheel` to scroll.
* `TAB`/`SHIFT+TAB` to cycle through keyboard editable fields.
* `Ctrl+Click` on a slider or drag box to input text. You can also `double click` on a drag box.
* While editing text:
  * Hold `SHIFT` or use mouse to select text.
  * `Ctrl+Left/Right` to word jump.
  * `Ctrl+A` or `double click` to select all.
  * `Ctrl+X`, `Ctrl+C`, `Ctrl+V` clipboard.
  * `Ctrl+Z`, `Ctrl+Y` undo/redo.
  * `ESCAPE` to revert.
  * You can apply arithmetic operators `+`, `*`, `/` on numerical values. Use `+-` to subtract.
  
## Opening and closing windows
There are several ways to open and close windows:
* Buttons in the main window.
* Checkboxes in the right of each header on [Settings](/docs/settings/).
* Chat command `/hide (name of window)`.
* Chat command `/show (name of window)`.
* Chat command `/tb (name of window)` to toggle show/hide.
* The close button on the top right of each window.

## Toolbox window
The main Toolbox window contains the buttons to open each of the other windows (except the notepad), and a button to activate/de-activate auto pcons.

The close button on the top-right of the main window closes the whole of Toolbox.

## Pcons ([more info](/docs/pcons/))
Automatically pops cons and pcons.

## Hotkeys ([more info](/docs/hotkeys/))
Sets up hotkeys for various Toolbox functions.

## Builds ([more info](/docs/builds/))
Sends team builds to party chat.

## Travel ([more info](/docs/travel/))
Fast travel to any outpost in the game.

## Info ([more info](/docs/info/))
Displays various pieces of useful information.

## Materials ([more info](/docs/materials/))
Automatically buys materials from the trader.

## Settings ([more info](/docs/settings/))
All Toolbox settings can be found here.

## Notepad
The notepad is just a space where you can write (or copy/paste) anything you want, such as complicated instructions to remember. Anything you write will still be there when you restart Toolbox or Guild Wars.

---

# Builds

Source: https://www.gwtoolbox.com/docs/builds/

<figure>
<img src="/docs-images/z6kp0v1.webp"/>
<figcaption>Edit Teambuild Window</figcaption>
</figure>

Open from `Toolbox › Builds` or `/show builds`. Per-window options live under `Settings › Builds`.

The Builds window allows you to create and edit teambuilds, which can then be sent directly to party chat or loaded onto your character. Clicking "Send" on one of your teambuilds will send the name, followed by each build in a loadable template to the party chat. Clicking "Load" will load the build onto your character.

To create a new teambuild, click "Add Teambuild", or to edit an existing teambuild, click on its name. This will open a new window, which can be independently moved and re-sized. You can have multiple windows open at once. In these windows, you can write the name of the team and the individual builds, and paste in the template codes.

## Features

- **Pcons**: The "Pcons" button allows you to toggle specific [Pcons](/docs/pcons/) on or off when you load the build. When the Pcons button is greyed out, it won't change your pcons when you load the build. You can also send the list of Pcons for a build to chat.

- **View/Send**: The "View" button allows you to view the build in-game. Ctrl + Click to Send the build to chat.

- **Load**: The "Load" button loads the build onto your character and activates the associated Pcons.

- **Show numbers**: Adds a number to the name of each build when sending to chat.

- **Blank template**: If you leave a template code blank, it will simply appear as a message, instead of a blank template, and will not be given a number. This is useful for sending general instructions to the whole team.

- **Teambuild management**: "Up" and "Down" change the teambuild's position in the list of teambuilds, and "Delete" will delete the entire teambuild from the list.

- **Preferred Skill Orders**: You can set preferred skill orders for builds. When a matching set of skills is loaded, it will be automatically reordered to match your preference.

## Settings

- **Hide when entering explorable**: Automatically hides the Builds window when entering an explorable area.
- **Only show one teambuild at a time**: Closes other teambuild windows when you open a new one.
- **Auto load pcons**: Automatically loads pcons for a build when loaded onto a character.
- **Send pcons when pinging a build**: Automatically sends a second message after the build template in team chat, showing the pcons that the build uses.
- **Order teambuilds by**: Choose to order teambuilds by index or name.

## Chat Commands
`/load [build template|build name] [Hero index]` loads a build from your saved templates in Guild Wars. The build name must be between quotes if it contains spaces. First Hero in the party is 1, and so on up to 7. Leave out for player.

`/loadbuild [teambuild] <build name|build code>` loads a build via GWToolbox Builds window. Does a partial search on team build name/build name/build code. Matches current player's profession.
* Example: `/loadbuild fbgm tk` would load the build called `Me/A | Tendril Killer (TK)` from the teambuild called `DoA | FBGM Tactics` onto your player if you're a Mesmer

---

# Hero Builds

Source: https://www.gwtoolbox.com/docs/herobuilds/

<figure>
<img src="/docs-images/kwop9ub.webp"/>
<figcaption>Edit Hero Teambuild Window</figcaption>
</figure>

Open from `Toolbox › Hero Builds` or `/show herobuilds`. Per-window options live under `Settings › Hero Builds`.

The Hero Builds window allows you to create and edit teambuilds for your heroes, which can then be loaded directly onto them. This feature streamlines the process of setting up your hero team with specific builds and configurations.

## Features

- **Create and Edit Teambuilds**: Click "Add Teambuild" to create a new one, or click on an existing teambuild's name to edit it. Each teambuild can be independently moved and re-sized.

- **Load Teambuilds**: Clicking "Load" on a teambuild will kick all your current heroes, add the chosen heroes to the party, and load the builds onto them.

- **Customize Builds**: For each build in a teambuild, you can:
  - Set the build name
  - Paste the template code
  - Select the specific hero
  - Choose whether to show or hide the hero's panel
  - Set the hero's behavior (Fight, Guard, or Avoid Combat)

- **View/Send Builds**: The "View" button allows you to view the build in-game. Ctrl + Click to Send the build to chat.

- **Manage Teambuilds**: Use "Up" and "Down" to change a teambuild's position in the list, and "Delete" to remove it entirely.

- **Mode Selection**: The **Mode** dropdown allows you to automatically change to Normal or Hard Mode when loading the team.

- **Add Current Team**: You can quickly create a new teambuild based on your current team setup.

## Settings

- **Hide when entering explorable**: Automatically hides the Hero Builds window when entering an explorable area.
- **Only show one teambuild at a time**: Closes other teambuild windows when you open a new one.

## Chat Commands

`/heroteam [hero_build_name]` or `/herobuild [hero_build_name]`: Loads the specified hero teambuild.

## Notes

- Make sure you're in an outpost before trying to load a hero teambuild.
- The window will automatically save your changes when you close it.

---

# Hotkeys

Source: https://www.gwtoolbox.com/docs/hotkeys/

<figure>
<img src="/docs-images/28233491-14e981f0-68ac-11e7-9164-11b9ee781647.webp"/>
<figcaption>Hotkeys Window</figcaption>
</figure>

Open the Hotkeys window from `Toolbox › Hotkeys` or with `/show hotkeys`. Per-window options live under `Settings › Hotkeys`.

The Hotkeys window offers a large selection of Toolbox functions that can be mapped to a key on your keyboard or mouse, so that when you press the key, you will perform that action.

Click "Create Hotkey..." and select the type of hotkey you want to create. A new row will appear in the list of hotkeys, and you can now edit this hotkey.

The unmarked toggle switches the hotkey on or off: if it's off, pressing your hotkey will do nothing, but you can still activate it by clicking the "Run" button.

"Display message when triggered" prints a message in the Emotes channel whenever the hotkey is successfully activated.

"Block key in Guild Wars when triggered" prevents the hotkey from performing its usual Guild Wars function. For example, if the hotkey is `R`, successfully activating the hotkey will not cause your character to autorun.

"Trigger hotkey when entering explorable area" and "Trigger hotkey when entering outpost" cause the hotkey to activate every time you enter an instanced area or outpost/town/Guild Hall, respectively.

"Trigger hotkey when Guild Wars loses focus" and "Trigger hotkey when Guild Wars gains focus" allow the hotkey to activate when you switch away from or back to the Guild Wars window.

You can specify which maps, professions, and instance types the hotkey will work for. You can also set a character name for the hotkey to only work on a specific character.

The "Hotkey:" button allows you to choose a new key to bind to this function.

"Move Up" and "Move Down" adjust the hotkey's position in the list of hotkeys.

"Delete" deletes the hotkey from the list.

The other controls are for setting up the parameters of the hotkey, and are of course different for each type of hotkey, as described below:

## Send Chat
Select a channel to send the message to, and type your message. You can use Guild Wars commands (such as `/resign` or `/stuck`), as well as Toolbox commands (such as `/pcons` or `/cam unlock`).

## Use Item
Specify the item's Model ID [^1] and optionally a name to help you remember what the item is. This works for consumable items, including those in your Xunlai storage when you're in an outpost.

## Drop or Use Buff
This has a dual function: if you are currently maintaining the selected enchantment, you will dismiss it. Otherwise, you will cast it on the target. You can choose from Recall, Unyielding Aura, Holy Veil, or specify a custom skill ID [^1].

## Toggle...
This activates and de-activates one of four features:

* **Clicker** makes the left mouse button click rapidly.
* **Pcons** toggles [auto pcons](/docs/pcons/) on or off.
* **Coin Drop** drops a gold coin on the floor periodically.
* **Tick** toggles the Ready tick in the party window.

## Execute...
This triggers one of several features:

* **Open Xunlai Chest** opens your storage from anywhere in an outpost.
* **Open Locked Chest** automatically uses a lockpick to open a targeted chest.
* **Drop Gold Coin** drops a single gold coin on the ground.
* **Reapply appropriate title** changes your title based on the current area.
* **Enter Challenge** activates the Enter Mission button in certain outposts.

## Target
This automatically targets a particular pre-specified NPC, signpost, or item based on its ID[^1].

## Move to
This will move your character to a pre-specified point on the map. You can set the coordinates and specify a range within which the hotkey will work.

## Dialog
This sends a specific dialog ID, useful for interacting with NPCs or accepting quests automatically.

## Ping Build
Select a teambuild from your saved builds. Using the hotkey will send it to party chat.

## Load Hero Team Build
Select a hero team build from your saved builds. Using the hotkey will load the team.

## Equip Item
This allows you to equip a specific item, either by its attributes or by its position in your inventory.

## Flag Hero
This allows you to set a flag for a specific hero or all heroes at a certain angle and distance from your character.

- **Degree** — the angle of the flag, in degrees (-360 to 360), measured from the reference direction described below. `180` is directly behind that direction.
- **Distance** — how far from your character the flag is placed, in game units (0 to 10000). For reference, aggro (danger) range is roughly 1250 units and spellcasting range roughly 1010.
- **Hero** — which hero to flag (1-11, in party order). Use `0` to flag the whole party.

The flag is always placed relative to **your** position; only the direction the angle is measured from changes:

- **No target selected** — the angle is measured from the direction your character is facing, so the formation rotates with you.
- **A target selected** — the angle is measured from the line between you and your target, so the formation stays oriented on the target as you move around it. `Degree = 0` therefore puts the hero directly between you and your target at the given distance.

Pressing the hotkey again while that hero (or the party, for `0`) is already flagged clears the flag instead, so a single key toggles the position on and off.

Building a formation is just a handful of these hotkeys — e.g. one per hero at the same distance with degrees spread out (120 / 180 / 240 for a three-hero backline), plus a `Hero = 0` hotkey to unflag everything. See also the [minimap's hero flagging controls](/docs/minimap/#hero-flagging) and the [`/flag` chat commands](/docs/minimap/#chat-commands).

## Guild Wars Key
This allows you to bind a hotkey to trigger a specific Guild Wars control action.

## Command Pet
This allows you to set your pet's behavior (Fight, Guard, or Avoid Combat) with a hotkey.

[^1]: ID can be found using the Info Module. See Info documentation.

---

# Info

Source: https://www.gwtoolbox.com/docs/info/

<figure>
<img src="/docs-images/28233535-5b479466-68ac-11e7-910a-a58a3d755578.webp"/>
<figcaption>Info Window</figcaption>
</figure>

Open from `Toolbox › Info` or `/show info`. Per-window options live under `Settings › Info`.

The Info window is the hub for information, which can be be highlighted, and copied with Ctrl+C. Most of this is displayed in drop-down menus.

Each of these individual components can be removed in [Settings](/docs/settings/).

## Widget Toggles
Here you can switch each of your widgets on and off.

## Open Xunlai Chest
This is simply a button to open your storage, wherever you are in any outpost. This is even possible on new characters that haven't yet unlocked a storage account (such as in pre-Searing), but these will be unable to access any of the items; you can only look.

This function is also available as a [chat command](/docs/commands/) or a [hotkey](/docs/hotkeys/).

## Camera
Position shows the co-ordinates of the camera. Target shows the direction the camera is pointing (usually the top of your character's head).

## Player
Here you can see your exact position on the map, and how fast you are moving (normal walking forwards with no speed boost is 1.000).

Agent ID, Player ID, Effects, and Buffs are only useful for debugging and development; normal players can ignore these.

## Target
The Target menu is mostly the same as the Player one, but the information pertains to your current target instead.

Model ID is unique for each kind of agent. For example, all Margonite Anur Manks share the same Model ID, but Margonite Anur Tuks have a different one. This value can be used for targeting hotkeys and commands. This is not useful for targeting players, however, because they do not have a static ID.

There is also an Advanced section, only useful for debugging and development.

## Map
This section tells you about the current zone you are in.

Map ID is useful for setting up custom map markers and hotkeys. Each explorable area has a unique map ID, although this is sometimes shared with the associated outpost.

Map Type simply tells you if you are in an Outpost or Explorable area.

Map file refers to the zone's pathing map. The files are often shared with other maps; this is especially noticeable in Eye of the North dungeons.

## Dialog
This just shows the decimal codes for the last NPC you spoke to. You can use this to find out the code to set up dialog hotkeys.

## Items
This just shows the ID for the item in the top-left slot of your inventory backpack. You can use this to find out the ID to set up "Use Item" hotkeys.

## Quest
This gives information about the active quest, which can be used for dialogs and movement macros.

## Enemy Count
This simply shows how many enemy agents are in the vicinity.

The count for "compass range" and "spirit range" still includes those in "casting range".

Note that "casting range" is slightly larger than your aggro bubble.

## Resign Log
This is a list of all players in the party, showing whether they are still loading, connected (but not resigned), or have resigned.

The exact time (to the millisecond) the player loaded or resigned is displayed, although if they connected before you, it will show your connection time instead. If they resigned before you connected, it will not show that they resigned.

In an outpost, it will show the time the player joined your party, rather than when they connected.

---

# Materials Window

Source: https://www.gwtoolbox.com/docs/materials/

<figure>
<img src="/docs-images/28233538-62518442-68ac-11e7-80f7-c1b68b0c81b3.webp"/>
<figcaption>Materials Window</figcaption>
</figure>

Open from `Toolbox › Materials` or `/show materials`. Per-window options live under `Settings › Materials`.

The Materials window allows you to automatically buy and sell rare and common materials from the traders. It also provides price checks and purchase options for crafting materials needed for consets, powerstones, and resurrection scrolls.

## Features
- Buy and sell common and rare materials
- Price check and purchase materials for crafting consets, powerstones, and resurrection scrolls
- Automatically manage gold for transactions
- Use existing stock in inventory and storage when buying materials

## Usage
1. Stand next to a material trader.
2. Enter the quantity of materials you want to buy or sell.
3. Click "Price Check" to get current prices, or "Buy" to purchase immediately.
4. For selling, click "Sell" instead of "Buy".

The window displays real-time progress of your transactions and updates prices as they change.

### Crafting Materials
For consets, powerstones, and resurrection scrolls, the window shows the total price for the materials needed. You can adjust the quantity and purchase all required materials at once.

### Queue System
- Multiple orders are queued and processed in order.
- Sell orders take priority over buy orders.
- Price checks have the highest priority.

### Gold Management
Enable "Automatically manage gold" in the [Settings](/docs/settings/) window to have GWToolbox++ automatically withdraw or deposit gold as needed during transactions.

### Using Existing Stock
Enable "Use stock" to take into account materials you already have in your inventory and storage when buying materials.

## Controls
- **Cancel**: Cancels all queued orders.
- **Progress Bar**: Shows the progress of the current set of transactions.

## Known Issues
- The trader might continue or stop working unexpectedly when moving away from the NPC. If this happens, try moving back to the NPC, re-zoning, or changing districts.
- When selling common materials, ensure your inventory stacks are in multiples of 10 to avoid transaction failures.

[Back to Index](./)

---

# Pcons

Source: https://www.gwtoolbox.com/docs/pcons/

<figure>
<img src="/docs-images/28233488-0d9a3e30-68ac-11e7-8a23-850cbd44735b.webp"/>
<figcaption>Pcons Window</figcaption>
</figure>

The Pcons window can maintain your choice of cons and pcons, provided you have them in your inventory.

Each pcon will pop whenever you are alive and do not have the pcon's effect. Note that whilst most pcons' effects expire on death, and will re-pop immediately on resurrection, some (such as war supplies and alcohol) persist and do not need to be popped again.

## City Speedboost
City speedboosts, represented by the Sugary Blue Drink icon, will pop as soon as you move in an outpost.

Only the ones in your inventory (not your storage) will be used.

## Consets
Your Essence of Celerity, Grail of Might, and Armor of Salvation will only pop when the entire party has loaded into the area.

If any players are dead, cons will not pop. A player leaving the party or losing communication with the server will not prevent cons from popping.

## Res Scrolls and Powerstones
Scrolls of Resurrection and Powerstones of Courage are not auto-popped. Selecting these just allows Toolbox to automatically refill them from storage.

<figure>
<img src="/docs-images/28233558-77976cb8-68ac-11e7-90a3-cebe2015f2cf.webp"/>
<figcaption>Pcons Settings</figcaption>
</figure>

## Settings
All Pcons options live under `Settings › Pcons`, grouped into the sub-sections below.

* **Functionality** `Settings › Pcons › Functionality:`
  * **Toggle Pcons per character** — remember which pcons you choose for each character. With this unticked, your selection of pcons will be used for all characters.
  * **Tick with pcons** — automatically ticks/unticks your "Ready" check on the party window when you turn pcons on or off. Ticking and unticking will not affect pcons.
  * **Disable when not found** — turns off a pcon if you have none in your inventory.
  * **Refill from storage** — tops up your selected pcons to the level specified in **thresholds**. This only works when pcons are enabled.
  * **Show storage quantity in outpost** — displays a number on the bottom of each pcon icon, showing the total quantity in storage. This only displays when in an outpost.
  * **Pcons delay** — how long Toolbox waits between re-popping pcons. If this is lower than your ping, multiple sets of pcons will pop each time.
  * **Lunars delay** — how long Toolbox waits between popping Lunar Fortunes.
* **Thresholds**  
Choose the "threshold" for each pcon. When you have less than this amount:
  * The number in the interface becomes yellow.
  * Warning message is displayed when zoning into outpost.
* **Interface** `Settings › Pcons › Interface:`
  * **Items per row** — number of icons per row of the Pcons window.
  * **Pcon size** — icon size. 32.000 matches inventory icons on a Small interface.
  * **Enabled-Background** colour for highlighted (active) pcons.
* **Visibility**  
Select which pcons you want to appear on the Pcons window.

* **Lunars and Alcohol** `Settings › Pcons › Lunars and Alcohol`
  * **Current drunk level** shows how many minutes until you are no longer drunk. If alcohol is selected to auto-pop, you will drink more before the counter reaches 0.
  * **Suppress lunar and drunk post-processing effects** prevents the screen from going blurry from lunar or drunk effects. If you turn this on *after* the effect activates, it will actually prevent it from turning off.
  * **Suppress lunar and drunk text** hides the random speech bubbles that appear above characters when they're drunk or under the effects of Spiritual Possession.
  * **Suppress air of superiority text** hides the speech bubble shown above characters affected by Air of Superiority (from a Birthday Cupcake).
  * **Suppress drunk emotes** prevents your character from randomly performing emotes at high levels of drunkenness. There is a chance that this will cause your game to crash, and it's recommended to just use level 1 alcohol instead.
  * **Hide Spiritual Possession and Lucky Aura** hides these 2 effects on your effects monitor.

* **Auto-Disabling Pcons** `Settings › Pcons › Auto-Disabling Pcons`
  * **Auto Disable on Vanquish completion** — disables pcons when a vanquish is completed.
  * **Auto Disable in final room of Urgoz/Deep** — disables pcons when reaching Urgoz or Kanaxai.
  * **Auto Disable on final objective completion** — disables pcons when defeating Dhuum or completing all 11 quests in FoW.
  * **Disable on map change** — disables pcons when leaving an explorable area.

---

# Settings

Source: https://www.gwtoolbox.com/docs/settings/

Open from `Toolbox › Settings` or `/show settings`. Per-window options live under `Settings › Toolbox Settings`.

The Settings window contains configuration options for all Toolbox features, and provides access to several features that don't have their own [window](/docs/windows/).

The buttons at the top of the window link to the settings folder and this website.<br />
The buttons at the bottom save and load your Toolbox settings to and from the settings folder. 

## Help
This section contains some information about how to use Toolbox, along with a list of some of the more important chat commands. All of this information can be found, often in more detail, on this website.

<figure>
<img src="/docs-images/28233546-6e8dde4a-68ac-11e7-8bc9-20de80416296.webp"/>
<figcaption>Game Settings</figcaption>
</figure>

## Game Settings
These are several quality-of-life features that can be toggled on or off:

### Chat & Messages
* **Show chat messages timestamp** shows the time of each message in the chat history. Click the color box to choose a color for the timestamps.
* **Keep chat history** prevents the chat history from being deleted when changing characters.
* **Open web links from templates** automatically opens any links in templates you click on, instead of opening the template.
* **Automatically change URLs into build templates** puts links into equipment templates whenever you send them to chat. A link is any message that starts with `https://` or `http://`.
* **Target with double-click on message author** targets a player when you double-click their name in the chat.
* **Hide email address on login screen** replaces your email address with asterisks on the login screen.
* **Block messages from inactive chat channels** hides messages from chat channels that are currently turned off.

### Gameplay
* **Tick is a toggle** makes the "Ready" check on the party window immediately tick/untick when you click on it, instead of offering a drop-down menu.
* **Disable camera smoothing with mouse** removes the delay when rotating the camera with the mouse.
* **Disable camera smoothing with controller** removes the same delay when rotating the camera with a controller.
* **Automatically skip cinematics** skips in-game cutscenes without user input.
* **Automatically return to outpost on defeat** returns the party to the outpost when wiped (only works if you're the party leader).
* **Disable gold/green items confirmation** removes the confirmation prompt when selling gold and green items to merchants.
* **Automatically accept party invitations when ticked** accepts party invites without user input when you're ticked.
* **Automatically accept party join requests when ticked** accepts requests to join your party without user input when you're ticked.
* **Skip character name input when donating faction** automatically fills in your character name when donating faction.
* **Auto-cancel Unyielding Aura when re-casting** automatically drops Unyielding Aura before recasting it.
* **Remove 1.5 second minimum for the cast bar to show** allows the cast bar to appear for skills with very short cast times.
* **Lazy chest looting** automatically targets nearby reserved items when using the 'target nearest item' key next to a chest.
* **Auto use available keys when interacting with locked chest** automatically uses keys when interacting with locked chests.
* **Auto use lockpick when interacting with locked chest** automatically uses lockpicks when interacting with locked chests.
* **Keep current quest when accepting a new one** maintains the current active quest when a new quest is added.
* **Restore the legacy Enter Mission button when party leadership changes** works around a game bug where the legacy Enter Mission button disappears for whoever becomes party leader. Guild Wars only sets the button up when the party window is built, so Toolbox rebuilds the window on a leadership change - the same as toggling the game's "legacy Enter Mission button" option off and on again. Only applies if you have that game option enabled.
* **Prompt if entering a mission you've already completed** shows an "Are you sure?" confirmation when you start a mission your character has already finished in the selected difficulty, to avoid accidentally replaying it in the wrong mode.
* **Hide known skills when using a tome, capturing a skill or talking to a skill trainer** removes skills your current character already has from the skill selection window.
* **Hide all non-elite skills when capturing a skill** shows only elite skills in the skill capture window.
* **Stop screen shake from skills or effects** disables the camera shake caused by skills such as Aftershock, Earth Shaker or Avalanche.

### Item Management
* **Ctrl+Click to move items** allows you to move items between inventory and storage with Ctrl+Click.
* **Move items to current storage pane** moves items to the currently open storage pane when using Ctrl+Click.
* **Move materials to current storage pane** moves materials to the currently open storage pane when using Ctrl+Click (overrides default behavior of moving to material storage).
* **Hide item descriptions in explorable areas/outposts** only shows the item name in tooltips when hovering over items in inventory or weapon sets.
* **Hide skill descriptions in explorable areas/outposts** only shows the skill name and attributes in tooltips when hovering over skills.
* **Show 'You have N Lockpicks' on Locked Chest name tags** displays how many lockpicks you're carrying on the name tag of locked chests.
* **Show price check information on item hover** displays the current market price of the item when hovering over it.
* **Show salvage information on item hover** displays potential salvage materials for the item when hovering over it.

### Notifications
* **Flash Guild Wars taskbar icon when:**
    * **Receiving a private message** - you receive a whisper
    * **Zoning in a new map** - when you switch to another map
    * **Cinematic starts/ends** - when a cutscene begins or finishes
    * **A player starts trade with you** - when someone initiates a trade with you
    * **A party member pings your name** - when someone in your party pings your name in chat
* **Show Guild Wars in foreground when:**
    * **Launching GWToolbox++** - brings Guild Wars to the front when Toolbox starts
    * **Zoning in a new map** - brings Guild Wars to the front when changing maps
    * **A player starts trade with you** - brings Guild Wars to the front when someone initiates a trade
* **Show a chat message when a friend:**
    * **Logs in** - notifies you when a friend comes online
    * **Logs out** - notifies you when a friend goes offline
    * **Joins your outpost** - notifies you when a friend enters your current outpost
    * **Leaves your outpost** - notifies you when a friend leaves your current outpost
* **Show a chat message when a player:**
    * **Joins your party** - notifies you when someone joins your party
    * **Leaves your party** - notifies you when someone leaves your party
    * **Joins your outpost** - notifies you when any player enters your current outpost
    * **Leaves your outpost** - notifies you when any player leaves your current outpost

### Status
* **Automatically set "Away" after ___ minutes of inactivity** sets your status to Away after the specified minutes of no input to Guild Wars. This will only happen if you were set to Online.
* **Automatically set "Online" after an input to Guild Wars** immediately sets your status to Online after any input to Guild Wars. This will only happen if you were set to Away.
* **Set Guild Wars window title as current logged-in character** changes the game window title to show your character's name.
* **Remember my online status when returning to character select screen** keeps your friend-list status when you return to character select, instead of resetting it to Online when you next pick a character.

Note that you will not see status changes on your own friend list, but your status will have changed, and other players will see this.

### Miscellaneous
* **Show warning when earned faction reaches ___%** displays a warning when your faction reaches the specified percentage in challenge missions or elite areas.
* **Collectors Edition emotes on player dance** applies Collector's Edition animations to your character's dance emote.
* **Automatically flag pet to fight called target** flags your pet to attack the target you've called in chat.
* **Block floating numbers above character on:** hides the floating numbers that appear above characters for the selected events.
    * **Faction gain** hides floating faction-gain numbers.
    * **XP Gain** hides floating experience-gain numbers.
    * **0 XP Gain** hides floating experience-gain numbers when the amount gained is zero.
    * **Zero damage/heal/energy** hides floating numbers when the damage, healing, or energy change is zero.
    * **Damage received** hides floating damage numbers shown when your character takes damage.
    * **Damage dealt** hides floating damage numbers shown above other characters you damage.
    * **Healing received** hides floating healing numbers shown when your character is healed.
    * **Healing given** hides floating healing numbers shown above other characters you heal.
* **Disable animation and sound from consumables:**
    * **Tonics**
    * **Sweets**
    * **Bottle rockets**
    * **Party poppers**
    * **Snowman Summoners**
    * **Fireworks**
* **Block sparkle effect on dropped items**
* **Limit signet of capture to 10 in skills window**
* **Block full screen message when entering a new area**
* **Block full screen popup that shows when completing a vanquish**
* **Block full screen popup that shows when opening a dungeon chest**
* **In-game name tag colors** sets the colour the floating name tag above each agent is drawn in, by category. Click a colour wheel to change a category's colour. These are global overrides — to recolour a single specific agent instead of a whole category, use [Minimap → Custom Agents](/docs/windows/minimap#custom-agents)' **Text color** field:
    * **NPC** — non-player characters such as allies, vendors and signposts.
    * **Myself** — your own character.
    * **Other Player** — players not currently in your party.
    * **Other Player (In Party)** — players in your party.
    * **Friends** — players on your Friends list.
    * **Guild Members** — players in your guild roster.
    * **Gadget** — interactive objects such as chests, levers and traps.
    * **Enemy** — hostile creatures.
    * **Item** — dropped items on the ground.
* **Hide in-game store message on character select screen** removes the in-game store advertisement shown on the character selection screen.
* **Show message in chat when you're the last player to resign** posts a chat message once everyone else in your party has resigned. See also the [Resign Log](/docs/info/#resign-log).
* **Show experience progress instead of current level on your experience bar** displays your XP as progress toward the next level rather than your current level number.
* **Prevent weapon spell skin showing on player weapons** keeps weapons looking like their base item while a weapon spell (such as Conjure or a flame/frost/lightning effect) is active.
* **Prevent dervish avatar elites from changing your character's appearance** keeps your character's normal appearance while a Dervish avatar form is active.
* **Automatic /age on vanquish** sends `/age` as soon as a vanquish completes, to fetch the server-side completion time.
* **Automatic /age2 on /age** also shows the instance time (`/age2`) whenever /age is shown in chat.
* **Automatic screenshot on:** takes a screenshot automatically when the selected event occurs — **Vanquish**, **Boss kill**, **Mission complete**, **Dungeon complete**, or **Title maxed**.

The **Lunars and Alcohol** options at the bottom of this section (suppressing lunar/drunk effects, text and emotes) are documented under [Pcons → Settings](/docs/pcons/#settings).

<figure>
<img src="/docs-images/28233555-719397f6-68ac-11e7-82e5-8a18f4c7c44e.webp"/>
<figcaption>Toolbox Settings</figcaption>
</figure>

## Toolbox Settings
These options change some of the ways Toolbox function:
* Use **Update mode** to control Toolbox's updates:
  * **Do not check for updates** - Toolbox will never update.
  * **Check and display a message** - Toolbox will not update, but will inform you when there is an update, so you can install it manually.
  * **Check and ask before updating** - Toolbox will prompt you to confirm updates whenever they are available.
  * **Check and automatically update** - Toolbox will update without requesting confirmation, but will still show a changelog window when an update takes place.
  
* **Unlock Move All** releases all windows and widgets to be manually re-positioned.  
  This feature can also be toggled from the top of the Settings window.
  
* **Save Location Data** saves your co-ordinates every second to a file in the settings folder.

* Each window and widget (except the main window and Settings) can be completely turned off. When you restart Toolbox, your choice of disabled features will not load, and their buttons on the main window will no longer appear.

* Each window and widget (except the main window itself) can be set to appear as a button in the main window or not. No restart is required.

## Chat Filter ([more info](filter))
Here you can choose messages to filter out of the chat.

## Chat Commands
Here you can adjust the settings of the [`cam unlock` feature](/docs/camera/).

## Theme ([more info](/docs/theme/))
Here you can adjust the appearance of Toolbox.

## Storage
The settings are stored in the folder `C:\Users\[Username]\AppData\Local\GWToolboxpp`. You can open this folder by clicking on the button at the top of the Settings window, manually navigate to it, or type %LOCALAPPDATA% in Start Menu, Run, or in the address in Explorer.

There are a number of files in this folder:

* `img/` folder contains icons used in Toolbox.
* `FilterByContent.txt` contains the words used in the content-based [chat filter](filter).
* `Font.ttf` is the font used by Toolbox.
* `GWToolbox.dll` is Toolbox itself.
* `GWToolbox.ini` contains most of the Toolbox settings.
* `Hotkeys.ini` contains your Hotkeys window entries.
* `healthlog.ini` contains the health of mobs by id, which is collected and used by the damage monitor for more accuracy in measuring the damage of your allies.
* `interface.ini` contains information about the interface, such as position and size of your windows.
* `Markers.ini` contains your custom minimap markers.
* `Theme.ini` contains any changes you make to the default theme.

## Backup
You can (and should!) backup your Toolbox settings by saving some of the files above, and copy them over to the new installation. You definitely want to backup `GWToolbox.ini`, `Hotkeys.ini`, `Markers.ini` and `Theme.ini`. Optionally you can also backup all the `.ini` and `.txt` files.

In general, it is recommended to backup your Toolbox settings, so you have a copy in case something goes wrong.

## Font customization
You can change the font used by Toolbox simply by replacing the default `Font.ttf`.

## Icon customization
You can change any icons used by toolbox by replacing the respective file.

---

# Travel Window

Source: https://www.gwtoolbox.com/docs/travel/

<figure>
<img src="/docs-images/28233518-40a6f0d4-68ac-11e7-96c5-5c4fab47a107.webp"/>
<figcaption>Travel Window</figcaption>
</figure>

Open from `Toolbox › Travel` or `/show travel`. Per-window options live under `Settings › Travel`.

The Travel window allows you to quickly travel to any outpost in the game that you have unlocked.

## Main Features
- **Outpost Selection**: Choose from a dropdown menu of all available outposts.
- **Quick Travel Buttons**: Instantly travel to commonly visited outposts.
- **District Selection**: Choose which district to travel to.
- **Favorites**: Set and use your favorite outposts for quick access.

## Usage
1. Open the Travel window.
2. Select an outpost from the dropdown menu or use one of the quick travel buttons.
3. Choose a district if desired.
4. Click to travel to the selected outpost.

## User Travel Destinations
The quick-access buttons in the Travel window are fully configurable. To manage them, go to `Settings › Travel` and scroll to the **User Travel Destinations** section:
- **Add**: Click "Add Destination" to append a new button. Select the outpost, district, and optional district number for each entry.
- **Remove**: Click the trash button on any row to delete that destination.
- **Reset**: "Reset to Defaults" restores the original set of destinations.

Note: reordering destinations is not currently supported in the UI.

## Chat Commands
Use `/tp`, `/to`, or `/travel` followed by the outpost name or abbreviation to quickly travel. For example:
- `/tp doa` for Domain of Anguish
- `/tp embark` for Embark Beach
- `/tp gh` to enter or leave your guild hall
- `/tp zb|zm|zv` for Zaishen Bounty/Mission/Vanquish, will take you to GtoB to accept the quests if you don't have them yet

You can use various shortcuts and partial names for outposts and districts. Some examples include:
- `kama ae1` - Kamadan, American district 1
- `fa l` - Fort Aspenwood (Luxon)
- `deep ee` - The Deep, Europe English district, reqauires a scroll in inventory or chest
- `eee` - Embark Europe English

## Additional Features
- Automatically retry if a district is full (can be toggled in settings).
- Option to close or collapse the window after traveling.
- Special handling for elite areas like The Deep and Urgoz's Warren.
- In pre-Searing Ascalon, only the 5 pre-Searing outposts are available.

## Settings
Open via `Settings › Travel`.

- **Close on travel**: Automatically close the Travel window after selecting a destination.
- **Collapse on travel**: Automatically collapse the Travel window after selecting a destination.
- **Automatically retry if the district is full**: Keep trying to enter a full district. Use `/tp stop` to cancel.
- **Use English map names**: When unchecked, the `/tp` command uses localized map names matching your current language.
- **Show Zaishen quest buttons**: Toggle the Zaishen Bounty, Mission, Vanquish, and Combat travel buttons in the Travel window.
- **User Travel Destinations**: Add or remove the quick-travel buttons shown in the Travel window (see [above](#user-travel-destinations)).
- **Outpost Aliases**: Add, edit, or remove shorthand aliases used with the `/tp` command.

## Notes

You can use the following shortcuts instead of `[dest]`:
* `fav1`, `fav2`, `fav3` for your favorite locations
* `gh` to enter or leave your guild hall
* `gh [tag]` for any guild hall in your alliance - the tag is not case sensitive.
* `toa` - Temple of the Ages
* `doa`, `goa`, `tdp` - Domain of Anguish
* `eee` - Embark Beach, Europe English
* `gtob` - The Great Temple of Balthazar
* `la` - Lions Arch
* `ac` - Ascalon City
* `eotn` - Eye of the North
* `hzh` - House Zu Heltzer
* `ctc` - Central Transfer Chamber
* `topk` - Tomb of the Primeval Kings
* `ra` - Random Arenas
* `ha` - Heroes' Ascent
* `fa` - Fort Aspenwood
* `jq` - Jade Quarry

The `[dest]` argument also does a partial search on outpost names and returns the best match. Some examples include:
* `kama ae1` - Kamadan, American district 1
* `aurora int` - Aurora Glade, International district
* `sunspear sanc eg` - Sunspear Sanctuary, Europe German district
* `fa l` - Fort Aspenwood (Luxon)
* `jade quarry k` - Jade Quarry (Kurzick)
* `shing fr` - Shing Jea Monastery, Europe French district
* `vizunah square l` - Vizunah Square, Local Quarter
* `deep ee` - The Deep, Europe English district
* `foib` - Foibles' Fair (when on a Pre-Searing character)

The `[dest]` argument also does a partial search on dungeon names:
* `catacombs of kathandrax`, `rragars menagerie`, `cathedral of flames` - Doomlore Shrine
* `ooze pit`, `darkrime delves` - Longeye's Ledge
* `frostmaws burrows`, `sepulchre of dragrimmar` - Sifhalla
* `ravens point` - Olafstead
* `vloxen excavations` - Umbral Grotto
* `bogroot growths` - Gadds Encampment

The last word of the `[dest]` argument can also be a district shortcut as shown in the above examples:
* `ae` - American (any district)
* `ae1`, `ad1` - American district 1
* `int` - International district
* `ee` - Europe English district
* `eg`, `dd` - Europe German district
* `ef`, `fr` - Europe French district
* `ei`, `it` - Europe Italian district
* `es` - Europe Spanish district
* `ep`, `pl` - Europe Polish district
* `er`, `ru` - Europe Russian district
* `ak`, `kr` - Asia Korean district
* `ac`, `atc`, `ch` - Asia Chinese district
* `aj`, `jp` - Asia Japanese district

---

# Trade Window

Source: https://www.gwtoolbox.com/docs/trade/

Open from `Toolbox › Trade` or `/show trade`. Per-window options live under `Settings › Trade`.

<img src="/docs-images/trade_window.webp" alt="Trade window showing a live feed of Kamadan trade chat with timestamps, sender names and messages" />

The Trade window displays a live feed of trade chat from either Kamadan, America English district 1 or Pre-Searing Ascalon, America English district 1.

## Main Features
- **Live Feed**: Displays real-time trade messages from the selected location.
- **Search**: Filter messages by keywords.
- **Whisper**: Click on a trader's name to open a whisper chat with them.
- **Time Stamps**: Shows how long ago each message was posted (when window width allows).
- **Switch Locations**: Toggle between Kamadan and Pre-Searing Ascalon trade chats.

## Search
The search bar at the top allows you to filter messages by keywords. Click "Search" or press Enter to apply the filter. Use "Clear" to remove the filter and show all messages.

## Alerts
The "Alerts" button opens a new window with additional options:

- **Redirect Trade Chat**: Send trade messages to your in-game trade chat channel.
- **Filter Alerts**: Only show messages containing specific keywords.
- **Local Trade Filter**: Apply trade alerts filter to local trade messages.

### Alert Keywords
In the Alerts window, you can set up keywords for filtering trade messages. Each line represents a separate keyword (not case-sensitive).

A line wrapped in slashes is treated as a regular expression instead of a plain keyword, e.g. `/(wtb|wts).*ecto/`. Flags go after the closing slash — matching is case-insensitive unless you add `I`. The same syntax works for the party search alerts and for [loot beacon name rules](./loot_beacons/).

## Seek Party
When in Kamadan or Pre-Searing Ascalon, you can use the "Seek Party" feature to advertise your party search:

1. Enter your message in the text field.
2. Select the search type (e.g., Trade, Mission, etc.).
3. Check the "Seek Party" box to start advertising.

## Additional Information
- The window automatically connects to the trade chat server when opened.
- You can switch between Kamadan and Pre-Searing Ascalon trade chats using the button in the top-right corner.
- The footer provides a link to the source website powering the trade chat feed.

---

# Market Browser

Source: https://www.gwtoolbox.com/docs/market_browser/

Open from `Toolbox › Market Browser` or `/show marketbrowser`. Per-window options live under `Settings › Market Browser`.

<img src="/docs-images/market_browser.webp" alt="Market Browser window showing the item list with seller and buyer counts, a Favorites pane and an item details pane with active sell orders" />

The **Market Browser** is a docked window that streams live buy/sell listings from [gwmarket.net](https://gwmarket.net) over a websocket connection, so you can search for items, compare prices across currencies, and whisper sellers without alt-tabbing out of Guild Wars.

It's a read-only view of the gwmarket.net order book today — posting your own orders happens on the website (the in-game "My Shop" panel exists in source but is gated behind a build flag).

## Header

A status row at the top of the window shows the connection state:

- **Connected** (green) — receiving live updates.
- **Connecting…** (yellow) — handshake in progress.
- **Disconnected** (red) — websocket dropped; click **Refresh** to try again.

Three radio buttons filter the item list by order direction:

- **All** — show every item with active orders.
- **WTS** — show only items with active sell orders (Want to Sell).
- **WTB** — show only items with active buy orders (Want to Buy).

A **Search** box just below the filters narrows the item list by name. Matching is substring-based, case-insensitive.

## Layout

The body is split into three panes:

- **Item list** (top-left) — every item with active listings, with badges showing how many buyers and sellers are quoting it. Click an item to load its order book in the details pane.
- **Favorites** (bottom-left) — items you've starred. Persisted to `GWToolbox.ini` under `[Market Browser]` so they survive restarts.
- **Item details** (right) — the order book for whichever item you've selected.

A small footer button reads **"Powered by gwmarket.net"** — clicking it opens the site in your browser via the Toolbox URL handler.

## Item details pane

When you click an item, the right pane fills with:

- A header showing the item name plus two dropdowns:
  - **Sort mode** — **Most Recent** (newest orders first) or **Currency** (cheapest first).
  - **View currency** — show **All** currencies, or filter to one of **Plat**, **Ecto**, **Zkeys**, **Arms**.
- A **★ Favorite / Unfavorite** button to toggle the item in your Favorites pane.
- A **gwmarket.net** button to open the item's page in the website.
- A **Guild Wars Wiki** button to open the item's wiki page.
- Two grouped lists below: **SELL ORDERS** (green) and **BUY ORDERS** (orange). Each row shows the seller name, when it was posted, the quoted quantity, the asking price, the per-unit price and a **Whisper** button that opens an in-game whisper pre-filled with that player's name. If you then send a whisper to that player within 60 seconds, anonymous purchase data is sent to gwmarket.net (see [Anonymous Analytics](/docs/analytics/)).

## Settings

The window has its own settings panel (open from [Settings](/docs/settings/) → **Market Browser**):

- **Auto-refresh** — when on, polls the market every N seconds.
- **Interval (sec)** — slider, 30 to 300 seconds. Only shown when Auto-refresh is enabled.
- **Refresh** — manual one-shot refresh; only enabled while the websocket is connected.

## Tips

- The browser only shows *active* orders. If a listing's TTL has expired on the gwmarket side, it disappears from the in-game view automatically.
- Currencies are converted by gwmarket — when the **Currency** sort is selected, items priced in different currencies are sorted within their currency bucket, not against each other.
- Your favourites list is stored under your Toolbox configuration, not on gwmarket.net, so it's per-installation rather than per-account.

---

# Completion Window

Source: https://www.gwtoolbox.com/docs/completion/

Open from `Toolbox › Completion` or `/show completion`. Per-window options live under `Settings › Completion`.

<img src="/docs-images/completion_window.webp" alt="Completion window showing outposts, missions, vanquishes and elite skill progress for a character" />

The Completion Window in GWToolbox++ allows you to track your progress across various aspects of Guild Wars. This feature provides an easy way to visualize your achievements, unlocks, and completions for different characters.

## Features

- Track progress for missions, vanquishes, skills, and more
- View completion status for different campaigns
- Monitor Hall of Monuments achievements
- Filter and sort completion data
- Switch between different characters

## Usage

To access the Completion Window:
1. Open the GWToolbox++ main window
2. Click on the "Completion" button

The window displays various categories of completion data:

1. Outposts
2. Missions
3. Vanquishes
4. Elite Skills
5. PvE Skills
6. Heroes
7. Unlocked Item Upgrades
8. Festival Hats
9. Hall of Monuments

For each category, you'll see:
- Total completion percentage
- Detailed breakdown of individual items
- Option to hide completed/unlocked items

## Character Selection

You can view completion data for different characters:
1. Use the character dropdown at the top of the window
2. Select the desired character
3. The window will update to show that character's completion data

## Filtering and Display Options

- Toggle between list and grid view
- Hide completed missions, vanquishes, or unlocked skills
- Switch between normal and hard mode for applicable categories

## Hall of Monuments

The Completion Window includes a detailed breakdown of your Hall of Monuments achievements:
- View progress for all five monuments
- See dedicated items and points earned
- Track individual achievements within each monument

## Updating Data

The Completion Window automatically updates as you play. For Hall of Monuments data, it fetches information from the official Guild Wars 2 HoM website.

## Notes

- Completion data is character-specific, except for account-wide achievements
- Some data may require specific actions in-game to update (e.g., talking to NPCs for festival hats)
- The window provides a comprehensive overview of your Guild Wars journey and helps identify areas for further exploration or completion

---

# Armory Window

Source: https://www.gwtoolbox.com/docs/armory_window/

Open from `Toolbox › Armory` or `/show armory`. Per-window options live under `Settings › Armory`.

<img src="/docs-images/armory_window.webp" alt="Armory window showing per-slot armor previews and a live character preview" />

The Armory Window is a powerful feature that allows you to preview all armor in the game in all colors on your character. This tool is perfect for planning your character's appearance or simply exploring the vast array of armor options available in Guild Wars.

## Features

- **Preview All Armor**: Browse through every armor set available in the game for your character's profession.
- **Color Customization**: Apply any dye color to each armor piece to see how it looks.
- **Real-time Updates**: Changes are applied to your character in real-time, allowing you to see exactly how the armor will look in-game.
- **Campaign Filter**: Filter armor sets by campaign (Core, Prophecies, Factions, Nightfall, Eye of the North).
- **Costume Preview**: Preview full costumes and festival hats.

## How to Use

1. Open the Armory Window from the GWToolbox++ menu.
2. Select the armor slot you want to change (Head, Chest, Hands, Legs, Feet).
3. Browse through the available armor pieces for that slot.
4. Click on an armor piece to apply it to your character.
5. Use the color pickers to change the dye colors for each part of the armor piece.
6. Use the campaign filter to narrow down the armor options if desired.

Note that every armor piece can also be applied using a chat command. The correct command format is shown when you hover over an item in the Armory Window. For example: `/armory "Imposing Mask" 3 3 3 3`. The text in quotes is the internal armor identifier, and the four numbers after it are the dye channels applied to that piece, which together apply the selected item to your character using the specified dye color values. Right click an item and press "Copy chat command" to copy the command. Note that the chat command `/armory reset` will reset to the original character outfit.

## Notes

- The Armory Window only changes the appearance of your character locally. Other players will still see your actual equipped armor.
- Some special armors or costumes may not be available for preview.
- Weapon previews are currently not supported.
- There is currently no way to keep the applied armor appearance permanently. However, you can automatically reapply it every time you zone by using the Hotkey module. See the Tips section below.

Remember to click the "Reset" button if you want to revert all changes and return to your originally equipped armor.

Enjoy experimenting with different armor combinations and colors to create your perfect look!

## Tips

### Reapply armor every time you rezone
There is currently no built‑in way to keep your previewed armor applied permanently. However, you can use the Hotkey module to automatically reapply your chosen outfit whenever you enter an outpost or explorable area.

To set this up:

1. Collect all the chat commands for the outfit you want to use by hovering over the items in the Armory Window.  Right click the item and press "Copy chat command" to copy the command. For example, as a Mesmer:
```
/armory "Imposing Mask" 3 3 3 3
/armory "Obsidian Attire" 3 3 12 12
/armory "Luxon Gloves" 3 3 12 12
/armory "Elite Noble Hose" 3 3 12 12
/armory "Vabbian Footwear" 3 3 12 12
```
2. Open the Hotkey module and create a new hotkey. Set the method to `Send Chat` and the channel to `/Commands`.
3. In the message box, paste the first command **without** the leading slash. Example: `armory "Imposing Mask" 3 3 3 3`
4. Enable the following options: `Trigger hotkey when entering explorable area` and `Trigger hotkey when entering outpost`
5. Under Character Names, enter the name of the character you want this outfit applied to (press Enter to add it). This prevents the hotkey from affecting all characters and triggering errors.
6. Close the Hotkey window and fast‑travel to another outpost to test whether the hotkey is triggering. If set up correctly, the armor piece should be applied automatically.
7. Repeat steps 2–6 for each additional armor command in your outfit.

* Note that the game window must be in focus for the trigger to activate.
* You can also group hotkeys to keep your Hotkey window organized. Refer to the Hotkey module documentation for details.
* The armor will be reset to the original for cutscenes.

---

# Duping Window

Source: https://www.gwtoolbox.com/docs/duping_window/

Open from `Toolbox › Duping` or `/show duping`. Per-window options live under `Settings › Duping`.

The Duping Window is a feature in GWToolbox++ that helps players monitor and track enemy duplication (duping) in the Domain of Anguish (DoA) area. This window is particularly useful for players engaging in DoA runs, as it provides real-time information about enemy duping status.

## Features

1. **Enemy Type Tracking**: The window tracks three types of enemies:
   - Souls (Soul Tormentors)
   - Waters (Water Tormentors)
   - Minds (Mind Tormentors)

2. **Enemy Counters**: Displays the total count of each enemy type within range.

3. **Health Bars**: Shows the current health of each tracked enemy.

4. **Duping Status**: Indicates when an enemy is duping (using the skill "Call to the Torment").

5. **Regen Pips**: Displays the health regeneration rate of each enemy.

6. **Last Duped Timer**: Shows how long ago each enemy last duped.

7. **Target Selection**: Allows you to target an enemy by clicking on their entry in the window.

## Settings

The Duping Window can be customized with the following settings:

- **Hide when there is nothing to show**: Automatically hides the window when there are no relevant enemies to display.
- **Range**: Adjust the range (in game units) within which enemies are tracked.
- **Enemy Counters**: Toggle the display of total counts for each enemy type.
- **Duping thresholds**: Set the health threshold below which enemy duping info is displayed for each enemy type.

## Usage

1. Enable the Duping Window in GWToolbox++ settings.
2. The window will automatically appear when you enter the Domain of Anguish.
3. Monitor the window to track enemy duping status and make tactical decisions based on the information provided.
4. Click on an enemy's entry to target them in-game.

This tool is especially useful for coordinating attacks and managing enemy duplication during DoA runs, helping players to optimize their strategies and improve clear times.

---

# Account Inventory

Source: https://www.gwtoolbox.com/docs/account_inventory/

Open from `Toolbox › Account Inventory` or `/show Account Inventory`. Per-window options live under `Settings › Account Inventory`.

The Account Inventory window shows a single combined view of every item you own — across all of your characters, their heroes, and your Xunlai chest — and remembers what it has seen so the items stay visible even when you are logged in on a different character. If you have several Guild Wars accounts registered with Toolbox, items from those accounts are shown too, marked as **foreign** so you can tell them apart.

<img src="/docs-images/account_inventory_window.webp" alt="Account Inventory window showing the toolbar, Free Slots header, filter row and item grid" />

## Header toolbar

The row of checkboxes along the top of the window controls how the items list is filtered and rendered. The same toggles are mirrored under `Settings › Account Inventory`.

- **Detailed View** `Account Inventory › Detailed View` — Switch between the compact icon grid (default) and a sortable table with `Character`, `Location / Hero`, `Model ID` and `Item` columns.
- **Merge Stacks** `Account Inventory › Merge Stacks` — Combine multiple matching items into a single row, including normally non-stackable items. Hovering shows where each piece of the stack lives.
- **Hide other Accounts** `Account Inventory › Hide other Accounts` — Hide items that belong to other GW accounts registered with Toolbox.
- **Hide Equipment** `Account Inventory › Hide Equipment` — Hide items in the *Equipped Items* bag and any weapon-set entry currently marked equipped.
- **Hide Equipment Packs** `Account Inventory › Hide Equipment Packs` — Hide everything inside the *Equipment Pack* bag.
- **Hide Hero Armor** `Account Inventory › Hide Hero Armor` — Hide armor pieces worn by heroes (slots 2+ of a hero's equipped bag).
- **Hide unclaimed Items** `Account Inventory › Hide unclaimed Items` — Hide the contents of the *Unclaimed Items* bag.
- **Gather Inventories** `Account Inventory › Gather Inventories` — Walk through every character on the active account and every unlocked hero to refresh the saved inventory data. See [Gather Inventories](#gather-inventories) below.

## Free Slots

The collapsible **Free Slots** header expands into a sortable table showing how many inventory and equipment slots are free on each character and chest that Toolbox has seen, in the form `free/total`. Click a column header to sort; click again to flip the direction; hold `Shift` to sort by multiple columns.

Clicking the **character name** of an entry on the active account is a shortcut:

- On a player row — reroll to that character.
- On the `(Chest)` row — reroll/open the Xunlai chest on the active character at the first storage pane.

Entries from other accounts are shown greyed out. Chest rows from foreign accounts include the alphabetically-first character name on that account in square brackets (`(Chest) [SomeName]`) so you can distinguish multiple foreign chests without showing account email addresses.

The anniversary storage pane (Storage 14) is only counted toward the chest's max once Toolbox has seen at least one item in it.

## Items list

Below the toolbar sits the items list. The first row under the column headers is a per-column filter:

- **Character** filter — Substring match against the character name. Case-insensitive if your query is all lowercase.
- **Location / Hero** filter — Substring match against the bag/hero label (e.g. `Storage 3`, `Equipped Items`, `Olias`). Case-insensitive if all lowercase.
- **Model ID** filter — Exact match against the item's model id.
- **Item** filter — Substring match against the decoded item description. Case-insensitive if all lowercase.

To the right of the item filter, `Filter <shown>/<total> Items` shows how many items pass the current filter out of the total tracked.

The columns are also sort keys — click a header to sort by `Character`, `Location / Hero`, `Model ID` or `Item`; hold `Shift` to add secondary sort columns.

### Item colors

Each item button is tinted to tell you at a glance where it lives:

- **Default** — A normal inventory item on the active account.
- **Green-tinted** — Stored in the Xunlai chest (any storage pane) or material storage.
- **Yellow / orange-tinted** — Equipped on a hero.
- **Desaturated** — Belongs to another GW account registered with Toolbox.

The yellow number in the top-left of an icon (icon grid view) is the stack size.

### Clicking an item

Clicking an item is a "go to it" shortcut:

- **Click** — Reroll to the character that owns the item. If the item lives on a hero, that hero is added to the party. If the item is in the chest, Toolbox opens the Xunlai window and switches to the correct storage pane.
- **Ctrl+Click** — Same jump as above, *plus* automatically move the item between your inventory and the chest using the same logic as the Inventory Manager. Hero armor cannot be moved this way and is treated as a plain click. Items on other accounts cannot be moved either.

While a reroll/load is in progress, an `Account Inventory loading in progress` dialog appears with an **Abort!** button if you need to cancel.

Hovering an item shows a tooltip that lists each character/location the item is found on with per-location totals, plus the full item description. Items from foreign accounts are dimmed in the tooltip.

## Gather Inventories

By default, Toolbox only sees items on the character you are currently playing (plus your active heroes and chest). To populate the window with everything on the account, use **Gather Inventories**:

- Available both in the window's toolbar and under `Settings › Account Inventory › Gather Inventories`.
- Triggers a confirmation dialog before starting, because it will use the [Reroll](/docs/reroll/) feature to cycle through every PvE character on the account and read each one's inventory.
- On each character it kicks the party, adds every unlocked hero in batches of up to `max party size - 1` (capped at 7), waits for the hero's inventory to load, and records what is in their equipped bag.
- When finished it rerolls back to the character you started on and restores the heroes you had in your party.
- The whole pass can take several minutes if you have many characters/heroes. The progress dialog has an **Abort!** button.

The gather pass is skipped for PvP characters and for characters currently stuck on a map where Toolbox disables itself.

## Settings page

Under `Settings › Account Inventory`:

- All seven toggles from the header toolbar (`Detailed View`, `Merge Stacks`, `Hide other Accounts`, `Hide Equipment`, `Hide Equipment Packs`, `Hide Hero Armor`, `Hide unclaimed Items`) with short descriptions next to each.
- **Gather Inventories** `Settings › Account Inventory › Gather Inventories` — Same action as the in-window button.
- **Delete Account Inventory** `Settings › Account Inventory › Delete Account Inventory` — Wipe the saved inventory data **for the active account only** and remove its `.ini` files from disk.
- **Delete All Inventories** `Settings › Account Inventory › Delete All Inventories` — Wipe saved inventory data for **every** account stored on disk, including foreign accounts.

After either delete action a reminder dialog notes that you should also disable **Account Inventory** under `Settings › Windows › Account Inventory` if you don't want Toolbox to immediately start regathering data the next time you load a map.

## How the data is stored

Inventory data is persisted as `.ini` files under your Toolbox settings folder, in a sub-directory called `inventories`:

- One file per character holds that character's items.
- One file per account holds that account's Xunlai chest items.
- Files are saved on map load while you are in an **outpost**. Saves are suppressed in explorable areas so writes don't impact gameplay.
- When you log out, Toolbox writes out the current account's data and reloads any foreign-account data so it stays in sync between profiles.

You never need to edit these files by hand; this is documented so you know what gets touched if you back up or move your Toolbox settings folder.

---

# Widgets

Source: https://www.gwtoolbox.com/docs/widgets/

Unlike [Windows](/docs/windows/), widgets are designed to stay open all the time, as part of your user interface. Mostly widgets are non-interactive, and just display information.

All widgets have options in [Settings](/docs/settings/) to specify the exact co-ordinates of their on-screen position and prevent the widget from being moved around or re-sized.

## Interface
* Click and drag on the lower right corner to re-size a widget.
* Click and drag anywhere to move a widget.

<figure>
<img src="/docs-images/28233476-fa86197c-68ab-11e7-85ac-f9c21f4e30db.webp"/>
<figcaption>Timer Widget</figcaption>
</figure>
  
There are several ways to open and close widgets:
* Checkboxes in the [Info](/docs/info/) window.
* Checkboxes in the right of each header on [Settings](/docs/settings/).
* Chat command `/hide (name of widget)`.
* Chat command `/show (name of widget)`.
* Chat command `/tb (name of widdget)` to toggle show/hide.

<figure>
<img src="/docs-images/28233454-decaf91e-68ab-11e7-8547-e584bd499628.webp"/>
<figcaption>Health Widget</figcaption>
</figure>

## Timer
The timer shows the *instance time* of the current map, meaning for how long the instance/map/district has been running.

## Health
The health monitor shows your target's current health, maximum health, and health as a percentage.

Until you directly affect the health of an agent (see a pop-up number over it), you will only be able to see the percentage. If its maximum health changes (e.g. a player using a cupcake or getting a morale boost), the health monitor won't show this until you affect its health again.

<figure>
<img src="/docs-images/28233453-dcab43f0-68ab-11e7-9788-c5e39799d0ee.webp"/>
<figcaption>Distance Widget</figcaption>
</figure>

## Distance
The distance monitor shows your distance from your target as a percentage of compass range and in GW distance units (gwinches).

## Minimap
The [minimap](/docs/minimap/) is an improved version of the default Guild Wars compass, with such features as targeting, zoom, and accurate pathing maps.

## Damage
The [damage monitor](/docs/damage_monitor/) records how much damage has been dealt by each party member and displays it as a number, as a percentage of the party's total, and as a thick horizontal bar.

## Bonds
The bonds monitor shows which maintained monk enchantments you currently have on the allies in the party window. There is an option in [Settings](/docs/settings/) to only show bonds for party members. The monitor also shows refrains ([Heroic Refrain](https://wiki.guildwars.com/wiki/Heroic_Refrain), [Bladeturn Refrain](https://wiki.guildwars.com/wiki/Bladeturn_Refrain), [Burning Refrain](https://wiki.guildwars.com/wiki/Burning_Refrain), [Hasty Refrain](https://wiki.guildwars.com/wiki/Hasty_Refrain), [Mending Refrain](https://wiki.guildwars.com/wiki/Mending_Refrain)) you have cast on yourself and your heroes. Refrains cast on **other players** cannot be shown: Guild Wars only tells your client about the effects on you and your own heroes, so a refrain you are maintaining on another player will leave its slot on the monitor empty.

The bonds are displayed in the order they appear in your skill bar when entering the zone. There is a button in [Settings](/docs/settings/) to refresh the order if you re-order your skill bar in an explorable area. You can also make them appear in reverse order.

Self-targeted enchantments that cannot be maintained on another ally (e.g. Unyielding Aura) will not show up.

If your attributes have increased, allowing you to cast a stronger version of a bond or refrain, it will appear darkened on the monitor. This only works for yourself and your heroes.

You can click on the monitor to cast or dismiss bonds and cast refrains. This can be disabled in [Settings](/docs/settings/).

You can customize the background color of the monitor in [Settings](/docs/settings/). You can also adjust the row height to make it line up better with your party window.

## Clock
The clock simply shows your local time of day. You can choose 12 or 24-hour clock.

## Vanquish
The vanquish monitor shows how many enemies are in a zone, and how many have already been killed. This updates whenever you spawn additional enemies e.g. from quests or pop-ups.

This widget will not appear unless you are in an vanquishable area and in Hard Mode.

## Vanquish Overlay
The [vanquish overlay](/docs/vanquish_overlay/) paints fog of war, enemy markers, and a compass-range circle on top of the in-game mission map to help you finish Hard Mode vanquishes.

## World Map
The [world map widget](/docs/world_map/) overlays quest markers, elite capture locations, and toolbox minimap lines on the in-game world map, and adds right-click shortcuts for travel and the wiki.

## Alcohol
When in an explorable area, the alcohol monitor displays a timer of how long before the drunkenness effect wears off.

---

# Damage Monitor

Source: https://www.gwtoolbox.com/docs/damage_monitor/

All settings for this widget live under `Settings › Damage`.

The damage monitor records how much damage has been dealt by each party member and displays it as a number, as a percentage of the party's total, and as a thick horizontal bar.

As well as the thick bar showing each party member's damage, there is a thinner bar showing recent damage. This resets after dealing no damage for a short time, which can be customized in [Settings](/docs/settings/).

You can customize the color of the bars in [Settings](/docs/settings/). You can also adjust the row height to make the monitor line up better with your party window.

Life steal is counted as damage, but degen is not; if it doesn't show as a pop-up number above the enemy, it isn't counted by the monitor. 

Bear in mind that if a party member or enemy is beyond compass range, your client cannot see the damage packets they are dealing/receiving, so these will not show up on the damage monitor.

# How does the damage monitor work?

Toolbox reads damage from a single packet that is sent from the server to your GW client. The goal of this packet is two-fold: update the HP bars of any agent on your screen, and make the client show the damage numbers done by you and dealt to you. This is only sent for agents in your compass range, and contains the following information:
* Who dealt the damage (caster)
* Who receives the damage (target)
* The amount of damage *as a factor of max health*, between 0 and 1. For example, after casting an 80-damage spell on an 800-hp foe, this value would be 0.1.
 
So how does Toolbox compute the amount of damage dealt? This step is the most tricky, and it is what causes most misconceptions. Every time toolbox receives a damage packet, it does the following:
 
* Does the GW client know the target's maximum health? If so, the damage is computed as *(amount * target maximum health)*, and also save this max health for this *kind* of foe.
* Otherwise, has toolbox seen this *kind* of foe before? If so, use the maximum health previously saved, and do *(amount * saved maximum health)*.
* Otherwise, toolbox really doesn't know the target's max health, compute a "best guess" approximate with *(amount * (target level * 20 + 100))*.
 
Notes:
* By default, your GW client does not know the health of any mob. This is only known once the player directly affects the target's health, usually through an attack, or a damaging or healing spell. You can see this effect in Toolbox's health monitor.
* Toolbox compiles a personalized list of maximum health for each foe seen. Why? The same *kind* of foe can have different maximum health, for example with Normal mode / Hard mode differences, or the same foe appearing in different areas, or even temporary buffs such as Signet of Stamina. By keeping track of the health of the mobs that *you* encounter, the damage monitor will produce the best estimate for you.
* Toolbox will save the maximum health of foes and retain this information even after you close and re-open it. All of this information is stored locally in your toolbox settings folder (`healthlog.ini`), and none is sent over the internet.
 
In summary, the Toolbox damage monitor has the following limitations:
* Only accurately register damage done to entities that were directly damaged by the user before the damage is inflicted. However, this is mitigated by Toolbox remembering the maximum health of each foe.
* Only registers damage that occurs within compass range.
* Only register damage, and not health-degeneration.
* Only register player-inflicted damage (e.g.: will not measure EoE damage as inflicted by the caster).
* But, it *will* count a summoning stone's damage as inflicted by the player who summoned it.
 
In case you want to check the actual code, you can see it here: https://github.com/gwdevhub/GWToolboxpp/blob/master/GWToolboxdll/Widgets/PartyDamage.cpp

## Chat Commands

`/dmg [arg]` or `/damage [arg]` controls the party damage monitor:

* Full party report in party chat: `/dmg` or `/dmg report`
* Your own damage only: `/dmg me`
* A specific party member's damage: `/dmg 3`
* Reset the monitor: `/dmg reset`

---

# Minimap

Source: https://www.gwtoolbox.com/docs/minimap/

<figure>
<img src="/docs-images/28382699-ed34bf1e-6c73-11e7-8280-bdfa85d90ae0.webp"/>
<figcaption>Minimap</figcaption>
</figure>

All settings for this widget live under `Settings › Minimap`.

These minimap layers can also be overlaid on the in-game mission map — see [Mission Map](/docs/mission_map/).

The Minimap widget is an advanced version of the Guild Wars compass. It shows the full party-range area with an accurate pathing map, replaces agent dots with shaped/coloured markers, draws range circles, custom markers, AoE-spell footprints, and quest goals, exposes a click-through targeting and movement layer, and (optionally) projects custom markers into the 3D game world.

## Features Overview

- The minimap shows everything within party range (5000 gwinches) — about 10% further than the default compass. Agents inside that range can be targeted via `Ctrl+Click` (default — see [Hold + Click modifiers](#hold--click-modifiers)).
- Unlike the default compass, the minimap turns immediately as you look around (with optional smoothing).
- Background is an accurate pathing map showing where agents can actually move.
- Party range, spirit range, cast range, aggro range and any custom range circles you add — all drawn accurately. Special circles (HoS, chain aggro, res aggro, shadow step) appear automatically when relevant skills/targets are active.
- All 7 heroes can be individually flagged from the minimap, including flagging on the ground in the open world.
- AoE spell footprints for enemy casters (Maelstrom, Chaos Storm, traps, etc.) are drawn on the map.
- Custom lines, circles, and polygons can be drawn on the minimap and optionally projected onto the 3D terrain in-world.
- `/marktarget` lets you keep specific agents highlighted on the minimap.

### Agents

- **Edge of Extinction**, **Quickening Zephyr**, **Winnowing**, **Frozen Soil**, and **Symbiosis** areas of effect are visible on the minimap.
- Agents that can move or turn have a teardrop shape with the point indicating facing. Static agents (passive spirits, etc.) are circles. Signposts and items on the ground are squares.
- Bosses can be drawn at a different size, and (optionally) tinted by primary profession.
- You can override the colour, text colour, size and shape of any specific agent by model id — optionally restricted to a particular map and/or combat / weapon state.

<figure>
<img src="/docs-images/28233561-79208cae-68ac-11e7-8e7e-af4bb1b1264e.webp"/>
<figcaption>Minimap Settings</figcaption>
</figure>

## Customising appearance

All of the settings below live under `Settings › Minimap` and persist in `GWToolbox.ini` in your settings folder. Most colour pickers accept alpha — set alpha to `0` to disable a feature entirely.

### General

- **Scale** `Settings › Minimap › Scale` — Zoom level. Range 0.1–10.0. Also adjustable in-game with `Shift+mousewheel`.
- **Size** `Settings › Minimap › Size` — Minimap edge size in pixels. Hidden when **Snap to GW compass** is on (the minimap is then sized from the in-game compass).
- `Shift+drag` to pan the minimap to look at other areas. In-game movement snaps the view back onto you. Panned views still cannot show anything beyond party range. (The drag modifier is configurable — see [Hold + Click modifiers](#hold--click-modifiers).)

### Compass integration

- **Snap to GW compass** `Settings › Minimap › Snap to GW compass` — Resize and position the minimap to match the in-game compass.
- **Hide GW compass agents** `Settings › Minimap › Hide GW compass agents` — Hide the agent dots on the underlying GW compass so the minimap doesn't have to fight them for visual clarity.
- **Hide GW compass quest marker** `Settings › Minimap › Hide GW compass quest marker` — Hide the GW quest star. To suppress the *toolbox* quest marker as well, set its colour to fully transparent under **Symbols**.
- **Draw all quest markers** `Settings › Minimap › Draw all quest markers` — Draw the goal of every quest in your log, not just the active quest.
- **Hide GW compass drawings** `Settings › Minimap › Hide GW compass drawings` — Hide drawings on the GW compass. Drawings from other players still show on the minimap.
- **Hide GW compass when minimap is visible** `Settings › Minimap › Hide GW compass when minimap is visible` — Hide the entire in-game compass while the minimap is up.
- **Hide GW compass flagging controls** `Settings › Minimap › Hide GW compass flagging controls` — Hide the in-game hero-flag buttons. Takes effect on map change. PvP areas are unaffected.

### Agents

Settings sit under `Settings › Minimap › Agents` with three sub-panels:

#### Agent Colors

- AoE auras: **EoE**, **QZ**, **Winnowing**, **Frozen Soil**, **Symbiosis** — the picker is the rim colour; the centre is the same hue with alpha-50, gradient in between.
- **Target** — border surrounding the currently targeted agent.
- **Player (alive)** / **Player (dead)** — you.
- **Signpost** / **Item** — interactive props / ground items.
- **Hostile (>90% HP)** / **Hostile (dead)** — enemies; below 90% HP they shift by the *Agent damaged modifier*.
- **Ally (NPC Quest Giver)** / **Ally (dead)** — apply across every friendly allegiance.
- **Neutral**, **Ally (player)**, **Ally (NPC)**, **Ally (spirit)** and **Ally (minion)** have moved to seeded rows in **Custom Agents** below, so they're reorderable and filterable alongside your own custom colours.
- **Agent modifier** — subtracted at the border and added at the centre of every agent to create a shaded look. Set to 0 for flat-colour agents.
- **Agent damaged modifier** — subtracted from hostile agents under 90% HP.
- **Marked Target** — outline colour for agents highlighted via [`/marktarget`](#chat-commands).
- **Restore Defaults** — reset every colour and per-row size override in this sub-panel.

#### Agent Sizes

- **Default Size** — every agent except the player, signposts, items, and bosses.
- **Player Size** / **Signpost Size** / **Item Size** / **Boss Size**. (Minion size moved to the **Ally (Minion)** row in Custom Agents.)
- **Marked Target Size** — size of agents highlighted via `/marktarget`.
- **Marked Targets Inherit Custom Size/Shape** `Settings › Minimap › Agents › Marked Targets Inherit Custom Size/Shape` — When on, marked agents that also have a Custom Agent entry use *that* entry's size and shape instead of the marked-target defaults.
- **Default Shape** / **Player Shape** / **Other Player Shape** — pick from `Tear`, `Circle`, `Square`, `Big Circle`.
- **Restore Defaults** — reset every size in this sub-panel.

#### Custom Agents

Override colour/size/shape per model id, or per agent allegiance. Shown in a scrollable list with a **Filter** box (matches on **Name** or **Group**, display-only — it doesn't change list order). **Add Agent Custom Color** appends a new row. Each row exposes:

- **Visible** toggle, **Name** (free-text label), **Group** (free-text tag, e.g. `Farming`, used only for the filter box above).
- **Match by** — `Model ID` (a specific agent) or an allegiance (`Ally`, `Neutral`, `Enemy`, `Spirit/Pet`, `Minion`, `NPC/Minipet`) that matches every living agent of that type. Matching by allegiance shows extra **Dead state** and **Quest state** filters and disables the **Model ID** field.
- **Model ID** (when matching by Model ID) / **Map ID** (`0` = all maps).
- **Combat** — `In combat` / `Not in combat` / `Either`.
- **Weapon** — `Has weapon` / `No weapon` / `Either`.
- **Color** / **Text color** / **Size** / **Shape** — each with an *enable* checkbox; leave unchecked to fall through to the defaults.
- **Move Up / Move Down / Delete** — entries are evaluated top-to-bottom, so order matters when multiple rules could match. The seeded default rows (**Neutral**, **Ally**, **Ally (NPC)**, **Ally (Spirit/Pet)**, **Ally (Minion)**) can't be deleted, only disabled via the **Visible** toggle.

### Ranges

Under `Settings › Minimap › Ranges`. Reference radii in gwinches: aggro 1012, cast 1248, spirit 2512, extended 3500, compass 5000.

Ranges are now a fully editable list rather than a fixed set of circles. Each row has:

- **Visible** toggle, free-text **Label**, **Radius** (1–10000 gwinches), **Origin** (`Player` or `Target`), **Thickness** in pixels, **Color**, and **Move Up / Move Down / Delete** controls.
- **Add Circle** `Settings › Minimap › Ranges › Add Circle` — append a new circle to the list.

#### Special Range Circles

A separate sub-panel for the conditional ranges that aren't user-configurable, beyond their colour:

- **HoS range** — shown when you have Heart of Shadow / Viper's Defense, with a line away from your target showing where you would land.
- **Chain Aggro range (enemy target)** — aggro radius around your current enemy target.
- **Res Aggro range (dead ally target)** — aggro radius around a dead ally you're considering resurrecting.
- **Shadow Step range** — Recall range; the **Shadow Step Line** (in *Pings and drawings*) fades from one colour to another as you approach this limit.

### Pings and drawings

Under `Settings › Minimap › Pings and drawings`.

- **Drawings** — lines drawn by you and party members.
- **Pings** — single-click pings.
- **Shadow Step Marker** — the dot at your origin when you cast Shadow of Haste / Shadow Walk / Aura of Displacement / Shadow Meld.
- **Shadow Step Line** — the connecting line from you to that marker (so you can see if terrain blocks the return).
- **Shadow Step Line (Max range)** — the colour the line interpolates toward as you approach Recall range.
- **Max range start** / **Max range end** — fraction of Recall range (0.0–1.0) where the line starts changing colour and where it reaches the max-range colour.

### AoE Effects

Under `Settings › Minimap › AoE Effects`. A colour per spell footprint that the minimap will trace when an enemy casts it:

`Chaos Storm`, `Maelstrom`, `Savannah Heat`, `Breath of Fire`, `Lava font`, `Churning Earth`, `Barbed Trap`, `Flame Trap`, `Spike Trap`.

### Symbols

Under `Settings › Minimap › Symbols`.

- **Active quest marker** — the star for your current active quest (becomes an arrow on the compass edge if the goal is out of range).
- **Quest line color** — the line drawn from you toward the quest goal.
- **Other quest markers** — colour used for non-active quests when **Draw all quest markers** is enabled. If this colour's alpha is `0`, inactive markers are given random colours instead.
- **North marker** — arrow on the northernmost point of the compass.
- **Symbol modifier** — same shading effect as *Agent modifier*, but applied to symbols.

#### Cardinal directions

- **Color** — colour of the `N` / `S` / `E` / `W` labels on the compass edge.
- **Offset** — game-unit offset from the compass edge (positive = outward, negative = inward). Range −1000 to 1000 gwinches.
- **Font size** — 16–56 px.

### Terrain

Under `Settings › Minimap › Terrain`.

- **Map** — the area agents can move within.
- **Shadow** — same shape as Map, offset slightly to fake thickness.
- **Background** — the area behind the map.
- **Restore Defaults** — reset all three colours.

### Custom Drawings

Custom drawings let you annotate the minimap (and, optionally, the 3D world) with lines, circles, and polygons. Stored in `Markers.ini` in your settings folder, which is safe to share or merge from other players.

#### Custom Lines

Under `Settings › Minimap › Custom Drawings › Custom Lines`.

A global **Color** picker at the top of the sub-panel sets the default for newly-added rows. Each row:

- **Visible** toggle, **X1 / Y1 / X2 / Y2** endpoints, per-line **Color**, **Map ID** (`0` = all maps), free-text **Name**.
- **Draw on in-game terrain** — render this line in the 3D world too (see [In-game rendering](#in-game-rendering)).
- **Move Up / Move Down / Delete**.
- **Add Line** — append a new row.

Use the [Info](/docs/info/) window to read off coordinates and the current Map ID.

#### Custom Circles (Markers)

Under `Settings › Minimap › Custom Drawings › Custom Circles`.

- **Visible** toggle, **X / Y** center, **Size** (radius), **Type** (`Circle` outline or `FillCircle`), per-marker **Color**, **Map ID**, **Name**.
- A secondary colour overrides the rendering of **hostile agents inside the marker** — useful for highlighting pull spots or kill boxes. Alpha 0 disables this overlay.
- **Draw on in-game terrain** — project the circle onto the 3D world.
- **Move Up / Move Down / Delete**.
- **Add Marker** — append a new row.

#### Custom Polygons

Under `Settings › Minimap › Custom Drawings › Custom Polygons`.

Polygons need at least 3 points. Each row:

- **Visible** toggle, **Show Points (N)** to expand the per-point editor, **Filled** toggle (filled rendering is limited to a maximum number of points; outline-only above that), **Color** of the polygon outline / fill, hostile-agent-inside overlay colour (alpha 0 disables), **Map ID**, **Name**.
- **Draw on in-game terrain** — project the polygon onto the 3D world.
- When expanded: each point exposes an `X, Y` field and a delete button. **Add Polygon Point** appends a point.
- **Move Up / Move Down / Delete** at the polygon level.
- **Add Polygon** — append a new polygon.

### Hero flagging

Under `Settings › Minimap › Hero flagging`.

- **Show hero flag controls** `Settings › Minimap › Hero flagging › Show hero flag controls` — Show the row of `All / 1 / 2 / 3 / … / 7 / 8 / Clear` flag buttons next to the minimap.
- **Attach to minimap** `Settings › Minimap › Hero flagging › Attach to minimap` — Pin the buttons to the minimap. Disable to make the row a free-standing window — move/resize it via **Unlock Move All** at the top of the Settings window.
- **Background** — background colour of the flag-controls row.

Hero flag buttons only appear in explorable areas while you have heroes in your party.

### In-game rendering

Under `Settings › Minimap › In-game rendering`. **Beta** — these settings drive the per-marker *Draw on in-game terrain* toggle. The renderer draws over your character, world props, and UI elements, so treat it as an overlay.

- **Maximum render distance** — game-units. Markers beyond this distance from your camera are skipped. Range 0–10000.
- **Interpolation granularity** — Number of interpolation points along curved segments. Higher is smoother but costlier. Range 0–100.
- **Fog factor** — 0.0 disables fog; 1.0 is maximum.

### Bosses and other agent behaviour

These settings sit at the bottom of the settings panel rather than inside a named header.

- **Show boss by profession color on minimap** `Settings › Minimap › Show boss by profession color on minimap` — Tint bosses by primary profession. Enabling the option reveals a sub-panel with one colour picker per profession (Warrior, Ranger, Monk, Necromancer, Mesmer, Elementalist, Assassin, Ritualist, Paragon, Dervish).
- **Show hidden NPCs** `Settings › Minimap › Show hidden NPCs` — Show NPCs that aren't normally on the compass (minipets, invisible NPCs, etc.).
- **Show symbol for quest NPCs** `Settings › Minimap › Show symbol for quest NPCs` — Draw a star next to NPCs that have quest progress available.
- **Agent Border thickness** `Settings › Minimap › Agent Border thickness` — Border around every agent (0–100).
- **Target Border thickness** `Settings › Minimap › Target Border thickness` — Border around your current target (0–100).

### Allow mouse click-through

Pass the mouse through the minimap to the game underneath, separately for:

- **Explorable areas** `Settings › Minimap › Explorable areas`
- **Outposts** `Settings › Minimap › Outposts`

### Hold + Click modifiers

Pick which modifier key gates each click-on-minimap behaviour. Each setting is a combo of `None / Ctrl / Shift / Alt` (or combinations):

- **Draw** `Settings › Minimap › Draw:` — Ping and draw on the compass.
- **Target** `Settings › Minimap › Target:` — Click an agent on the minimap to target it.
- **Drag** `Settings › Minimap › Drag:` — Pan the minimap view outside party range.
- **MoveTo** `Settings › Minimap › MoveTo:` — Start walking your character to the clicked spot.

### Rotation and shape

- **Reduce agent ping spam** `Settings › Minimap › Reduce agent ping spam` — Repeated pings on the same agent extend the duration of the existing ping rather than stacking new ones.
- **Map Rotation** `Settings › Minimap › Map Rotation` — On = rotate with the camera (like the compass). Off = stays north-up (like the mission map).
- **Flip when reversed** `Settings › Minimap › Flip when reversed` — Flip 180° when you reverse-camera.
- **Map rotation smoothing** `Settings › Minimap › Map rotation smoothing` — Match the rotation speed of the in-game compass instead of snapping.
- **Circular** `Settings › Minimap › Circular` — Circle (default) vs. square minimap shape.

## Chat Commands

Hero flagging:

- `/flag` or `/flag all` — Flag all heroes to your current position.
- `/flag all x y` — Flag all heroes to the given coordinates.
- `/flag <1-8>` — Flag the numbered hero to your current position.
- `/flag <1-8> x y` — Flag the numbered hero to coordinates.
- `/flag <1-8> clear` — Unflag the numbered hero.
- `/flag <1-8> toggle` — Toggle the numbered hero's flag.
- `/flag clear` — Unflag all heroes.

Target marking (uses the **Marked Target** colour and size from the Agents settings):

- `/marktarget` — Mark your current target so it stays highlighted on the minimap.
- `/marktarget clear` or `/marktarget remove` — Unmark the current target.
- `/marktarget clearall` or `/clearmarktarget` — Clear every marked target.

---

# Miscellaneous Widgets

Source: https://www.gwtoolbox.com/docs/misc_widgets/

GWToolbox++ includes several small but useful widgets that enhance your gameplay experience. Each lives in its own settings section — see the heading on each entry below for the exact path.

## Latency Widget

The Latency Widget displays your current ping to the server. It helps you monitor your connection quality in real-time.

`Settings › Latency`

- Shows current ping in milliseconds
- Color-coded display (green for good, red for poor connection)
- Option to show average ping
- Customizable red ping threshold
- Adjustable font size

## Clock Widget

The Clock Widget shows the current time on your computer.

`Settings › Clock`

- Displays current time
- Option for 12-hour or 24-hour format
- Option to show or hide seconds

## Vanquish Widget

The Vanquish Widget helps you track your progress in vanquishing areas.

`Settings › Vanquish`

- Shows the number of foes defeated and remaining
- Only visible in Hard Mode explorable areas
- Click to announce progress in chat

For an overlay drawn on top of the in-game mission map, see the [Vanquish Overlay](/docs/vanquish_overlay/) doc.

## Server Info Widget

The Server Info Widget displays information about the game server you're connected to.

`Settings › Server Info`

- Shows the server's IP address
- Displays the server's geographical location (city and country)

## Alcohol Widget

The Alcohol Widget helps you track your character's alcohol level and duration.

`Settings › Alcohol`

- Displays remaining time of alcohol effect
- Shows current alcohol level
- Option to only show when drunk

## World Map Widget

The World Map Widget adds extra functionality to the in-game world map — see the dedicated [World Map](/docs/world_map/) doc for the full feature list.

`Settings › World Map`

- Option to show all areas on the map, including those you haven't unlocked
- Quick toggle for Hard Mode
- Option to show Elite Skill capture locations
- Only visible when the world map is open

## Notepad Window

The Notepad Window provides a simple text editor within the game for taking notes or storing information.

Open from `Toolbox › Notepad` or with `/show notepad`.

- Allows you to write and store text within the game
- Automatically saves your notes when you close the window
- Persists between game sessions
- Supports basic text input, including multi-line entries
- Resizable window for comfortable viewing and editing

The Notepad Window is particularly useful for keeping track of important information, to-do lists, or any other text-based notes you want to have readily available while playing.

---

# Party Window Enhancements

Source: https://www.gwtoolbox.com/docs/party_window/

All settings for this module live under `Settings › Party Settings`.

GWToolbox++ extends the in-game party window (P) with a handful of quality-of-life features: showing player numbers next to names, renaming summoned allies to the elite skill they cast, cleaning up dead imperial summons, attaching extra NPCs to the *Allies* list so they get a health bar in the party window, and sorting your party by profession.

This page documents only the controls under `Settings › Party Settings`. Other "party-adjacent" features have their own pages:

- [Damage Monitor](/docs/damage_monitor/) — per-player damage tracking that snaps to the party window.
- [Miscellaneous Widgets](/docs/misc_widgets/) — Bonds widget, Health/Distance widget, and other party-window overlays.

## Player Numbers

- **Add player numbers to party window** `Settings › Party Settings › Add player numbers to party window` — Appends each player's instance number in parentheses to their name in the party window (for example, `PlayerName (3)`). Only takes effect on the next map load and is suppressed in PvP areas (Alliance Battle, Arena, GvG, Hero Battles, HA, Zaishen Battle, Competitive Mission).

## Summon Renaming

- **Rename Tengu and Imperial Guard Ally summons to their respective elite skill** `Settings › Party Settings › Rename Tengu and Imperial Guard Ally summons to their respective elite skill` — Replaces the agent name of newly-spawned Imperial Guard and Tengu summoning-stone allies with the elite skill they bring (e.g. *Crippling Slash*, *Triple Chop*, *Barrage*, *Hundred Blades*, *Broad Head Arrow*, *Aura of the Lich*, *Sandstorm*, etc.). Only applies to summons that spawn after the option is enabled — existing summons are not renamed.

- **Remove dead imperial guard allies** `Settings › Party Settings › Remove dead imperial guard allies` — When an Imperial Guard summon (Crippling Slash, Quivering Blade, Triple Chop, or Barrage) dies, its entry is removed from the party window's Allies list so it does not clutter the bar with a corpse.

## Special NPCs in the Party Window

- **Add special NPCs to party window** `Settings › Party Settings › Add special NPCs to party window` — Toggles the feature that promotes selected NPCs into the *Allies* section of the party window when they spawn within compass range, so you can see their health bar without having to click them. Only works in explorable areas and only on friendly NPCs — not enemies, minions, or spirits. Disabling the option removes any previously added allies on the next pass.

When enabled, the settings panel expands to show the editable NPC list:

- **Name** — Label shown in the list (also used in the flash message when adding/removing).
- **Model ID** — The NPC's model id. NPCs match by model id only — different models of the same "kind" need separate entries.
- **Map** — The map this entry applies to. `Any` matches everywhere; a specific map restricts the entry to that outpost/explorable. Edit by removing and re-adding with a different Map ID.
- **X** — Remove this entry from the list.

**Add new** lets you append a row:

- **Name** `Settings › Party Settings › Name` — Display alias for the entry.
- **Model ID** `Settings › Party Settings › Model ID` — Model id of the NPC to add. Must be greater than 0.
- **Map ID (0 = Any)** `Settings › Party Settings › Map ID (0 = Any)` — Restrict the entry to a single map by id, or leave at `0` to match every map.
- **Add** `Settings › Party Settings › Add` — Adds the row to the list. The current map is rechecked immediately so matching NPCs already in compass range are added without waiting for the next spawn.

A starter set of entries is created the first time the module loads (with no saved settings), covering:

- **Underworld** — friendly spirits in The Vale (2 entries) and The Pits (4 entries).
- **Fissure of Woe** — Griffons and the Forgemaster.
- **Polymock summons** — Mursaat Elementalist, Flame Djinn, Ice Imp, Naga Shaman (any map).
- **Ebon Vanguard Assassin** summons (any map).
- **Ben Wolfson** (Pre-Searing, any map).
- **Mission bonus NPCs** — Gyala Hatchery siege turtle, Rornak Stonesledge (The Frost Gate bonus), Oink (Gates of Kryta bonus), Restless Spirit (Sanctum Cay bonus), Captain Besuz (Blacktide Den bonus).

## Custom Party Sorting

- **Add custom sorting to party window** `Settings › Party Settings › Add custom sorting to party window` — Reorders the player list inside the party window based on profession (and optionally map / party size), instead of the default join order. Sorting reruns when a player joins or leaves, when a profession changes, and on map load.

When enabled, the panel expands to a table of sorting rules. Each row matches against the current map and party size; the most specific matching rule wins (a rule with a fixed map beats one with `Any Map`, and a rule with a fixed party size beats one with `Any`).

Columns:

- **Map** — `Any Map`, the resolved map name, or `Map <id>` if the name isn't loaded yet.
- **Party Size** — `Any`, or the exact number of players the rule applies to.
- **Sort Order** — The profession sequence as `Primary/Secondary -> Primary/Secondary -> …`. `None` in either slot means "wildcard". Higher up in the list = earlier in the party window.
- **Edit** `Settings › Party Settings › Edit` — Loads the rule into the editor below.
- **Delete** `Settings › Party Settings › Delete` — Removes the rule.

### Editing a sorting rule

The editor below the list applies to either a new rule or the rule currently being edited:

- **Map ID (0 = Any)** `Settings › Party Settings › Map ID (0 = Any)` — Restrict the rule to a single map id, or `0` to match anywhere. When non-zero, the resolved map name is shown next to the input.
- **Party Size (0 = Any)** `Settings › Party Settings › Party Size (0 = Any)` — Restrict to a specific party size from 1 to 12, or `0` for any size.
- **Profession Order** — Ordered list of profession slots. Each slot is a `Primary / Secondary` pair; leaving either as `None` makes that half a wildcard. Each player is placed at the first slot they match best (primary + secondary match beats primary-only beats secondary-only); players who match no slot fall to the end.
  - **▲ / ▼** — Move the slot up or down in the order.
  - **Remove** — Delete the slot.
- **Add Profession** `Settings › Party Settings › Add Profession` — Append a new `None/None` slot to the order.
- **Add Sorting** / **Save Changes** `Settings › Party Settings › Add Sorting` — Commit the new rule, or save changes to the rule being edited. At least one profession slot is required.
- **Cancel** `Settings › Party Settings › Cancel` — Discard edits and return to "add new" mode (only shown while editing).

## Party Search Offline Reminder

When you create or update a party search while your friend-list status is **Offline**, Toolbox flashes a reminder:

> You're currently offline, and won't receive party search responses.
> Type '/online' in chat to set your status to Online.

The reminder is rate-limited to once every 10 seconds and has no setting — it always triggers when the conditions are met.

---

# Party Statistics

Source: https://www.gwtoolbox.com/docs/party_statistics/

The Party Statistics window records how many times each party member has cast each of their skills, and displays the counts as a grid of skill icons per member. It only collects data in explorable areas — in an outpost the window shows *Statistics will update in explorable area*, and the counts reset when you leave.

This is separate from the [Damage Monitor](/docs/damage_monitor/), which tracks damage dealt rather than skill usage.

## Display options

Settings for this window live under `Settings › Party Statistics`.

- **Show the absolute skill count** — Shows the raw number of times each skill was cast under its icon.
- **Show the percentage skill count** — Shows each skill's share of that member's total casts, as a percentage.
- **Print skill statistics by Ctrl+LeftClick** — Enables printing a member's stats to chat: hold **Ctrl** and left-click a member's section in the window to send their per-skill counts to **team chat** (one line per skill, e.g. *PlayerName used Barrage 12 times.*).

Printing is **text only** — nothing is saved to disk as a screenshot or file. The lines go into the in-game chat log like any other team-chat message.

## Chat command

The same output is available through the `/skillstats` command (see [Commands](/docs/commands/)):

- `/skillstats` — Print your own skill statistics.
- `/skillstats <player_number>` — Print statistics for the party member at that slot (1-based).
- `/skillstats <player_number> <skill_number>` — Print a single skill (1–8) for that member.
- `/skillstats reset` — Clear all collected statistics.

---

# Target Widgets

Source: https://www.gwtoolbox.com/docs/target_widgets/

GWToolbox++ provides several widgets that display information about your current target, enhancing your gameplay experience and decision-making. Each one has its own section in the settings panel — see the headings below for the exact path.

## Distance Widget

The Distance Widget shows the distance between you and your current target.

`Settings › Distance`

### Features:
- Displays the distance as a percentage of compass range and/or absolute value
- Color-coded based on different range thresholds (Adjacent, Nearby, Area, Earshot, Spellcast, Spirit, Compass)
- Updates in real-time as you or your target moves

### Usage:
- The widget appears automatically when you target an agent
- You can customize its appearance and display options in the GWToolbox++ settings

## Health Widget

The Health Widget displays the health of your current target.

`Settings › Health`

### Features:
- Shows target's health as a percentage and/or absolute value
- Color-coded based on customizable health thresholds
- Supports custom thresholds for specific skills, maps, or agent models

### Usage:
- The widget appears automatically when you target an agent
- You can set up custom thresholds in the GWToolbox++ settings
- Ctrl+Click on the widget to print the target's current health in chat

## Target Info Window

The Target Info Window provides detailed information about your current target, sourced from the Guild Wars Wiki.

Open from `Toolbox › Target Info` or with `/show targetinfo`. Settings live under `Settings › Target Info`.

### Features:
- Displays the target's name and image (if available)
- Lists skills used by the target
- Shows armor ratings for different damage types
- Provides additional details from the target's wiki infobox

### Usage:
- The window automatically updates when you select a new target
- Click on skill icons to open their respective wiki pages
- Click on damage type icons to learn more about that damage type
- Use the "View More on Guild Wars Wiki" button to open the full wiki page for the target

## Customization

All these widgets can be customized in the GWToolbox++ settings:
- Enable or disable each widget
- Adjust positions and sizes
- Customize colors and transparency
- Set up custom thresholds and display options

Remember, while these features can greatly enhance your gameplay, they are not official parts of Guild Wars. Use them responsibly and in accordance with the game's terms of service.

---

# Enemy Window

Source: https://www.gwtoolbox.com/docs/enemy_window/

All settings for this widget live under `Settings › Enemy Window`.

The Enemy Window is a feature in GWToolbox++ that provides detailed information about nearby enemy units. This tool is useful for monitoring enemy status, health, and recent skill usage across various game modes.

## Features

1. **Enemy List**: Displays a list of nearby enemy units within a specified range.

2. **Health Bars**: Shows the current health of each tracked enemy.

3. **Level Display**: Optionally shows the level of each enemy.

4. **Last Used Skill**: Optionally displays the last skill used by each enemy.

5. **Health Regeneration**: Shows the health regeneration rate (in pips) for each enemy.

6. **Status Indicators**: Visual indicators for enchanted, hexed, and conditioned states.

7. **Target Selection**: Allows you to target an enemy by clicking on their entry in the window.

8. **Distance-based Sorting**: Enemies are sorted by their distance from the player.

## Settings

The Enemy Window can be customized with the following settings:

- **Range**: Adjust the range (in game units) within which enemies are tracked.
- **Show level**: Toggle the display of enemy levels.
- **Show enemy last skill**: Toggle the display of the last skill used by each enemy.
- **HP thresholds**: Set the health threshold below which enemy info is displayed.
- **Last skill casted threshold**: Set the duration for which the last used skill is displayed.
- **Status triangle spacing**: Adjust the spacing of status indicator triangles.

## Usage

1. Enable the Enemy Window in GWToolbox++ settings.
2. The window will display information about nearby enemies in all game modes.
3. Use the information to make tactical decisions about targeting, skill usage, and positioning.
4. Click on an enemy's entry to target them in-game.

This tool is valuable for PvE scenarios, providing quick access to important enemy information without the need to manually target and inspect each unit. It can help players make faster, more informed decisions during combat.

---

# Item Management Features

Source: https://www.gwtoolbox.com/docs/items/

GWToolbox++ provides several advanced item management features to enhance your gameplay experience. These features are designed to streamline inventory management, improve item filtering, and provide convenient shortcuts for common item-related tasks.

## Inventory Manager

The Inventory Manager module offers the following functionality:

- **Ctrl+Click to move between inventory and storage**: hold Ctrl and click an item to send it to storage (or back to your inventory if the storage pane is open).
  `Settings › Inventory Settings › Move items from/to storage with Control+Click`
- **Move to the currently open storage pane**: when the option above is on, Toolbox can prefer the pane you have open instead of any free slot.
  `Settings › Inventory Settings › Move items to current open storage pane on click`
- **Materials to the open storage pane**: same idea, scoped specifically to materials so you can still consolidate ectos / shards into the materials pane.
  `Settings › Inventory Settings › Move materials to current open storage pane on click`
- **Auto-Salvage**: Ctrl+Click a salvage kit to open the Salvage All window for every salvageable item of a chosen rarity.
  `Settings › Inventory Settings › Salvage All with Control+Click`
- **Auto-Identify**: Ctrl+Click an identification kit to identify everything in the selected bags.
  `Settings › Inventory Settings › Identify All with Control+Click`
- **Pick which bags to salvage from**: tick only the bags you want the bulk operations to consider.
  `Settings › Inventory Settings › Salvage from: Backpack / Belt Pouch / Bag 1 / Bag 2`
- **Right-click context menu**: extra options on items in inventory or storage (move stack, identify, salvage, send to merchant).
- **Move whole stacks by default**: when offering a stackable item in a trade window, Toolbox automatically accepts the maximum quantity — bypassing the per-item quantity prompt entirely. Hold **Shift** while dragging to bring up the quantity prompt instead.
  `Settings › Inventory Settings › Move whole stacks by default`
- **Move items to trade**: with a trade window open, you can move an item from your inventory directly into the trade offer by **Double Click** or **Alt+Click** — no dragging required. Enable one (or neither) under:
  `Settings › Inventory Settings › Move items to trade on`

## Item Filter

The Item Filter module controls which item drops appear in the game world. Configure it in `Settings › Item Filter`.

- **Rarity-based filtering** — hide or show drops by rarity (white, blue, purple, gold, green) independently for items you can pick up and items reserved for party members.
- **Custom exceptions** — name items that should always be shown regardless of rarity, so a rare drop you're farming for never gets hidden by a broad rule.

## Merchant window

You can also hide specific items from the merchant's *Sell* window so you don't accidentally vendor them. `Settings › Inventory Settings › Merchant hidden items…`

These features combine to provide a powerful suite of tools for managing your items more efficiently in Guild Wars.

---

# Quest Functionality

Source: https://www.gwtoolbox.com/docs/quest/

GWToolbox++ includes enhanced functionality for quests, providing users with improved navigation and information display. Configure all quest-related widgets and modules under `Settings › Active Quest Info` and `Settings › Quest Module`.

## Features

### Active Quest Widget

The Active Quest Widget displays information about the currently active quest, including:

- Quest name
- Quest objectives
- Completion status of each objective

This widget provides a clear and concise view of your current quest progress, helping you stay focused on your goals.

`Settings › Active Quest Info`

### Quest Pathing

GWToolbox++ includes an advanced quest pathing feature that calculates the optimal route to your quest objective. This feature:

- Automatically calculates a path to the quest marker
- Updates the path in real-time as you move
- Displays the path on the minimap
- Redirects the in-game quest marker to guide you along the calculated path

`Settings › Quest Module`

## How It Works

1. When a quest becomes active, GWToolbox++ calculates a path from your current position to the quest marker.
2. The calculated path is displayed on the minimap as a series of connected lines.
3. The in-game quest marker is updated to point to the next waypoint in the calculated path.
4. As you move, the path is continuously updated:
   - If you move significantly away from the calculated path, it will recalculate.
   - As you reach waypoints along the path, the quest marker will update to the next waypoint.

## Benefits

- Easier navigation, especially in complex areas
- Reduced time spent figuring out how to reach quest objectives
- Improved efficiency in completing quests

## Notes

- The quest pathing feature works best in areas where GWToolbox++ has accurate map data.
- In some cases, especially in very complex areas or where map data is incomplete, the calculated path may not be optimal. Always use your judgment and knowledge of the game world.
- This feature is designed to assist players, not to replace exploration or learning of the game world. We encourage players to use it as a tool to enhance their gameplay experience, not as a crutch.

Remember, while this feature can greatly assist in navigation, the joy of Guild Wars often comes from exploration and discovery. Use this tool to enhance your experience, not to diminish it!

---

# World Map

Source: https://www.gwtoolbox.com/docs/world_map/

The World Map widget extends the in-game world map (`M` by default) with extra
markers, filters, and shortcuts. It only appears while the world map is open
and is hidden everywhere else.

<img src="/docs-images/world_map.webp" alt="World map of Cantha with the toolbox controls panel in the top-left and quest/elite-capture markers overlaid" />

## Features Overview
* **Show all areas** — reveals every outpost on the current continent, even
  ones you have not unlocked. Useful for picking a travel destination without
  needing to manually clear fog of war.
* **Hard mode** toggle — when you are in an outpost, the same checkbox the
  party window uses to switch difficulty is mirrored here, so you can flip
  modes without leaving the map.
* **Toolbox minimap lines** — any custom lines, circles, or polygons you have
  drawn on the [Minimap](/docs/minimap/) are projected onto the world map so
  you can see your run plans in context.
* **Quest markers for all quests** — by default Guild Wars only shows the
  marker for your active quest. With this option every quest in your log gets
  its goal pinned to the world map, decoded and color-coded.
* **Quest marker color overlays** — tints the *region* around each quest
  marker so it stands out at a glance. The active quest and "other" quests use
  separate colors, both editable from the same controls panel.
* **Elite capture locations** — overlays every boss that drops an elite skill,
  filtered by the profession buttons. Right-click a boss to travel to its
  nearest outpost or jump straight to the boss/skill wiki page. If the
  [Completion Window](/docs/completion/) is enabled, elites you've already
  captured on the current character can be hidden.

## Right-click context menus
The widget hooks the world map's right-click menu and adds extra entries:
* **Anywhere on the map** — drops a custom quest marker at the clicked point
  (handy as a personal waypoint when planning a run).
* **On a quest marker** — Set active quest, Travel to nearest outpost, open
  the quest on the Guild Wars wiki.
* **On an elite boss marker** — Travel to nearest outpost, open the boss page
  on the wiki, open the elite skill page on the wiki.

Quest markers also show a tooltip on hover that includes the Zaishen coin
reward (normal-mode and hard-mode) for that quest, when applicable.

## Settings
There are no settings under the regular GWToolbox settings panel — the
controls are baked into the widget itself, so you only see them when the
world map is actually open. Your selections are saved between sessions.

---

# Mission Map

Source: https://www.gwtoolbox.com/docs/mission_map/

The Mission Map widget draws extra information on top of the in-game mission
map (`U` by default). It is not a separate window — everything it adds paints
directly onto the game's map, so it scales and pans with the map itself.

All settings for this widget live under `Settings › Mission Map`.

## Lines and quest paths
Custom lines you have drawn on the [Minimap](/docs/minimap/), and the calculated
path to your [active quest](/docs/quest/), can be projected onto the mission map:

* **Draw all minimap lines** (on by default) — also show lines that are set to
  draw on the minimap.
* **Draw all terrain lines** (off by default) — also show lines that are set to
  draw on the in-game terrain.

Lines explicitly set to draw on the mission map always appear regardless of
these two toggles.

## Show the minimap on the mission map
Enabling **Show minimap on mission map** overlays the [Minimap](/docs/minimap/)
layers on top of the game's mission map, using the same colours, agent styles
and range circles you have already configured for the minimap. It is **off by
default**, so the mission map is unchanged until you turn it on.

The layers are always drawn north-aligned (the mission map never rotates) and
follow the map as you pan and zoom. Each can be toggled individually:

* **Range rings** — your configured range circles, centred on your character.
* **Agents** — players, enemies and NPCs as the minimap's shaped/coloured markers.
* **Pings & drawings** — compass pings and player drawings.
* **Effects** — AoE spell footprints.
* **Background** — the minimap background fill.
* **Pathing map (terrain)** — the accurate walkable-area map.
* **Symbols** — quest markers and other minimap symbols.

Use the **Customise minimap (colours, agents, ranges)…** button to jump
straight to the [Minimap](/docs/minimap/) settings, where the appearance of
all of these is configured.

## Click to target
With the minimap overlay shown, **Click to target** lets you left-click
(without dragging) anywhere on the mission map to target the nearest agent to
that point — the same targeting the minimap offers. Click-and-drag is left to
the game so you can still pan the map as normal. This option only applies while
the minimap overlay is shown.

## See also
* [Minimap](/docs/minimap/) — the full compass replacement and where its
  appearance is configured.
* [Vanquish Overlay](/docs/vanquish_overlay/) — fog-of-war, enemy tracking and
  navigation drawn on the same mission map.
* [World Map](/docs/world_map/) — the equivalent extras for the continent map (`M`).

---

# Vanquish Overlay

Source: https://www.gwtoolbox.com/docs/vanquish_overlay/

<img src="/docs-images/vanquish_overlay.webp" alt="Mission map of Witman's Folly with the Vanquish Overlay enabled, showing fog of unexplored area, frontier edge, compass range circle and blue/orange enemy markers" />

The Vanquish Overlay draws extra information on top of the in-game mission
map (`U` by default) to help you plan and finish vanquishes in Hard Mode.
It complements the small numeric [Vanquish](/docs/widgets/#vanquish) widget
by showing *where* the work is, not just how many enemies are left.

This is not a separate map — the overlay paints directly on top of the
game's mission map, so it scales and pans with the map itself.

## Features Overview
* **Map border and inaccessible areas** are outlined and shaded so the
  walkable region of the zone is obvious at a glance — particularly useful
  in maps with disjoint islands or hidden corners.
* **Fog of explored area** dims the parts of the zone you haven't been near
  yet during this instance. As you walk around the fog clears, with a bright
  **frontier edge** marking the boundary of explored territory. Restarting
  the instance resets the fog.
* **Compass range circle** centered on your character shows the same radius
  the minimap uses, so you can judge how much of the zone is currently
  within enemy-tracking range.
* **Enemy markers** appear for every foe that has entered compass range:
    - **Blue** — alive and currently tracked.
    - **Orange** — last known position, with a small arrow pointing in the
      direction they were last moving. Useful for catching wanderers that
      left compass range before you could engage.
* **Enemy count label** shows how many of the foes that count toward the
  vanquish are currently located (alive + last-known), separate from the
  global "killed / remaining" figure on the Vanquish widget.

## Controls
* A small skull button (<code>&#x1F480;</code>) sits in the bottom-left corner
  of the mission map and toggles the overlay on and off. Hover it for a
  tooltip describing the current state.
* **Right-click the mission map** to open its context menu. While the overlay
  is active and you are in an explorable area, two extra entries appear:
    - **Navigate to closest enemy** — auto-runs your character toward the
      nearest tracked enemy.
    - **Stop navigating** — cancels an in-progress navigation.
* **Ctrl+click** on the numeric Vanquish widget reports the vanquish status to
  party chat, including the located-enemy count contributed by the overlay.

## When it's visible
The overlay only draws while you are in an *explorable area*, with the
mission map open, and with the overlay toggled on. Outside those conditions
the skull button is shown disabled so you can still toggle the setting from
inside an outpost.

## Settings
Color and size controls are under Settings → Vanquish Overlay:
* **Inaccessible area** — fill color for non-walkable space outside the
  map border.
* **Map border** — outline color of the walkable region.
* **Unexplored fog** — fill color of areas you haven't visited this instance.
* **Frontier edge** — color of the leading edge of explored territory.
* **Compass range** — color of the circle around your character.
* **Enemy (alive)** and **Enemy (last known position)** — marker fill colors
  for the two enemy states.
* **Enemy outline** — outline color drawn under every enemy marker for
  contrast against the map.
* **Enemy marker size** — pixel radius of each marker on the mission map,
  3 to 20.

---

# Camera

Source: https://www.gwtoolbox.com/docs/camera/

Toolbox includes several features that interact with the game's camera, letting you view the world from perspectives the vanilla client doesn't allow. All camera functions are driven by [chat commands](/docs/commands/) — there's no setting panel, so the annotations below show the exact command to type.

## Camera Unlock

Free the camera from your character so you can fly it around the map.

`/cam unlock` &nbsp; or &nbsp; `/camera unlock`

To re-attach the camera to your character:

`/cam lock` &nbsp; or &nbsp; `/camera lock`

## Movement

While the camera is unlocked:

- **Horizontal axis** — `W` (forward), `E` / `D` (strafe right), `S` (backward), `Q` / `A` (strafe left).
- **Vertical axis** — `Z` (up), `X` (down).
- Hold the **right mouse button** to pan and tilt with the mouse.
- Press `R` for auto-forward; press `W` or `S` to cancel.

## Other features

Toggle fog rendering:

`/cam fog on` &nbsp; / &nbsp; `/cam fog off`

Adjust how fast the unlocked camera moves (default 100):

`/cam speed 200`

---

# Chat Settings

Source: https://www.gwtoolbox.com/docs/chat/

All settings for this feature live under `Settings › Chat Settings`.

## Timestamps

- **Show chat messages timestamp** `Settings › Chat Settings › Show chat messages timestamp` — Show timestamps in the message history.
  - **Use 24h** `Settings › Chat Settings › Use 24h` — Display timestamps in 24-hour format.
  - **Show seconds** `Settings › Chat Settings › Show seconds` — Include seconds in the timestamp.
  - **Color** `Settings › Chat Settings › Color:` — Customize the timestamp color.

## Chat Bubbles

- **Hide player chat speech bubbles** `Settings › Chat Settings › Hide player chat speech bubbles` — Don't show in-game speech bubbles over player characters that send a message in chat.
- **Hide all friendly speech bubbles** `Settings › Chat Settings › Hide all friendly speech bubbles` — Don't show any in-game speech bubbles from friendly entities.
- **Show NPC speech bubbles in emote channel** `Settings › Chat Settings › Show NPC speech bubbles in emote channel` — Speech bubbles from NPCs and heroes appear as emote messages in chat.

## Message Redirection

- **Redirect NPC dialog to emote channel** `Settings › Chat Settings › Redirect NPC dialog to emote channel` — Messages from NPCs that would normally show on-screen and in team chat are instead redirected to the emote channel.
- **Redirect outgoing whispers to whisper channel** `Settings › Chat Settings › Redirect outgoing whispers to whisper channel` — Whispers you send appear blue like an incoming message, with `->` before the name.

## Link Handling

- **Open web links from templates** `Settings › Chat Settings › Open web links from templates` — Clicking a template with a URL as its name opens that URL in your browser.
- **Automatically change urls into build templates** `Settings › Chat Settings › Automatically change urls into build templates.` — URLs (starting with `https://` or `http://`) anywhere in your messages are automatically converted to template format.

## Appearance

- **Chat window font size** `Settings › Chat Settings › Chat window font size` — Choose from Default, Large, Larger, or Largest.
- **Chat Colors** `Settings › Chat Settings › Chat Colors` — Customize the sender and message color for each chat channel: Local, Guild, Team, Trade, Alliance, Whispers, Emotes, and Other.
- **Chat Token Colors** `Settings › Chat Settings › Chat Token Colors` — Customize the highlight color of text tokens such as item rarities (Common, Uncommon, Rare, etc.) and other labeled text throughout the game.

## Other

- **Clear chat message when hiding the in-game chat window** `Settings › Chat Settings › Clear chat message when hiding the in-game chat window` — Clears any typed text when you hide the chat window.

## Chat Commands

- `/afk [message]`: Set your status to Away and optionally set an AFK message
- `/age2`: Display instance time in chat
- `/chat [all|guild|team|trade|alliance|whisper]`: Open or switch to the specified chat channel

For a full list of chat commands, see the [Chat Commands](/docs/commands/) page.

---

# Chat Filter

Source: https://www.gwtoolbox.com/docs/chatfilter/

The Chat Filter module in GWToolbox++ controls which messages appear in your chat window. You can suppress different message categories to reduce clutter and focus on what matters.

All filters live under `Settings › Chat Settings`, grouped into the sub-sections below. Each bullet is the literal checkbox label you'll find in the panel.

## Features

### Drops

- A rare item drops for you / an ally
- A common item drops for you / an ally
- An ally picks up a rare / common item
- You pick up a rare / common item

`Settings › Chat Settings › Drops › A rare item drops for you`

> "Rare" stands for a gold-name item, Ecto, Obsidian Shard, or Lockpick. "Common" is everything else.

### Announcements

- Guild Announcement
- Hall of Heroes winners
- Favor of the Gods announcements
- 'You have been playing for…'
- 'Player x has achieved title…'
- 'You gain x faction'

`Settings › Chat Settings › Announcements › Hall of Heroes winners`

### Warnings

Suppress the most common spam messages: "Unable to use item", "Invalid target", "Inventory is full", "Item already identified", "Not enough Adrenaline/Energy", "Opening chests".

`Settings › Chat Settings › Warnings › Inventory is full`

### Others

Skill points, PvP balance messages, 9 Rings, Lunar fortunes, challenge mission scores, "No one hears you", away replies, salvaging spam, ashes-dropped, targetting messages.

### Custom filters

Hide any message that contains specific words or phrases.

- Enter words or phrases, one per line.
- Matching is case-insensitive substring by default, or full regex if "Use regular expressions" is enabled.
- A line wrapped in slashes is always a regex, e.g. `/wts.*ecto/`, whichever box it's in.
- Optionally scope the filter to specific chat channels (Local, Guild, Team, Trade, Alliance, Emotes).

`Settings › Chat Settings › Hide any messages containing:`

### Hide messages by author

Block specific players' messages outright. One name per line, matched in full and not case-sensitive; a line wrapped in slashes is a regex instead, e.g. `/^Bob The/`.

`Settings › Chat Settings › Hide any messages from:`

### Channel logging

Stop the game from logging messages from chat channels you've turned off (chat history isn't unlimited).

`Settings › Chat Settings › Block messages from inactive chat channels`

## Advanced filtering

For more complex needs, tick **Use regular expressions** and treat each line of the custom-filter list as a regex pattern. Lines in that list stay case-sensitive unless wrapped in slashes with the `i` flag, e.g. `/wts.*ecto/i`.

The same slash syntax works everywhere Toolbox takes a filter you typed — chat filters, [trade and party-search alerts](./trade/) and [loot beacon name rules](./loot_beacons/).

Examples:

- `^Player.*joined the game\.` — every "Player has joined the game" message.
- `\b(rare|unique|gold)\b` — any message containing the words *rare*, *unique*, or *gold*.

Test your patterns first — a too-broad regex will quietly eat messages you wanted to see.

---

# Chat Log

Source: https://www.gwtoolbox.com/docs/chatlog/

All settings for this feature live under `Settings › Chat Log`.

The Chat Log module in GWToolbox++ enhances the in-game chat functionality by providing persistent chat history and additional features.

## Features

### Persistent Chat History
- Maintains chat history across map changes and game sessions
- Automatically saves chat logs to disk
- Loads previous chat history when starting a new session

### Extended Chat Log
- Stores more messages than the default Guild Wars chat log
- Includes both received and sent messages

### Multi-Character Support
- Maintains separate chat logs for each Guild Wars account

### Automatic Injection
- Automatically injects saved chat history into the game's chat log when changing maps or characters

## Usage

The Chat Log module works automatically in the background. Once enabled, it will:
- Save your chat history to disk periodically and when you exit the game
- Load your previous chat history when you start the game or change characters
- Inject the saved chat history into your game client's chat log

## Settings

To access Chat Log settings:
1. Open the GWToolbox++ Settings window
2. Navigate to the "Chat Log" section

Available options:
- Enable/disable the Chat Log module
- Configure the maximum number of messages to store

## File Location

Chat logs are stored in the GWToolbox++ settings folder:
```
C:\Users\[Username]\Documents\GWToolboxpp\[ComputerName]\
```

Files are named based on the account email address:
- `recv_[account_email].ini` for received messages
- `sent_[account_email].ini` for sent messages

## Notes

- The Chat Log module respects your in-game chat filter settings
- Chat history is stored securely on your local machine and is not shared or uploaded anywhere

---

# Chat Commands

Source: https://www.gwtoolbox.com/docs/commands/

GWToolbox++ adds a wide variety of chat commands that you trigger by typing them in the in-game chat box, the same way you'd use a built-in command like `/age`. Most commands also work as a [Hotkey](/docs/hotkeys/) action so you can fire them from the keyboard.

## Notation

- `<a>` denotes a **mandatory** argument.
- `[a]` denotes an **optional** argument.
- `(a|b)` denotes a choice between alternatives — pick one.
- Strings containing spaces must be wrapped in double quotes, e.g. `/button "BtnBuy"`.

## Toolbox windows and widgets

- `/tb`: Hide or show the main Toolbox window.
- `/tb <name>`: Toggle the window or widget titled `<name>`.
- `/tb save [profile]`: Save the current Toolbox settings to disk. With `[profile]`, write to that profile name; otherwise write to the default config.
- `/tb load [profile]`: Load Toolbox settings from disk (optionally from a named profile).
- `/tb reset`: Move the Settings and main Toolbox windows back to the top-left of the screen.
- `/tb close`, `/tb quit`, or `/tb exit`: Close Toolbox entirely.
- `/show [name]`: Show a window or widget by name.
- `/hide [name]`: Hide a window or widget by name.
- `/toggle [name]`: Toggle visibility of a window or widget by name.
- `/resize <width> <height>`: Resize the Guild Wars window (windowed mode only).
- `/config (set|get|toggle|load) <section> <key> [value]...`: Read or modify any Toolbox `.ini` setting from chat. `set` overwrites, `get` prints, `toggle` flips between the current value and the value on disk, `load` re-reads from disk. Multiple section/key/value tuples can be chained.

## General

- `/age2`: Print the current instance time to chat.
- `/afk [message]`: Set your status to **Away**. Optionally pass an AFK auto-reply message.
- `/chest` or `/xunlai`: Open the Xunlai Chest in any outpost.
- `/dialog <id>`: Send a dialog ID to the NPC you're currently talking to (e.g. `/dialog 0x184`). Use `/dialog take` to take the first available quest/reward from the current NPC.
- `/fps [limit]`: Set a hard frame-rate cap between 15 and 400 fps. Pass `0` to remove the cap. `/fps` with no argument prints the current limit.
- `/pref <preference> <value>`: Set an in-game preference (value 0–4). Use `/pref list` to see the available preference names.
- `/saveprefs` / `/loadprefs`: Save or restore your Guild Wars in-game preferences to/from disk.
- `/spawnblockeditems`: Re-spawn any item drops that Toolbox previously suppressed by your drop filter, so you can pick them up.
- `/resignlog [pending]`: Print the resign status of every player in your party. With `pending` (or `notresigned`), only list players who haven't resigned yet.
- `/scwiki [search terms]`: Open the Speed Clear Wiki in your browser. Optional search terms run a wiki search instead of opening the home page.
- `/hom [player_name|me]`: Open a player's Hall of Monuments page in your browser. With no argument it uses your current target; `/hom me` uses yourself.
- `/observer:reset`: Reset all data collected by the [Observer Mode](/docs/info/) module in the current instance.

## Pcons and consumables

- `/pcons [on|off]`: Turn [Pcons](/docs/pcons/) on or off. `/pcons` with no argument toggles.
- `/dropbuff <skill_id>`: Drop the first instance of an upkept skill or buff by skill ID.
- `/dropitem <model_id> [quantity]`: Drop inventory items matching the model ID, stack by stack. With no quantity, drops every matching stack; otherwise drops up to `[quantity]` in total. Only works in an explorable area, and won't drop equipped or customized items.

## Targeting and minimap

- `/target` / `/tgt`: Targeting utilities.
  - `/target closest` (or `nearest`): Target the closest agent.
  - `/target closest <filter> [name|model_id]`: Restrict the closest-target search to a type — `npc`, `item`, `gadget`, `player`, `ally`, `enemy`.
  - `/target <name|model_id> [index]`: Target the nearest NPC matching the name or model ID; `[index]` picks the N-th match. Names match on any substring, and `|` separates alternatives (e.g. `/target dhuum|dwayna`).
  - `/target player <name|player_number>`: Target the nearest player by name or player number.
  - `/target item <name|model_id>`: Target the nearest dropped item by name or model ID.
  - `/target gadget <name|gadget_id>`: Target the nearest interactive gadget.
  - `/target priority [party_member]`: Target the priority target of the given party member (defaults to yourself).
  - `/target ee`: Target the furthest ally within spell range in front of you (for Ebon Escape).
  - `/target hos` (or `vipers`): Target the furthest enemy/ally behind you within spell range (for Viper's Defense / Heart of Shadow).
  - `/target getid`: Print the target's model ID (PlayerNumber).
  - `/target getpos`: Print the target's (x, y) coordinates.
- `/call`: Call the current target the same way the in-game **Ctrl+Space** does.
- `/marktarget`: Highlight the current target on the Toolbox [Minimap](/docs/minimap/).
- `/marktarget clear`: Stop highlighting the current target.
- `/marktarget clearall`: Clear every highlighted target on the minimap.
- `/flag`: Hero flagging commands — see [Minimap → Chat commands](/docs/minimap/#chat-commands).
- `/custommarker <x> <y>`: Place a custom marker on the minimap at world-map coordinates `(x, y)`. `/custommarker clear` removes it.

## Travel and party

- `/to`, `/tp`, or `/travel <destination>`: Map-travel to an outpost. See [Travel → Chat commands](/docs/travel/#chat-commands) for the full destination list.
- `/enter (fow|uw)`: From Temple of the Ages, Zin Ku Corridor, Chantry of Secrets or Embark Beach, use a passage scroll to enter the Fissure of Woe or Underworld. Anywhere else with an enter button, `/enter` toggles the mission entry just like the in-game button.
- `/leave`: Leave the current party (no effect if you're already solo).
- `/reinvite`: Re-invite the player whose name is currently in the party invite field.
- `/addhero <name|profession>`: Add a hero to your party by name or by profession.
- `/addhenchman <name|profession>`: Add a henchman to your party by name or by profession.
- `/hero (avoid|guard|attack|target) [hero_index] [silent]`: Set hero behaviour or order them to attack your target. Without `[hero_index]`, applies to every hero. Append `silent` to suppress the hero's voice line.
- `/disableheroskill <hero_index (1-7)> <slot (1-8)> [1|0]`: Disable, enable, or toggle a hero's skill slot. Omit the trailing argument to toggle the current state.
- `/morale`: If you have a morale boost or death penalty, call it; otherwise post "I have no Morale Boost or Death Penalty!" in team chat.
- `/hm` or `/hardmode`: Switch the party to Hard Mode (if unlocked).
- `/nm` or `/normalmode`: Switch the party back to Normal Mode.
- `/tick`: Toggle your own party-ready ("ticked") state.

## Skills and builds

- `/useskill <slot>`: Repeatedly cast the skill in the given slot whenever it recharges. Use `/useskill`, `/useskill 0`, `/useskill off`, or `/useskill stop` to stop.
- `/load <template_name> [hero_index]`: Load a skill template onto your character. With `[hero_index]` (1–8), load it onto that hero instead. Pass either the name of a saved template under `Templates/Skills/` or a raw template code.
- `/loadbuild`: Load a [Builds](/docs/builds/) entry by name onto yourself. See [Builds → Chat commands](/docs/builds/#chat-commands).
- `/pingbuild <template_name> [template_name...]`: Ping one or more saved skill templates to team chat as clickable build links.
- `/herobuild` or `/heroteam <name>`: Load a saved [Hero Build](/docs/herobuilds/) onto the active hero team.
- `/skillstats [reset|<player_number>]`: From the [Party Statistics](/docs/party_statistics/) module, print skill-usage statistics for yourself, for a specific party member (by number), or `reset` to clear collected stats.
- `/bonds (add|remove) <party_index|all> (<skill_id>|all)`: Add or remove maintained-bond highlights on the [Bonds Monitor](/docs/widgets/#bonds) widget.
- `/dmg` or `/damage`: Control the [Damage Monitor](/docs/damage_monitor/#chat-commands). See that page for the full sub-command list.

## Items, inventory, and trade

- `/pingitem <slot>`: Ping a piece of equipped gear to chat.
  - `<slot>` options: `armor`, `head`, `chest`, `legs`, `boots` (or `feet`), `gloves` (or `hands`), `offhand` (or `shield`), `weapon`, `weapons`, `costume`.
- `/withdraw <quantity> [model_id1 model_id2 ...]`: Top up your inventory from storage. With model IDs, refills each up to `<quantity>`. With no model IDs, withdraws `<quantity>k` gold (use `all` to pull every coin you can hold).
- `/deposit <quantity> [model_id1 model_id2 ...]`: Inverse of `/withdraw` — store items by model ID, or `<quantity>k` gold if no model IDs are given. `all` deposits everything.
- `/sortinventory`: Sort your bags using the rules configured in the [Inventory Sorting](/docs/items/) module.
- `/sortstorage`: Same, but for Xunlai storage.
- `/pc <item>`: Run a [Trade](/docs/trade/) price-check for the named item.
- `/armory <armor_item_name> [dye1 dye2 dye3 dye4]`: Equip an armour piece (and optionally apply up to four dye colour IDs) via the [Armory window](/docs/armory_window/). `/armory reset` restores your original armour.

## Daily quests

All daily commands accept an optional `tomorrow` argument (e.g. `/zm tomorrow`) to look ahead one day.

- `/zm`: Today's Zaishen Mission.
- `/zb`: Today's Zaishen Bounty.
- `/zc`: Today's Zaishen Combat.
- `/zv`: Today's Zaishen Vanquish.
- `/wanted`: Today's Wanted by the Shining Blade target.
- `/nicholas`: Today's Nicholas the Traveler item.
- `/vanguard`: Today's Pre-Searing Vanguard quest.
- `/weekly`: This week's weekly bonus.
- `/today` or `/daily` / `/dailies`: Print all of the above in one go (uses pre-searing equivalents when applicable).
- `/tomorrow`: Same as `/today` but for tomorrow's rotation.

## Friends list

- `/t`, `/tell`, `/w`, `/whisper <player_name> <message>`: Whisper a player. Toolbox routes the message to the player's currently-logged-in character automatically.
- `/addfriend <player_name>`: Add a player to your friends list.
- `/removefriend` (or `/deletefriend`) `<player_name>`: Remove a friend.
- `/invite <player_name>`: Invite a friend to your party using their *current* character name even if you only know the account.
- `/away`, `/dnd` (or `/busy`), `/offline`, `/online`: Set your visible friend-list status.

## Chat channels

- `/chat (all|guild|team|trade|alliance|whisper)`: Open chat input on the chosen channel.

## Titles and prefs

- `/title [title_id]` or `/settitle [title_id]`: Re-apply your active title after a death/zone, or activate a specific title by ID.
- `/volume [channel] <amount (0-100)>`: Set an audio channel's volume. `[channel]` is one of `master`, `music`, `background`, `effects`, `dialog`, `ui`. Defaults to `master` if omitted.

## Camera and view

- `/cam` or `/camera <subcommand>`: Camera control:
  - `/cam (unlock|lock)`: Toggle the free camera.
  - `/cam speed <value>`: Set the unlocked-camera move speed.
  - `/cam fog (on|off)`: Enable or disable fog.
  - `/cam fov [amount]`: Set the field-of-view (no argument resets).
- `/zoom [value]`: Set the maximum zoom distance. `/zoom` with no argument resets to the default 750.

## Weather

- `/weather`: List every [Weather](/docs/weather/) condition and whether it's on.
- `/weather <condition> [on|off|toggle]`: Toggle a condition by name (names may contain spaces), or set its state explicitly (`1`/`0` also work). Turning one on turns the rest off.
- `/weather auto`: Start [automatic weather](/docs/weather/#automatic-weather) following the current map's climate (same as `/climate auto`).
- `/weather off`: Stop automatic weather and clear any running weather effects (same as `/climate off`).
- `/climate`: Show whether automatic weather is on and which climate is currently driving it.
- `/climate [auto|off|<climate>]`: Control [automatic weather](/docs/weather/#automatic-weather). `auto` follows the current map's climate, a climate name (e.g. `Tropical`) forces that climate regardless of map, and `off` stops automatic weather and clears any running weather effects.

## Appearance (transmog)

- `/transmo`: Transmog your character into the model of the currently targeted NPC (visible only to you).
  - `/transmo <size (6-255)>`: Resize without changing model.
  - `/transmo <npc_name> [size]`: Transmog into a specific NPC by name.
  - `/transmo model <npc_id> <model_file_id> <model_file> <flags>`: Manual transmog by raw model IDs.
  - `/transmo reset`: Restore your original appearance.
- `/transmotarget <npc_name> [size]`: Transmog the *target's* appearance. `/transmotarget reset` restores it.
- `/transmoparty <npc_name> [size]`: Transmog every party member. `/transmoparty reset` restores them.
- `/transmoagent <agent_id> <npc_name> [size]`: Transmog a specific agent ID — useful for scripted NPCs that don't survive a normal target click.

## Privacy

- `/obfuscate` or `/hideme`: Toggle the [Obfuscator](/docs/settings/) — hides your character name, account name and guild info in screenshots, the friends list panel, and the in-game UI.

## Teamspeak

- `/ts`, `/ts3`, `/ts5`: Ping the current Teamspeak server and your channel's join link into team chat. `/ts3` always targets the Teamspeak 3 module; `/ts5` always targets Teamspeak 5; `/ts` uses whichever client is connected.

## Reroll

- `/reroll <profession|character_name>`: Log out and log straight back in on a different character. Accepts a profession name or any substring of a character name. Skips any characters you've marked as excluded in the [Reroll](/docs/reroll/) window.
- `/rr`: Short alias for `/reroll`.

## UI buttons

- `/button <label> [label...]`: Click one or more UI buttons by their internal label, e.g. `/button "BtnBuy" "BtnAccept" "BtnOk"`. Handy for scripting NPC vendor interactions.

## Timer

- `/resettimer` or `/timerreset`: Reset the [Instance Timer](/docs/widgets/#timer) widget back to zero.

## Aliases

You can define personal aliases for any command by editing the **Chat Command Aliases** section of `GWToolbox.ini`, or via the alias panel in the [Chat](/docs/chat/) settings. Toolbox ships with three defaults:

| Alias    | Expands to       |
| -------- | ---------------- |
| `/ff`    | `/resign`        |
| `/gh`    | `/tp gh`         |
| `/armor` | `/pingitem armor`|

---

# Audio Settings

Source: https://www.gwtoolbox.com/docs/audio_settings/

All settings for this feature live under `Settings › Audio Settings`.

The Audio Settings module lets you block specific in-game sound effects. This is useful for silencing repetitive or distracting sounds — for example, the error chime that plays when a chest is already being opened, when a hero can't cast on a given target, or when Panic prevents you from casting.

## Blocking a Sound

1. Open `Settings › Audio Settings` and expand **In-Game Sound Log**.
2. Trigger the sound in-game (e.g. try to cast on an invalid target).
3. The filename of the sound will appear in the log.
4. Click **Block** next to it. The sound is now silenced and saved for future sessions.

You can click **Play** on any logged entry to preview it before deciding whether to block it.

## Blocked In-Game Sounds

Expand this section to see everything you've already blocked. Each entry has:

- **Play** — previews the sound effect.
- **Unblock** — removes the block and restores the sound.

## In-Game Sound Log

Opening this section activates sound logging. Every sound effect triggered while the log is open is recorded here. Closing the section clears the log.

- **Clear Logged Sounds** — empties the log without closing it.

## In-Game Music Log

Works the same as the Sound Log but captures background music tracks rather than sound effects.

- **Clear Logged Music** — empties the music log.

## Storage

Blocked sounds are saved in `Settings › Open settings folder` inside `GWToolbox.ini` under the `[Audio Settings]` section.

---

# Text-to-Speech Module

Source: https://www.gwtoolbox.com/docs/text-to-speech/

All settings for this feature live under `Settings › Text-to-speech`.

The Text-to-Speech (TTS) Module in GWToolbox++ brings Guild Wars to life by converting NPC dialogue, speech bubbles, and other in-game text into spoken audio. This feature enhances immersion and accessibility by allowing you to hear conversations and interactions as you play.

## Features

- Convert NPC dialogue to speech using multiple TTS providers
- Play speech bubbles from NPCs, enemies, and party members
- Customizable voice settings for different races and genders
- Support for both explorable areas and outposts
- Custom voice assignments for specific NPCs
- Activity logging and recent playback tracking

## TTS Providers

The module supports multiple text-to-speech providers:

1. **GWDevHub TTS** (Default)
   - Free service specifically for Guild Wars players
   - No API key required
   - Only processes the first sentence of NPC dialogue

2. **ElevenLabs**
   - High-quality AI voices
   - Requires API key from [ElevenLabs](https://elevenlabs.io/app/settings/api-keys)

3. **OpenAI**
   - Natural-sounding TTS
   - Requires API key from [OpenAI Platform](https://platform.openai.com/api-keys)

4. **Google Cloud**
   - Enterprise-grade text-to-speech
   - Requires API key and Text-to-Speech API enabled
   - Get credentials at [Google Cloud Console](https://console.cloud.google.com/apis/credentials)

5. **Play.ht**
   - Voice cloning and custom voices
   - Requires both API key and User ID
   - Sign up at [Play.ht](https://play.ht)

## Getting Started

To access the Text-to-Speech settings:
1. Open the GWToolbox++ main window
2. Navigate to Settings
3. Find the "Text-to-speech" section

### Basic Configuration

1. **Choose TTS Provider**
   - Select your preferred provider from the dropdown
   - For paid services, enter your API credentials
   - GWDevHub TTS works immediately with no setup

2. **Configure Processing Options**
   - Enable/disable first sentence only processing
   - Enable/disable first dialog only processing
   - Toggle goodbye messages when closing dialogs
   - Choose whether to play merchant greetings

## Location Settings

Control where TTS is active:

### Play Speech In
- **Explorable Areas**: Enable TTS in missions, quests, and explorable zones
- **Outposts**: Enable TTS in towns and outposts

### Play Speech Bubbles
- **When in an outpost**: Process speech bubbles from NPCs in towns
- **When in an explorable area**: Process speech from skills, enemy quotes, and ally dialogue
- **From other party members**: Include speech from your party (Warning: may use additional API credits)
- **From non-friendly NPCs**: Include enemy dialogue and quotes

### NPC Speech Bubble Range
- Set the distance (in game units) for processing speech bubbles
- Default: 166.000 (earshot range)
- Range: 0 to 2500
- Higher values process more speech but use more API credits

## Race and Character Voices

The module can generate speech for different Guild Wars races:

### Supported Races
- **Human**: Default human male/female voices
- **Charr**: Deep, gravelly voices
- **Norn**: Strong, resonant voices
- **Asura**: Higher-pitched, energetic voices
- **Tengu**: Unique avian-inspired voices
- **Dwarf**: Traditional dwarven voices
- **Centaur**: Distinctive centaur voices

Enable or disable TTS for each race individually to customize your experience.

## Advanced Features

### Custom NPC Voice Assignment

For paid TTS providers (ElevenLabs, OpenAI, etc.), you can assign specific voice IDs to individual NPCs:

1. Find the NPC ID of the character you want to customize
2. Enter the NPC ID in the input field
3. Enter the Voice ID from your TTS provider
4. Click "Add Custom Voice Assignment"

Voice settings (stability, similarity, style) are automatically inherited from the NPC's race and gender.

**Example:**
- NPC ID: `1234`
- Voice ID: `2EiwWnXFnvU5JabPnv8n`

You can remove custom assignments at any time using the "Remove" button next to each assignment.

### Stop Conditions

- **Stop speech when dialog window is closed**: Immediately halt audio playback when you close an NPC dialogue
- Useful for quickly moving through conversations

## Cost Management

When using paid TTS services, several options help manage API usage:

**Cost Optimization Settings:**
- Only process first sentence (reduces API calls)
- Only process first dialog (limits conversation length)
- Disable speech bubbles in explorable areas (reduces frequent triggers)
- Limit NPC speech bubble range (processes fewer ambient quotes)
- Disable party member speech bubbles (reduces multiplayer triggers)

The module displays a warning when settings that increase API usage are enabled.

## Recent Activity Log

The bottom of the settings panel shows recent TTS activity:
- Audio files being played
- Estimated duration of each clip
- Success/failure messages
- Generation status from GWDevHub voice service

This helps you monitor what's being processed and troubleshoot any issues.

## Language Support

- The module respects Guild Wars' audio language settings
- Guild Wars officially supports 6 audio languages
- Goodbye messages and some merchant greetings currently only support English
- Text processing uses the game's configured audio language preference

## Tips and Best Practices

1. **Start with GWDevHub TTS**: It's free and requires no setup
2. **Enable selectively**: Start with outposts only to test the feature
3. **Monitor API usage**: Keep an eye on the Recent Activity log when using paid services
4. **Adjust bubble range**: Lower the range in busy areas to reduce processing
5. **Use race filters**: Disable races you don't want to hear to reduce load
6. **First sentence only**: Keep this enabled for most content to save on API costs

## Troubleshooting

**No audio playing?**
- Check that your TTS provider is configured correctly
- Verify API credentials are valid (for paid services)
- Ensure the location settings allow speech in your current area
- Check that the NPC's race is enabled in the race filters

**Too many API calls?**
- Enable "Only process the first sentence"
- Enable "Only process the first dialog"
- Reduce NPC speech bubble range
- Disable speech bubbles in explorable areas
- Disable non-friendly NPC speech

**Audio cutting off?**
- Disable "Stop speech when dialog window is closed"
- Check the Recent Activity log for error messages

**Quality issues?**
- Try a different TTS provider
- For ElevenLabs/OpenAI, experiment with custom voice IDs
- Check that your API key has sufficient credits

## Notes

- TTS processing happens asynchronously to avoid impacting game performance
- Audio files are cached where possible to reduce API calls
- The GWDevHub service is optimized for Guild Wars dialogue and lore-appropriate voices
- Custom voice assignments only work with providers that support voice selection
- Speech bubbles from skills and combat quotes may be frequent in explorable areas

---

# Theme

Source: https://www.gwtoolbox.com/docs/theme/

All settings for this feature live under `Settings › Theme`.

Toolbox's appearance can be greatly customized. Many individual features have some separate options for this, but the controls that affect everything are all in the Theme menu in [Settings](/docs/settings/). Usually it's best to see the effects of these controls for yourself by tweaking them, but you can also read about them here.

It's possible to share all or part of your theme with someone else by copying from the Theme.ini file in the [Settings folder](folder).

## Basic controls
**Restore Default** returns all Theme settings to the Toolbox standard.

**Global Alpha** determines the transparency of all elements of Toolbox, with the following exceptions:
* Icons on the main window
* Bonds on the bond monitor
* The [Minimap](/docs/minimap/) widget
* Damage bars and numbers on the damage monitor

**Global Font Scale** adjusts the size of all text anywhere in Toolbox.

## Sizes
* **Window Padding** controls the empty space around the edge of [windows](/docs/windows/).
* **Window Rounding** determines the sharpness of [windows'](/docs/windows/) corners.

Frames are the areas within windows that contain text, including headers, sliders, and text input fields.
* **Frame Padding** controls the empty space around the edge of frames.
* **Frame Rounding** determines the sharpness of frames' corners.<br /><br />
* **Item Spacing** controls the space between items.
* **Item InnerSpacing** controls the space between the separate parts of the each item.<br /><br />
* **Indent Spacing** controls the width of indents.<br /><br />
* **Scrollbar Size** controls the thickness of scrollbars.
* **Scrollbar Rounding** determines the sharpness of scrollbars' corners.

Grabs are the things you click-and-drag to move a slider.
* **Grab MinSize** determines the minimum size a grab can be on a slider with a small scale.
* **Grab Rounding** determines the sharpness of grabs' corners.

## Alignment
* **Window Title Align** determines the position of the title on window title bars.
* **Button Text Align** determines the position of text on some buttons.

## Colors
The color channels control the levels of red, green, blue, and opacity of each element:
* **Text**: most text in Toolbox.
* **TextDisabled**: a few other pieces of text, such as tooltip help markers.

* **WindowBg**: the background of windows.
* **ChildWindowBg**: does nothing.
* **PopupBg**: the background of mouseover tooltips.<br /><br />
* **Border**: border lines on the main window, materials window, dialogs window, and the chat filter.
* **BorderShadow**: does nothing.<br /><br />
* **FrameBg**: the background of frames, when out of focus.
* **FrameBgHovered**: the background of frames, when moused over.
* **FrameBgActive**: the background of frames, when clicked on.<br /><br />
* **TitleBg**: the title bar of windows that are out of focus.
* **TitleBgCollapsed**: the title bar of collapsed windows.
* **TitleBgActive**: the title bar of the window in focus.<br /><br />
* **MenuBarBg**: does nothing.<br /><br />
* **ScrollbarBg**: the background on scrollbars.
* **ScrollbarGrab**: the thing you click on to move a scrollbar, when out of focus.
* **ScrollbarGrabHovered**: the thing you click on to move a scrollbar, when moused over.
* **ScrollbarGrabActive**: the thing you click on to move a scrollbar, when clicked on.<br /><br />
* **ComboBg**: the background on drop-down menus.<br /><br />
* **CheckMark**: the circles inside checkboxes.<br /><br />
* **SliderGrab**: the thing you click on to move a slider, when out of focus.
* **SliderGrabActive**: the thing you click on to move a slider, when clicked on.<br /><br />
* **Button**: buttons, when out of focus.
* **ButtonHovered**: buttons, when moused over.
* **ButtonActive**: buttons, when clicked.<br /><br />
* **Header**: headers, when out of focus.
* **HeaderHovered**: headers, when moused over.
* **HeaderActive**: headers, when clicked on.<br /><br />
* **Column**: does nothing.
* **ColumnHovered**: does nothing.
* **ColumnActive**: does nothing.<br /><br />
* **ResizeGrip**: the triangle for re-sizing windows and widgets, when out of focus.
* **ResizeGripHovered**: the triangle for re-sizing windows and widgets, when moused over.
* **ResizeGripActive**: the triangle for re-sizing windows and widgets, when clicked on.<br /><br />
* **CloseButton**: a window's close button, when out of focus.
* **CloseButtonHovered**: a window's close button, when moused over.
* **CloseButtonActive**: a window's close button, when clicked on.<br /><br />
* **PlotLines**: does nothing.
* **PlotLinesHovered**: does nothing.
* **PlotHistogram**: does nothing.
* **PlotHistogramHovered**: does nothing.
* **TextSelectedBg**: the background of highlighted text.
* **ModalWindowDarkening**: does nothing.

---

# Weather

Source: https://www.gwtoolbox.com/docs/weather/

All settings for this feature live under `Settings › Weather`.

The Weather module draws camera-anchored weather — rain, snow, ash and similar — into the 3D game world. The effect is composited under the in-game UI and occluded by terrain, and can dim the scene with an overcast tint. It ships with a few presets (Heavy Rain, Light Rain, Snow, Ashfall) and lets you author your own.

The module is off by default. Tick **Weather** in the "Enable the following features" list under `Settings › General` and restart Toolbox to use it.

<p class="text-(--color-fg-meta)">This is a beta feature. If the in-world compositor fails to install, the settings panel will say so at the top.</p>

## Conditions

Each condition is one weather effect. Only one runs at a time — turning a condition on (via its checkbox or [chat command](#chat-commands)) turns the others off. Expand a condition to edit it:

- **Enabled** — turn the condition off entirely: it's skipped by automatic weather and can't be turned on manually or via chat command until re-enabled. A disabled condition shows `[Disabled]` in its header. Fog is disabled by default, as it's quite invasive to gameplay (it obscures vision); enable it here if you want it in the rotation.
- **Type** — Rain (streaked drops) or Snow (square flakes; also used for ash).
- **Density** — how densely the volume is filled, 1–100%. The particle count is derived from this and the range, so it stays consistent if you change the radius. Higher = denser and heavier on FPS; the estimated particle count is shown below the slider.
- **Range** — radius of the weather volume around the focus. A small range concentrates the effect close in; a large one fills out to compass range.
- **Drop size** / **Fall speed** — particle size, and the constant speed they fall at (wind tilts direction without changing speed).
- **Wind direction** — range of headings the wind may blow toward; one is picked at random each time the condition activates. A wide range (e.g. 0–360) varies it; a narrow one keeps it consistent.
- **Wind tilt** — how far the fall tilts from straight down: 0 = vertical, 90 = fully sideways.
- **Wind relative to camera** — measure wind direction from the camera, so the effect keeps the same on-screen direction as you rotate.
- **Centre on camera** — centre the volume on the camera itself instead of its target, wrapping the effect tightly around the viewer. Best paired with a small range.
- **Drift** (Snow only) — how much flakes wander sideways as they fall; 0 = straight down.
- **Floor decal** — what each impact leaves on the ground: None, Splash, or a settled flake/patch. Splash adds a **Splash chance**.
- **Tint** — the particle colour (e.g. a dark grey for ash).
- **Overcast** — how strongly the condition dims the scene while active, toward the **Overcast tint** colour.
- **Sounds** — `.dat` file IDs played at random while active. Each entry shows whether it's a valid sound, with **Test**, and **Remove** buttons. Set the **Sound interval** range, and optionally **Play sounds in 3D** so the game varies volume and panning.

Use **Duplicate** / **Remove condition** per condition, **Add condition** to create one, and **Reset to defaults** to restore the presets.

## Automatic weather

Enable **Automatic weather (by climate)** to pick the active condition automatically from the climate of the region you're in, re-rolling every few minutes (set the **Change interval** range). While on, the manual on/off toggles are disabled.

Below it is the climate table. Each climate lists conditions with a chance (0–100% per roll); the leftover chance is clear weather, shown below the list. Add or remove conditions per climate, **Add climate**, **Remove climate**, or **Reset climate table**. The current map's climate and the condition currently showing are displayed at the top of the panel.

By default the climate follows the map you're in. You can force a specific climate regardless of map with `/climate <climate>` (see below); while a climate is forced, the panel shows it and offers a **Follow map** button to clear it.

## Chat commands

- `/weather` — list every condition and whether it's on.
- `/weather <condition>` — toggle a condition by name (names may contain spaces).
- `/weather <condition> on|off|toggle` — set a condition's state explicitly (`1`/`0` also work).
- `/weather clear` — unset the current condition (clear skies) without turning automatic weather off; if automatic weather is on it re-rolls at the next scheduled change.

Turning one condition on turns the rest off, matching the one-at-a-time behaviour of the settings panel.

- `/climate` — show whether automatic weather is on and the climate currently driving it.
- `/climate auto` (or `/weather auto`) — turn automatic weather on and follow the current map's climate.
- `/climate <climate>` — turn automatic weather on and force a specific climate (e.g. `Temperate`, `Arid`, `Desertous`, `Tropical`, `Mountainous`, `Volcanic`), regardless of the map.
- `/climate off` (or `/weather off`) — turn automatic weather off and clear any running weather effects.

---

# Texture Mods (gMod)

Source: https://www.gwtoolbox.com/docs/texmod/

Toolbox can load texture replacement packs at runtime using a built-in [gMod](https://github.com/gwdevhub/gMod), so you no longer need to run TexMod or uMod as a separate program. Find it under `Settings › gMod/uMod/Texmod`.

gMod itself is downloaded and kept up to date automatically into your Toolbox folder — there's nothing to install. The status line shows whether gMod is active, and the version row offers a manual **Check for gMod updates** if you want to force a re-check.

<img src="/docs-images/texmod_window.webp" alt="The gMod/uMod/Texmod settings panel: the gMod active status and version row, the texture pack list with load-order and remove controls, and the expanded Loaded DirectX9 Textures capture gallery" />

## Adding packs

Click **Add texture pack** and pick a file. Supported formats:

- `.tpf` and `.zip` — TexMod / uMod packs
- `.dds` — a single replacement texture

Each pack appears as a row with a checkbox. Tick it to load the pack, untick to unload. Use the trash button to remove a pack from the list entirely, or **Unload all** to disable everything at once. Your packs and their enabled state are remembered between sessions.

## Load order

When two packs replace the **same** texture, the one **higher in the list wins**. Use the up/down arrows on each row to change a pack's priority — moving a pack up gives it precedence over the packs below it on any conflicting textures. Packs that don't overlap are all applied regardless of order.

## When changes take effect

gMod swaps textures as the game loads them. Textures already in memory for the area you're standing in are not re-evaluated immediately, so **a pack you load (or reorder) after entering a map may not visibly apply until the next map change**. Zoning into another area — or relogging — forces the game to reload its textures and your changes show up.

## Extracting textures

Expand **Loaded DirectX9 Textures** to capture the textures the game is currently using, so you can build your own replacements. Click **Record textures** to start collecting them as you play (this hashes every texture the game creates and will lower your framerate while active, so stop it when you're done). Click any captured texture to download it as `.dds` (for use in a gMod/uMod/TexMod pack) or `.png`. The hash shown is the gMod/uMod/TexMod texture hash you'll target in a pack.

## Notes

- Running the standalone TexMod or uMod programs alongside Toolbox can conflict — prefer the built-in gMod instead (see the [FAQ](/docs/faq/)).
- If the status line shows gMod isn't active, make sure you have at least one pack added; gMod only loads once there's something to serve.

---

# Reroll Window

Source: https://www.gwtoolbox.com/docs/reroll/

Open from `Toolbox › Reroll` or `/show reroll`. Per-window options live under `Settings › Reroll`.

The Reroll window allows you to quickly switch between characters on your account without logging out completely.

## Main Features
- **Character List**: Displays all characters on your account.
- **Quick Switch**: Click on a character name to switch to that character.
- **Travel Options**: Choose whether to travel to the same location after rerolling.
- **Party Options**: Choose whether to rejoin your party after rerolling.

## Usage
1. Open the Reroll window.
2. Click on the name of the character you want to switch to.
3. Confirm your choice if prompted (e.g., when in an explorable area).

## Settings
- **Travel to same location after rerolling**: If checked, you'll be moved to the same map after switching characters.
- **Re-join your party after rerolling**: If checked, you'll automatically rejoin your previous party after switching characters.
- **Return to original character on fail**: If checked, you'll switch back to your original character if the reroll process fails.

## Chat Commands
Use `/reroll` or `/rr` followed by a profession name or character name to quickly switch characters. For example:
- `/reroll warrior` to switch to your first available warrior character.
- `/reroll My Character Name` to switch to a specific character.

## Excluded Characters
You can set up a list of characters to exclude from the `/reroll` command. This is useful if you have characters you don't want to accidentally switch to.

## Notes
- The reroll process may take a few moments as it logs out your current character and logs in the new one.
- If you're in an explorable area, you'll be prompted to confirm before rerolling.
- The window will display all characters available on your account when you're at the character selection screen.

---

# Integrations

Source: https://www.gwtoolbox.com/docs/integrations/

All settings for this feature live under `Settings › Third Party Integration`.

GWToolbox++ offers several integrations with external services to enhance your Guild Wars experience.

## Discord Integration

The Discord integration allows GWToolbox++ to send in-game information to Discord, providing rich presence functionality.

Features:
- Display your current in-game location
- Show your character information
- Share party information
- Allow other players to join your party through Discord

To enable and configure Discord integration:
1. Go to GWToolbox++ settings
2. Check "Enable Discord integration"
3. Customize the displayed information as desired

## Teamspeak 5 Integration

The Teamspeak 5 integration connects GWToolbox++ with your Teamspeak 5 client, allowing for seamless communication between the game and your voice chat.

Features:
- View current Teamspeak server information in-game
- Send your current server info to the in-game chat
- Automatically connect to the appropriate Teamspeak channel based on your in-game location

To set up Teamspeak 5 integration:
1. Ensure Teamspeak 5 is running and the "Remote Apps" feature is enabled
2. In GWToolbox++ settings, enable "Teamspeak 5 integration"
3. Use the "/ts5" command in-game to send your current server info

## Twitch Integration

The Twitch integration allows streamers to interact with their chat directly from within Guild Wars.

Features:
- Send and receive Twitch chat messages in-game
- Receive notifications when viewers join or leave your channel
- Customize the appearance of Twitch messages in your game chat

To configure Twitch integration:
1. In GWToolbox++ settings, enable "Twitch integration"
2. Click "Click Here to get a Twitch Oauth Token" - this opens Twitch in your browser to authorise GWToolbox++, and fills in the token for you
3. Enter the Twitch channel you want to connect to (your own Twitch username if you're streaming)
4. Customize notification settings as desired
5. Click the "Disconnected" button to connect. Re-connect after changing any of these settings

### Sending messages to Twitch chat

Incoming Twitch messages appear in your chat window as if they were whispers from `<viewer> @ Twitch`.

To send a message back to Twitch chat, **send a whisper to `Twitch`**:

- Type `/whisper Twitch, your message here` (or `/w Twitch, your message`), or
- Click a Twitch message in your chat window to start a whisper - GWToolbox++ rewrites the recipient to `Twitch` automatically

Anything you whisper to `Twitch` is posted in the Twitch channel you're connected to, and is echoed back into your in-game chat window. Whispers to any other name behave normally.

Notes:
- You must be connected (the button in settings reads "Connected") for this to work.
- The message is sent as the Twitch account whose OAuth token you authorised, so that account needs to be able to talk in the target channel (i.e. not banned, and meeting any follower/subscriber-only chat requirements).

These integrations help bridge the gap between Guild Wars and popular external services, enhancing communication and social features for players and streamers alike.

## LiveSplit Integration

The LiveSplit integration allows livesplit to communicate with toolbox and get updates when objectives are completed. This essentially works as an autosplitter integrated into GWToolbox++.

Features:
- Automatically start, split, and reset your LiveSplit runs
- Integrates directly into LiveSplit One
- Integrates with the LiveSplit Webserver using a third-party connector

To configure LiveSplit integration:
1. In GWToolbox++ settings, enable "Livsplit Websocket server" in the Objectives settings
2. Configure a port and press "Restart" if the server is not already running
3. Choose the corresponding format for the LiveSplit tool of choice
4. To configure your splits in LiveSplit One
    1. Set up you splits to match the objectives for your chosen run
    2. In LiveSplit One, go to "Settings" and connect to the server under "Network"
    3. The URL will be "ws://localhost:9001" or whatever port you configured in GWToolbox++ previously
5. To configure your Splits in LiveSplit using the LiveSplit Server
    1. Go to your LiveSplit Settings and configure the LiveSplit Server Port to something other than the GWToolbox++ server port and set the Startup Behaviour to "Start Websocket Server"
    2. Go to Control->"Start Websocket Server" if it is not already running
    3. Use something like [websocat](https://github.com/vi/websocat) to connect the two servers
        1. Example in linux: `websocat ws://localhost:9001 ws://localhost:16834/livesplit`
        2. Example in windows: `websocat.exe ws://localhost:9001 ws://localhost:16834/livesplit`

These integrations help bridge the gap between Guild Wars and popular external services, enhancing communication and social features for players and streamers alike.

---

# Input Modules

Source: https://www.gwtoolbox.com/docs/input_modules/

GWToolbox++ includes several modules that enhance and fix various input-related aspects of Guild Wars. These modules improve the user experience by addressing common issues and adding useful features. Each one is configured in its own section of the settings panel.

## Mouse Fix

The Mouse Fix module addresses issues related to cursor movement and camera control in Guild Wars.

`Settings › Mouse Settings`

### Features:
- Fixes camera glitches when moving the mouse
- Allows customization of the cursor size
- Improves overall mouse responsiveness

### Settings:
- Enable cursor fix: Toggles the mouse fix functionality
- Guild Wars cursor size: Allows you to adjust the size of the in-game cursor (16-64 pixels)

Note: Cursor sizes other than 32 pixels might cause the cursor to disappear randomly. If this happens, right-click to make the cursor reappear.

## Mouse Walking Module

The Mouse Walking Module provides a quick way to toggle mouse walking on and off using a keyboard shortcut.

### Features:
- Quickly enable or disable mouse walking by holding the Left Alt key
- Automatically restores the previous mouse walking state when the key is released

This module is particularly useful for players who frequently switch between mouse walking and normal movement modes.

## Keyboard Language Fix

The Keyboard Language Fix module ensures that Guild Wars uses the correct keyboard layout, particularly for non-English keyboards.

`Settings › Keyboard Layout Fix`

### Features:
- Attempts to set the correct keyboard layout before Guild Wars loads its own settings
- Prioritizes the en-US (English US) keyboard layout if available
- Falls back to the current system keyboard layout if en-US is not found

This module is especially helpful for players using non-English keyboard layouts, as it helps prevent input issues caused by mismatched keyboard settings.

These input modules work together to provide a smoother, more customizable input experience in Guild Wars, addressing common pain points and adding quality-of-life improvements for players.

---

# Quality of Life Fixes

Source: https://www.gwtoolbox.com/docs/qol_fixes/

Alongside its bigger windows and widgets, GWToolbox++ quietly fixes a number of small base-game bugs and annoyances. These are enabled by default, and most players never realise that Toolbox is the reason things "just work". This page collects them in one place.

Each can be toggled in its own section of the [Settings](/docs/settings/) panel.

## Fixes

- **Hero command panel positions** — Remembers where you place each hero's skill-bar / command panel and restores it when the panel reappears, so they stop scattering across the screen after you reorder your party or swap characters. In the Party Settings section you can choose whether positions are remembered by **party slot** (the default — each slot keeps its placement no matter which hero is in it) or by **hero** (the placement follows the specific hero across slots and characters).

- **Experience bar shows XP progress** — Replaces the experience bar text so it shows your progress toward the next level (current XP / XP needed) instead of just repeating your current level number.

- **Keyboard Language Fix** — Stops Guild Wars from silently switching your Windows keyboard layout to en-US on startup, which would otherwise trigger the Win+Space language switcher and persist until you change it back in Windows. See [Input Modules](/docs/input_modules/).

- **Mouse Fix** — Fixes an occasional camera glitch when looking around with the mouse, and optionally lets you resize the in-game cursor. See [Input Modules](/docs/input_modules/).

- **Vendor Fix** — Fixes a base-game bug where collectable items sitting beyond the 56th inventory slot aren't recognised by collectors and crafters, so trade-ins work no matter where the item sits in your bags.

- **Code Optimiser** — Swaps Guild Wars' internal checksum (CRC32) routine for a much faster one, cutting the time the game spends validating large chunks of data and the stutter that can come with it.

- **FPS Fix** — Removes Guild Wars' hard-coded 90 FPS cap so the frame rate can match your monitor's refresh rate.

---

# GWToolbox++ Plugins

Source: https://www.gwtoolbox.com/docs/plugins/

Open from `Toolbox › Plugins` or `/show plugins`. Per-window options live under `Settings › Plugins`.

## ⚠️ IMPORTANT SAFETY WARNING ⚠️

**Plugins are NOT officially supported by GWToolbox++ developers and may be unsafe. Use plugins at your own risk and only if you fully trust the author.**

**Using plugins is NOT permitted by ArenaNet and may violate the Guild Wars Terms of Service. Using plugins could result in account suspension or banning.**

## What are Plugins?

Plugins are additional features or modifications that can be added to GWToolbox++. They are created by third-party developers and are not part of the official GWToolbox++ package.

## Using Plugins

If you choose to use plugins despite the risks, here's how to add them to GWToolbox++:

1. Place the plugin DLL file in the `plugins` folder of GWToolbox++.
2. Restart GWToolbox++ or use the "Refresh" button in the Plugins settings.
3. Enable the plugin through the GWToolbox++ interface.

## Plugin Settings

Some plugins may have their own settings. These can usually be accessed through the GWToolbox++ settings interface.

## Visibility Control

You can show or hide a plugin's UI through the GWToolbox++ interface, typically by toggling a checkbox next to the plugin's name.

## Troubleshooting

If you encounter any issues while using plugins:

1. Disable all plugins and see if the issue persists.
2. If the issue is resolved, re-enable plugins one by one to identify the problematic one.
3. Report the issue to the plugin developer, not to GWToolbox++ developers.

Remember, GWToolbox++ developers do not provide support for third-party plugins. If you encounter any bugs or issues while using plugins, do not report them to the GWToolbox++ team.

## Final Reminder

By using plugins, you acknowledge that you're doing so at your own risk. GWToolbox++ developers are not responsible for any consequences resulting from the use of third-party plugins.

---

# Danger Rings

Source: https://www.gwtoolbox.com/docs/danger_rings/

All settings for this feature live under `Settings › Danger Rings`.

The Danger Rings module draws hostile ground area-of-effect skills — Meteor Shower, Maelstrom, traps and similar — as rings on the ground in the 3D game world. The rings are composited under the in-game UI and depth-tested against the terrain, so they sit on the floor and are hidden by hills and walls like real geometry.

<p class="text-(--color-fg-meta)">This is a beta feature. If the in-world compositor fails to install, the settings panel says so at the top.</p>

## Settings

- **Occlude behind terrain** — hide the parts of a ring that fall behind hills, walls and other terrain. Off draws the whole ring on top.
- **Maximum render distance** — how far from the camera rings are drawn.
- **Ring thickness** — width of the ring band.
- **Rim opacity** / **Fill opacity** — how solid the ring's outline and its filled interior are (0 = invisible).
- **Height lift** — raises the rings slightly off the ground to avoid flicker (z-fighting) on flat terrain.
- **Pulse speed** — how fast the rings pulse, in Hz (0 = no pulsing).

---

# Loot Beacons

Source: https://www.gwtoolbox.com/docs/loot_beacons/

All settings for this feature live under `Settings › Loot Beacons`.

The Loot Beacons module marks dropped items worth picking up with a beacon — a vertical pillar of light and a ring on the ground — in the 3D game world. Beacons are composited under the in-game UI and depth-tested against the terrain. Choose what gets a beacon by rarity, by trader value, or both.

<p class="text-(--color-fg-meta)">This is a beta feature. If the in-world compositor fails to install, the settings panel says so at the top.</p>

## What gets a beacon

- **Beacon on valuable items** — beacon any drop whose Kamadan trader price meets the **Value threshold (gold)**, regardless of rarity. This catches white-rarity valuables like ectos, gemstones and dyes.
- **Beacon by item name** — your own list of text/colour pairs. Any drop whose name contains the text gets a beacon in that colour, whatever its rarity or value — e.g. `scroll`, `dye`, `glob of ectoplasm`. Matching ignores case and uses the item name as shown in-game. Each rule has its own on/off checkbox, and rules can be removed with the **x** button. Name rules are checked before value and rarity, and the first matching rule in the list wins, so order the list by priority.

  Wrap the text in slashes to match with a regular expression instead, e.g. `/^Superb Charr Carving$/` or `/(gold|silver) dye/`. Flags go after the closing slash, same as the [chat filter](./chatfilter/) — regex rules ignore case unless you add the `I` flag. A rule whose pattern doesn't parse is flagged **Invalid regex** in the settings panel and is ignored.
- **Beacon by rarity** — turn beacons on per rarity (White, Blue, Purple, Gold, Green), each with its own colour.
- **Show beacons on items reserved for other party members** — also beacon drops assigned to other players (drawn dimmed). Off shows only unreserved drops and drops assigned to you.

## Appearance

- **Occlude behind terrain** — hide beacon parts that fall behind terrain.
- **Maximum render distance** — how far from the camera beacons are drawn.
- **Beam height** / **Beam width** / **Beam opacity** — the pillar of light above the item.
- **Ring radius** / **Ring opacity** — the ring drawn on the ground at the item.
- **Height lift** — raises the ground ring slightly to avoid flicker (z-fighting).
- **Pulse speed** — pulse rate in Hz (0 = no pulsing).

---

# Skill Range Rings

Source: https://www.gwtoolbox.com/docs/skill_range_rings/

All settings for this feature live under `Settings › Skill Range Rings`.

The Skill Range Rings module draws a hovered skill's ranges on the ground in the 3D game world. Hover any skill — on your skillbar, in the Skills window, in template previews — and its relevant ranges are draped onto the terrain:

- **Cast / use range** around you.
- **AoE radius** around your current target (or yourself).
- **Earshot** for shouts and chants.
- **Constant effect (spirit range)** where a skill has one.

The rings are composited under the in-game UI and depth-tested against the terrain.

<p class="text-(--color-fg-meta)">This is a beta feature. If the in-world compositor fails to install, the settings panel says so at the top.</p>

## Settings

- **Show AoE ring at your current target** — for targeted skills with an area effect, draw the AoE ring around your target instead of around you. Off always draws it around you.
- **Occlude behind terrain** — hide ring segments that fall behind terrain.
- **Maximum render distance** — how far from the camera rings are drawn.
- **Ring thickness** / **Opacity** — the ring band width and how solid it is.
- **Height lift** — raises rings slightly off the ground to avoid flicker (z-fighting).
- **Colours** — each range (AoE, earshot, constant effect) has its own colour.

---