Installer EUP sur FiveM : l'exigence Element Club et l'ajout de vêtements personnalisés
EUP (Emergency Uniforms Pack) est un pack de vêtements qui ajoute au personnage multijoueur de GTA V des uniformes de police, de secours médicaux et de pompiers ; sur les serveurs roleplay (RP), il sert de base aux tenues des métiers. Dans ce guide, vous découvrirez l'exigence Element Club pour le streaming de vêtements personnalisés et comment activer l'abonnement dans le portail Cfx.re, comment installer les ressources EUP, comment intégrer les tenues au menu de vêtements de QBCore ou d'ESX, ainsi que les étapes de base pour ajouter votre propre pack de vêtements.
Avant de commencer
- Un FXServer fonctionnel : votre serveur doit être installé et démarrer sans erreur. Si ce n'est pas encore fait, suivez d'abord le guide d'installation de FXServer.
- Une clé serveur du portail Cfx.re : le serveur est lié à votre compte Cfx.re par la valeur
sv_licenseKeydeserver.cfg. Cette clé s'obtenait autrefois sur Keymaster ; elle se crée désormais dans le portail Cfx.re (portal.cfx.re). Les étapes sont décrites dans le guide de la clé de licence. - Un abonnement Element Club : la clé gratuite permet les véhicules moddés et les maps (YMAP), mais pas les vêtements personnalisés. Les vêtements exigent au minimum le palier Argentum (étape 1).
- Un pack adapté à FiveM : la version d'EUP distribuée comme mod solo et installée dans les fichiers du jeu avec OpenIV ne peut pas être utilisée telle quelle sur un serveur. Procurez-vous une version prête pour FiveM, qui contient un fichier manifeste (définition de la ressource) (
fxmanifest.lua, ou__resource.luadans les packs plus anciens) et un dossierstream. Lisez les conditions d'utilisation et de distribution du pack ; ne partagez pas de packs payants sans autorisation. - Accès aux fichiers et sauvegarde : vous vous connectez à un VDS Windows en RDP, et à un VDS Linux en SSH ou SFTP. Avant de commencer vos modifications, faites une copie de votre dossier
server-data.
La gamme que nous recommandons pour FiveM est le VDS AMD Ryzen 9 9950X, pour ses performances élevées en monocœur ; les offres se trouvent sur la page Location de serveur FiveM.
1. Activez Element Club dans le portail Cfx.re
FiveM n'active le streaming de vêtements personnalisés que pour les serveurs qui disposent des droits (entitlements) Element Club. D'après la page Element Club de Cfx.re, les paliers Argentum, Aurum et Platinum incluent tous le droit « Stream custom clothing » (streaming de vêtements personnalisés) ; les paliers se distinguent par le nombre de places joueurs et la visibilité dans la liste des serveurs. Pour EUP seul, Argentum suffit.
- Connectez-vous à
portal.cfx.reavec le compte Cfx.re qui vous a servi à créer votre clé serveur. - Ouvrez la page Subscriptions (abonnements,
portal.cfx.re/subscriptions), choisissez un palier Element Club pour FiveM et réglez le paiement. - Patientez : Cfx.re indique que l'activation des droits peut prendre jusqu'à 6 heures. Il est normal que les vêtements ne s'affichent pas pendant ce délai.
- Sur la page Registration Keys (clés d'enregistrement), vérifiez que la clé utilisée par votre serveur se trouve sur le même compte et a le statut Active, puis redémarrez le serveur.
L'abonnement s'applique à votre compte Cfx.re ; une clé créée sur un autre compte ne porte pas ces droits. Autrefois, l'abonnement s'achetait via Patreon et se liait à un compte du forum. Patreon n'accepte plus de nouvelles adhésions et la prise en charge des anciennes a pris fin ; si vous avez une ancienne adhésion Patreon, choisissez à nouveau le même palier dans le portail.
Les noms de fichiers montrent pourquoi la licence est déterminante. Les noms des fichiers de vêtements contiennent un caractère ^, par exemple mp_m_freemode_01_hh_police^jbib_000_u.ydd. Le client FiveM transforme ce caractère en séparateur de dossier et place le fichier dans la collection de vêtements nommée par la partie qui précède le caractère ; mais il ne fait cette correspondance que si la politique de licence du serveur l'autorise. Sans le droit, les fichiers ne sont pas appliqués au personnage, même s'ils sont téléchargés ; c'est vrai aussi bien pour les fichiers qui ajoutent de nouvelles pièces (add-on) que pour ceux qui remplacent une pièce du jeu (replace). Le caractère ^ ne désigne pas un accessoire (prop) ; les accessoires comme les chapeaux, les lunettes et les montres forment une catégorie distincte, avec le préfixe p_.
2. Envoyez les ressources EUP sur le serveur
Les packs EUP adaptés à FiveM sont généralement fournis avec trois dossiers de ressources :
| Ressource | Rôle |
|---|---|
NativeUI | La bibliothèque d'interface utilisée par le menu eup-ui |
eup-stream | Les modèles de vêtements (.ydd), les textures (.ytd) et les définitions de collections (.ymt) |
eup-ui | Le menu d'uniformes ouvert en jeu avec la commande /eup |
Les noms peuvent varier d'un pack à l'autre ; utilisez dans les étapes ci-dessous les noms de dossiers de votre propre pack. Regroupez ces dossiers dans un dossier entre crochets, comme [eup], sous resources dans le dossier de données du serveur ; FiveM ne traite pas un tel dossier comme une ressource, mais comme une catégorie qui regroupe plusieurs ressources.
Sous Windows, dans le « Command Prompt » (cmd, l'invite de commandes) :
mkdir "C:\FXServer\server-data\resources\[eup]"
Sous Linux :
mkdir -p ~/FXServer/server-data/resources/'[eup]'
Dans la commande Linux, la partie entre crochets est mise entre apostrophes, car le shell peut interpréter les caractères [ ] comme un motif de nom de fichier. Copiez ensuite les dossiers NativeUI, eup-stream et eup-ui dans le dossier créé (sous Linux, avec un client SFTP comme WinSCP ou FileZilla). En extrayant l'archive, veillez à ce que les dossiers ne soient pas imbriqués : le fichier manifeste doit se trouver directement dans le dossier eup-stream, et non dans un deuxième niveau comme eup-stream\eup-stream\. Si vous avez installé le serveur avec txAdmin, faites de même sous resources dans le dossier de données créé par txAdmin ; son emplacement est indiqué dans le guide txAdmin.
3. Ajoutez-les à server.cfg et redémarrez le serveur
Ajoutez ce qui suit dans server.cfg, après les lignes du framework que vous utilisez (QBCore ou ESX) :
ensure NativeUI
ensure eup-stream
ensure eup-ui
D'après la documentation des commandes serveur de FiveM, ensure démarre une ressource si elle ne tourne pas et la redémarre si elle tourne déjà. L'ordre compte : NativeUI, utilisé par le menu, doit démarrer avant la ressource eup-ui. Écrivez le nom de la ressource exactement comme le nom du dossier ; sous Linux en particulier, une différence de majuscules/minuscules empêche de trouver la ressource.
La commande refresh dans la console fait connaître les nouveaux dossiers au serveur en cours d'exécution, mais un redémarrage complet est plus fiable pour les packs de vêtements. Rejoignez le jeu et tapez /eup dans le chat : si le menu s'ouvre et que l'uniforme choisi apparaît sur votre personnage, l'installation est terminée. Si le menu s'ouvre mais que le personnage se retrouve avec des pièces invisibles, le problème vient très probablement de la licence ; consultez la section « Erreurs fréquentes ».
4. Intégrez les tenues à votre menu de vêtements
eup-ui apporte son propre menu ; le magasin de vêtements, la garde-robe des métiers et les tenues enregistrées qu'utilisent les joueurs proviennent en revanche de la ressource de vêtements du framework. qb-clothing dans QBCore et skinchanger dans ESX lisent dans le jeu le nombre de pièces de chaque catégorie (avec des fonctions comme GetNumberOfPedDrawableVariations). Grâce à cela, les pièces nouvellement streamées s'ajoutent à la fin de la catégorie concernée sans configuration supplémentaire : les numéros qui suivent les derniers hauts d'origine du jeu sont les hauts d'EUP.
Les tenues de métier (les tenues prêtes à l'emploi de la garde-robe de la police ou de l'EMS, c'est-à-dire les services médicaux d'urgence) sont en revanche définies par des numéros de catégorie, de drawable et de texture. Pour transformer un uniforme EUP en tenue de métier :
- Ouvrez le menu de vêtements en jeu et trouvez la pièce voulue ; notez sa catégorie, son numéro de drawable et son numéro de texture. Les numéros de composant des catégories figurent dans le tableau ci-dessous.
- Saisissez ces numéros dans les réglages des tenues de métier de votre framework. Dans qb-clothing, les définitions se trouvent dans la section
Config.Outfitsdeconfig.lua; la catégorie s'écrit par son nom (les hauts sonttorso2, les pantalonspants),itemest le numéro de drawable ettexturele numéro de texture. - Redémarrez la ressource et essayez la tenue sur un personnage de test.
Ces numéros ne sont pas définitifs : ils peuvent se décaler lorsque vous ajoutez ou retirez un pack ou que vous changez l'ordre de démarrage, et les tenues enregistrées affichent alors la mauvaise pièce. Démarrez toujours les packs dans le même ordre et revérifiez les tenues de métier après chaque modification.
Par défaut, le menu /eup est ouvert à tous les joueurs. Si vous voulez que seuls les joueurs du métier concerné puissent porter les uniformes, utilisez une ressource d'apparence capable de restreindre les composants par métier, par gang ou par permission ACE (contrôle d'accès) ; illenium-appearance, par exemple, le permet et nécessite ox_lib. Dans ce cas, vous pouvez retirer la ressource eup-ui (et aussi la ressource NativeUI si aucune autre ressource ne l'utilise) et ne garder que la ressource eup-stream ; les tenues se choisissent alors dans le menu de vêtements du framework.
5. Ajoutez votre propre pack de vêtements
Si vous ajoutez chaque pack de vêtements comme une ressource distincte, vous pouvez désactiver isolément un pack qui pose problème. La logique est la même que pour l'ajout d'un véhicule add-on : les fichiers du jeu vont dans le dossier stream, et les fichiers de définition .meta sont chargés par les lignes data_file du manifeste.
- Choisissez pour la ressource un nom en minuscules, sans accents ni caractères spéciaux (é, è, à, ç) et sans espaces, par exemple
hh-police. Les noms contenant une lettre accentuée, commevêtements_été, peuvent poser problème selon les systèmes d'exploitation et les outils. - Créez le dossier de la ressource et, à l'intérieur, le dossier
stream. Les commandes ci-dessous créent aussi les dossiers intermédiaires. Sous Windows (cmd) :
Sous Linux :mkdir "C:\FXServer\server-data\resources\[clothing]\hh-police\stream"mkdir -p ~/FXServer/server-data/resources/'[clothing]'/hh-police/stream - Placez les fichiers
.ydd,.ytdet.ymtdu pack dans le dossierstream, et les fichiers.meta, si le pack en contient, dans le dossier racine de la ressource. - Créez le fichier
fxmanifest.luadans le dossier racine (exemple ci-dessous). - Ajoutez la ligne
ensure hh-policeàserver.cfget redémarrez le serveur.
La structure obtenue ressemble à ceci :
resources/
[clothing]/
hh-police/
fxmanifest.lua
mp_m_freemode_01_hh_police.meta
mp_f_freemode_01_hh_police.meta
stream/
mp_m_freemode_01_hh_police.ymt
mp_m_freemode_01_hh_police^jbib_000_u.ydd
mp_m_freemode_01_hh_police^jbib_diff_000_a_uni.ytd
mp_f_freemode_01_hh_police.ymt
mp_f_freemode_01_hh_police^jbib_000_u.ydd
mp_f_freemode_01_hh_police^jbib_diff_000_a_uni.ytd
Exemple de fxmanifest.lua :
fx_version 'cerulean'
game 'gta5'
files {
'mp_m_freemode_01_hh_police.meta',
'mp_f_freemode_01_hh_police.meta'
}
data_file 'SHOP_PED_APPAREL_META_FILE' 'mp_m_freemode_01_hh_police.meta'
data_file 'SHOP_PED_APPAREL_META_FILE' 'mp_f_freemode_01_hh_police.meta'
Inutile de lister séparément dans le manifeste les fichiers du dossier stream. Le bloc files envoie les fichiers .meta aux joueurs, et les lignes data_file les chargent comme définitions du magasin de vêtements. Si votre pack n'a pas de fichiers .meta, supprimez ces deux sections ; seules les deux premières lignes restent. L'exemple comprend des fichiers masculins et féminins ; ne listez que ceux que votre pack contient réellement. Le détail des directives fx_version, file (au pluriel files) et data_file figure dans la documentation du manifeste de ressource.
Ne renommez pas les fichiers. La partie qui précède le caractère ^ (mp_m_freemode_01_hh_police) est le nom de la collection, et ce même nom figure aussi dans le fichier .ymt ; mp_m_freemode_01 désigne le personnage multijoueur masculin et mp_f_freemode_01 le personnage féminin. Si un nom de fichier commence directement par mp_m_freemode_01^, le pack n'ajoute pas de nouveau numéro : il remplace la pièce du jeu qui porte le même numéro (replace). Deux packs différents qui utilisent le même nom de collection peuvent entrer en conflit ; au lieu de renommer les fichiers à la main, utilisez la sortie de l'outil qui a créé le pack ou contactez son auteur.
Numéros de composant et préfixes de fichiers
Le préfixe du nom de fichier indique à quelle catégorie appartient la pièce. Les fonctions du jeu et les menus de vêtements identifient les catégories par ces numéros :
| Préfixe du fichier | Numéro | Sur le personnage multijoueur |
|---|---|---|
berd | Composant 1 | Masque |
hair | Composant 2 | Cheveux |
uppr | Composant 3 | Bras et mains |
lowr | Composant 4 | Pantalon |
hand | Composant 5 | Sac et parachute |
feet | Composant 6 | Chaussures |
teef | Composant 7 | Accessoire (collier, cravate, insigne) |
accs | Composant 8 | Sous-haut (t-shirt) |
task | Composant 9 | Gilet et gilet pare-balles |
decl | Composant 10 | Emblème et décalcomanie |
jbib | Composant 11 | Haut (veste, chemise) |
p_head | Prop 0 | Chapeau et casque |
p_eyes | Prop 1 | Lunettes |
p_ears | Prop 2 | Accessoire d'oreille |
p_lwrist | Prop 6 | Montre |
p_rwrist | Prop 7 | Bracelet |
Le fichier de modèle (.ydd) porte la forme de la pièce, et les fichiers de texture (.ytd) de même numéro portent les options de couleur et de motif ; dans le menu, celles-ci apparaissent comme des couleurs de la même pièce.
Erreurs fréquentes
- Le menu s'ouvre, mais le personnage se retrouve avec des pièces invisibles, ou les vêtements ne s'affichent pas du tout : la cause la plus fréquente est la licence. Vérifiez que votre abonnement Element Club apparaît comme actif dans le portail, que 6 heures se sont écoulées depuis la souscription et que vous avez redémarré le serveur ensuite. Vérifiez ensuite que la ressource démarre sans erreur dans la console et que les noms de fichiers n'ont pas changé.
- La licence ne correspond pas ; vous avez un abonnement, mais les droits n'arrivent pas : la clé du serveur n'a pas été créée sur le compte avec lequel vous vous êtes abonné. Cherchez la clé de
server.cfgdans la liste Registration Keys du portail ; si elle n'y figure pas, créez une nouvelle clé sur ce compte et saisissez-la dans la configuration. Si vous utilisez txAdmin, vérifiez la clé dans la configuration de txAdmin ; le fichier ne doit pas contenir deux lignessv_licenseKey. Si la console affiche « not matching the initial IP address », vous utilisez une ancienne clé Keymaster liée à une adresse IP ; créez une nouvelle clé dans le portail. - La commande
/eupne fonctionne pas : NativeUI n'a pas démarré, ou démarre après la ressource eup-ui. Vérifiez l'ordre desensureet les noms des dossiers ; des dossiers imbriqués créés lors de l'extraction de l'archive empêchent aussi de trouver la ressource. - Une pièce apparaît sans texture ou dans la mauvaise couleur : la texture
.ytddu modèle est manquante, ou son nom ne correspond pas au modèle. Copiez à nouveau les fichiers avec les noms d'origine du pack. Si vous soupçonnez un conflit avec un autre pack, désactivez les packs un par un pour trouver celui qui pose problème. - Les tenues enregistrées et les tenues de métier affichent la mauvaise pièce : un nouveau pack ou un ordre de démarrage modifié a décalé les numéros. Relevez à nouveau les numéros dans le menu et saisissez-les dans les réglages.
- L'avertissement « You lack the required entitlement » : un pack de vêtements chiffré (escrow) acheté sur une boutique comme Tebex est utilisé avec une clé qui n'appartient pas au compte Cfx.re qui l'a acheté. Utilisez la clé de ce compte sur le serveur.
Questions fréquentes
Puis-je utiliser EUP avec une clé de licence gratuite ?
Non. Avec une clé gratuite, vous pouvez faire tourner le serveur et streamer des véhicules moddés et des maps ; le droit de streamer des vêtements personnalisés n'existe en revanche que dans les paliers Element Club. Sans ce droit, les fichiers EUP ne sont pas appliqués au personnage, même s'ils sont téléchargés.
De quel palier Element Club ai-je besoin ?
Argentum, le palier le plus bas, suffit. Aurum et Platinum offrent davantage de places joueurs, en plus du même droit sur les vêtements. Les limites de places des paliers sont comparées dans le tableau du guide de la licence.
Les joueurs doivent-ils télécharger EUP séparément ?
Non. Les fichiers du dossier stream sont téléchargés automatiquement lorsqu'un joueur se connecte au serveur. Plus le pack est volumineux, plus la première connexion est longue ; lors des visites suivantes, les fichiers inchangés sont généralement chargés depuis le cache du joueur.
Que se passe-t-il si je résilie l'abonnement ?
À la fin de l'abonnement, les droits sont aussi retirés et le serveur revient aux limites de la clé gratuite : la limite de joueurs redescend à la valeur par défaut de 48, et les vêtements personnalisés ne sont plus appliqués au personnage. Les fichiers de vêtements restent sur le serveur ; si vous reprenez l'abonnement, ils fonctionnent de nouveau une fois les droits appliqués.
Guides associés
- Clé de licence FiveM : enregistrer un serveur sur le portail Cfx.re
- Installer FXServer : un serveur FiveM de zéro (Windows et Linux)
- Comment installer QBCore : recette txAdmin, installation manuelle et premier admin
- Comment ajouter des véhicules add-on à un serveur FiveM (fxmanifest et stream)
- Utiliser txAdmin : guide de gestion d'un serveur FiveM
- Tous les guides FiveM : catégorie des guides FiveM
Commentaires0
Pas encore de commentaire
Soyez le premier à partager votre avis.
Veuillez vous connecter ou vous inscrire pour laisser un commentaire.