FAQ Troubleshooting

5. FAQ & Troubleshooting

Common problems and the quickest checks for each one.

The theme does not appear in League Client settings.

• Verify that the built theme folder is inside the Pengu Loader plugins directory.
• Verify that Pengu Loader is running and enabled for the League Client.
• Restart the League Client.
• Check the console for theme import or syntax errors.

My wallpaper or audio file does not show up.

• For Pengu Loader 1.2.0+, verify the file is in the correct asset folder and has a supported extension.
• For older Pengu builds, add the exact filename manually in Theme Settings -> Asset library.
• Reload the client if the asset list was changed while the client was already open.
• Avoid unsupported extensions or filenames that differ only by case.

Settings are not saving.

• On Pengu Loader 1.2.0+, check whether PluginFS can write ./data/ElainaData.json.
• On older Pengu builds, settings are stored in Pengu DataStore.
• Try changing one simple setting, reload the client, and check whether it persists.
• Export a manual backup before deleting or resetting data.

Auto Accept accepts too fast or accepts after I declined.

• Check auto_accept_delay; the value is in milliseconds and is capped by the plugin.
• The current implementation cancels the pending accept when ReadyCheck ends or when your ready-check response becomes Declined.
• If it still happens, disable Auto Accept button, reload the client, then re-enable it.

The client becomes slow after enabling wallpapers.

• Use smaller videos or image wallpapers.
• Disable theme wallpaper or reduce video complexity.
• Disable animated loading and other heavy visual replacements.
• Reload the client after changing large assets.

Cloud backup says the server is unavailable.

• Check your internet connection.
• Try again later; the cloud service may be sleeping or temporarily unavailable.
• Use manual backup/restore when cloud backup is unavailable.

How do I reset the theme?

• Use the theme restore/default flow if available.
• Export a manual backup first if you want to keep a copy.
• On PluginFS builds, removing the theme data file resets file-backed settings.
• On older builds, clearing the Pengu DataStore entry for ElainaTheme resets stored settings.

Should I enable Developer mode?

• Keep Developer mode disabled unless you are debugging or contributing to the theme.
• Developer mode exposes debug tools and extra system information.
• Some developer-only behavior can make the theme noisier or less stable for normal use.

---