├── .gitattributes ├── .github └── ISSUE_TEMPLATE │ ├── bug_report.md │ └── feature_request.md ├── .gitignore ├── LCUSharp.sln ├── LCUSharp ├── Http │ ├── Endpoints │ │ ├── EndpointBase.cs │ │ ├── ProcessControl │ │ │ ├── IProcessControlEndpoint.cs │ │ │ └── ProcessControlEndpoint.cs │ │ └── RiotClient │ │ │ ├── IRiotClientEndpoint.cs │ │ │ └── RiotClientEndpoint.cs │ ├── ILeagueRequestHandler.cs │ ├── LeagueRequestHandler.cs │ └── RequestHandler.cs ├── ILeagueClientApi.cs ├── LCUSharp.csproj ├── LeagueClientApi.cs ├── Utility │ ├── LeagueProcessHandler.cs │ └── LockFileHandler.cs └── Websocket │ ├── ILeagueEventHandler.cs │ ├── LeagueEvent.cs │ └── LeagueEventHandler.cs ├── LICENSE.txt └── README.md /.gitattributes: -------------------------------------------------------------------------------- 1 | ############################################################################### 2 | # Set default behavior to automatically normalize line endings. 3 | ############################################################################### 4 | * text=auto 5 | 6 | ############################################################################### 7 | # Set default behavior for command prompt diff. 8 | # 9 | # This is need for earlier builds of msysgit that does not have it on by 10 | # default for csharp files. 11 | # Note: This is only used by command line 12 | ############################################################################### 13 | #*.cs diff=csharp 14 | 15 | ############################################################################### 16 | # Set the merge driver for project and solution files 17 | # 18 | # Merging from the command prompt will add diff markers to the files if there 19 | # are conflicts (Merging from VS is not affected by the settings below, in VS 20 | # the diff markers are never inserted). Diff markers may cause the following 21 | # file extensions to fail to load in VS. An alternative would be to treat 22 | # these files as binary and thus will always conflict and require user 23 | # intervention with every merge. To do so, just uncomment the entries below 24 | ############################################################################### 25 | #*.sln merge=binary 26 | #*.csproj merge=binary 27 | #*.vbproj merge=binary 28 | #*.vcxproj merge=binary 29 | #*.vcproj merge=binary 30 | #*.dbproj merge=binary 31 | #*.fsproj merge=binary 32 | #*.lsproj merge=binary 33 | #*.wixproj merge=binary 34 | #*.modelproj merge=binary 35 | #*.sqlproj merge=binary 36 | #*.wwaproj merge=binary 37 | 38 | ############################################################################### 39 | # behavior for image files 40 | # 41 | # image files are treated as binary by default. 42 | ############################################################################### 43 | #*.jpg binary 44 | #*.png binary 45 | #*.gif binary 46 | 47 | ############################################################################### 48 | # diff behavior for common document formats 49 | # 50 | # Convert binary document formats to text before diffing them. This feature 51 | # is only available from the command line. Turn it on by uncommenting the 52 | # entries below. 53 | ############################################################################### 54 | #*.doc diff=astextplain 55 | #*.DOC diff=astextplain 56 | #*.docx diff=astextplain 57 | #*.DOCX diff=astextplain 58 | #*.dot diff=astextplain 59 | #*.DOT diff=astextplain 60 | #*.pdf diff=astextplain 61 | #*.PDF diff=astextplain 62 | #*.rtf diff=astextplain 63 | #*.RTF diff=astextplain 64 | -------------------------------------------------------------------------------- /.github/ISSUE_TEMPLATE/bug_report.md: -------------------------------------------------------------------------------- 1 | --- 2 | name: Bug report 3 | about: Create a report to help us improve 4 | title: '' 5 | labels: bug 6 | assignees: '' 7 | 8 | --- 9 | 10 | **Describe the bug** 11 | A clear and concise description of what the bug is. 12 | 13 | **To Reproduce** 14 | Steps to reproduce the behavior: 15 | 1. Go to '...' 16 | 2. Click on '....' 17 | 3. Scroll down to '....' 18 | 4. See error 19 | 20 | **Expected behavior** 21 | A clear and concise description of what you expected to happen. 22 | 23 | **Screenshots** 24 | If applicable, add screenshots to help explain your problem. 25 | 26 | **Additional context** 27 | Add any other context about the problem here. 28 | -------------------------------------------------------------------------------- /.github/ISSUE_TEMPLATE/feature_request.md: -------------------------------------------------------------------------------- 1 | --- 2 | name: Feature request 3 | about: Suggest an idea for this project 4 | title: '' 5 | labels: enhancement 6 | assignees: '' 7 | 8 | --- 9 | 10 | **Is your feature request related to a problem? Please describe.** 11 | A clear and concise description of what the problem is. Ex. I'm always frustrated when [...] 12 | 13 | **Describe the solution you'd like** 14 | A clear and concise description of what you want to happen. 15 | 16 | **Describe alternatives you've considered** 17 | A clear and concise description of any alternative solutions or features you've considered. 18 | 19 | **Additional context** 20 | Add any other context or screenshots about the feature request here. 21 | -------------------------------------------------------------------------------- /.gitignore: -------------------------------------------------------------------------------- 1 | ## Ignore Visual Studio temporary files, build results, and 2 | ## files generated by popular Visual Studio add-ons. 3 | 4 | # User-specific files 5 | *.suo 6 | *.user 7 | *.userosscache 8 | *.sln.docstates 9 | 10 | # User-specific files (MonoDevelop/Xamarin Studio) 11 | *.userprefs 12 | 13 | # Build results 14 | [Dd]ebug/ 15 | [Dd]ebugPublic/ 16 | [Rr]elease/ 17 | [Rr]eleases/ 18 | x64/ 19 | x86/ 20 | bld/ 21 | [Bb]in/ 22 | [Oo]bj/ 23 | [Ll]og/ 24 | 25 | # Visual Studio 2015 cache/options directory 26 | .vs/ 27 | # Uncomment if you have tasks that create the project's static files in wwwroot 28 | #wwwroot/ 29 | 30 | # MSTest test Results 31 | [Tt]est[Rr]esult*/ 32 | [Bb]uild[Ll]og.* 33 | 34 | # NUNIT 35 | *.VisualState.xml 36 | TestResult.xml 37 | 38 | # Build Results of an ATL Project 39 | [Dd]ebugPS/ 40 | [Rr]eleasePS/ 41 | dlldata.c 42 | 43 | # DNX 44 | project.lock.json 45 | project.fragment.lock.json 46 | artifacts/ 47 | 48 | *_i.c 49 | *_p.c 50 | *_i.h 51 | *.ilk 52 | *.meta 53 | *.obj 54 | *.pch 55 | *.pdb 56 | *.pgc 57 | *.pgd 58 | *.rsp 59 | *.sbr 60 | *.tlb 61 | *.tli 62 | *.tlh 63 | *.tmp 64 | *.tmp_proj 65 | *.log 66 | *.vspscc 67 | *.vssscc 68 | .builds 69 | *.pidb 70 | *.svclog 71 | *.scc 72 | 73 | # Chutzpah Test files 74 | _Chutzpah* 75 | 76 | # Visual C++ cache files 77 | ipch/ 78 | *.aps 79 | *.ncb 80 | *.opendb 81 | *.opensdf 82 | *.sdf 83 | *.cachefile 84 | *.VC.db 85 | *.VC.VC.opendb 86 | 87 | # Visual Studio profiler 88 | *.psess 89 | *.vsp 90 | *.vspx 91 | *.sap 92 | 93 | # TFS 2012 Local Workspace 94 | $tf/ 95 | 96 | # Guidance Automation Toolkit 97 | *.gpState 98 | 99 | # ReSharper is a .NET coding add-in 100 | _ReSharper*/ 101 | *.[Rr]e[Ss]harper 102 | *.DotSettings.user 103 | 104 | # JustCode is a .NET coding add-in 105 | .JustCode 106 | 107 | # TeamCity is a build add-in 108 | _TeamCity* 109 | 110 | # DotCover is a Code Coverage Tool 111 | *.dotCover 112 | 113 | # NCrunch 114 | _NCrunch_* 115 | .*crunch*.local.xml 116 | nCrunchTemp_* 117 | 118 | # MightyMoose 119 | *.mm.* 120 | AutoTest.Net/ 121 | 122 | # Web workbench (sass) 123 | .sass-cache/ 124 | 125 | # Installshield output folder 126 | [Ee]xpress/ 127 | 128 | # DocProject is a documentation generator add-in 129 | DocProject/buildhelp/ 130 | DocProject/Help/*.HxT 131 | DocProject/Help/*.HxC 132 | DocProject/Help/*.hhc 133 | DocProject/Help/*.hhk 134 | DocProject/Help/*.hhp 135 | DocProject/Help/Html2 136 | DocProject/Help/html 137 | 138 | # Click-Once directory 139 | publish/ 140 | 141 | # Publish Web Output 142 | *.[Pp]ublish.xml 143 | *.azurePubxml 144 | # TODO: Comment the next line if you want to checkin your web deploy settings 145 | # but database connection strings (with potential passwords) will be unencrypted 146 | #*.pubxml 147 | *.publishproj 148 | 149 | # Microsoft Azure Web App publish settings. Comment the next line if you want to 150 | # checkin your Azure Web App publish settings, but sensitive information contained 151 | # in these scripts will be unencrypted 152 | PublishScripts/ 153 | 154 | # NuGet Packages 155 | *.nupkg 156 | # The packages folder can be ignored because of Package Restore 157 | **/packages/* 158 | # except build/, which is used as an MSBuild target. 159 | !**/packages/build/ 160 | # Uncomment if necessary however generally it will be regenerated when needed 161 | #!**/packages/repositories.config 162 | # NuGet v3's project.json files produces more ignoreable files 163 | *.nuget.props 164 | *.nuget.targets 165 | 166 | # Microsoft Azure Build Output 167 | csx/ 168 | *.build.csdef 169 | 170 | # Microsoft Azure Emulator 171 | ecf/ 172 | rcf/ 173 | 174 | # Windows Store app package directories and files 175 | AppPackages/ 176 | BundleArtifacts/ 177 | Package.StoreAssociation.xml 178 | _pkginfo.txt 179 | 180 | # Visual Studio cache files 181 | # files ending in .cache can be ignored 182 | *.[Cc]ache 183 | # but keep track of directories ending in .cache 184 | !*.[Cc]ache/ 185 | 186 | # Others 187 | ClientBin/ 188 | ~$* 189 | *~ 190 | *.dbmdl 191 | *.dbproj.schemaview 192 | *.jfm 193 | *.pfx 194 | *.publishsettings 195 | node_modules/ 196 | orleans.codegen.cs 197 | 198 | # Since there are multiple workflows, uncomment next line to ignore bower_components 199 | # (https://github.com/github/gitignore/pull/1529#issuecomment-104372622) 200 | #bower_components/ 201 | 202 | # RIA/Silverlight projects 203 | Generated_Code/ 204 | 205 | # Backup & report files from converting an old project file 206 | # to a newer Visual Studio version. Backup files are not needed, 207 | # because we have git ;-) 208 | _UpgradeReport_Files/ 209 | Backup*/ 210 | UpgradeLog*.XML 211 | UpgradeLog*.htm 212 | 213 | # SQL Server files 214 | *.mdf 215 | *.ldf 216 | 217 | # Business Intelligence projects 218 | *.rdl.data 219 | *.bim.layout 220 | *.bim_*.settings 221 | 222 | # Microsoft Fakes 223 | FakesAssemblies/ 224 | 225 | # GhostDoc plugin setting file 226 | *.GhostDoc.xml 227 | 228 | # Node.js Tools for Visual Studio 229 | .ntvs_analysis.dat 230 | 231 | # Visual Studio 6 build log 232 | *.plg 233 | 234 | # Visual Studio 6 workspace options file 235 | *.opt 236 | 237 | # Visual Studio LightSwitch build output 238 | **/*.HTMLClient/GeneratedArtifacts 239 | **/*.DesktopClient/GeneratedArtifacts 240 | **/*.DesktopClient/ModelManifest.xml 241 | **/*.Server/GeneratedArtifacts 242 | **/*.Server/ModelManifest.xml 243 | _Pvt_Extensions 244 | 245 | # Paket dependency manager 246 | .paket/paket.exe 247 | paket-files/ 248 | 249 | # FAKE - F# Make 250 | .fake/ 251 | 252 | # JetBrains Rider 253 | .idea/ 254 | *.sln.iml 255 | 256 | # CodeRush 257 | .cr/ 258 | 259 | # Python Tools for Visual Studio (PTVS) 260 | __pycache__/ 261 | *.pyc -------------------------------------------------------------------------------- /LCUSharp.sln: -------------------------------------------------------------------------------- 1 |  2 | Microsoft Visual Studio Solution File, Format Version 12.00 3 | # Visual Studio Version 16 4 | VisualStudioVersion = 16.0.28407.52 5 | MinimumVisualStudioVersion = 10.0.40219.1 6 | Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "LCUSharp", "LCUSharp\LCUSharp.csproj", "{919961C7-FFB2-482F-8013-793CA02AB86A}" 7 | EndProject 8 | Global 9 | GlobalSection(SolutionConfigurationPlatforms) = preSolution 10 | Debug|Any CPU = Debug|Any CPU 11 | Release|Any CPU = Release|Any CPU 12 | EndGlobalSection 13 | GlobalSection(ProjectConfigurationPlatforms) = postSolution 14 | {919961C7-FFB2-482F-8013-793CA02AB86A}.Debug|Any CPU.ActiveCfg = Debug|Any CPU 15 | {919961C7-FFB2-482F-8013-793CA02AB86A}.Debug|Any CPU.Build.0 = Debug|Any CPU 16 | {919961C7-FFB2-482F-8013-793CA02AB86A}.Release|Any CPU.ActiveCfg = Release|Any CPU 17 | {919961C7-FFB2-482F-8013-793CA02AB86A}.Release|Any CPU.Build.0 = Release|Any CPU 18 | EndGlobalSection 19 | GlobalSection(SolutionProperties) = preSolution 20 | HideSolutionNode = FALSE 21 | EndGlobalSection 22 | GlobalSection(ExtensibilityGlobals) = postSolution 23 | SolutionGuid = {714AD3EF-DB23-4458-B786-603827B4E228} 24 | EndGlobalSection 25 | EndGlobal 26 | -------------------------------------------------------------------------------- /LCUSharp/Http/Endpoints/EndpointBase.cs: -------------------------------------------------------------------------------- 1 | namespace LCUSharp.Http.Endpoints 2 | { 3 | /// 4 | /// An endpoint within the league client's API. 5 | /// 6 | internal abstract class EndpointBase 7 | { 8 | /// 9 | /// The request handler. 10 | /// 11 | protected ILeagueRequestHandler RequestHandler { get; set; } 12 | 13 | /// 14 | /// Initializes a new instance of the class. 15 | /// 16 | /// The request handler. 17 | public EndpointBase(ILeagueRequestHandler requestHandler) 18 | { 19 | RequestHandler = requestHandler; 20 | } 21 | } 22 | } 23 | -------------------------------------------------------------------------------- /LCUSharp/Http/Endpoints/ProcessControl/IProcessControlEndpoint.cs: -------------------------------------------------------------------------------- 1 | using System.Threading.Tasks; 2 | 3 | namespace LCUSharp.Http.Endpoints 4 | { 5 | /// 6 | /// Handles operations relating to the process-control endpoint. 7 | /// 8 | public interface IProcessControlEndpoint 9 | { 10 | /// 11 | /// Quits the league client processes. 12 | /// 13 | Task QuitAsync(); 14 | 15 | /// 16 | /// Restarts the league client processes. 17 | /// 18 | /// The amount of time to wait before restarting. 19 | Task RestartAsync(int delaySeconds); 20 | 21 | /// 22 | /// Restarts the league client processes. 23 | /// 24 | /// The amount of time to wait before restarting. 25 | /// The client version to use on restart. 26 | Task RestartAsync(int delaySeconds, int restartVersion); 27 | 28 | /// 29 | /// Restarts the league client processes to repair the client. 30 | /// 31 | Task RestartToRepair(); 32 | 33 | /// 34 | /// Restarts the league client processes to update. 35 | /// 36 | /// The amount of time to wait before restarting. 37 | /// The update source url. 38 | Task RestartToUpdate(int delaySeconds, string selfUpdateUrl); 39 | } 40 | } 41 | -------------------------------------------------------------------------------- /LCUSharp/Http/Endpoints/ProcessControl/ProcessControlEndpoint.cs: -------------------------------------------------------------------------------- 1 | using System.Collections.Generic; 2 | using System.Net.Http; 3 | using System.Threading.Tasks; 4 | 5 | namespace LCUSharp.Http.Endpoints 6 | { 7 | /// 8 | internal class ProcessControlEndpoint : EndpointBase, IProcessControlEndpoint 9 | { 10 | private const string BaseUrl = "process-control/v1/process/"; 11 | 12 | /// 13 | /// Initializes a new instance of the class. 14 | /// 15 | public ProcessControlEndpoint(ILeagueRequestHandler requestHandler) 16 | : base(requestHandler) 17 | { 18 | } 19 | 20 | /// 21 | public async Task QuitAsync() 22 | { 23 | await RequestHandler.GetJsonResponseAsync(HttpMethod.Post, $"{BaseUrl}quit").ConfigureAwait(false); 24 | } 25 | 26 | /// 27 | public async Task RestartAsync(int delaySeconds) 28 | { 29 | var queryParameters = new List(); 30 | await RestartAsync(delaySeconds, queryParameters).ConfigureAwait(false); 31 | } 32 | 33 | /// 34 | public async Task RestartAsync(int delaySeconds, int restartVersion) 35 | { 36 | var queryParameters = new List { $"restartVersion={restartVersion}" }; 37 | await RestartAsync(delaySeconds, queryParameters).ConfigureAwait(false); 38 | } 39 | 40 | /// 41 | public async Task RestartToRepair() 42 | { 43 | await RequestHandler.GetJsonResponseAsync(HttpMethod.Post, $"{BaseUrl}restart-to-repair").ConfigureAwait(false); 44 | } 45 | 46 | /// 47 | public async Task RestartToUpdate(int delaySeconds, string selfUpdateUrl) 48 | { 49 | var queryParameters = new string[] 50 | { 51 | $"delaySeconds={delaySeconds}", 52 | $"selfUpdateUrl={selfUpdateUrl}" 53 | }; 54 | await RequestHandler.GetJsonResponseAsync(HttpMethod.Post, $"{BaseUrl}restart-to-update", queryParameters).ConfigureAwait(false); 55 | } 56 | 57 | /// 58 | /// Restarts the league client process. 59 | /// 60 | /// The amount of time to wait before restarting. 61 | /// The query parameters. 62 | /// 63 | private async Task RestartAsync(int delaySeconds, ICollection queryParameters) 64 | { 65 | queryParameters.Add($"delaySeconds={delaySeconds}"); 66 | await RequestHandler.GetJsonResponseAsync(HttpMethod.Post, $"{BaseUrl}restart", queryParameters).ConfigureAwait(false); 67 | } 68 | } 69 | } 70 | -------------------------------------------------------------------------------- /LCUSharp/Http/Endpoints/RiotClient/IRiotClientEndpoint.cs: -------------------------------------------------------------------------------- 1 | using System.Threading.Tasks; 2 | 3 | namespace LCUSharp.Http.Endpoints 4 | { 5 | /// 6 | /// Handles operations relating to the riotclient endpoint. 7 | /// 8 | public interface IRiotClientEndpoint 9 | { 10 | /// 11 | /// Minimizes the client. 12 | /// 13 | Task MinimizeUxAsync(); 14 | 15 | /// 16 | /// Show the client. 17 | /// 18 | Task ShowUxAsync(); 19 | 20 | /// 21 | /// Flashes the client's icon on the taskbar. 22 | /// 23 | Task FlashUxAsync(); 24 | 25 | /// 26 | /// Kills the client ux. 27 | /// 28 | Task KillUxAsync(); 29 | 30 | /// 31 | /// Kills and restarts the client ux. 32 | /// 33 | Task KillAndRestartUxAsync(); 34 | 35 | /// 36 | /// Kills the client ux and resets the state (logs out user, etc.). 37 | /// 38 | Task UnloadUxAsync(); 39 | 40 | /// 41 | /// Launches the client ux. 42 | /// 43 | Task LaunchUxAsync(); 44 | 45 | /// 46 | /// Gets the client ux zoom scale. 47 | /// 48 | /// The zoom scale. 49 | Task GetZoomScaleAsync(); 50 | 51 | /// 52 | /// Sets the client ux zoom scale. 53 | /// 54 | /// The zoom scale. 55 | /// 56 | Task SetZoomScaleAsync(double scale); 57 | } 58 | } 59 | -------------------------------------------------------------------------------- /LCUSharp/Http/Endpoints/RiotClient/RiotClientEndpoint.cs: -------------------------------------------------------------------------------- 1 | using System.Net.Http; 2 | using System.Threading.Tasks; 3 | 4 | namespace LCUSharp.Http.Endpoints 5 | { 6 | /// 7 | internal class RiotClientEndpoint : EndpointBase, IRiotClientEndpoint 8 | { 9 | private const string BaseUrl = "riotclient/"; 10 | 11 | /// 12 | /// Initializes a new instance of the class. 13 | /// 14 | public RiotClientEndpoint(ILeagueRequestHandler requestHandler) 15 | : base(requestHandler) 16 | { 17 | } 18 | 19 | /// 20 | public async Task MinimizeUxAsync() 21 | { 22 | await RequestHandler.GetJsonResponseAsync(HttpMethod.Post, $"{BaseUrl}ux-minimize").ConfigureAwait(false); 23 | } 24 | 25 | /// 26 | public async Task ShowUxAsync() 27 | { 28 | await RequestHandler.GetJsonResponseAsync(HttpMethod.Post, $"{BaseUrl}ux-show").ConfigureAwait(false); 29 | } 30 | 31 | /// 32 | public async Task FlashUxAsync() 33 | { 34 | await RequestHandler.GetJsonResponseAsync(HttpMethod.Post, $"{BaseUrl}ux-flash").ConfigureAwait(false); 35 | } 36 | 37 | /// 38 | public async Task KillUxAsync() 39 | { 40 | await RequestHandler.GetJsonResponseAsync(HttpMethod.Post, $"{BaseUrl}kill-ux").ConfigureAwait(false); 41 | } 42 | 43 | /// 44 | public async Task KillAndRestartUxAsync() 45 | { 46 | await RequestHandler.GetJsonResponseAsync(HttpMethod.Post, $"{BaseUrl}kill-and-restart-ux").ConfigureAwait(false); 47 | } 48 | 49 | /// 50 | public async Task UnloadUxAsync() 51 | { 52 | await RequestHandler.GetJsonResponseAsync(HttpMethod.Post, $"{BaseUrl}unload").ConfigureAwait(false); 53 | } 54 | 55 | /// 56 | public async Task LaunchUxAsync() 57 | { 58 | await RequestHandler.GetJsonResponseAsync(HttpMethod.Post, $"{BaseUrl}launch-ux").ConfigureAwait(false); 59 | } 60 | 61 | /// 62 | public async Task GetZoomScaleAsync() 63 | { 64 | return double.Parse(await RequestHandler.GetJsonResponseAsync(HttpMethod.Get, $"{BaseUrl}zoom-scale").ConfigureAwait(false)); 65 | } 66 | 67 | /// 68 | public async Task SetZoomScaleAsync(double scale) 69 | { 70 | var queryParameters = new string[] { $"newZoomScale={scale}" }; 71 | await RequestHandler.GetJsonResponseAsync(HttpMethod.Post, $"{BaseUrl}zoom-scale", queryParameters).ConfigureAwait(false); 72 | } 73 | } 74 | } 75 | -------------------------------------------------------------------------------- /LCUSharp/Http/ILeagueRequestHandler.cs: -------------------------------------------------------------------------------- 1 | using System.Collections.Generic; 2 | using System.Net.Http; 3 | using System.Threading.Tasks; 4 | 5 | namespace LCUSharp.Http 6 | { 7 | /// 8 | /// A request handler for the league client that requires the client's port and the user's Basic authentication token. 9 | /// 10 | public interface ILeagueRequestHandler 11 | { 12 | /// 13 | /// The league client's port. 14 | /// 15 | int Port { get; set; } 16 | 17 | /// 18 | /// The user's Basic authentication token 19 | /// 20 | string Token { get; set; } 21 | 22 | /// 23 | /// Changes the request handler's settings. 24 | /// 25 | /// The league client's port. 26 | /// The user's Basic authentication token. 27 | void ChangeSettings(int port, string token); 28 | 29 | /// 30 | /// Creates and sends a new and returns the 's content. 31 | /// 32 | /// The . 33 | /// The relative url. 34 | /// The query parameters. 35 | /// The 's content. 36 | Task GetJsonResponseAsync(HttpMethod httpMethod, string relativeUrl, IEnumerable queryParameters = null); 37 | 38 | /// 39 | /// Creates and sends a new and returns the 's content. 40 | /// 41 | /// The object to serialize into the body. 42 | /// The . 43 | /// The relative url. 44 | /// The query parameters. 45 | /// The request's body. 46 | /// The 's content. 47 | Task GetJsonResponseAsync(HttpMethod httpMethod, string relativeUrl, IEnumerable queryParameters, TRequest body); 48 | 49 | /// 50 | /// Creates and sends a new and deserializes the 's content (json) as . 51 | /// 52 | /// The object to deserialize the response into. 53 | /// The / 54 | /// The relative url. 55 | /// The query parameters. 56 | /// The deserialized response. 57 | Task GetResponseAsync(HttpMethod httpMethod, string relativeUrl, IEnumerable queryParameters = null); 58 | 59 | /// 60 | /// Creates and sends a new and deserializes the 's content (json) as . 61 | /// 62 | /// The object to serialize into the body. 63 | /// The object to deserialize the response into. 64 | /// The / 65 | /// The relative url. 66 | /// The query parameters. 67 | /// The request's body. 68 | /// The deserialized response. 69 | Task GetResponseAsync(HttpMethod httpMethod, string relativeUrl, IEnumerable queryParameters, TRequest body); 70 | } 71 | } 72 | -------------------------------------------------------------------------------- /LCUSharp/Http/LeagueRequestHandler.cs: -------------------------------------------------------------------------------- 1 | using LCUSharp.Utility; 2 | using Newtonsoft.Json; 3 | using System; 4 | using System.Collections.Generic; 5 | using System.Net.Http; 6 | using System.Net.Http.Headers; 7 | using System.Text; 8 | using System.Threading.Tasks; 9 | 10 | namespace LCUSharp.Http 11 | { 12 | /// 13 | internal class LeagueRequestHandler : RequestHandler, ILeagueRequestHandler 14 | { 15 | /// 16 | public int Port { get; set; } 17 | 18 | /// 19 | public string Token { get; set; } 20 | 21 | /// 22 | /// Creates a new instance of the class. 23 | /// 24 | /// The league client's port. 25 | /// The user's Basic authentication token. 26 | public LeagueRequestHandler(int port, string token) 27 | { 28 | ChangeSettings(port, token); 29 | } 30 | 31 | /// 32 | public void ChangeSettings(int port, string token) 33 | { 34 | Port = port; 35 | Token = token; 36 | CreateHttpClient(); 37 | 38 | var authTokenBytes = Encoding.ASCII.GetBytes($"riot:{token}"); 39 | HttpClient.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue("Basic", Convert.ToBase64String(authTokenBytes)); 40 | HttpClient.BaseAddress = new Uri($"https://127.0.0.1:{port}/"); 41 | } 42 | 43 | /// 44 | public async Task GetJsonResponseAsync(HttpMethod httpMethod, string relativeUrl, IEnumerable queryParameters = null) 45 | { 46 | return await GetJsonResponseAsync(httpMethod, relativeUrl, queryParameters, null).ConfigureAwait(false); 47 | } 48 | 49 | /// 50 | public async Task GetJsonResponseAsync(HttpMethod httpMethod, string relativeUrl, IEnumerable queryParameters, TRequest body) 51 | { 52 | var request = await PrepareRequestAsync(httpMethod, relativeUrl, queryParameters, body).ConfigureAwait(false); 53 | var response = await HttpClient.SendAsync(request).ConfigureAwait(false); 54 | response.EnsureSuccessStatusCode(); 55 | return await GetResponseContentAsync(response).ConfigureAwait(false); 56 | } 57 | 58 | /// 59 | public async Task GetResponseAsync(HttpMethod httpMethod, string relativeUrl, IEnumerable queryParameters = null) 60 | { 61 | return await GetResponseAsync(httpMethod, relativeUrl, queryParameters, null).ConfigureAwait(false); 62 | } 63 | 64 | /// 65 | public async Task GetResponseAsync(HttpMethod httpMethod, string relativeUrl, IEnumerable queryParameters, TRequest body) 66 | { 67 | var json = await GetJsonResponseAsync(httpMethod, relativeUrl, queryParameters, body).ConfigureAwait(false); 68 | return await Task.Run(() => JsonConvert.DeserializeObject(json)).ConfigureAwait(false); 69 | } 70 | } 71 | } 72 | -------------------------------------------------------------------------------- /LCUSharp/Http/RequestHandler.cs: -------------------------------------------------------------------------------- 1 | using Newtonsoft.Json; 2 | using System.Collections.Generic; 3 | using System.Linq; 4 | using System.Net.Http; 5 | using System.Net.Http.Headers; 6 | using System.Text; 7 | using System.Threading.Tasks; 8 | 9 | namespace LCUSharp.Http 10 | { 11 | /// 12 | /// A request handler that supports authentication. 13 | /// 14 | internal abstract class RequestHandler 15 | { 16 | private readonly HttpClientHandler _httpClientHandler; 17 | 18 | /// 19 | /// The HttpClient used to make requests. 20 | /// 21 | protected HttpClient HttpClient { get; private set; } 22 | 23 | /// 24 | /// Creates a new instance of the class. 25 | /// 26 | public RequestHandler() 27 | { 28 | _httpClientHandler = new HttpClientHandler 29 | { 30 | ClientCertificateOptions = ClientCertificateOption.Manual 31 | }; 32 | _httpClientHandler.ServerCertificateCustomValidationCallback = (response, cert, chain, errors) => true; 33 | CreateHttpClient(); 34 | } 35 | 36 | /// 37 | /// Creates a new . 38 | /// 39 | protected void CreateHttpClient() 40 | { 41 | HttpClient = new HttpClient(_httpClientHandler); 42 | HttpClient.DefaultRequestHeaders.Accept.Add(new MediaTypeWithQualityHeaderValue("application/json")); 43 | } 44 | 45 | /// 46 | /// Prepares a request by calculating the proper url. 47 | /// 48 | /// The object to serialize into the body. 49 | /// The relative url. 50 | /// The . 51 | /// The request's body. 52 | /// The query parameters. 53 | /// 54 | protected async Task PrepareRequestAsync(HttpMethod httpMethod, string relativeUrl, IEnumerable queryParameters, TRequest body) 55 | { 56 | var url = queryParameters == null 57 | ? relativeUrl 58 | : relativeUrl + BuildQueryParameterString(queryParameters); 59 | var request = new HttpRequestMessage(httpMethod, url); 60 | 61 | if (body != null) 62 | { 63 | var json = await Task.Run(() => JsonConvert.SerializeObject(body)).ConfigureAwait(false); 64 | request.Content = new StringContent(json, Encoding.UTF8, "application/json"); 65 | } 66 | 67 | return request; 68 | } 69 | 70 | /// 71 | /// Builds the query parameter string that's appended to the request url. 72 | /// 73 | /// The query parameters. 74 | /// The query parameter url string. 75 | protected string BuildQueryParameterString(IEnumerable queryParameters) 76 | { 77 | return "?" + string.Join("&", queryParameters.Where(a => !string.IsNullOrWhiteSpace(a))); 78 | } 79 | 80 | /// 81 | /// Gets a 's content. 82 | /// 83 | /// The . 84 | /// The 's content. 85 | protected async Task GetResponseContentAsync(HttpResponseMessage response) 86 | { 87 | return await response.Content.ReadAsStringAsync().ConfigureAwait(false); 88 | } 89 | } 90 | } 91 | -------------------------------------------------------------------------------- /LCUSharp/ILeagueClientApi.cs: -------------------------------------------------------------------------------- 1 | using LCUSharp.Http; 2 | using LCUSharp.Http.Endpoints; 3 | using LCUSharp.Websocket; 4 | using System; 5 | using System.Threading.Tasks; 6 | 7 | namespace LCUSharp 8 | { 9 | /// 10 | /// Represents an interface that can directly communicate to the league client's API. 11 | /// 12 | public interface ILeagueClientApi 13 | { 14 | /// 15 | /// Triggered when the client disconnects from the api. 16 | /// 17 | event EventHandler Disconnected; 18 | 19 | /// 20 | /// The request handler. 21 | /// 22 | ILeagueRequestHandler RequestHandler { get; } 23 | 24 | /// 25 | /// The event handler. 26 | /// 27 | ILeagueEventHandler EventHandler { get; } 28 | 29 | /// 30 | /// The riot client endpoint. 31 | /// 32 | IRiotClientEndpoint RiotClientEndpoint { get; } 33 | 34 | /// 35 | /// The process control endpoint. 36 | /// 37 | IProcessControlEndpoint ProcessControlEndpoint { get; } 38 | 39 | /// 40 | /// Reconnects to the league client api. 41 | /// 42 | Task ReconnectAsync(); 43 | 44 | /// 45 | /// Disconnect from the league client api. 46 | /// 47 | void Disconnect(); 48 | } 49 | } 50 | -------------------------------------------------------------------------------- /LCUSharp/LCUSharp.csproj: -------------------------------------------------------------------------------- 1 |  2 | 3 | 4 | net5.0 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | -------------------------------------------------------------------------------- /LCUSharp/LeagueClientApi.cs: -------------------------------------------------------------------------------- 1 | using LCUSharp.Http; 2 | using LCUSharp.Http.Endpoints; 3 | using LCUSharp.Utility; 4 | using LCUSharp.Websocket; 5 | using System; 6 | using System.Net.Http; 7 | using System.Threading.Tasks; 8 | 9 | namespace LCUSharp 10 | { 11 | /// 12 | public class LeagueClientApi : ILeagueClientApi 13 | { 14 | private static readonly LeagueProcessHandler _processHandler; 15 | private static readonly LockFileHandler _lockFileHandler; 16 | 17 | /// 18 | public event EventHandler Disconnected; 19 | 20 | /// 21 | public ILeagueRequestHandler RequestHandler { get; } 22 | 23 | /// 24 | public ILeagueEventHandler EventHandler { get; } 25 | 26 | /// 27 | public IRiotClientEndpoint RiotClientEndpoint { get; } 28 | 29 | /// 30 | public IProcessControlEndpoint ProcessControlEndpoint { get; } 31 | 32 | /// 33 | /// Initializes the necessary handlers. 34 | /// 35 | static LeagueClientApi() 36 | { 37 | _processHandler = new LeagueProcessHandler(); 38 | _lockFileHandler = new LockFileHandler(); 39 | } 40 | 41 | /// 42 | /// Initializes a new instance of the class. 43 | /// 44 | /// The league client API's port. 45 | /// The authentication token. 46 | /// The event handler. 47 | private LeagueClientApi(int port, string token, ILeagueEventHandler eventHandler) 48 | { 49 | EventHandler = eventHandler; 50 | RequestHandler = new LeagueRequestHandler(port, token); 51 | RiotClientEndpoint = new RiotClientEndpoint(RequestHandler); 52 | ProcessControlEndpoint = new ProcessControlEndpoint(RequestHandler); 53 | _processHandler.Closed += OnDisconnected; 54 | } 55 | 56 | /// 57 | /// Connects to the league client api. 58 | /// 59 | /// A new instance of that's connected to the client api. 60 | public static async Task ConnectAsync() 61 | { 62 | var (port, token) = await GetAuthCredentialsAsync().ConfigureAwait(false); 63 | var eventHandler = new LeagueEventHandler(port, token); 64 | var api = new LeagueClientApi(port, token, eventHandler); 65 | return await EnsureConnectionAsync(api).ConfigureAwait(false); 66 | } 67 | 68 | /// 69 | public async Task ReconnectAsync() 70 | { 71 | var (port, token) = await GetAuthCredentialsAsync().ConfigureAwait(false); 72 | 73 | RequestHandler.ChangeSettings(port, token); 74 | EventHandler.ChangeSettings(port, token); 75 | 76 | await EnsureConnectionAsync(this).ConfigureAwait(false); 77 | } 78 | 79 | /// 80 | public void Disconnect() 81 | { 82 | OnDisconnected(this, EventArgs.Empty); 83 | } 84 | 85 | /// 86 | /// Gets the league client api authentication credentials. 87 | /// 88 | /// The port and auth token. 89 | private static async Task<(int port, string token)> GetAuthCredentialsAsync() 90 | { 91 | await _processHandler.WaitForProcessAsync().ConfigureAwait(false); 92 | return await _lockFileHandler.ParseLockFileAsync(_processHandler.ExecutablePath).ConfigureAwait(false); 93 | } 94 | 95 | /// 96 | /// Ensures the connection is successful by sending a test request. 97 | /// 98 | /// The league client api. 99 | /// The league client api. 100 | private static async Task EnsureConnectionAsync(LeagueClientApi api) 101 | { 102 | while (true) 103 | { 104 | try 105 | { 106 | await api.RequestHandler 107 | .GetResponseAsync(HttpMethod.Get, "/riotclient/app-name") 108 | .ConfigureAwait(false); 109 | 110 | var delay = Task.Delay(200); 111 | var connect = api.EventHandler.ConnectAsync(); 112 | 113 | var finished = await Task.WhenAny(delay, connect).ConfigureAwait(false); 114 | if (finished == delay) 115 | { 116 | continue; 117 | } 118 | 119 | return api; 120 | } 121 | catch (Exception) 122 | { 123 | await Task.Delay(200).ConfigureAwait(false); 124 | } 125 | } 126 | } 127 | 128 | /// 129 | /// Invoked when the client is disconnected from the api. 130 | /// 131 | /// The sender. 132 | /// The event arguments. 133 | private async void OnDisconnected(object sender, EventArgs e) 134 | { 135 | await EventHandler.DisconnectAsync().ConfigureAwait(false); 136 | Disconnected?.Invoke(this, EventArgs.Empty); 137 | } 138 | } 139 | } 140 | -------------------------------------------------------------------------------- /LCUSharp/Utility/LeagueProcessHandler.cs: -------------------------------------------------------------------------------- 1 | using System; 2 | using System.Diagnostics; 3 | using System.IO; 4 | using System.Threading.Tasks; 5 | 6 | namespace LCUSharp.Utility 7 | { 8 | /// 9 | /// Manages the operations relating to the league client's process. 10 | /// 11 | internal class LeagueProcessHandler 12 | { 13 | private const string ProcessName = "LeagueClientUx"; 14 | 15 | /// 16 | /// Triggers when the league client is closed. 17 | /// 18 | public event EventHandler Closed; 19 | 20 | private Process _process; 21 | /// 22 | /// The league client's process. 23 | /// 24 | public Process Process 25 | { 26 | get { return _process; } 27 | private set 28 | { 29 | if (Process != null) 30 | { 31 | Process.Exited -= OnProcessExited; 32 | } 33 | 34 | _process = value; 35 | Process.EnableRaisingEvents = true; 36 | Process.Exited += OnProcessExited; 37 | 38 | ExecutablePath = Path.GetDirectoryName(Process.MainModule.FileName); 39 | } 40 | } 41 | 42 | /// 43 | /// The league client's executable path. 44 | /// 45 | public string ExecutablePath { get; private set; } 46 | 47 | /// 48 | /// Waits for the league client's process to start. 49 | /// 50 | /// True if the process was found successfully, otherwise false. 51 | public async Task WaitForProcessAsync() 52 | { 53 | while (true) 54 | { 55 | var newProcess = TryGetProcess(); 56 | if (newProcess == null) 57 | { 58 | await Task.Delay(100).ConfigureAwait(false); 59 | continue; 60 | } 61 | 62 | Process = newProcess; 63 | return true; 64 | } 65 | } 66 | 67 | private Process TryGetProcess() 68 | { 69 | var processes = Process.GetProcessesByName(ProcessName); 70 | if (processes.Length <= 0) 71 | { 72 | return null; 73 | } 74 | 75 | var newProcess = processes[0]; 76 | if (newProcess == null || newProcess.MainModule == null) 77 | { 78 | return null; 79 | } 80 | 81 | return newProcess; 82 | } 83 | 84 | /// 85 | /// Called when the league client is closed. 86 | /// 87 | /// The sender. 88 | /// The event arguments. 89 | private void OnProcessExited(object sender, EventArgs e) 90 | { 91 | Closed?.Invoke(sender, e); 92 | } 93 | } 94 | } 95 | -------------------------------------------------------------------------------- /LCUSharp/Utility/LockFileHandler.cs: -------------------------------------------------------------------------------- 1 | using System.IO; 2 | using System.Threading.Tasks; 3 | 4 | namespace LCUSharp.Utility 5 | { 6 | /// 7 | /// Manages the operations relating to the league client's lockfile. 8 | /// 9 | internal class LockFileHandler 10 | { 11 | private const string FileName = "lockfile"; 12 | 13 | /// 14 | /// Creates a new instance of the class. 15 | /// 16 | public LockFileHandler() 17 | { 18 | } 19 | 20 | /// 21 | /// Waits for the lockfile to be created and then parses it for the token, port, etc. 22 | /// 23 | /// The lockfile's path. 24 | /// The league client's port and the user's authentication token. 25 | public async Task<(int port, string token)> ParseLockFileAsync(string path) 26 | { 27 | var lockfilePath = await WaitForFileAsync(path).ConfigureAwait(false); 28 | using (var fileStream = new FileStream(lockfilePath, FileMode.Open, FileAccess.Read, FileShare.ReadWrite)) 29 | { 30 | using (var reader = new StreamReader(fileStream)) 31 | { 32 | var contents = await reader.ReadToEndAsync().ConfigureAwait(false); 33 | var items = contents.Split(':'); 34 | 35 | var processId = int.Parse(items[1]); 36 | var port = int.Parse(items[2]); 37 | var token = items[3]; 38 | 39 | return (port, token); 40 | } 41 | } 42 | } 43 | 44 | /// 45 | /// Waits until the lockfile is created by the league client. 46 | /// 47 | /// The directory to search in. 48 | /// The lockfile's path. 49 | private async Task WaitForFileAsync(string path) 50 | { 51 | var filePath = Path.Combine(path, FileName); 52 | if (File.Exists(filePath)) 53 | { 54 | return filePath; 55 | } 56 | 57 | var fileCreated = new TaskCompletionSource(); 58 | var fileWatcher = new FileSystemWatcher(path); 59 | 60 | void OnFileCreated(object sender, FileSystemEventArgs e) 61 | { 62 | if (e.Name == FileName) 63 | { 64 | filePath = e.FullPath; 65 | fileWatcher.Dispose(); 66 | fileCreated.SetResult(true); 67 | } 68 | } 69 | 70 | fileWatcher.Created += OnFileCreated; 71 | fileWatcher.EnableRaisingEvents = true; 72 | 73 | await fileCreated.Task.ConfigureAwait(false); 74 | return filePath; 75 | } 76 | } 77 | } 78 | -------------------------------------------------------------------------------- /LCUSharp/Websocket/ILeagueEventHandler.cs: -------------------------------------------------------------------------------- 1 | using System; 2 | using System.Threading.Tasks; 3 | 4 | namespace LCUSharp.Websocket 5 | { 6 | /// 7 | /// Handles operations relating to capturing and processing league events via WebSockets. 8 | /// 9 | public interface ILeagueEventHandler 10 | { 11 | /// 12 | /// EventHandler used for the Websocket's received messages. 13 | /// 14 | EventHandler MessageReceived { get; set; } 15 | 16 | /// 17 | /// EventHandler used for the Websocket's error messages. 18 | /// 19 | EventHandler ErrorReceived { get; set; } 20 | 21 | /// 22 | /// Connects to the WebSocket server. 23 | /// 24 | Task ConnectAsync(); 25 | 26 | /// 27 | /// Disconnects from the WebSocket server. 28 | /// 29 | Task DisconnectAsync(); 30 | 31 | /// 32 | /// Initializes the web socket listener. 33 | /// 34 | /// The league client's port. 35 | /// The user's Basic authentication token. 36 | void ChangeSettings(int port, string token); 37 | 38 | /// 39 | /// Subscribes the event handler to the specified event uri. 40 | /// 41 | /// The league client event uri. 42 | /// The event handler. 43 | void Subscribe(string uri, EventHandler eventHandler); 44 | 45 | /// 46 | /// Unsubscribes the event handlers subscribed to the specified event uri. 47 | /// 48 | /// The uri to unsubscribe from. 49 | /// True if the uri exists and was unsubscribed successfully, otherwise false. 50 | bool Unsubscribe(string uri); 51 | 52 | /// 53 | /// Unsubcribes all event handlers. 54 | /// 55 | void UnsubscribeAll(); 56 | } 57 | } 58 | -------------------------------------------------------------------------------- /LCUSharp/Websocket/LeagueEvent.cs: -------------------------------------------------------------------------------- 1 | using Newtonsoft.Json; 2 | using Newtonsoft.Json.Linq; 3 | 4 | namespace LCUSharp.Websocket 5 | { 6 | /// 7 | /// Represents a league client event. 8 | /// 9 | public class LeagueEvent 10 | { 11 | /// 12 | /// The event's data. 13 | /// 14 | [JsonProperty("data")] 15 | public JToken Data { get; set; } 16 | 17 | /// 18 | /// The event's type. 19 | /// 20 | [JsonProperty("eventType")] 21 | public string EventType { get; set; } 22 | 23 | /// 24 | /// The event's uri. 25 | /// 26 | [JsonProperty("uri")] 27 | public string Uri { get; set; } 28 | } 29 | } 30 | -------------------------------------------------------------------------------- /LCUSharp/Websocket/LeagueEventHandler.cs: -------------------------------------------------------------------------------- 1 | using Newtonsoft.Json.Linq; 2 | using System; 3 | using System.Collections.Generic; 4 | using System.Net; 5 | using System.Net.WebSockets; 6 | using System.Reactive.Linq; 7 | using System.Threading.Tasks; 8 | using Websocket.Client; 9 | 10 | namespace LCUSharp.Websocket 11 | { 12 | /// 13 | internal class LeagueEventHandler : ILeagueEventHandler 14 | { 15 | private const int ClientEventData = 2; 16 | private const int ClientEventNumber = 8; 17 | 18 | /// 19 | /// Contains all event handlers that are subscribed to an event uri. 20 | /// 21 | private readonly Dictionary>> _subscribers; 22 | 23 | /// 24 | /// Websocket client used to connect to the League Client's backend. 25 | /// 26 | private WebsocketClient _webSocket; 27 | 28 | /// 29 | public EventHandler MessageReceived { get; set; } 30 | 31 | /// 32 | public EventHandler ErrorReceived { get; set; } 33 | 34 | /// 35 | /// Creates a new instance of the class. 36 | /// 37 | /// The league client's port. 38 | /// The user's Basic authentication token. 39 | public LeagueEventHandler(int port, string token) 40 | { 41 | _subscribers = new Dictionary>>(); 42 | ChangeSettings(port, token); 43 | } 44 | 45 | /// 46 | public async Task ConnectAsync() 47 | { 48 | await _webSocket.Start(); 49 | await _webSocket.SendInstant("[5, \"OnJsonApiEvent\"]"); 50 | } 51 | 52 | /// 53 | public async Task DisconnectAsync() 54 | { 55 | return await _webSocket.Stop(WebSocketCloseStatus.NormalClosure, 56 | "User requested to close the connection."); 57 | } 58 | 59 | /// 60 | public void ChangeSettings(int port, string token) 61 | { 62 | _webSocket = new WebsocketClient(new Uri($"wss://127.0.0.1:{port}/"), () => 63 | { 64 | var socket = new ClientWebSocket 65 | { 66 | Options = 67 | { 68 | Credentials = new NetworkCredential("riot", token), 69 | RemoteCertificateValidationCallback = 70 | (sender, cert, chain, sslPolicyErrors) => true, 71 | } 72 | }; 73 | 74 | socket.Options.AddSubProtocol("wamp"); 75 | return socket; 76 | }); 77 | 78 | _webSocket 79 | .MessageReceived 80 | .Where(msg => msg.Text != null) 81 | .Where(msg => msg.Text.StartsWith('[')) 82 | .Subscribe(msg => 83 | { 84 | // Check if the message is json received from the client 85 | var eventArray = JArray.Parse(msg.Text); 86 | var eventNumber = eventArray?[0].ToObject(); 87 | 88 | if (eventNumber != ClientEventNumber) 89 | { 90 | return; 91 | } 92 | 93 | var leagueEvent = eventArray[ClientEventData].ToObject(); 94 | MessageReceived?.Invoke(this, leagueEvent); 95 | 96 | if (!_subscribers.TryGetValue(leagueEvent.Uri, out var eventHandlers)) 97 | { 98 | return; 99 | } 100 | 101 | eventHandlers.ForEach(eventHandler => eventHandler?.Invoke(this, leagueEvent)); 102 | }); 103 | } 104 | 105 | /// 106 | public void Subscribe(string uri, EventHandler eventHandler) 107 | { 108 | if (_subscribers.TryGetValue(uri, out var eventHandlers)) 109 | { 110 | eventHandlers.Add(eventHandler); 111 | } 112 | else 113 | { 114 | _subscribers.Add(uri, new List> { eventHandler }); 115 | } 116 | } 117 | 118 | /// 119 | public bool Unsubscribe(string uri) 120 | { 121 | return _subscribers.Remove(uri); 122 | } 123 | 124 | /// 125 | public void UnsubscribeAll() 126 | { 127 | _subscribers.Clear(); 128 | } 129 | } 130 | } 131 | -------------------------------------------------------------------------------- /LICENSE.txt: -------------------------------------------------------------------------------- 1 | MIT License 2 | 3 | Copyright (c) 2020 Bryan Hitchcock 4 | 5 | Permission is hereby granted, free of charge, to any person obtaining a copy 6 | of this software and associated documentation files (the "Software"), to deal 7 | in the Software without restriction, including without limitation the rights 8 | to use, copy, modify, merge, publish, distribute, sublicense, and/or sell 9 | copies of the Software, and to permit persons to whom the Software is 10 | furnished to do so, subject to the following conditions: 11 | 12 | The above copyright notice and this permission notice shall be included in all 13 | copies or substantial portions of the Software. 14 | 15 | THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR 16 | IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, 17 | FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE 18 | AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER 19 | LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, 20 | OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE 21 | SOFTWARE. 22 | -------------------------------------------------------------------------------- /README.md: -------------------------------------------------------------------------------- 1 | # lcu-sharp 2 | 3 | An API wrapper for the League of Legends client. 4 | 5 | For the LCU API documentation, check out [Rift Explorer.](https://github.com/Pupix/rift-explorer) 6 | 7 | ## Usage 8 | 9 | ### Request example 10 | 11 | ```cs 12 | // Initialize a connection to the league client. 13 | var api = await LeagueClientApi.ConnectAsync(); 14 | 15 | // Show the client. 16 | await api.RiotClientEndpoint.ShowUxAsync(); 17 | await Task.Delay(1000); 18 | 19 | // Update the current summoner's profile icon to 23. 20 | var body = new { profileIconId = 23 }; 21 | var queryParameters = Enumerable.Empty(); 22 | var json = await api.RequestHandler.GetJsonResponseAsync(HttpMethod.Put, "lol-summoner/v1/current-summoner/icon", 23 | queryParameters, body); 24 | 25 | // Minimize the client. 26 | await Task.Delay(1000); 27 | await api.RiotClientEndpoint.MinimizeUxAsync(); 28 | ``` 29 | 30 | ![Usage Request Run](https://i.imgur.com/OCRPHes.gif) 31 | 32 | ### Event example 33 | 34 | ```cs 35 | public event EventHandler GameFlowChanged; 36 | private readonly TaskCompletionSource _work = new TaskCompletionSource(false); 37 | 38 | public async Task EventExampleAsync() 39 | { 40 | // Initialize a connection to the league client. 41 | var api = await LeagueClientApi.ConnectAsync(); 42 | Console.WriteLine("Connected!"); 43 | 44 | // Register game flow event. 45 | GameFlowChanged += OnGameFlowChanged; 46 | api.EventHandler.Subscribe("/lol-gameflow/v1/gameflow-phase", GameFlowChanged); 47 | 48 | // Wait until work is complete. 49 | await _work.Task; 50 | Console.WriteLine("Done."); 51 | } 52 | 53 | private void OnGameFlowChanged(object sender, LeagueEvent e) 54 | { 55 | var result = e.Data.ToString(); 56 | var state = string.Empty; 57 | 58 | switch (result) 59 | { 60 | case "None": 61 | state = "main menu"; 62 | break; 63 | case "Lobby": 64 | state = "lobby"; 65 | break; 66 | case "ChampSelect": 67 | state = "champ select"; 68 | break; 69 | case "GameStart": 70 | state = "game started"; 71 | break; 72 | case "InProgress": 73 | state = "game"; 74 | break; 75 | case "WaitingForStats": 76 | state = "waiting for stats"; 77 | break; 78 | default: 79 | state = $"unknown state: {result}"; 80 | break; 81 | } 82 | 83 | // Print new state and set work to complete. 84 | Console.WriteLine($"Status update: Entered {state}."); 85 | _work.SetResult(true); 86 | } 87 | ``` 88 | 89 | ![Usage Event Run](https://i.imgur.com/mavltPs.gif) 90 | 91 | ## License 92 | 93 | Copyright (c) 2020 Bryan Hitchcock. All rights reserved. 94 | 95 | Licensed under the [MIT](./LICENSE.txt) license. 96 | --------------------------------------------------------------------------------