AdvancedMERTools (AMERT)

Note: If you want to use schematics that were created with the old version of AMERT, prior to this LabAPI port, see the note about legacy releases at the bottom.

Installation Instructions

This version of the project now depends on the following:

• SCPSL Version 14.1
• ProjectMER
• LabAPI
• AudioPlayerApi

Extra AMERT Tools (UnityEditor)

1. Download the necessary files from the specified folder above.
2. Drag and drop the files into the 'Project' tab in the Unity Editor. Preferably to DONT TOUCH/Scripts
3. (LabAPI work in progress) In the release tab, you will find a plugin that facilitates the execution of functions and modeling for LCZ, HCZ, and EZ doors.

Main Plugin (Server)

To add AMERT to your server:

1. Download the AMERT .dll and the dependencies.zip from the Releases page
2. Place AdvancedMERTools.dll and ProjectMER.dll in %APPDATA%\Roaming\SCP Secret Laboratory\LabAPI\plugins\global
3. Place AudioPlayerApi.dll and Newtonsoft.Json.dll in %APPDATA%\Roaming\SCP Secret Laboratory\LabAPI\dependencies\global
4. If you are using any AMERT audio tools in the next section, place AMERTAudioModule.dll in %APPDATA%\Roaming\SCP Secret Laboratory\LabAPI\dependencies\global

Schematics

This project uses schematics and other assets in the same way that ProjectMER does.

1. Place schematic folders in %APPDATA%\Roaming\SCP Secret Laboratory\LabAPI\configs\ProjectMER\Schematics by default. This can be changed via PMER config.
2. Place audio files (for GroovyNoises or other AMERT audio) in %APPDATA%\Roaming\SCP Secret Laboratory\LabAPI\audio by default. This can be changed via AMERT config.

Permissions

If you are new to ProjectMER, see their github for documentation. In order to spawn schematics in-game, you need to set permissions for the desired roles. The file for permissions can be found at %APPDATA%\Roaming\SCP Secret Laboratory\LabAPI\configs\permissions.yml by default.

This example permissions.yml file grants the ability to use all PMER mp commands to admins and the server owner:

default:
  inherited_groups: []
  permissions: []
admin:
  inherited_groups: []
  permissions:
  - mpr.*
owner:
  inherited_groups: []
  permissions:
  - mpr.*

AdvancedMERtools Description

AdvancedMERtools offers advanced tools for the SCP: SL plugin called MapEditorReborn (formerly MER, now ProjectMER). We plan to add more features in the future.

Features

• AutoScaler: Scales grouped objects up or down automatically.
• Rotator: Rotates objects akin to the behavior of a magnetic field or sphere.
• Mirror: Creates a mirrored copy of objects.
• Arrange: Duplicates and arranges objects.
• Health Object: Adds a hitbox to your objects. Requires additional plugin.
• Interactable Pickup: Functions similarly to the Health Object. Requires additional plugin.
• Custom Collider: Adds custom collision properties to objects.
• Interactable Teleporters:
• Text: Adds text to set empty object.
• Custom RGBA: Extends the minimum and maximum RGBA values beyond 0-255 to enhance object glow.
• Converter: Converts Unity's primitives into MER's components if placed accidentally. Activating it will also automatically color your primitives based on the set material.

Tutorials

• Arrange Tutorial: Watch Tutorial
• Text Tutorial: Watch Tutorial

DummyDoorSpawner

The DummyDoorSpawner creates visible dummy doors to counteract the visibility issues caused by the culling system.

• Showcase Video: Watch Showcase
• Straightforward Installation Tutorial: Watch Tutorial

Development / Contribute

To build the project, you just need to define the following environment variables:

• "LABAPI_PLUGINS" => "%APPDATA%\Roaming\SCP Secret Laboratory\LabAPI\plugins\global"
• "LABAPI_DEPENDENCIES" => "%APPDATA%\Roaming\SCP Secret Laboratory\LabAPI\dependencies\global"
• "SL_REFERENCES" => "\SCPSL_Data\Managed"

Where is the path to your SCPSL server folder. This is the same as "EXILED_REFERENCES" if you have developed EXILED plugins.

Note about legacy version (6/18/2025)

Legacy release

To use schematics that were created with the old AMERT version, please use the legacy release. This version should support older schematics that were created prior to this LabAPI port, and they should work on SCPSL v14.1 and LabAPI v1.0.2, aside from some limitations and bugs that exist in the port at the time of legacy release.

There are some limitations to this release that may not be compatible or function properly with the current version of SCPSL. I do not plan on supporting the legacy version very much in the future. Schematics created with future versions will likely not be compatible with the legacy plugin in future versions, and schematics created with the legacy version will likely not be compatible with the future plugin versions.

More information about converting legacy schematics to the future versions will come soon. Hopefully soon I can create a PowerShell script that will update schematics to be compatible with future versions.

Known limitations:

• HealthObjects do not detect shooting events
• Probably others :)