THE ORB
Iniciando o studio

Ponte de scripts: guia e tutorial

ESX, QBCore, Qbox, standalone: converta um script de um para outro.

O tutorial em vídeo chega em breve

Enquanto isso, o guia escrito abaixo te leva por cada passo.

O que é

O Script Bridge pega um script feito para um framework e devolve ele funcionando no seu. O framework é a base em que o seu servidor roda (ESX, QBCore ou Qbox): todo script de emprego, loja e inventário conversa com ele, e um script escrito para um não liga no outro. Você solta o resource, uma análise grátis diz se vale a pena converter e quanto custa, e se você seguir em frente baixa o resource inteiro de volta, reescrito para o seu framework, com um relatório do que ficou para você conferir.

Para quem é

  • Donos de servidor que compraram um script para ESX mas usam QBCore ou Qbox, ou o contrário.
  • Quem está passando um servidor inteiro de um framework para outro, um resource de cada vez.
  • Quem quer saber antes de pagar se um script vai converter sem problema, ou se ele já roda no seu servidor.

Antes de começar

  • O resource que você quer converter: um .zip dele, ou a própria pasta. Um resource é uma pasta dentro do diretório resources/ do seu servidor.
  • Para converter (não para analisar): uma conta THE ORB com plano pago e créditos suficientes. Veja os preços.
  • Um servidor de teste onde você possa testar o resultado antes do servidor principal.

Envie o resource e escolha onde ele vai rodar

A ferramenta trabalha com um resource de cada vez. Se você soltar a pasta resources/ inteira, cada script lá dentro vira uma análise e um preço separados, então escolha o que você quer converter.

  1. 1

    Abra o Script Bridge

    Entre no Script Bridge. A barra da esquerda mostra os quatro passos: Enviar, Análise, Converter e Baixar.

  2. 2

    Escolha o framework de destino

    No painel, em Converter para, escolha onde o script vai rodar quando estiver pronto. O Qbox vem selecionado. Dá para trocar depois: reler é grátis e instantâneo.

  3. 3

    Solte o resource

    Arraste o .zip ou a pasta para a caixa que diz Solte o seu resource aqui, ou use Escolher um .zip ou Escolher uma pasta.

  4. 4

    Espere alguns segundos

    Você vê quatro etapas: leitura do resource, leitura do Lua, separação do que é do framework e identificação das tabelas do banco de dados que ele usa. Até aqui, nada foi enviado para lugar nenhum.

Resources protegidos por escrow (a criptografia da Cfx para scripts pagos) são recusados. O código deles não pode ser lido, então não dá para analisar nem converter. A ferramenta avisa isso em vez de tentar.

Qual destino escolher

OpçãoO que você recebeEscolha quando
Native QboxO script chama o Qbox direto.Seu servidor roda Qbox.
Native QBCoreO script chama o QBCore direto.Seu servidor roda QBCore.
Native ESXO script chama o ESX direto.Seu servidor roda ESX.
Universal BridgeUma pastinha bridge/ é adicionada ao resource e, ao ligar, descobre qual framework o servidor tem.Você não tem certeza, ou pode trocar de framework mais tarde.
StandaloneNenhum framework. As chamadas de dinheiro e de emprego viram hooks vazios em config/hooks.lua.Seu servidor não tem framework. Alguém vai ter que preencher esses hooks.

O Community Bridge também aparece na lista, marcado como em breve. Ainda não dá para escolher.

Leia a análise: vale a pena?

A análise é grátis e roda inteira no seu navegador. Primeiro ela responde uma pergunta, com um veredito colorido no topo:

VereditoO que isso significa para você
Vale a penaO script converte sem problema. Espere pouca coisa ou nada para conferir.
Dá para fazer, com ressalvasConverte, mas algumas partes vão precisar que alguém dê uma olhada depois. Os motivos aparecem embaixo do veredito.
Pode ser que você não preciseEle já roda no que você escolheu. Por exemplo, a maioria dos scripts QBCore já roda no Qbox. Teste no seu servidor primeiro.
Não dá para converterNão tem nada para vender a você, então não aparece preço nem botão. O motivo é mostrado (veja abaixo).

Embaixo do veredito você vê quatro números: quantas vezes o script conversa com o framework, quantas dessas têm um equivalente conhecido, quantas precisam de raciocínio e quantos arquivos vão ser reescritos. Mais abaixo, seções recolhidas listam o que vai precisar da sua atenção, as tabelas do banco onde o script guarda os próprios dados e cada arquivo com o número de linhas.

  • Um resource sem Lua, ou sem código de framework, não dá para converter: não tem nada para mudar.
  • Um arquivo sozinho com mais de 1.400 linhas não pode ser convertido de uma vez. Se todos os arquivos que mexem com o framework passam disso, o resource é recusado.
  • Mais de 12.000 linhas de código de framework no total é grande demais para uma conversão só.
  • Se boa parte dos arquivos não puder ser lida como Lua válido, a análise para por aí. Um ou dois arquivos quebrados só mostram um aviso.

Trocar o destino no painel refaz a análise na hora. Você não precisa enviar de novo.

Confira o preço antes de pagar

Quando o veredito permite converter, o painel mostra a linha Preço com o número exato de créditos e o seu saldo. Nada é cobrado até você apertar o botão.

  1. 1

    Abra a linha Preço

    Ela diz quantas linhas o ORBIE vai reescrever e em quantos arquivos. Só contam os arquivos que realmente conversam com o framework: o resto do resource não entra no preço.

  2. 2

    Abra Como esse preço é calculado

    O preço é 3 créditos de início, 1 por arquivo que precisa ser reescrito e 1 a cada 45 linhas de código de framework, com essa última parte multiplicada pelo quanto de critério essas linhas exigem. Os motivos do multiplicador aparecem listados.

  3. 3

    Veja o que sai do seu navegador

    O painel mostra: os arquivos que mexem com o framework e o manifest (fxmanifest.lua) são enviados para conversão. Imagens, arquivos de idioma e a página NUI ficam no seu computador.

Converter é para planos pagos. No plano Free a análise funciona, mas apertar converter abre a janela de planos. Se os seus créditos não cobrem o preço, o botão avisa que os créditos não dão e aparece embaixo um link para conseguir mais.

Converta com o ORBIE

  1. 1

    Aperte Convert with ORBIE

    O preço está no botão. Você precisa estar logado. Os créditos são descontados nesse momento.

  2. 2

    Deixe a aba aberta

    A tela mostra quantos arquivos já ficaram prontos do total. Cada arquivo é reescrito, depois relido e comparado com o original, função por função e evento por evento, para garantir que nada se perdeu.

  3. 3

    Leia o resultado

    Quando termina, o visor diz quantos arquivos foram reescritos para o seu framework e, se algum não deu certo, quantos créditos voltaram.

Se a conversão de um arquivo não passar nas verificações depois de uma segunda tentativa, o seu arquivo original vai no download, sem mudanças. Esses arquivos aparecem como deixados do jeito que você escreveu, com o motivo.

Se o preço mudar entre a análise e o clique (por exemplo, porque os arquivos mudaram), a ferramenta analisa de novo e mostra o preço novo em vez de cobrar o antigo.

Entenda o que voltou

A tela de resultado tem até quatro seções. É o que alguém deve olhar antes de o script entrar no ar:

  • Arquivos do jeito que você escreveu: a conversão não se sustentou, então o seu original está no zip.
  • Lugares que cabem a você decidir: pontos que a conversão deixou de propósito sem mexer. Cada um está marcado dentro do arquivo com -- @bridge:TODO, para quem revisar poder procurar esse texto.
  • Arquivos para ler antes de subir: arquivos que voltaram com confiança baixa (menos de 60%).
  • O que mudou, arquivo por arquivo: as notas de cada arquivo convertido e a confiança dele.

Aperte Baixar o recurso no painel. O zip é montado no seu navegador com os arquivos convertidos e as partes que nunca saíram do seu computador.

O que você baixa

Você baixa um .zip com o nome do resource e do destino, por exemplo my_script_qbx.zip. Dentro dele:

  • O resource inteiro: arquivos reescritos onde algo mudou e todos os outros exatamente como você enviou.
  • O fxmanifest.lua com as dependências apontando para o framework novo. Sem isso o resource se recusaria a ligar no seu servidor.
  • BRIDGE_REPORT.md: o que mudou fora do código, o que conferir antes de ligar, quais arquivos não puderam ser convertidos, quais voltaram com confiança baixa e o que acontece com os seus dados.
  • Para Universal Bridge e Standalone: uma pasta bridge/ que o manifest carrega primeiro. O Standalone também adiciona config/hooks.lua.
  • Se o script guarda dados próprios: sql/install.sql, que cria as tabelas dele se estiverem faltando.
  • Se o framework antigo e o novo identificam os jogadores de jeitos diferentes: sql/migrate.sql, que liga as linhas já salvas à nova chave de jogador, para ninguém perder o que tinha.

Instalar no seu servidor

  1. 1

    Faça backup antes

    Copie a pasta do resource antigo para algum lugar fora de resources/. Se o script tem tabelas próprias, faça backup do banco de dados também.

  2. 2

    Troque a pasta

    Descompacte o download e coloque a pasta do resource em resources/ no lugar da antiga. Mantenha o mesmo nome de pasta para o seu server.cfg continuar encontrando.

  3. 3

    Rode os arquivos do banco, se houver

    Se o zip tem sql/install.sql, leia e rode no seu banco de dados. Se tem sql/migrate.sql, rode depois do backup. Ele só adiciona colunas, nunca apaga nada, e a última consulta mostra quantas linhas bateram.

  4. 4

    Ligue num servidor de teste

    Ligue o servidor, ou digite ensure seguido do nome do resource no console do servidor. A gente não rodou o script convertido: teste antes dos seus jogadores.

  5. 5

    Confira os pontos em aberto

    Peça para alguém procurar -- @bridge:TODO nos arquivos e ler os arquivos listados com confiança baixa no BRIDGE_REPORT.md.

Não mude a ordem das entradas bridge/ que a ferramenta adicionou ao manifest. Elas precisam carregar antes do resto do script.

Problemas comuns

Diz que o resource está protegido por escrow.

O código está criptografado pela Cfx e não pode ser lido, então não dá para converter. Peça ao vendedor uma versão para o seu framework.

O veredito é Não dá para converter e não aparece preço.

Leia o motivo embaixo do veredito. Normalmente o script não tem código de framework (já funciona em qualquer lugar), um arquivo passa de 1.400 linhas, ou o total passa de 12.000 linhas de código de framework. Nada foi cobrado.

Apertar converter abre a janela de planos.

Converter vem com um plano pago. A análise continua grátis. Veja os preços.

O resource não liga depois de converter.

Procure a primeira linha vermelha no console do servidor e cole no Server Fixer. Confira também se você rodou o sql/install.sql, caso o zip tenha um, e se não mexeu nas linhas bridge/ do manifest.

Os jogadores dizem que os itens ou o progresso sumiram.

O script guarda os dados pela chave de cada jogador, e o framework novo usa outra chave. Rode o sql/migrate.sql do zip (depois de um backup do banco). Se o relatório diz que algumas linhas se completam quando o jogador entra, essas se resolvem sozinhas na primeira vez que cada jogador logar.

Alguns arquivos voltaram sem mudanças.

A conversão deles falhou nas verificações duas vezes, então você recebeu o original em vez de algo quebrado. Os créditos desses arquivos voltaram automaticamente. Esses arquivos ainda precisam que alguém converta na mão.

Perguntas frequentes

A análise é grátis mesmo?

Sim. Ela roda no seu navegador, não precisa de login e nada é enviado até você apertar converter.

O que é enviado quando eu converto?

Só os arquivos que conversam com o framework, mais o manifest. Imagens, sons, arquivos de idioma e a página NUI nunca saem do seu computador. O zip é montado no seu navegador.

E se a conversão falhar?

Se não voltar nada aproveitável, você recebe todos os créditos de volta. Se só alguns arquivos falharem, volta a parte do preço desses arquivos. Os 3 créditos de início só ficam quando algo foi entregue.

Meu script é QBCore e meu servidor é Qbox. Preciso disso?

Normalmente não: o Qbox roda a maioria dos scripts QBCore do jeito que estão, e a análise avisa isso. Mesmo assim, você pode converter se quiser chamadas nativas do Qbox.

Posso fechar a página enquanto converte?

Deixe a aba aberta. O download é montado nessa aba a partir dos seus arquivos originais, então fechar significa enviar tudo de novo.

Ele converte a NUI (os menus na tela)?

Não. Só o Lua que conversa com o framework é reescrito. Se o script manda dados do framework para o menu, a análise avisa, porque o código do menu pode esperar o formato antigo.

Conferido com a ferramenta em 15 de novembro de 2026.

Experimente o Ponte de scripts agora

Comprou um script para o framework errado? Solte aqui e receba de volta rodando no seu, com um relatório honesto do que não deu para converter.

Mais guias de Scripts