MapLoader

v1.1.7·Updated 2026-02-26

Loads scene asset bundles and creates portals in Sanctum that lead to them.

About this mod Author’s original text

Map Loader

This is a helper mod to load maps contained in an asset bundle. It looks through the plugins folder and finds bundles that end with ".mapbundle".

It will load them, and make a portal for each bundle. The portal caption will be the name of the scene that was bundled, and the mod's icon will float above it if an icon.png is present in the same directory as the mapbundle. The portals will appear on the spawn platform in Sanctum. You can also use the world portal to teleport to custom maps.

For Mappers

To make a map you'll need a decompiled project of Atlyss. You can follow this tutorial to get one

Once you have a working project, you can copy an existing map (that is NOT Sanctum) and edit it how you want.

Make sure you have a spawn point with the tag "spawnPoint" since the map loader will make a portal pointing to this tag.

The caption on the portal will be the name of the scene you bundle.

If you have custom creeps or items on your map, you can pack those scriptables in their own bundle with a ".scriptable" extension. Maploader will load these bundles and automatically add any creeps, items, skills, quests, and conditions it finds to the game's cache so they can work properly.

When the map is ready, you can bundle it with thunderkit or AssetBundleBrowser. Just make sure the extension is ".mapbundle" so the loader will see it.

If you want to upload the map, remember to include the dependency string of this mod in your manifest.

Known Issues

  • At most 12 separate portals will be made, but all maps should have an entry in the world portal to teleport to.
  • This mod doesn't check if a mod depends on it. It just loads any files it finds that end with ".mapbundle" (or ".scriptable") so a mod that relies on loading its own bundle will need to use a different extension.
  • Clients will see a unity error for every portal they don't have when spawning into Sanctum. As far as I'm aware, this can be safely ignored.

Install & use Install: follow the bundled instructions

  1. Unzip the archive from playbuff and read the bundled readme / instructions first.
  2. Most mods rely on the game's mod loader — the usual route is a community mod manager (such as r2modman): pick this game, install, and it handles the loader and dependencies.
  3. For a manual install, put the mod files into the matching Mod / plugins folder inside the game directory.
  4. Launch the game to confirm it loaded; mods with listed dependencies need those installed as well.

Install locations vary a lot between mods — the bundled readme is the most reliable guide.

Dependencies

Install these first, or the mod will not work:

BepInEx-BepInExPack

File & checksum

Filename
MapLoader-1.1.7.zip
File size
88.6 KiB