Befehle / Exports / Events

Um das volle Potenzial des Grew esxAddon auszuschöpfen, bietet diese Seite eine Übersicht über die verfügbaren Befehle und Exports.
Es wird empfohlen, das Script als required in die fxmanifest.lua einzutragen, um sicherzustellen, dass die Exports reibungslos geladen
werden und in allen serverseitigen Dateien verfügbar sind. So kann das Addon nahtlos mit anderen Serverfunktionen interagieren.

  dependency {
    'grew_esxAddon'
  }

Falls Sie Fragen zur Einrichtung oder Nutzung des Scripts haben, zögern Sie nicht, uns zu kontaktieren. Sie erreichen uns per E-Mail oder im Support-Channel auf unserem Discord.

Befehle

removeitem <playerId> <item> <count>

Beschreibung

Dieser Befehl entfernt die angegebene Anzahl eines Items vom angegebenen Benutzer. Der Befehl erfordert:

playerId: Die ID des Spielers, von dem das Item entfernt wird.
item: Das zu entfernende Item.
count: Die Anzahl des zu entfernenden Items.

Beispiel

Dieses Beispiel entfernt 3 Einheiten “bread” (Brot) vom Spieler mit der ID 1: /removeitem 1 bread 3

Voraussetzungen

Berechtigungen: Nur für Benutzer mit Mod-Berechtigungen verfügbar.
Spieler online: Der Spieler muss online sein, damit der Befehl erfolgreich ausgeführt wird.

Hinweise

removeweapon <playerId> <weapon>

Beschreibung

Dieser Befehl entfernt die angegebene Waffe vom angegebenen Benutzer. Der Befehl erfordert:

playerId: Die ID des Spielers, von dem die Waffe entfernt wird.
weapon: Die zu entfernende Waffe (verwende den genauen Waffennamen aus der Datenbank).

Beispiel

Dieses Beispiel entfernt die Waffe “weapon_pistol” vom Spieler mit der ID 1: /removeweapon 1 weapon_pistol

Voraussetzungen

Berechtigungen: Nur für Benutzer mit Mod-Berechtigungen verfügbar.
Spieler online: Der Spieler muss online sein, damit der Befehl erfolgreich ausgeführt wird.

Hinweise

Exports

Die folgenden Exports sind ausschließlich auf der Server-Seite verfügbar und können in allen serverseitigen Dateien verwendet werden.

getAllItems

Beschreibung

Gibt eine Liste aller Items aus der Datenbank zurück.

Beispiel

Dieses Beispiel ruft alle Items aus der Datenbank ab:

  local allItems = exports["grew_esxAddon"]:getAllItems()

getAllJobs

Beschreibung

Gibt eine Liste aller Jobs aus der Datenbank zurück.

Beispiel

Dieses Beispiel ruft alle Jobs aus der Datenbank ab:

local allJobs = exports["grew_esxAddon"]:getAllJobs()

getAllRanks

Beschreibung

Gibt eine Liste aller Ränge aus der Datenbank zurück.

Beispiel

Dieses Beispiel ruft alle Ränge aus der Datenbank ab:

local allRanks = exports["grew_esxAddon"]:getAllRanks()

getAllLicenses

Beschreibung

Gibt eine Liste aller Lizenzen aus der Datenbank zurück.

Beispiel

Dieses Beispiel ruft alle Lizenzen aus der Datenbank ab:

local allLicenses = exports["grew_esxAddon"]:getAllLicenses()

Events

triggerSyncServerCallback

Beschreibung

Dieses Event löst einen synchronen Callback auf der Server-Seite aus. Es wartet, bis der Callback eine Antwort zurückgibt, bevor die Codeausführung fortgesetzt wird.
Nützlich in Fällen, in denen eine Antwort vom Server benötigt wird, bevor zusätzliche Logik auf der Client-Seite ausgeführt wird.

Beispiel

Dieses Beispiel ruft triggerSyncServerCallback auf, um Daten vom Server abzurufen und wartet, bis eine Antwort empfangen wird:

  local result = exports["grew_esxAddon"]:triggerSyncServerCallback("exampleEvent", 1, "param1", "param2")

  if result then
      print("Server-Callback erfolgreich abgeschlossen!")
  else
      print("Server-Callback fehlgeschlagen oder abgelaufen.")
  end

triggerSyncClientCallback

Beschreibung

Dieses Event löst einen synchronen Callback auf der Client-Seite aus.
Es wartet auf eine Antwort vom Client, bevor die Ausführung auf der Server-Seite fortgesetzt wird. Dies ist hilfreich, wenn die Serverlogik auf Rückmeldungen vom Client angewiesen ist.

Beispiel

Dieses Beispiel verwendet triggerSyncClientCallback, um eine Anfrage vom Server an den Client zu senden, mit einer Timeout-Mechanik für den Fall einer Verzögerung:

  local clientResult = triggerSyncClientCallback("exampleClientEvent", 1, "paramA", "paramB")

  if clientResult then
      print("Client-Callback hat Daten erfolgreich zurückgegeben!")
  else
      print("Client-Callback fehlgeschlagen oder abgelaufen.")
  end