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
.zipcom os seus resources, uma pasta inteira (até a sua pastaresources/completa) ou arquivos.luae.jssoltos. - 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
Abra o Script Optimizer
Entre no Script Optimizer.
- 2
Solte os seus resources
Arraste um
.zip, uma pasta ou arquivos.luae.jspara 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
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:
| Nota | O que ela diz |
|---|---|
| 85 a 100 | O seu servidor deve aguentar bem |
| 60 a 84 | Algumas coisas vão te morder quando crescer |
| 35 a 59 | Isto vai travar quando o seu servidor encher |
| Abaixo de 35 | Os 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
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
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
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
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
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
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
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
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
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
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
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
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
Faça backup do resource
Copie a pasta do resource para algum lugar fora de
resources/. - 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
Teste primeiro num servidor de teste
Reinicie o servidor, ou digite
ensureseguido do nome do resource no console. Use o script no jogo e olhe oresmonpara 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
- Ponte de scriptsESX, QBCore, Qbox, standalone: converta um script de um para outro.
- Tradutor de resourcesTraduza para qualquer idioma um resource que você comprou.
- Reparador de servidoresCole o console. Descubra o que quebrou e o que fazer.
- Escâner de vulnerabilidadesOs buracos que os trapaceiros usam de verdade, achados antes deles.
