VORP Core ou RSG Core : installer un framework RP sur son serveur RedM

VORP Core et RSG Core sont deux frameworks roleplay open source pour RedM, écrits en Lua. Ils gèrent les personnages, l'argent, les métiers et l'inventaire, et chaque script RP indique pour lequel il est fait. Ce guide montre comment installer un framework RedM sur votre serveur, avec la recette txAdmin officielle de chaque projet ou à la main.

Votre serveur, pris sur notre offre d'hébergement RedM, doit déjà démarrer avec sa clé Cfx.re. Le guide Créer un serveur RedM : clé Cfx.re, server.cfg et txAdmin montre comment faire.

---

Choisir entre VORP Core et RSG Core

Les deux frameworks couvrent les mêmes besoins. Ce qui les sépare tient surtout à l'installation et aux scripts disponibles.

	VORP Core	RSG Core
Base de données	MySQL ou MariaDB, par oxmysql	MySQL ou MariaDB, par oxmysql
Recette txAdmin	Dans la liste Popular Recipes, ou par son adresse	Par son adresse, avec Remote URL Template
Compte Steam des joueurs	Exigé par la recette	Non exigé par la recette
Documentation	docs.vorp-core.com	rsgcore.com/docs
Code source	github.com/VORPCORE	github.com/Rexshack-RedM

Choisissez avant d'acheter des scripts. Un script VORP ne tourne pas tel quel sur RSG, et l'inverse non plus. RedEM:RP, un framework plus ancien, n'est pas traité ici.

---

Créer la base de données

VORP et RSG enregistrent les personnages et l'économie dans une base MySQL. Créez-la d'abord dans OuiPanel.

1. Dans le menu latéral, cliquez sur Bases de données, puis sur Créer une base de données.

2. Dans Nom de la base de données, saisissez par exemple vorp ou rsg, puis cliquez sur Créer la base de données.

3. Ouvrez la fenêtre Informations de la base et notez l'hôte, le port, le nom, le nom d'utilisateur et le mot de passe.

Le panel ajoute un préfixe au nom. La base vorp devient par exemple s123_vorp. Le guide Créer une base de données MySQL pour son serveur de jeu sur OuiPanel détaille chaque écran.

Le bouton « Insérer la connexion MySQL » de OuiPanel n'existe que pour FiveM. Sur RedM, la recette txAdmin écrit la connexion à votre place. À la main, vous l'écrivez dans server.cfg.

---

Installer VORP Core avec txAdmin

D'après VORP, sa recette officielle installe le framework, ses ressources principales, oxmysql et les tables de la base. Lancez-la à la première configuration de txAdmin. Si txAdmin est déjà configuré, la remise à zéro se trouve dans Settings › FXServer.

1. Dans l'assistant de txAdmin, nommez le serveur, puis choisissez Popular Recipes et VORP Core. Vous pouvez aussi choisir Remote URL Template et coller l'adresse de la recette ci-dessous.

2. Gardez le dossier proposé par txAdmin et passez à l'étape suivante.

3. Relisez la recette, puis cliquez sur Next.

4. Collez votre clé dans Server Registration Key.

5. Cliquez sur Show/Hide Database options (advanced). Remplissez Database Host, Database Port, Database Username et Database Password avec les valeurs notées dans OuiPanel.

6. Dans Database Name, saisissez le nom complet de votre base, préfixe compris. Laissez Delete Database décoché.

7. Cliquez sur Run Recipe et laissez le déploiement aller au bout.

8. Relisez le server.cfg proposé, puis cliquez sur Save & Run Server.

https://raw.githubusercontent.com/VORPCORE/VORP_txAdmin/main/vorp_recipe.yaml

La documentation de VORP propose d'appeler la base vorpv2. Chez OuiHeberg, gardez le nom de la base créée dans OuiPanel.

Dans sa version actuelle, la recette VORP règle sv_enforceSteamAuth sur true. Chaque joueur doit alors relier un compte Steam à son compte Cfx.re pour entrer. Ce réglage demande FXServer 38004 ou plus récent.

---

Installer RSG Core avec txAdmin

La documentation de RSG décrit l'installation par txAdmin avec sa propre recette. D'après elle, la recette installe RSG Core, ses ressources et les tables de la base.

1. Dans l'assistant de txAdmin, nommez le serveur, choisissez Remote URL Template et collez l'adresse ci-dessous.

2. Gardez le dossier proposé, relisez la recette, puis cliquez sur Next.

3. Remplissez Server Registration Key et les options de base de données comme pour VORP, avec le nom complet de votre base.

4. Cliquez sur Run Recipe, puis sur Save & Run Server.

https://raw.githubusercontent.com/Rexshack-RedM/txAdminRecipe/refs/heads/main/rsgcore.yaml

---

Installer un framework à la main

Sans txAdmin, ou pour choisir chaque ressource vous-même, le framework s'installe comme un script. Le guide Script RedM : installer des scripts et ressources sur son serveur détaille l'envoi des fichiers.

1. Téléchargez la dernière version d'oxmysql sur GitHub, puis les ressources du framework sur le GitHub officiel du projet.

2. Déposez-les dans resources et nommez les dossiers comme le demande le projet, par exemple vorp_core ou rsg-core.

3. Importez les tables avec PhpMyAdmin. Pour RSG, rsg-core demande les tables players et bans. Pour VORP, le fichier MariaDB.sql du dépôt VORP_txAdmin contient les tables de la recette.

4. Écrivez la connexion à la base dans server.cfg, puis les lignes ensure dans l'ordre.

La connexion à la base

oxmysql lit cette ligne. Placez-la avant les lignes ensure et remplacez les valeurs par celles de OuiPanel.

set mysql_connection_string "mysql://u123_AbCdEf:votre_mot_de_passe@mysql-xxx.ouiheberg.com:3306/s123_vorp?charset=utf8mb4"

L'ordre de démarrage

Ces lignes reprennent le début du server.cfg des recettes officielles. Voici celles de VORP Core.

ensure oxmysql
ensure vorp_menu
ensure vorp_lib
ensure vorp_core
ensure vorp_inputs
ensure vorp_progressbar
ensure vorp_inventory
ensure vorp_character

Et celles de RSG Core.

ensure oxmysql
ensure ox_lib
ensure rsg-core

Ajoutez ensuite les autres ressources du framework, puis vos scripts. La page installation manuelle de RSG et le dépôt de VORP Core donnent la liste complète.

---

Devenir administrateur du framework

Les recettes txAdmin ajoutent les identifiants de votre compte Cfx.re, celui lié à txAdmin, au groupe group.admin de FXServer. Chaque framework a en plus ses propres rangs.

Sur VORP Core

D'après la FAQ de VORP, ajoutez l'administrateur dans server.cfg et dans vorp_admin/vorp_perms.cfg, en suivant les exemples de ces fichiers. Passez ensuite à admin la colonne group de votre joueur dans les tables users et characters, avec PhpMyAdmin.

Sur RSG Core

add_principal identifier.license:xxxxxxxx rsgcore.god

Remplacez xxxxxxxx par votre identifiant de licence Rockstar. Un administrateur god peut ensuite donner un rang en jeu avec /addpermission, parmi god, developer, headadmin, admin, mod et helper.

Les identifiants et la syntaxe add_principal sont ceux de FiveM. Le guide Permissions ACE sur FiveM les explique.

---

Si le framework ne démarre pas

Message ou symptôme	Solution
Could not find dependency oxmysql for resource vorp_core.	oxmysql manque, ou sa ligne ensure vient après celle du framework
Access denied for user	Vérifiez l'utilisateur et le mot de passe dans mysql_connection_string
Unknown database	Le nom de la base est écrit sans son préfixe
Couldn't find resource vorp_core.	Le dossier est mal nommé, par exemple avec le suffixe -main
Le jeu demande de relier un compte Steam	C'est l'effet de sv_enforceSteamAuth true. Le joueur relie Steam à son compte Cfx.re, puis se reconnecte

Pour le fonctionnement interne d'un framework, sa documentation officielle reste la référence.

---

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