Chud
Join the Discord Download
Docs · Players & mod makers

Everything Chud does, documented.

Setup, picking skins in champ select, Announcer packs, ModScan, party sync, every setting and file path — with guidance for existing skin and announcer packs. Updated for Chud 5.3.66.

GETTING STARTED

Install & first run

Current release: 5.3.66. Windows 10/11 x64 · 17.9 MB installer. The app requests administrator rights on launch.

01

Download & run the installer

Chud-Setup.exe installs for your user only — Chud requests administrator rights when it launches.

02

Launch Chud, start League

Chud finds the running League client by itself and connects over the local League client API. Nothing to configure.

03

Arm what you want

Auto-Accept and Auto-Range have controls in Settings. Skins, Library, Party, Builds, and ModScan have their own pages; additional tools are available from the app menu.

Closing the main window doesn't quit Chud — it minimizes to the system tray so Auto-Accept keeps working while you play. Left-click the tray icon (or its "Show Dashboard" menu item) to bring the window back; use the tray's "Exit" or the in-app Exit button to actually quit.

Enable or stop tools from Home and adjust their detailed controls in Settings.

Skin setup

Skins are applied through League Toolkit's patcher (ltk_patcher_host.exe and ltk_patcher_dll.dll, explained here). Chud can't bundle it, so since 5.3.13 it downloads the signed original on first run and re-checks once a day:

Nothing to drop in by hand

The Skins tab shows a notice with a Re-check button only while the download is pending or has failed. If it stays, check your connection, or install LTK Manager (free) and Chud picks the patcher up from there. A copy you place in %LOCALAPPDATA%\Chud\cslol-tools\ yourself is also used.

  • Only a genuinely signed patcher is accepted; a download that fails that check is discarded and the installed copy is kept.
  • First skin setup also downloads the game-hash table (hashes.game.txt, ~200 MB) that the WAD tools need. It refreshes itself when League patches — you'll see a "League updated" toast when that happens.

Staying updated

Chud checks the download mirror first, then GitHub, for signed updates. Review the version and notes before choosing Update & restart. If a request stalls, a deadline lets fallback and future checks continue. If updating fails, retry or install from the download mirror.

Already using an older Chud? If your build checks only GitHub and no update appears, install the current build from the download mirror once. Current builds check the mirror first, then GitHub. Anonymous GitHub release links are currently unavailable; this mirror is the working download channel.

USING CHUD

The main window

Home, Skins, Library, Party, Builds, ModScan, Activity and Settings provide the main navigation. Profile and additional tools are available from the app controls. Voicepack and skin creation tools have been removed; existing packs remain supported.

Picking skins in champ select

Pick skins right in League's own skin carousel: scroll to one and Chud applies it. Chud confirms each pick and tries again if the client was busy, so a pick sticks. Skins you don't own show as unlocked, and your custom skins and chromas appear there too. The first three times, a short hint reads "Locked skins work too. Click any skin to use it." Chud's panel still provides Build, Timers, Augments, Skills, Maps, Announcer, Fonts, Other and Party tabs; its Skins tab steps aside while the carousel does the work and comes back on its own if a League patch changes the carousel. Skin selection requires a locked champion; the main Skins page also supports local catalog browsing. The short version, with what you will see on screen, is in how to unlock all skins in champ select.

Skins, chromas & forms

  • Any skin for your champion, owned or not. Scroll League's own skin carousel to any skin, locked ones included, and Chud applies it; scroll back to one you own and the client's own pick is used. The strip above the skin name says "Applying…" the moment you move to a locked skin, then names it, for example "Star Guardian Jinx", once it is set. The carousel stays on the skin you chose while you browse. If a League patch ever changes the carousel, the Skins tab in Chud's panel returns with the full grid. Skins that haven't been downloaded yet appear dimmed with a "not downloaded" note.
  • Chromas — the strip above the skin name in the carousel shows swatches for the chromas of the skin you're on; a swatch lights up the moment you click it, and the strip names the skin and the chroma. Locked chromas can also be picked from League's own chroma popup, opened from the chroma icon on the carousel tile: click a locked chroma and Chud applies it, the popup's ring moves to it and the strip names it. Tiles with a ◈ badge in Chud's panel open a chroma row with live colour previews; pick one or the base look.
  • Forms — special variants (Elementalist Lux, Sahn-Uzal Mordekaiser, Radiant Sett, K/DA Seraphine, Viego and friends) show in the carousel's strip and as a ◆ row above the chromas in Chud's panel, picked exactly like chromas. Re-tap the active form to go back to base.
  • Your custom mods appear right in the carousel: tiles that have custom skins carry a badge such as "✦ 2 custom" (how many are installed for that skin), and a row of them rises above the skin name when you land on one; the first tile in that row is "No custom". They also appear as pills under the grid in Chud's panel with real preview images on hover (how to add them).
  • Owned or downloaded picks live-preview on the champ-select 3D model. Clicking your current pick again clears it, and the footer's "Clear pick" falls back to your favorite or the base skin.

Favorites, random & historic

FeatureHow it works
⭐ FavoritesStar a skin on its tile in Chud's panel (or from the Skins tab's Favorites picker) and it's auto-applied every game you play that champion — set and forget, no overlay needed. A manual pick in a given game still wins for that game.
🎲 Random rollThe dice button, or Random in the carousel's strip, rolls a random skin (and chroma) from what you can actually inject — owned or downloaded — never the base skin. Roll again or hit Cancel to go back. In the carousel, Random moves League's own carousel to the skin it rolled, and the strip puts the word Rolled before the skin's name.
⟲ HistoricToggle the ⟲ pill (or the Remember switch in the carousel's strip) and Chud remembers your last pick per champion and re-applies it automatically every future lock-in — custom mods included. A banner shows "Historic restored your last pick" with an Undo button; picking manually overrides it for that game only.

Maps, announcers, fonts & more

The Maps, Announcer, and Fonts tabs are single-pick lists (with search, and "None — Riot default" always on top). The Other tab is a stacking multi-select for everything else: UI, VFX, SFX, voiceover, loading screens, and misc mods — tag as many as you like, "Clear all" resets.

These are set-once, they stick: your choices persist across app restarts and are re-applied every game until you change them.

Skin Library

The Library tab is an in-app browser for thousands of community skins, maps, announcers, and fonts. Search by champion, one-click install, and everything you install shows up in the right place — custom champion skins in League's own skin carousel in champ select, announcers in the Announcer tab, and so on. ★ Bundles install a curated top-skin pack for a champion in one go.

ModScan checks archives before Library installation; it is a heuristic check — see ModScan. Skin files themselves are hosted by RuneForge; Chud hosts the index and thumbnails.

Existing announcer packs

Install existing announcer packs from the Library or manage your existing local packs. Select an installed pack from the Announcer controls. Chud no longer includes voicepack or skin creation tools. Playback and selection of compatible existing packs remain supported.

ModScan

ModScan inspects archive structure and contents before Library installation, with optional hash-only reputation checks. Installed and local mods can also be scanned on demand. These are heuristic checks, not a guarantee that every file is safe.

Review the scan result and any reported archive problems before installing a mod. A clean result does not establish game-patch compatibility.

Auto-Accept & Auto-Range

Auto-Accept watches for ready checks through the local League client API. Auto-Range holds the configured attack-range key while the game is active, with input ownership and game-state checks. How the check works, and how to turn it on and off, is on the League auto accept page.

Use the controls in Home and Settings to enable the features you want. Chud requests administrator rights on launch. There is no ranked-mode lockout. Availability still depends on the current game/client and required files.

Lobby page

New in 5.3.62: the Lobby page shows who you are playing with. In champion select it lists your teammates; in a live game it lists all ten players. Each card shows the player's level, solo rank with LP, their last ten games as win or loss dots with the champion played, top champions, and win and loss streaks. An op.gg button on each card opens that player's page in your browser.

Names Riot hides stay hidden. All the data comes from the League client on your own PC, and nothing is uploaded.

Ranks in game

New in 5.3.63: Chud can show each player's solo rank during the match. Both places read the ranks the Lobby page already looked up from your own client, and nothing is uploaded.

Loading screen. Each player's champion name on the loading screen carries their solo rank, for example Ahri · Gold II. The same text shows wherever the game prints that champion name during the match. The switch is Settings → Skins → Ranks on the loading screen, and it is on by default.

Tab scoreboard. Hold Tab in game and a small rank chip in the tier colour, for example Bronze IV, sits beside every player's name on the scoreboard. It is scaled to your resolution and HUD scale and disappears when you release Tab. The switch is Settings → Overlays → Ranks on the Tab scoreboard, also in the in-game Alt+I panel, and it is on by default.

Auto pick & auto ban

New in 5.3.62: auto pick and auto ban are in Settings → Queue, under Auto-Accept, and both are off by default. Set them per account and per role (top, jungle, mid, bot, support): an ordered list of up to three champions for Chud to hover or lock, another of up to three to ban, and an optional delay before Chud acts.

Chud never overrides a champion you hovered or locked yourself. It skips any champion that is banned, taken or not owned, and moves on to the next one on your list.

Custom mod repair

New in 5.3.65 (faster in 5.3.66): every custom mod is checked against the installed game before it loads. Links to objects the game no longer defines, texture fields that name a file that is not an image, sound banks the game drops silently, materials and health bars from older patches, effects on retired layouts and dead asset paths are all found, and what can be fixed is fixed on the spot using the game's own files.

In the Library. A Needs attention row lists each problem in plain words and offers Fix now; Check all mods runs the sweep on demand. Repair covers UI, map and language packs as well as champion files, and anything it cannot fix is listed with the reason rather than skipped.

Accounts

New in 5.3.62: open Accounts from the app menu. Save the Riot account you are signed in to, then switch between saved accounts in about five seconds from the app or the tray. Each saved session is stored encrypted on your PC.

Signing in always happens in Riot's own window. Chud never fills in Riot's login for you and never sends credentials anywhere. If you want, you can also save a sign-in name and password per account: they stay on your PC, encrypted in the same store as the session and tied to your Windows user account, and Chud copies them to the clipboard for 30 seconds when you need them.

Saved accounts can be backed up to an encrypted file protected by a passphrase, and restored from it later.

Runes, offline & profile

  • 🎵 Runes & builds — opt-in. The moment you lock a champion, Chud imports a recommended rune page (sorted by win-rate or popularity, your choice), and there's a manual "Import build" button too. It never runs unless you've turned it on.
  • 🕵️ Appear offline — hides you on friends lists while you play, and keeps re-asserting it when the client tries to flip you back online.
  • 📊 Live profile — the Profile tab reads rank, form, champion pool, and match history straight from your own client. Nothing is fetched from third-party sites.

Party sync

Enable Party on each Chud client. Party connects when League is available and shares selections with peers in the lobby. Party codes are also available to join a friend’s room: use Copy my party code, or paste a friend’s CHUD code and choose Add friend. Friends’ announcer and custom-mod downloads have separate controls. Shared selections use signed room messages; signatures do not prove ownership of a Riot account.

Party data and privacy

Party sync exchanges selected cosmetic information with other Chud users through a relay. Signed room messages authenticate messages, not ownership of a Riot account. The Party screen contains separate controls for peer announcer and custom-mod downloads.

Read the app’s current privacy descriptions before enabling network features. Local League client calls and external catalog, update, reputation and party services are separate connections.

COMPATIBILITY

Compatibility and requirements

Enable Skins in Settings → Skins. Chud needs administrator rights, the required helper files, a connected client with current game state, an appropriate game phase, and an available injection job. There is no ranked-mode lockout.

Game and client updates can require compatibility fixes. Review the current error shown in the app when a feature is unavailable.

REFERENCE

Settings

Settings is organized into Queue, Auto-Range, Skins, Builds, Party, App and Community sections. Sections render immediately and load their data independently. Retry controls recover failed reads without clearing typed edits.

Use each setting’s current label and description in the app. Some controls require the desktop backend or a connected League client. Artwork can be full, ambient, or off, and reduced-motion preferences are respected.

File locations

Almost everything lives under %LOCALAPPDATA%Chud. The Diagnostics tab shows the exact paths on your machine.

PathWhat's in it
cslol-toolsThe WAD/overlay tools, League Toolkit's patcher pair, and the game-hash table.
modsYour persistent mod library, organized as skins, maps, announcers, fonts, ui, vfx, sfx, voiceover, loading_screen, others.
skins & resourcesThe downloaded community skin catalog and its preview resources.
injectionChud's working area — staged mods, the built overlay, and an extraction cache. Safe to ignore.
stateSmall state files: historic picks, the patcher trust record, updater bookkeeping.
thumbs & logsCached mod thumbnails and app logs.
config.jsonAll settings — stored separately under %APPDATA%; Diagnostics → Paths shows the exact file.

What Chud talks to

Everything that leaves your machine goes through a hardened HTTPS client with a strict allowlist (checked on every redirect, too). The complete list:

HostWhy
chud-skins.jivy26.workers.devThe Library catalog, thumbnails, and the hash-only reputation lookups.
chud-runes.jivy26.workers.devRecommended builds for rune import.
chud-party-relay.jivy26.workers.devThe party-sync relay (a dumb pipe with no database).
chud-telemetry.jivy26.workers.devThe optional anonymous heartbeat.
github.com + GitHub CDN hostsSelf-updates, the community skin repository, game-hash data, and League Toolkit's patcher.
runeforge.dev / r2-prod.runeforge.devLibrary skin files — RuneForge hosts the artifacts; Chud only hosts the index.

The League client itself is only ever reached on 127.0.0.1 — the local API Riot exposes for companion tools.

Troubleshooting

  • No League connection: open League, then retry the relevant section.
  • Skin unavailable: check that Skins is enabled, the patcher download has finished (the Skins tab says so), Chud is running with administrator rights, and a champion is locked for overlay selection.
  • Update missing: install the current build from the working download mirror once if your old build checks only GitHub.
  • Library or Settings load failed: use the section’s Retry control. Keep the current error text when reporting a problem.
  • A pack stopped working: check whether the pack or underlying mod tools need an update for the current League patch.
MODDERS & CREATORS

Custom mods (.fantome)

A .fantome is a renamed .zip with a META/ folder and a WAD/ tree (loose WAD-folder entries or packed .wad.client files). Chud accepts both .fantome and .zip, as files or as unpacked folders.

Installing your own mod

Drop it in %LOCALAPPDATA%Chudmods<category>

Champion skins go one level deeper: modsskins<skinId> — and the folder name is not just organization. Chud reads the mod's target skin from it. Everything else goes straight into its category folder: maps, announcers, fonts, ui, vfx, sfx, voiceover, loading_screen, others.

File it under the skin it edits — not the champion's base folder

  • Skin ids are numeric: a champion's base skin is its champion id × 1000 (Yasuo = 157000), and each of their skins counts up from there. Mod pages usually say which skin a mod was made for.
  • A mod built on a particular skin goes in that skin's id folder. An edit of, say, a Primordian or Elderwood skin belongs in modsskins<that-skin's-id>. Chud uses the folder to pick the right base: if you don't own that skin, it automatically injects the skin's own assets underneath your mod so it shows up complete in game.
  • Only true base-skin retextures go in the champion's ×1000 folder. File a skin-edit there instead and it's applied over the wrong base — missing textures, broken look.
  • Whatever folder it's in, the mod shows for that champion in League's own skin carousel in champ select.
  • Preview image: for a mod file, put an image with the same name beside it (MyMod.fantome + MyMod.png — png/jpg/jpeg/webp all work). For a folder mod, add preview.png (or any image at the folder root). This is what shows on hover in champ select.
  • Description: a description.txt inside a folder mod — or MyMod.txt beside a mod file — is shown as the mod's description.
  • Automatic scoping: on startup and each champ select, Chud sweeps champion-skin mods and strips entries that appear in more than 5 game WADs (shared/global assets). This turns "one skin accidentally rebuilds 22 GB of overlay" into a sub-second build — see the standalone tool if you want to pre-scope yourself.
  • Announcer packs get retargeted automatically to cover Summoner's Rift, ARAM, and Nexus Blitz (details).
  • Scan your own drops: mods you place by hand aren't force-scanned — run ModScan → Scan all mods to get verdict badges on everything, especially files you got from a third party.

Understanding ModScan results

The scanner uses archive structure, content and size checks to flag suspicious or unsupported files. Optional reputation checks use a file hash. Review specific findings in ModScan; a heuristic scan cannot establish that every file is safe.

Announcer pack compatibility

Existing announcer packs are cosmetic mod archives. Compatibility depends on their audio assets, target maps, the game patch and the underlying mod tools. A pack made outside Chud may require changes by its creator when League updates.

Chud supports installing and selecting compatible existing packs; it does not provide a voicepack creation tool.

Using existing custom mods

Existing skin and announcer packs remain supported after removal of the creation tools. Use Library to browse existing packs and ModScan to inspect a local archive. For format or patch problems, consult the pack’s creator.

Need a hand getting started?

Setup help, mod-making questions, and update news — straight from the source.

Join the DiscordDownload for Windows