Puente de scripts: guía y tutorial
ESX, QBCore, Qbox, standalone: convierte un script de uno a otro.
El videotutorial llega pronto
Mientras tanto, la guía escrita de abajo te lleva por cada paso.
Qué es
Script Bridge toma un script hecho para un framework y te lo devuelve funcionando en el tuyo. El framework es la base sobre la que corre tu servidor (ESX, QBCore o Qbox): todos los scripts de trabajos, tiendas e inventario hablan con él, y un script escrito para uno no arranca en otro. Sueltas el recurso, un análisis gratis te dice si vale la pena convertirlo y cuánto cuesta, y si sigues adelante descargas el recurso completo, reescrito para tu framework, con un informe de lo que queda por revisar.
Para quién es
- Dueños de servidor que compraron un script para ESX pero usan QBCore o Qbox, o al revés.
- Quien está pasando un servidor entero de un framework a otro, recurso por recurso.
- Quien quiere saber antes de pagar si un script se convierte bien, o si ya funciona en su servidor.
Antes de empezar
- El recurso que quieres convertir: un
.zipo la carpeta misma. Un recurso es una carpeta dentro deresources/en tu servidor. - Para convertir (no para analizar): una cuenta de THE ORB con un plan pago y créditos suficientes. Mira los precios.
- Un servidor de prueba donde probar el resultado antes que en el servidor de verdad.
Sube el recurso y elige dónde va a correr
La herramienta trabaja con un recurso a la vez. Si sueltas toda la carpeta resources/, cada script sería su propio análisis y su propio precio, así que elige el que quieres convertir.
- 1
Abre Script Bridge
Entra en Script Bridge. El riel de la izquierda muestra los cuatro pasos: Subir, Análisis, Convertir y Descargar.
- 2
Elige el framework de destino
En el panel, en Convertir a, elige sobre qué tiene que correr el script al terminar. Viene elegido Qbox. Puedes cambiarlo después: releer es gratis e instantáneo.
- 3
Suelta el recurso
Arrastra el
.zipo la carpeta a la caja, o usa Elegir un .zip o Elegir una carpeta. - 4
Espera unos segundos
Verás cuatro etapas: leer el recurso, leer el Lua, ver qué pertenece al framework y ver qué tablas de la base de datos usa. Hasta aquí no se envió nada a ningún lado.
Los recursos protegidos con escrow (el cifrado de Cfx para scripts pagos) se rechazan. Su código no se puede leer, así que no se puede analizar ni convertir. La herramienta lo dice en vez de intentarlo.
Qué destino elegir
| Opción | Qué obtienes | Elígela cuando |
|---|---|---|
| Native Qbox | El script llama a Qbox directamente. | Tu servidor usa Qbox. |
| Native QBCore | El script llama a QBCore directamente. | Tu servidor usa QBCore. |
| Native ESX | El script llama a ESX directamente. | Tu servidor usa ESX. |
| Universal Bridge | Se agrega al recurso una carpeta bridge/ que al arrancar averigua qué framework tiene el servidor. | No estás seguro, o puede que cambies de framework más adelante. |
| Standalone | Sin framework. Las llamadas de dinero y trabajos quedan como funciones vacías en config/hooks.lua. | Tu servidor no tiene framework. Alguien tiene que completar esas funciones. |
En la lista también aparece Community Bridge, marcado como próximamente. Todavía no se puede elegir.
Lee el análisis: ¿vale la pena?
El análisis es gratis y corre entero en tu navegador. Primero responde una pregunta, con un veredicto de color arriba:
| Veredicto | Qué significa para ti |
|---|---|
| Vale la pena | El script se convierte limpio. Queda poco o nada por revisar. |
| Se puede, con reparos | Se convierte, pero algunas partes van a necesitar que alguien las mire después. Los motivos aparecen debajo del veredicto. |
| Puede que no lo necesites | Ya corre en lo que elegiste. Por ejemplo, la mayoría de los scripts de QBCore ya corren en Qbox. Pruébalo primero en tu servidor. |
| No se puede convertir | No hay nada que venderte, así que no hay precio ni botón. Se muestra el motivo (mira abajo). |
Debajo del veredicto ves cuatro números: cuántas veces el script habla con el framework, cuántas de esas tienen una equivalencia conocida, cuántas hay que razonar y cuántos archivos se van a reescribir. Más abajo, secciones plegadas listan lo que va a necesitar tu atención, las tablas de la base de datos donde el script guarda sus datos y cada archivo con sus líneas.
- Un recurso sin Lua, o sin código del framework, no se puede convertir: no hay nada que cambiar.
- Un solo archivo de más de 1.400 líneas no se puede convertir de una vez. Si todos los archivos que tocan el framework pasan de eso, el recurso se rechaza.
- Más de 12.000 líneas de código del framework en total es demasiado para una conversión.
- Si una buena parte de los archivos no se puede leer como Lua válido, se detiene ahí. Uno o dos archivos rotos solo muestran un aviso.
Cambiar el destino en el panel vuelve a hacer el análisis en el momento. No hace falta subir de nuevo.
Mira el precio antes de pagar
Cuando el veredicto permite convertir, el panel muestra la fila Precio con los créditos exactos y tu saldo. No se cobra nada hasta que aprietas el botón.
- 1
Abre la fila Precio
Dice cuántas líneas va a reescribir ORBIE y en cuántos archivos. Solo cuentan los archivos que hablan con el framework: el resto del recurso no entra en el precio.
- 2
Abre Cómo se calcula este precio
Son 3 créditos para empezar, 1 por cada archivo que hay que reescribir y 1 por cada 45 líneas de código del framework, y esa última parte se multiplica según cuánto criterio piden esas líneas. Los motivos del multiplicador aparecen en la lista.
- 3
Mira qué sale de tu navegador
El panel lo dice: se envían a convertir los archivos que tocan el framework y el manifiesto (
fxmanifest.lua). Las imágenes, los archivos de idioma y la página NUI se quedan en tu computadora.
Convertir es de los planes pagos. En el plan Free el análisis funciona, pero al apretar convertir se abre la ventana de planes. Si tus créditos no alcanzan, el botón dice que no te alcanzan y aparece debajo un enlace para conseguir más.
Conviértelo con ORBIE
- 1
Aprieta Convert with ORBIE
El precio está en el botón. Tienes que haber iniciado sesión. Los créditos se descuentan en ese momento.
- 2
Deja la pestaña abierta
La pantalla muestra cuántos archivos van de cuántos. Cada archivo se reescribe y después se vuelve a leer y se compara con el original, función por función y evento por evento, para asegurar que no se perdió nada.
- 3
Lee el resultado
Al terminar, el visor dice cuántos archivos se reescribieron para tu framework y, si alguno no salió, cuántos créditos volvieron.
Si la conversión de un archivo no pasa los controles después de un segundo intento, en la descarga va tu archivo original, sin tocar. Esos archivos aparecen como dejados tal como los escribiste, con el motivo.
Si el precio cambia entre el análisis y el clic (por ejemplo, porque cambiaron los archivos), la herramienta vuelve a analizar y te muestra el precio nuevo en vez de cobrar el viejo.
Entiende lo que volvió
La pantalla del resultado tiene hasta cuatro secciones. Es lo que alguien debería mirar antes de poner el script en el servidor de verdad:
- Archivos dejados tal como los escribiste: la conversión no aguantó los controles, así que en el zip va tu original.
- Lugares que quedan para que decidas: puntos que la conversión no tocó a propósito. Cada uno está marcado dentro del archivo con
-- @bridge:TODO, para que quien lo revise pueda buscar ese texto. - Archivos para leer antes de publicar: los que volvieron con poca confianza (menos del 60%).
- Qué cambió, archivo por archivo: las notas de cada archivo convertido y su confianza.
Aprieta Descargar el recurso en el panel. El zip se arma en tu navegador con los archivos convertidos y las partes que nunca salieron de tu computadora.
Qué descargas
Descargas un .zip con el nombre del recurso y el destino, por ejemplo mi_script_qbx.zip. Adentro:
- El recurso completo: los archivos reescritos donde algo cambió y todos los demás tal como los subiste.
fxmanifest.luacon sus dependencias apuntando al framework nuevo. Sin eso el recurso se negaría a arrancar en tu servidor.BRIDGE_REPORT.md: qué cambió fuera del código, qué revisar antes de arrancarlo, qué archivos no se pudieron convertir, cuáles volvieron con poca confianza y qué pasa con tus datos.- Para Universal Bridge y Standalone: una carpeta
bridge/que el manifiesto carga primero. Standalone además agregaconfig/hooks.lua. - Si el script guarda sus propios datos:
sql/install.sql, que crea sus tablas si faltan. - Si el framework viejo y el nuevo identifican a los jugadores de forma distinta:
sql/migrate.sql, que une las filas ya guardadas con la clave nueva de cada jugador, para que nadie pierda lo que tenía.
Instalarlo en tu servidor
- 1
Haz una copia primero
Copia la carpeta vieja del recurso a algún lugar fuera de
resources/. Si el script tiene sus propias tablas, haz también una copia de la base de datos. - 2
Reemplaza la carpeta
Descomprime la descarga y pon la carpeta del recurso en
resources/en lugar de la vieja. Deja el mismo nombre de carpeta para que tuserver.cfgla siga encontrando. - 3
Corre los archivos de base de datos si los hay
Si el zip trae
sql/install.sql, léelo y córrelo en tu base de datos. Si traesql/migrate.sql, córrelo después de la copia. Solo agrega columnas y nunca borra nada, y su última consulta muestra cuántas filas coincidieron. - 4
Arráncalo en un servidor de prueba
Inicia el servidor, o escribe
ensureseguido del nombre del recurso en la consola del servidor. Nosotros no corrimos el script convertido: pruébalo antes que tus jugadores. - 5
Revisa los puntos abiertos
Que alguien busque
-- @bridge:TODOen los archivos y lea los archivos marcados con poca confianza enBRIDGE_REPORT.md.
No cambies el orden de las líneas de bridge/ que la herramienta agregó al manifiesto. Tienen que cargarse antes que el resto del script.
Problemas comunes
Dice que el recurso está protegido con escrow.
El código está cifrado por Cfx y no se puede leer, así que no se puede convertir. Pídele al vendedor una versión para tu framework.
El veredicto es No se puede convertir y no hay precio.
Lee el motivo debajo del veredicto. Casi siempre el script no tiene código del framework (ya funciona en cualquiera), un archivo pasa de 1.400 líneas o el total pasa de 12.000 líneas de código del framework. No se cobró nada.
Al apretar convertir se abre la ventana de planes.
Convertir viene con un plan pago. El análisis sigue siendo gratis. Mira los precios.
El recurso no arranca después de convertirlo.
Busca la primera línea roja en la consola del servidor y pégala en Server Fixer. Revisa también que hayas corrido sql/install.sql si el zip lo traía, y que no hayas movido las líneas de bridge/ en el manifiesto.
Los jugadores dicen que perdieron sus cosas o su progreso.
El script guarda los datos con la clave de cada jugador, y el framework nuevo usa otra clave. Corre sql/migrate.sql del zip (después de copiar la base de datos). Si el informe dice que algunas filas se completan cuando el jugador entra, esas se arreglan solas la primera vez que cada jugador se conecta.
Algunos archivos volvieron sin cambios.
Su conversión falló los controles dos veces, así que recibiste tu original en vez de algo roto. Los créditos de esos archivos volvieron solos. Esos archivos todavía necesitan que alguien los convierta a mano.
Preguntas frecuentes
¿El análisis es gratis de verdad?
Sí. Corre en tu navegador, no pide iniciar sesión y no se envía nada hasta que aprietas convertir.
¿Qué se envía cuando convierto?
Solo los archivos que hablan con el framework, más el manifiesto. Las imágenes, los sonidos, los archivos de idioma y la página NUI nunca salen de tu computadora. El zip se arma en tu navegador.
¿Qué pasa si la conversión falla?
Si no vuelve nada utilizable, te devolvemos todos los créditos. Si solo fallan algunos archivos, te devolvemos la parte del precio de esos archivos. Los 3 créditos de arranque solo se quedan cuando se entregó algo.
Mi script es de QBCore y mi servidor es Qbox. ¿Lo necesito?
Casi nunca: Qbox corre la mayoría de los scripts de QBCore tal como están, y el análisis te lo dice. Igual puedes convertirlo si quieres llamadas nativas de Qbox.
¿Puedo cerrar la página mientras convierte?
Deja la pestaña abierta. La descarga se arma en esta pestaña con tus archivos originales, así que si la cierras tendrás que subir de nuevo.
¿Convierte la NUI (los menús en pantalla)?
No. Solo se reescribe el Lua que habla con el framework. Si el script le pasa datos del framework a su menú, el análisis te avisa, porque el código del menú puede esperar el formato viejo.
Revisada contra la herramienta el 15 de noviembre de 2026.
Prueba Puente de scripts ahora
¿Compraste un script para el framework equivocado? Suéltalo aquí y recupéralo funcionando en el tuyo, con un informe honesto de lo que no se pudo convertir.
Más guías de Scripts
- Traductor de recursosTraduce a cualquier idioma un recurso que compraste.
- Reparador de servidoresPega la consola. Descubre qué se rompió y qué hacer.
- Optimizador de scriptsLas líneas exactas que se comen ms en resmon, con el arreglo de cada una.
- Escáner de vulnerabilidadesLos agujeros que los tramposos usan de verdad, encontrados antes que ellos.
