Server Creator·Eksporty

Eksporty

DS-ServerCreator exposes server-side exports that let your own resources reuse the permissions, doorlock, multijob, and robbery systems configured in the in-game panel.

Server-side exports

Call these exports from a server script. A client script cannot call them directly; trigger a secured server event in your resource when client interaction is required.

Permissions

HasPermission

server

Checks whether a player can use one configured Server Creator action. Global actions and permissions assigned to the player’s current job are both considered.

Sygnatura

Lua

exports['DS-ServerCreator']:HasPermission(playerId, permission)

Parametry

Nazwa	Typ	Opis
playerId	number	The player’s server ID.
permission	string	Permission key, such as handcuff, drag, billing, revive, or check_identity.

Zwraca

boolean

true when the action is allowed, otherwise false.

Przykład

Lua

if exports['DS-ServerCreator']:HasPermission(source, 'handcuff') then
  -- The player can use the handcuff action
end

GetPlayerPermissions

server

Returns the player’s effective permission map after merging job permissions with globally enabled actions.

Sygnatura

Lua

exports['DS-ServerCreator']:GetPlayerPermissions(playerId)

Parametry

Nazwa	Typ	Opis
playerId	number	The player’s server ID.

Zwraca

table

A table keyed by permission name. Returns an empty table when no permissions apply or the player ID is invalid.

Przykład

Lua

local permissions = exports['DS-ServerCreator']:GetPlayerPermissions(source)
if permissions.billing then
  -- Show the billing option
end

IsPlayerHandcuffed

client

Checks the local client state and returns whether the local player is currently handcuffed by Server Creator.

Sygnatura

Lua

exports['DS-ServerCreator']:IsPlayerHandcuffed()

Zwraca

boolean

true while the local player is handcuffed, otherwise false.

Przykład

Lua

if exports['DS-ServerCreator']:IsPlayerHandcuffed() then
  -- Block an action for the local cuffed player
end

IsPlayerHandcuffed

server

Checks whether a specific player is currently handcuffed by Server Creator’s built-in permission actions.

Sygnatura

Lua

exports['DS-ServerCreator']:IsPlayerHandcuffed(playerId)

Parametry

Nazwa	Typ	Opis
playerId	number	The player’s server ID.

Zwraca

boolean

true while the player is handcuffed, otherwise false.

Przykład

Lua

if exports['DS-ServerCreator']:IsPlayerHandcuffed(targetId) then
  print('The player is handcuffed')
end

Doorlocks

GetDoorState

server

Reads the authoritative live state of a built-in Server Creator doorlock.

Sygnatura

Lua

exports['DS-ServerCreator']:GetDoorState(reference)

Parametry

Nazwa	Typ	Opis
reference	number \| string	The numeric database ID or the stable door name configured in the panel.

Zwraca

string | nil, string?

locked or unlocked. If the door does not exist, returns nil followed by door_not_found.

Przykład

Lua

local state, errorCode = exports['DS-ServerCreator']:GetDoorState('bank_vault')
if state == 'locked' then
  print('The vault is locked')
end

SetDoorState

server

Sets a door’s live state, synchronizes every client, fires the configured toggle hook, and arms autolock when applicable.

Sygnatura

Lua

exports['DS-ServerCreator']:SetDoorState(reference, newState)

Parametry

Nazwa	Typ	Opis
reference	number \| string	The numeric database ID or the stable door name configured in the panel.
newState	string	The new state: locked or unlocked.

Zwraca

boolean, string

A success boolean followed by the resulting state, or an error code on failure.

Przykład

Lua

local success, stateOrError = exports['DS-ServerCreator']:SetDoorState('bank_vault', 'unlocked')

ToggleDoor

server

Switches a door between locked and unlocked using the same authoritative synchronization as normal interactions.

Sygnatura

Lua

exports['DS-ServerCreator']:ToggleDoor(reference)

Parametry

Nazwa	Typ	Opis
reference	number \| string	The numeric database ID or the stable door name configured in the panel.

Zwraca

boolean, string

A success boolean followed by the resulting state, or an error code on failure.

Przykład

Lua

local success, stateOrError = exports['DS-ServerCreator']:ToggleDoor('bank_vault')

Multijob

GetPlayerJobs

server

Returns every job held by a player, enriched with job and grade labels. Offline lookups are supported when you pass an identifier.

Sygnatura

Lua

exports['DS-ServerCreator']:GetPlayerJobs(player)

Parametry

Nazwa	Typ	Opis
player	number \| string	An online player server ID, or a framework identifier for an offline lookup.

Zwraca

table

An array containing job_name, job_grade, is_active, job_label, and grade_label.

Przykład

Lua

local jobs = exports['DS-ServerCreator']:GetPlayerJobs(source)
for _, job in ipairs(jobs) do
  print(job.job_name, job.job_grade, job.is_active)
end

HasPlayerJob

server

Checks whether a player holds a job, optionally requiring a minimum grade.

Sygnatura

Lua

exports['DS-ServerCreator']:HasPlayerJob(player, jobName, minimumGrade)

Parametry

Nazwa	Typ	Opis
player	number \| string	An online player server ID, or a framework identifier for an offline lookup.
jobName	string	The internal job name, for example police.
minimumGrade?	number	Optional minimum grade. Omit it to accept any grade for the job.

Zwraca

boolean

true when the player holds the requested job and meets the grade requirement.

Przykład

Lua

if exports['DS-ServerCreator']:HasPlayerJob(source, 'police', 2) then
  -- The player holds police grade 2 or higher
end

Robberies

GetRobberies

server

Returns all robbery definitions using the same client-safe schema sent to regular players.

Sygnatura

Lua

exports['DS-ServerCreator']:GetRobberies()

Zwraca

table

An array of sanitized robbery definitions, including public steps, markers, blips, and sounds.

Przykład

Lua

local robberies = exports['DS-ServerCreator']:GetRobberies()
for _, robbery in ipairs(robberies) do
  print(robbery.id, robbery.name, robbery.enabled)
end

IsRobberyActive

server

Checks whether a robbery currently has an active runtime session.

Sygnatura

Lua

exports['DS-ServerCreator']:IsRobberyActive(robberyId)

Parametry

Nazwa	Typ	Opis
robberyId	number	The numeric robbery ID shown in the Server Creator panel.

Zwraca

boolean

true while the robbery is reserved or in progress, otherwise false.

Przykład

Lua

if exports['DS-ServerCreator']:IsRobberyActive(1) then
  print('Robbery #1 is in progress')
end

GetRobberyState

server

Returns the public live state of one robbery, including its state, current step, participant count, looted props, and remaining cooldown.

Sygnatura

Lua

exports['DS-ServerCreator']:GetRobberyState(robberyId)

Parametry

Nazwa	Typ	Opis
robberyId	number	The numeric robbery ID shown in the Server Creator panel.

Zwraca

table | nil

The live-state table, or nil when the robbery ID does not exist.

Przykład

Lua

local state = exports['DS-ServerCreator']:GetRobberyState(1)
if state then
  print(state.state, state.currentStep, state.cooldownRemaining)
end

Sensitive data stays private

GetRobberies never exposes keypad codes, reward tables, alert chances, or other server-only values. Returned tables are copies, so changing them cannot modify Server Creator’s internal state.

PoprzednieServer Creator · Instalacja NastępneDeath · Instalacja

Nadal nie działa?

Załóż ticket na naszym Discordzie, a pomożemy ci.

Dołącz na Discord →