SUMMER STARTS WITH 10% OFF | CODE: SUMMER10 SUMMER STARTS WITH 10% OFF | CODE: SUMMER10 SUMMER STARTS WITH 10% OFF | CODE: SUMMER10 SUMMER STARTS WITH 10% OFF | CODE: SUMMER10 SUMMER STARTS WITH 10% OFF | CODE: SUMMER10 SUMMER STARTS WITH 10% OFF | CODE: SUMMER10

Burner Phone Documentation

This guide explains how to install and configure Tdev Burner Phone for your FiveM server.

Compatibility

  • ESX Legacy
  • QBCore
  • Qbox
  • Ox Core
  • ND Core
  • Standalone mode
  • Custom framework adapter
  • ox_inventory

Requirements

  • ESX Legacy, QBCore, Qbox, Ox Core, ND Core, standalone, or custom framework setup
  • Framework resource if you use a framework mode
  • ox_lib required
  • ox_inventory required
  • oxmysql recommended because ox_inventory normally depends on it
  • pma-voice optional for Contact app voice calls
  • ox_target optional for gang tax withdrawal targets
  • OneSync recommended for stable networked NPC behavior

Installation

  • Download the resource from your Tebex purchases.
  • Extract the folder.
  • Place the tdev_burnerphone folder inside your server resources folder.
  • Start your framework before the resource.
  • Start ox_lib before the resource.
  • Start ox_inventory before the resource.
  • Start pma-voice before the resource if you use the Contact app call voice feature.
  • Start ox_target before the resource if you use target-based gang tax withdrawal points.
  • Open the config.lua file.
  • Select your framework or leave it on auto detection.
  • Configure the burner phone item name.
  • Add the burner phone item to ox_inventory.
  • Add all configured drug items to ox_inventory.
  • Configure sale rewards, reward accounts, and payout items.
  • Configure Lined Up and Crowd NPC settings.
  • Configure TrapStar leaderboard settings.
  • Configure TrapZones, admin permissions, zone radius limits, and gang tax settings.
  • Configure MoveIt pickup spots, drop-off spots, minimum rank, payouts, and cooldowns.
  • Configure Contact app settings, ringtone distance, and pma-voice support.
  • Configure police jobs, alert messages, blips, and tracking durations.
  • Replace html/logo.png if you want to use your own menu logo.
  • Replace html/ringtones/burner.mp3 if you want to use your own ringtone.
  • Add the resource to your server.cfg.
  • Restart your server or run refresh followed by ensure tdev_burnerphone.
  • Test the burner phone, Lined Up, Crowd, TrapStar, TrapZones, MoveIt, Contact calls, police alerts, and gang tax withdrawals.

Server CFG Example

ESX Example:

ensure oxmysql

ensure es_extended

ensure ox_lib

ensure ox_inventory

ensure pma-voice

ensure ox_target

ensure tdev_burnerphone

QBCore Example:

ensure qb-core

ensure ox_lib

ensure ox_inventory

ensure pma-voice

ensure ox_target

ensure tdev_burnerphone

Configuration

  • Set Config.Framework to auto, esx, qb, qbx, ox, nd, standalone, or custom.
  • Set Config.BurnerPhone.item to the ox_inventory item used to open the phone.
  • Set Config.BurnerPhone.requireItem to true if players must own the burner phone item.
  • Use the ox_inventory client export tdev_burnerphone.openBurnerPhone on the burner phone item.
  • Configure Config.Drugs for every sellable drug item, label, prop, quantity, price, refusal chance, and negotiation settings.
  • Configure Config.NpcMovement for custom maps, MLO areas, retasking, cleanup distance, and stuck handling.
  • Keep Config.NpcMovement.forceThroughCustomMaps enabled if your server uses custom maps.
  • Configure Config.TrapStar for leaderboard, XP, levels, daily, weekly, and overall ranking.
  • Configure Config.TrapZones for admin permissions, zone radius, gang tax, and withdrawal points.
  • Configure Config.MoveIt for minimum TrapStar level, route distance, pickup spots, drop-off spots, payout range, and police tracking.
  • Configure Config.Contacts for phone numbers, max contacts, share distance, call timeout, ringtone distance, cooldowns, and pma-voice support.
  • Configure Config.PoliceAlert for police jobs, alert messages, UI duration, blip duration, blip sprite, blip scale, and blip colors.
  • Configure Config.Robbery for robbery chance, challenge time, shooting delay, and stolen drug behavior.
  • Edit server/bridge/custom.lua only when using a custom framework.
  • Keep transaction, reward, contact, police, MoveIt, and gang tax logic server-side.

Apps Included

  • Lined Up
  • Crowd
  • MoveIt
  • Zones
  • TrapStar
  • Contact
  • Hang Up

Phone System

  • Players open the system by using the configured burner phone item.
  • The old-school phone UI includes all apps inside the phone screen.
  • Players can move while the phone is open.
  • Phone actions use phone props and animations.
  • Lined Up starts an organized NPC buyer line.
  • Crowd starts NPC buyers around the player and sends them forward one at a time.
  • Hang Up stops the active trap session and releases remaining NPCs.
  • Sessions, buyer tokens, sale attempts, rewards, gang tax, refusals, robberies, and cooldowns are handled server-side.

TrapStar and TrapZones

  • TrapStar tracks player sales, XP, levels, and leaderboard rank.
  • TrapStar includes overall, weekly, and daily filters.
  • TrapStar supports external profile picture URLs.
  • TrapZones lets regular players view zones on the map.
  • TrapZones lets admins create, edit, delete, and manage trap zones.
  • TrapZones supports owned zones, members, gang tax balances, and withdrawal points.
  • Use add_ace group.admin tdevtrap.admin allow for ACE-based admin access.
  • Zone and leaderboard data is saved server-side in data/trap_data.json.

MoveIt and Contact

  • MoveIt creates random delivery routes with pickup and drop-off NPCs.
  • MoveIt requires the configured minimum TrapStar level.
  • MoveIt gives the player a package and pays them after the drop-off.
  • MoveIt supports configurable payout range, reward account, cooldown, and route distance.
  • MoveIt sends a live police tracking blip while the package is moving.
  • Contact gives each player a burner number.
  • Contact supports My Number, Share Nearby, Contacts, and Airplane mode.
  • Contacts can be called, blocked, unblocked, and removed.
  • Incoming calls ring the phone and can be answered or declined inside the phone UI.
  • Contact voice calls use pma-voice call channels when enabled.
  • Contact data is saved server-side in data/contacts_data.json.

Security

  • Do not move sale logic client-side.
  • Do not move reward logic client-side.
  • Do not move gang tax logic client-side.
  • Do not move MoveIt payout logic client-side.
  • Do not trust client-sent prices, items, payouts, drug names, buyer tokens, coordinates, zones, contacts, call IDs, or reward accounts.
  • Keep server-side session validation enabled on production servers.
  • Keep server-side buyer token validation enabled on production servers.
  • Keep server-side inventory checks and rollback protection enabled on production servers.
  • Use Config.Logging for sale logs, warning logs, and exploit logs.
  • Keep data files backed up before updates.

Anticheat Whitelist

If your anticheat blocks custom resource events, whitelist the Tdev Burner Phone events from the README.

Important server events include tdev_trap:rpc:startSession, tdev_trap:rpc:stopSession, tdev_trap:rpc:registerBuyer, tdev_trap:rpc:buyerLeft, tdev_trap:rpc:attemptSale, tdev_trap:rpc:moveitStart, tdev_trap:rpc:moveitPickup, tdev_trap:rpc:moveitComplete, tdev_trap:moveit:update, tdev_trap:moveit:cancel, tdev_trap:rpc:taxZones, tdev_trap:rpc:withdrawGangTax, tdev_trap:ui:leaderboard, tdev_trap:ui:zones, tdev_trap:ui:contacts, and tdev_trap:robbery:resolve.

Important client events include tdev_trap:rpcResponse, tdev_trap:uiResponse, tdev_trap:openBurnerPhone, tdev_trap:contacts:callUpdate, tdev_trap:contacts:ringtone, tdev_trap:contacts:shared, tdev_trap:police:alert, tdev_trap:police:trackStart, tdev_trap:police:trackUpdate, tdev_trap:police:trackStop, tdev_trap:tax:refresh, and tdev_trap:robberyResolved.

Common Issues

Burner phone does not open: Check that the ox_inventory item exists and that the client export is tdev_burnerphone.openBurnerPhone.

Player cannot start trapping: Check Config.BurnerPhone.requireItem and make sure the player has the configured burner phone item.

No buyers spawn: Check that the player has sellable configured drug items and that ox_inventory is started.

Sales fail: Check that every Config.Drugs item exists in ox_inventory and that reward items or accounts are valid.

NPCs struggle on custom maps: Keep Config.NpcMovement.forceThroughCustomMaps enabled and adjust retask or cleanup settings if needed.

TrapStar menu does not open: Check the /trapstar command, NUI errors, and server console errors.

TrapZones admin panel does not show: Check Config.TrapZones.adminAce, Config.TrapZones.adminGroups, and ACE permissions.

Gang tax withdrawal does not appear: Check Config.TrapZones.taxWithdrawEnabled, ox_target ensure order, marker fallback settings, and zone withdrawal coordinates.

MoveIt does not start: Check Config.MoveIt.enabled, Config.MoveIt.minTrapStarLevel, pickup spots, drop-off spots, payout settings, and cooldown.

Police alerts do not appear: Check Config.PoliceAlert.enabled, police job names, player job data, and client blip settings.

Contact calls do not connect voice: Check that pma-voice is started and Config.Contacts.voice.enabled is true.

Ringtone does not play: Replace html/ringtones/burner.mp3 with a valid MP3 file and restart the resource.

Contacts are not saving: Check that the resource can write to data/contacts_data.json.

Trap zone data is not saving: Check that the resource can write to data/trap_data.json.

Support

If you need help, open a support ticket in the Tdev Scripts Discord.

Provide your order ID, script name, framework, inventory, full F8 error, server console error, and a screenshot or video.

Support is only available for verified customers.

Support is not provided for leaked, resold, or heavily modified versions.

Discord: https://discord.gg/5MYzXemM4q