-
Notifications
You must be signed in to change notification settings - Fork 13
Theme customization
github-actions[bot] edited this page May 25, 2026
·
3 revisions
Theme customization is split into asset management, visual/theme settings, and optional plugin settings.
Custom assets must be placed in the correct folder. Pengu Loader 1.2.0+ can scan these folders through PluginFS; older Pengu builds require manual filename registration.
| Asset | Folder | Supported formats | Data list | Function |
|---|---|---|---|---|
| Wallpaper | assets/backgrounds/wallpapers |
.png, .jpg, .jpeg, .gif, .bmp, .webp, .ico, .mp4, .webm, .mkv, .mov, .avi, .wmv, .3gp, .m4v
|
Wallpaper-list |
Home page background image or video. |
| Audio | assets/backgrounds/audio |
.mp3, .flac, .ogg, .wav, .aac
|
Audio-list |
Theme background music or ambient audio. |
| Banner | assets/icon/regalia-banners |
.png, .jpg, .jpeg, .gif, .bmp, .webp, .ico
|
Banner-list |
Profile regalia banner image. |
| Font | assets/fonts |
.ttf, .otf, .woff, .woff2
|
Font-list |
Custom client font. |
- Copy the file into the matching folder.
- Open League Client Settings -> Elaina Theme -> Theme Settings -> Asset library.
- Enter the exact filename in the correct field, for example
my-wallpaper.webm. - Use Add/Delete to update the stored list.
- Reload the client if the current page does not refresh immediately.
- Copy the file into the matching folder.
- Keep the League Client open or restart it.
- The theme scans the asset folders and updates the matching list automatically.
- Use the wallpaper/audio controls on the homepage, or choose font/banner from Theme Settings.
- Custom Font supports either a local file from
assets/fontsor a Google Fonts CSS link. Google Fonts links must usehttps://fonts.googleapis.com/cssorhttps://fonts.googleapis.com/css2.
- Use only the supported extensions listed in the table.
- Keep filenames unique inside each asset folder.
- Avoid very large videos if the client becomes slow.
- If a file does not appear, verify the folder, extension, and exact filename.
Theme Settings control the visual theme, asset behavior, homepage media, profile identity visuals, interface layout, and game tab visibility.
Base theme behavior and language.
| Setting key | UI label | Default | Type | Function |
|---|---|---|---|---|
Elaina-Plugins |
Elaina-Plugins | true |
boolean | Master toggle to enable or disable all Elaina Theme plugins. |
Theme-language |
Theme language | "client" |
string | Theme UI language. Use client to follow the League Client language. |
prevent-manual-update |
Don't receive notifications about future manual updates | false |
boolean | Prevent manual theme update prompts. |
holiday-message |
Message notification for holidays | true |
boolean | Show special messages on holidays. |
Merry-Christmas |
Merry-Christmas | true |
boolean | Enable Christmas holiday special effects. |
NSFW-Content |
NSFW contents | false |
boolean | Enable NSFW content in the theme (disabled by default). |
Homepage background, media playback, slideshow, and window effects.
| Setting key | UI label | Default | Type | Function |
|---|---|---|---|---|
manual-wallpaper-name |
manual-wallpaper-name | "Ex: Wallpaper.webm" |
string | Manually specify a wallpaper filename to add. |
manual-audio-name |
manual-audio-name | "Ex: Audio.mp3" |
string | Manually specify an audio filename to add. |
wallpaper-volume |
Wallpaper volume | 0 |
number | Volume level for wallpaper video audio (0.0 to 1.0). |
WallpaperAudio-timeUpdate |
Wallpaper/Audio interval will save progress to Datastore (per Miliseconds) | not set in defaults | number | Interval for saving wallpaper/audio playback progress to ElainaData (milliseconds). |
Playback-speed |
Playback-speed | not set in defaults | number | Wallpaper video playback speed as a percentage. |
wallpaper-slideshow |
Wallpaper slider | false |
boolean | Automatically cycle through wallpapers at a set interval. |
wallpaper-change-slide-time |
wallpaper-change-slide-time | 10000 |
number | Time between wallpaper changes in slideshow mode (milliseconds). |
disable-theme-wallpaper |
Disable theme's wallpaper | false |
boolean | Completely disable the theme wallpaper background. |
window-effect-name |
Effect | "transparent" |
string | Window background effect mode such as transparent, acrylic, mica, or vibrancy. |
window-effect-color-base |
window-effect-color-base | "#ffffff" |
string | Base color used by the selected window effect before alpha is applied. |
window-effect-alpha |
window-effect-alpha | "00" |
string | Alpha component appended to the window effect color. |
window-effect-color |
Effect color | "#ffffff00" |
string | Computed window effect color including alpha. |
window-effect-material |
Material | "none" |
string | Material variant used by window effects that support material selection. |
audio-volume |
audio-volume | 0.15 |
number | Volume level for background audio (0.0 to 1.0). |
audio-loop |
audio-loop | false |
boolean | Loop background audio when it finishes playing. |
turnoff-audio-ingame |
Pause music/wallpaper when ingame | true |
boolean | Automatically mute theme audio when in a game. |
disable-theme-audio |
Disable theme's audio | false |
boolean | Completely disable background audio. |
pause-audio |
pause-audio | 1 |
number | Pause state for background audio (1 = paused). |
pause-wallpaper |
pause-wallpaper | 1 |
number | Pause state for wallpaper video playback (1 = paused). |
mute-audio |
mute-audio | false |
boolean | Mute the background audio. |
Enable or disable bundled/custom asset replacement.
| Setting key | UI label | Default | Type | Function |
|---|---|---|---|---|
sync-user-icons |
Sync users' custom icons (Only Elaina theme users can see) | true |
boolean | Sync custom user icons across sessions. |
Custom-Icon |
Custom icon | true |
boolean | Use custom summoner icon. |
Custom-Loading-Icon |
Loading | true |
boolean | Use custom loading screen icon. |
Custom-Avatar |
Avatar | true |
boolean | Use a custom avatar image. |
Custom-Border |
Border | true |
boolean | Use custom profile border. |
Custom-Regalia-Banner |
Regalia Banner | true |
boolean | Use custom regalia banner on your profile. |
CurrentBanner |
CurrentBanner | "faker_2.png" |
string | The currently selected banner filename. |
manual-banner-name |
manual-banner-name | "Ex: Banner.png" |
string | Manually specify a banner filename to add. |
Banner-list |
Banner-list | 11 items | array | List of available banner filenames. |
Custom-Hover-card-backdrop |
Hover card backdrop | true |
boolean | Use a custom backdrop for player hover cards. |
Custom-RP-Icon |
RP icon | true |
boolean | Use a custom RP currency icon. |
Custom-BE-Icon |
BE icon | true |
boolean | Use a custom BE currency icon. |
Custom-Rank-Icon |
Rank icon | true |
boolean | Use a custom ranked icon. |
Custom-Emblem |
Honor icon | true |
boolean | Use a custom rank emblem. |
Custom-Clash-banner |
Clash banner | true |
boolean | Use a custom Clash banner. |
Custom-Trophy |
Trophy | true |
boolean | Use a custom trophy icon. |
Custom-Gamemode-Icon |
Custom gamemode icon | true |
boolean | Use custom game mode icons. |
Custom-Ticker |
Ticker icon | true |
boolean | Use a custom ticker/notification icon. |
Custom-Cursor |
Custom cursor | false |
boolean | Use a custom mouse cursor in the client. |
Runes-BG |
Runes-BG | true |
boolean | Use custom rune page backgrounds. |
custom-champs-image |
Custom champions image | false |
boolean | Use custom champion images. |
animate-loading |
Using gif image for loading logo | false |
boolean | Enable animated loading screen. |
Client layout visibility and transparency controls.
| Setting key | UI label | Default | Type | Function |
|---|---|---|---|---|
hide-homepage-navbar |
Hide homepage's navbar manually | true |
boolean | Hide the navigation bar on the home page. |
old-prev/next-button |
Old wallpaper change button | false |
boolean | Use the old-style previous/next wallpaper buttons. |
enable-hide-top-navbar-friendlist-button |
Hide top navigation bar and friends list button | true |
boolean | Show the button that hides/shows the top navbar friend list. |
sidebar-transparent |
Sidebar transparent | false |
boolean | Make the sidebar transparent. |
lobby-transparent-filter |
Lobby transparent filter | true |
boolean | Apply a transparency filter to the lobby area. |
settings-dialogs-transparent |
Transparent dialogs and settings panel | false |
boolean | Make settings dialog backgrounds transparent. |
hide-profile-background |
Hide profile background | true |
boolean | Hide the default profile background image. |
hide-champions-splash-art |
Hide champions splash art in champs select | false |
boolean | Hide champion splash art in the client. |
hide-vertical-lines |
Hide vertical lines on the right of the navbar | true |
boolean | Hide vertical decorative lines in the UI. |
custom-navbar-css |
Custom secondary navigation bar | true |
boolean | Apply custom CSS to the navigation bar. |
navbar-content |
navbar-content | empty list | array | Custom content items for the navigation bar. |
Local visual changes for the player's profile and identity text.
| Setting key | UI label | Default | Type | Function |
|---|---|---|---|---|
custom-rp |
custom-rp | false |
boolean | Display a custom RP (Riot Points) amount. |
RP-data |
RP-data | "-69" |
string | The custom RP number to display. |
custom-be |
custom-be | false |
boolean | Display a custom BE (Blue Essence) amount. |
BE |
Blue essence | "-69" |
string | The custom BE number to display. |
custom-summoner-lv |
custom-summoner-lv | true |
boolean | Display a custom summoner level. |
custom-summoner-lv-number |
custom-summoner-lv-number | "∞" |
string | The custom summoner level to display. |
custom-rank-name |
custom-rank-name | true |
boolean | Display a custom rank name on your profile. |
Rank-line1 |
Rank-line1 | "Apprentice" |
string | First line of the custom rank name. |
Rank-line2 |
Rank-line2 | "Witch" |
string | Second line of the custom rank name. |
Custom-Font |
Custom font | true |
boolean | Enable custom font for the client UI. |
Custom-Font-Local |
Local font file | true |
boolean | Use a font file from the local theme assets/fonts folder. |
Custom-Font-Google |
Google Font | false |
boolean | Use a Google Font CSS URL instead of a local font file. |
Google-Font-Url |
Google Font URL | "https://fonts.googleapis.com/css2?family=Roboto&display=swap" |
string | Google Fonts CSS URL. Only https://fonts.googleapis.com/css and /css2 links are accepted. |
CurrentFont |
CurrentFont | "elaina-herculanum_roman.ttf" |
string | The currently selected font filename. |
manual-font-name |
manual-font-name | "Ex: Font.ttf" |
string | Manually specify a font filename to add. |
Font-list |
Font-list | 4 items | array | List of available font filenames. |
change-nickname-color |
Change nickname color | true |
boolean | Enable custom nickname color in the client. |
nickname-color |
nickname-color | "#f2c1d0" |
string | Hex color code for your nickname. |
nickname-opacity |
nickname-opacity | "ff" |
string | Opacity (alpha) hex for the nickname color (00-ff). |
nickname-color-with-opacity |
nickname-color-with-opacity | "#f2c1d0ff" |
string | Full hex color with opacity for the nickname (auto-computed). |
hide-theme-usage-time |
Hide theme usage time | false |
boolean | Hide the theme usage time counter in settings. |
Hide or show queue/game sections in the play page.
| Setting key | UI label | Default | Type | Function |
|---|---|---|---|---|
hide-summoner-rift-5v5 |
Hide Summoner Rift 5v5 | false |
boolean | Hide the Summoner's Rift 5v5 tab or section in the play page. |
hide-aram |
Hide ARAM | false |
boolean | Hide the ARAM tab or section in the play page. |
hide-arena |
Hide Arena | false |
boolean | Hide the Arena tab or section in the play page. |
hide-custom-game-section |
Hide custom game section | false |
boolean | Hide the custom game section in the play page. |
hide-tft |
Hide TFT | false |
boolean | Hide the TFT tab or section in the play page. |
hide-tft-match-history |
Hide TFT match history | false |
boolean | Hide TFT match history section. |
hide-tft-news |
Hide TFT news | false |
boolean | Hide TFT news section. |
hide-tft-rotational-shop |
Hide TFT rotational shop | false |
boolean | Hide TFT rotational shop. |
hide-tft-troves |
Hide TFT troves | false |
boolean | Hide TFT Troves section. |
hide-tft-battle-pass |
Hide TFT battle pass | false |
boolean | Hide TFT battle pass section. |
hide-tft-home |
Hide TFT home | false |
boolean | Hide TFT home tab entirely. |
Plugins Settings controls optional client behavior. Some plugin settings apply immediately; queue/profile features commonly require reload or restart.
General plugin toggles and commonly used client helpers.
| Setting key | UI label | Default | Type | Function |
|---|---|---|---|---|
Old-League-Loader-Settings |
Old-League-Loader-Settings | true |
boolean | Show old-style League Loader settings layout. |
loot-helper |
Loot helper | true |
boolean | Enable the loot disenchant helper buttons. |
auto_accept_button |
Auto Accept button | true |
boolean | Show the auto-accept toggle button in the lobby. |
auto_accept |
Auto Accept | false |
boolean | Automatically accept matchmaking queue when a game is found. |
auto_accept_delay |
Auto accept delay (ms) | 0 |
number | Delay before auto-accepting a ready check (milliseconds). |
dodge-button |
Show dodge button | true |
boolean | Show a dodge button in champion select to leave the queue. |
Enable-Invite-Fr |
Enable invite all friends plugins | true |
boolean | Show the 'Invite All Friends' button in lobby. |
Automatic lobby creation and match search behavior.
| Setting key | UI label | Default | Type | Function |
|---|---|---|---|---|
Auto-Find-Queue |
Auto find queue | false |
boolean | Automatically search for a new game queue. |
Gamemode |
Game modes | 450 |
number | Game mode queue ID for auto-queue (e.g., 450 = ARAM). |
Create-Delay |
Queue creation delay | 15000 |
number | Delay before creating a new lobby in auto-queue (milliseconds). |
Find-Delay |
Match finding delay ( Miliseconds ) | 10000 |
number | Delay before searching for a match in auto-queue (milliseconds). |
aram-only |
Aram only mode | false |
boolean | Restrict auto-queue to ARAM mode only. |
Local profile hover card, rank, challenge, status, and name display changes.
| Setting key | UI label | Default | Type | Function |
|---|---|---|---|---|
Custom-profile-hover |
Custom profile(Hover-card) | false |
boolean | Customize the profile hover card information. |
Custom-mastery-score |
Custom mastery score | true |
boolean | Display a custom mastery score. |
Mastery-Score |
Mastery-Score | 6969 |
number | The custom mastery score number to display. |
Custom-rank |
Custom-rank | true |
boolean | Display a custom rank on your profile. |
Ranked Queue ID |
Ranked Queue ID | 2 |
number | Queue ID for custom rank display. |
Ranked Tier ID |
Ranked Tier ID | 9 |
number | Tier ID for custom rank (e.g., 9 = Challenger). |
Ranked Division ID |
Ranked Division ID | 0 |
number | Division ID for custom rank display. |
Custom-challenge-crystal |
Custom challenge crystal | true |
boolean | Display a custom challenge crystal level. |
Challenge-Points |
Challenge-Points | 6969 |
number | Custom challenge point total to display. |
challengeCrystalLevel |
challengeCrystalLevel | 9 |
number | Custom challenge crystal level (0-9). |
Custom-Status |
Custom status | false |
boolean | Set a custom status message. |
Custom-Status-Local |
(Experiment) Local custom status | false |
boolean | Display custom status locally only (others won't see it). |
status-delay |
Delay time ( Miliseconds ) | 10000 |
number | Delay before applying custom status (milliseconds). |
Name-Spoofer |
Name spoofer | false |
boolean | Display a custom summoner name (local only). |
Spoof-name |
Spoof-name | "Elaina Da Catto" |
string | The custom summoner name to display. |
Debug and developer-only controls. Keep these disabled unless you are debugging the theme.
| Setting key | UI label | Default | Type | Function |
|---|---|---|---|---|
Debug-mode |
Debug mode | false |
boolean | Enable debug logging in the console. |
Dev-mode |
Dev-mode | false |
boolean | Enable developer mode features. |
Active-dev-button |
Active-dev-button | 0 |
number | Click counter for developer mode activation (internal). |
Dev-button |
Dev-button | false |
boolean | Whether the developer mode button is visible. |