Docs / Entraînement : scripts FiveM (GTA V)
Créer une interface (NUI)
Afficher une interface web dans le jeu et la faire dialoguer avec tes scripts, avec un exemple complet.
Entraînement sur GTA V : cette page explique FiveM, la plateforme RP de GTA V. Aucun outil pour créer un serveur GTA 6 n'est annoncé : ce que tu apprends ici est la meilleure préparation.
Sur FiveM, les interfaces des serveurs (téléphone, inventaire, menus, HUD) sont des pages web : HTML, CSS et JavaScript, affichées par un navigateur intégré au jeu. C'est ce qu'on appelle la NUI.
Comment ça marche
| Sens | Côté script (Lua) | Côté page (JavaScript) |
|---|---|---|
| Script → page | SendNUIMessage({ ... }) |
window.addEventListener('message', ...) |
| Page → script | RegisterNUICallback('nom', ...) |
fetch('https://<ressource>/nom', ...) |
| Souris et clavier | SetNuiFocus(true, true) |
La page reçoit les clics et les touches |
Les interfaces natives du jeu (grands messages, menus de GTA V) passent par un autre système, les scaleforms, qu'on peut aussi appeler depuis un script.
1. La structure
carte/
├── fxmanifest.lua
├── client.lua
└── html/
├── index.html
├── style.css
└── app.js
2. Le manifeste
fx_version 'cerulean'
game 'gta5'
lua54 'yes'
ui_page 'html/index.html'
files { 'html/index.html', 'html/style.css', 'html/app.js' }
client_script 'client.lua'
ui_page indique la page à charger ; tous les fichiers de l'interface doivent être listés dans files.
3. Le script client
client.lua : ouvre et ferme la carte avec une touche que le joueur peut changer dans ses réglages.
local open = false
local function setOpen(state)
open = state
SetNuiFocus(state, state)
SendNUIMessage({ action = 'toggle', visible = state, name = GetPlayerName(PlayerId()) })
end
RegisterCommand('+carte', function() setOpen(not open) end, false)
RegisterCommand('-carte', function() end, false)
RegisterKeyMapping('+carte', 'Ouvrir ma carte', 'keyboard', 'F7')
-- Appelé par la page quand le joueur ferme la carte
RegisterNUICallback('close', function(data, cb)
setOpen(false)
cb('ok')
end)
4. La page
html/index.html :
<!doctype html>
<html lang="fr">
<head>
<meta charset="utf-8">
<link rel="stylesheet" href="style.css">
</head>
<body>
<div id="card" hidden>
<h1>Carte d'identité</h1>
<p id="name"></p>
<button id="close">Fermer</button>
</div>
<script src="app.js"></script>
</body>
</html>
html/style.css : le fond doit rester transparent, sinon la page cache le jeu.
html, body { margin: 0; background: transparent; font-family: sans-serif; }
#card { position: absolute; right: 40px; bottom: 40px; padding: 20px 24px;
border-radius: 14px; background: rgba(10, 20, 29, .9); color: #fff; }
html/app.js :
const card = document.getElementById('card');
// Messages envoyés par SendNUIMessage
window.addEventListener('message', (e) => {
if (e.data.action !== 'toggle') return;
card.hidden = !e.data.visible;
document.getElementById('name').textContent = e.data.name || '';
});
// Prévient le script Lua (RegisterNUICallback 'close')
function closeCard() {
fetch(`https://${GetParentResourceName()}/close`, {
method: 'POST',
headers: { 'Content-Type': 'application/json; charset=UTF-8' },
body: '{}'
});
}
document.getElementById('close').addEventListener('click', closeCard);
window.addEventListener('keydown', (e) => { if (e.key === 'Escape') closeCard(); });
Ajoute ensure carte dans server.cfg, puis appuie sur F7 en jeu.
5. Tester sans lancer le jeu
Ouvre index.html dans ton navigateur et simule un message dans la console :
window.postMessage({ action: 'toggle', visible: true, name: 'Joueur test' });
Tu travailles ainsi la mise en page en quelques secondes, sans redémarrer la ressource. En jeu, la commande nui_devtools dans la console F8 ouvre les outils de développement de la NUI.
Les bonnes pratiques
- Écris le texte avec
textContent, pasinnerHTML: un nom de joueur peut contenir du code. AvecinnerHTML, n'importe qui pourrait l'exécuter dans l'interface des autres. - Ne fais jamais confiance à la page : tout ce qu'elle envoie (montants, objets) se vérifie côté serveur, comme un événement.
- Rends toujours la main : chaque
SetNuiFocus(true, true)doit avoir sonSetNuiFocus(false, false). Sinon le joueur reste bloqué avec la souris. - Pense aux performances : cache l'interface quand elle ne sert pas, évite les animations en continu et les gros fichiers. Mesure avec
resmon. - Garde une charte commune : mêmes couleurs, polices et boutons pour toutes les interfaces du serveur, dans un fichier CSS partagé.
- Pense à la manette : une interface utilisable sans souris (gros boutons, navigation avec les flèches) sera un vrai avantage.
- Mets les textes à part : tous les textes dans un fichier de traduction, pas en dur dans le code.
Et sur GTA 6 ?
À confirmer : on ne sait pas comment les interfaces des serveurs GTA 6 seront construites, ni si une NUI web existera. Pour être prêt, sépare ton interface du jeu : une petite couche fait le lien (ici SendNUIMessage et fetch), et le reste de l'interface n'en dépend pas. Si le moyen de dialoguer change, tu ne réécris que cette couche. Voir Préparer son serveur pour GTA 6.
