Agency-Phone Custom Apps

🧩 Eine eigene App für das Agency-Phone bauen

Es gibt zwei Wege, eine App auf das Phone zu bringen. Nimm den, der zu dir passt:

Wenn du eine App an andere Server auslieferst, nimm Weg A. Er braucht keinen Quelltext von uns und funktioniert auch nach Updates weiter.

A SDK: eine App aus der eigenen Resource anmelden

agency-phone stellt Exports bereit, mit denen jede Resource zur Laufzeit eine App mit eigenem Icon auf den Startbildschirm des Phones bringt. Die Oberfläche deiner App liegt in deiner eigenen Resource; das Phone zeigt das Icon und übergibt dir die Kontrolle, sobald der Spieler es antippt. Keine Änderung an agency-phone, kein freigeschalteter Build.

Minimalbeispiel

-- 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)

Konfiguration von RegisterApp

SDK-Exports (Client)

Das Antipp-Event

Tippt der Spieler auf dein Icon, löst agency-phone beide Events auf dem Client aus. Nimm das, was dir lieber ist:

Trag dependency 'agency-phone' in deine fxmanifest.lua ein, damit die Startreihenfolge stimmt.

B Drop-in, ein nativer Bildschirm im Phone

Für einen Bildschirm, den das Phone selbst zeichnet (nicht deine Resource). Dabei werden Dateien von agency-phone geändert.

Schritt 3 und 4 liegen in Dateien, die Escrow verschlüsselt, ein nativer Bildschirm braucht also einen Build mit Quelltext bzw. einen freigeschalteten Build. Hast du nur die Escrow-Version, nimm stattdessen Weg A (dein Bildschirm liegt dann in deiner eigenen Resource). Beispieldateien in der Resource: apps/testapp_client.lua und apps/dispatch_client.lua.

📋 Weitere Exports des Phones

Client

Server

⇄ Brücke zwischen NUI und Lua (Weg B)

💳 AgencyPay-Kasse

Belaste die Wallet des Spielers aus jeder beliebigen 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)

Das Ergebnis enthält status (paid / cancelled / failed), amount, cardId, balance und deine metadata.

Ein paid, das vom Client bei deiner Resource ankommt, beweist für sich allein nichts. Gib StartAgencyPayCheckout eine eigene id mit und ruf auf dem Server exports['agency-phone']:VerifyAgencyPayCharge(source, id, amount) auf, bevor du etwas herausgibst. Das liefert true und den Betrag nur, wenn dieser Spieler genau diese Kasse in den letzten 60 Sekunden bezahlt hat, und verbraucht die Zahlung, damit dieselbe Zahlung nicht zweimal eingelöst werden kann.

🐛 Fehlersuche

Fragen oder Hilfe nötig? Komm in den Discord von Agency Scripts.