Comment installer des resources sur votre serveur RedM

Tout ce qu’un serveur RedM exécute est une resource : la boîte de chat, le spawn manager, un framework de roleplay et chaque script par-dessus. Installer une resource se fait toujours en trois étapes identiques.

Où se trouvent les resources

resources/

Une resource est un dossier contenant un fxmanifest.lua. Beaucoup de serveurs les regroupent dans des sous-dossiers dont le nom est entre crochets, comme [core] et [scripts], que le serveur analyse automatiquement.

Installer une resource

1. Dans le panel, ouvrez Files et allez dans resources/.
2. Téléversez le dossier de la resource. Ne le renommez pas, car le nom du dossier est le nom de la resource.
3. Arrêtez le serveur, modifiez server.cfg et ajoutez :

   ensure resourcename

4. Démarrez le serveur et lisez la console.

L’ordre de chargement compte

Les resources démarrent dans l’ordre où apparaissent leurs lignes ensure. Un framework, un wrapper de base de données et toute bibliothèque partagée doivent venir avant les scripts qui les utilisent. Se tromper produit des erreurs qui ressemblent à un script cassé mais sont en réalité une dépendance manquante.

Un ordre typique est :

ensure mapmanager
ensure chat
ensure spawnmanager
ensure sessionmanager-rdr3
ensure oxmysql
ensure my-framework
ensure my-jobs-script

Resources avec base de données

Beaucoup de resources de roleplay ont besoin d’une base de données MySQL. Créez-en une dans la section Bases de données du panel, puis placez son hôte, son nom, son utilisateur et son mot de passe dans la chaîne de connexion que la resource demande, en général une ligne set mysql_connection_string dans server.cfg. Importez tout fichier SQL fourni avec la resource avant de la démarrer.

Travailler sans redémarrage complet

Depuis la Console du panel :

refresh
start resourcename
restart resourcename
stop resourcename

refresh fait remarquer au serveur une resource tout juste téléversée. restart est ce que vous utilisez après avoir modifié un script.

Quand une resource échoue

La console nomme la resource et la raison. Causes courantes :

• Un fxmanifest.lua manquant, ou écrit pour une autre version de Cfx.re.
• Une dépendance non démarrée, nommée dans l’erreur.
• Une connexion à la base de données non configurée.
• Une erreur de syntaxe Lua, signalée avec un fichier et un numéro de ligne.

Téléchargements côté client

Les fichiers qu’une resource marque comme côté client sont téléchargés par chaque joueur à la connexion. Un serveur avec des centaines de mégaoctets d’assets en streaming a une première connexion très longue : retirez donc les modèles inutilisés avant d’ouvrir le serveur au public.