THE ORB
Studio wird gestartet

Script-Brücke: Anleitung und Tutorial

ESX, QBCore, Qbox, standalone: wandle ein Script zwischen ihnen um.

Das Video-Tutorial folgt bald

Bis dahin führt dich die Anleitung unten durch jeden Schritt.

Was es ist

Script Bridge nimmt ein Script, das für ein Framework gebaut wurde, und gibt es dir lauffähig für deins zurück. Das Framework ist die Basis, auf der dein Server läuft (ESX, QBCore oder Qbox): Jedes Job-, Shop- und Inventar-Script redet mit ihm, und ein Script für das eine startet nicht auf dem anderen. Du ziehst die Resource rein, eine kostenlose Analyse sagt dir, ob sich die Umwandlung lohnt und was sie kostet, und wenn du weitermachst, lädst du die ganze Resource umgeschrieben für dein Framework herunter, mit einem Bericht über alles, was du noch prüfen solltest.

Für wen

  • Serverbesitzer, die ein Script für ESX gekauft haben, aber QBCore oder Qbox fahren, oder umgekehrt.
  • Alle, die einen ganzen Server von einem Framework aufs andere umziehen, Resource für Resource.
  • Leute, die vor dem Bezahlen wissen wollen, ob ein Script sauber umgewandelt wird oder ob es auf ihrem Server sowieso schon läuft.

Bevor du anfängst

  • Die Resource, die du umwandeln willst: als .zip oder direkt den Ordner. Eine Resource ist ein Ordner in deinem resources/-Verzeichnis.
  • Zum Umwandeln (nicht zum Analysieren): ein THE ORB Konto mit bezahltem Plan und genug Credits. Siehe Preise.
  • Einen Testserver, auf dem du das Ergebnis ausprobierst, bevor es auf deinen Live-Server geht.

Resource hochladen und Ziel wählen

Das Tool arbeitet mit einer Resource auf einmal. Ziehst du deinen ganzen resources/-Ordner rein, wäre jedes Script darin eine eigene Analyse mit eigenem Preis. Such dir also die eine aus, die du umwandeln willst.

  1. 1

    Script Bridge öffnen

    Geh zu Script Bridge. Die Leiste links zeigt die vier Schritte: Hochladen, Analyse, Umwandeln und Download.

  2. 2

    Ziel-Framework wählen

    Im Panel wählst du unter Umwandeln nach, worauf das Script am Ende laufen soll. Standardmäßig ist Qbox ausgewählt. Du kannst das später ändern: Neu einlesen kostet nichts und geht sofort.

  3. 3

    Resource reinziehen

    Zieh die .zip oder den Ordner auf das Feld Zieh deine Resource hierher, oder nimm Eine .zip wählen bzw. Einen Ordner wählen.

  4. 4

    Ein paar Sekunden warten

    Du siehst vier Phasen: Resource lesen, Lua lesen, herausfinden, was zum Framework gehört, und herausfinden, welche Datenbanktabellen es nutzt. Bis hierhin wurde nichts irgendwohin geschickt.

Resources mit Escrow-Schutz (die Verschlüsselung von Cfx für Bezahl-Scripts) werden abgelehnt. Ihr Code lässt sich nicht lesen, also weder analysieren noch umwandeln. Das Tool sagt dir das, statt es zu versuchen.

Welches Ziel du nimmst

OptionWas du bekommstNimm es, wenn
Native QboxDas Script ruft Qbox direkt auf.Dein Server läuft mit Qbox.
Native QBCoreDas Script ruft QBCore direkt auf.Dein Server läuft mit QBCore.
Native ESXDas Script ruft ESX direkt auf.Dein Server läuft mit ESX.
Universal BridgeDie Resource bekommt einen kleinen bridge/-Ordner, der beim Start erkennt, welches Framework der Server hat.Du bist dir nicht sicher oder wechselst vielleicht später das Framework.
StandaloneGar kein Framework. Geld- und Job-Aufrufe werden zu leeren Hooks in config/hooks.lua.Dein Server hat kein Framework. Jemand muss diese Hooks dann ausfüllen.

Community Bridge steht auch in der Liste, markiert mit Demnächst. Auswählen kannst du es noch nicht.

Die Analyse lesen: Lohnt es sich?

Die Analyse ist kostenlos und läuft komplett in deinem Browser. Sie beantwortet zuerst eine Frage, mit einem farbigen Urteil ganz oben:

UrteilWas es für dich heißt
Lohnt sichDas Script lässt sich sauber umwandeln. Danach bleibt wenig oder nichts zu prüfen.
Machbar, mit EinschränkungenEs lässt sich umwandeln, aber ein paar Stellen muss sich danach jemand anschauen. Die Gründe stehen unter dem Urteil.
Vielleicht brauchst du das gar nichtEs läuft schon auf dem, was du gewählt hast. Die meisten QBCore-Scripts laufen zum Beispiel schon auf Qbox. Probier es zuerst auf deinem Server aus.
Nicht umwandelbarEs gibt nichts zu verkaufen, also keinen Preis und keinen Button. Der Grund wird angezeigt (siehe unten).

Unter dem Urteil siehst du vier Zahlen: wie oft das Script mit dem Framework redet, wie viele dieser Stellen ein bekanntes Gegenstück haben, wie viele Nachdenken brauchen und wie viele Dateien umgeschrieben werden. Darunter listen aufklappbare Bereiche auf, worum du dich kümmern musst, in welchen Datenbanktabellen das Script seine eigenen Daten speichert und jede Datei mit ihrer Zeilenzahl.

  • Eine Resource ohne Lua oder ohne Framework-Code ist nicht umwandelbar: Es gibt nichts zu ändern.
  • Eine einzelne Datei mit mehr als 1.400 Zeilen lässt sich nicht in einem Rutsch umwandeln. Liegt jede Datei, die das Framework berührt, darüber, wird die Resource abgelehnt.
  • Mehr als 12.000 Zeilen Framework-Code insgesamt sind zu viel für eine Umwandlung.
  • Lässt sich ein großer Teil der Dateien nicht als gültiges Lua lesen, ist hier Schluss. Ein oder zwei kaputte Dateien zeigen nur eine Warnung.

Wenn du im Panel das Ziel änderst, läuft die Analyse sofort neu. Du musst nichts noch mal hochladen.

Preis prüfen, bevor du zahlst

Wenn das Urteil eine Umwandlung erlaubt, zeigt das Panel die Zeile Preis mit der genauen Zahl an Credits und deinem Guthaben. Abgebucht wird erst, wenn du den Button drückst.

  1. 1

    Zeile Preis aufklappen

    Dort steht, wie viele Zeilen ORBIE umschreibt und in wie vielen Dateien. Es zählen nur die Dateien, die wirklich mit dem Framework reden: Der Rest der Resource gehört nicht zum Preis.

  2. 2

    Wie sich dieser Preis errechnet aufklappen

    Der Preis sind 3 Credits zum Start, 1 pro Datei, die umgeschrieben werden muss, und 1 pro 45 Zeilen Framework-Code, wobei dieser letzte Teil damit multipliziert wird, wie viel Abwägung diese Zeilen brauchen. Die Gründe für den Multiplikator stehen dabei.

  3. 3

    Prüfen, was deinen Browser verlässt

    Das Panel listet es auf: Die Dateien, die das Framework berühren, und das Manifest (fxmanifest.lua) werden zum Umwandeln geschickt. Bilder, Sprachdateien und die NUI-Seite bleiben auf deinem Rechner.

Umwandeln gibt es in den bezahlten Plänen. Im Free-Plan funktioniert die Analyse, aber der Umwandeln-Button öffnet das Fenster mit den Plänen. Reichen deine Credits nicht für den Preis, steht auf dem Button Nicht genug Credits, und darunter erscheint ein Link, um mehr zu holen.

Mit ORBIE umwandeln

  1. 1

    Convert with ORBIE drücken

    Der Preis steht auf dem Button. Du musst angemeldet sein. Die Credits werden in diesem Moment abgebucht.

  2. 2

    Tab offen lassen

    Der Bildschirm zeigt, wie viele Dateien von allen schon fertig sind. Jede Datei wird umgeschrieben, dann zurückgelesen und mit dem Original verglichen, Funktion für Funktion und Event für Event, damit nichts verloren geht.

  3. 3

    Ergebnis lesen

    Wenn es fertig ist, zeigt der Viewer, wie viele Dateien für dein Framework umgeschrieben wurden und, falls manche es nicht geschafft haben, wie viele Credits zurückgekommen sind.

Besteht die Umwandlung einer Datei auch nach einem zweiten Versuch die Prüfungen nicht, kommt stattdessen deine Originaldatei unverändert in den Download. Diese Dateien werden als genau so gelassen, wie du sie geschrieben hast, aufgelistet, mit Grund.

Ändert sich der Preis zwischen Analyse und Klick (zum Beispiel, weil sich die Dateien geändert haben), analysiert das Tool neu und zeigt dir den neuen Preis, statt den alten abzubuchen.

Verstehen, was zurückkam

Der Ergebnisbildschirm hat bis zu vier Bereiche. Die sollte sich jemand anschauen, bevor das Script live geht:

  • Dateien genau so, wie du sie geschrieben hast: Die Umwandlung hat nicht gehalten, also liegt dein Original im Zip.
  • Stellen, die du entscheiden musst: Stellen, die die Umwandlung absichtlich nicht angefasst hat. Jede ist in der Datei mit -- @bridge:TODO markiert, damit sie jeder beim Prüfen per Suche findet.
  • Dateien, die du vor dem Deployen lesen solltest: Dateien, die mit niedriger Sicherheit zurückkamen (unter 60 %).
  • Was sich geändert hat, Datei für Datei: die Notizen zu jeder umgewandelten Datei und ihre Sicherheit.

Drück im Panel auf Resource herunterladen. Das Zip wird in deinem Browser zusammengebaut, aus den umgewandelten Dateien und den Teilen, die deinen Rechner nie verlassen haben.

Was du herunterlädst

Du lädst eine .zip herunter, benannt nach Resource und Ziel, zum Beispiel my_script_qbx.zip. Drin ist:

  • Die ganze Resource: umgeschriebene Dateien, wo sich etwas geändert hat, jede andere Datei genau so, wie du sie hochgeladen hast.
  • fxmanifest.lua mit Abhängigkeiten, die auf das neue Framework zeigen. Ohne das würde die Resource auf deinem Server nicht starten.
  • BRIDGE_REPORT.md: was sich außerhalb des Codes geändert hat, was du vor dem Start prüfen solltest, welche Dateien nicht umgewandelt werden konnten, welche mit niedriger Sicherheit zurückkamen und was mit deinen Daten passiert.
  • Bei Universal Bridge und Standalone: ein bridge/-Ordner, den das Manifest zuerst lädt. Standalone legt außerdem config/hooks.lua dazu.
  • Wenn das Script eigene Daten speichert: sql/install.sql, das seine Tabellen anlegt, falls sie fehlen.
  • Wenn altes und neues Framework Spieler unterschiedlich erkennen: sql/migrate.sql, das die schon gespeicherten Zeilen mit dem neuen Spieler-Schlüssel verknüpft, damit niemand verliert, was er hatte.

Auf deinem Server installieren

  1. 1

    Zuerst ein Backup

    Kopier den alten Resource-Ordner irgendwohin außerhalb von resources/. Hat das Script eigene Tabellen, sichere auch deine Datenbank.

  2. 2

    Ordner ersetzen

    Entpack den Download und leg den Resource-Ordner anstelle des alten in resources/. Behalte den gleichen Ordnernamen, damit deine server.cfg ihn weiter findet.

  3. 3

    Datenbankdateien ausführen, falls vorhanden

    Hat das Zip sql/install.sql, lies es und führ es in deiner Datenbank aus. Hat es sql/migrate.sql, führ es nach deinem Backup aus. Es fügt nur Spalten hinzu und löscht nie etwas, und die letzte Abfrage zeigt, wie viele Zeilen gepasst haben.

  4. 4

    Auf einem Testserver starten

    Starte den Server oder tipp in der Serverkonsole ensure gefolgt vom Namen der Resource. Das umgewandelte Script haben wir nicht laufen lassen: Probier es aus, bevor deine Spieler es tun.

  5. 5

    Offene Punkte prüfen

    Lass jemanden die Dateien nach -- @bridge:TODO durchsuchen und die Dateien lesen, die in BRIDGE_REPORT.md mit niedriger Sicherheit aufgeführt sind.

Ändere nicht die Reihenfolge der bridge/-Einträge, die das Tool ins Manifest geschrieben hat. Sie müssen vor dem Rest des Scripts laden.

Häufige Probleme

Es heißt, die Resource ist mit Escrow geschützt.

Der Code ist von Cfx verschlüsselt und lässt sich nicht lesen, also auch nicht umwandeln. Frag den Verkäufer nach einer Version für dein Framework.

Das Urteil ist Nicht umwandelbar und es gibt keinen Preis.

Lies den Grund unter dem Urteil. Meistens hat das Script keinen Framework-Code (es läuft also schon überall), eine Datei hat mehr als 1.400 Zeilen, oder das Ganze hat mehr als 12.000 Zeilen Framework-Code. Abgebucht wurde nichts.

Der Umwandeln-Button öffnet das Fenster mit den Plänen.

Umwandeln gehört zu einem bezahlten Plan. Die Analyse bleibt kostenlos. Siehe Preise.

Die Resource startet nach dem Umwandeln nicht.

Such in der Serverkonsole die erste rote Zeile und füg sie in Server Fixer ein. Prüf außerdem, ob du sql/install.sql ausgeführt hast, falls das Zip eine hatte, und ob du die bridge/-Zeilen im Manifest nicht verschoben hast.

Spieler sagen, ihre Items oder ihr Fortschritt sind weg.

Das Script speichert Daten unter dem Schlüssel jedes Spielers, und das neue Framework nutzt einen anderen Schlüssel. Führ sql/migrate.sql aus dem Zip aus (nach einem Datenbank-Backup). Steht im Bericht, dass manche Zeilen beim Beitreten ergänzt werden, reparieren die sich beim ersten Login jedes Spielers von selbst.

Manche Dateien kamen unverändert zurück.

Ihre Umwandlung ist zweimal durch die Prüfungen gefallen, also hast du dein Original bekommen statt etwas Kaputtem. Die Credits für diese Dateien kamen automatisch zurück. Diese Dateien muss noch jemand von Hand umwandeln.

Häufige Fragen

Ist die Analyse wirklich kostenlos?

Ja. Sie läuft in deinem Browser, braucht keine Anmeldung, und nichts wird verschickt, bis du auf Umwandeln drückst.

Was wird beim Umwandeln verschickt?

Nur die Dateien, die mit dem Framework reden, plus das Manifest. Bilder, Sounds, Sprachdateien und die NUI-Seite verlassen nie deinen Rechner. Das Zip wird in deinem Browser gebaut.

Was, wenn die Umwandlung schiefgeht?

Kommt nichts Brauchbares zurück, bekommst du alle Credits zurück. Scheitern nur einzelne Dateien, bekommst du den Teil des Preises für diese Dateien zurück. Die 3 Start-Credits werden nur behalten, wenn etwas geliefert wurde.

Mein Script ist für QBCore und mein Server läuft mit Qbox. Brauche ich das?

Meistens nicht: Qbox führt die meisten QBCore-Scripts so aus, wie sie sind, und die Analyse sagt dir das. Umwandeln kannst du trotzdem, wenn du native Qbox-Aufrufe willst.

Kann ich die Seite schließen, während umgewandelt wird?

Lass den Tab offen. Der Download wird in diesem Tab aus deinen Originaldateien zusammengebaut. Schließt du ihn, musst du neu hochladen.

Wandelt es auch die NUI um (die Menüs auf dem Bildschirm)?

Nein. Umgeschrieben wird nur das Lua, das mit dem Framework redet. Schickt das Script Framework-Daten an sein Menü, warnt dich die Analyse, weil der Code des Menüs das alte Format erwarten könnte.

Am 15. November 2026 mit dem Tool abgeglichen.

Probier Script-Brücke jetzt aus

Ein Script fürs falsche Framework gekauft? Zieh es rein und hol es dir lauffähig auf deinem zurück — mit einem ehrlichen Bericht darüber, was sich nicht konvertieren ließ.

Weitere Anleitungen: Scripts