Répertoire des Fonctions Natives GTA IV

Dans LuaModLoader, vous pouvez appeler directement n'importe quelle fonction native du jeu en Lua avec son nom en majuscules. Cette page regroupe les fonctions les plus utiles et fréquentes, classées par catégorie avec des exemples prêts à l'emploi.

💡 Comment Appeler une Fonction Native en Lua ?

Dans vos scripts Lua, vous n'avez pas besoin de code C++ compliqué. Vous écrivez simplement le nom de la fonction native :

-- Exemple : Récupérer le personnage du joueur et mettre sa vie à 200
local playerPed = GET_PLAYER_CHAR(GET_PLAYER_ID())
SET_CHAR_HEALTH(playerPed, 200)

👤 Joueur & Personnages (`CHAR` / `PED`)

Identité & Santé

Fonction	Paramètres	Description
`GET_PLAYER_ID()`	aucun	Renvoie l'identifiant entier du joueur local.
`GET_PLAYER_CHAR(playerId)`	`playerId`	Renvoie le pointeur/handle du personnage joueur (`Ped`).
`SET_CHAR_HEALTH(ped, health)`	`ped`, `health (int)`	Définit les points de vie (standard : 100 à 200).
`GET_CHAR_HEALTH(ped, pHealth)`	`ped`	Récupère la santé actuelle.
`ADD_ARMOUR_TO_CHAR(ped, armour)`	`ped`, `armour (int)`	Ajoute des points d'armure / gilet pare-balles (max : 100).
`SET_CHAR_INVINCIBLE(ped, enable)`	`ped`, `bool`	Active ou désactive le mode invincible (Godmode).
`SET_CHAR_NEVER_TARGETTED(ped, enable)`	`ped`, `bool`	Empêche les ennemis de cibler ce personnage.

Position & Déplacement

Fonction	Paramètres	Description
`SET_CHAR_COORDINATES(ped, x, y, z)`	`ped`, `x`, `y`, `z`	Téléporte le personnage aux coordonnées 3D.
`SET_CHAR_HEADING(ped, angle)`	`ped`, `angle (float)`	Définit l'orientation de regard (0 à 360°).
`SET_CHAR_VELOCITY(ped, vx, vy, vz)`	`ped`, `vx`, `vy`, `vz`	Applique un vecteur de vélocité physique.
`GET_CHAR_COORDINATES(ped)`	`ped`	Récupère la position 3D (s'utilise avec `call_native_out`).

Police & Étoiles de Recherche

Fonction	Paramètres	Description
`ALTER_WANTED_LEVEL(playerId, stars)`	`playerId`, `stars (0-6)`	Définit le niveau d'étoiles de police.
`APPLY_WANTED_LEVEL_CHANGE_NOW(playerId)`	`playerId`	Applique immédiatement le changement de comportement policier.
`CLEAR_CHAR_LAST_DAMAGE_ENTITY(ped)`	`ped`	Réinitialise l'état d'agression envers la police.

-- Exemple : Soigner le joueur et effacer les étoiles de police
local ped = GET_PLAYER_CHAR(GET_PLAYER_ID())
SET_CHAR_HEALTH(ped, 200)
ADD_ARMOUR_TO_CHAR(ped, 100)
ALTER_WANTED_LEVEL(GET_PLAYER_ID(), 0)
APPLY_WANTED_LEVEL_CHANGE_NOW(GET_PLAYER_ID())

🚗 Véhicules (`CAR` / `VEHICLE`)

Création & Réparation

Fonction	Paramètres	Description
`CREATE_CAR(modelHash, x, y, z, createdByScript)`	`hash`, `x`, `y`, `z`, `bool`	Fait apparaître un véhicule et renvoie son handle.
`DELETE_CAR(veh)`	`veh`	Supprime un véhicule du monde de jeu.
`FIX_CAR(veh)`	`veh`	Répare entièrement la carrosserie et le moteur du véhicule.
`SET_CAR_ENGINE_ON(veh, engineOn, silent)`	`veh`, `bool`, `bool`	Démarre ou coupe le moteur du véhicule.
`WARP_CHAR_INTO_CAR(ped, veh)`	`ped`, `veh`	Téléporte le joueur directement sur le siège conducteur.

Vitesse & Contrôle

Fonction	Paramètres	Description
`GET_CAR_SPEED(veh)`	`veh`	Renvoie la vitesse en mètres par seconde (m/s). Multiplier par 3.6 pour des km/h.
`SET_CAR_FORWARD_SPEED(veh, speed)`	`veh`, `speed (float)`	Applique une vitesse avant en m/s.
`IS_CHAR_IN_ANY_CAR(ped)`	`ped`	Renvoie `true` si le personnage est à bord d'un véhicule.
`GET_CAR_CHAR_IS_USING(ped)`	`ped`	Renvoie le handle du véhicule dans lequel se trouve le personnage.

-- Exemple : Réparer et booster la voiture actuelle
local ped = GET_PLAYER_CHAR(GET_PLAYER_ID())
if IS_CHAR_IN_ANY_CAR(ped) then
    local veh = GET_CAR_CHAR_IS_USING(ped)
    FIX_CAR(veh)
    SET_CAR_FORWARD_SPEED(veh, 50.0) -- Accélération à ~180 km/h
end

🔫 Armes & Équipement (`WEAPON`)

Fonction	Paramètres	Description
`GIVE_WEAPON_TO_CHAR(ped, weaponId, ammo, show)`	`ped`, `weaponId`, `ammo`, `bool`	Donne une arme et ses munitions au personnage.
`REMOVE_ALL_CHAR_WEAPONS(ped)`	`ped`	Retire toutes les armes du personnage.
`SET_CHAR_ACCURACY(ped, accuracy)`	`ped`, `accuracy (0-100)`	Définit la précision de tir (pourcentage).
`SET_CHAR_AMMO(ped, weaponId, ammo)`	`ped`, `weaponId`, `ammo`	Définit le nombre de balles d'une arme spécifique.

-- Exemple : Donner un Desert Eagle (ID 9) et une M4 (ID 15) avec munitions
local ped = GET_PLAYER_CHAR(GET_PLAYER_ID())
GIVE_WEAPON_TO_CHAR(ped, 9, 100, false)
GIVE_WEAPON_TO_CHAR(ped, 15, 300, true)

🧠 Intelligence Artificielle & Tâches (`TASK`)

Fonction	Paramètres	Description
`TASK_WANDER_STANDARD(ped)`	`ped`	Fait marcher le piéton aléatoirement dans la rue.
`TASK_COMBAT(ped, targetPed)`	`ped`, `targetPed`	Ordonne au personnage d'attaquer la cible.
`TASK_CAR_DRIVE_WANDER(ped, veh, speed, drivingStyle)`	`ped`, `veh`, `speed`, `style`	Fait conduire le personnage aléatoirement.
`TASK_HANDS_UP(ped, duration)`	`ped`, `duration (ms)`	Fait lever les mains en l'air au piéton.
`CLEAR_CHAR_TASKS(ped)`	`ped`	Annule immédiatement toutes les actions de l'IA.

🌍 Environnement & Monde de Jeu

Fonction	Paramètres	Description
`SET_TIME_OF_DAY(hours, minutes)`	`hours (0-23)`, `minutes (0-59)`	Modifie l'heure du jeu.
`FORCE_WEATHER_NOW(weatherId)`	`weatherId (0-7)`	Change immédiatement la météo.
`ADD_EXPLOSION(x, y, z, type, radius, sound, visual, camShake)`	`x`, `y`, `z`, `type`, `radius`, `bool`, `bool`, `float`	Déclenche une explosion dans le monde.
`DRAW_LIGHT_WITH_RANGE(x, y, z, r, g, b, range, intensity)`	`x`, `y`, `z`, `r`, `g`, `b`, `range`, `intensity`	Crée une source de lumière dynamique aux coordonnées.

📍 Blips & Points sur la Carte (`BLIP`)

Fonction	Paramètres	Description
`ADD_BLIP_FOR_COORD(x, y, z)`	`x`, `y`, `z`	Crée un repère sur la carte aux coordonnées.
`ADD_BLIP_FOR_CHAR(ped)`	`ped`	Attache un repère GPS sur un personnage.
`ADD_BLIP_FOR_CAR(veh)`	`veh`	Attache un repère GPS sur un véhicule.
`CHANGE_BLIP_COLOUR(blip, colorId)`	`blip`, `colorId (0-4)`	Change la couleur (0=Blanc, 1=Rouge, 2=Vert, 3=Bleu, 4=Jaune).
`REMOVE_BLIP(blip)`	`blip`	Supprime un repère de la carte.