LeagueConvert

Effortlessly convert League of Legends models to glTF, with textures and animations.

Status and roadmap

This version was built from scratch to replace the GUI version (LeagueBulkConvert) and is still in development. Currently this version is command-line only. The builds from GitHub Actions probably work just fine, but there are still a few things that have to be done before a release is created. I highly recommend not using the release builds anymore because they have many issues that have all been fixed in this version.

Comparison to old version

	Old	New
Aatrox conversion time	16 s	10 s
Aatrox conversion time (skeleton)	16 s	10 s
Aatrox conversion time (animations)	122 s	24 s
(More) correct animations	❌	✔️
Cross platform	❌	✔️
No temporary files	❌	✔️
Smart update check	❌	✔️
Support for newer models with tangents	❌	✔️
Valid glTF	❌	✔️

SimpleGltf

SimpleGltf is a custom library that was written to replace SharpGltf. This library probably won't be released as a standalone library.

Planned:

• Optimisation/cleanup
• Reading glTF

LeagueToolkit

This is a modified version of LoL-Fantome/LeagueToolkit. and will probably be moved to a separate repository in the future.

LeagueConvert

LeagueConvert is a custom library that searches for game models, textures and animations.

Planned:

• Rewrite hash table loading code
• Support for map geometry
• Support for textures other than diffuse
• Move code from LeagueConvert.CommandLine to LeagueConvert
• Optimisation/clean-up

LeagueConvert.CommandLine

LeagueConvert.CommandLine is the command-line interface for LeagueConvert.

Planned:

• Clean-up

LeagueConvert.MAUI

A multiplatform user interface for LeagueConvert. Postponed for now.

Installation instructions

1. Download the .NET 6.0 Runtime
2. Download the latest build (generic is cross-platform) here
3. Extract the archive
4. Run the executable or dotnet LeagueConvert.CommandLine.dll

Set-up instructions for developing

1. Clone or download the source code.
2. Install the .NET 6.0 SDK. (Recommended: Visual Studio 2022 with the '.NET desktop development' workload and the 'Development tools for .NET' component.)
3. Install Rider, a better C# IDE (optional).
4. Open the .sln.