Installer une ressource

Du fichier téléchargé au serveur qui démarre sans erreur. La méthode est la même pour toutes nos ressources.

1. Poser les fichiers

Décompresse l'archive. Tu obtiens un dossier au nom de la ressource, par exemple kp_bda, qui contient un fxmanifest.lua. C'est ce dossier entier qui va sur le serveur.

Place-le dans resources/. Si tu utilises des dossiers entre crochets pour ranger, mets-le dedans :

resources/
  [kaapsule]/
    kp_bda/
      fxmanifest.lua

Ne renomme jamais le dossier. Pour FiveM, le nom du dossier est le nom de la ressource : il sert à la nommer dans server.cfg, dans ses events et ses exports, et pour une ressource protégée il fait partie de ce que Cfx.re vérifie au démarrage. Renommer casse tout, souvent avec une erreur peu parlante.

2. Vérifier les dépendances

Chaque ressource liste ses dépendances dans sa page d'installation. Elles doivent démarrer avant elle dans server.cfg. Les nôtres s'appuient en général sur :

  • ox_lib (obligatoire à peu près partout)
  • es_extended si tu es sur ESX
  • OneSync, actif avant le démarrage des ressources : set onesync on dans server.cfg, ou +set onesync on en argument de lancement. Certains hébergeurs et certaines configurations ne tiennent compte que de l'argument de lancement, c'est le premier réflexe si OneSync semble ignoré

3. Démarrer

Ajoute la ressource à server.cfg, après ses dépendances :

ensure ox_lib
ensure es_extended
ensure kp_bda

Un dossier entre crochets se démarre d'un bloc avec ensure [kaapsule]. Pratique, mais l'ordre à l'intérieur du dossier ne t'appartient plus : quand une ressource doit démarrer après une autre, nomme-les une par une.

Redémarre le serveur complètement pour le premier lancement. Un refresh suivi d'un ensure suffit ensuite pour les modifications de config.

4. Lire la console

Au démarrage, la console doit afficher la ressource comme démarrée, sans ligne rouge. Les deux messages qui doivent t'alerter :

  • une erreur de dépendance : la ressource attend quelque chose qui n'est pas démarré, ou démarre trop tard ;
  • une erreur d'escrow : voir Escrow et Keymaster.

5. Donner les accès

Les ressources d'administration ne s'ouvrent pas à tout le monde par défaut, et il n'existe aucun mode « tout le monde ». Il faut déclarer qui a le droit : voir Permissions ACE.

Mettre à jour

Remplace le dossier complet par la nouvelle version, ne copie pas les nouveaux fichiers par-dessus les anciens. Reprends ensuite le config.lua neuf et recopie tes valeurs dedans, plutôt que de garder ton ancien fichier : un mélange de deux versions produit des erreurs difficiles à lire.