Scripts FiveM são o motor de gameplay por trás de todo servidor de roleplay. Eles transformam uma instância multiplayer nua de GTA V em um mundo vivo com empregos, economia, aplicação da lei, sistemas médicos e recursos sociais. Enquanto mods lidam com ativos visuais, scripts lidam com a lógica — o que acontece quando um jogador abre uma conta bancária, é preso, inicia um laboratório de drogas ou liga para o 911. A qualidade dos seus scripts determina diretamente quão profunda e envolvente é a experiência de roleplay do seu servidor.
O que São Scripts FiveM?
Scripts FiveM são recursos baseados em Lua (às vezes JavaScript ou C#) que rodam no servidor e/ou cliente FiveM para adicionar lógica personalizada de jogo. Cada script consiste em código do lado do servidor (executado no seu VPS, lidando com operações de banco de dados, verificações de autoridade e estado do jogo), código do lado do cliente (executado no PC de cada jogador, lidando com renderização de UI, detecção de entrada e efeitos locais) e código compartilhado (utilitários acessíveis de ambos os lados). Scripts se comunicam entre cliente e servidor usando o sistema de eventos do FiveM — TriggerServerEvent e TriggerClientEvent. Entender esta arquitetura cliente-servidor é essencial para escolher scripts compatíveis e depurar problemas.
Lua: A Linguagem do FiveM
Lua é uma linguagem de script leve e embutível originalmente projetada para desenvolvimento de jogos. É a linguagem principal de scripting FiveM, alimentando mais de 95% de todos os recursos de servidores. A simplicidade do Lua o torna acessível para iniciantes — você pode modificar o config.lua de um script sem experiência em programação — enquanto sua flexibilidade suporta sistemas complexos como plataformas MDT completas e frameworks de telefone. O FiveM estende o Lua com sua API de Natives, fornecendo mais de 3.000 funções para interagir com o motor GTA V: spawnar veículos, teleportar jogadores, disparar animações, modificar clima e controlar cada aspecto do mundo do jogo. Frameworks como QBCore e ESX adicionam outra camada, fornecendo funções padronizadas para gerenciamento de inventário, sistemas de emprego e persistência de dados de jogadores.
Entendendo Frameworks FiveM
Um framework é a camada base do seu servidor — ele fornece os sistemas principais dos quais todos os outros scripts dependem. Escolher um framework é a decisão mais importante que você tomará porque determina quais scripts são compatíveis com seu servidor. QBCore (framework dominante de 2024-2026) usa uma arquitetura moderna orientada a eventos com excelente desempenho. Ele fornece inventário embutido, gerenciamento de empregos, sistemas de gangues e uma API padronizada sobre a qual desenvolvedores de scripts constroem. ESX Legacy (framework mais antigo em atividade) tem o maior ecossistema de scripts — se um tipo de script existe, provavelmente há uma versão ESX. Usa uma arquitetura mais tradicional com operações pesadas de MySQL. QBOX é o mais novo concorrente, fork do QBCore com otimizações de desempenho e padrões modernos de código mantendo compatibilidade retroativa com a maioria dos scripts QBCore.
Arquitetura de Scripts: Cliente vs. Servidor
Entender a divisão cliente-servidor é crítico para o desempenho do servidor. Código do lado do servidor roda uma vez no seu VPS independente da contagem de jogadores — consultas de banco de dados, verificações de autoridade e gerenciamento de estado do jogo acontecem aqui. Código do lado do cliente roda no PC de cada jogador conectado — renderização de UI, manipulação de entrada e efeitos visuais executam localmente. Um erro comum é rodar computações pesadas no lado do cliente em cada frame (usando Citizen.CreateThread com 0ms de espera). Isso mata o FPS do jogador. Scripts bem escritos usam padrões orientados a eventos: escutam gatilhos específicos ao invés de verificar condições constantemente. Ao avaliar scripts, verifique o impacto no resmon (monitor de recursos): qualquer coisa acima de 0.5ms no lado do servidor sob carga merece investigação. Os melhores scripts rodam a 0.01-0.05ms em idle.
Otimizando Sua Stack de Scripts
A maioria dos servidores FiveM roda 100-200 scripts simultaneamente. Sem gerenciamento cuidadoso, conflitos de scripts e inchaço de desempenho podem degradar a experiência do jogador. Comece com estes princípios de otimização: Primeiro, consolide funcionalidades sobrepostas — rodar dois scripts de inventário separados ou três sistemas de notificação desperdiça recursos e cria conflitos. Escolha uma solução por funcionalidade. Segundo, audite o monitor de recursos regularmente — use o resmon do txAdmin para identificar scripts consumindo tempo excessivo de CPU, depois trabalhe com criadores para otimizar ou substituí-los. Terceiro, gerencie sua ordem de ensure — scripts carregam na ordem listada no server.cfg. O core do framework deve carregar primeiro, depois bibliotecas de dependência, depois scripts de funcionalidades. Ordem de carregamento incorreta causa erros de variáveis indefinidas e falhas silenciosas. Quarto, use pooling de conexão de banco de dados — cada script acessando MySQL cria conexões. Usar oxmysql com pooling adequado previne esgotamento de conexões sob carga pesada.
Segurança de Scripts: Protegendo Seu Servidor
Segurança de scripts é o aspecto mais negligenciado do gerenciamento de servidores FiveM. Um único script com backdoor pode comprometer todo o seu servidor — concedendo acesso admin a atacantes, vazando seu banco de dados (incluindo IPs de jogadores e tokens Discord) ou injetando código que rouba itens e dinheiro dos jogadores. Sinais de alerta incluem: código Lua ofuscado (criadores legítimos raramente ofuscam), scripts que se conectam a APIs externas sem razão clara, e recursos que solicitam permissões desnecessárias. Sempre baixe de marketplaces verificados como a VertexMods que realizam auditorias de segurança em cada envio. Antes de instalar qualquer script, revise seu código — especialmente arquivos do lado do servidor — para padrões suspeitos como strings codificadas em base64, requisições HTTP externas para domínios desconhecidos ou execução dinâmica de código via load() ou loadstring().
