CS Stories

CS Stories ajoute des stories vidéo à durée limitée à votre téléphone FiveM. Les joueurs enregistrent de courtes vidéos en jeu et les partagent dans un flux de stories. C'est une ressource autonome qui fonctionne avec n'importe quel framework et peut être intégrée à n'importe quel téléphone basé sur Lua NUI. Elle est livrée avec une configuration étendue, des événements, des exports et certains fichiers source client et serveur, vous permettant ainsi de la personnaliser.

Fonctionnalités

• De courtes vidéos éphémères avec le nom et la position en jeu de la personne qui les a publiées
• Les stories sont affichées pendant 24 heures par défaut et conservées dans le stockage pendant 24 heures par défaut ; durée maximale de 30 secondes par défaut (environ 5 Mo par vidéo de durée maximale sans vignette) ; limite de taux pour protéger votre stockage
• Les joueurs peuvent supprimer leurs propres histoires ; les joueurs autorisés peuvent supprimer les histoires de n'importe qui
• Flux de stories simple avec navigation complète à la souris et au clavier
• Basculer entre la caméra arrière et avant ; mode caméra expérimental qui permet au joueur de se déplacer tout en enregistrant
• Filtres de couleur (niveaux de gris, sépia, inversion, saturation et plus) et filtres d'image avec suivi facial de personnage en temps réel (chien, chat et plus)
• S'adapte à différentes résolutions d'écran
• De nombreux événements et exports pour vérifier et contrôler la ressource
• Intégrations de téléphones incluses : gcphone et qb-phone (également utilisables pour les téléphones basés sur ceux-ci) ; les intégrations peuvent être ajustées ou écrites pour d'autres téléphones
• Ressource complémentaire optionnelle cs-histoires-dw pour publier des histoires sur Discord à des fins de modération ou de journalisation (veuillez respecter les politiques de webhook de Discord)

Exigences

• Un téléphone basé sur Lua NUI et le fil ressource
• Le serveur d'hébergement inclus est obligatoire. Il stocke les vidéos, les miniatures et les métadonnées, il a donc besoin de réseau, de bande passante et de stockage, ainsi que d'un port TCP ouvert supplémentaire (35540 par défaut). Il est également disponible en tant que application node.js externe (cs-stories-ehs) que vous pouvez exécuter sur une autre machine.
• Si votre téléphone utilise fx_version "cerulean", acheminez le serveur d'hébergement via HTTPS (par exemple avec un domaine et Cloudflare) ou changez le fx_version du téléphone pour "bodacious".

Installation

• S'assurer fil est dans votre dossier de ressources, placez cs-stories dans vos ressources et ajoutez ensure cs-stories à la configuration de votre serveur avant votre téléphone.
• Dans le fichier de votre téléphone __resource.lua ou fxmanifest.lua, ajoutez '@cs-stories/client/hooks/core.lua' comme le dernier script client et '@cs-stories/server/hooks/core.lua' comme le dernier script du serveur.
• Dans le fichier NUI de votre téléphone (généralement index.html), ajouter <script type="text/javascript" src="nui://cs-stories/client/hooks/core.js"></script> juste avant </body>.
• Lisez toutes les options dans config.js et les adapter à votre configuration.
• Avec le serveur d'hébergement interne, ouvrez le port TCP (35540 par défaut, entrant) dans votre pare-feu.
• Exécuter refresh et ensure cs-stories. Si votre téléphone utilise une boucle d'animation, ajoutez un not CS_STORIES.ACTIVE vérifiez avant de jouer l'animation, puis assurez-vous que votre téléphone.
• Avec le serveur d'hébergement externe : installez-le avec npm install, configurez son config.js, exécutez-le avec node (par exemple avec pm2) et ajoutez son adresse IP à sv_proxyIPRanges dans la configuration de votre serveur.

Informations importantes

• Il est demandé aux joueurs d'autoriser l'accès au microphone. S'ils refusent par erreur, ils doivent supprimer %AppData%\CitizenFX\media_access.json pour le réinitialiser.
• Seule la voix du joueur qui enregistre est enregistrée, en utilisant le microphone par défaut du système. La parole est détectée grâce à la fonction native intégrée ; avec un VoIP externe tel que TokoVoip, vous devez modifier le crochet.
• Un joueur en cours d'enregistrement ne peut pas bouger (comportement par défaut de la caméra GTA V) à moins d'utiliser le mode caméras expérimentales.
• Un décalage de rendu vidéo ou des gels peuvent survenir à très haute résolution ou sur des systèmes très peu puissants.
• L'enregistrement utilise la capture de jeu : tout dans le jeu est enregistré, y compris les paramètres visuels et mods et les jeux UIs, mais pas les NUIs.
• Si votre serveur fonctionne derrière un proxy inversé qui ne peut pas gérer un port TCP supplémentaire, hébergez le serveur de stories en externe sur une autre machine.
• Le téléchargement et la consultation des histoires consomment la bande passante des joueurs et du serveur d'hébergement. Si votre hébergeur de serveur a une bande passante limitée, vérifiez régulièrement votre utilisation et votre stockage.
• Les métadonnées des histoires sont stockées dans Stockage KV de FiveM; sur une configuration multi-serveur partagée, définissez sv_kvsName à quelque chose d'unique.
• La vidéo et l'emplacement sont vérifiés, mais comme le client les envoie, ils ne peuvent pas être entièrement fiables.
• Les stories expirées sont supprimées au démarrage de la ressource, le nettoyage dépend donc de la fréquence de vos redémarrages.

Dépannage

• Erreurs lors de l'affichage ou du téléversement : consultez la note HTTPS/fx_version ci-dessus. Sinon, la cause est généralement un blocage TCP, une configuration réseau complexe ou une protection anti-DDoS ; essayez un autre port élevé et assurez-vous qu'il est ouvert pour le TCP, ou hébergez le serveur stories en externe.
• Pas de bouton pour l'application des histoires : assurez-vous d'utiliser le hook approprié pour votre téléphone et que ses événements et éléments DOM correspondent. Certains hooks ajoutent l'application à l'App Store du téléphone au lieu de l'écran d'accueil.
• yarn continue de se réinstaller : Modifier package.json, ajoutez ou supprimez un espace, et enregistrez.