Ajouter vos propres scripts

01Votre dossier : resources/[client]

Vos scripts, maps et ressources personnelles vont dans le dossier resources/[client], depuis l'écran Fichiers du serveur. Ce dossier est le vôtre, et le seul décompté de votre espace : le framework Nova, le cache et les journaux vivent ailleurs, gérés et mis à jour par nous.

La jauge « Vos fichiers » montre la place prise sur le quota de votre offre. La corbeille compte aussi : un fichier supprimé y reste 7 jours, restaurable, puis il est détruit. Pour libérer de la place tout de suite, ouvrez « Corbeille » et videz-la.

02Déposer des fichiers

« Déposer un fichier » et « Déposer un dossier » envoient depuis votre ordinateur, et un glisser-déposer sur la liste fait la même chose. « Nouveau dossier », « Renommer », « Déplacer » et « Supprimer » rangent le reste. Un fichier texte de 512 Ko au plus s'ouvre avec « Modifier » ; au-delà, téléchargez-le.

Certains types sont toujours refusés, seuls ou dans une archive : les scripts et programmes système comme .sh, .bat, .exe ou .dll. Une ressource FiveM n’en a pas besoin ; un paquet qui en contient mérite d’être regardé de près avant d’être installé.

03Importer une archive

Une archive déposée (zip, rar, 7z, tar.gz…) est importée : chaque dossier qui contient un manifeste (fxmanifest.lua, ou l'ancien __resource.lua) en est extrait ici, puis l'archive est supprimée. Ce qui n'est pas une ressource est laissé de côté, et le résultat le liste. Une archive sans aucun manifeste est refusée, sans rien écrire. Pour déposer une archive telle quelle, cochez « Garder l'archive telle quelle », puis utilisez « Décompresser ici » sur le fichier.

Si une ressource du même nom existe déjà, rien n'est écrit avant votre choix : « Remplacer » met l'ancienne version de côté et ne la supprime qu'une fois la nouvelle en place, « Importer sous un autre nom » ajoute -2, -3… et garde les deux. Une seule archive se traite à la fois par serveur ; le traitement continue sur le serveur, gardez la page ouverte pour en voir le résultat.

« Importer depuis un lien » télécharge une archive depuis une adresse https, par exemple le fichier joint à une release GitHub, jusqu'à 2 Go. Collez le lien du fichier joint plutôt que celui du code source : le site doit connaître la taille du fichier avant de le recevoir.

04Activer et ordonner

Une ressource nouvelle arrive éteinte. Sous les fichiers, la carte « Ressources » liste tout ce qui porte un manifeste : activez ce qui doit démarrer, glissez pour choisir l'ordre, puis « Enregistrer ». Tout démarre après le framework Nova, au prochain redémarrage du serveur ; « Redémarrer maintenant » l'applique tout de suite.

La carte lit les dépendances de chaque manifeste. Une ressource qui demande une dépendance introuvable ne démarrera pas ; une dépendance désactivée est démarrée quand même, et « Activer et placer avant » remet l'ordre d'aplomb. Un dossier qu'on garde sans le démarrer s'exclut depuis le menu de sa ligne, et se réintègre plus tard.

La section « À corriger » dit pourquoi un dossier ne peut pas être activé : nom refusé (lettres sans accent, chiffres, _, - et . seulement), plus de trois niveaux de catégories imbriquées, aucun manifeste, même nom qu'une ressource du framework Nova, ou même nom dans un autre dossier. Corrigez dans vos fichiers, puis cliquez sur « Actualiser » dans la carte.

05Les pièges fréquents

ox_lib est fourni par nova_lib, et aucun dossier ox_lib n'existe sur le disque. Dans le fxmanifest d'un script, la ligne @ox_lib/init.lua se remplace par @nova_lib/shared/lib_init.lua, sinon la console affiche « Failed to load script ». C'est la retouche la plus fréquente d'un script récent.

N'importez pas un framework entier ni ses ressources de base (inventaire, téléphone, ciblage) : Nova les fournit déjà, et deux versions de la même ressource se marchent dessus. Un script écrit pour ESX ne fonctionnera pas sans être adapté ; venir d'un autre framework dit ce qui se reprend.

Un script serveur tourne avec l'accès à la base de données du serveur. N'installez que des ressources dont vous connaissez la provenance : les risques des packs FiveM détaille ce qu'un paquet douteux peut cacher. Si un script a besoin d'un droit ACE, accordez-le depuis Configuration, carte « Permissions des scripts » (configuration du serveur).