Installer des ressources et scripts FiveM

Les ressources FiveM

Les ressources sont les composants de votre serveur FiveM. Chaque script, map, vehicule ou interface est une ressource. Comprendre leur installation est essentiel pour personnaliser votre serveur OneSubnet.

Structure d'une ressource

Une ressource FiveM typique contient :

fxmanifest.lua ou __resource.lua : Fichier de declaration de la ressource
client.lua : Code execute cote client (joueur)
server.lua : Code execute cote serveur
config.lua : Fichier de configuration
html/ : Interface NUI (interface web)
stream/ : Fichiers de streaming (models, textures)

Methode 1 : Installation via la Toolbox OneSubnet

La methode la plus simple pour les ressources populaires :

Ouvrez la Toolbox FiveM dans le panel Pterodactyl
Recherchez la ressource souhaitee
Cliquez sur « Installer »
Redemarrez le serveur

Methode 2 : Installation manuelle

Etape 1 : Telecharger la ressource

Telechargez les ressources depuis des sources fiables :

GitHub : Pour les scripts open-source
FiveM Forum : Ressources partagees par la communaute
Tebex / Cfx.re Portal : Ressources premium

Etape 2 : Uploader les fichiers

Arretez votre serveur
Ouvrez le gestionnaire de fichiers
Naviguez vers le dossier /resources/
Créez un dossier pour votre ressource (ex: [scripts]/mon_script)
Uploadez les fichiers du script

[ici capture d'ecran du panel Pterodactyl - upload de fichiers]

Etape 3 : Configurer le server.cfg

Ajoutez la ressource dans votre server.cfg :

# Ajoutez cette ligne dans server.cfg
ensure mon_script

Pour les ressources dans un sous-dossier :

ensure [scripts]/mon_script

Etape 4 : Configurer la ressource

Ouvrez le fichier config.lua de la ressource
Modifiez les parametres selon vos besoins
Sauvegardez le fichier

Etape 5 : Demarrer le serveur

Demarrez le serveur depuis le panel
Verifiez dans la console que la ressource se charge sans erreur
Recherchez le message « Started resource mon_script »

Organisation des ressources

Pour garder votre serveur organise :

/resources/
  /[framework]/     # ESX ou QBCore
  /[core]/          # Ressources essentielles
  /[maps]/          # Maps et interiors
  /[vehicles]/      # Vehicules
  /[scripts]/       # Scripts personnalises
  /[ui]/            # Interfaces NUI

Dependances

Certaines ressources necessitent d'autres ressources pour fonctionner :

Verifiez toujours les dependances dans la documentation
Installez les dependances avant la ressource principale
L'ordre dans server.cfg est important : les dependances doivent etre declarees en premier

Ressources recommandees

Administration

EasyAdmin : Panel d'administration
vMenu : Menu de gestion pour les admins

Performance

onesync : Active dans server.cfg
cron : Execution de taches planifiees
mysql-async ou oxmysql : Optimisation des requetes SQL

Gameplay

es_extended / qb-core : Framework de base
ox_inventory : Inventaire moderne
qb-phone / gcphone : Telephone

Problemes courants

« Couldn't find resource » : Le chemin dans server.cfg ne correspond pas au dossier
Erreurs SQL : Importez le fichier SQL de la ressource dans votre base de donnees
Conflits : Deux ressources font la meme chose. Desactivez l'une d'entre elles