- Une ressource, tout le parcoursÉcran de chargement, menu principal, sélection de personnage, spawn et véhicule de départ dans une seule ressource.
- Apparaître au bon endroitDernière position, points de spawn par défaut, appartements ou logements, au choix dans un sélecteur de spawn.
- Panneau adminAttribuez des slots, désactivez ou réactivez des personnages et effectuez des character kills avec sauvegarde automatique.
- Configuration détectée automatiquementLe framework et le système d’apparence sont détectés au démarrage, sans réglage de framework à modifier.
Un script multicharacter FiveM avec écran de chargement et menu principal
Rarx Multicharacter (nom de ressource rarx_multicharacter) couvre tout, du moment où le joueur se connecte jusqu’à son arrivée dans le monde : un écran de chargement personnalisé, un menu principal aux couleurs de votre serveur, le sélecteur de personnage, un sélecteur de spawn et un véhicule de départ pour les nouveaux personnages.
Le framework est détecté au démarrage dans l’ordre qbx_core, qb-core, es_extended. Le système d’apparence est détecté de la même façon : le sélecteur affiche chaque personnage avec la ressource de vêtements que votre serveur utilise déjà.
Création et sélection de personnages avec slots configurables
- Créez, sélectionnez et, si vous l’autorisez, supprimez des personnages.
- Le nombre total de slots affichés et de slots débloqués par défaut est configurable, et le staff peut en accorder davantage par joueur.
- Filtre de mots interdits pour les noms, limites d’année de naissance et liste de nationalités configurable.
- Les fiches de personnage affichent les champs de votre choix : nom, métier, liquide, banque, téléphone, nationalité ou date de naissance.
- Couleurs principale et secondaire personnalisées et votre propre logo.
Sélecteur de spawn et véhicule de départ pour les nouveaux personnages
Après avoir choisi un personnage, les joueurs choisissent où apparaître : leur dernière position, l’un de vos points de spawn par défaut, ou un appartement ou une maison via les ressources de logement compatibles. Un routing bucket aléatoire évite que les joueurs se chevauchent pendant leur choix.
Les nouveaux personnages peuvent recevoir un véhicule de départ via un écran de sélection avec votre liste de modèles, ou en obtenir un au hasard dans la liste, sans interface. Le véhicule est envoyé au garage que vous configurez.
Panneau admin pour les slots, l’état des personnages et les character kills
Le staff ouvre le panneau admin avec /multicharadmin pour accorder ou retirer des slots, désactiver ou réactiver des personnages avec un motif obligatoire, et effectuer des character kills qui créent d’abord une sauvegarde automatique. Chaque action admin peut être envoyée vers des logs webhook distincts.
L’accès se donne par permissions ACE ou par une liste d’identifiants admin, les deux fonctionnant en parallèle. Sur ESX, utilisez la liste d’identifiants ou une ACE que vous accordez réellement, car l’ACE par défaut est propre à QBCore.
Tout est inclus
Fonctionnalités
Joueurs
- Création, sélection et suppression optionnelle de personnages
- Limites de slots configurables
- Filtre de noms, limites d’année de naissance et liste de nationalités
- Fiches d’infos de personnage personnalisables
- Sélecteur de spawn avec dernière position et spawns par défaut
- Sélecteur de véhicule de départ ou mode aléatoire
Écran de chargement et menu
- Fonds en vidéo, image ou lien vidéo
- Musique de fond et astuces qui défilent
- Logo, nom, slogan et couleurs du serveur
- Sections de règles, de commandes et personnalisées
- Barre de statistiques en direct : joueurs, uptime, staff
- Stream intégré au menu principal
Staff
- Panneau admin avec gestion des slots
- Désactivation et réactivation de personnages avec motif
- Character kill avec sauvegarde automatique de la base de données
- Logs webhook par type d’action
- Permissions par ACE et par identifiant
- Traductions anglaise et espagnole, fichiers de langue ouverts
Commandes
| Commande | Ce qu’elle fait | Accès |
|---|---|---|
/logout | Revient à la sélection de personnage (si Config.logoutCmd est activé) | — |
/relog | Revient à la sélection de personnage (Qbox uniquement) | — |
/multicharadmin | Ouvre le panneau admin | Permission ACE ou identifiants admin |
/setslots [identifier] [amount] | Attribue des slots de personnage débloqués à un joueur | Admin |
/removeslots [identifier] | Remet les slots d’un joueur à la valeur par défaut | Admin |
/disablecharacter | Désactive un personnage ([citizenid] sur QBCore/Qbox, [identifier] [slot] sur ESX) | Admin |
/enablecharacter | Réactive un personnage ([citizenid] sur QBCore/Qbox, [identifier] [slot] sur ESX) | Admin |
Avant d’installer
Compatibilité
Frameworks
- Qbox
qbx_core- QBCore
qb-core- ESX
es_extended
Détecté automatiquement au démarrage dans l’ordre qbx_core, qb-core, es_extended.
Ressources et base de données
Requises : ox_lib, oxmysql, rarx_lib (inclus), Une ressource d’apparence
Facultatives : rarx_clothing (recommandé), illenium-appearance, fivem-appearance, bl_appearance, origen_clothing ou qb-clothing, rarx_apartments, qb-apartments, 0r_motels ou origen_housing pour le choix du spawn
Base de données : Importez install/general.sql plus le fichier de votre framework (esx.sql, qb.sql ou qbox.sql). Toutes les tables utilisent IF NOT EXISTS.
Intégrations et langues
- Qbox : définissez useExternalCharacters = true dans qbx_core/config/client.lua.
- ESX Legacy : deux petits correctifs d’es_extended sont nécessaires, et esx_multicharacter, esx_skin et skinchanger doivent être retirés.
- QBCore avec qb-apartments : ajoutez l’export GetApartmentsConfig. qb-apartments et rarx_apartments ne peuvent pas être utilisés ensemble.
- Les logs webhook admin utilisent des URL de webhook compatibles Discord.
- La langue se définit avec la convar rarx-lang.
- Anglais
- Espagnol
Mise en place
Installation
- 01
Téléchargez et extrayez
Téléchargez la ressource depuis votre Cfx.re Portal et extrayez rarx_multicharacter et rarx_lib dans votre dossier resources.
- 02
Importez la base de données
Exécutez install/general.sql, puis le fichier de votre framework : esx.sql, qb.sql ou qbox.sql.
- 03
Lancez-les dans l’ordre
D’abord oxmysql, ox_lib et rarx_lib, puis votre framework et votre ressource d’apparence, et enfin le multicharacter.
ensure oxmysql ensure ox_lib ensure rarx_lib ensure es_extended # or qb-core / qbx_core ensure illenium-appearance # or your appearance resource ensure rarx_multicharacter - 04
Appliquez l’étape propre au framework
Qbox : activez useExternalCharacters. ESX : appliquez les correctifs d’es_extended décrits dans la documentation et retirez les ressources qu’il remplace.
- 05
Configurez et redémarrez
Modifiez config.lua (et ui/loadingConfig.js pour l’écran de chargement), puis redémarrez complètement le serveur.
Ceci est un résumé. La configuration, les exports, les events et le dépannage se trouvent dans la documentation complète.
Bon à savoir
Questions sur Rarx Multicharacter
Votre question n’est pas traitée ici ? Ouvrez un ticket sur notre Discord en indiquant votre framework et l’erreur que vous voyez.
Obtenir de l’aideEn savoir plus sur les scripts multicharacter FiveM →Quels frameworks Rarx Multicharacter prend-il en charge ?
Qbox, QBCore et ESX. Le framework est détecté automatiquement au démarrage dans l’ordre qbx_core, qb-core, es_extended.
Que dois-je installer ?
ox_lib, oxmysql, rarx_lib (inclus) et une ressource d’apparence comme rarx_clothing, illenium-appearance, fivem-appearance ou bl_appearance.
Sur ESX, l’écran de chargement se termine mais le sélecteur n’apparaît jamais. Pourquoi ?
es_extended est encore en mode personnage unique. Appliquez les deux correctifs d’es_extended décrits dans la documentation (Config.Multichar = true et désactivation systématique du spawn manager) et redémarrez complètement le serveur.
Les personnages ne fonctionnent pas sur Qbox. Que dois-je vérifier ?
Définissez useExternalCharacters = true dans qbx_core/config/client.lua pour que Rarx Multicharacter prenne en charge la sélection de personnage.
Pourquoi l’écran de chargement affiche-t-il le mauvais logo ?
L’écran de chargement s’exécute avant le chargement des scripts Lua : il lit ui/loadingConfig.js et non config.lua. Indiquez les mêmes valeurs dans les deux fichiers et redémarrez le serveur.
Puis-je utiliser mon propre écran de chargement ?
Oui. Définissez Config.Loading.enabled = false et commentez les lignes loadscreen dans fxmanifest.lua.
Qui peut ouvrir le panneau admin ?
Toute personne ayant la permission ACE ou figurant dans Config.AdminSystem.adminIdentifiers. Sur ESX, utilisez la liste d’identifiants ou une ACE que vous accordez, comme group.admin.
Continuez à explorer
