Erste Schritte mit Agency Phone
Agency Phone ist ein Premium-Phone-Script, das für FiveM-Roleplay-Server entwickelt wurde, auf denen QBCore, ESX oder eigenständige Frameworks ausgeführt werden. Diese Anleitung führt du durch den gesamten Installationsprozess, vom Herunterladen der Ressource bis zur Konfiguration für dein spezifisches Server-Setup. Egal, ob du ein erfahrener Entwickler sind oder deinen ersten Server einrichten, mit diesen Schritten läuft Agency Phone reibungslos.
Voraussetzungen
Stelle vor Beginn der Installation sicher, dass dein Server die folgenden Anforderungen erfüllt. Du benötigst einen laufenden FiveM-Server mit entweder QBCore, ESX oder einem benutzerdefinierten Framework. Auf deinem Server sollten die neuesten empfohlenen FiveM-Artefakte ausgeführt werden, und du benötigst Zugriff auf deine Serverdateien über FTP oder direkte Dateiverwaltung. Stelle außerdem sicher, dass du über eine gültige Lizenz aus dem Agency Scripts Tebex Store verfügen.
Schritt 1: Herunterladen und extrahieren
Nachdem du Agency Phone im Tebex Store gekauft haben, lade die Ressourcendateien von deinem Keymaster-Konto herunter. Extrahiere das Archiv und legst du den Ordner agency-phone in deinem Serverressourcenverzeichnis ab. Die Ordnerstruktur sollte wie folgt aussehen: resources/[phone]/agency-phone/, du kannst sie jedoch in jedem beliebigen Unterordner platzieren.
Schritt 2: Konfiguriere dein Framework
Öffne die Datei config.lua im Ordner „agency-phone“. Lege dein Framework fest, indem du dest Wert von Config.Framework entweder in "qbcore", "esx" oder "standalone" ändern. Agency Phone erkennt die meisten Framework-Einstellungen automatisch. Möglicherweise möchtest du jedoch Benachrichtigungsstile, Standard-Apps und Telefonnummernformate anpassen, um sie an dein Serverdesign anzupassen.
Schritt 3: Datenbank einrichten und starten
Importiere die bereitgestellte SQL-Datei in deine Datenbank, um die erforderlichen Tabellen für Kontakte, Nachrichten und Anrufprotokolle zu erstellen. Füge dann ensure Agency-phone zu deiner server.cfg-Datei hinzu. Starte deinen Server neu und teste das Telefon, indem du die konfigurierte Taste drücken (Standard ist F1). Das Telefon sollte sich mit einer flüssigen Animation öffnen und den Startbildschirm mit allen einsatzbereiten Standard-Apps anzeigen.
Beheben häufiger Probleme
Wenn das Telefon nicht geöffnet wird, überprüfe, ob die Ressource gestartet ist, indem du die Serverkonsole auf Fehlermeldungen prüfen. Das häufigste Problem ist eine fehlende Abhängigkeit oder eine falsche Framework-Konfiguration. Überprüfe, ob die Exportnamen deines Frameworks mit den Erwartungen von Agency Phone übereinstimmen. Wenn Datenbankfehler auftreten, stelle sicher, dass der SQL-Import ohne Probleme abgeschlossen wurde und der Datenbankbenutzer über die entsprechenden Berechtigungen verfügt. Wenn du weitere Hilfe benötigen, tritt der Agency Scripts Discord-Community bei, in der das Team und andere Serverbesitzer Ihnen helfen können.
Zusammenfassung
Agency Scripts baut seine gesamte Produktlinie nach denselben Grundprinzipien: Framework-agnostische Architektur, schlanke Performance-Eigenschaften, klar dokumentierte Konfiguration und eine API, die echte Composability zwischen den Scripts ermöglicht. Kein Script ist eine Insel — jedes ist so gebaut, dass es gut allein und noch besser als Teil des Ökosystems funktioniert.
Für Fragen zur Installation, Konfiguration oder Kompatibilität ist der Agency Scripts Discord der schnellste Weg zur Hilfe. Die Community dort ist aktiv und hilfsbereit, und das Core-Team ist regelmäßig präsent. Für kritische Probleme steht auch ein direktes Support-Ticket-System auf der Tebex-Produktseite zur Verfügung.
Updates für alle Agency-Scripts werden über Tebex-Benachrichtigungen kommuniziert. Active-Business-Abonnenten erhalten neue Scripts automatisch ohne zusätzlichen Kauf. Changelog-Details erscheinen im #changelog-Kanal des Discords, damit du Updates bewerten kannst, bevor du sie auf einem Produktionsserver installierst.