FiveM-Handy oder Tablet: Welches Geräteskript passt zu deinem Server?

Warum zwei Geräte statt einem?

Als wir Agency Phone zum ersten Mal veröffentlicht haben, wurde es schnell zum beliebtesten Ingame-Telefon auf Hunderten von FiveM-Servern. Doch als Serverbesitzer begannen, komplexere Roleplay-Ökosysteme aufzubauen, kam immer wieder derselbe Wunsch auf: Spieler wollten einen größeren Bildschirm für Aufgaben wie das Durchsuchen des MDT, die Verwaltung von Unternehmen oder das Prüfen von Dokumenten während des Roleplays. Genau deshalb haben wir Agency Pad entwickelt. Statt alle Funktionen in eine einzige Telefonoberfläche zu packen, haben wir das Erlebnis auf zwei speziell dafür ausgelegte Geräte aufgeteilt. Das Telefon eignet sich für schnelle Interaktionen unterwegs, etwa Anrufe, SMS und Benachrichtigungen. Das Pad bietet dagegen ein vollwertiges Tablet-Erlebnis für datenintensive Aufgaben. In diesem Artikel erfährst du genau, wann du welches Gerät verwenden solltest und wie sie sich auf deinem Server ergänzen.

Bildschirmfläche und UI-Layout

Der offensichtlichste Unterschied zwischen Agency Phone und Agency Pad ist die Bildschirmgröße. Agency Phone verwendet ein kompaktes, an Mobilgeräte angelehntes Anzeigefenster von ungefähr 360x640 Pixeln, das in der Ecke des Spielerbildschirms Platz findet, ohne das Gameplay zu verdecken. Agency Pad öffnet dagegen ein tabletgroßes Anzeigefenster von etwa 800x600 Pixeln. Es nimmt mehr Bildschirmfläche ein, bietet dafür aber deutlich mehr nutzbaren Platz. Das ist wichtig, wenn du Apps mit Tabellen, Formularen oder Karten entwickelst. Eine Kontakte-App im Telefonformat funktioniert problemlos. Versuch aber einmal, ein vollständiges Polizei-MDT mit Verdächtigenakten, Haftbefehlen und Beweisfotos auf einer 360 Pixel breiten Fläche unterzubringen, und der Platz wird schnell knapp. So kannst du erkennen, auf welchem Gerät deine App läuft, und das Layout entsprechend anpassen:

-- client.lua: Detecting active device
local activeDevice = nil

RegisterNetEvent('agency:phone:opened', function()
    activeDevice = 'phone'
    SendNUIMessage({ action = 'setDevice', device = 'phone' })
end)

RegisterNetEvent('agency:pad:opened', function()
    activeDevice = 'pad'
    SendNUIMessage({ action = 'setDevice', device = 'pad' })
end)

-- In your NUI JavaScript
window.addEventListener('message', (e) => {
    if (e.data.action === 'setDevice') {
        document.body.classList.toggle('device-phone', e.data.device === 'phone')
        document.body.classList.toggle('device-pad', e.data.device === 'pad')
    }
})

Funktionsvergleich auf einen Blick

Beide Geräte verwenden ein gemeinsames App-Framework. Das bedeutet, dass jede App, die du entwickelst, technisch auf beiden Geräten laufen kann. Bestimmte Funktionen sind jedoch jeweils für eines der Geräte optimiert. Agency Phone eignet sich besonders für Anrufe und Sprachchat-Integration, SMS und Nachrichten, schnelle Benachrichtigungen, Kamera und Fotogalerie, Kontaktverwaltung , und GPS-Navigation. Agency Pad eignet sich besonders für MDT und Polizeidaten, Dashboards zur Unternehmensverwaltung, Anzeigen und Bearbeiten von Dokumenten, Karten-Overlays mit mehreren Markierungen, Raster für die Inventarverwaltung , und Admin-Panels. Entscheidend ist der Unterschied zwischen Nutzungshäufigkeit und Informationsdichte. Wenn ein Spieler während des Gameplays schnell etwas nachsehen muss, gehört es aufs Telefon. Wenn er sich hinsetzen und Daten bearbeiten muss, ist das Pad die richtige Wahl.

Leistungsaspekte

Zwei gleichzeitig laufende NUI-Geräte sind für Serverbesitzer, die sich um die Client-Performance sorgen, ein häufiges Thema. Die gute Nachricht: Agency Phone und Agency Pad nutzen dieselbe optimierte Rendering-Engine. Wird ein Gerät geschlossen, wird sein NUI-Frame vollständig zerstört, statt nur ausgeblendet zu werden. Dadurch werden Speicher und GPU-Ressourcen freigegeben. Im Durchschnitt beansprucht jedes geöffnete Gerät etwa 0.01ms der Client-Framezeit, was vernachlässigbar ist. Wichtig ist, nicht beide Geräte gleichzeitig geöffnet zu haben. Unser integrierter Gerätemanager übernimmt das automatisch, indem er das Telefon schließt, wenn das Pad geöffnet wird, und umgekehrt. Wenn du eigene Integrationen entwickelst, solltest du dieses Muster beachten:

-- Ensure only one device is active at a time
local function openPad()
    if GetResourceState('agency-phone') == 'started' then
        TriggerEvent('agency:phone:close')
    end
    Wait(100) -- Allow phone NUI to clean up
    SetNuiFocus(true, true)
    SendNUIMessage({ action = 'openPad' })
end

local function openPhone()
    if GetResourceState('agency-pad') == 'started' then
        TriggerEvent('agency:pad:close')
    end
    Wait(100)
    SetNuiFocus(true, true)
    SendNUIMessage({ action = 'openPhone' })
end

Anwendungsfall: Polizei- und EMS-Server

Bei Roleplay rund um Polizei und Rettungsdienste spielt die Kombination aus Telefon und Pad ihre Stärken besonders aus. Streifenbeamte verwenden Agency Phone für den Funkverkehr, schnelle Kennzeichenabfragen über einen einfachen Befehl und Dispatch-Benachrichtigungen. Wenn sie auf der Wache ankommen oder detaillierte Arbeit erledigen müssen, holen sie Agency Pad heraus und greifen auf das vollständige MDT mit Verdächtigenprofilen, Fallakten, Haftbefehlsverwaltung und Beweismittelverfolgung zu. EMS-Spieler nutzen das Telefon für eingehende Notrufe und das Pad für Patientenakten und die Krankenhausverwaltung. Diese Aufteilung entspricht der Arbeitsweise von Rettungskräften in der realen Welt: Funkgerät und Telefon für die Kommunikation im Einsatz, Laptop oder Tablet für die detaillierte Dateneingabe. Der Ablauf fühlt sich natürlich an und sorgt für immersives Roleplay, weil Spieler je nach aktueller Aufgabe tatsächlich zwischen den Geräten wechseln.

Anwendungsfall: Wirtschafts- und Economy-Server

Auf Servern mit tiefgreifenden Wirtschaftssystemen wird das Pad zu einem unverzichtbaren Werkzeug für die Unternehmensverwaltung. Restaurantbesitzer nutzen Agency Phone, um Kundenbestellungen per schneller Textnachricht entgegenzunehmen und Lieferbenachrichtigungen zu erhalten. Agency Pad dient ihnen als Kassensystem, Inventarverwaltung und Finanz-Dashboard. Autohändler durchstöbern den Fahrzeugbestand in der großen Rasteransicht des Pads, inklusive Fotos, Preisen und Lagerbeständen, und wechseln dann zum Telefon, um potenzielle Käufer anzurufen. Immobilienmakler prüfen Immobilienangebote in der Kartenansicht des Pads und vereinbaren Besichtigungstermine über den Kalender des Telefons. Das Muster bleibt gleich: Das Telefon dient der Kommunikation und schnellen Abfragen, während das Pad für alles gedacht ist, was von einem größeren Anzeigefenster und komplexeren UI-Elementen profitiert.

Apps entwickeln, die auf beiden Geräten funktionieren

Wenn du eigene Apps entwickelst, ist ein responsives Design, das sich an das jeweilige Gerät anpasst, der beste Ansatz. Verwende CSS-Container-Queries oder einfache klassenbasierte Formatierungen, um Layouts je nach aktivem Gerät anzupassen. Halte die Kernlogik in gemeinsam genutzten JavaScript-Modulen und passe nur die UI-Ebene an. Hier ist ein praktisches Beispiel für eine responsive App-Komponente, deren Grid-Layout sich je nach Gerätekontext anpasst:

/* styles.css - Responsive app layout */
.app-grid {
    display: grid;
    gap: 0.75rem;
    padding: 1rem;
}

.device-phone .app-grid {
    grid-template-columns: 1fr;
    font-size: 0.875rem;
}

.device-pad .app-grid {
    grid-template-columns: repeat(3, 1fr);
    font-size: 1rem;
}

.device-phone .detail-panel {
    display: none; /* Hide detail panel on phone */
}

.device-pad .detail-panel {
    display: block;
    border-left: 1px solid rgba(255,255,255,0.1);
    padding-left: 1rem;
}

/* Phone: stack navigation vertically */
.device-phone .app-nav {
    display: flex;
    overflow-x: auto;
    white-space: nowrap;
}

/* Pad: sidebar navigation */
.device-pad .app-nav {
    display: flex;
    flex-direction: column;
    width: 200px;
}

Welche Variante solltest du für deinen Server kaufen?

Wenn du einen Roleplay-Server für verschiedene Zwecke betreibst und nur ein Produkt auswählen kannst, fang mit Agency Phone an. Es deckt die gängigsten Interaktionen der Spieler ab, und jeder Server braucht ein zuverlässiges Telefonsystem. Ergänze später Agency Pad, wenn dein Server um komplexere Systeme wie MDTs, Unternehmensverwaltung oder Admin-Tools erweitert wird. Wenn du von Anfang an einen ernsthaften Server mit Fokus auf Strafverfolgung oder Wirtschaft aufbaust, hol dir beide. Zusammen sorgen sie für ein deutlich immersiveres Spielerlebnis, als wenn du versuchst, alles in einem einzigen Gerät unterzubringen. Beide Produkte erhalten regelmäßig Updates und verwenden dieselbe Plugin-API. Daher kannst du eigene App-Entwicklungen nahtlos auf beiden Geräten nutzen. In unserem Store findest du Bundle-Preise, falls du dich für beide entscheidest.