Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/Nebula-Modmakers/Nebula-Launcher/llms.txt

Use this file to discover all available pages before exploring further.

Profiles let you maintain completely separate sets of mods without ever touching the BepInEx folder by hand. Instead of renaming directories or dragging DLLs in and out before every session, you create a named profile for each mod set you want to run, switch to it in Nebula, and launch. Everything else is handled automatically.

Example use cases

A common starting point is two profiles:
  • Default — the base Nebula runtime with no extra gameplay mods installed.
  • Town of Us — the same base runtime plus Town of Us: Mira and any plugins it depends on.
You can create as many profiles as you need. Each one is independent, so installing or removing a mod in one profile has no effect on the others.

How profiles work

When you press Launch, Nebula stages the active profile’s plugins/ folder into the shared FusionCore BepInEx plugin directory that Among Us reads at startup. Only the files from the selected profile are copied into that shared location — files from other profiles are left untouched. The original Among Us APK is never modified. Nebula operates entirely within its own sandboxed storage and the shared FusionCore area; no system files or game installation files are altered.

Managing profiles

1

Open the Profiles screen

From the main screen, tap Profiles to see a list of all your profiles. The currently active profile is highlighted.
2

Create a new profile

Tap the create button and enter a name. Profile names may contain letters, numbers, spaces, and the characters . - _, and must be no longer than 40 characters. Any other characters are automatically replaced with underscores. Leading dots are stripped, consecutive dots are collapsed to a single dot, and a name that becomes empty after sanitization is saved as Default.
3

Select or activate a profile

Tap a profile in the list to make it the active profile. The change takes effect on the next game launch — switching profiles does not interrupt a running session.
4

Delete a profile

Long-press or tap the delete option next to any profile you no longer need. The Default profile cannot be deleted. If the currently active profile is deleted, Nebula automatically switches back to Default.
Changing the active profile does not take effect until the next game launch. If Among Us is already running, you must exit and relaunch through Nebula for the new profile’s plugins to load.

NebulaCompat.dll

Every time you stage a profile — either by activating it or launching the game — Nebula automatically copies NebulaCompat.dll into the active profile’s plugin folder before syncing it into the shared directory. This file is required for the FusionCore runtime to function correctly with Nebula’s account and session services. You do not need to add it yourself — Nebula manages it entirely.

Profile storage

Each profile’s plugin files are stored in Nebula’s private app data at:
files/profiles/<profile-name>/plugins/
This directory is private to Nebula and is not accessible by other apps. Because it lives in private app data, uninstalling Nebula may permanently remove all profile data, including any mods you have installed into profiles. Back up any files you want to keep before uninstalling. Shared FusionCore files — the staged BepInEx runtime and active plugins — live in shared storage under FusionCore/com.innersloth.spacemafia/ and may persist after an uninstall depending on your Android version and storage configuration.

Build docs developers (and LLMs) love