Skip to content

PieOrCake/skinventory

Repository files navigation

Skinventory

A Guild Wars 2 addon for Raidcore Nexus that helps you track, browse, and collect armor and weapon skins across your account.

Currently in pre-release testing.

AI Notice

This addon has been 100% created in Windsurf using Claude. I understand that some folks have a moral, financial or political objection to creating software using an LLM. I just wanted to make a useful tool for the GW2 community, and this was the only way I could do it.

If an LLM creating software upsets you, then perhaps this repo isn't for you. Move on, and enjoy your day.

Features

  • Skin browser — browse all armor and weapon skins by category, weight class, and slot
  • Ownership tracking — integrates with Hoard & Seek to show owned/unowned status with a per-category progress bar
  • Wiki integration — click any skin to see its wiki image, acquisition source, set info, and vendor details
  • Shopping list — shows the cheapest unowned skins sorted by price, from both the Trading Post and vendors
  • Vendor support — cultural armor and karma vendor prices with vendor name, location, and clickable waypoint chat links
  • Source filtering — filter the shopping list by TP, Vendor, Armor, or Weapons
  • Rarity colors — skin names colored by rarity throughout the UI
  • Coin icons — GW2-style gold/silver/copper coin display

Screenshots

Browser Shopping List

Building

Prerequisites

  • CMake 3.20+
  • MinGW cross-compiler (x86_64-w64-mingw32-gcc, x86_64-w64-mingw32-g++)

Setup

Download dependencies (ImGui and nlohmann/json):

chmod +x scripts/setup.sh
./scripts/setup.sh

Build

mkdir -p build && cd build
cmake -DCMAKE_TOOLCHAIN_FILE=../toolchain-mingw64.cmake ..
make -j$(nproc)

The output Skinventory.dll can be placed in your Nexus addons folder.

Installation

  1. Install Raidcore Nexus
  2. Install Hoard & Seek (required for owned skin tracking)
  3. Copy Skinventory.dll to your Nexus addons directory
  4. In-game, press Ctrl+Shift+K to open the Skinventory window

Cache Files

Skinventory caches data locally for performance. These files are created in the addon's data directory:

File Purpose
skin_cache.json All skin metadata from the GW2 API
item_map.json Skin-to-item ID mapping
vendor_prices.json Cultural armor vendor prices
wiki_data.json Wiki-scraped acquisition and vendor info
wiki_cache/ Downloaded wiki images

Delete any of these files to force a re-fetch of that data.

Project Structure

skinventory/
├── CMakeLists.txt
├── Skinventory.def
├── toolchain-mingw64.cmake
├── include/
│   ├── HoardAndSeekAPI.h       # H&S cross-addon event API
│   └── nexus/
│       └── Nexus.h             # Raidcore Nexus API header
├── src/
│   ├── dllmain.cpp             # Addon entry point, ImGui UI, Shopping List
│   ├── HttpClient.h/cpp        # WinINet HTTP wrapper
│   ├── SkinCache.h/cpp         # GW2 skin metadata fetch and cache
│   ├── OwnedSkins.h/cpp        # H&S integration for owned skin tracking
│   ├── Commerce.h/cpp          # TP prices, item mapping, vendor prices
│   └── WikiImage.h/cpp         # Wiki scraping, image cache, vendor parsing
├── scripts/
│   └── setup.sh                # Dependency download script
└── README.md

License

This project is licensed under the MIT License.

Third-Party Notices

This project uses the following open-source libraries:

  • Dear ImGui — MIT License, Copyright (c) 2014-2021 Omar Cornut
  • nlohmann/json — MIT License, Copyright (c) 2013-2025 Niels Lohmann
  • Nexus API — MIT License, Copyright (c) Raidcore.GG

About

GW2 Nexus addon for browsing and collecting armor and weapon skins

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors