Maranara-Custom_Maps icon

Custom Maps

Custom map loader for BONEWORKS

Last updated 2 months ago
Total downloads 21215
Total rating 9 
Categories Code Mods
Dependency string Maranara-Custom_Maps-1.8.1
Dependants 26 other mods depend on this mod

This mod requires the following mods to function

gnonme-ModThatIsNotMod-0.2.3 icon

A mod for loading in custom items, making life easier for other mod creators, and a whole lot more.

Preferred version: 0.2.3


Custom Maps (ML2.3+)

Version 1.8.0, uploaded by Maranara into category code Original File Name:

Original mod created by Herp Derpenstine and Someone Somewhere! Features from 1.3 onward are made by me, Maranara, with cleanup help from Trev.


ModThatIsNotMod (HEAVILY RECOMMENDED, NOT REQUIRED) Custom Map Interactions

NEW Custom Map Guide:

How To Use

  1. Install the latest version of MelonLoader.
  2. Install the required mods (Dependencies) provided on Thunderstore. a. ModThatIsNotMod c. (HEAVILY RECOMMENDED, NOT REQUIRED) Custom Map Interactions
  3. Install Custom Maps by dragging the .dll into your BONEWORKS/Mods folder.
  4. Launch BONEWORKS once, let it run to the Main Menu and then exit the game right after.
  5. Download any maps you want on Thunderstore, in the Custom Maps category.
  6. To use the maps, drag the .bcm into the CustomMaps folder inside of UserData. UserData is a folder inside of your BONEWORKS directory, the place where BONEWORKS.exe is located.
  7. Launch the game once again. Open your spawn menu and spawn the Utility Gun. You can select the Custom Map you want from the SPAWNABLES category. Once you select the map you want, spawn it.
  8. Step onto the platform and it will begin to load your custom map.




  • Upon loading a map, it now force-loads the Blank Box scene and deletes the Blank Box geometry.
  • The KeepGadgets modpref will prevent Custom Maps from deleting the gadgets in Blank Box, such as the Health Machine.
  • Upon teleporting, the player's velocity is now set to 0.
  • Maps are now able to override fog with ValveFog. Δ
  • Maps are now able to prevent enemies from agroe-ing each other. Δ
  • Maps are now able to place Monomats with custom set prices. Δ
  • Added support for dummy audio mixers instead of using MAP_SFX/MAP_MUSIC. Δ
  • Dummy shader optimizations made now with the requirement of the BMT.
  • Fixed inconsistent respawning.
  • Optimized audio mixer finding.
  • Changed the Spawngun Portal to be more lightweight and simpler to use.
  • All cleanup functions now removed due to force-loading BlankBox.
  • Old loading method, using OpenVR, removed due to force-loading BlankBox.

Δ Map makers - view the Custom Map Guide if you're wondering how to use these features.

Older changes logged at

Available versions

Please note that the install buttons only work if you have compatible client software installed, such as the Thunderstore Mod Manager. Otherwise use the zip download links instead.

Upload date Version number Downloads Download link  
2021-10-17 1.8.1 10231 Version 1.8.1 Install
2021-7-28 1.8.0 10984 Version 1.8.0 Install