Installation & Setup

Installation & Setup

Requirements

• Blender 5.0 or 5.1 (Windows)
• League of Legends installation (for Riot-base and WAD workflows)
• ~200 MB disk space for WAD hash files (downloaded on first use)

Pillow is not required in current versions.

---

Install the Addon

1. Download the latest release ZIP from GitHub Releases.
2. In Blender: Edit → Preferences → Add-ons.
3. Click Install and select the downloaded ZIP.
4. Enable "Rey's Mapgeo Blender Addon" in the list.
5. Open the 3D Viewport sidebar (N key) — two new tabs appear:
   • LoL Mapgeo — core map tools
   • League Tools — project manager, editors, importers

---

First-Time Configuration

1. Set League Install Path

1. Open League Tools → Project Manager.
2. Click Detect League Install or manually set the path (e.g. C:\Riot Games\League of Legends).
3. The addon uses this to locate the game's WAD archives for asset extraction.

2. Set Project Folder

Your project folder is where map files live. Typical structure:

MyProject/
├── data/
│   └── maps/
│       └── mapgeometry/
│           └── map11/
│               ├── sodapop_srs.mapgeo
│               └── sodapop_srs.materials.bin
└── levels/
    └── map11/
        └── map11.bin

1. In Project Manager, set the Project Path to your project root.
2. Click Scan Project — the addon detects map variants automatically.

3. Download WAD Hashes (Optional but Recommended)

WAD hash files allow the addon to resolve WAD archive entry paths.

1. Open League Tools → WAD Archive Tool.
2. Click Download WAD Hashes.
3. Wait for download (~180 MB total).

Hash files are stored in the addon's hashes/ directory and are automatically shared across Blender versions.

---

Sidebar Layout

LoL Mapgeo Tab

Panel	Purpose
Mapgeo Tools	Quick actions, version info, scene summary
Layer Management	Dragon/Baron visibility filters, bucket grid controls
Import Map	Mapgeo file picker, import options
Export Settings	Format version, export options
Mesh Properties	Per-object property viewer/editor
Utilities	Bush import, render region import, external mesh import
Lighting & Baking	Lightgrid and lightmap tools

League Tools Tab

Panel	Purpose
Project Manager	Project setup, variant scanning, load/export
Material Editor	Full material editing with samplers, params, switches
SCO/SCB Mesh Tools	Static mesh import/export
SKN/SKL Skinned Mesh	Character mesh import
WAD Archive Tool	WAD extraction, hash management
Map Porter	Material porting between map slots
Map Patcher	Binary diff creation and application
Map11 Editor	Map11.bin MapSkin field editing
Light Manager	Custom point light management
Character Bin Updater	Batch character.bin updates
Project Integrity	Validation and issue detection
PropertyBin Editor	Generic .bin file editor
CFGBin Editor	Config binary editor
Troybin Particle Editor	.troybin particle system editor
Legacy Map	Legacy format import (.nvr, .dat)

---

Auto Updater

The addon checks GitHub for new releases on startup.

• Disable: LoL Mapgeo panel → Addon Updates → uncheck "Auto Check on Startup"
• Manual check: Click "Check for Updates"
• When an update is found, a download link is shown in the panel.

---

Upgrading

1. Download the new release ZIP.
2. In Blender: Edit → Preferences → Add-ons.
3. Remove the old addon, then install the new ZIP.
4. Or simply overwrite the addon folder and restart Blender.

WAD hash files and cached data persist in %APPDATA%\Blender Foundation\Blender\<version>\mapgeo_addon\ and are not lost during upgrades.