GUIDE

Ein FiveM Script installieren

Die Schritte unten sind bei jedem Script gleich, das wir verkaufen. Jede Produktseite wiederholt die, die nur für sie gelten, also lies das einmal und der Rest geht schnell.

Ein FiveM Script installieren

Woher die Dateien kommen

Käufe werden von Tebex geliefert und landen in deinem Cfx.re Keymaster unter Granted assets. Lade von dort, nicht über einen Link, den dir jemand schickt. Ein Script, das dich außerhalb dieses Kanals erreicht, hat kein Entitlement an deinem Lizenzschlüssel, also keine Updates und keinen Anspruch auf Hilfe.

Die Resource ablegen

Kopier den Ordner in dein resources-Verzeichnis und lass den Namen exakt so, wie er geliefert wurde. Genau diesen Namen nutzen die exports-Aufrufe, ein Umbenennen zerlegt also still jede Integration, die darauf zeigt, deine wie die einer anderen Resource. Danach die Startzeile in die Server-Config.

lua
ensure oxmysql
ensure avenida_barber

Warum die Reihenfolge zählt

Starte die Datenbankschicht vor dem Script, denn das Script schreibt beim Boot. Wenn dein Framework nach uns hochfährt, versucht es die Bridge erneut und findet es trotzdem, aber ein zu spät gestartetes oxmysql gibt dir einen SQL-Fehler statt eines neuen Versuchs.

Das SQL ausführen

Jedes Script bringt eine INSTALL.sql mit, aufgeteilt in beschriftete Abschnitte. Abschnitt [A] ist Pflicht und läuft immer. Die späteren sind bedingt, und der Dateikopf sagt genau, wann du sie brauchst, typischerweise die Appearance-Speicherung für Server, die noch keine haben.

Prüfen, ob die Installation durch ist

Setz Config.Debug = true, starte neu und lies die Konsole. Eine Zeile pro Bridge-Kategorie nennt das gewählte Target. Die meisten Scripts haben zusätzlich einen Check-Command, der im Spiel einen vollständigen Installationsbericht ausgibt, etwa /avenida_barber_check, sobald du dir die Ace gegeben hast.

lua
add_ace group.admin avenida_barber.admin allow

Was du einstellen solltest, bevor du aufmachst

Zwei Dinge lohnen sich vor den ersten Spielern: die Sprache in Config.Locale und die Preise, die in der Config-Datei mit dem Namen des Scripts liegen. Alles andere hat einen Standard, der auf den meisten Servern passt.

Später updaten

Lade die neue Version aus dem Keymaster und ersetze den Ordner, behalte dabei deine config/ und locales/. Genau dafür liegen diese beiden Verzeichnisse außerhalb der Escrow, damit deine Änderungen ein Update überleben, und das Changelog nennt alles, was sich verschoben hat.

Fragen

Muss ich den ganzen Server neu starten?

Nein, ein Resource-Restart reicht für Config- und Sprachänderungen. Das SQL läuft nur einmal, und ein kompletter Neustart bringt nur etwas, wenn du die Startreihenfolge der Resources änderst.

Das Script startet nicht, wo schaue ich zuerst?

In die Server-Konsole beim Start. Eine fehlende Abhängigkeit, ein falscher Ordnername und ein fehlgeschlagenes SQL geben dort alle eine Zeile aus. Setz Config.Debug = true und starte neu, dann bekommst du eine Zeile pro Bridge-Kategorie und siehst, ob die Erkennung das gefunden hat, was du erwartest.

Kann ich den Ordner der Resource umbenennen?

Nein. Der Ordnername ist der, den die exports-Aufrufe nutzen, unsere wie deine, ein Umbenennen zerlegt also still jede Integration. Wenn du in der Server-Config einen anderen Namen brauchst, nimm einen Symlink statt umzubenennen.

Wo finde ich meine Dateien nach einer Neuinstallation wieder?

In deinem Cfx.re Keymaster unter Granted assets. Das Entitlement hängt am Account, der das Script gekauft hat, ein frischer Server oder eine neue Maschine ändern daran nichts.

Scripts, die das nutzen

Warenkorb
Spirit RP
Discord