SBF Phone Installation Guide

Requirements

System Requirements

  • FiveM Server
  • ESX or QB-Core Framework
  • MySQL Database
  • Voice System: PMA-Voice or SaltyChat

Compatible Frameworks

ESX QB-Core

Discord Verification Required

This script requires Discord verification. You must be a member of our Discord server and configure your Discord User ID in the config file.

Join Discord Server

Installation

1 Download & Extract

Extract the sbf_phone folder to your server's resources directory:

Place in: server-data/resources/[phone]/sbf_phone

2 Database Setup

Import the provided SQL file into your database:

Database file: sbf_phone/installation/database.sql

3 Discord User ID Configuration

Open sbf_phone/shared/config.lua and enter your Discord User ID: 

Config.DiscordUserId = "YOUR_DISCORD_USER_ID"

Important: You must be a member of our Discord server. Join at: discord.gg/pBuYB5ndZm

4 Item Configuration

Add the phone item to your ESX items database or items.lua: 

-- SQL Database
INSERT INTO `items` (`name`, `label`, `weight`) VALUES ('sbfphone', 'SBF Phone', 1);

-- Or in items.lua
['sbfphone'] = {
    label = 'SBF Phone',
    weight = 1,
    stack = false,
    close = true,
    description = 'A modern smartphone'
}

5 Server Configuration

Add the resource to your server.cfg: 

ensure sbf_phone

Configuration

Basic Settings 

-- Discord Verification (REQUIRED!)
Config.DiscordUserId = "YOUR_DISCORD_USER_ID"

-- Timezone
Config.Timezone = 'Europe/Berlin'

-- Phone Item Name
Config.PhoneItem = 'sbfphone'

-- Voice System
Config.VoiceSystem = 'pma-voice' -- 'pma-voice' or 'saltychat'

-- Sync with SBF Tablet
Config.SBFTabletSync = true

Key Mapping Configuration 

-- Phone Open/Close Key
Config.KeyMapping = {
    commandName = 'open_phone',
    description = 'Open Phone',
    inputGroup = 'keyboard',
    defaultKey = 'F1'
}

-- Phone Peek/Focus Toggle
Config.PeekKeyMapping = {
    commandName = 'sbf_phone_peek',
    description = 'SBF Phone Peek/Focus Toggle',
    inputGroup = 'keyboard',
    defaultKey = 'LMENU' -- Left ALT
}

Radio Configuration 

Config.Radio = {
    VoiceSystem = 'pma-voice',
    MinFrequency = 1,
    MaxFrequency = 999,
    DisconnectOnDeath = true,
    ReservedFrequencies = {
        {min = 1, max = 50, jobs = {'police'}},
        {min = 51, max = 100, jobs = {'ambulance'}},
        {min = 101, max = 150, jobs = {'mechanic'}},
    },
    DefaultVolume = 50,
    PMAVoice = {
        RadioEffect = true,
        RadioClicks = true
    },
}

Exports

Service Dispatch Exports

The SBF Phone includes export functions for creating service dispatches from other scripts. 

-- Example: Creating a service dispatch
local result = exports.sbf_phone:createServiceChat('police')

if result and result.success then
    exports.sbf_phone:sendServiceMessage(result.chat.id, "Emergency!")
    
    local coords = GetEntityCoords(PlayerPedId())
    exports.sbf_phone:sendServiceCoordinates(result.chat.id, {
        x = coords.x,
        y = coords.y
    }, "location")
end

Phone Number System 

-- Get a player's phone number
local phoneNumber = exports.sbf_phone:getPhoneNumber(source)

if phoneNumber then
    print("Player phone number: " .. phoneNumber)
end

Support

Need Help?

If you encounter any issues during installation or have questions about the script, please don't hesitate to contact the support team.

Discord Support Video Tutorials