Pulse Phone — Quick Start

PhoneHub + Pulse ist eine separate Edition mit eigener Lizenz und eigener Kopie dieses Handys. Wenn du diese Edition gekauft hast, folge stattdessen ihrer eigenen Installationsanleitung: Ein Server nutzt eine Handy-Resource.

1. Prüf deinen Server

Starte deine Datenbank, dein Framework, Inventar, deine Voice-Resource und screenshot-basic vor Pulse. Die richtige Reihenfolge findest du unter Voraussetzungen und dein Framework.

Mach vor dem ersten Start ein Backup deiner Datenbank. Pulse legt seine eigenen Tabellen an. Wenn ein anderes Handy Tabellen mit denselben Namen hinterlassen hat, werden sie in old_<name> umbenannt (nichts wird gelöscht); die Details stehen unter Voraussetzungen.

2. Den phone-Ordner kopieren

Lade deinen Kauf aus deinem Cfx.re-Account herunter. Kopier den Ordner phone mit der fxmanifest.lua in die Resources deines Servers. Behalte seinen Namen. Dein Server-Key muss zu dem Account gehören, dem das Asset gehört.

Upload per FTP (gehosteter Server): Nutze den Binary-Modus (FileZilla: Transfer > Transfer Type > Binary) oder lade das Zip hoch und entpack es auf dem Server. Der Auto-Modus verändert die gesperrten Dateien, und das Handy verweigert den Start; die Symptome und die Lösung stehen unter Fehlerbehebung. Der hochgeladene Ordner muss dieser Tabelle entsprechen; der Start-Check nennt jede Datei, die fehlt oder die falsche Größe hat.

Der Download von Pulse Phone 1.4.2:

Du aktualisierst eine bestehende Installation? Folge zuerst Updaten, damit Einstellungen und Spieler-Medien erhalten bleiben. Stopp die vorherige Handy-Resource, bevor du auf Pulse wechselst.

3. Inventar-Items hinzufügen

Öffne Inventare und folge den Anweisungen für das Inventar, das du schon nutzt. Mitgelieferte Definitionen und Bilder liegen in config/items/. Füg die Einträge in dein Inventar ein; ersetz nicht seine ganze Item-Datei.

Das Standard-Inventar von ESX und QBCore können fehlende Definitionen automatisch registrieren. Andere Inventare brauchen eventuell die mitgelieferten Einträge. Kopier die Item-Bilder dorthin, wo dein Inventar sie erwartet. Standalone ohne Inventar braucht keine Items.

4. Pulse starten

Lass die automatische Erkennung in config/config.lua an. Der erste Abschnitt enthält Framework, Sprache, Inventar-Auswahl, Handy-Item und Tasten. Optionale Einstellungen sind unter Konfiguration aufgelistet.

Füg das nach deinen bestehenden Abhängigkeiten in die server.cfg ein:

ensure phone
add_ace group.admin phone.admin allow

Starte den Server neu. Pulse legt seine Datenbanktabellen an, sobald die SQL-Verbindung verfügbar ist. Lies den Check in der Konsole und folge allen Anweisungen zur Korrektur. Führ phone:health aus, um ihn zu wiederholen.

5. Dein Handy öffnen

Tritt als Administrator bei, öffne F8 und gib phone:setup ein. Bestätige das erkannte Framework und Inventar und schließ dann das geführte Setup ab. Drück F1 oder nutze /phone, um das Handy zu öffnen. Wenn deine Einstellungen ein Item verlangen, kauf zuerst ein Handy und benutz seine Box aus dem Inventar.

In Settings → Server gespeicherte Einstellungen überschreiben die passenden Einstellungen aus den Dateien. Setz eine gespeicherte Überschreibung dort zurück, wenn wieder der Wert aus der Datei gelten soll.

6. Optional: das schlankere screenshot-basic

Dein Download enthält auch einen Ordner screenshot-basic. Es ist das screenshot-basic von CitizenFX (MIT-Lizenz) mit einer Änderung: Das Original zeichnet das Spielbild für seine Aufnahme-Ebene in jedem Frame neu, auch wenn niemand ein Foto macht, und diese Kopie zeichnet nur, während ein Foto gemacht wird. Der Resource-Name, seine Exports (requestScreenshot, requestScreenshotUpload, requestClientScreenshot) und seine Events sind unverändert, und es kommt bereits gebaut, muss sich also beim ersten Start nicht selbst bauen. Die geänderten Dateien stehen in screenshot-basic/ZERODEV-CHANGES.md.

Pulse funktioniert mit beiden Kopien, dieser Schritt ist also optional. Andere Scripts auf deinem Server nutzen screenshot-basic auch, wechsle also zuerst auf einem Testserver, wenn du einen hast:

1. Benenne deinen aktuellen Ordner screenshot-basic um (zum Beispiel in screenshot-basic.bak) und verschieb ihn aus resources, damit du ihn zurücklegen kannst.
2. Kopier unseren nach resources, mit demselben Namen, screenshot-basic, und behalte dieselbe Zeile ensure screenshot-basic.
3. Starte den Server neu und probier jedes Script aus, das Screenshots macht: die Handykamera und jedes Report-, Beweis- oder Bodycam-Tool, das du nutzt.
4. Wenn sich irgendetwas anders verhält, lösch unsere Kopie, leg deinen alten Ordner als screenshot-basic zurück und starte neu.

Die Features einrichten, die du nutzt

• Anrufe, Video und Live: unterstützte Voice-Resources, Anrufsteuerung und Einrichtung der Videoverbindung für den Livebetrieb.
• Fotos und Videos: eingebauter Speicher, FiveManage und andere Upload-Optionen. Private Service-Keys bleiben in deiner Server-Konfiguration. Auf einem gehosteten Server, dessen Web-Port nicht erreichbar ist, brauchen Fotos FiveManage: zwei Zeilen in der server.cfg (set phone_media_provider "fivemanage" und set phone_fivemanage_token "<token>").
• Konfiguration: Läden, Apps, Zubehör, Sprachen und optionale Features.
• Fehlerbehebung: Finde das Symptom und folge seiner Lösung.
• Entwickler-Integrationen: eigene Scripts und fortgeschrittene Verbindungseinstellungen.

Eine normale Installation erfordert keine Änderungen an bridge/, ui/ oder stream/. Halte die komplette Resource zusammen, inklusive ihrer Modell- und Map-Assets.