Gw2sdk
A .NET code library for interacting with the Guild Wars 2 API and game client.
Install / Use
/learn @sliekens/Gw2sdkREADME
GW2SDK
A .NET library for the Guild Wars 2 API and game client.
Introduction · Installation · Usage · API Docs · API Keys
</div>✨ Features
| | | |---|---| | ⚡ High Performance | Low-allocation JSON with System.Text.Json | | 🔄 Async First | Stream data from both the API and game client | | 🎯 Type Safe | Full nullability annotations for C# 8.0+ | | 🧩 Pure C# | No native dependencies | | 🌍 Cross-Platform | Runs anywhere .NET runs | | 🚀 AOT Ready | Supports ahead-of-time compilation | | 📜 MIT License | Free and open source |
⚡ Quick Start
using var httpClient = new HttpClient();
var gw2 = new Gw2Client(httpClient);
// Get today's daily achievements
var dailies = await gw2.Hero.Achievements.GetDailyAchievements();
// Get trading post prices
var prices = await gw2.Commerce.GetItemPriceById(19721); // Glob of Ectoplasm
Console.WriteLine($"Buy: {prices.Value.BestBid}, Sell: {prices.Value.BestAsk}");
📦 Platform Support
GW2SDK targets .NET Standard 2.0, supporting modern and legacy runtimes:
| Platform | Version | |----------|---------| | .NET | 8.0+ | | .NET Framework | 4.6.2+ | | Mono | 5.4+ | | Xamarin.iOS | 10.14+ | | Xamarin.Mac | 3.8+ | | Xamarin.Android | 8.0+ | | UWP | 10.0.16299+ | | Unity | 2018.1+ |
Note: Game client integration (MumbleLink) requires Windows. Wine compatibility is untested.
🤝 Contributing
Check the wiki for contributor guidelines and the documentation site for user guides.
<div align="center">
Other ways to contribute:
- 🐛 Report a bug or 💡 request a feature
- 💬 Start a discussion for questions or feedback
- ✏️ Quick edit typos directly in your browser
[!TIP] GitHub Codespaces offers ~60 free hours/month.
📚 Resources
| Resource | Description | |----------|-------------| | Codecov | Test coverage reports | | GW2 Wiki: API | Official API documentation | | GW2 Wiki: Chat Links | Chat link format specification | | GW2 Wiki: MumbleLink | MumbleLink structure format | | API Explorer | Browse available endpoints | | API Schema | Machine-readable endpoint data |
<div align="center">
Made with ❤️ for the Guild Wars 2 community
</div>