Agency Phone v2: Neue Funktionen, Apps und mehr Leistung

Was ist neu in v2

Agency Phone v2 ist das größte Update seit der ursprünglichen Veröffentlichung. Basierend auf umfangreichem Community-Feedback und monatelanger Entwicklung bietet dieses Release eine vollständig überarbeitete Benutzeroberfläche, neue Anwendungen, eine tiefere Framework-Integration und weitere Leistungsverbesserungen. Jeder Aspekt des Handys wurde verfeinert, um Spielern ein immersiveres und hochwertigeres Erlebnis zu bieten.

Überarbeitete Benutzeroberfläche

Die Benutzeroberfläche von v2 bietet eine moderne Glassmorphism-Optik mit flüssigeren Animationen und einer verbesserten visuellen Hierarchie. Der Startbildschirm unterstützt jetzt anpassbare Hintergrundbilder und App-Symbolanordnungen, sodass Spieler ihr Handy personalisieren können. Benachrichtigungen wurden vollständig überarbeitet. Das neue Benachrichtigungscenter gruppiert Hinweise nach App und unterstützt Schnellaktionen direkt über die Benachrichtigung. Insgesamt kommt das Aussehen und die Bedienung des Handys im Spiel dem näher, was Spieler von einem echten Smartphone erwarten.

Neue Anwendungen

Mehrere neue Apps erweitern die Möglichkeiten für Spieler. Mit einer eigenen Galerie-App können Spieler Screenshots aus dem Spiel speichern und ansehen. Die Notizen-App bietet eine einfache, aber effektive Möglichkeit, während des Rollenspiels Informationen festzuhalten. Eine verbesserte Banking-App mit Transaktionsverlauf und Überweisungsfunktionen bietet ein vollständiges mobiles Banking-Erlebnis. Über die Marktplatz-App können Spieler Gegenstände zum Verkauf anbieten und so eine neue Ebene des Wirtschafts-Rollenspiels schaffen.

Leistungsverbesserungen

Obwohl Agency Phone bereits im Leerlauf einen Verbrauch von 0.00ms hatte, optimiert v2 auch die aktive Nutzung weiter. Das Laden von Apps wurde neu entwickelt und verwendet jetzt Lazy Loading. Dadurch werden die UI-Komponenten von Apps erst initialisiert, wenn sie tatsächlich geöffnet werden. Das reduziert den Speicherbedarf bei geöffnetem Handy und sorgt für einen schnelleren Wechsel zwischen Apps. Die NUI-Kommunikationsschicht wurde optimiert, um die Anzahl der Ereignisse zwischen Client und Benutzeroberfläche zu reduzieren.

Upgrade-Pfad

Bestehende Nutzer von Agency Phone können über den üblichen Tebex-Download auf v2 aktualisieren. Die Migration ist darauf ausgelegt, bestehende Daten wie Kontakte, Nachrichten und Anruflisten zu erhalten. Eine ausführliche Migrationsanleitung findest du in der Dokumentation. Das Team von Agency Scripts auf Discord hilft dir bei Fragen zum Upgrade. Wir empfehlen, das Update vor der Bereitstellung auf dem Liveserver auf einem Entwicklungsserver zu testen, um die Kompatibilität mit deinen benutzerdefinierten Konfigurationen sicherzustellen.

Installation und Einrichtung für v2

Das Upgrade von v1 auf v2 erfolgt wie ein übliches Tebex-Download-Update. Lade die neue Version aus deiner Tebex-Bibliothek herunter, ersetze den Ressourcenordner auf deinem Server und starte den Server neu. Das Migrationsskript in sql/migrate_v1_to_v2.sql übernimmt Schemaänderungen. Führe es einmal für deine bestehende Datenbank aus, bevor du die Ressource neu startest. Bestehende Kontakte, Nachrichtenverläufe und Anruflisten bleiben erhalten.

Wenn du Agency-Phone zum ersten Mal unter v2 installierst, importiere phone.sql, lege den Resource-Ordner ab und füge hinzu ensure agency-phone in server.cfg. Die Ressource erkennt QBCore oder ESX automatisch. Bei standalone-Setups implementierst du den Adapter in config.lua.

Konfigurationsoptionen in v2

Die config.lua von v2 ist vollständig rückwärtskompatibel mit v1-Konfigurationen und bietet zusätzliche Optionen für neue Funktionen:

• Wallpaper-Bibliothek, gib erlaubte Wallpaper-URLs an oder aktiviere den CDN-Endpunkt für Spieler-Uploads.
• App-Icon-Layout, Rastergröße (4x5, 4x6) und ob Spieler die Positionen der Apps ändern können.
• Verhalten des Benachrichtigungscenters, maximale Anzahl gespeicherter Benachrichtigungen, Schwellenwert zum Wegwischen und Schnellaktionsbuttons pro App.
• Galeriespeicher, Screenshot-CDN-Endpunkt und Speicherlimit pro Spieler (in MB).
• Marketplace-Einstellungen, Dauer bis zum Ablauf von Angeboten, ob Angebote eine Admin-Freigabe erfordern und Transaktionsgebühr in Prozent.
• Integration der Banking-App, verbinde sie mit QBCore-Banking, ESX-Banking oder einer benutzerdefinierten Banking-Funktion.
• Lazy Loading, welche Apps Lazy Initialization verwenden (in v2 standardmäßig alle) und ob bestimmte Apps beim Öffnen des Phones vorgeladen werden.

Framework-Kompatibilität in v2

v2 verwendet dasselbe Framework-Adapter-Muster wie v1. Wenn du den Adapter in v1 angepasst hast, bleiben deine Änderungen erhalten, die Adapter-Schnittstelle ist unverändert. Neue Apps in v2 (Galerie, Notizen, Marketplace) laufen alle über dieselben Adapterfunktionen. Für die neuen Funktionen sind keine neuen Framework-spezifischen Implementierungen erforderlich.

Warum das Redesign von v2 für Roleplay wichtig ist

Das Phone in v1 war bereits das leistungsstärkste FiveM-Phone auf dem Markt. Das Redesign von v2 geht ein anderes Problem an: die Lücke zwischen dem Aussehen des Phones und dem Gefühl, ein echtes Smartphone zu benutzen. Der überarbeitete Startbildschirm mit anpassbaren Wallpapern und verschiebbaren App-Icons ist die erste Änderung, die Spieler bemerken. Tatsächlich gibt sie Spielern aber die Möglichkeit, ihrem Phone eine persönliche Note zu verleihen. Ein Phone, das sich persönlich anfühlt, ist ein Requisit, in das Spieler als Teil ihres Charakters investieren.

Das überarbeitete Benachrichtigungscenter hat die größten praktischen Auswirkungen auf das tägliche Gameplay. In v1 wurden Benachrichtigungen als Toasts angezeigt und verschwanden wieder. In v2 sammeln sie sich in einem Center mit Schnellaktionen: Anrufe direkt über die Benachrichtigung annehmen oder ablehnen, auf Nachrichten antworten, ohne die SMS-App zu öffnen, Marketplace-Transaktionen freigeben. Weniger Aktionen erfordern das Öffnen eines Menüs. Dieser geringere Aufwand summiert sich im Laufe einer Session zu einer spürbar reibungsloseren Nutzung des Phones.

Die Marketplace-App eröffnet eine ganze wirtschaftliche Ebene, für die zuvor eine Abstimmung außerhalb des Charakters nötig war. Spieler, die anderen Spielern Items verkaufen möchten, stellen sie im Marketplace ein. Käufer können Angebote durchstöbern und kaufen, ohne das Phone zu verlassen. Verhandelt wird in DMs. Die Abholung wird per SMS koordiniert. Die gesamte Transaktion findet im Charakter statt, und genau das macht aus einer Transaktion RP.

Was sich in v2 nicht geändert hat

Die grundlegenden Leistungsmerkmale haben sich nicht geändert, weil es dafür keinen Grund gab. Die Idle-Auslastung von 0.00ms, das framework-unabhängige Adapter-Muster und die Lazy-Loading-Architektur sind das Fundament, auf dem die v2-UI aufbaut. Wir haben die neuen Apps für Galerie, Notizen und Marketplace hinzugefügt, ohne die Leistungsebene anzutasten. v2 bietet mehr Funktionen, verbraucht aber nicht mehr Ressourcen.

Die Apps für Kontakte, SMS und Anrufe wurden in v2 optisch überarbeitet, funktionieren aber unverändert. Spieler, die in v1 auf bestimmte Funktionen angewiesen waren, etwa Threads, Gruppen-SMS oder Anruflisten, finden dieselben Funktionen in v2 mit einer verbesserten visuellen Darstellung. Die Migration verläuft für etablierte Communities reibungslos, gerade weil wir nichts geändert haben, was bereits funktioniert hat.

Häufig gestellte Fragen zu v2

Kann ich auf v1 zurückwechseln, falls v2 auf meinem Server Probleme verursacht?

Ja, v1-Downloads bleiben in deiner Tebex-Bibliothek verfügbar. Dein v1-Datenbankschema ist kompatibel. Das Migrations-SQL fügt nur Tabellen hinzu und ändert keine bestehenden Tabellen. Für den Wechsel zurück musst du den Ressourcenordner von v1 wiederherstellen und die neuen Tabellen ignorieren. Nicht ideal, aber sicher, falls in den ersten Tagen nach der Bereitstellung von v2 ein kritisches Kompatibilitätsproblem auftritt.

Benötigt die Marketplace-App eine spezielle Backend-Einrichtung?

Der Marketplace verwendet die bestehende oxmysql-Datenbank. Ein zusätzliches Backend ist nicht erforderlich. Einträge werden in einer neuen phone_marketplace Tabelle gespeichert, die vom Migrations-SQL erstellt wird. Der Marketplace läuft vollständig auf dem Server und hat keine Abhängigkeiten von externen APIs.

Können Admins Marketplace-Einträge moderieren?

Ja. Aktiviere den Freigabemodus in config.lua. Neue Einträge erscheinen dann in einer Moderationswarteschlange, die über Agency-Admin oder das eigene Admin-Panel des Phones zugänglich ist. Das Admin-Panel können Spieler mit dem Admin-Flag aufrufen. Das empfiehlt sich für Server, auf denen Spieler möglicherweise verbotene Gegenstände anbieten oder über den Marketplace Einschränkungen der Ingame-Wirtschaft umgehen könnten.

Wird der Galeriespeicher von Charakteren desselben Kontos gemeinsam genutzt?

Standardmäßig ist der Galeriespeicher an den Charakter gebunden, nicht an das Konto. Screenshots sind dem Charakter zugeordnet, der sie aufgenommen hat. Bei Mehrcharaktersystemen, in denen Spieler Screenshots zwischen Charakteren teilen möchten, stelle Config.GalleryByAccount = true so ein, dass statt der Charakter-ID die Spieler-ID als Speicherschlüssel verwendet wird.

Voraussetzungen

• FiveM-Server (QBCore, ESX oder standalone)
• oxmysql
• cfx.re-Konto mit gültiger Agency-Phone-Lizenz
• Photo-CDN-Endpunkt für die Galerie-Funktion (optional, ohne Konfiguration werden nur URLs verwendet)