Moonlight Mod FAQ
Concise answers about downloads, installation, compatibility, client-mod risk, updates, and troubleshooting.
What is Moonlight Mod?
Moonlight is an open-source Discord client mod focused on user and developer customization through a modular extension system.
Is this the official Moonlight website?
No. Moonlightmod.com is presented here as an independent guide. Official project code and downloads are linked from the moonlight-mod GitHub organization and its documentation.
Where is the Windows installer hosted?
The download button points to GitHub's latest release asset for moonlight-mod/moonlight-installer.
Does the site re-host the EXE?
No. The executable is not bundled in this project; the button links to the official upstream GitHub asset.
Does Moonlight work on macOS?
A macOS installer is documented, but official notes mention application-signing and persistence limitations that can affect updates.
Does Moonlight work on Linux?
Yes, with documented limitations. Supported installer layouts include specific user-local and Flatpak setups; system package-manager installations may not be supported by the installer.
Can Discord updates break Moonlight?
Yes. The client can change internals used by mappings or patches. Moonlight releases often address those changes.
Are extensions automatically safe?
No software extension should be treated as automatically safe. Prefer trusted repositories, review source when practical, and avoid projects that request account secrets.
Does using Moonlight violate Discord rules?
The official Moonlight installation documentation explicitly warns that client mods are against Discord's Terms of Service.
What should I do if Discord no longer starts?
Use the installer to update or unpatch, then test Discord without optional extensions. Re-enable extensions gradually after the core setup works.