SERVER EXPORTS

Generate Phone Number

Generates a new, unique, random phone number formatted according to the server's configuration.

local newNumber = exports["17mov_Phone"]:GeneratePhoneNumber()

Returns:

• string: The generated phone number.

Get Identifier From Number

Retrieves the player identifier (license) associated with a specific phone number. This function works even if the player is offline, as it checks the database.

local identifier = exports["17mov_Phone"]:GetIdentifierFromNumber(number)

Returns:

• string: The identifier assigned to the given phone number.

Argument	Type	Optional	Explanation
number	number | string	❌	A target phone number

Get Number From Player

Retrieves the phone number currently active on a player's device using their Server ID (Source).

local phoneNumber = exports["17mov_Phone"]:GetNumberFromPlayer(src)

Returns:

• string: The active phone number of the player.

Argument	Type	Optional	Explanation
src	number	❌	The player's server ID (source).

Get Player Source From Number

Retrieves the Server ID (Source) of an online player currently using the specified phone number.

local src = exports["17mov_Phone"]:GetPlayerSrcFromActiveNumber(number)

Returns:

• number | nil: The player's server ID if they are online and using the number, otherwise nil.

Argument	Type	Optional	Explanation
number	number | string	❌	A target phone number

Set Phone Block State

Blocks or unblocks a player from using their phone. When blocked, the player cannot open the phone interface. This is useful for situations like being handcuffed, unconscious, or in a restricted zone.

exports["17mov_Phone"]:SetPlayerPhoneBlockState(src, state)

Argument	Type	Optional	Explanation
src	number	❌	The player's server ID (source).
state	boolean	❌	true to block the phone, false to unblock.

Change User Password

Changes the user password for a specific application account (e.g., Darkchat, Swiply). This is useful for "forgot password" mechanics or admin tools.

local success = exports["17mov_Phone"]:ChangeUserPassword(app, username, newPassword)

Returns:

• boolean: true if the password was changed successfully.

Argument	Type	Optional	Explanation
app	string	❌	The internal name of the app (e.g., "darkchat", "swiply").
username	string	❌	The username of the account.
newPassword	string	❌	The new password to set.

Send Notification (By Source)

Sends a notification to a player using their Server ID (Source).

exports["17mov_Phone"]:SendNotificationToSrc(src, notification)

Argument	Type	Optional	Explanation
src	number	❌	The player's server ID (source).
notification	Notification	❌	The notification data object.

Notification Structure

{
    app = "MESSAGES", -- App identifier (e.g., "MESSAGES", "BANK", "SYSTEM")
    title = "New Alert", -- Title string or ReplaceType object
    message = "This is a test notification", -- Message string or ReplaceType object
    data = {
        href = "/messages/1", -- (Optional) Internal link to open on click
        alwaysShow = true -- (Optional) Show even if app is open
    }
}

ReplaceType Structure (Localization)

Use this structure if you want to use localized strings with dynamic replacements.

{
    key = "LocaleKey", -- e.g., "Messages:NewMessage"
    replace = "%s", -- Placeholder to replace
    value = "John Doe" -- Value to insert
}

Send Notification (By Number)

Sends a notification to a player using their phone number.

exports["17mov_Phone"]:SendNotificationToNumber(number, notification)

Argument	Type	Optional	Explanation
number	string	❌	The target phone number.
notification	Notification	❌	The notification data object (same structure as above).

GetSignalTowers

Returns a table with all Signal Towers from config

exports["17mov_Phone"]:GetSignalTowers()

Returns:

• {coords: vector3, radius: number}[]

GetSignalLevelForCoords

Returns a 0-4 value that represent signal strenght for given coordinates

exports["17mov_Phone"]:GetSignalLevelForCoords(coords)

Argument	Type	Optional	Explanation
coords	vector3	❌	Coords to check signal

Returns:

• number (0-4)

GetPlayerSignalLevel

Returns a current player signal strenght

exports["17mov_Phone"]:GetPlayerSignalLevel(playerId)

Argument	Type	Optional	Explanation
playerId	number	❌	Player ID to check

Returns:

• number (0-4)

AddSimcard

Adding a given player simcard with given number.

exports["17mov_Phone"]:fmcard(playerId, number)

Argument	Type	Optional	Explanation
playerId	number	❌	Player ID to Give
number	string	✅	What number should be assigned. If no number is given then script will generate random

Returns:

• boolean true if sucess

EjectSimCard

Eject simcard with given number, or if no number is given, then current phone will be ejected

exports["17mov_Phone"]:fmcard(playerId, number)

Returns:

• boolean true if sucess

Argument	Type	Optional	Explanation
playerId	number	❌	Player ID to Eject
number	string	✅	What number should be ejected. If no number is given, then current phone number will eject.