extraes-SceneSaverBL icon

SceneSaverBL

Save and load collections of spawnables, NPCs, and their constraints & planks! And share them with others!

Last updated a week ago
Total downloads 5097
Total rating 8 
Categories Code Mods
Dependency string extraes-SceneSaverBL-2.0.0
Dependants 0 other packages depend on this package

This mod requires the following mods to function

gnonme-BoneLib-3.1.2 icon
gnonme-BoneLib

A BONELAB mod for making life easier for other mod creators.

Preferred version: 3.1.2
extraes-JeviLibBL-3.1.0 icon
extraes-JeviLibBL

A multifunction library for code modders, containing patching, preferences, tweening, easy barcodes, async support, stats, and other utilities.

Preferred version: 3.1.0

README

SceneSaverBL - Basically GMod dupes in BONELAB

Especially now that you can move where saves are loaded in v2.0.0!

You can watch the trailer here

SceneSaver v2.0.0 does not support Quest/LemonLoader. This is because the loader version is older than 0.7.1, so I haven't even rebuilt the resources for Android.

What does it save?

  • Spawnables

    • NPCs (cuz theyre spawnables) and their limb positions.

    • Giant stacks of props, like the "Dunes of Nimbus" if you spawn a few hundred Nimbus Guns

  • Constraints

    • All constraint modes can be saved and loaded. WELD constraints can be ignored if they weld a saved object to the world.

    • They may be offset a bit when loading, but the constrainer's code is kind of a black box that I don't feel like inspecting any more than I already have. Sorry.

  • Planks from the board gun

    • Make a cool house? Or make a zombie survival scenario with boarded up windows? Now you can relive it with SSBL!
  • Preview image & area

    • Show off what's in your save! Anything ingame will appear in the preview, including your avatar!

    • The area that was saved will appear when you preview the save, so you know where you left off.

Preferences

Among various other things, SceneSaverBL manages its preferences/config via JeviLib. Various aspects of SSBL can be adjusted and fine-tuned to find the best experience for you. All of these values can be changed in MelonPreferences.cfg or in BoneMenu.

  • showPreviewLocation (true/false, default: false)

    • Always shows where the preview image will be taken from, as opposed to only when SSBL's BoneMenu is open (by showing an orange smiley face).
  • disablePolaroid (true/false, default: false)

    • When saving, a 'polaroid' of the preview image is spawned. To disable this, set this to true.
  • filterByLevel (true/false, default: true)

    • When looking through your locally stored saves, this will filter out saves that are not for your current level (example: a save for LongRun won't show up if you're in Mine Dive).

    • In v2.0.0 you can disable this to load saves from different levels using the "Load as Dupe" button, and spawn them anywhere you want!

  • freezeWhileLoading (true/false, default: true)

    • Freezes objects while other objects are still loading. This may cause saves to load slower than if it was disabled, but prevents things from falling while loading.
  • saveChecks (true/false, default: true)

    • Performs extra checks while saving, to make sure data will be able to be loaded properly (has fallback behavior)
  • loadStaticWelds (true/false, default: false)

    • Loads WELD constraints that are between the current object and a non-saved object. Use this if you pin an object in place when saving and want it to remain pinned when being loaded.
  • dontUseStickClick (true/false, default: false)

    • If true, will move wire when only Grip+Trigger are held, otherwise will require Grip+Trigger+StickClick
  • ssblRepo (URL, default: https://ssbl.extraes.xyz)

    • The URL base to be used when fetching from the online save repository. If you change this, don't include a slash at the end.

    • Repositories don't communicate with each other, so if a friend changes repositories, you'll have to change to that.

    • It's worth noting that if the repo you use is hosted with the official SSBL Repo server software, there are certain stats that are collected that cannot be disabled by the client (you)

      • Weekly and lifetime download counts.
  • rightHandDupeLine (true/false, default: true)

    • If true, the position-setting line for Dupes will come from your right hand. Otherwise it'll come from your left hand.
  • fusionSync (true/false, default: true)

    • If true, uses Fusion to spawn objects. If false, it uses the base game to spawn objects, which may or may not work with Fusion.

What's next?

Honestly? I don't know. If I were to continue work on features for this mod, it'd probably need a rearchitecting. I think I've accomplished everything I'd like to do at this point.

Probably Quest support, once it gets ML 0.7.1, but not much big after that.


SceneSaverBL makes use of "ModStats" for some basic statistics about mod usage. You may opt-out by setting "disableStats" to true in MelonPreferences.cfg, or by doing the same in BoneMenu.

The information SSBL uses is as follows, and it is impossible to identify any single user. As a result, it is impossible for me to remove your specific data, as that would require I identify your data.

questLaunches - the number of times the game has been launched with SceneSaverBL installed on Quest devices. pcvrLaunches - the number of times the game has been launched with SceneSaverBL installed on PCs (Steam or the Oculus desktop app, or pirated). fullsavesCreated - the number of times a "full" save has been created. quicksavesCreated - the number of times a "quick" save has been created. fullsavesLoaded - the number of times a "full" save has been loaded. quicksavesLoaded - the number of times a "quick" save has been loaded.

This data probably isn't handled in accordance with GDPR or California state law, but I don't really care. I don't use it for advertising or tracking, and it's basically just used on a personal basis (e.g. "oh hey the pcvrLaunches is 7x what questLaunches is"). If you care so much that I want to know whether to focus more on PCVR or Quest development, move to the woods and become Ted Kaczynski's spiritual successor.


If you like SSBL and want to support it/me/other mods I've made or will make (like BLChaos), you can support me on Ko-fi. The Repo server runs on a computer I own, so if you like how easy it makes sharing saves, throw a brother some coin

SceneSaverBL uses the name from the BONEWORKS mod "SceneSaver". I never used it and didn't check who made it, I just liked the name and wanted to make "GMod dupes but in BONELAB" a reality, because it seemed like a fun programming challenge.

SceneSaverBL uses two models for the Selection Wire tutorial:

  1. The left Oculus Quest 2 controller model is from:

  2. The left Valve Index controller model is from:

  3. The hand model is from: