Modules & layers

How modules, layers, and the three layer modes (Single, Multi, Inherit) are meant to work.

Modules

A module is a named group of mods for a specific Minecraft version, e.g. "Performance" or "PvP Pack". You can have as many modules as you want per version, and toggle which ones are active before launching.

Layers

Inside a module, mods live in one or more layers. Every module starts with a single Default layer. Layers exist so you can keep variations of a module's mod set without duplicating the whole module — e.g. a "Default" layer and a "Lite" layer with fewer mods.

Each layer has its own name and its own set of installed mods, independent of other layers in the same module until you combine them with a layer mode.

Layer modes

Every module has one layer mode, which controls how its layers combine when you launch:

Single

Only one layer is active at a time. You pick which one from the layer dropdown. This is the default and the simplest mode — think of it as "one variant of this module active at once."

Multi

More than one layer can be active simultaneously. If the same mod (or a different version of the same mod) exists in two active layers, Bricky picks a winner automatically — newest Modrinth publish date first, falling back to version number, and if it genuinely can't tell, it asks you.

Inherit

Layers stack on top of each other in order. Every layer above the first one automatically includes everything from the layer(s) below it, plus whatever it adds on its own. The first layer (index 0) never inherits — it's always just its own mods, since there's nothing below it to inherit from.

Switching a module into or out of Inherit mode physically copies or removes files to match — this can take a moment on modules with a lot of mods, and the launcher blocks input with a progress modal while it happens so nothing can race it.

Reordering layers

You can drag layers to reorder them. In Inherit mode, reordering changes what inherits from what, so Bricky re-syncs the physical files afterward (again behind a blocking progress modal) — the layer that ends up first stops inheriting anything, and every other layer's inherited content is recalculated for its new position.

Layer limits

Modules are capped at 5 layers by default — every part of the launcher has actually been tested against that limit. There's an Unlimited layers toggle in Settings → Launcher → Danger Zone for advanced testing past that, but it's explicitly untested territory and comes with a warning for a reason.