Icône FiveM, bannière, tags et couleurs du serveur : améliorez votre liste

Votre serveur est en ligne, mais dans la liste des serveurs, c'est un nom simple avec une icône grise par défaut. Ce guide couvre les lignes du server.cfg qui contrôlent l'apparence de votre serveur dans la liste et sur l'écran de connexion : l'icône, les bannières, le nom coloré, les tags, la locale et un lien Discord.

#L'icône du serveur

load_server_icon myLogo.png

Mettez myLogo.png dans votre dossier de données du serveur, celui qui contient server.cfg, et donnez-lui exactement cette forme :

• 96x96 pixels.
• Format PNG.
• Un design simple et lisible. Il est affiché très petit.

Si l'icône n'apparaît pas, vérifiez le nom du fichier et la casse (sur Linux, Logo.png et logo.png sont des fichiers différents), la taille et que la ligne n'est pas commentée. La console imprime un message si le fichier ne peut pas être chargé.

#Le nom et la description

sets sv_projectName "My Server"
sets sv_projectDesc "A friendly roleplay server, active staff, custom jobs"

sv_projectName est le nom que les gens voient dans la liste, et sv_projectDesc est la courte description en dessous. Gardez le nom court pour qu'il ne soit pas coupé sur les petits écrans. La forme sets publie la valeur dans la liste, par rapport à set, qui la garde privée.

#Codes couleur

Les codes couleur commencent par ^ et un chiffre. Le texte après le code prend cette couleur jusqu'au code suivant :

sets sv_projectName "^1My ^5Server"

Codes courants : ^1 rouge, ^2 vert, ^3 jaune, ^4 bleu, ^5 bleu clair, ^6 pourpre, ^7 blanc, ^8 rouge foncé, ^9 rose, ^0 blanc par défaut. Réinitialisez avec ^0 ou ^7. Deux couleurs suffisent ; un nom arc-en-ciel semble bon marché et est difficile à lire.

Conseil : si la couleur semble mauvaise dans la liste mais bonne en jeu, la liste peut afficher une valeur en cache. Voir « Pourquoi les modifications prennent du temps » ci-dessous.

#Bannières

sets banner_detail "https://example.com/banner-detail.png"
sets banner_connecting "https://example.com/banner-connecting.png"

• banner_detail est l'image sur la page de détails de votre serveur dans la liste.
• banner_connecting est l'image affichée pendant qu'un joueur se connecte.

Les deux prennent une URL vers une image. L'image doit être hébergée quelque part qui reste en ligne et la sert directement, sans connexion ni page autour. Un lien Discord CDN peut expirer ou changer, donc un hôte que vous contrôlez est plus sûr. Utilisez une large image et gardez la taille du fichier raisonnablement petite pour qu'elle se charge rapidement.

Si vous voulez également votre propre écran de chargement une fois que le joueur a rejoint, voir custom loading screen.

#Tags et locale

sets tags "roleplay, esx, english, economy"
sets locale "en-US"

Les tags sont des mots-clés, séparés par des virgules, que les joueurs utilisent pour trouver un serveur dans la liste. Choisissez des tags qui décrivent le serveur véridiquement : le framework, le type (roleplay, racing), la langue. Ne les remplissez pas avec des mots sans rapport, ce qui ne fait que les joueurs partir.

locale est la langue et la région du serveur, sous la forme en-US, fr-FR et ainsi de suite.

#Le lien Discord

sets Discord "https://discord.gg/yourinvite"

sets vous permet de publier des paires clé-valeur supplémentaires, et de nombreux serveurs en utilisent une pour leur Discord. Les joueurs le voient dans les détails du serveur. Utilisez une invitation permanente qui n'expire jamais, car un lien expiré est pire que rien.

#Pourquoi les modifications prennent du temps à s'afficher

Vous avez modifié server.cfg, redémarré, et la liste affiche toujours l'ancienne icône ou le nom. C'est normal, pour trois raisons :

1. Le serveur lit sa config au démarrage. Une modification ne fait rien jusqu'à ce que vous redémarriez. Redémarrez le serveur à partir de txAdmin.
2. La liste est mise en cache. Le serveur envoie ses infos à la liste Cfx.re régulièrement, et la liste en garde des copies. Cela peut prendre plusieurs minutes pour la mise à jour.
3. Votre client le met aussi en cache. Le client FiveM peut conserver une ancienne copie des détails du serveur. Si quelques minutes passent et votre client affiche toujours l'ancienne version, redémarrez FiveM. Si c'est seulement votre client qui l'affiche, rien ne va mal avec le serveur.

Donc après une modification : redémarrez le serveur, attendez et vérifiez à partir d'un compte ou d'une machine différente si vous le pouvez. N'éditez pas entre-temps, car chaque redémarrage redémarre l'attente.

#Un exemple complet

load_server_icon myLogo.png
sets sv_projectName "^5My ^7Server"
sets sv_projectDesc "A friendly roleplay server"
sets tags "roleplay, english"
sets locale "en-US"
sets Discord "https://discord.gg/yourinvite"
sets banner_detail "https://example.com/banner-detail.png"
sets banner_connecting "https://example.com/banner-connecting.png"

Pour le reste du fichier, voir server.cfg explained. Si votre serveur ne s'affiche pas du tout dans la liste, c'est un problème différent : server not showing: port forwarding.

#Liste de contrôle