Script RedM : installer des scripts et ressources sur son serveur

Un script RedM s'installe sur le serveur sous la forme d'une ressource, un dossier rangé dans resources. Ce guide montre comment choisir un script fiable, vérifier qu'il est fait pour RedM, l'envoyer avec OuiPanel, le déclarer dans server.cfg et le démarrer. Les scripts et les mods de serveur RedM s'installent tous de cette façon.

Votre serveur, pris sur notre offre d'hébergement RedM, doit déjà démarrer avec sa clé Cfx.re. Si ce n'est pas le cas, suivez d'abord le guide Créer un serveur RedM : clé Cfx.re, server.cfg et txAdmin.

---

Choisir un script RedM fiable

Les auteurs publient leurs scripts sur le forum de Cfx.re, dans la catégorie RedM Releases, et sur leur page GitHub. Le titre d'un sujet donne en général deux informations.

• Le framework demandé, entre crochets, par exemple [VORP], [RSG], [REDEMRP], ou [Standalone] pour un script qui fonctionne seul.

• Le prix, avec [FREE] pour un script gratuit et [PAID] pour un script payant.

Un script prévu pour un framework ne marche qu'avec lui. Un script VORP ne tourne pas tel quel sur RSG. Pour installer le framework, suivez le guide VORP Core ou RSG Core : installer un framework RP sur son serveur RedM.

Installez seulement des scripts publiés par leur auteur. Une copie d'un script payant trouvée ailleurs viole sa licence et peut contenir du code que vous ne contrôlez pas.

Les scripts payants protégés

Beaucoup de scripts payants passent par le système d'escrow de Cfx.re. Après l'achat, vous recevez un lien de téléchargement et le script est lié à votre compte Cfx.re. Il ne démarre que sur un serveur dont la clé de licence appartient à ce même compte. Sinon, la console affiche « You lack the required entitlement ».

---

Vérifier qu'un script est fait pour RedM

Chaque ressource contient un fichier fxmanifest.lua qui la décrit. FXServer est strict sur ce fichier pour RedM. Ouvrez-le et cherchez ces trois lignes.

fx_version 'cerulean'
game 'rdr3'
rdr3_warning 'I acknowledge that this is a prerelease build of RedM, and I am aware my resources *will* become incompatible once RedM ships.'

• fx_version est obligatoire.

• game doit contenir rdr3. Une ressource prévue pour les deux jeux écrit games { 'rdr3', 'gta5' }. Une ressource en gta5 seul est refusée.

• rdr3_warning doit reprendre cette phrase exacte, sans changer un caractère.

• L'ancien fichier __resource.lua n'est pas accepté sur RedM.

Si l'une de ces règles manque, FXServer refuse de démarrer la ressource et l'écrit dans la console.

---

Envoyer le script sur le serveur

Les scripts se téléchargent le plus souvent en archive .zip. Envoyez-la telle quelle, OuiPanel la décompresse.

1. Dans OuiPanel, cliquez sur Gestionnaire de fichiers, puis ouvrez le dossier resources.

2. Glissez l'archive sur la page. Le calque « Déposez vos fichiers ici » apparaît, lâchez le fichier.

3. Cliquez sur ⋯ au bout de la ligne de l'archive, puis sur Décompresser, et confirmez. L'archive reste en place.

4. Ouvrez le dossier obtenu. Le fichier fxmanifest.lua doit se trouver directement dedans, pas dans un sous-dossier.

5. Si besoin, renommez le dossier avec Renommer. Retirez par exemple le suffixe -main qu'ajoute GitHub. Le nom du dossier devient le nom de la ressource.

6. Supprimez l'archive avec ⋯ › Supprimer.

Le bouton Importer URL télécharge aussi une archive directement sur le serveur. Collez-y le lien d'une version publiée sur GitHub.

Le glisser-déposer accepte 100 Mo par fichier. Au-delà, passez par le SFTP avec le guide Comment se connecter en SFTP avec FileZilla.

Rangez vos scripts dans un dossier entre crochets, par exemple [scripts]. FXServer le lit comme une catégorie, et une seule ligne ensure [scripts] démarre tout son contenu.

Si txAdmin a installé votre serveur

Une recette txAdmin, comme celles de VORP ou de RSG, crée son propre dossier de serveur dans txData, par exemple txData/vorp_123abc.base. Ses ressources et son server.cfg s'y trouvent. Déposez le script dans le dossier resources de ce dossier, pas dans celui de la racine.

---

Déclarer le script dans server.cfg

Un script ne démarre que si une ligne ensure le cite. FXServer lit ces lignes dans l'ordre, donc chaque dépendance doit venir avant le script qui l'utilise.

1. Dans la Console, arrêtez le serveur avec Arrêter.

2. Ouvrez server.cfg dans le Gestionnaire de fichiers.

3. Ajoutez la ligne du script après celles de la base de données et du framework.

4. Cliquez sur Sauvegarder, puis démarrez le serveur.

# Base de données
ensure oxmysql

# Framework
ensure vorp_core

# Vos scripts
ensure mon_script

Le fichier README d'un script liste ses dépendances. Avec un serveur installé par txAdmin, vous pouvez aussi modifier server.cfg depuis l'éditeur de configuration de txAdmin.

Au démarrage, la console affiche « Started resource mon_script » quand le script est chargé.

---

Démarrer le script sans redémarrer

Avec txAdmin, vous pouvez essayer un script sans couper le serveur. Tapez ces commandes dans la console en direct de txAdmin, appelée Live Console. La Console de OuiPanel ne transmet pas ces commandes au jeu quand txAdmin gère le serveur. Sans txAdmin, ajoutez la ligne ensure dans server.cfg, puis redémarrez le serveur.

1. Tapez refresh. FXServer relit le dossier resources et découvre le nouveau script.

2. Tapez ensure mon_script.

3. Lisez la console. Un démarrage réussi se termine par une ligne « Started resource mon_script ».

Ajoutez quand même la ligne ensure à server.cfg. Sans elle, le script ne repart pas au prochain démarrage.

Commande	Effet
refresh	Relit le dossier resources
ensure nom	Démarre la ressource, ou la redémarre si elle tourne
start nom	Démarre la ressource
stop nom	Arrête la ressource
restart nom	Redémarre la ressource

---

Configurer le script

Beaucoup de scripts se règlent dans un fichier config.lua, à la racine de la ressource ou dans un dossier config ou shared. On y trouve la langue, les prix, les positions ou les permissions.

1. Ouvrez le fichier dans le Gestionnaire de fichiers, modifiez-le, puis cliquez sur Sauvegarder.

2. Avec txAdmin, tapez restart mon_script dans la Live Console. Sans txAdmin, redémarrez le serveur.

Certains scripts fournissent un fichier .sql pour créer leurs tables. Importez-le dans votre base avec PhpMyAdmin. Le guide Créer une base de données MySQL pour son serveur de jeu sur OuiPanel explique comment y accéder.

---

Si le script ne démarre pas

La console de OuiPanel donne la raison. Voici les messages les plus courants de FXServer.

Message	Solution
Couldn't find resource mon_script.	Le nom du dossier diffère de la ligne ensure, ou le script est dans un sous-dossier de trop
Could not find dependency oxmysql for resource mon_script.	Installez la dépendance et placez sa ligne ensure avant celle du script
Resource mon_script does not support the current game (rdr3).	Le script est fait pour FiveM. Cherchez une version RedM
Resource mon_script does not contain the RedM pre-release warning in fxmanifest.lua.	La ligne rdr3_warning manque ou diffère de la phrase exacte
Resource mon_script is not using CitizenFXv2 manifest.	Le script utilise l'ancien __resource.lua. Demandez une version à jour à son auteur
You lack the required entitlement	Le script payant a été acheté avec un autre compte Cfx.re que celui de la clé du serveur

Une erreur peut aussi venir du côté du jeu. Dans RedM, la console F8 affiche les erreurs des scripts chargés chez le joueur.

---

Besoin d'aide ?

Ouvrez un ticket depuis Tickets › Ouvrir un ticket, ou depuis la tuile Contacter le support en bas de la fiche de votre serveur dans l'espace client. Vous pouvez aussi poser votre question sur le Discord de OuiHeberg.

Ouvrir un ticketDiscord