THE ORB
Démarrage du studio

Passerelle de scripts : guide et tutoriel

ESX, QBCore, Qbox, standalone : convertissez un script de l'un à l'autre.

Le tutoriel vidéo arrive bientôt

En attendant, le guide écrit ci-dessous vous accompagne à chaque étape.

Ce que c'est

Script Bridge prend un script écrit pour un framework et vous le rend fonctionnel sur le vôtre. Le framework, c'est la base sur laquelle tourne votre serveur (ESX, QBCore ou Qbox) : chaque script de métier, de boutique ou d'inventaire dialogue avec lui, et un script écrit pour l'un ne démarre pas sur un autre. Vous déposez la resource, une analyse gratuite vous dit si la conversion vaut le coup et combien elle coûte, et si vous continuez, vous téléchargez la resource entière, réécrite pour votre framework, avec un rapport de ce qu'il vous reste à vérifier.

Pour qui

  • Les propriétaires de serveur qui ont acheté un script pour ESX mais tournent sous QBCore ou Qbox, ou l'inverse.
  • Ceux qui font passer tout un serveur d'un framework à un autre, une resource à la fois.
  • Ceux qui veulent savoir, avant de payer, si un script se convertira proprement ou s'il tourne déjà sur leur serveur.

Avant de commencer

  • La resource à convertir : un .zip de celle-ci, ou le dossier lui-même. Une resource, c'est un dossier dans le répertoire resources/ de votre serveur.
  • Pour convertir (pas pour analyser) : un compte THE ORB avec une offre payante, et assez de crédits. Voir les tarifs.
  • Un serveur de test pour essayer le résultat avant votre serveur en ligne.

Importer la resource et choisir où elle doit tourner

L'outil travaille sur une resource à la fois. Si vous déposez tout votre dossier resources/, chaque script qu'il contient serait une analyse et un prix à part : choisissez donc celui que vous voulez convertir.

  1. 1

    Ouvrir Script Bridge

    Allez sur Script Bridge. La barre de gauche affiche les quatre étapes : Importer, Analyse, Convertir et Télécharger.

  2. 2

    Choisir le framework cible

    Dans le panneau, sous Convertir vers, choisissez ce sur quoi le script doit tourner une fois terminé. Qbox est sélectionné par défaut. Vous pourrez changer plus tard : la relecture est gratuite et immédiate.

  3. 3

    Déposer la resource

    Glissez le .zip ou le dossier sur la zone Déposez votre ressource ici, ou utilisez Choisir un .zip ou Choisir un dossier.

  4. 4

    Patienter quelques secondes

    Quatre étapes défilent : lecture de la resource, lecture du Lua, repérage de ce qui appartient au framework, puis des tables de base de données utilisées. À ce stade, rien n'a été envoyé nulle part.

Les resources protégées par escrow (le chiffrement de Cfx pour les scripts payants) sont refusées. Leur code est illisible, donc impossible à analyser ou à convertir. L'outil vous le dit au lieu d'essayer.

Quelle cible choisir

OptionCe que vous obtenezÀ choisir quand
Native QboxLe script appelle Qbox directement.Votre serveur tourne sous Qbox.
Native QBCoreLe script appelle QBCore directement.Votre serveur tourne sous QBCore.
Native ESXLe script appelle ESX directement.Votre serveur tourne sous ESX.
Universal BridgeUn petit dossier bridge/ est ajouté à la resource et détecte au démarrage le framework du serveur.Vous n'êtes pas sûr, ou vous changerez peut-être de framework plus tard.
StandaloneAucun framework. Les appels d'argent et de métier deviennent des hooks vides dans config/hooks.lua.Votre serveur n'a pas de framework. Quelqu'un devra remplir ces hooks.

Community Bridge apparaît aussi dans la liste, marqué comme bientôt disponible. Vous ne pouvez pas encore le choisir.

Lire l'analyse : est-ce que ça vaut le coup ?

L'analyse est gratuite et tourne entièrement dans votre navigateur. Elle répond d'abord à une question, avec un verdict en couleur tout en haut :

VerdictCe que ça veut dire pour vous
Ça vaut le coupLe script se convertit proprement. Attendez-vous à peu de choses, voire rien, à vérifier.
Faisable, avec des réservesIl se convertit, mais certaines parties devront être relues ensuite. Les raisons sont listées sous le verdict.
Vous n'en avez peut-être pas besoinIl tourne déjà sur ce que vous avez choisi. Par exemple, la plupart des scripts QBCore tournent déjà sur Qbox. Essayez-le d'abord sur votre serveur.
Non convertibleIl n'y a rien à vous vendre : pas de prix, pas de bouton. La raison est affichée (voir plus bas).

Sous le verdict, quatre chiffres : combien de fois le script dialogue avec le framework, combien de ces appels ont un équivalent connu, combien demandent du raisonnement, et combien de fichiers seront réécrits. En dessous, des sections repliées listent ce qui demandera votre attention, les tables de base de données où le script garde ses propres données, et chaque fichier avec son nombre de lignes.

  • Une resource sans Lua, ou sans code de framework, n'est pas convertible : il n'y a rien à changer.
  • Un fichier de plus de 1 400 lignes ne peut pas être converti d'un coup. Si tous les fichiers qui touchent au framework dépassent cette taille, la resource est refusée.
  • Plus de 12 000 lignes de code de framework au total, c'est trop pour une seule conversion.
  • Si une grande partie des fichiers n'est pas du Lua valide, l'analyse s'arrête là. Un ou deux fichiers cassés n'affichent qu'un avertissement.

Changer la cible dans le panneau relance l'analyse sur-le-champ. Inutile d'importer à nouveau.

Vérifier le prix avant de payer

Quand le verdict permet une conversion, le panneau affiche la ligne Prix avec le nombre exact de crédits et votre solde. Rien n'est débité tant que vous n'appuyez pas sur le bouton.

  1. 1

    Ouvrir la ligne Prix

    Elle indique combien de lignes ORBIE va réécrire, et dans combien de fichiers. Seuls les fichiers qui dialoguent vraiment avec le framework comptent : le reste de la resource n'entre pas dans le prix.

  2. 2

    Ouvrir Comment ce prix est calculé

    Le prix, c'est 3 crédits de départ, 1 par fichier à réécrire, et 1 par tranche de 45 lignes de code de framework, cette dernière partie étant multipliée selon le degré de jugement que ces lignes demandent. Les raisons du multiplicateur sont listées.

  3. 3

    Vérifier ce qui quitte votre navigateur

    Le panneau le liste : les fichiers qui touchent au framework et le manifest (fxmanifest.lua) sont envoyés pour la conversion. Les images, les fichiers de langue et la page NUI restent sur votre ordinateur.

La conversion est réservée aux offres payantes. Avec l'offre Free, l'analyse fonctionne, mais le bouton de conversion ouvre la fenêtre des offres. Si vos crédits ne couvrent pas le prix, le bouton indique Not enough credits et un lien pour en obtenir plus apparaît en dessous.

Convertir avec ORBIE

  1. 1

    Appuyer sur Convert with ORBIE

    Le prix est affiché sur le bouton. Vous devez être connecté. Les crédits sont débités à ce moment-là.

  2. 2

    Garder l'onglet ouvert

    L'écran indique combien de fichiers sont terminés sur le total. Chaque fichier est réécrit, puis relu et comparé à l'original, fonction par fonction et événement par événement, pour s'assurer que rien ne s'est perdu.

  3. 3

    Lire le résultat

    À la fin, le visualiseur indique combien de fichiers ont été réécrits pour votre framework et, si certains n'ont pas abouti, combien de crédits vous sont revenus.

Si la conversion d'un fichier ne passe pas les vérifications après une deuxième tentative, c'est votre fichier d'origine, intact, qui va dans le téléchargement. Ces fichiers sont listés comme laissés tels que vous les avez écrits, avec la raison.

Si le prix change entre l'analyse et le clic (par exemple parce que les fichiers ont changé), l'outil refait l'analyse et vous montre le nouveau prix au lieu de débiter l'ancien.

Comprendre ce que vous recevez

L'écran de résultat compte jusqu'à quatre sections. C'est ce que quelqu'un doit regarder avant que le script passe en ligne :

  • Fichiers laissés tels que vous les avez écrits : la conversion n'a pas tenu, votre original est donc dans le zip.
  • Endroits qu'il vous revient de trancher : des points que la conversion n'a volontairement pas touchés. Chacun est marqué dans le fichier par -- @bridge:TODO, pour que la personne qui relit puisse chercher ce texte.
  • Fichiers à lire avant de déployer : les fichiers revenus avec une faible confiance (moins de 60 %).
  • Ce qui a changé, fichier par fichier : les notes de chaque fichier converti et sa confiance.

Appuyez sur Télécharger la ressource dans le panneau. Le zip est assemblé dans votre navigateur à partir des fichiers convertis et des parties qui n'ont jamais quitté votre ordinateur.

Ce que vous téléchargez

Vous téléchargez un seul .zip qui porte le nom de la resource et de la cible, par exemple my_script_qbx.zip. Dedans :

  • La resource entière : les fichiers réécrits là où quelque chose a changé, tous les autres exactement comme vous les avez importés.
  • fxmanifest.lua avec ses dépendances pointées vers le nouveau framework. Sans ça, la resource refuserait de démarrer sur votre serveur.
  • BRIDGE_REPORT.md : ce qui a changé en dehors du code, ce qu'il faut vérifier avant de la démarrer, quels fichiers n'ont pas pu être convertis, lesquels sont revenus avec une faible confiance, et ce qui arrive à vos données.
  • Pour Universal Bridge et Standalone : un dossier bridge/ que le manifest charge en premier. Standalone ajoute aussi config/hooks.lua.
  • Si le script garde ses propres données : sql/install.sql, qui crée ses tables si elles manquent.
  • Si l'ancien et le nouveau framework identifient les joueurs différemment : sql/migrate.sql, qui relie les lignes déjà enregistrées à la nouvelle clé de joueur, pour que personne ne perde ce qu'il avait.

L'installer sur votre serveur

  1. 1

    Faire une sauvegarde d'abord

    Copiez l'ancien dossier de la resource quelque part en dehors de resources/. Si le script a ses propres tables, sauvegardez aussi votre base de données.

  2. 2

    Remplacer le dossier

    Décompressez le téléchargement et placez le dossier de la resource dans resources/ à la place de l'ancien. Gardez le même nom de dossier pour que votre server.cfg le trouve toujours.

  3. 3

    Lancer les fichiers de base de données s'il y en a

    Si le zip contient sql/install.sql, lisez-le et exécutez-le dans votre base de données. S'il contient sql/migrate.sql, exécutez-le après votre sauvegarde. Il ne fait qu'ajouter des colonnes, ne supprime jamais rien, et sa dernière requête indique combien de lignes ont correspondu.

  4. 4

    La démarrer sur un serveur de test

    Démarrez le serveur, ou tapez ensure suivi du nom de la resource dans la console du serveur. Nous n'avons pas exécuté le script converti : essayez-le avant vos joueurs.

  5. 5

    Vérifier les points ouverts

    Demandez à quelqu'un de chercher -- @bridge:TODO dans les fichiers et de lire ceux listés en faible confiance dans BRIDGE_REPORT.md.

Ne changez pas l'ordre des entrées bridge/ que l'outil a ajoutées au manifest. Elles doivent se charger avant le reste du script.

Problèmes fréquents

Il dit que la resource est protégée par escrow.

Le code est chiffré par Cfx et illisible, donc impossible à convertir. Demandez au vendeur une version pour votre framework.

Le verdict est Non convertible et il n'y a pas de prix.

Lisez la raison sous le verdict. En général, le script n'a pas de code de framework (il marche déjà partout), un fichier dépasse 1 400 lignes, ou l'ensemble dépasse 12 000 lignes de code de framework. Rien n'a été débité.

Le bouton de conversion ouvre la fenêtre des offres.

La conversion est incluse dans une offre payante. L'analyse reste gratuite. Voir les tarifs.

La resource ne démarre pas après la conversion.

Repérez la première ligne rouge dans la console du serveur et collez-la dans Server Fixer. Vérifiez aussi que vous avez exécuté sql/install.sql si le zip en contenait un, et que vous n'avez pas déplacé les lignes bridge/ dans le manifest.

Des joueurs disent que leurs objets ou leur progression ont disparu.

Le script enregistre les données sous la clé de chaque joueur, et le nouveau framework utilise une clé différente. Exécutez sql/migrate.sql depuis le zip (après une sauvegarde de la base). Si le rapport indique que certaines lignes se complètent à la connexion du joueur, elles se corrigent seules la première fois que chaque joueur se connecte.

Certains fichiers sont revenus intacts.

Leur conversion a échoué deux fois aux vérifications : vous avez donc reçu votre original au lieu d'un fichier cassé. Les crédits de ces fichiers vous sont revenus automatiquement. Ils restent à convertir à la main.

Questions fréquentes

L'analyse est-elle vraiment gratuite ?

Oui. Elle tourne dans votre navigateur, ne demande pas de connexion, et rien n'est envoyé nulle part tant que vous n'appuyez pas sur convertir.

Qu'est-ce qui est envoyé quand je convertis ?

Uniquement les fichiers qui dialoguent avec le framework, plus le manifest. Les images, les sons, les fichiers de langue et la page NUI ne quittent jamais votre ordinateur. Le zip est assemblé dans votre navigateur.

Et si la conversion échoue ?

Si rien d'utilisable ne revient, vous récupérez tous vos crédits. Si seuls certains fichiers échouent, vous récupérez la part du prix correspondant à ces fichiers. Les 3 crédits de départ ne sont gardés que si quelque chose a été livré.

Mon script est en QBCore et mon serveur sous Qbox. Ai-je besoin de ça ?

En général, non : Qbox fait tourner la plupart des scripts QBCore tels quels, et l'analyse vous le dit. Vous pouvez quand même convertir si vous voulez des appels Qbox natifs.

Puis-je fermer la page pendant la conversion ?

Gardez l'onglet ouvert. Le téléchargement est assemblé dans cet onglet à partir de vos fichiers d'origine : le fermer vous oblige à tout importer à nouveau.

Est-ce que ça convertit la NUI (les menus à l'écran) ?

Non. Seul le Lua qui dialogue avec le framework est réécrit. Si le script envoie des données du framework à son menu, l'analyse vous prévient, car le code du menu peut attendre l'ancien format.

Vérifié avec l'outil le 15 novembre 2026.

Essayez Passerelle de scripts maintenant

Vous avez acheté un script pour le mauvais framework ? Déposez-le ici et récupérez-le fonctionnel sur le vôtre, avec un rapport honnête de ce qui n'a pas pu être converti.

Autres guides : Scripts