THE ORB
Iniciando o studio

Otimizador de scripts: guia e tutorial

As linhas exatas que comem ms no resmon, com a correção de cada uma.

O tutorial em vídeo chega em breve

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

O que é

O Script Optimizer lê os seus scripts e diz o que vai deixar o seu servidor lento quando os jogadores encherem ele: código que roda 60 vezes por segundo à toa, chamadas ao banco de dados que congelam todo mundo, dados enviados para todos os jogadores quando só um precisa. Você recebe uma nota de saúde e uma lista na ordem do que consertar primeiro, com cada item escrito como o que acontece com o seu servidor. Depois o ORBIE pode reescrever os arquivos com problema e te devolver prontos para colocar no lugar.

Para quem é

  • Donos de servidor cujo servidor engasga ou dá rubber-band quando fica cheio.
  • Quem vê um resource comendo milissegundos no resmon (o monitor de resources do jogo) e quer saber por quê.
  • Quem quer conferir um script antes de colocar num servidor que está no ar.

Antes de começar

  • Os scripts para escanear: um .zip com os seus resources, uma pasta inteira (até a sua pasta resources/ completa) ou arquivos .lua e .js soltos.
  • Para deixar o ORBIE consertar: uma conta da THE ORB e, para a maioria dos consertos, créditos. Veja os preços.

Escaneie os seus scripts

  1. 1

    Abra o Script Optimizer

    Entre no Script Optimizer.

  2. 2

    Solte os seus resources

    Arraste um .zip, uma pasta ou arquivos .lua e .js para a caixa que diz Solte os seus resources aqui, ou use Escolher um .zip ou arquivos ou Escolher uma pasta. Vários resources de uma vez não tem problema.

  3. 3

    Espere um instante

    Cada script é lido e conferido atrás dos padrões que já se sabe que deixam servidores de FiveM lentos. Leva segundos.

O escaneamento acontece inteiro no seu navegador e é grátis. Nenhum arquivo é enviado para lugar nenhum, a não ser que você peça para o ORBIE consertar aquele arquivo.

Só os arquivos .lua e .js e os manifests dos resources são lidos; imagens, modelos e sons são ignorados. O manifest diz à tool quais scripts rodam no computador dos jogadores e quais rodam no servidor. Envios muito grandes param de ser lidos perto de 25 MB de código ou 4.000 arquivos.

O seu último escaneamento fica guardado neste aparelho. Se você voltar depois, ele abre onde você parou. Depois de mudar os seus scripts, use Reanalisar a versão nova na seção Escanear para escanear de novo.

Leia a nota e a lista

No topo da seção Achados você vê a Saúde do servidor, de 0 a 100, com um veredito de uma linha:

NotaO que ela diz
85 a 100O seu servidor deve aguentar bem
60 a 84Algumas coisas vão te morder quando crescer
35 a 59Isto vai travar quando o seu servidor encher
Abaixo de 35Os seus jogadores vão sentir isto

Embaixo, os problemas ficam agrupados por quando cuidar deles: Conserte isto primeiro, Conserte isto logo, Vale a pena consertar e Menor. Cada linha diz o que acontece com o seu servidor, seguido do resource onde está.

O visor abre em O que isto faz com o seu servidor: os três piores problemas, cada um com o que acontece e quando. Clique em qualquer um para abrir.

Algumas das coisas que ele procura:

  • Código que roda 60 vezes por segundo, para sempre, mesmo sem ninguém por perto.
  • Chamadas ao banco de dados que congelam o servidor inteiro toda vez que rodam, e todo mundo para de se mexer.
  • Dados enviados para todos os jogadores do servidor, incluindo os que não precisam.
  • Tarefas em segundo plano criadas para cada jogador que entra e que nunca param.
  • Trabalho que congela o servidor por um instante toda vez que um jogador conecta.
  • Menus na tela atualizados 60 vezes por segundo mesmo quando nada mudou.

No fim do resumo, O que a gente contou durante a varredura mostra os números brutos: linhas de código, tarefas em segundo plano, loops que rodam a cada quadro, mensagens enviadas para todos os jogadores, chamadas ao banco que travam e arquivos escaneados.

Abra um problema

  1. 1

    Clique num problema da lista

    O visor mostra a urgência, o que ele faz com o seu servidor, quem ele atinge e quando.

  2. 2

    Leia O que precisa mudar

    Uma descrição curta da mudança, escrita para você conseguir julgar depois se o conserto do ORBIE resolveu.

  3. 3

    Abra Ver os detalhes técnicos se precisar

    O arquivo e a linha, se ele roda no computador do jogador ou no servidor, o código que disparou o aviso e a explicação técnica. Útil para um desenvolvedor.

  4. 4

    Volte

    Use Voltar ao resumo na barra de cima do visor.

Deixe o ORBIE consertar um problema

Cada problema tem uma caixa do ORBIE com o preço no canto. O preço depende de quanto raciocínio o conserto precisa: alguns são mudanças exatas que não precisam de IA e são grátis, o resto custa poucos créditos (por padrão 1 ou 5). No plano Free, os consertos mais profundos incluem uma tentativa grátis; depois disso, eles vêm com um plano pago.

  1. 1

    Aperte Conserta isso, ORBIE

    Só esse arquivo é enviado para o nosso servidor. É a única exceção ao escaneamento que fica só no navegador, só acontece quando você clica, e o código não fica guardado. Você precisa estar logado.

  2. 2

    Leia a resposta

    Você vê O quanto o ORBIE tem certeza, numa barra com porcentagem, e O que eu mudei, em palavras simples. Ver exatamente o que mudou abre as linhas de antes e de depois.

  3. 3

    Aperte Usar esta correção

    O conserto é aplicado na cópia guardada no seu navegador, o arquivo é conferido de novo e a nota sobe se o problema sumiu. Os seus arquivos no disco nunca são mexidos.

O ORBIE só oferece Usar esta correção quando tem certeza suficiente (o mínimo aparece na tela). Abaixo disso, leia a resposta dele como uma ideia, não como um arquivo para colocar no lugar.

Se o ORBIE não consegue um conserto em que confie (por exemplo, a mudança quebraria o script, ou o código na verdade está bom), ele avisa. Quando ele chegou a rodar e não saiu nada seguro, 1 crédito fica pela tentativa; nos outros casos, você não paga. Alguns tipos de problema vêm marcados com O ORBIE ainda não corrige este sozinho: esses não são oferecidos, então você nunca paga por uma tentativa que provavelmente ia falhar.

Conserte tudo

  1. 1

    Confira o total

    No fim da seção Achados, o painel diz quantos problemas o ORBIE consegue consertar e o total exato em créditos, ao lado do seu saldo. Se os seus créditos não cobrem tudo, ele diz mais ou menos até quantos dá.

  2. 2

    Aperte Consertar tudo

    O ORBIE vai passando pela lista, um conserto e uma cobrança por vez. Uma faixa mostra quantos foram consertados e quantos pulados.

  3. 3

    Saia se quiser

    Ele continua trabalhando se você for para outra página. A pílula da barra de cima te traz de volta. Aperte Parar para terminar antes.

Ele para quando os seus créditos acabam. O que ele consertou continua consertado.

Peça para o ORBIE conferir de novo

Alguns problemas dependem do que o resto do script faz. Quando a lista tem algum desses, uma caixa oferece Deixe o ORBIE conferir estes.

  1. 1

    Aperte Revisar

    O ORBIE lê o código em volta de cada um desses problemas (até 20). Esse pedaço de cada arquivo é enviado para a gente. Custa 1 crédito por padrão, que aparece na caixa.

  2. 2

    Veja o que mudou

    Os que no fim estão certos saem da lista e a nota é recalculada. Uma linha diz quantos foram descartados.

Baixe ou compartilhe o relatório

A seção Relatório tem três coisas:

  • Baixar o relatório em PDF: um PDF com a marca, a nota e todos os problemas, feito no seu navegador.
  • Compartilhar: publica um link público em /report/<code> e copia ele. Você precisa estar logado. A página pública só mostra a nota, quantos problemas de cada urgência, o framework e os tipos de problema, nunca nomes de arquivo, linhas ou código. Depois de publicado, o botão vira Copiar o link de novo.
  • O que o ORBIE mudou: cada conserto aplicado, com as linhas que ele mexeu.

Procurar trapaceiros, na barra, manda o mesmo envio para o Vulnerability Scanner, para você não precisar soltar tudo de novo.

O que você baixa

Depois de aplicar os consertos, aperte Arquivos corrigidos no painel. Você recebe <nome>-fixed.zip com:

  • Só os arquivos que o ORBIE mudou, cada um no mesmo caminho que tinha no seu envio. Os arquivos que ninguém mexeu não vão no zip.
  • ORBIE-CHANGES.md: cada conserto aplicado, o arquivo, as linhas e o que mudou.

O relatório em PDF é baixado como <nome>-performance-report.pdf.

Instalar no seu servidor

  1. 1

    Faça backup do resource

    Copie a pasta do resource para algum lugar fora de resources/.

  2. 2

    Copie os arquivos consertados por cima dos originais

    Descompacte o download. Cada arquivo está no mesmo caminho que tinha no seu envio, então copie para o mesmo lugar dentro do seu resource, substituindo o antigo.

  3. 3

    Teste primeiro num servidor de teste

    Reinicie o servidor, ou digite ensure seguido do nome do resource no console. Use o script no jogo e olhe o resmon para ver a diferença.

Guarde o seu backup até ter jogado um tempo com a mudança. Se alguma coisa se comportar estranho, coloque o arquivo original de volta.

Problemas comuns

O relatório continua igual depois que eu mudei os scripts.

Você está vendo o escaneamento guardado de antes. Na seção Escanear, use Reanalisar a versão nova e escolha os arquivos novos, ou Nova varredura para começar do zero.

Conserta isso, ORBIE abre a janela de planos.

Esse problema precisa de um conserto profundo, e no plano Free você já usou o seu grátis. Veja os preços.

Diz que eu estou sem créditos.

Pegue mais créditos ou faça upgrade do plano. O escaneamento continua grátis.

O ORBIE respondeu, mas não tem o botão Usar esta correção.

O ORBIE não teve certeza suficiente para te entregar o arquivo. Use a explicação dele e O que precisa mudar para consertar à mão, ou passe para um desenvolvedor.

Diz que já tentou este duas vezes.

Uma terceira tentativa não vai sair diferente. Use a explicação para consertar à mão.

Parece que o meu envio grande está sem alguns scripts.

A leitura para perto de 25 MB de código ou 4.000 arquivos. Escaneie menos resources por vez.

Perguntas frequentes

O meu código é enviado?

Não para escanear. Um arquivo só é enviado para o nosso servidor quando você pede para o ORBIE consertar ou conferir de novo, e o código não fica guardado.

Nota alta quer dizer que o meu servidor não vai travar?

Quer dizer que nenhum dos padrões conhecidos de lag foi encontrado no que você escaneou. O lag também pode vir de scripts que você não enviou, da máquina que hospeda o servidor ou de assets em streaming.

O ORBIE muda os meus arquivos?

Nunca no seu disco. A cópia consertada fica no seu navegador até você baixar, e quem troca os arquivos é você.

Dá para escanear o servidor inteiro de uma vez?

Dá, solte a pasta resources/ inteira ou um .zip dela, até uns 25 MB de código.

Dá para provar para alguém que o meu script está limpo?

Compartilhe o relatório: o link público mostra a nota e as contagens sem expor nada do seu código.

Conferido com a ferramenta em 15 de novembro de 2026.

Experimente o Otimizador de scripts agora

Um resource comendo ms no resmon? Cole o script e veja as linhas exatas que estão travando o seu servidor, com a correção de cada uma.

Mais guias de Scripts