Agency-Phone Apps Personalizadas

🧩 Crea una app propia para Agency-Phone

Hay dos formas de poner una app en el teléfono. Elige la que te encaje:

Si distribuyes una app a otros servidores, usa el método A. No necesita código fuente nuestro y sigue funcionando tras las actualizaciones.

A SDK: registra una app desde tu propio resource

agency-phone ofrece exports con los que cualquier resource pone en tiempo de ejecución una app con su propio icono en la pantalla de inicio del teléfono. La interfaz de tu app vive en tu propio resource; el teléfono muestra el icono y te pasa el control cuando el jugador lo toca. Sin cambios en agency-phone ni build desbloqueado.

Ejemplo mínimo

-- client side of YOUR resource
CreateThread(function()
    Wait(1500) -- let agency-phone boot
    exports['agency-phone']:RegisterApp({
        id        = 'myshop',
        label     = 'My Shop',
        icon      = 'fa-solid fa-cart-shopping', -- FontAwesome 6 class
        -- image  = 'https://cfx-nui-myresource/icon.png', -- or your own image instead
        color     = '#ff9500',
        colorDark = '#e08600',
    })
end)

-- fired when the player taps your icon on the phone
AddEventHandler('agency-phone:client:openApp', function(appId)
    if appId ~= 'myshop' then return end
    exports['agency-phone']:ClosePhone()
    -- open your own NUI here
end)

Configuración de RegisterApp

Exports del SDK (cliente)

El evento al tocar

Cuando el jugador toca tu icono, agency-phone lanza estos dos eventos en el cliente. Usa el que prefieras:

Añade dependency 'agency-phone' a tu fxmanifest.lua para que el orden de arranque sea correcto.

B Drop-in, una pantalla nativa dentro del teléfono

Para una pantalla que dibuja el propio teléfono (no tu resource). Esto modifica archivos de agency-phone.

Los pasos 3 y 4 están en archivos cifrados por el escrow, así que una pantalla nativa necesita un build con código fuente o desbloqueado. Si solo tienes la versión escrow, usa el método A (tu pantalla vive en tu propio resource). Archivos de referencia dentro del resource: apps/testapp_client.lua y apps/dispatch_client.lua.

📋 Otros exports del teléfono

Cliente

Servidor

⇄ Puente NUI ↔ Lua (método B)

💳 Cobro AgencyPay

Cobra al wallet del jugador desde cualquier resource.

exports['agency-phone']:StartAgencyPayCheckout({
    merchant = 'My Shop', title = 'Agency Pay', subtitle = 'Checkout',
    label = 'Premium Coffee', amount = 24.50,
    icon = 'fa-solid fa-mug-hot', accent = '#ff9f0a',
    clientEvent = 'myshop:client:agencyPayResult',
    serverEvent = 'myshop:server:agencyPayResult',
    metadata = { orderId = 'order_2048' },
})

RegisterNetEvent('myshop:client:agencyPayResult', function(result)
    if result.status == 'paid' then
        -- deliver the goods
    end
end)

El resultado incluye status (paid / cancelled / failed), amount, cardId, balance y tus metadata.

Un paid que llega desde el cliente a tu resource no demuestra nada por sí solo. Pasa tu propio id a StartAgencyPayCheckout y llama a exports['agency-phone']:VerifyAgencyPayCharge(source, id, amount) en el servidor antes de entregar nada. Solo devuelve true y el importe si este jugador pagó ese cobro en los últimos 60 segundos, y consume el pago para que no se pueda reclamar dos veces.

🐛 Solución de problemas

¿Dudas o necesitas ayuda? Únete al Discord de Agency Scripts.