/GWToolboxpp

Tools for Guild Wars players

Primary LanguageC++OtherNOASSERTION

GWToolbox++

A set of tools for Guild Wars Players

If you are here to check toolbox features and for a download link to go https://gwtoolbox.com. Keep reading for information on how to download and build from the source.

How to download, build, and run

Requirements

  1. Open Git Bash. Use all the following commands in Git Bash.

  2. Clone the repository recursively: git clone --recursive https://github.com/Haskha/GWToolboxpp.git

  3. Navigate to the GWToolboxpp folder: cd GWToolboxpp

  4. Build: cmake -B build

  5. Open: cmake --open build

  6. Build the solution.

  7. Run.

Notes

  • GWToolbox compiles as a DLL (GWToolboxdll.dll) and EXE (GWToolbox.exe). The exe lets you select a Guild Wars Client and injects the dll, but you can also use other dll injectors of your choice.
  • By default, the launcher (GWToolbox.exe) will run the GWToolboxdll.dll in the same folder, if there is none, it will inject the one in your installation folder.
  • You can use the Visual Studio debugger directly to be able to break and step through toolbox code. First launch toolbox in debug mode as normal, then go to Debug -> Attach to process, then select the Gw.exe process and click Attach. You can also attach the debugger before running toolbox, to debug issues during launch, but then you will have to manually launch toolbox from outside visual studio, either with GWToolbox.exe or AutoItLauncher/inject.au3.

How to contribute

  • First of all make sure you take a look at the code and respect the somewhat consistent code conventions.
  • Create a new branch and commit the changes relevant to your contribution. Please make sure you don't commit unrelated lines.
  • Finally submit a pull request and let us review your code. Stay updated in the pull request page for feedback and comments.

Quick code overview: There are three main kinds of Toolbox components: Modules, Widgets and Windows. Any code change is most likely an additional one of those, or some change in one.

  • Modules are components without an interface, but they do have a panel in Settings. Two modules noteworthy: GameSettings contains any static change to the game, while ToolboxSettings contains any static change to toolbox.
  • Widgets are visual elements without an explicit window (border, header, etc).
  • Windows are visual elements with an explicit window.

Both Widgets and Windows can also have a panel in Settings, and share common code in ToolboxUIElement, which handles saving of position, visibility, etc. If you wish to create a new window/widget, please take a look at how similar ones have already been implemented.

Important: The destruction chain is as follows: SignalTerminate -> Terminate -> Destructor. Make sure to handle all destruction logic that uses other modules or interfaces with GWCA in SignalTerminate, Terminate to revert any changes to the game and only use the destructor for class scope clean up.

Plugins

Toolbox supports plugins, meaning you can extend Toolboxes functionality. Please take note that plugins are currently a beta feature - plugins compiled for one version of toolbox should continue working, but may have to be recompiled

For users: put the plugin into GWToolboxpp/<Computername>/plugins

For developers: there are a few things you should take note of:

  • two examples (clock and InstanceTimer) will automatically be added to the solution (see CMakeLists.txt)
  • Toolbox is compiled with /MT - this means that memory allocation/deallocation must not happen across dll or library boundaries
  • Your Plugin::Initialize must call ToolboxPlugin::Initialize(ctx, fns, tbdll), otherwise you must take care of creating and destroying your own ImGui context.
  • we do not guarantee API stability between versions but try to not change existing exported method signatures
  • you must not call GW::Initialize in your plugin, it will use the instance created by Toolbox. Get access to functions either through GetProcAddress(toolbox_handle, mangled_name) or by linking with GWToolboxdll.lib

Credits

HasKha

  • Original creator of GWToolbox++.

KAOS

  • Original creator of the GW API used, reverse engineering work.
  • Several minor additions.

Ziox

  • 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

  • Implemented many new features and improvements.
  • Major contributor to the GW API used, reverse engineering work.
  • Current maintainer of the project.

Dub

  • Implemented many new features and improvements.

Itecka

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

Everyone who proposed a PR

Misty/DarkManic

  • Extensive work on the site and documentation.

and everyone suggesting ideas!

Images: