Comment installer un script FiveM après l'avoir acheté

Les scripts FiveM payants sont livrés via le système d'assets de Cfx.re, et non sous forme de fichier dans votre boîte mail. Ce guide vous accompagne pour installer un script de la boutique sur un serveur en fonctionnement. Il s'applique à tous les scripts Zerio ; la page d'installation de chaque produit dans la documentation indique ce dont il a besoin en plus.

Avant d'acheter : utilisez le bon compte Cfx.re

Les scripts protégés (FiveM Asset Escrow) ne démarrent que sur un serveur dont la clé de licence appartient au même compte Cfx.re que celui qui a acheté le script. Lors du paiement, connectez-vous avec le compte propriétaire du sv_licenseKey de votre serveur.

Si votre hébergeur a généré la clé de licence pour vous, elle est peut-être enregistrée sur son compte. Dans ce cas, créez votre propre clé sur le Portail Cfx.re et placez-la dans votre server.cfg avant l'installation.

1. Téléchargez le script depuis le Portail Cfx.re

1. Rendez-vous sur portal.cfx.re et connectez-vous avec le compte utilisé pour l'achat.
2. Ouvrez Granted Assets. Les achats y apparaissent généralement en une minute ou deux.
3. Téléchargez la dernière version et décompressez-la dans un dossier temporaire.

Téléchargez toujours depuis le Portail plutôt que de réutiliser une ancienne copie ; c'est le seul endroit qui propose la version actuelle.

2. Envoyez-le dans le dossier resources de votre serveur

Copiez le dossier de la ressource extraite dans le répertoire resources de votre serveur, par exemple resources/[zerio]/zerio-radio. Conservez exactement le nom du dossier tel qu'il est dans le téléchargement, car d'autres ressources et exports y font référence par son nom.

Si vous envoyez les fichiers en FTP, transférez-les en mode binaire. Certains clients FTP convertissent les fins de ligne en mode ASCII, ce qui corrompt les fichiers escrow et provoque l'erreur syntax error near <\1>.

3. Importez le SQL (si le script en a un)

Cherchez un fichier .sql dans la ressource. S'il y en a un, importez-le dans la base de données de votre serveur avec phpMyAdmin, HeidiSQL ou la ligne de commande MySQL avant de démarrer la ressource. Les scripts sans fichier SQL créent eux-mêmes ce dont ils ont besoin.

4. Ajoutez-le au server.cfg

Ajoutez une ligne ensure pour la ressource après ses dépendances (votre framework, oxmysql, ox_lib, etc.) :

ensure oxmysql
ensure es_extended   # or qb-core / qbx_core
ensure zerio-radio

5. Configurez, puis redémarrez

Ouvrez les fichiers de config (généralement dans un dossier config ou shared) et adaptez-les à votre serveur : métiers, objets, touches et langue. Redémarrez ensuite le serveur, et pas seulement la ressource, afin que FiveM actualise vos entitlements.

Si la ressource ne démarre pas

• « Lacking entitlement » : la clé de licence et l'achat sont sur des comptes différents. Consultez comment corriger lacking entitlement.
• « Syntax error near <\1> » : les fichiers ont été corrompus pendant l'envoi. Consultez comment corriger syntax error near <\1>.
• Autre problème : posez la question sur notre Discord. Le support est inclus avec chaque achat.