A .NET code library for interacting with the Guild Wars 2 API and game client.
- Introduction to features in the SDK
- Installation instructions for NuGet packages
- Basic usage example for working with the SDK
- API documentation for the SDK
- API key management for the Guild Wars 2 API
To give feedback:
- GitHub Issues for bug reports and feature requests
- GitHub Discussions for other feedback or questions
The SDK provides an interface to the Guild Wars 2 API and game client. It is designed to be easy to use and to provide a high level of performance.
It provides the following features and benefits:
- Asynchronous methods to query the API
- Asynchronous methods to stream data from the game client
- High performance, low-allocation JSON conversions with System.Text.Json
- Type safety and nullability annotations for C# 8.0+
- Pure C# implementation, no native dependencies
- Cross-platform support
- AOT compilation support
- Free and open source under the MIT license
GW2SDK is compiled for .NET Standard 2.0 so it supports a wide range of platforms:
- .NET Core 2.0+
- .NET Framework 4.6.2+
- Mono 5.4+
- Xamarin.iOS 10.14+
- Xamarin.Mac 3.8+
- Xamarin.Android 8.0+
- Universal Windows Platform 10.0.16299+
- Unity 2018.1+
Retrieving information from the game client is only supported on Windows due to the use of named memory-mapped files. It might work in Wine, but it has not been tested.
You are welcome to create an issue if you find something is missing or broken, or a discussion for other feedback, questions or ideas.
You are also welcome to propose changes directly with a pull request.
- Small changes can be made with the free github.dev editor.
- A Dev Container definition is provided for larger changes.
The wiki contains information for contributors. The docs directory contains user-facing articles which are used to build the documentation site.
(Light usage of Codespaces is free*, up to around 60 hours per month if you choose the lightest machine and don't exceed 15GB disk usage. This codespace weighs around 2.84GB.)
- Codecov contains test coverage reports
- Guild Wars 2 wiki: API contains API endpoint documentation
- Guild Wars 2 wiki: chat link format contains the format of chat links
- https://api.guildwars2.com/v2 contains an overview of API endpoints
- https://api.guildwars2.com/v2.json?v=latest contains API endpoints, schema versions and changelog in machine-readable format