FiveM Getting Started 4/4 — Créer votre premier script

Vous avez un serveur local qui tourne. Cette étape crée votre première ressource Lua : un Hello World, puis un spawn de véhicule.

Créer le script avec Visual Studio Code

1. Aller dans les fichiers serveur

1. Ouvrez l’Explorateur et allez dans le dossier txData (généré à côté / près de votre installation FXServer).
2. Ouvrez le dossier du type FiveMBasicServerCFXDefault_XXXX.base (le suffixe varie).
3. Ouvrez le dossier resources à l’intérieur.

2. Créer le dossier et les fichiers

1. Dans resources, créez un dossier nommé helloWorld.
2. À l’intérieur, créez deux fichiers texte : client.lua et fxmanifest.lua.

3. Écrire le manifest

Ouvrez fxmanifest.lua dans VS Code et collez :

fx_version 'cerulean'
game 'gta5'
author 'YourName'
description 'My first hello world script'
version '1.0.0'
client_script 'client.lua'

Enregistrez le fichier.

4. Écrire le script client

Ouvrez client.lua et collez :

print('helloWorld')

Enregistrez.

5. Démarrer la ressource dans FiveM / txAdmin

1. En jeu, F8 → tapez tx (Tab si besoin) pour ouvrir le sous-menu txAdmin.
2. Allez dans Resources → Reload & Refresh.
3. Cherchez helloWorld.
4. Cliquez sur Start à côté de la ressource.

Selon la config, vous pouvez aussi ajouter ensure helloWorld dans le server.cfg pour un démarrage automatique.

6. Vérifier

Appuyez sur F8 : vous devez voir helloWorld imprimé dans la console. Félicitations — votre première ressource tourne.

Aller plus loin : spawn un véhicule

Remplacez le contenu de client.lua par un script qui enregistre une commande client et spawn un véhicule devant le joueur. Exemple pédagogique :

RegisterCommand('car', function()
  local ped = PlayerPedId()
  local coords = GetEntityCoords(ped)
  local model = `adder`
  RequestModel(model)
  while not HasModelLoaded(model) do
    Wait(0)
  end
  local vehicle = CreateVehicle(model, coords.x + 2.0, coords.y, coords.z, GetEntityHeading(ped), true, false)
  SetPedIntoVehicle(ped, vehicle, -1)
  SetModelAsNoLongerNeeded(model)
end, false)

1. Sauvegardez client.lua.
2. Dans txAdmin Resources : Restart (ou Stop puis Start) sur helloWorld.
3. En jeu, tapez /car (ou la commande chat selon votre chat resource) : un Adder devrait apparaître.

Sur certains templates, les commandes chat passent par la resource chat. Si /car ne répond pas, testez aussi depuis F8 : car.

Bonnes pratiques dès le premier script

• Un dossier = une ressource, avec un fxmanifest.lua clair
• Nommez les ressources sans espaces (helloWorld, pas hello world)
• Testez hors peak et isolez les crashes resource par resource
• Gardez une sauvegarde de txData avant d’installer des packs massifs

Vous avez bouclé le parcours Getting Started : client, serveur txAdmin, première ressource. Vous pouvez ensuite installer MLO, scripts framework (ESX/QBCore) et véhicules depuis le catalogue.

Catalogue mods FiveM · Scripts · Sommaire de la série