Webpack and Patches

Find Discord Webpack modules and write source patches using the local Illegalcord APIs.

Discord code is bundled through Webpack. Illegalcord exposes lazy finders and a patch system so plugins can use Discord internals without importing them directly.

Lazy finders

Use lazy finders at module scope:

import { findByPropsLazy, findComponentByCodeLazy, findStoreLazy } from "@webpack";

const VoiceActions = findByPropsLazy("toggleSelfMute");
const GuildStore = findStoreLazy("GuildStore");
const SomeComponent = findComponentByCodeLazy(".someStableCodeFragment");

Common stores and utilities are often already exported from @webpack/common:

import { FluxDispatcher, React, UserStore, useStateFromStores } from "@webpack/common";

Before adding a finder, check src/webpack/common. Many stores and utilities are already mapped there.

CSS classes

Use findCssClassesLazy for Discord’s mangled class names:

import { findCssClassesLazy } from "@webpack";

const classes = findCssClassesLazy("container", "avatar");

Do not hardcode generated class prefixes or suffixes in plugin CSS.

Declarative patches

Webpack source patches live on the plugin object:

import { EquicordDevs } from "@utils/constants";
import definePlugin from "@utils/types";

export default definePlugin({
    name: "PatchExample",
    description: "Shows the shape of a Webpack patch.",
    authors: [EquicordDevs.irritably],

    patches: [
        {
            find: "stableSourceString",
            replacement: {
                match: /stableSourceString.{0,80}?targetCall\(/,
                replace: "$&$self.beforeTarget(arguments[0]),"
            }
        }
    ],

    beforeTarget(value: unknown) {
        return value;
    }
});

Use $self only for methods that live on the plugin object.

Patch rules

• Prefer string find anchors.
• Use stable strings such as intl keys, action types, paths, or distinctive code.
• Keep regex gaps bounded, usually .{0,150}?.
• Capture only what you reuse.
• Use group: true when multiple replacements must succeed together.
• Use predicate, fromBuild, or toBuild for version or target gates.
• Keep replacement strings small and move logic into plugin methods.

Do not write broad patches with unbounded .*? or .+?. They are fragile and can rewrite the wrong module after Discord updates.