Skip to main content
Resolve common problems with cslol-manager, from installation issues to runtime errors.

​
Before You Start

When troubleshooting, always:
1

Check the Log File

The log.txt file (next to cslol-manager.exe) contains detailed error information.Look for:
  • Error messages
  • Stack traces
  • Status updates before the failure
2

Run Diagnostics

Use the built-in diagnostic tool:
  • Click the Diagnostics button
  • Or run cslol-diag.exe directly
This checks system compatibility and configuration.
3

Check Known Issues

Visit the GitHub Issues for known workarounds.

​
Installation Issues

​
”Unsupported platform” Error

Symptom: Error message on startup about unsupported machine configuration. Cause: Running on an incompatible operating system or architecture. Solution:
Verify you’re running:
  • Windows 10 or Windows 11 (64-bit)
  • Not Windows on ARM (unless using emulation)
macOS support is experimental and may have limitations.
Ensure Windows is fully updated:
  1. Open Windows Update
  2. Install all available updates
  3. Restart and try again

​
Missing mod-tools.exe

Symptom: “cslol-tools/mod-tools.exe is missing” error. Cause: Incomplete installation or anti-virus quarantine. Solution:
1

Check Anti-Virus

Your anti-virus may have quarantined the file:
  1. Open your anti-virus software
  2. Check quarantine/blocked files
  3. Restore mod-tools.exe
  4. Add exception for cslol-manager folder
2

Reinstall

Download a fresh copy:
  1. Download the latest release
  2. Extract to a new folder
  3. Don’t overwrite the old installation
3

Verify Files

Check that these files exist:
  • cslol-manager.exe
  • cslol-tools/mod-tools.exe
  • cslol-tools/cslol-diag.exe (Windows only)

​
Can’t Acquire Lock

Symptom: “Can not run multiple instances” error. Cause: Another instance is running, or lockfile wasn’t cleaned up. Solution:
  1. Check Task Manager for cslol-manager.exe
  2. End all instances
  3. Restart the application

​
Profile and Mod Issues

​
Mod Installation Failed

Symptom: “Already exists” error when installing. Cause: A mod with the same name is already installed. Solution:
1

Check Installed Mods

Look in the mod list for a mod with the same name.
2

Choose Action

Options:
  • Delete old mod: Remove the existing mod first
  • Rename new mod: Rename the file before installing
  • Skip: Don’t install if it’s truly a duplicate

​
Profile Won’t Build

Symptom: Overlay build fails with conflict errors. Cause: Multiple mods modify the same game files. Solution:
Check the error message for conflicting file names:
Error: Conflict in data/characters/ahri/skins/base/ahri.dds
Mods: "Skin A" and "Skin B"
Disable one of the conflicting mods:
  1. Uncheck one mod in the profile
  2. Save the profile
  3. Try building again
Force the build to continue:
  1. Check Skip Conflict Check option
  2. Save and run
Later mods in the list will override earlier ones. This may produce unexpected results.

​
Profile Won’t Run

Symptom: Patcher fails to start after building overlay. Cause: Missing files, permissions, or anti-virus blocking. Solution:
1

Check for Admin Prompt

If you see “Run as administrator” in the error:
  1. A file named admin_allowed.txt was created
  2. Restart cslol-manager
  3. It will request administrator privileges
  4. Allow the elevation
2

Verify Game Path

Ensure the League path is correct:
  • Should point to folder containing League of Legends.exe
  • On Windows: Usually C:\Riot Games\League of Legends\Game
  • On macOS: Usually /Applications/League of Legends.app/Contents/LoL/Game
3

Check Anti-Virus

Add exceptions for:
  • cslol-manager.exe
  • cslol-tools/mod-tools.exe
  • The entire cslol-manager folder

​
Runtime Issues

​
Mods Not Appearing In-Game

Symptom: Profile runs successfully but changes don’t appear in League. Cause: Timing, game mode mismatch, or injection failure. Solution:
Start patcher before game:
  1. Run the profile in cslol-manager
  2. Wait for “Status: Running” or “Status: Idle”
  3. Then launch League of Legends
The patcher must be running before you start the game.

​
Crashes or Freezes

Symptom: cslol-manager or League crashes/freezes. Cause: Corrupted mod files, bad game state, or compatibility issues. Solution:
Test if mods are causing the issue:
  1. Create an empty profile
  2. Run it
  3. Launch League
If it works, add mods back one at a time to identify the problem.
Fix game files:
  1. Open League client
  2. Click settings (gear icon)
  3. Initiate repair
  4. Wait for completion
  5. Try mods again
Ensure compatibility:
  • Update cslol-manager to latest version
  • Update League to latest patch
  • Rebuild all profiles after updates

​
Performance Issues

Symptom: Game lags or stutters with mods enabled. Cause: Too many mods, large texture files, or resource conflicts. Solution:
1

Reduce Mod Count

Fewer mods = better performance:
  1. Disable unused mods
  2. Only enable essentials
  3. Test performance after each change
2

Enable TFT Blacklist

If you don’t play TFT:
  1. Open settings
  2. Enable TFT Blacklist
  3. Rebuild profiles
This reduces overlay size significantly.
3

Optimize Mods

Ensure mods are optimized:
  • All mods should be rebased against game files
  • Use --removeUNK to strip unused entries
  • Avoid including unmodified files

​
File and Permission Issues

​
”Access Denied” Errors

Symptom: Can’t write files, can’t create mods, or operations fail with permission errors. Solution:
Grant elevated privileges:
  1. Right-click cslol-manager.exe
  2. Select “Run as administrator”
  3. Allow the UAC prompt
Ensure you have write access:
  1. Right-click the cslol-manager folder
  2. Properties → Security tab
  3. Ensure your user has “Full control”
Avoid protected folders:
  • Don’t install in Program Files
  • Don’t install in system directories
  • Use C:\cslol-manager or Documents

​
Files Not Saving

Symptom: Changes to mod info or profiles don’t persist. Cause: Insufficient permissions or file locks. Solution:
1

Close Other Programs

Ensure no other programs are accessing the files:
  • Close text editors
  • Close file explorers in that directory
  • Check for anti-virus scans
2

Check Disk Space

Verify you have enough free space:
  • Mod operations can require temporary storage
  • Aim for at least 10GB free
3

Restart cslol-manager

Sometimes a restart clears file locks:
  1. Stop any running profiles
  2. Close cslol-manager completely
  3. Restart and try again

​
League of Legends Integration

​
Game Path Not Found

Symptom: Can’t detect or set League installation path. Solution:
1

Manual Path Selection

Set the path manually:
  1. Click Settings or Game Path
  2. Browse to your League installation
  3. Select the folder containing League of Legends.exe
2

Verify Path Format

Correct paths:
  • ✅ C:\Riot Games\League of Legends\Game
  • ✅ /Applications/League of Legends.app/Contents/LoL/Game
  • ❌ C:\Riot Games\League of Legends (too high)
  • ❌ C:\Riot Games\League of Legends\Game\League of Legends.exe (file, not folder)
3

Reinstall League

If the path is corrupted:
  1. Uninstall League of Legends
  2. Reinstall to default location
  3. Set path in cslol-manager

​
Patcher Won’t Detect Game

Symptom: Patcher runs but doesn’t inject into League. Cause: Game not running, wrong process, or anti-cheat blocking. Solution:
Correct sequence:
  1. Start cslol-manager
  2. Run your profile (wait for “Running” status)
  3. Launch League of Legends
  4. Enter a game (loading screen or in-game)
The patcher hooks when you enter a match.

​
Server and Region Issues

​
Asian Servers / Garena

Symptom: Mods don’t work on Garena or Asian region servers. Cause: These servers use different clients with modified structures. Solution:
Officially Unsupportedcslol-manager officially supports only Riot-operated servers (NA, EUW, EUN, etc.).Asian servers and Garena are not officially supported and may experience issues.
Possible workarounds:
  • Check community forums for region-specific patches
  • Use alternative tools designed for your region
  • Contact server-specific modding communities

​
Advanced Troubleshooting

​
Enable Debug Mode

For detailed logging:
1

Enable Debug Patcher

When running a profile:
  1. Check the Debug Patcher option
  2. Save and run
  3. Check log.txt for verbose output
2

Review Detailed Logs

Look for:
  • [DLL] messages about injection
  • Stack traces for errors
  • Status updates from mod-tools

​
Manual Diagnostics

Run diagnostics manually: 
# Windows
cslol-diag.exe e

# Generates diagnostic report
This checks:
  • System compatibility
  • File permissions
  • Required dependencies
  • Known configuration issues

​
Clean Reinstall

For persistent issues, do a clean reinstall:
1

Backup Important Files

Save:
  • profiles/ directory (your profiles)
  • installed/ directory (your mods)
  • Any custom configuration
2

Complete Uninstall

  1. Stop all running profiles
  2. Close cslol-manager
  3. Delete the entire cslol-manager folder
3

Fresh Install

  1. Download the latest release
  2. Extract to a new location
  3. Configure game path
4

Restore Data

Copy back:
  • profiles/ directory
  • installed/ directory
  1. Refresh the mod list

​
Getting Help

If you’re still experiencing issues:

GitHub Issues

Search existing issues or create a new bug report

Known Workarounds

Check the issue tracker for documented solutions

​
Creating a Bug Report

When reporting issues, include:
  1. log.txt file - Located next to cslol-manager.exe
  2. Steps to reproduce - Exact sequence that causes the issue
  3. Expected vs actual behavior - What should happen vs what does happen
  4. System information:
    • Windows version
    • League of Legends version
    • cslol-manager version
  5. Screenshots - If applicable
Before reporting: Check if your issue is already listed in the known issues. Many common problems have documented workarounds.

​
Preventive Measures

Avoid future issues:
Back up regularly:
  • Export important mods
  • Save profile configurations
  • Keep log.txt from successful runs
Stay current:
  • Update cslol-manager when new versions release
  • Keep League of Legends updated
  • Rebuild profiles after major patches
Good mod hygiene:
  • Always rebase mods against game files
  • Remove unused or broken mods
  • Test mods before adding to main profile
Prevent storage issues:
  • Keep at least 10GB free
  • Clean temporary files periodically
  • Remove old profile builds

Build docs developers (and LLMs) love

Get started for freeTalk to us