Awesome League

A curated list of tools, libraries, and resources for working with League of Legends files, assets, and mods

Table of Contents

• File Format Index
• Mod Managers
• Modding
• WAD Archives
• Bin & Property Files
• Textures & Images
• 3D Models & Animation
• VFX & Materials
• Audio
• Hashtables
• Game Manifests
• Misc
• Libraries
• Documentation

File Format Index

Not sure where to look? Find your file format here:

Format	What it is	Where to look
.wad, .wad.client	Game asset archives	WAD Archives
.bin	Object/property data (characters, skins, VFX, ...)	Bin & Property Files
.tex, .dds	Textures	Textures & Images
.skn, .skl, .anm, .scb, .sco	Meshes, skeletons, animations	3D Models & Animation
.bnk, .wpk	Audio soundbanks	Audio
Shader bytecode	Compiled shaders	Misc
.fantome, .modpkg	Mod packages	Modding
Hashes, .hashdb	Hash → path tables for resolving file names	Hashtables
Manifests	Game file download data	Game Manifests

Mod Managers

Trusted mod managers for installing and running mods.

• LTK Manager GUI - The official LeagueToolkit mod manager, succeeding the original cslol-manager
• cslol-go GUI - Mod manager bundled with the Topaz mod fixer

Modding

Creating, fixing, and distributing mods.

• Flint GUI - Modding IDE for extracting, previewing, editing, and exporting League assets
• Hematite CLI - Automatically detects and fixes common issues in custom League skins
• league-mod CLI - Toolkit for creating, managing, and distributing League of Legends mods
• League-Mod-Repather GUI - Automatically repaths .fantome files and mod folders; also fixes issues like square particles and game crashes
• LtMAO GUI - Collection of various tools and utilities to help modders
• TopazModFixerCLI CLI - Standalone CLI for the Topaz mod fixer (C#), used in Cslol-go and available for automation and integration into other tools

WAD Archives

Exploring, extracting, and building .wad game archives.

• hexbelt Web - Web app for exploring/interacting with .wad & .bin files
• Obsidian GUI - Tool for exploring and extracting WAD files with a modern UI
• wadtools CLI - High-performance tool for extracting and working with WAD files; includes modern automatic hash management, file diffing and scanning

Bin & Property Files

Converting and editing .bin property files and their legacy predecessors.

• hexbelt Web - Web app for exploring/interacting with .wad & .bin files
• lolpytools CLI - Python scripts for converting inibin, troybin, luaobj and luabin files
• ritobin CLI - Converts League's .bin format to a human-readable version (.ritobin)
• ritobin-tools CLI - CLI tool for working with Ritobin (.py/.bin) files
• ritobin-lsp LSP - The official LSP server/VSCode extension for the .ritobin language format; includes formatting, auto-complete and linting of structs using an integration with the LTK meta wiki database

Textures & Images

Converting and editing .tex and .dds texture files.

• ltk-tex-utils CLI - Robust converter for .tex files; convert back and forth between common image formats
• Ritoddstex CLI - Simple converter for dds<->tex files

Image Editor Plugins

• Gimp-Tex-Plugin Plugin - Open and save League of Legends .tex files in GIMP
• ltk-tex-thumb-handler Plugin - Show .tex texture previews in Windows Explorer
• Paint.NET-Tex-Plugin Plugin - Import and save .tex files in Paint.NET, with Windows Explorer previews
• RitoTex-Photoshop Plugin - Load and save .tex texture files in Photoshop

3D Models & Animation

Importing, exporting, and converting meshes, skeletons, and animations.

• Aventurine-League-Tools Plugin - Blender plugin for League of Legends asset import/export
• lemon3d Plugin - Modern and maintained iteration of the Autodesk Maya plugin, bundled with the LtMAO app
• lol2gltf CLI - Convert 3D assets from League into the glTF format (partial support for converting glTF to League formats as well)

VFX & Materials

Editing particles, materials, and recoloring effects.

• Chroma-Tool-Studio GUI - Edit .dds files using full color instead of pixels and recolor VFX in one click by tracking relevant values in code
• Quartz GUI - All-in-one VFX & material editor

Audio

Extracting and building .bnk/.wpk soundbanks.

• bnk_gui GUI - Audio soundbank editor
• Wwise GUI - Audiokinetic's audio middleware, used to make custom soundbanks
• Wwiser CLI - Analyze _events.bnk files

Hashtables

Hash → path tables for resolving the game's hashed file and field names.

• League Hashes by CDragon - Actively maintained collection of hashes used by League
• mimir CLI - Toolkit for generating, storing, and serving League hash → path tables as a compact, memory-mapped binary format (.hashdb)

Game Manifests

Manifests for downloading game files from Riot's CDN.

• ManifestDownloaderGUI GUI - Download Riot manifest files
• riot-manifests - List of manifest files for Riot Games products, including League

Misc

• shader-tools CLI - CLI tool for extracting shader bytecode

Libraries

For developers building their own tools.

• cdragon-rs Rust - CDragon Rust library collection
• league-toolkit Rust - Rust implementation of League Toolkit
• LeagueToolkit C# - Parse, edit and convert various League of Legends file formats
• pyritofile Python - Python package to deal with League of Legends files

Documentation

• LTK Wiki - The official LeagueToolkit wiki - the main hub for League modding knowledge and documentation of the LeagueToolkit ecosystem, created by people who've been here since the beginning of modding
• lol-meta-classes - Tracks League's .bin meta class metadata across updates - all existing and past classes/properties in the game, including their default values, in a custom database
• lol-meta-wiki - Wiki for documenting League of Legends Meta .bin classes and properties