- FIVEM - RESOURCEN UND FUNKTIONSWEISE DER MANIFEST !-|

- FIVEM - RESOURCEN AUSLEGUNG !-|

Das Ressourcenmanifest ist eine Datei mit dem Namen fxmanifest.lua ,die in einem Ressourcenordner auf dem Server abgelegt wird.

Es handelt sich um eine Lua-Datei, die in einer von den üblichen Lua-Skripten getrennten Laufzeit ausgeführt wird und ein spezielles Setup verwendet, sodass eine semi-deklarative Syntax zum Definieren von Metadaten verwendet werden kann.

Beispiel

-- Ressourcenmetadaten
fx_version 'cerulean'
games {'gta5' }

author 'Jon Doe'
description 'Example resource'
version '1.0.0'

client_scripts {    'client.lua',    'client_two.lua'
}
server_script 'server.lua'

-- Zusätzliche Daten können ebenfalls verwendet werden
my_data 'one' { two = 42 }
my_data 'three' { four = 69 }

-- Aufgrund der Lua-Syntax funktioniert auch Folgendes:
my_data('nine')({ninety = "nein"})

Intern werden dadurch die folgenden Metadateneinträge erstellt:

• fx_version: cerulean
• game: gta5
• game: rdr3
• client_script: client.lua
• client_script: client_two.lua
• client_scripts: { client.lua, client_two.lua }
• server_script: server.lua
• server_scripts: { server.lua, server_two.lua }
• my_data: one
• my_data: three
• my_data: nine
• my_data_extra: {"two":42} (as JSON)
• my_data_extra: {"four":69}
• my_data_extra: {"ninety":"nein"}

Globbing

Einige Eintragstypen unterstützen möglicherweise das Globbing für mehrere Dateien. Diese haben eine folgende Mustersyntax:

Die Unterstützung für Globbing wird unter jedem Eintragstyp angegeben.

Ressourcen Manifest Einträge

Jetzt kommen die integrierten Ressourcen Manifest Einträge. Eine Ressource kann auch benutzerdefinierte Metadateneinträge enthalten, die mit GetNumResourceMetadata KLICK und GetResourceMetadata KLICK abgerufen werden können.

fx_version

Definiert die unterstützten Funktionen für die Ressource. Dies muss eines bestimmter Wörter sein. Jeder Eintrag erbt Eigenschaften vom vorherigen. Die aktuelle FXv2-Ressourcenversion ist cerulean.

Das Game

Definiert die unterstützten Spiel-API-Sets für die Ressource.

resource_manifest_version

Du solltest fxmanifest.lua und fx_version verwenden

Definiert die unterstützten Funktionen für die Ressource. Dies muss eine bestimmte Gruppe von GUIDs sein. Jede GUID erbt Eigenschaften von der vorherigen. Die aktuelle Version des Ressourcen Manifest lautet 44febabe-d386-4d18-afbe-5e627f4af937.

client_script

Dies unterstützt das Globbing.

Definiert ein Skript, das auf den Client geladen werden soll, und fügt die Datei implizit der Ressourcenpaketdatei hinzu. Die Erweiterung bestimmt, welcher Skriptlader die Datei verarbeitet

server_Script

Dies unterstützt das Globbing. Referenz CitizenFX.Core.Server für eine .NET-Assembly

Definiert ein Skript, das auf den Server geladen werden soll. Die Erweiterung bestimmt, welcher Skriptlader die Datei wie bei client_script verarbeitet.

shared_Script

Dies unterstützt das Globbing.

Definiert ein Skript, das auf beiden Seiten geladen werden soll, und fügt die Datei der Ressourcenpaketdatei hinzu. Die Erweiterung bestimmt, welcher Skriptlader die Datei wie bei client_script verarbeitet.

export

Definiert eine globale Funktion, die von einem Client-Skript exportiert werden soll. In Lua wird _G [exportName] als exportName exportiert. In C # wird dies zu diesem Zeitpunkt absolut nichts bewirken.

export definieren

LUA

exports {    'setWidget',    'getWidget'
}

local lastWidget

function setWidget(widget)    lastWidget = widget
end

function getWidget()    return lastWidget
end

Export und Verbrauch

LUA

exports.myresource:setWidget(50)

C#

int widget = Exports["myresource"].getWidget();

server_export

Definiert eine globale Funktion, die von einem Serverskript exportiert werden soll

ui_page

Setzt die NUI-Seite der Ressource auf die definierte Datei. Diese Datei muss mithilfe von Dateien referenziert werden.

ui_page 'html/index.html'
file 'html/index.html'

before_level_meta

Lädt das angegebene Ebenen-Meta in die Ressource vor dem primären Ebenen-Meta.

Wenn möglich sollten wir Datendateien verwerden.

after_level_meta

Lädt das angegebene Level-Meta in die Ressource nach dem primären Level-Meta.

Wenn möglich sollten wir Datendateien verwerden.

replace_level_meta

Ersetzt das Ebenen-Meta (normalerweise unter /data/levels/gta5/gta5.meta zu finden). Dies muss mit Dateien referenziert werden.

replace_level_meta 'mymap'
files {    'mymap.meta'
}

data_file

Diese Anweisung unterstützt das Globbing im Feld Dateiname.

Fügt dem zusätzlichen Inhaltssystem des Spiels eine Datendatei eines bestimmten Typs hinzu.

files {    'audio/mywaves/stupidcar.awc',    'myvehicles.meta',    'metas/*_handling.meta',
}

data_file 'AUDIO_WAVEPACK' 'audio/mywaves'
data_file 'VEHICLE_METADATA_FILE' 'myvehicles.meta'
data_file 'HANDLING_FILE' 'metas/*_handling.meta'

this_is_a_map

Markiert diese Ressource als GTA-Karte und lädt den Kartenspeicher neu, wenn die Ressource geladen wird.

this_is_a_map 'yes' -- can be any value

server_only

Markiert die Ressource als Nur-Server. Dies verhindert, dass Clients etwas von dieser Ressource herunterladen.

server_only 'yes' -- can be any value

loadscreen

Legt die HTML-Datei fest, die als Ladebildschirm für das Spiel angegeben ist.

loadscreen 'html/loadscreen.html'
file 'html/loadscreen.html'

file

Fügt die angegebene Datei zur Ressourcenpaketdatei hinzu, die von Clients beim Laden der Ressource heruntergeladen werden soll.

file 'main.net.dll.mdb'

dependency

Erfordert, dass die angegebene Ressource vor der aktuellen Ressource geladen wird.

dependency 'myresource-base'

dependencies

Alias für Abhängigkeit. Ist ein absichtlicher Alias speziell für die Pluralisierung.

dependencies {    'myresource-base',    'utility-resource'
}

provide

Markiert die aktuelle Ressource als Ersatz für die angegebene Ressource. Dies bedeutet, dass es anstelle der angegebenen Ressource gestartet wird, wenn eine andere Ressource dies erfordert, und sich so verhält, als würde es beim Starten als Ressource bezeichnet.

provide 'mysql-async'

disable_lazy_natives

LUA

Standardmäßig ist das verzögerte laden nativer Funktionen aktiviert, um die Ressourcenspeicherauslastung drastisch zu reduzieren. Obwohl dies nicht empfohlen wird, kannst du diese Option auf einen beliebigen Wert setzen, um das verzögerte laden zu deaktivieren.

disable_lazy_natives 'yes'

clr_disable_task_scheduler

Deaktiviert falls vorhanden den benutzerdefinierten C # -Aufgabenplaner auf dem Server. Dies erhöht die Kompatibilität mit Bibliotheken von Drittanbietern, die die .NET-TPL verwenden, erhöht jedoch die Wahrscheinlichkeit, dass wir auf Delay (0) warten müssen. um wieder auf dem Hauptfaden zu landen.

FXv2 versions

Das Ressourcen Manifest muss eine bestimmte FXv2-Version angeben, an die sich die Ressource halten soll. Hier wird dir der Versionsname und die Funktionen angezeigt, mit denen du verknüpft bist. Jede Manifestversion enthält alle Funktionen der oben genannten Manifest Versionen, außer dort, wo sie sich gegenseitig überschreiben würden. In diesem Fall wird die neueste Version verwendet.

FX-Version cerulean (2020-05)

Erfordert https: // Rückrufe, unterstützt jedoch WASM und Fetch. FX

Manifestversionen

Das Ressourcen Manifest muss eine bestimmte Version angeben, an die sich die Ressource halten soll. Hier wird dir eine Liste von -GUIDs und Funktionen angezeigt, denen sie zugeordnet sind. Jede Manifest Version enthält alle Funktionen der oben genannten Manifest Versionen, außer dort, wo sie sich gegenseitig überschreiben würden. In diesem Fall wird die neueste Version verwendet.

Falsche Manifest Versionen

Standardmäßig wird keine Manifest Version verwendet, die der Manifest-GUID 00000000-0000-0000-0000-000000000000 entspricht. Diese (zusammen mit der leeren GUID) wird in zukünftigen Versionen von FXServer entfernt, und es werden Ressourcen benötigt, um eine Manifest Version anzugeben.

Manifestversion 00000000-0000-0000-0000-000000000000

Die Datei natives.lua natives_21e43a33.lua wird für clientseitige Lua verwendet.

Quelle: KLICK