Retro Hidden Mic

This section covers exports, events, usable items, and integration points for developers. The framework, notification, progress bar, and target bridges all live in the open framework/ folder, so you can adapt them without touching escrowed code.

How Players Use It

The script is driven entirely by inventory items and target interactions - there are no chat commands by default.

Action	Trigger
Plant a room bug	Use the `room_bug` item, then place it on a surface
Plant a wearable wire	`ox_target`/`qb-target` option on another player (requires `player_bug`)
Plant a vehicle bug	`ox_target`/`qb-target` option on a vehicle (requires `vehicle_bug`)
Deploy a jammer	Use the `bug_jammer` item
Deploy an amplifier	Use the `bug_signal_amplifier` item
Detect / remove bugs	Equip `WEAPON_DIGISCANNER`, then press the `Config.KeyRemoveBug` key
Open the wiretap panel	Target the command center point (job/grade gated)

Scanner Exports

The scanner module (client/scaner.lua) exposes exports so other resources can drive the detection UI.

-- Start the scanner UI aimed at a target position
exports[GetCurrentResourceName()]:InitializeScannerUI(targetVector, parameters)

-- Update the target while the scanner is running (used for moving bugs)
exports[GetCurrentResourceName()]:RefreshScannerData(newCoords, newBugId, isDynamicState)

-- Stop the scanner UI
exports[GetCurrentResourceName()]:HaltScanner()

-- Returns true while the scanner UI is active
local running = exports[GetCurrentResourceName()]:IsScannerRunning()

Usable Items

Each device is registered as a usable inventory item on the server via the framework bridge. Changing the item names in config/config.lua automatically re-registers them.

-- server/server.lua (registered through the framework bridge)
Framework.TS.RegisterUsableItem(Config.BugItem, function(source) ... end)         -- room_bug
Framework.TS.RegisterUsableItem(Config.BugPlayerItem, function(source) ... end)   -- player_bug
Framework.TS.RegisterUsableItem(Config.BugVehicleItem, function(source) ... end)  -- vehicle_bug
Framework.TS.RegisterUsableItem(Config.JammerSetup.Item, function(source) ... end)    -- bug_jammer
Framework.TS.RegisterUsableItem(Config.AmplifierSetup.Item, function(source) ... end) -- bug_signal_amplifier

Server Events & Callbacks

Placement and persistence run through server events (namespaced ts_podsluch_v2:) and ox_lib callbacks.

-- Placement
TriggerServerEvent('ts_podsluch_v2:server:placeBug', coords)
TriggerServerEvent('ts_podsluch_v2:server:placeBugOnPlayer', targetId)
TriggerServerEvent('ts_podsluch_v2:server:placeBugOnVehicle', netId, plate)
TriggerServerEvent('ts_podsluch_v2:server:placeJammer', coords)
TriggerServerEvent('ts_podsluch_v2:server:placeAmplifier', coords)

-- Removal
TriggerServerEvent('ts_podsluch_v2:server:removeJammer', jammerId)
TriggerServerEvent('ts_podsluch_v2:server:removeAmplifier', amplifierId)

-- Panel data, notes & rename
TriggerServerEvent('ts_podsluch_v2:server:requestBugList')
TriggerServerEvent('ts_podsluch_v2:server:saveNote', bugId, noteText)
TriggerServerEvent('ts_podsluch_v2:server:saveName', bugId, customName)
TriggerServerEvent('ts_podsluch_v2:server:startListening', bugId)

-- Pre-placement validation (ox_lib callbacks)
lib.callback.await('ts_podsluch_v2:server:canPlaceBugOnPlayer', false, targetId)
lib.callback.await('ts_podsluch_v2:server:canPlaceBugOnVehicle', false, netId)

Command Centers

Command centers are defined in config/config.lua and built into target zones in client/target.lua. Access is checked per center against the player’s job and grade.

-- client/target.lua: canInteract check (open file)
canInteract = function()
    local playerJob = Framework.TS.GetPlayerJob()
    if not playerJob then return false end
    if center.jobs then
        for jobName, minGrade in pairs(center.jobs) do
            if playerJob.name == jobName and playerJob.grade >= minGrade then
                return true
            end
        end
        return false
    end
    return true
end

Framework Bridge

If you run a non-standard framework resource name or a custom notification/progress system, adapt the open bridge files instead of the escrowed core.

File	Responsibility
`framework/main.lua`	TextUI + target abstractions, localization (`_U`)
`framework/cl-functions.lua`	Core getter, `Framework.TS.Notification`, `Framework.TS.ProgressBar`, callbacks
`framework/sv-functions.lua`	Server-side framework helpers and `RegisterUsableItem`

-- framework/cl-functions.lua
local framework = Config.Framework or 'ESX'

if framework == 'ESX' then
    Core = exports["es_extended"]:getSharedObject()
    ESX = exports["es_extended"]:getSharedObject()
elseif framework == 'QBCore' then
    Core = exports['qb-core']:GetCoreObject()
elseif framework == 'Qbox' then
    Core = exports['qbx_core']
end