slocLoader

A plugin that allows for the loading of objects contained within sloc files in SCP: Secret Laboratory.

Watch the tutorial

Set up the plugin

MapEditorReborn

Before this project was started, I had no knowledge of the MapEditorReborn plugin.

This is not meant to be a clone of MER, but a different approach to be able to load Unity Scenes in SCP: Secret Laboratory.

Check out MapEditorReborn here

What is an sloc?

sloc stands for Secret Laboratory Object Container.

An sloc file can contain primitive Unity objects (spheres, cubes etc.) and also lights.

Note: SCP:SL only supports spawning point lights remotely, therefore it's not yet possible to create spot, directional or area lights.

To create an sloc file, use slocExporter

sloc files are not text, but raw bytes. This means that opening one in a text editor will produce gibberish, since it's not meant to be interpreted as text. It is a sequence of integers and floats.

Setup

Axwabo.Helpers is required as a dependency.

For EXILED

1. Download the slocLoader.dll file from the latest release
2. Place the DLL into the EXILED Plugins folder (Windows: %appdata%\EXILED\Plugins)
3. Restart your server

For Northwood Plugin API

Automatically

1. Run the command p install Axwabo/slocLoader in the server console
2. Restart your server

Manually

1. Download the slocLoader-nw.dll file from the latest release
2. Place the DLL into the NW Plugins folder (Windows: %appdata%\SCP Secret Laboratory\PluginAPI\plugins\port)
3. Download the latest Harmony release (Harmony.x.x.x.x.zip, not the source code)
4. From the zip file, put the net4.8\0Harmony.dll into the NW Dependencies folder (Windows: %appdata%\SCP Secret Laboratory\PluginAPI\plugins\port\dependencies)
5. Restart your server

Adding objects

To load objects automatically, put your sloc file into %appdata%\EXILED\Plugins\sloc\Objects or %appdata%\SCP Secret Laboratory\PluginAPI\plugins\port\sloc\Objects

Make sure the auto_load property in the plugin config is set to true.

The objects in the folder above will be loaded automatically when the map is generated.

Use the sl_spawn command and the name of the object file (without the extension) in-game to spawn an object. Example: sl_spawn test

To remove previously spawned objects, use the sl_destroy command. It takes the netID of the object, which the spawn command outputs.

Automatic spawning

Make sure the enable_auto_spawn property in the plugin config is set to true.

View the list of room names and types here

In the plugin config, add an item to the auto_spawn_by_room_name, auto_spawn_by_room_type or auto_spawn_by_location list. There are examples provider for ease of use.

Room name template:

asset_name: example
point:
  room_name: HCZ_106
  position_offset:
    x: 0
    y: 0
    z: 0
  rotation_offset:
    x: 0
    y: 0
    z: 0
make_objects_static: false

RoomType template:

asset_name: example
point:
  type: LczClassDSpawn
  position_offset:
    x: 0
    y: 0
    z: 0
  rotation_offset:
    x: 0
    y: 0
    z: 0
make_objects_static: true

StaticPosition template:

asset_name: example
point:
  position:
    x: 10
    y: 0
    z: 50
  rotation:
    x: 0
    y: 90
    z: 0
make_objects_static: false

All assets that have been loaded by the AutomaticObjectLoader will be spawned in the room specified.

If an asset was not loaded, it will be ignored.

Rotation offsets are specified using Euler angles, not Quaternions.

The make_objects_static property defaults to false. Setting it to true will boost server performance as transform updates will not be sent to the client (can cause desync if plugins move the objects).

Spawning objects in-game

The sl_spawn command can be used to spawn assets through the Remote Admin. Required permission is FacilityManagement

Example: sl_s MyObject

The asset has to be defined as in automatic spawning

Your position and horizontal rotation will be applied to the objects by default. To modify this behavior, use the sl_position and sl_rotation commands.

For example, sl_pos 0 1000 0 will spawn the specified object at the coordinates 0, 1000, 0 (x, y, z)

To clear the current settings, simply type sl_pos or sl_rot to remove the defined values.

API usage

The plugin offers various methods to make loading objects easy.

Add the DLL as an assembly reference to get started.

You can spawn objects directly from a file, or from within your assembly

Use the methods in the slocLoader.API class to load objects.

Make sure to do this after the prefabs are loaded; register a handler to the PrefabsLoaded event contained in the API class.

Example of spawning a singular object:

using UnityEngine;
using slocLoader;
using slocLoader.Objects;

new PrimitiveObject(ObjecType.Capsule)  // non-primitive type will throw an exception
{
    Transform = 
    {
        Position = new Vector3(0, 50, 0),
        Rotation = Quaternion.Euler(0, 50, 0),
        Scale = new Vector3(2, 1, 2)
    },
    ColliderMode = PrimitiveObject.ColliderCreationMode.Trigger,
    MaterialColor = Color.red
}.SpawnObject();

Versioning

Each exported sloc file has a version number.

Even if a new version of sloc is released, old sloc files will still be compatible with the current version of the plugin due to the versioning system.

All versions have their own object readers to read the objects from the sloc file. This way, no sloc file will be broken after a new version is released.