Installationsdetails

1. Schnellinstallation

Bevor du irgendetwas kopierst

Nutze ein Server-Artifact, das die Voraussetzungen unten erfüllt, mit aktiviertem OneSync und Game Build 2699 oder neuer. Auf einem normalen Roleplay-Server sollten dein Framework, Inventar, oxmysql, deine Voice-Resource und screenshot-basic zuerst funktionieren. Standalone funktioniert auch ohne Framework; Inventar-Items sind dort optional.

Lade die Resource aus deinem Cfx.re-Account herunter, nachdem du den Kauf beansprucht hast. Nutze den Server-Key, der zu dem Account gehört, dem das Asset gehört. Wenn Cfx.re einen Berechtigungsfehler meldet, korrigiere die Zuordnung von Account und Key; Änderungen an den Handy-Einstellungen können die Berechtigung nicht erteilen.

Schritt 1 — Die Resource auf deinen Server legen

Entpack das Paket und kopier den Resource-Ordner phone mit der fxmanifest.lua in das Verzeichnis resources deines Servers. Benenne ihn nicht um und leg nicht den äußeren ZIP-/Paketordner an seine Stelle.

Auf einem gehosteten Server lad im Binary-Modus hoch oder lad das Zip hoch und entpack es dort (warum). Der Quick Start (Schritt 2) listet Dateianzahl und Größe jedes Ordners für diesen Build, und der Start-Check nennt jede Datei, die fehlt oder die falsche Größe hat.

Stopp deine vorherige Handy-Resource, bevor du Pulse testest, damit nicht zwei Handys um dieselbe Taste und dasselbe Item konkurrieren. Sichere ihre Daten, wenn du sie später importieren willst.

Schritt 2 — Deine Inventar-Items hinzufügen

Wähl dein bestehendes Inventar; du musst es nicht ersetzen.

Der Start-Check erkennt fehlende Einträge und gibt nur die Definitionen aus, die du noch brauchst. Ein Inventar, das Item-Definitionen beim Start lädt, wie ox_inventory, braucht die Einträge oben; Pulse überschreibt keine Dateien einer anderen Resource.

Schritt 3 — Die Hauptkonfiguration prüfen

Öffne config/config.lua. Die Standardwerte erkennen dein bestehendes Setup:

Config.Framework = 'auto'

Lass inventory = 'auto' in der bestehenden Tabelle Config.Providers. Wenn du mehrere Inventar-Resources nutzt, setz den Wert auf das Inventar, das du verwenden willst, etwa 'ox_inventory'. Füg am Ende der Datei keine zweite Tabelle Config.Providers oder Config.Item hinzu.

Wähl in der bestehenden Tabelle Config.Item, wie Handys funktionieren:

Einzigartige Handys folgen der gewählten Inventar-Bridge. Lass Config.Item.inventory = 'auto'; diese ältere Überschreibung ist nur für bestehende fortgeschrittene Installationen. Config.Providers.inventory hat Vorrang, wenn es ausdrücklich gesetzt ist.

Ändere Config.IdentityScope nicht auf einem bestehenden Server. Der Standard, 'character', hält die Handys verschiedener Charaktere getrennt.

Optional: Inventar-Handys und bezahlter Mobilfunk

Um für jedes Handy ein eigenes Handy-Item zu verlangen, setz required = true und unique = true in der bestehenden Tabelle Config.Item in config/config.lua, nachdem du die Inventar-Einträge hinzugefügt hast. Nutze eins der oben genannten Inventare für einzigartige Handys.

Um Mobilfunk zu verkaufen, setz Config.Carrier.enabled = true in derselben Datei. Das aktiviert die Carrier-App, in der Spieler ihren Tarif kaufen. Neue Handys brauchen einen Tarif, bevor normale Anrufe, Nachrichten und Apps mit mobilen Daten verfügbar sind. Im App Hub installieren Spieler Apps, er ist nicht der Laden für Mobilfunk. Setz Config.Coverage.enabled = true, wenn du auch Netzabdeckungszonen willst. Netzabdeckung und bezahlte Tarife sind getrennte Optionen; lass eine davon aus, wenn du das Feature nicht willst.

Bearbeite die bestehenden Einstellungen, statt doppelte Tabellen hinzuzufügen. Starte den Server nach dem Speichern neu. Wenn eine Einstellung im Spiel schon gespeichert wurde, setz sie in Settings → Server zurück, damit der Wert aus deiner Datei gilt.

Schritt 4 — Abhängigkeiten vor Pulse starten

Behalte deine bestehende Datenbankverbindung und deine Framework-Einstellungen. Füg nur fehlende Zeilen hinzu; starte keine zweite Kopie einer Abhängigkeit.

Nutze diese Reihenfolge mit den Resources, die schon auf deinem Server installiert sind:

1. Datenbank-Resource und ihre bestehenden Verbindungseinstellungen.
2. Framework und seine benötigten Bibliotheken, Identitäts- und Charakter-Resources.
3. Inventar, mit der Konfiguration dieses Inventars für dein Framework.
4. Eine unterstützte Voice-Resource und screenshot-basic.
5. ensure phone.

Installiere nicht ESX, QBCore oder ein anderes Inventar nur für Pulse. Wähl dein bestehendes Setup unter Dein Framework für das passende Beispiel zur Startreihenfolge. Qbox wird als Qbox erkannt, auch wenn eine andere Resource seine QBCore-kompatiblen Exports nutzt.

Für Administrator-Zugriff auf Pulse füg add_ace group.admin phone.admin allow hinzu. Dein Administrator-Account muss bereits zu group.admin gehören, damit diese Berechtigung greift.

Schritt 5 — Den Check beim ersten Start lesen

Starte den Server neu. Pulse gibt einen Startbericht aus und legt seine Datenbanktabellen automatisch an, sobald die SQL-Verbindung verfügbar ist.

• FIX / FAIL: Ein benötigter Teil kann nicht funktionieren. Folge der Korrekturzeile, bevor du Spieler es nutzen lässt.
• NOTE / WARN: Lies, welches Feature betroffen ist; manche Warnungen beschreiben optionale Features, die du nicht konfiguriert hast.
• Führ phone:health in der Serverkonsole aus, um den Check zu wiederholen.
• Führ phone:diag aus, um das gewählte Framework/Inventar/die Provider zu sehen.
• Tritt als Admin bei, öffne F8 und führ phone:setup für das bestehende geführte Setup aus.

Im Admin-Setup im Spiel gespeicherte Einstellungen überschreiben die entsprechenden Einstellungen aus den Dateien. Wenn eine Dateiänderung ignoriert zu werden scheint, prüf Settings → Server und setz die gespeicherte Überschreibung zurück, bevor du weitere Dateien änderst.

Schritt 6 — Als Spieler testen

1. Lade einen Charakter, drück F1 und schließ das Handy-Setup ab. Wenn die Item-Pflicht aktiv ist, kauf zuerst ein Handy im Laden oder gib dem Charakter das konfigurierte Handy-Item.
2. Wenn du eine versiegelte Box gekauft hast, benutz die Box aus dem Inventar, um sie auszupacken, und schließ dann das Setup ab. Das Handy kommt eingeschaltet an; mit Config.Device.arrivesOn = false halte zuerst End oder O.
3. Öffne Messages, Contacts und Phone. Geh zurück zum Home Screen, öffne den App Switcher und schließ jede App nacheinander.
4. Mach ein Foto und ein kurzes Video. Öffne beide in Photos, schließ das Handy und öffne es wieder und prüf, dass sie noch da sind.
5. Verbinde dich neu und prüf, dass derselbe Charakter noch dasselbe Handy hat. Teste Anrufe mit einem zweiten Spieler über deine installierte Voice-Resource.

Wo du Dinge änderst

Die Abschnitte unten enthalten die ausführliche Referenz. Du musst nicht jede Feature-Einstellung lesen, um die erste Installation abzuschließen.