Détails d'installation

1. Installation rapide

Avant de copier quoi que ce soit

Utilisez un artifact serveur qui respecte les prérequis ci-dessous, avec OneSync activé et le game build 2699 ou plus récent. Pour un serveur roleplay classique, faites d'abord fonctionner votre framework, votre inventaire, oxmysql, votre ressource vocale et screenshot-basic. Le mode standalone fonctionne aussi sans framework ; les items d'inventaire y sont facultatifs.

Téléchargez la ressource depuis votre compte Cfx.re après avoir réclamé l'achat. Utilisez la clé serveur qui appartient au compte propriétaire de l'asset. Si Cfx.re signale une erreur de droits (entitlement), corrigez l'association compte/clé ; modifier les réglages du téléphone ne peut pas accorder ces droits.

Étape 1 — Placez la ressource sur votre serveur

Extrayez le package et copiez le dossier de la ressource phone, qui contient fxmanifest.lua, dans le répertoire resources de votre serveur. Ne le renommez pas et ne mettez pas le dossier ZIP/package extérieur à sa place.

Sur un serveur hébergé, envoyez les fichiers en mode Binary ou envoyez le zip et extrayez-le sur place (pourquoi). Le démarrage rapide (étape 2) liste le nombre de fichiers et la taille de chaque dossier pour ce build, et la vérification au démarrage nomme tout fichier manquant ou de mauvaise taille.

Arrêtez votre ancienne ressource de téléphone avant de tester Pulse, pour que deux téléphones ne se disputent pas la même touche et le même item. Sauvegardez ses données si vous comptez les importer plus tard.

Étape 2 — Ajoutez vos items d'inventaire

Choisissez votre inventaire existant ; vous n'avez pas besoin de le remplacer.

La vérification au démarrage repère les entrées manquantes et n'affiche que les définitions dont vous avez encore besoin. Un inventaire qui charge les définitions d'items au démarrage, comme ox_inventory, a besoin des entrées ci-dessus ; Pulse n'écrase pas les fichiers d'une autre ressource.

Étape 3 — Vérifiez la configuration principale

Ouvrez config/config.lua. Les valeurs par défaut détectent votre configuration existante :

Config.Framework = 'auto'

Laissez inventory = 'auto' dans la table Config.Providers existante. Si vous faites tourner plusieurs ressources d'inventaire, mettez à cette valeur l'inventaire que vous comptez utiliser, par exemple 'ox_inventory'. N'ajoutez pas une deuxième table Config.Providers ou Config.Item en bas du fichier.

Dans la table Config.Item existante, choisissez le fonctionnement des téléphones :

Les téléphones uniques suivent le bridge d'inventaire sélectionné. Laissez Config.Item.inventory = 'auto' ; cet ancien réglage de forçage ne sert qu'aux installations avancées existantes. Config.Providers.inventory est prioritaire quand il est défini explicitement.

Ne modifiez pas Config.IdentityScope sur un serveur existant. La valeur par défaut, 'character', garde séparés les téléphones des différents personnages.

Facultatif : téléphones en inventaire et service payant

Pour exiger un item de téléphone distinct pour chaque téléphone, définissez required = true et unique = true dans la table Config.Item existante de config/config.lua, après avoir ajouté les entrées d'inventaire. Utilisez l'un des inventaires compatibles avec les téléphones uniques listés ci-dessus.

Pour vendre un service téléphonique, définissez Config.Carrier.enabled = true dans le même fichier. Cela active l'app Carrier, où les joueurs achètent leur forfait. Les nouveaux téléphones ont besoin d'un forfait avant que les appels normaux, les messages et les apps utilisant les données mobiles soient disponibles. App Hub est l'endroit où les joueurs installent des apps, pas la boutique de service. Définissez Config.Coverage.enabled = true si vous voulez aussi des zones de couverture. La couverture et les forfaits payants sont des options séparées ; laissez l'une ou l'autre désactivée si vous ne voulez pas cette fonctionnalité.

Modifiez les réglages existants plutôt que d'ajouter des tables en double. Redémarrez le serveur après avoir enregistré. Si un réglage en jeu a déjà été enregistré, réinitialisez-le dans Settings → Server pour que la valeur de votre fichier s'applique.

Étape 4 — Démarrez les dépendances avant Pulse

Gardez votre connexion à la base de données et vos réglages de framework existants. N'ajoutez que les lignes manquantes ; ne démarrez pas une deuxième copie d'une dépendance.

Utilisez cet ordre avec les ressources déjà installées sur votre serveur :

1. La ressource de base de données et ses réglages de connexion existants.
2. Le framework et ses bibliothèques requises, ses ressources d'identité et de personnage.
3. L'inventaire, avec la configuration de cet inventaire pour votre framework.
4. Une ressource vocale prise en charge et screenshot-basic.
5. ensure phone.

N'installez pas ESX, QBCore ou un autre inventaire juste pour Pulse. Choisissez votre configuration existante dans Votre framework pour l'exemple d'ordre de démarrage correspondant. Qbox est détecté comme Qbox même quand une autre ressource utilise ses exports compatibles QBCore.

Pour l'accès administrateur à Pulse, ajoutez add_ace group.admin phone.admin allow. Votre compte administrateur doit déjà appartenir à group.admin pour que cette permission s'applique.

Étape 5 — Lisez la vérification du premier démarrage

Redémarrez le serveur. Pulse affiche un rapport de démarrage et crée automatiquement ses tables dès que la connexion SQL est disponible.

• FIX / FAIL : une partie obligatoire ne peut pas fonctionner. Suivez la ligne de correction avant de laisser les joueurs l'utiliser.
• NOTE / WARN : lisez quelle fonctionnalité est concernée ; certains avertissements portent sur des fonctionnalités facultatives que vous n'avez pas configurées.
• Lancez phone:health dans la console du serveur pour refaire la vérification.
• Lancez phone:diag pour voir le framework, l'inventaire et les fournisseurs choisis.
• En tant qu'admin, connectez-vous, ouvrez F8 et lancez phone:setup pour la configuration guidée existante.

Les réglages enregistrés dans la configuration admin en jeu remplacent les réglages correspondants des fichiers. Si une modification de fichier semble ignorée, vérifiez Settings → Server et réinitialisez ce réglage enregistré avant de modifier d'autres fichiers.

Étape 6 — Testez en tant que joueur

1. Chargez un personnage, appuyez sur F1 et terminez la configuration du téléphone. Si l'exigence d'items est activée, achetez d'abord un téléphone en boutique ou donnez au personnage l'item téléphone configuré.
2. Si vous avez acheté une boîte scellée, utilisez la boîte depuis l'inventaire pour la déballer, puis terminez la configuration. Le téléphone arrive allumé ; avec Config.Device.arrivesOn = false, maintenez d'abord End ou O.
3. Ouvrez Messages, Contacts et Phone. Revenez à l'accueil, ouvrez le sélecteur d'apps et fermez chaque app l'une après l'autre.
4. Prenez une photo et une courte vidéo. Ouvrez-les dans Photos, fermez et rouvrez le téléphone, et vérifiez qu'elles sont toujours là.
5. Reconnectez-vous et vérifiez que le même personnage a toujours le même téléphone. Testez les appels avec un second joueur en utilisant votre ressource vocale installée.

Où modifier les choses

Les sections ci-dessous contiennent la référence détaillée. Vous n'avez pas besoin de lire chaque réglage de fonctionnalité pour terminer la première installation.