{"id":151273,"date":"2024-08-29T08:59:09","date_gmt":"2024-08-29T06:59:09","guid":{"rendered":"https:\/\/hifivem.com\/?p=151273"},"modified":"2026-08-16T15:16:25","modified_gmt":"2026-08-16T13:16:25","slug":"introduction-aux-scripts-lua","status":"publish","type":"post","link":"https:\/\/rpcrate.com\/fr\/introduction-lua-scripting\/","title":{"rendered":"Introduction au scripting Lua pour FiveM"},"content":{"rendered":"

FiveM resources can use CfxLua, a modified Lua 5.4 runtime, for client and server scripts.<\/strong> A current resource starts with fxmanifest.lua<\/code>, lists the files that each context loads, and keeps authoritative decisions such as permissions, money and inventory on the server.<\/p>\n

The configuration and code examples here target FiveM for GTA V Legacy. Enhanced has different runtime and compatibility rules; check Cfx.re\u2019s Legacy-to-Enhanced changes<\/a> before applying them to an Enhanced server.<\/p>\n

\n

The old __resource.lua<\/code> manifest and the lua54 'yes'<\/code> switch are deprecated for new work. Cfx.re states that Lua 5.3 support ended in June 2025 and current scripts use Lua 5.4.<\/p>\n<\/div>\n

Create a minimal resource<\/h2>\n

Inside your server-data resources<\/code> directory, create [local]\/hello_fivem<\/code>. The brackets group resources; the resource itself is the hello_fivem<\/code> directory.<\/p>\n

fxmanifest.lua<\/code>:<\/p>\n

fx_version 'cerulean'\ngame 'gta5'\n\nauthor 'Your name'\ndescription 'Small CfxLua learning resource'\nversion '1.0.0'\n\nclient_script 'client.lua'\nserver_script 'server.lua'\n<\/code><\/pre>\n
client.lua<\/code>:<\/p>\n
RegisterCommand('mycoords', function()\n    local coords = GetEntityCoords(PlayerPedId())\n    print(('x=%.2f y=%.2f z=%.2f'):format(coords.x, coords.y, coords.z))\nend, false)\n<\/code><\/pre>\n
server.lua<\/code>:<\/p>\n
AddEventHandler('onResourceStart', function(resourceName)\n    if resourceName ~= GetCurrentResourceName() then\n        return\n    end\n\n    print(('[%s] started'):format(resourceName))\nend)\n<\/code><\/pre>\n
The manifest and runtime behaviour are documented in the official resource manifest reference<\/a> and CfxLua guide<\/a>.<\/p>\n
Understand client and server contexts<\/h2>\n
A client script runs separately for each connected player and can call game-facing natives such as PlayerPedId<\/code> and GetEntityCoords<\/code>. A server script coordinates shared state, persistence and authorization. Values supplied by a client are inputs, not proof.<\/p>\n
Use AddEventHandler<\/code> for events that should stay in one context. Use RegisterNetEvent<\/code> only when an event must cross the client\/server boundary. The official Secure Your Events guide<\/a> explains why every networked action must validate the player’s current server-side permission and state.<\/p>\n
Avoid blocking the scheduler<\/h2>\n
CfxLua scripts are cooperatively scheduled. A loop that never yields can freeze its script context. When a loop must wait, use Wait<\/code> with a delay appropriate to the job, and do not poll a database or HTTP endpoint every frame. Prefer events and state changes over permanent polling.<\/p>\n
Use exports for a clear resource boundary<\/h2>\n
An export exposes a named function to another resource. Define it explicitly and document its arguments and return value:<\/p>\n
exports('formatPlayerLabel', function(serverId, playerName)\n    return ('[%d] %s'):format(serverId, playerName)\nend)\n<\/code><\/pre>\n
Another Lua resource can call it as exports.hello_fivem:formatPlayerLabel(id, name)<\/code>. Do not use an export to bypass permission or ownership checks.<\/p>\n
Run and test the resource<\/h2>\n
    \n
  1. Back up the resource you are replacing, if any.<\/li>\n
  2. In the server console, run refresh<\/code> and then ensure hello_fivem<\/code>.<\/li>\n
  3. Check the server console for the start message.<\/li>\n
  4. Connect to the development server, open F8 and run mycoords<\/code>.<\/li>\n
  5. Add ensure hello_fivem to server.cfg after any dependencies, then restart the server to confirm normal startup.<\/li>\n<\/ol>\n
    The supported resource commands are listed in the official server-command reference<\/a>. Continue with the official first Lua script tutorial<\/a> before adding framework or database dependencies.<\/p>\n","protected":false},"excerpt":{"rendered":"
    Les ressources FiveM peuvent utiliser CfxLua, un runtime Lua 5.4 modifi\u00e9, pour les scripts client et serveur. Une ressource actuelle commence par fxmanifest.lua, liste les fichiers que chaque contexte charge, et conserve les d\u00e9cisions faisant autorit\u00e9 telles que les permissions, l'argent et l'inventaire sur le serveur.<\/p>","protected":false},"author":1,"featured_media":151274,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[2340],"tags":[3001],"class_list":["post-151273","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-lua-scripting","tag-fivem-script"],"_links":{"self":[{"href":"https:\/\/rpcrate.com\/fr\/wp-json\/wp\/v2\/posts\/151273","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/rpcrate.com\/fr\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/rpcrate.com\/fr\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/rpcrate.com\/fr\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/rpcrate.com\/fr\/wp-json\/wp\/v2\/comments?post=151273"}],"version-history":[{"count":3,"href":"https:\/\/rpcrate.com\/fr\/wp-json\/wp\/v2\/posts\/151273\/revisions"}],"predecessor-version":[{"id":217360,"href":"https:\/\/rpcrate.com\/fr\/wp-json\/wp\/v2\/posts\/151273\/revisions\/217360"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/rpcrate.com\/fr\/wp-json\/wp\/v2\/media\/151274"}],"wp:attachment":[{"href":"https:\/\/rpcrate.com\/fr\/wp-json\/wp\/v2\/media?parent=151273"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/rpcrate.com\/fr\/wp-json\/wp\/v2\/categories?post=151273"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/rpcrate.com\/fr\/wp-json\/wp\/v2\/tags?post=151273"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}