How Nebula delivers mods

Nebula is a launcher, a server panel and an app (Windows and Android) that gives players the mods of the server they play on, and keeps everyone else from getting them. This page is the same for every game; the game-specific pages say how to build a mod for that game.

What Nebula does

  • You, the mod author or server owner, upload a mod once on the panel.
  • Nebula scans it, and delivers it, encrypted, to the players whose Nebula account is whitelisted for your server (and, for a game server such as Minecraft, to the server itself).
  • The mod is only on a player's device while the game runs, and is removed when it closes (unless you allow caching).

Accounts and servers

Everything hangs off a server (a Discord server you manage) or the global store of a game. A player signs in with Discord or Google, is whitelisted per server (or globally), and picks which server's mods to play with. A game can be switched to admin-only while it is in development.

Uploading a mod

  1. Open Admin › Mods (global) or a server's own Server mods tab, on the web panel, the desktop launcher or the Android app.
  2. Choose the file: a .dll for Among Us, a .jar for Minecraft. Nebula reads the name, version and what it needs from the file itself.
  3. It is malware-scanned. A mod that is flagged cannot go live until an admin has reviewed it.
  4. A new mod starts off, so nothing changes for players by accident. Switch it on when you are ready.

The four lists

ListWhat it holds
Server modsThe gameplay mods players of this server get.
LibrariesHelper mods other mods need in order to load. They are delivered together with the mods that need them.
Optional add-onsExtras each player can turn on or off, unless you force one on.
GlobalThe same lists for the whole game: what everyone gets, and which servers get each.

Versions

Uploading the same name with a new version keeps both. Players get whichever version you enable. A server can also pin the game build its players run.

How a mod reaches a player

  • Stored encrypted on the panel.
  • Encrypted again for each delivery with a fresh key (AES-256-GCM) and signed by the panel. The launcher or agent checks the signature before it uses the file.
  • Stamped with a hidden per-account watermark.
  • Placed where the game reads it only while the game runs, then removed.

Secure and Secure+

Two optional levels a mod author can opt in to. How you opt in depends on the game, so each game has its own page: Among Us marks a mod in its assembly; Minecraft marks it in its jar's manifest.

LevelIdea
SecureThe mod only runs when Nebula delivered it. A copy dropped into someone's own game does not load.
Secure+Secure, and the mod is kept out of reach as far as the game allows: in Among Us it is loaded from memory and never written to disk; in Minecraft it is never sent to a server or its host.
Secure and Secure+ make casual copying pointless. Nothing running on someone else's machine can be made truly un-extractable, which is what the watermark is for.

Leaks

If a mod turns up where it should not, upload it to Admin › Trace a leak. Nebula reads the hidden watermark and tells you which account it was delivered to.