Documentation Pulse Phone
Pulse Phone — Démarrage rapide
Installez une seule ressource nommée phone. Gardez votre framework et vos scripts pris en charge ; Pulse les détecte au démarrage.
PhoneHub + Pulse est une édition distincte avec sa propre licence et sa propre copie de ce téléphone. Si vous avez acheté cette édition, suivez plutôt son propre guide d'installation : un serveur fait tourner une seule ressource de téléphone.
1. Vérifiez votre serveur
| Quoi | Nécessaire ? |
|---|---|
| OneSync activé, game build 2699 ou plus récent | Obligatoire |
| Une base de données : oxmysql (ou mysql-async, ghmattimysql) sur MariaDB 10.6+ ou MySQL 8 | Recommandé. Sans ressource SQL, le téléphone garde ses données dans le stockage clé/valeur du serveur |
| Une ressource vocale : pma-voice, mumble-voip, SaltyChat, TokoVOIP ou YACA | Recommandé. Sans elle, les appels se connectent mais sans audio |
| screenshot-basic | Recommandé, pour que l'appareil photo puisse enregistrer les photos. La ressource standard fonctionne |
| Un framework et un inventaire | Facultatif. Sans eux, le téléphone tourne en standalone |
Démarrez votre base de données, votre framework, votre inventaire, votre ressource vocale et screenshot-basic avant Pulse. Consultez les prérequis et votre framework pour le bon ordre.
Sauvegardez votre base de données avant le premier démarrage. Pulse crée ses propres tables. Si un autre téléphone a laissé des tables portant les mêmes noms, elles sont renommées en old_<name> (rien n'est supprimé) ; les détails se trouvent dans les prérequis.
2. Copiez le dossier phone
Téléchargez votre achat depuis votre compte Cfx.re. Copiez le dossier phone qui contient fxmanifest.lua dans les ressources de votre serveur. Gardez son nom. La clé de votre serveur doit appartenir au compte qui possède l'asset.
Envoi par FTP (serveur hébergé) : utilisez le mode binaire (FileZilla : Transfer > Transfer Type > Binary), ou envoyez le zip et extrayez-le sur le serveur. Le mode automatique modifie les fichiers verrouillés et le téléphone refuse de démarrer ; les symptômes et la solution se trouvent dans Dépannage. Le dossier envoyé doit correspondre à ce tableau ; la vérification au démarrage nomme tout fichier manquant ou de mauvaise taille.
Le téléchargement de Pulse Phone 1.4.2 :
| Dossier ou fichier | Fichiers | Taille |
|---|---|---|
ui/ |
3,932 | 78,3 Mo |
stream/ |
40 | 30,5 Mo |
config/ |
138 | 23.2 MB |
d6c1e95a/ (le code verrouillé ; son nom change à chaque version) |
7 | 5,5 Mo |
data/ |
2 | 1,4 Mo |
bridge/ |
55 | 0,5 Mo |
guides/ |
13 | 0,2 Mo |
phone.sql |
1 | 0,2 Mo |
fxmanifest.lua |
1 | 6 Ko |
dossier phone complet |
4,204 | 139.7 MB |
Vous mettez à jour une installation existante ? Suivez d'abord Mise à jour pour conserver les réglages et les médias des joueurs. Arrêtez l'ancienne ressource de téléphone avant de passer à Pulse.
3. Ajoutez les items d'inventaire
Ouvrez Inventaires et suivez les instructions pour l'inventaire que vous utilisez déjà. Les définitions et images fournies se trouvent dans config/items/. Fusionnez les entrées dans votre inventaire ; ne remplacez pas tout son fichier d'items.
L'inventaire par défaut d'ESX et QBCore peuvent enregistrer automatiquement les définitions manquantes. D'autres inventaires peuvent demander les entrées fournies. Copiez les images des items là où votre inventaire les attend. Le mode standalone sans inventaire n'a besoin d'aucun item.
4. Démarrez Pulse
Gardez la détection automatique dans config/config.lua. La première section contient le framework, la langue, le choix de l'inventaire, l'item téléphone et les touches. Les réglages facultatifs sont répertoriés dans Configuration.
Ajoutez ceci après vos dépendances existantes dans server.cfg :
ensure phone
add_ace group.admin phone.admin allowRedémarrez le serveur. Pulse crée ses tables dès que la connexion SQL est disponible. Lisez sa vérification dans la console et suivez les éventuelles instructions de correction. Lancez phone:health pour la refaire.
5. Ouvrez votre téléphone
Connectez-vous en tant qu'administrateur, ouvrez F8 et tapez phone:setup. Confirmez le framework et l'inventaire détectés, puis terminez la configuration guidée. Appuyez sur F1 ou utilisez /phone pour ouvrir le téléphone. Si vos réglages exigent un item, achetez d'abord un téléphone et utilisez sa boîte depuis l'inventaire.
Les réglages enregistrés dans Settings → Server remplacent les réglages correspondants des fichiers. Réinitialisez un réglage enregistré à cet endroit si vous voulez que la valeur du fichier s'applique de nouveau.
6. Facultatif : le screenshot-basic allégé
Votre téléchargement contient aussi un dossier screenshot-basic. C'est le screenshot-basic de CitizenFX (licence MIT) avec une seule modification : l'original redessine l'image du jeu pour sa couche de capture à chaque image, même quand personne ne prend de photo, alors que cette copie ne dessine que pendant la prise d'une photo. Le nom de la ressource, ses exports (requestScreenshot, requestScreenshotUpload, requestClientScreenshot) et ses events sont inchangés, et elle est livrée déjà compilée, donc elle n'a pas besoin de se compiler au premier démarrage. Les fichiers modifiés sont listés dans screenshot-basic/ZERODEV-CHANGES.md.
Pulse fonctionne avec l'une ou l'autre copie, cette étape est donc facultative. D'autres scripts de votre serveur utilisent aussi screenshot-basic : faites d'abord le changement sur un serveur de test si vous en avez un :
- Renommez votre dossier
screenshot-basicactuel (par exemple enscreenshot-basic.bak) et sortez-le deresources, pour pouvoir le remettre. - Copiez le nôtre dans
resourcessous le même nom,screenshot-basic, et gardez la même ligneensure screenshot-basic. - Redémarrez le serveur et testez chaque script qui prend des captures d'écran : l'appareil photo du téléphone, et tout outil de rapport, de preuves ou de bodycam que vous utilisez.
- Si quelque chose se comporte différemment, supprimez notre copie, remettez votre ancien dossier sous le nom
screenshot-basicet redémarrez.
Configurez les fonctionnalités que vous utilisez
- Appels, vidéo et Live : ressources vocales prises en charge, commandes d'appel et configuration de la connexion vidéo en production.
- Photos et vidéos : stockage intégré, FiveManage et autres options d'envoi. Les clés de service privées restent dans la configuration de votre serveur. Sur un serveur hébergé dont le port web n'est pas accessible, les photos ont besoin de FiveManage : deux lignes dans
server.cfg(set phone_media_provider "fivemanage"etset phone_fivemanage_token "<token>"). - Configuration : boutiques, apps, accessoires, langues et fonctionnalités facultatives.
- Dépannage : trouvez le symptôme et suivez sa solution.
- Intégrations développeur : scripts personnalisés et réglages de connexion avancés.
Une installation normale ne nécessite pas de modifier bridge/, ui/ ou stream/. Gardez la ressource complète ensemble, y compris ses modèles et ses assets de map.