Extension-first customization
Moonlight separates optional behavior into extensions, making it easier to enable only what you want and disable a feature when troubleshooting.
Feature overview
Moonlight Mod Features
Understand what Moonlight adds, how its modular design works, and where client customization meets update and compatibility tradeoffs.
Moonbase controls
Configuration is surfaced inside the client so supported extension settings and core options stay discoverable.
Dedicated installer
The installer handles detection, downloading Moonlight, patching, updating, and recovery tasks for supported layouts.
Developer APIs
Official docs cover extension manifests, APIs, mappings, Webpack module patching, and common development pitfalls.
Cross-platform paths
Windows, macOS, Linux, browser builds, and Nix approaches are documented, though support details differ by platform.
Open source workflow
Source, issue tracking, releases, installer code, and the official extension repository can be reviewed publicly on GitHub.
What features do not guarantee
No client mod can guarantee uninterrupted compatibility with a service that changes its desktop client. Discord updates can break mappings, patches, or extensions until Moonlight is updated.
Best practice
Use stable releases, add extensions in small batches, and keep the official installer ready for update or unpatch operations.
Installation guide →