Mappings

moonlight comes with mappings that automatically rename Discord’s Webpack modules for you. You can import and use these modules in your extensions.

mappings automatically detects unknown modules and remaps them to have consistent module IDs and export names.

Browsing mappings

There is no search system for mappings yet, but you can browse the source repository instead. Press / on your keyboard to search in the GitHub web UI.

Notable modules

• react: React
• discord/packages/flux: Discord’s fork of Flux
• discord/Dispatcher: Discord’s Flux dispatcher
• discord/components/common/index: A lot of components reused in the client

Using mappings in an extension

Inside of a Webpack module, you can import/require mappings just like any other module:

import Dispatcher from "@moonlight-mod/wp/discord/Dispatcher";
// or
const Dispatcher = require("discord/Dispatcher").default;

Remember to add the module as a dependency to your Webpack module. Unlike extension libraries, mappings are built into moonlight, and do not need to be added to your extension’s manifest.

Mappings stability

The mappings repository only proxies existing Discord modules and exports. As such, if Discord removes a module or export, or a module is not properly remapped, the mapping will fail and your extension may break.

Exports and types in the mappings repository may change or be removed if Discord removes it from their own source code. In this scenario, moonlight developers are forced to remove the mapping, and we do not have the ability to bring a module back.

See here for more information on module stability.