Skip to content

Qrutz/quitlol

Repository files navigation

QuitLoL - Nuclear League of Legends Blocker

A comprehensive, multi-layered blocking system for Windows and macOS that makes playing League of Legends extremely difficult.

Platform Support

  • Windows (PowerShell scripts)
  • macOS (Bash scripts)

What This Does

This blocker implements multiple layers of protection:

  1. Network Blocking: Blocks all League of Legends and Riot Games domains via hosts file
  2. Process Killer: A background service that continuously monitors and kills League processes
  3. File Permissions: Makes League installation directories non-executable (or removes execute permissions)
  4. Auto-Start: Guardian service runs on system boot
  5. Cleanup: Removes existing League installations
  6. Browser Content Blocking (optional): Hides League content on YouTube, Twitch, Reddit, Twitter, and other websites

Installation

WARNING: This will immediately block League of Legends. Make sure you're ready.

Windows

  1. Right-click on block_league.ps1
  2. Select "Run with PowerShell" (as Administrator)
  3. If you get an execution policy error, run this first in PowerShell (as Admin):
    Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

Alternatively, from an Administrator PowerShell:

.\block_league.ps1

macOS

chmod +x block_league.sh
sudo ./block_league.sh

You'll need to enter your admin password.

What Gets Blocked

  • All Riot Games domains (riotgames.com, riot.com, etc.)
  • All League of Legends domains (all regions: NA, EUW, EUNE, KR, etc.)
  • Update and patch servers
  • Authentication servers
  • API and support sites

40+ domains blocked in total

Blocked Processes

The guardian continuously kills these processes every 2 seconds:

Windows:

  • League.exe
  • LeagueClient.exe
  • RiotClientServices.exe
  • RiotClientUx.exe

macOS:

  • League
  • LeagueClient
  • RiotClient
  • Riot Client
  • LeagueOfLegends

How Hard Is It To Reverse?

Moderately difficult - requires technical knowledge but not impossible:

  • Windows: Need to use Task Scheduler, edit hosts file, understand system services
  • macOS: Need to use Terminal, sudo commands, understand LaunchDaemons

This creates enough friction to make you think twice, but won't brick your system.

Uninstallation

If you really want to undo this (think carefully):

Windows

Right-click on uninstall_block.ps1 and select "Run with PowerShell" (as Administrator)

Or manually:

  1. Open Task Scheduler
  2. Delete the task named QuitLoL_Guardian
  3. Open Notepad as Administrator
  4. Open C:\Windows\System32\drivers\etc\hosts
  5. Delete the section between # QUITLOL_BLOCK_START and # QUITLOL_BLOCK_END
  6. Save the file

macOS

chmod +x uninstall_block.sh
sudo ./uninstall_block.sh

Or manually:

# Stop the daemon
sudo launchctl unload /Library/LaunchDaemons/com.quitlol.guardian.plist

# Remove daemon files
sudo rm /Library/LaunchDaemons/com.quitlol.guardian.plist
sudo rm /usr/local/bin/quitlol_guardian.sh

# Edit hosts file and remove QUITLOL_BLOCK section
sudo nano /etc/hosts

Files Created

Windows

  • C:\Windows\System32\drivers\etc\hosts - Modified with domain blocks
  • C:\ProgramData\QuitLoL\guardian.ps1 - Process killer script
  • Task Scheduler: QuitLoL_Guardian - Scheduled task
  • C:\ProgramData\QuitLoL\hosts.backup.* - Backup files

macOS

  • /etc/hosts - Modified with domain blocks
  • /Library/LaunchDaemons/com.quitlol.guardian.plist - Daemon config
  • /usr/local/bin/quitlol_guardian.sh - Process killer script
  • /var/quitlol_backup/ - Backup directory

Browser Content Blocking

Want to block League content on YouTube, Twitch, Reddit, and other sites? We've got you covered with two options:

Option 1: Browser Extension (Recommended)

A dedicated browser extension that actively hides League content across the web.

Features:

  • Blocks League videos on YouTube
  • Hides Twitch streams playing League
  • Filters Reddit posts from r/leagueoflegends
  • Removes League tweets on Twitter/X
  • Redirects direct visits to League sites
  • Works on Chrome, Edge, Brave, and Firefox

Installation: See browser-extension/README.md for detailed instructions.

Quick start:

  1. Open Chrome and go to chrome://extensions/
  2. Enable "Developer mode"
  3. Click "Load unpacked" and select the browser-extension folder
  4. Done!

Option 2: uBlock Origin Filters (Simpler)

If you already use uBlock Origin ad blocker, you can import our filter list.

Installation:

  1. Install uBlock Origin
  2. Open uBlock Origin dashboard (click icon → settings gear)
  3. Go to "Filter lists" tab
  4. Scroll to bottom, click "Import"
  5. Paste the raw GitHub URL of ublock-filters.txt or paste the file contents
  6. Click "Apply changes"

The filter list blocks 40+ League/Riot sites and hides League content on YouTube, Twitch, Reddit, and Twitter.

File: ublock-filters.txt

Which Should You Use?

Feature Browser Extension uBlock Filters
Ease of use Medium Easy
Effectiveness High Medium
Performance impact Low-Medium Very Low
Customization High Medium
Works on mobile No No

Recommendation: Use both for maximum protection! The extension catches dynamic content that filters might miss.

Philosophy

This tool is for people who genuinely want to quit League of Legends but struggle with impulse control. It creates enough friction to give you time to reconsider, without being truly irreversible.

If you're trying to disable this blocker, ask yourself: Why did you install it?

Technical Details

Windows Implementation

  • Uses PowerShell scripts with execution policy bypass
  • Creates a Windows Scheduled Task that runs at startup with SYSTEM privileges
  • Modifies ACLs to deny execute permissions on League executables
  • Runs continuously in the background with auto-restart on failure

macOS Implementation

  • Uses Bash scripts with root privileges
  • Creates a LaunchDaemon that runs at boot
  • Uses chmod to remove execute permissions
  • Runs as a persistent background process

Troubleshooting

Windows

"Cannot be loaded because running scripts is disabled":

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

"Access Denied": Right-click PowerShell and select "Run as Administrator"

Task not running: Open Task Scheduler and check the QuitLoL_Guardian task status

macOS

"Permission denied" errors: Run with sudo

Daemon not starting: Check /tmp/quitlol_guardian.err for errors

Already installed League after blocking: The daemon will continuously kill it and make the app non-executable

Contributing

Feel free to submit issues or pull requests if you want to improve the blocker or add support for other platforms (Linux?).

Star This Repo

If this helped you quit League, give it a star! Help others break free.

Good Luck

You've made the right choice. Stay strong.

Remember: The game is designed to be addictive. Breaking free takes courage.