fivem docsDeutsch

Entwicklung · FiveM Docs

FiveM Lua lernen: Erste Ressource mit Client und Server

FiveM verwendet CfxLua, eine angepasste Lua-5.4-Laufzeit. Ressourcen benötigen eine fxmanifest.lua. Client- und Server-Code laufen getrennt und dürfen nicht als gemeinsamer Zustand betrachtet werden.

Dateien der Ressource

Lege unter dem resources-Verzeichnis einen eigenen Ordner an, etwa mein_test. Darin liegen fxmanifest.lua, client.lua und server.lua. Ein Eintrag in der aktiven server.cfg sorgt anschließend dafür, dass FXServer die Ressource startet.

fx_version 'cerulean'
game 'gta5'

client_script 'client.lua'
server_script 'server.lua'

Client und Server voneinander trennen

Client-Skripte dürfen die lokale Spielumgebung auslesen und passende clientseitige Natives aufrufen. Server-Skripte übernehmen vertrauenswürdige Prüfungen, Berechtigungen und Persistenz. Ein Client-Ereignis oder übermittelter Wert ist nicht automatisch autorisiert.

Für den ersten Funktionstest eignet sich eine harmlose Konsolenausgabe. Sie prüft das Laden der Ressource, ohne eine Datenbank, Framework-Abhängigkeit oder ungesicherte Netzwerkfunktion einzuführen.

-- server.lua
print('[mein_test] Server-Skript geladen')

-- client.lua
print('[mein_test] Client-Skript geladen')

Start und Prüfung

  1. Trage ensure mein_test in der tatsächlich aktiven server.cfg ein.
  2. Starte den Server und suche in der Serverkonsole nach der Ausgabe des Serverskripts.
  3. Verbinde dich mit dem Client und prüfe dessen F8-Konsole auf die Client-Ausgabe.
  4. Bei Fehlern zuerst Dateinamen, Manifest, Ordnerpfad und den Ressourcennamen vergleichen.
ensure mein_test

Technische Beispiele sind Orientierungshilfen. Führe bei sicherheitskritischen Änderungen Backups durch und teste das Verhalten im echten FXServer sowie im FiveM-Client.