👁 Image
BlossomiShymae.Briar 0.2.3

Briar

👁 NuGet Stable
👁 NuGet Downloads

Briar is a wrapper for the League Client and Game Client APIs which are unofficially provided by Riot Games.

This library is currently compatible with .NET 8 and higher for Windows and MacOS.

Contributors

<a href="https://github.com/BlossomiShymae/Briar/graphs/contributors"> <img src="https://contrib.rocks/image?repo=BlossomiShymae/Briar" /> </a>

Usage

Installation

dotnet install BlossomiShymae.Briar

Sample application

A demonstration of Briar with more code examples can be found here.

To run the demo, clone the repo and then do:

dotnet run --project BlossomiShymae.Briar.Demo

Requesting the LCU

This library uses the System.Net.Http.HttpClient interface via LcuHttpClient. It comes with a built-in handler that takes care of the request path and authorization header.

Getting the LcuHttpClient instance

var client = Connector.GetLcuHttpClientInstance();

General request

var response = await client.SendAsync(new(HttpMethod.Get, "/lol-summoner/v1/current-summoner"));

var me = await response.Content.ReadFromJsonAsync<Summoner>();

GET request

var me = await client.GetFromJsonAsync<Summoner>("/lol-summoner/v1/current-summoner");

POST request with JSON body

var response = await client.PostAsJsonAsync("/player-notifications/v1/notifications", playerNotificationResource);

var resource = await response.Content.ReadFromJsonAsync<PlayerNotificationResource>();

Utilities

var leagueClientProcess = ProcessFinder.GetProcess();
var processInfo = ProcessFinder.GetProcessInfo();
var isActive = ProcessFinder.IsActive();
var isPortOpen = ProcessFinder.IsPortOpen();

var riotAuthentication = new RiotAuthentication(processInfo.RemotingAuthToken);

Requesting the Game Client

Getting the GameHttpClient instance

var client = Connector.GetGameHttpClientInstance();

General request

var response = await client.SendAsync(new(HttpMethod.Get, "/liveclientdata/activeplayername"));

var me = await response.Content.ReadFromJsonAsync<string>();

GET request

var me = await client.GetFromJsonAsync<string>("/liveclientdata/activeplayername");

LCU WebSocket

This library uses the Websocket.Client wrapper.

Create a client:

var client = Connector.CreateLcuWebsocketClient();

Listen to events, disconnections, or reconnection messages:

using System; // Include to avoid compiler errors CS1503, CS1660.
 // You may or may not need this.

client.EventReceived.Subscribe(msg =>
{
 Console.WriteLine(msg?.Data?.Uri);
});
client.DisconnectionHappened.Subscribe(msg => 
{
 if (msg.Exception != null) throw msg.Exception;
});
client.ReconnectionHappened.Subscribe(msg =>
{
 Console.WriteLine(msg.Type);
});

Use it:

// This starts the client in a background thread. You will need an event loop
// to listen to messages.
await client.Start();

// Subscribe to every event that the League Client sends.
var message = new EventMessage(EventRequestType.Subscribe, EventKinds.OnJsonApiEvent);
client.Send(message);

// We will need an event loop for the background thread to process.
while(true) await Task.Delay(TimeSpan.FromSeconds(1));