Developer API

Client Exports#

For your own scripts. Most servers never need these.

Open Studio#

Opens the studio, optionally on a specific tool.

exports['qs-mlocreator']:OpenStudio()
exports['qs-mlocreator']:OpenStudio('mlo_editor')

Parameters

Tool ids

The player still has to be an admin. OpenStudio does nothing for anyone else — it is not a way to grant access.

Close Studio#

Closes the studio.

exports['qs-mlocreator']:CloseStudio()

Is Studio Open#

Returns whether the studio is currently open.

local open = exports['qs-mlocreator']:IsStudioOpen()

Returns

boolean

Server Exports#

Is Build Running#

Returns whether a map build is in progress.

local busy = exports['qs-mlocreator']:IsBuildRunning()

Returns

boolean

Useful to block restarts or teleports during a build — both are things players should never do while one is running.

Events#

Nothing Else Is Public#

Events starting with mlocreator: are internal and may change between versions.

Do not hook them. The exports above are the entire public surface.

Integration Examples#

Open A Specific Tool From Your Own Menu#

exports['qs-mlocreator']:OpenStudio('collision_cut')

Avoid Opening It Twice#

if not exports['qs-mlocreator']:IsStudioOpen() then
    exports['qs-mlocreator']:OpenStudio()
end

Block A Restart While A Build Runs#

if exports['qs-mlocreator']:IsBuildRunning() then
    print('A map build is running — try again in a moment')
    return
end

Block A Teleport During A Build#

RegisterCommand('tp', function(source)
    if exports['qs-mlocreator']:IsBuildRunning() then
        -- tell the player to wait
        return
    end

    -- your teleport logic
end)