Ce guide a pour but d'initier les lecteurs à l'écriture de scripts LUA dans le contexte de FiveM, un cadre de modification populaire pour GTA V. Nous aborderons les éléments essentiels de LUA, la manière dont il s'intègre à FiveM et les étapes nécessaires à la mise en place d'un environnement de développement à l'aide de Visual Studio Code (VSCode). À la fin de cet article, les lecteurs disposeront d'un environnement de développement fonctionnel et d'une compréhension de base des scripts LUA pour FiveM.

LUA est-il difficile à apprendre ? Chaque début est difficile, mais LUA est un langage de codage très facile.

Qu'est-ce que le script LUA ?

LUA est un langage de programmation léger et de haut niveau conçu pour être intégré dans des applications. Il est connu pour sa simplicité, sa facilité d'intégration et sa rapidité d'exécution. Développé à l'origine en 1993, LUA a été largement adopté dans divers domaines, en particulier dans le développement de jeux, en raison de sa flexibilité et de sa syntaxe minimaliste.

1. Léger : L'ensemble de l'interpréteur LUA est de petite taille, ce qui le rend idéal pour être intégré dans d'autres programmes.
2. Facile à apprendre : La syntaxe de LUA est simple et facile à comprendre, ce qui en fait un excellent choix pour les débutants.
3. Flexible et dynamique : LUA prend en charge le typage dynamique et la programmation flexible orientée objet, ce qui permet un prototypage et des modifications rapides.
4. Extensible : LUA peut facilement être étendu avec des bibliothèques et des fonctionnalités personnalisées, ce qui le rend très adaptable à différents besoins.

Pourquoi utiliser LUA dans FiveM?
Dans le contexte de FiveM, LUA est le principal langage de script utilisé pour interagir avec le moteur de jeu. Il permet aux développeurs d'écrire des scripts qui peuvent :

• Contrôler la logique du jeu (par exemple, l'apparition de voitures, la modification des statistiques des joueurs).
• Gérer les événements et les interactions avec les joueurs.
• Créez des modes de jeu, des missions et des activités personnalisés.
• Interface avec des sources de données externes et des API. (même les ChatGPT)

Le code de FiveM fournit un riche ensemble de fonctions natives et de gestionnaires d'événements accessibles via des scripts LUA, ce qui permet d'étendre et de personnaliser presque tous les aspects du jeu.

Introduction à FiveM et à ses capacités de script LUA

FiveM est un cadre de modification multijoueur pour GTA V, permettant aux joueurs de se connecter à des serveurs dédiés avec des modes de jeu et du contenu personnalisés. Contrairement au mode multijoueur standard de GTA V, FiveM permet aux propriétaires de serveurs d'utiliser des mods, des scripts et des ressources personnalisées pour créer des expériences uniques pour les joueurs.

Les capacités de script LUA de FiveM sont les suivantes :

1. Scripting côté serveur : Scripts qui s'exécutent sur le serveur, gérant des tâches telles que l'authentification des joueurs, le stockage des données et les événements du monde. -> server.lua
2. Scripting côté client : Scripts qui s'exécutent sur les clients des joueurs individuels, permettant de personnaliser les éléments de l'interface utilisateur, de gérer les événements côté client et d'interagir avec les scripts côté serveur. -> client.lua
3. Script partagé : Scripts qui peuvent être exécutés à la fois sur le client et le serveur, permettant des actions synchronisées et des fonctionnalités partagées. -> shared.lua

Avec FiveM, les développeurs peuvent créer des modes de jeu personnalisés tels que des serveurs de jeu de rôle, des compétitions de course et des mini-jeux. LUA sert d'épine dorsale à ces scripts, en fournissant la logique et le contrôle nécessaires pour interagir avec le monde du jeu et les joueurs.

Mise en place d'un environnement de développement

Pour commencer à écrire des scripts avec LUA dans FiveM, vous devez mettre en place un environnement de développement approprié. Cette section vous guidera tout au long du processus d'installation de Visual Studio Code, de sa configuration pour le développement LUA et de la mise en place d'un environnement de serveur FiveM de base pour tester vos scripts.

Étape 1 : Installer Visual Studio Code (VSCode)

Code de Visual Studio est un éditeur de code libre et gratuit développé par Microsoft. Il est léger, riche en fonctionnalités et prend en charge différents langages de programmation, dont LUA.

1. Télécharger VSCode :
   • Visitez le site Site web de Visual Studio Code.
   • Téléchargez le programme d'installation correspondant à votre système d'exploitation (Windows, macOS, Linux).
   • Exécutez le programme d'installation et suivez les instructions d'installation.
2. Installer les extensions LUA :
   • Ouvrez VSCode, cliquez sur l'icône Extensions dans la barre latérale gauche ou appuyez sur la touche Ctrl+Shift+XRecherchez "Lua" et installez une extension telle que "Lua Language Server" ou "Lua Plus". Ces extensions permettent la mise en évidence de la syntaxe, l'achèvement du code et d'autres fonctions utiles.

# Exemple de commande pour installer une extension Lua à partir de la place de marché VSCode
ext install sumneko.lua

Étape 2 : Mise en place d'un environnement de serveur FiveM

Écrire et tester des scripts LUA, vous avez besoin d'un serveur FiveM local. Suivez les étapes suivantes pour créer votre environnement de développement :

1. Télécharger les fichiers du serveur FiveM :
   • Visitez le site Site officiel de FiveM.
   • Téléchargez les derniers fichiers du serveur FiveM. -> Fenêtres
2. Extraire et configurer le serveur :
   • Créez un nouveau dossier sur votre ordinateur (par ex, C:\FiveMServer).
   • Extraire les fichiers du serveur FiveM dans ce répertoire.
   • Dans le dossier du serveur, créez un nouveau sous-dossier nommé ressources. C'est là que résideront vos scripts et ressources personnalisés.
3. Créer une configuration de base du serveur :
   • A la racine du dossier de votre serveur FiveM, vous trouverez un server.cfg
   • Ce fichier est le fichier de configuration pour la plupart des paramètres :

Fichier de configuration du serveur # Basic FiveM

Nom et description du serveur #
sv_hostname "Mon serveur de développement FiveM"
sv_description "Un serveur de développement pour tester des scripts LUA"

# Nombre maximal de joueurs
sv_maxclients 32

# Répertoires de ressources
assurer le gestionnaire de cartes
assurer le chat
assurer spawnmanager
Assurer le gestionnaire de session
assurer fivem
assurer hardcap
assurer rconlog

# Ajouter des ressources personnalisées ici
assurer mon_script

Puis, en dernier lieu, Démarrer le serveur.

Étape 3 : Créer un script LUA simple pour FiveM

1. Créer un répertoire de scripts :
   • A l'intérieur de la ressources créez un nouveau répertoire pour votre script, par exemple, mon_script.
2. Créer les fichiers de script :
   • A l'intérieur mon_scriptcréer deux fichiers : __resource.lua et main.lua.
   • Les __resource.lua est un fichier de métadonnées qui renseigne FiveM sur les ressources contenues dans ce répertoire. Ajoutez les lignes suivantes à __resource.lua:

-- __resource.lua
-- Définir le script serveur à exécuter
server_script 'main.lua'

En main.luaDans le cadre d'un projet de recherche, écrivez un simple script LUA qui affiche un message sur la console du serveur :

-- main.lua
print("Bonjour, FiveM ! Ceci est mon premier script LUA.")

Testez votre script :

• Enregistrez les fichiers et redémarrez votre serveur FiveM.
• Vérifiez dans la console du serveur la présence du message "Hello, FiveM ! Ceci est mon premier script LUA". Cela confirme que votre script est chargé et qu'il s'exécute correctement.

Décomposition détaillée des concepts clés de LUA

1. Notions de syntaxe LUA

La syntaxe de LUA est conçue pour être simple et claire. Il est essentiel d'en comprendre les bases pour pouvoir créer des scripts efficaces dans FiveM.

Commentaires :

• Les commentaires d'une seule ligne commencent par --.
• Les commentaires sur plusieurs lignes sont inclus dans des --[[ ]].

-- Il s'agit d'un commentaire d'une seule ligne

--[[
Il s'agit d'un
commentaire sur plusieurs lignes
]]

Variables et types de données :

• Les variables n'ont pas besoin d'être déclarées avec un type. LUA leur attribue automatiquement un type en fonction de leur valeur.

local playerName = "John" -- chaîne de caractères
local playerScore = 100 -- nombre
local isOnline = true -- booléen

Types de données de base :

• Néant : Représente l'absence d'une valeur.
• Nombre : Représente des valeurs numériques.
• Chaîne de caractères : Une séquence de caractères.
• Booléen : vrai ou faux.
• Tableau : Une collection de valeurs.

Exemple de déclaration de variables et de types de données en LUA :

local playerHealth = 100 -- Nombre
local playerName = "Alex" -- Chaîne
local isAlive = true -- Booléen
local playerInfo = { -- Tableau
    name = "Alex",
    santé = 100,
    inventaire = {}
}

2. Commandes LUA de base dans le contexte du FiveM

Fonction d'impression : Les print() émet des messages sur la console. Elle est utile pour le débogage et l'affichage d'informations.

<code>print("Ce message sera imprimé sur la console du serveur")<br></code>

Gestionnaires d'événements du serveur : FiveM utilise la programmation événementielle. Vous pouvez définir des fonctions qui s'exécutent en réponse à des événements spécifiques, comme l'arrivée d'un joueur sur le serveur.

-- Exemple de gestionnaire d'événement en FiveM LUA
AddEventHandler('playerConnecting', function(playerName, setKickReason)
    print(playerName .. " se connecte au serveur")
end)

3. Mise en place de normes et de bonnes pratiques de codage LUA

• Utiliser des noms de variables significatifs :
  • Au lieu de nommer une variable X, utiliser Santé du joueur ou score actuel. Cela améliore la lisibilité et la maintenabilité :

local playerHealth = 100 -- Meilleur nom pour plus de clarté

• Indentation cohérente :
  • Une indentation correcte améliore la lisibilité du code. Il est conseillé d'utiliser 4 espaces ou une tabulation pour chaque niveau d'indentation.

if playerHealth > 0 then
    print("Le joueur est en vie")
else
    print("Le joueur est mort")
fin

• Commentez votre code :
  • Utiliser des commentaires pour expliquer une logique complexe ou des sections importantes du code

-- Vérifier si le joueur est en vie
if playerHealth > 0 then
    print("Le joueur est en vie")
fin

4. Traitement des erreurs et techniques de débogage

Utilisation de pcall pour la gestion des erreurs :

• pcall signifie "appel protégé". Il exécute une fonction en mode protégé et détecte les erreurs éventuelles.

local success, err = pcall(function()
    -- Du code qui pourrait provoquer une erreur
    print("Exécution d'un code risqué")
    error("Une erreur s'est produite !")
end)

if not success then
    print("Erreur détectée : " .. err)
fin

Conseils de débogage :

• Utilisation print() pour vérifier les valeurs des variables à différents stades.
• Gardez un œil sur la console du serveur pour les messages d'erreur et les avertissements.
• Décomposer les fonctions complexes en parties plus petites afin d'isoler et de tester des fonctionnalités spécifiques.

5. Exemple pratique : Création d'une commande de chat simple

Créons une simple commande de chat que les joueurs pourront utiliser pour se saluer. Cet exemple montre comment gérer les entrées des joueurs et répondre avec un message personnalisé.

1. Modifier le script pour ajouter une commande de chat :
   • Modifier le main.lua pour y inclure le code suivant :

-- Enregistrer une commande de chat /greet
RegisterCommand('greet', function(source, args, rawCommand)
    local playerName = GetPlayerName(source)
    if playerName then
        print(playerName .. " a utilisé la commande greet.")
        TriggerClientEvent('chat:addMessage', source, {
            args = { "Server", "Hello " .. playerName .. ", welcome to the server !" }
        })
    else
        print("Commande utilisée par un joueur inconnu.")
    fin
end, false)

1. Ce script enregistre une nouvelle commande /salut. Lorsqu'un joueur tape cette commande dans le chat, le serveur répond par un message d'accueil.
2. Test de la commande Chat :
   • Redémarrez votre serveur FiveM.
   • Se connecter au serveur à l'aide du client FiveM.
   • Ouvrez le chat en jeu et tapez /salut.
   • Un message du type "Bonjour [Votre nom], bienvenue sur le serveur" devrait s'afficher dans le chat.

6. Organisation de l'environnement de développement pour les grands projets

Au fur et à mesure que vos scripts deviennent plus complexes, l'organisation de vos fichiers de projet devient cruciale. Voici quelques conseils pour gérer efficacement vos scripts LUA FiveM :

Structure du répertoire : Conservez les scripts apparentés dans des dossiers distincts au sein de la base de données ressources . Par exemple, créez des dossiers distincts pour les scripts liés aux joueurs, les scripts de véhicules et les scripts d'interface utilisateur :

/resources
├── my_script
│ ├─── __resource.lua
│ ├── main.lua
│ └─── commands.lua
├── player_management
│ ├─── __resource.lua
│ ├─── player_health.lua
│ └─── player_inventory.lua
└─── vehicle_management
    ├── __resource.lua
    ├── vehicle_spawn.lua
    └── vehicle_control.lua

Script modulaire : Décomposez vos scripts en modules plus petits qui gèrent des tâches spécifiques. Il est ainsi plus facile de maintenir et de mettre à jour des composants individuels sans affecter l'ensemble du script.

Utiliser un système de contrôle des versions : Envisagez d'utiliser Git pour suivre les modifications apportées à vos scripts. Cela vous permet de revenir aux versions précédentes en cas de problème et de collaborer plus efficacement avec d'autres développeurs.

Documentation: Documentez soigneusement votre code. Créez un fichier README dans chaque répertoire du projet, expliquant ce que fait chaque script, comment l'utiliser et les dépendances éventuelles.

Sujets avancés et prochaines étapes

Maintenant que vous avez mis en place un environnement de développement de base et écrit votre premier script LUA, vous pouvez explorer des sujets plus avancés dans les prochains articles du blog. Il s'agira notamment de

1. Syntaxe et commandes LUA de base : Apprenez la syntaxe essentielle, les types de données et les commandes de LUA.
2. Création et utilisation de fonctions : Comprendre comment définir et utiliser des fonctions en LUA pour modulariser et réutiliser le code.
3. Déclarations conditionnelles et structures de bouclage : Apprenez à utiliser les instructions if-else et les boucles pour contrôler le flux de vos scripts.
4. Travailler avec des tableaux : Découvrez comment utiliser des tableaux pour gérer des structures de données complexes.
5. Gestion des erreurs et débogage : Explorer les techniques avancées de détection et de traitement des erreurs.
6. Utilisation de bibliothèques et de modules externes : Apprenez à intégrer des bibliothèques externes dans vos scripts LUA.
7. Opérations d'E/S de fichiers : Comprendre comment lire et écrire dans des fichiers.
8. Créer des interfaces utilisateur avec NUI : Apprenez à créer des éléments d'interface utilisateur interactifs à l'aide de NUI (Native User Interface).

Conclusion

La mise en place d'un environnement de développement pour les scripts LUA de FiveM à l'aide de VSCode est la première étape vers la création d'expériences de jeu riches et personnalisées. Avec cette configuration de base, vous pouvez commencer à écrire des scripts pour améliorer votre serveur FiveM. Les exemples de scripts et les exercices fournis ici ne sont qu'un début. Au fur et à mesure que vous gagnerez en expérience avec LUA et FiveM, vous serez en mesure de créer des scripts plus complexes et plus attrayants, repoussant ainsi les limites de ce qui est possible dans GTA V.

Exercices pratiques

1. Modifier la commande d'accueil : Mettre à jour le /salut pour accepter un paramètre supplémentaire. Si un nom est fourni, il est salué ; sinon, il est salué par le joueur qui a utilisé la commande.
2. Créer une nouvelle commande : Écrire une nouvelle commande /shout qui diffuse un message à tous les joueurs du serveur.
3. Pratique de la gestion des erreurs : Introduire une gestion des erreurs pour vérifier si une commande est utilisée sans les paramètres requis et fournir un retour d'information au joueur.

Liens de téléchargement

• Télécharger Visual Studio Code
• Télécharger les fichiers du serveur FiveM