CS Stories

CS Stories fügt deinem FiveM Telefon zeitlich begrenzte Video-Stories hinzu. Spieler nehmen im Spiel kurze Videos auf und teilen sie in einem Stories-Feed. Es ist eine eigenständige Ressource, die mit jedem Framework funktioniert und in jedes Lua NUI-basierte Telefon integriert werden kann. Sie bietet eine umfangreiche Konfiguration, Events, Exports und einige Client- und Server-Quellcodedateien, damit du sie anpassen kannst.

Funktionen

• Kurze, temporäre Videostories mit dem Standort und Namen des Hochladenden im Spiel
• Stories werden standardmäßig für 24 Stunden angezeigt und standardmäßig für 24 Stunden im Speicher behalten; maximale Länge standardmäßig 30 Sekunden (ca. 5 MB pro Video mit maximaler Länge ohne Vorschaubild); Ratenbegrenzung zum Schutz deines Speichers
• Spieler können ihre eigenen Stories löschen; autorisierte Spieler können die Stories von jedem löschen
• Einfacher Stories-Feed mit vollständiger Maus- und Tastatursteuerung
• Zwischen Rück- und Frontkamera wechseln; experimenteller Kameramodus, mit dem sich der Spieler während der Aufnahme bewegen kann
• Farbfilter (Graustufen, Sepia, Invertieren, Sättigen und mehr) und Bildfilter mit Echtzeit-Gesichtsverfolgung für Peds (Hund, Katze und mehr)
• Passt sich an verschiedene Bildschirmauflösungen an
• Viele Events und Exports zum Überprüfen und Steuern der Ressource
• Enthaltene Telefon-Hooks: gcphone und qb-phone (auch für darauf basierende Handys nutzbar); Hooks können angepasst oder für andere Handys geschrieben werden
• Optionales Begleitressourcen CS-Geschichten-DW um Stories zur Moderation oder Protokollierung an Discord zu senden (folge den Webhook-Richtlinien von Discord)

Anforderungen

• Ein Lua NUI-basiertes Telefon und das Garn Ressource
• Der mitgelieferte Hosting-Server ist zwingend erforderlich. Er speichert Videos, Vorschaubilder und Metadaten, benötigt daher Netzwerk, Bandbreite und Speicherplatz sowie einen zusätzlichen offenen TCP-Port (standardmäßig 35540). Er ist auch als externe node.js-Anwendung (cs-stories-ehs) verfügbar, die du auf einer anderen Maschine ausführen kannst.
• Wenn dein Telefon folgendes verwendet fx_version "cerulean", ,leite den Hosting-Server über HTTPS weiter (zum Beispiel mit einer Domain und Cloudflare) oder ändere die fx_version des Handys auf "bodacious".

Installation

• Stelle sicher Garn befindet sich in deinem resources-Ordner, platziere cs-stories in deine Ressourcen und füge ensure cs-stories zu deiner Server-Konfiguration vor deinem Handy.
• Auf deinem Handy __resource.lua oder fxmanifest.lua, füge '@cs-stories/client/hooks/core.lua' als letztes Client-Skript und '@cs-stories/server/hooks/core.lua' als letztes Serverskript.
• In der NUI-Datei deines Handys (normalerweise index.html), hinzufügen <script type="text/javascript" src="nui://cs-stories/client/hooks/core.js"></script> direkt vor </body>.
• Lies alle Optionen in config.js und passe sie an dein Setup an.
• Öffne für den internen Hosting-Server den TCP-Port (standardmäßig 35540, eingehend) in deiner Firewall.
• Führe aus: refresh und ensure cs-stories. Wenn dein Handy eine Animationsschleife verwendet, füge hinzu not CS_STORIES.ACTIVE vor dem Abspielen der Animation überprüfen und dann sicherstellen, dass dein Telefon.
• Mit dem externen Hosting-Server: Installiere ihn mit npm install, konfiguriere dessen config.js, starte ihn mit node (zum Beispiel mit pm2) und füge seine IP-Adresse hinzu zu sv_proxyIPRanges in deiner Serverkonfiguration.

Wichtige Informationen

• Spieler werden um Mikrofon-Berechtigung gebeten. Wenn sie diese versehentlich ablehnen, müssen sie löschen %AppData%\CitizenFX\media_access.json , um es zurückzusetzen.
• Es wird nur die Stimme des aufnehmenden Spielers über das Standardmikrofon des Systems aufgenommen. Das Sprechen wird über die integrierte Native erkannt; bei einem externen VoIP wie TokoVoip musst du den Hook anpassen.
• Ein aufnehmender Spieler kann sich nicht bewegen (standardmäßiges GTA V-Kameraverhalten), es sei denn, du verwendest den experimentellen Kameramodus.
• Bei sehr hohen Auflösungen oder Systemen mit sehr geringer Leistung kann es zu Video-Render-Lags oder -Hängern kommen.
• Die Aufnahme nutzt die Game-Capture-Funktion: Alles im Spiel wird aufgezeichnet, einschließlich der visuellen Einstellungen und Modifikationen und Spiel-UIs, aber keine NUIs.
• Wenn dein Server hinter einem Reverse-Proxy läuft, der keinen zusätzlichen TCP-Port verarbeiten kann, hoste den Stories-Server extern auf einer anderen Maschine.
• Das Hochladen und Ansehen von Stories verbraucht die Bandbreite der Spieler und des Hosting-Servers. Wenn dein Hosting-Server-Host hat eine begrenzte Bandbreite, überprüfe regelmäßig deine Nutzung und deinen Speicher.
• Story-Metadaten werden gespeichert in KV-Speicher von FiveM; Bei einem gemeinsamen Multi-Server-Setup lege fest sv_kvsName zu etwas Einzigartigem.
• Video und Standort werden überprüft, aber da der Client sie sendet, kann ihnen nicht vollständig vertraut werden.
• Abgelaufene Stories werden beim Start des Resizes gelöscht. Die Bereinigung hängt also davon ab, wie oft du neustartest.

Fehlerbehebung

• Fehler beim Anzeigen oder Hochladen: beachte den HTTPS/fx_version-Hinweis oben. Andernfalls ist die Ursache meistens eine TCP-Blockierung, ein komplexes Netzwerk-Setup oder ein Anti-DDoS-Schutz; versuche einen anderen, hohen Port und stelle sicher, dass er für TCP geöffnet ist, oder hoste den Stories-Server extern.
• Schaltfläche für die App „Keine Stories“: Stelle sicher, dass du den richtigen Hook für dein Telefon verwendest und dass dessen Events und DOM-Elemente übereinstimmen. Einige Hooks fügen die App dem App Store des Telefons anstatt dem Startbildschirm hinzu.
• yarn wird immer wieder neu installiert: Bearbeiten package.json, füge ein Leerzeichen hinzu oder entferne es und speichere es.