Server

Crypto Exports

`AddCryptoToPlayer`

Adds cryptocurrency to a player's balance.

Location: server/crypto.lua

Parameters:

citizenid (string) - The citizenid of the player
cryptoCode (string) - The crypto code (SCRPT, GG, RACE)
amount (number) - The amount to add

Returns:

number|nil - The new balance, or nil if invalid parameters

Example:

local newBalance = exports['mad-crimetablet']:AddCryptoToPlayer('ABC12345', 'SCRPT', 100)
if newBalance then
    print("New balance: " .. newBalance)
end

`RemoveCryptoFromPlayer`

Removes cryptocurrency from a player's balance.

Location: server/crypto.lua

Parameters:

citizenid (string) - The citizenid of the player
cryptoCode (string) - The crypto code (SCRPT, GG, RACE)
amount (number) - The amount to remove

Returns:

boolean - true on success, false on failure

Example:

local success = exports['mad-crimetablet']:RemoveCryptoFromPlayer('ABC12345', 'GG', 50)
if success then
    print("Crypto removed successfully")
end

`GetPlayerCryptoBalance`

Gets a player's cryptocurrency balance.

Location: server/crypto.lua

Parameters:

citizenid (string) - The citizenid of the player
cryptoCode (string) - The crypto code (SCRPT, GG, RACE)

Returns:

number - The balance (returns 0.0 if not found or invalid)

Example:

local balance = exports['mad-crimetablet']:GetPlayerCryptoBalance('ABC12345', 'SCRPT')
print("Player has " .. balance .. " SCRPT")

Services Exports

`IsServiceInCooldown`

Checks if a service is currently in cooldown.

Location: server/services.lua

Parameters:

serviceType (string) - The service type identifier

Returns:

boolean - true if in cooldown, false otherwise
number - Remaining time in seconds (0 if not in cooldown)

Example:

local inCooldown, remainingTime = exports['mad-crimetablet']:IsServiceInCooldown('beach_mission')
if inCooldown then
    print("Service in cooldown. Remaining: " .. remainingTime .. " seconds")
end

`StartServiceCooldown`

Starts a cooldown period for a service.

Location: server/services.lua

Parameters:

serviceType (string) - The service type identifier

Returns:

boolean - true on success, false if service doesn't exist

Example:

local success = exports['mad-crimetablet']:StartServiceCooldown('transport_mission')

`ClearServiceCooldown`

Manually clears a service cooldown (typically for admin use).

Location: server/services.lua

Parameters:

serviceType (string) - The service type identifier

Returns:

boolean - true on success, false if service doesn't exist

Example:

local success = exports['mad-crimetablet']:ClearServiceCooldown('horde_mission')

`FormatTimeRemaining`

Formats remaining time in a human-readable format.

Location: server/services.lua

Parameters:

seconds (number) - Time in seconds to format

Returns:

string - Formatted time (e.g., "2h 30m", "45m 30s", "30s")

Example:

local formatted = exports['mad-crimetablet']:FormatTimeRemaining(3665)
-- Returns: "1h 1m 5s"

`PayForService`

Processes payment for a service.

Location: server/services.lua

Parameters:

source (number) - The player's server ID
serviceType (string) - The service type identifier

Returns:

boolean - true if payment was successful, false otherwise

Example:

local success = exports['mad-crimetablet']:PayForService(source, 'beach_mission')

`IsGroupInMission`

Checks if a group is currently in an active mission.

Location: server/services.lua

Parameters:

groupID (number) - The group ID to check

Returns:

boolean - true if group has active mission, false otherwise
string|nil - The service type if in mission, nil otherwise

Example:

local inMission, serviceType = exports['mad-crimetablet']:IsGroupInMission(123)
if inMission then
    print("Group is in mission: " .. serviceType)
end

`RegisterGroupMission`

Registers an active mission for a group.

Location: server/services.lua

Parameters:

groupID (number) - The group ID
serviceType (string) - The service type identifier
missionData (table, optional) - Additional mission data

Returns:

boolean - true on success, false if group already has active mission

Example:

local success = exports['mad-crimetablet']:RegisterGroupMission(123, 'beach_mission', {
    startLocation = vector3(0, 0, 0)
})

`UnregisterGroupMission`

Removes an active mission registration for a group.

Location: server/services.lua

Parameters:

groupID (number) - The group ID

Returns:

void

Example:

exports['mad-crimetablet']:UnregisterGroupMission(123)

`GetGroupMissionData`

Gets the active mission data for a group.

Location: server/services.lua

Parameters:

groupID (number) - The group ID

Returns:

table|nil - Mission data table or nil if no active mission

Example:

local missionData = exports['mad-crimetablet']:GetGroupMissionData(123)
if missionData then
    print("Mission type: " .. missionData.serviceType)
    print("Start time: " .. missionData.startTime)
end

Groups Exports

`FindGroupByMember`

Finds the group ID that a player belongs to.

Location: server/groups.lua

Parameters:

source (number) - The player's server ID

Returns:

number - The group ID, or 0 if player is not in a group

Example:

local groupID = exports['mad-crimetablet']:FindGroupByMember(source)
if groupID > 0 then
    print("Player is in group: " .. groupID)
end

`getGroupMembers`

Gets all members of a group.

Location: server/groups.lua

Parameters:

groupID (number) - The group ID

Returns:

table - Array of player server IDs (leader first, then helpers)

Example:

local members = exports['mad-crimetablet']:getGroupMembers(123)
for _, memberId in ipairs(members) do
    print("Member: " .. memberId)
end

`IsGroupLeader`

Checks if a player is the leader of their group.

Location: server/groups.lua

Parameters:

source (number) - The player's server ID
groupID (number) - The group ID

Returns:

boolean - true if player is the leader, false otherwise

Example:

local groupID = exports['mad-crimetablet']:FindGroupByMember(source)
if exports['mad-crimetablet']:IsGroupLeader(source, groupID) then
    print("Player is the group leader")
end

`GetGroupName`

Gets the name of a group.

Location: server/groups.lua

Parameters:

groupID (number) - The group ID

Returns:

string|nil - The group name, or nil if group doesn't exist

Example:

local groupName = exports['mad-crimetablet']:GetGroupName(123)
if groupName then
    print("Group name: " .. groupName)
end

`CreateBlipForGroup`

Creates a blip for all members of a group.

Location: server/groups.lua

Parameters:

groupID (number) - The group ID
name (string) - The blip name/identifier
data (table) - Blip data (sprite, color, coords, etc.)

Returns:

void

Example:

exports['mad-crimetablet']:CreateBlipForGroup(123, 'mission_target', {
    sprite = 1,
    color = 1,
    coords = vector3(100.0, 200.0, 30.0)
})

`RemoveBlipForGroup`

Removes a blip for all members of a group.

Location: server/groups.lua

Parameters:

groupID (number) - The group ID
name (string) - The blip name/identifier to remove

Returns:

void

Example:

exports['mad-crimetablet']:RemoveBlipForGroup(123, 'mission_target')

`GroupEvent`

Triggers a client event for all members of a group.

Location: server/groups.lua

Parameters:

groupID (number) - The group ID
event (string) - The event name to trigger
args (table, optional) - Arguments to pass to the event

Returns:

void

Example:

exports['mad-crimetablet']:GroupEvent(123, 'myresource:customEvent', {
    data1 = 'value1',
    data2 = 'value2'
})

Faction Exports

`IsCompetitionInPausePeriod`

Checks if the competition is currently in a pause period (between ending and restart).

Location: server/main.lua

Parameters:

None

Returns:

boolean - true if in pause period, false otherwise

Example:

local inPause = exports['mad-crimetablet']:IsCompetitionInPausePeriod()
if inPause then
    print("Competition is in pause period")
end

`GetFactionId`

Gets the faction ID for a player based on their citizenid.

Location: server/main.lua

Parameters:

citizenid (string): The citizen ID of the player.

Returns:

string|nil: The faction ID if the player belongs to a faction, or nil if they don't belong to any faction.

Example:

local factionId = exports['mad-crimetablet']:GetFactionId('ABC123')
if factionId then
    print("Player belongs to faction: " .. factionId)
end

`AddFactionReputation`

Adds reputation to a faction, with automatic zone radius updates and competition pause period checks.

Location: server/main.lua

Parameters:

factionId (string): The faction ID to add reputation to.
amount (number): The amount of reputation to add (can be negative to remove reputation).

Returns:

boolean: Returns true on success, false on failure (faction not found, competition in pause period, or invalid parameters).

Example:

local success = exports['mad-crimetablet']:AddFactionReputation('GANG_ID', 50)
if success then
    print("Reputation added successfully!")
end

`AddFactionXP`

Adds XP to a faction, with automatic level-up handling and territory buffs.

Location: server/main.lua

Parameters:

factionId (number) - The faction ID
xpAmount (number) - The amount of XP to add
citizenid (string, optional) - The citizenid of the player who earned the XP (for buff calculation)

Returns:

boolean - true on success, false on failure
boolean - true if faction leveled up, false otherwise
number - The new faction level

Example:

local success, leveledUp, newLevel = exports['mad-crimetablet']:AddFactionXP(1, 100, 'ABC12345')
if leveledUp then
    print("Faction leveled up to level " .. newLevel)
end

Territory Exports

`GetPlayerTerritoryBuffs`

Gets all territory buffs for a player based on their faction's controlled territories.

Location: server/territories.lua

Parameters:

source (number) - The player's server ID

Returns:

table - Table with buff types as keys and values as numbers

Example:

local buffs = exports['mad-crimetablet']:GetPlayerTerritoryBuffs(source)
if buffs.mission_xp then
    print("Mission XP bonus: " .. buffs.mission_xp .. "%")
end
if buffs.mission_money then
    print("Mission money bonus: " .. buffs.mission_money .. "%")
end

Delivery Race Exports

`SetDeliveryRaceWaiting`

Sets a delivery race team as waiting.

Location: server/delivery_race_server.lua

Parameters:

teamName (string) - The team name
groupID (number) - The group ID

Returns:

void

Example:

local groupID = exports['mad-crimetablet']:FindGroupByMember(source)
exports['mad-crimetablet']:SetDeliveryRaceWaiting('Team Alpha', groupID)

`ClearDeliveryRaceWaiting`

Clears the waiting state for delivery race.

Location: server/delivery_race_server.lua

Parameters:

None

Returns:

void

Example:

exports['mad-crimetablet']:ClearDeliveryRaceWaiting()

Notes

All server exports require the resource name: exports['mad-crimetablet']:ExportName()
Client exports can be called from any client-side script
Most exports include validation and will return safe defaults (like 0 or false) on invalid input
Group-related exports work with the internal group system and require valid group IDs
Crypto exports validate crypto codes against the configuration (SCRPT, GG, RACE)
Service cooldowns are global and affect all players
Territory buffs are calculated based on the player's faction's controlled territories

Support

For issues or questions, please refer to the main documentation or contact support.

PreviousClient Next📔Tablet

Last updated 20 days ago