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
.zipde celle-ci, ou le dossier lui-même. Une resource, c'est un dossier dans le répertoireresources/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
Ouvrir Script Bridge
Allez sur Script Bridge. La barre de gauche affiche les quatre étapes : Importer, Analyse, Convertir et Télécharger.
- 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
Déposer la resource
Glissez le
.zipou le dossier sur la zone Déposez votre ressource ici, ou utilisez Choisir un .zip ou Choisir un dossier. - 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
| Option | Ce que vous obtenez | À choisir quand |
|---|---|---|
| Native Qbox | Le script appelle Qbox directement. | Votre serveur tourne sous Qbox. |
| Native QBCore | Le script appelle QBCore directement. | Votre serveur tourne sous QBCore. |
| Native ESX | Le script appelle ESX directement. | Votre serveur tourne sous ESX. |
| Universal Bridge | Un 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. |
| Standalone | Aucun 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 :
| Verdict | Ce que ça veut dire pour vous |
|---|---|
| Ça vaut le coup | Le script se convertit proprement. Attendez-vous à peu de choses, voire rien, à vérifier. |
| Faisable, avec des réserves | Il se convertit, mais certaines parties devront être relues ensuite. Les raisons sont listées sous le verdict. |
| Vous n'en avez peut-être pas besoin | Il 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 convertible | Il 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
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
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
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
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
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
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.luaavec 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 aussiconfig/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
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
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 votreserver.cfgle trouve toujours. - 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 contientsql/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
La démarrer sur un serveur de test
Démarrez le serveur, ou tapez
ensuresuivi 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
Vérifier les points ouverts
Demandez à quelqu'un de chercher
-- @bridge:TODOdans les fichiers et de lire ceux listés en faible confiance dansBRIDGE_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
- Traducteur de ressourcesTraduisez dans n'importe quelle langue une ressource que vous avez achetée.
- Réparateur de serveurCollez la console. Découvrez ce qui a cassé et quoi faire.
- Optimiseur de scriptsLes lignes exactes qui mangent des ms dans resmon, avec le correctif de chacune.
- Scanner de vulnérabilitésLes failles que les tricheurs utilisent vraiment, trouvées avant eux.
