MapLoader

版本 v1.1.7·更新於 2026-02-26

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

模組介紹 作者原文

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.

安裝與使用 安裝:按包內說明操作

  1. 解壓本站下載的壓縮包,先讀包內的 readme / 說明檔案。
  2. 多數模組依賴遊戲的模組載入器:常見做法是用社群模組管理器(如 r2modman)選中本遊戲安裝,由管理器自動處理載入器與依賴。
  3. 手動安裝時,把模組檔案放進遊戲目錄下對應的 Mod / plugins 資料夾。
  4. 啟動遊戲確認載入成功;帶「前置依賴」的模組需要把依賴一併安裝。

不同模組的安裝位置差異較大,包內說明是最可靠的依據。

前置依賴

下面這些內容需要先安裝,否則該模組不會生效:

BepInEx-BepInExPack

檔案與校驗

檔案名稱
MapLoader-1.1.7.zip
檔案大小
88.6 KiB