BlossomiShymae.GrrrLCU
0.13.1
See the version list below for details.
dotnet add package BlossomiShymae.GrrrLCU --version 0.13.1
NuGet\Install-Package BlossomiShymae.GrrrLCU -Version 0.13.1
<PackageReference Include="BlossomiShymae.GrrrLCU" Version="0.13.1" />
paket add BlossomiShymae.GrrrLCU --version 0.13.1
#r "nuget: BlossomiShymae.GrrrLCU, 0.13.1"
// Install BlossomiShymae.GrrrLCU as a Cake Addin #addin nuget:?package=BlossomiShymae.GrrrLCU&version=0.13.1 // Install BlossomiShymae.GrrrLCU as a Cake Tool #tool nuget:?package=BlossomiShymae.GrrrLCU&version=0.13.1
GrrrLCU
GrrrLCU is a wrapper for the LCU API which is unofficially provided by Riot Games.
This library is currently compatible with .NET 8 and higher for Windows.
Contributors
<a href="https://github.com/BlossomiShymae/GrrrLCU/graphs/contributors"> <img src="https://contrib.rocks/image?repo=BlossomiShymae/GrrrLCU" /> </a>
Usage
Sample application
A demonstration of GrrrLCU with more code examples can be found here.
To run the demo:
dotnet run --project BlossomiShymae.GrrrLCU.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.
[!NOTE] The built-in handler will attempt to refresh the port and auth if a
HttpRequestException
is encountered on request.InvalidOperationException
will be thrown if the port of the current LCU process cannot be found or the port cannot be connected to.
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>();
[!WARNING]
ProcessFinder.IsActive()
does not necessarily mean that the LCU process port is open for requests.
Utilities
var processInfo = ProcessFinder.Get();
var isActive = ProcessFinder.IsActive();
var isPortOpen = ProcessFinder.IsPortOpen();
var riotAuthentication = new RiotAuthentication(processInfo.RemotingAuthToken);
WebSockets
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(RequestType.Subscribe, EventMessage.Kinds.OnJsonApiEvent);
client.Send(message);
// We will need an event loop for the background thread to process.
while(true) await Task.Delay(TimeSpan.FromSeconds(1));
Product | Versions Compatible and additional computed target framework versions. |
---|---|
.NET | net8.0-windows7.0 is compatible. |
-
net8.0-windows7.0
- System.Management (>= 8.0.0)
- Websocket.Client (>= 5.1.2)
NuGet packages
This package is not used by any NuGet packages.
GitHub repositories
This package is not used by any popular GitHub repositories.
Version | Downloads | Last updated |
---|---|---|
0.14.0 | 29 | 8/29/2024 |
0.13.1 | 76 | 8/24/2024 |
0.13.0 | 67 | 8/23/2024 |
0.12.0 | 73 | 8/22/2024 |
0.11.1 | 72 | 8/20/2024 |
0.11.0 | 74 | 8/20/2024 |
0.10.0 | 74 | 8/16/2024 |
0.9.0 | 76 | 8/10/2024 |
0.8.0 | 70 | 8/8/2024 |
0.7.0 | 57 | 8/7/2024 |
0.6.0 | 61 | 8/7/2024 |
0.5.0 | 31 | 8/4/2024 |
0.4.0 | 29 | 8/2/2024 |
0.3.0 | 41 | 8/1/2024 |
0.2.0 | 31 | 7/31/2024 |
0.1.1 | 54 | 7/27/2024 |
0.1.0 | 54 | 7/27/2024 |