https://github.com/crauzer/lol2gltf

Convert between League of Legends mesh formats and the glTF runtime format
https://github.com/crauzer/lol2gltf

gltf leagueoflegends

Last synced: 6 months ago
JSON representation

Convert between League of Legends mesh formats and the glTF runtime format

Host: GitHub
URL: https://github.com/crauzer/lol2gltf
Owner: Crauzer
License: gpl-3.0
Created: 2020-09-01T17:02:41.000Z (about 5 years ago)
Default Branch: main
Last Pushed: 2025-02-28T21:54:50.000Z (8 months ago)
Last Synced: 2025-03-28T16:42:56.391Z (7 months ago)
Topics: gltf, leagueoflegends
Language: C#
Homepage:
Size: 8.81 MB
Stars: 141
Watchers: 8
Forks: 21
Open Issues: 14
Metadata Files:
- Readme: README.md
- License: LICENSE

Awesome Lists containing this project

README

lol2gltf

A powerful tool for converting between the glTF format and League of Legends models and animations

## 📋 Overview

lol2gltf is a command-line utility that enables seamless conversion between League of Legends' proprietary 3D formats and the industry-standard glTF format. This tool is essential for game modders, artists, and developers working with League of Legends assets.

## ✨ Features

- **Skinned Mesh Conversion**: Convert League's SKN/SKL/ANM files to glTF and back
- **Map Geometry Conversion**: Transform League's map geometry files to glTF
- **Static Mesh Conversion**: Convert glTF to League's static mesh formats (SCB/SCO)
- **Animation Support**: Include League animations in your glTF exports
- **Texture Integration**: Bundle textures with your models

## 🚀 Getting Started

### Installation

1. Download the latest release from the [Releases page](https://github.com/Crauzer/lol2gltf/releases)
2. Extract the ZIP file to a location of your choice
3. Run the tool from the command line as described below

## 📖 Command Reference

lol2gltf offers several conversion modes, each with its own set of parameters:

### Converting Skinned Mesh to glTF (`skn2gltf`)

Converts League's skinned mesh files (SKN, SKL, ANM) into a glTF asset.

```
lol2gltf skn2gltf -m -s -g [-a ] [--materials ] [--textures ]
```

**Required Parameters:**
- `-m, --skn`: Path to the Simple Skin (.skn) file
- `-s, --skl`: Path to the Skeleton (.skl) file
- `-g, --gltf`: Path for the output glTF file (use .glb extension for binary format)

**Optional Parameters:**
- `-a, --anm`: Path to a folder containing Animation (.anm) files
- `--materials`: Material names for textures (must match the count of texture paths)
- `--textures`: Paths to texture files (must match the count of material names)

**Example:**
```
lol2gltf skn2gltf -m Aatrox.skn -s Aatrox.skl -g Aatrox.glb -a animations/
```

### Converting glTF to Skinned Mesh (`gltf2skn`)

Converts a glTF asset into League's skinned mesh formats (SKN, SKL).

```
lol2gltf gltf2skn -g -m [-s ]
```

**Required Parameters:**
- `-g, --gltf`: Path to the glTF asset (.glb or .gltf)
- `-m, --skn`: Path for the output Simple Skin (.skn) file

**Optional Parameters:**
- `-s, --skl`: Path for the output Skeleton (.skl) file (if not specified, will use the same name as the SKN file)

**Example:**
```
lol2gltf gltf2skn -g Aatrox.glb -m Aatrox.skn
```

### Converting Map Geometry to glTF (`mapgeo2gltf`)

Converts League's map geometry files into a glTF asset.

```
lol2gltf mapgeo2gltf -m -b -g [-d ] [-x ] [-l ] [-q ]
```

**Required Parameters:**
- `-m, --mgeo`: Path to the Map Geometry (.mapgeo) file
- `-b, --matbin`: Path to the Materials Bin (.materials.bin) file
- `-g, --gltf`: Path for the output glTF file (use .glb extension for binary format)

**Optional Parameters:**
- `-d, --gamedata`: Path to the Game Data directory (required for bundling textures)
- In order to correctly bundle all textures into the glTF file, you should make sure to export all relevant `.wad.client` files into this folder (MapXX.wad.client, some maps require the DATA wads as well).
- `-x, --flipX`: Whether to flip the map node's X axis (default: true)
- `-l, --layerGroupingPolicy`: Layer grouping policy for meshes (Default, Ignore)
- `-q, --textureQuality`: Quality of textures to bundle (Low = 4x, Medium = 2x)

### Converting glTF to Static Mesh (`gltf2static`)

Converts a glTF asset into League's static mesh formats (SCB/SCO).

```
lol2gltf gltf2static -i -o
```

**Required Parameters:**
- `-i, --input`: Path to the input glTF file
- `-o, --output`: Path to the output SCB/SCO file (extension determines format)

**Example:**
```
lol2gltf gltf2static -i prop_rock.glb -o prop_rock.scb
```

## 📚 Additional Resources

- [Video Tutorial (Outdated)](https://www.youtube.com/watch?v=XxSGk6SAcAM): Comprehensive guide to using lol2gltf

## 🖼️ Gallery