Aller au contenu

LuaModLoader

Un mod loader Lua pour la réédition Steam 2020 de GTA IV, la « Complete Edition », build 1.2.0.59, x86.

L'ASI Loader classique et ScriptHookIV ne fonctionnent pas sur cette build. LuaModLoader est l'alternative moderne : écrivez vos mods en Lua, appelez directement les natifs du jeu, sans jamais manipuler la mémoire brute ni écrire de C++. Il ramène aussi l'ASI loader, si bien que les plugins .asi existants retournent sur Complete Edition.

Il s'installe en quatre fichiers dans le dossier de GTA IV et démarre avec le jeu. Il n'y a pas de lanceur, et rien à cliquer.

-- Maintient la santé et l'armure du joueur au maximum, une fois par seconde
Thread.Create(function()
    while true do
        local ped = GetPlayerChar(GetPlayerId())
        SetCharHealth(ped, 200)
        AddArmourToChar(ped, 100)
        Thread.Wait(1000)
    end
end)

Télécharger Écrire son premier mod

Ce que vous obtenez

  • 3 158 natifs en globales PascalCase. SetCharHealth(ped, 200) reprend les noms des scripts ScriptHookDotNet et des trainers classiques, donc rien à renommer lors d'un portage. La forme canonique SNAKE_CASE reste joignable par la table natives et par Native.Call.
  • Une API en namespaces. Tout ce que le loader fournit vit sous Thread, Console, Log, Draw, Color, Input, Gamepad, Native, Memory, Vehicle et Script. Aucune globale nue ne peut entrer en collision avec un natif.
  • Un ordonnanceur de coroutines. Thread.Create et un Thread.Wait(ms) bloquant qui suspend votre code sans figer le jeu.
  • Vos propres natifs. Native.Register place une fonction Lua dans la table des natifs du jeu, où n'importe quel autre mod peut l'appeler par son hash, quel que soit son langage.
  • Un éditeur de code à chaud. Écrire, exécuter et recharger du Lua sans redémarrer GTA IV.
  • Rendu et entrées. Dessiner du texte et des rectangles par-dessus le jeu, lire le clavier et la manette, et isoler les entrées du jeu pendant qu'un menu est ouvert.
  • Un ASI loader, pour que les plugins .asi se chargent à nouveau sur cette build.

Documentation

La version actuelle, le contenu de l'archive, et la mise à jour.

Quatre fichiers dans le dossier du jeu, plus les journaux et le dépannage.

Un guide de trois minutes, du dossier vide au mod qui tourne.

manifest.lua, mods multi-fichiers, MOD_DIR, autostart.

Thread, Draw, Input, Native, Memory, Vehicle, Script.

Thread.Create(), onUnload(), Input.IsKeyDown() et la table des codes VK.

Santé, véhicules, armes, IA et météo, avec des exemples à copier-coller.

Identifiants d'armes, de véhicules et de météo, prêts à coller.

Les 3 158 natifs : recherche, filtre par catégorie, copie Lua en un clic.

Des scripts prêts à l'emploi, expliqués.

Ce qui a changé à chaque version, la plus récente en premier.

Mods compatibles

  • ProTrainer-IV est un menu trainer complet, ouvert avec F4.
  • Les exemples de scripts couvrent un compteur de vitesse HUD avec nitro, une bascule god mode, un script never wanted, et d'autres.

Ce site documente le moteur

Le dépôt contient le moteur natif, c'est-à-dire le loader et son API C++. Les mods complets bâtis sur cette API vivent dans leurs propres dépôts.