Comment ajouter un blips sur son serveur FiveM ?

Bienvenue chez HanoHost Hébergement ! Si vous êtes ici, c’est probablement parce que vous avez ouvert votre carte sur votre serveur FiveM et que vous avez eu l’impression de regarder un désert vide. C’est frustrant, n’est-ce pas ? On a tous connu ce moment de solitude où, après avoir passé des heures à configurer un script, on se rend compte que personne ne peut trouver le lieu parce qu’il n’y a pas ce petit icône magique sur la carte.

Ces icônes, ce sont les blips.

Aujourd’hui, nous allons voir ensemble, étape par étape, comment maîtriser l’art du blip. Que vous soyez un vétéran du code Lua ou un débutant complet qui vient de louer son premier VPS chez nous, ce guide est fait pour vous. Installez-vous confortablement, prenez un café (ou une boisson énergisante, on ne juge pas), et c’est parti.

Qu’est-ce qu’un Blip et pourquoi est-ce vital ?

Avant de plonger dans le code, posons les bases. Un blip, dans le jargon de Grand Theft Auto, c’est cette petite icône qui apparaît sur votre radar (mini-map) et sur le menu pause (la grande carte). C’est littéralement le GPS de vos joueurs.

Imaginez que vous organisiez une énorme soirée RP au Bahamas Mamas. Si vous ne mettez pas de blip, c’est comme inviter des amis à une crémaillère sans leur donner l’adresse : ils vont tourner en rond, s’énerver, et finir par se déconnecter.

Sur un serveur FiveM, les blips servent à :

  • Localiser les points d’intérêt (Poste de police, Hôpital, Concessionnaire).
  • Guider les joueurs vers des missions ou des jobs.
  • Créer une identité visuelle pour votre serveur.

Chez HanoHost, on voit trop souvent des serveurs avec des cartes illisibles. Soit il n’y a rien, soit c’est un sapin de Noël surchargé. Notre objectif ici, c’est l’équilibre.

Les Prérequis : Ce dont vous avez besoin

Pas besoin d’avoir un doctorat en informatique, mais il vous faut quelques outils de base :

  1. Un éditeur de code : Visual Studio Code est la référence absolue (et c’est gratuit).
  2. Un accès à vos fichiers serveur : Via FileZilla ou le panel de gestion HanoHost.
  3. Les coordonnées : L’endroit exact (X, Y, Z) où vous voulez placer votre point.

L’astuce de pro : Pour récupérer des coordonnées rapidement en jeu, activez votre menu admin ou un script de développement et utilisez une commande type /coords ou /pos. Notez-les bien, c’est la base de tout.

Hebergeur FiveM

Méthode 1 : La méthode « Standalone » (Code Lua pur)

C’est ma méthode préférée. Pourquoi ? Parce qu’elle ne dépend d’aucun framework (ESX, QBCore, VRP). Elle fonctionnera tout le temps, même si vous changez tout le reste. C’est un peu comme savoir changer une roue soi-même au lieu d’appeler la dépanneuse : c’est gratifiant et ça sauve la mise.

A lire aussi :  Comment désactiver les coups de crosse sur FiveM ?

Nous allons créer un petit script simple.

Étape 1 : Créer l’architecture

Dans votre dossier resources, créez un dossier nommé hano_blips (par exemple). À l’intérieur, créez deux fichiers :

  • fxmanifest.lua
  • client.lua

Étape 2 : Le fxmanifest.lua

C’est la carte d’identité de votre ressource. Copiez ceci :

fx_version 'cerulean'
game 'gta5'

author 'HanoHost Team'
description 'Gestion simple des blips'
version '1.0.0'

client_script 'client.lua'

Étape 3 : Le cœur du réacteur (client.lua)

Voici le code magique. Nous allons utiliser une boucle pour créer les blips au démarrage du script.

-- Table de configuration : Ajoutez vos points ici
local blips = {
    {title="Commissariat", colour=38, id=60, x=425.1, y=-979.5, z=30.7},
    {title="Hôpital", colour=1, id=61, x=294.6, y=-1448.6, z=29.9},
    {title="Concessionnaire", colour=50, id=225, x=-33.7, y=-1102.0, z=26.4}
}

Citizen.CreateThread(function()
    for _, info in pairs(blips) do
      -- Création du point sur la carte
      info.blip = AddBlipForCoord(info.x, info.y, info.z)
      
      -- Définir l'icône (Sprite)
      SetBlipSprite(info.blip, info.id)
      
      -- Définir le comportement (Affichage)
      SetBlipDisplay(info.blip, 4)
      
      -- Définir la taille
      SetBlipScale(info.blip, 0.9)
      
      -- Définir la couleur
      SetBlipColour(info.blip, info.colour)
      
      -- IMPORTANT : Pour que le blip ne soit visible que de près sur la minimap
      SetBlipAsShortRange(info.blip, true)
      
      -- Ajouter le texte
      BeginTextCommandSetBlipName("STRING")
      AddTextComponentString(info.title)
      EndTextCommandSetBlipName(info.blip)
    end
end)

Analyse du code :

Nous utilisons Citizen.CreateThread pour lancer l’action. La fonction AddBlipForCoord pose le marqueur. Ensuite, nous le personnalisons. C’est comme peindre une figurine : d’abord on l’assemble, ensuite on met les couleurs.

Méthode 2 : Via votre Framework (ESX ou QBCore)

On le sait, 90% d’entre vous utilisent un framework. C’est pratique, c’est comme les meubles en kit : tout est pré-percé. Cependant, gardez à l’esprit que cela peut parfois alourdir votre serveur si c’est mal géré.

Si vous utilisez ESX

Généralement, cela se passe dans le fichier config.lua de vos scripts (ex: esx_policejob).

Vous trouverez souvent une section qui ressemble à ça :

Config.Blip = {
    Coords  = vector3(425.1, -979.5, 30.7),
    Sprite  = 60,
    Display = 4,
    Scale   = 1.0,
    Colour  = 29
}

Il suffit de modifier les valeurs ici. Attention : Si vous ajoutez un blip via un script standalone ET via le config.lua d’un job, vous aurez deux icônes superposées. C’est l’erreur classique du débutant, et franchement, ça fait « sale ». Vérifiez toujours vos doublons.

La Bible de la Personnalisation : Sprites, Couleurs et ID

C’est ici que vous pouvez exprimer votre créativité. GTA V offre une bibliothèque immense d’icônes. Mais comment savoir quel chiffre correspond à quelle image ?

Les Sprites (L’icône)

Le SetBlipSprite attend un numéro (ID).

  • Police : 60
  • Hôpital : 61
  • Magasin de vêtements : 73
  • Garage : 357

Pour trouver la liste complète, notre meilleur ami à tous est la documentation officielle de FiveM (docs.fivem.net). Ils ont une page dédiée aux blips qui est mise à jour à chaque DLC de GTA Online. Oui, même les icônes du dernier DLC « The Chop Shop » sont disponibles si votre serveur est à jour (ce qui est le cas si vous êtes hébergé chez HanoHost, car nos artefacts sont toujours top niveau).

Les Couleurs

Pareil, SetBlipColour utilise des ID.

  • Rouge : 1
  • Vert : 2
  • Bleu : 3
  • Jaune : 5
  • Blanc : 0
A lire aussi :  Agence web ou freelance : comment faire le bon choix pour lancer votre projet en ligne ?

Mon avis personnel : N’abusez pas des couleurs fluo. Une carte élégante utilise des codes couleurs cohérents. Par exemple, tout ce qui est illégal en rouge, les services publics en bleu, les commerces en vert. La lisibilité, c’est la clé de l’expérience utilisateur (UX).

La Taille (Scale)

La valeur standard est 1.0.

  • Si vous mettez 0.5, ce sera tout petit (discret).
  • Si vous mettez 2.0, ce sera énorme.

Évitez de dépasser 1.2, sinon votre carte va ressembler à un livre de coloriage d’enfant de 4 ans.

Astuces Avancées et « Best Practices »

Ajouter un point, c’est facile. Mais bien le faire, c’est un art. Voici quelques conseils que nous donnons souvent à nos clients chez HanoHost pour optimiser leurs serveurs.

1. La fonction « Short Range »

Dans le code Lua plus haut, vous avez vu SetBlipAsShortRange(info.blip, true).

  • Si mis sur true : Le blip est visible sur la grande carte (Echap), mais sur la mini-map en bas à gauche, il n’apparaît que si vous êtes proche.
  • Si mis sur false : Le blip est toujours visible sur la mini-map, même si vous êtes à l’autre bout de la ville.Conseil : Mettez toujours true, sauf pour des trucs critiques comme une alerte de police ou un point de livraison de mission temporaire. Sinon, la boussole du joueur devient inutilisable.

2. Les Blips de Zone (Radius)

Parfois, vous ne voulez pas un point précis, mais une zone (ex: zone de gang, zone de chasse).

Pour cela, on utilise AddBlipForRadius.

local blip = AddBlipForRadius(coords.x, coords.y, coords.z, 100.0) -- 100.0 est le rayon
SetBlipColour(blip, 1)
SetBlipAlpha(blip, 128) -- Transparence (0-255)

La transparence est cruciale ici. Une zone opaque cache les routes en dessous, ce qui est très gênant pour la conduite.

3. L’organisation du code

Ne créez pas 50 scripts différents pour vos blips (blip_police, blip_hopital, blip_karting). Faites un seul script (comme notre hano_blips plus haut) qui regroupe tous les blips « fixes » de la carte. Votre serveur chargera plus vite, et votre dossier resources sera plus propre. Votre futur vous vous remerciera quand il faudra faire une modification dans 6 mois.

Dépannage : « Au secours, ça ne marche pas ! »

Même les meilleurs développeurs font des erreurs. Si votre blip n’apparaît pas, voici la checklist de survie :

  1. Le script est-il lancé ? Vérifiez votre server.cfg. Avez-vous bien mis ensure hano_blips ?
  2. Les coordonnées sont-elles bonnes ? Une erreur classique est d’inverser X et Y, ou d’oublier le signe « moins ». Si votre blip est au milieu de l’océan, c’est sûrement ça.
  3. La console F8 : En jeu, appuyez sur F8. Si vous voyez du texte rouge, c’est qu’il y a une erreur de syntaxe dans votre Lua (souvent une virgule manquante ou une parenthèse oubliée).
  4. Le Cache : Parfois, FiveM est capricieux. Videz votre cache (ou redémarrez le serveur via le panel HanoHost, c’est ultra rapide).

Conclusion

Ajouter des blips sur votre serveur FiveM, ce n’est pas sorcier, mais c’est une étape fondamentale pour rendre votre monde vivant et accessible. C’est la différence entre un serveur brouillon et un projet professionnel.

Nous avons vu comment le faire en Lua « pur », comment le gérer via les frameworks, et surtout comment le faire avec goût et optimisation.

N’oubliez pas que chez HanoHost Hébergement, nous sommes là pour vous fournir la puissance nécessaire pour faire tourner tout ça. Un script de blips ne consomme rien, mais quand vous aurez 500 scripts et 64 joueurs, vous serez bien content d’avoir une infrastructure solide derrière vous.

Alors, à vos claviers, ouvrez VS Code, et commencez à cartographier votre monde. Bonne chance pour votre serveur, et à très bientôt sur nos réseaux !

Comment ajouter un blips sur son serveur FiveM