Resolva e volte para o seu servidor.
Soluções passo a passo para os erros mais comuns em servidores FiveM: ESX, QBCore, QBox, oxmysql e mais. Testadas, com o código pronto para copiar.
Erros e soluções
Could not find dependency X for resource Y: como corrigirFiveM diz Could not find dependency ox_lib for resource Y? O que dependency em fxmanifest.lua significa, como instalar o recurso faltando, nomes de pasta e ordem de início.
Couldn't start resource: por que FiveM não vai iniciar seu scriptCouldn't start resource X ou Failed to start resource em seu console FiveM? As causas usuais (manifesto, nome da pasta, erro Lua, dependência, escrow) e como encontrar a sua.
Você não tem o direito necessário para usar um recurso: correção de escrowScript FiveM em escrow diz que você não tem o direito necessário ou não conseguiu verificar? Combine a chave de licença do seu servidor com a conta Cfx.re que possui o ativo.
ESX é nil: corrigindo esx:getSharedObject em ESX Legacyattempt to index a nil value (global 'ESX')? O antigo evento esx:getSharedObject desapareceu de ESX Legacy. Aqui está a correção de uma linha e o que fazer com scripts que você não pode editar.
tentativa de indexar um valor nil (local 'xPlayer'): correção ESXxPlayer é nil em seu script ESX? Por que ESX.GetPlayerFromId(source) retorna nil: jogador não carregado, source perdido após Wait, ids de string, playerDropped. Com padrões de proteção.
Erro FiveM json.decode: correções para nil, string vazia e JSON inválidojson.decode falha ou retorna nil em seu script FiveM? Por que decodificar nil, JSON vazio ou editado manualmente quebra, o que json.encode faz com chaves mistas, e como usar pcall com segurança.tentar chamar um valor nulo (campo, global, método): como corrigir · tentar comparar número com nil / aritmética em um valor nil: corrigir · argumento inválido #1 para 'X' (número esperado, recebido nil): correção FiveM Lua · Erro de sintaxe Lua: símbolo inesperado perto, 'end' esperado (FiveM) · índice de tabela é nil / índice um valor nil (campo): correção FiveM Lua · No such export getSharedObject in resource es_extended: a correção · No such export X in resource Y: como corrigir no FiveM · @ox_lib/init.lua não encontrado e erros ox_lib: como corrigir · oxmysql não consegue conectar: ECONNREFUSED, access denied, unknown database · attempt to index a nil value (global 'QBCore'): a correção GetCoreObject · attempt to index a nil value (local 'Player'): QBCore e QBox fix · Como ler um FiveM SCRIPT ERROR: arquivo, linha e stack trace · Reliable network event overflow em FiveM: encontre o script e conserte · FiveM sv_licenseKey: correção do erro 'no license key was specified' · aviso de hitch do thread do servidor: intervalo de timer de X milissegundos, correção · Tabela 'db.x' não existe e coluna desconhecida: importe o arquivo SQL
Configurar o servidor
Como fazer backup de um servidor FiveM: banco de dados, recursos e txDataFaça backup do seu servidor FiveM: mysqldump ou HeidiSQL para o banco de dados, recursos, server.cfg e txData, backups agendados, cópias fora do servidor e como restaurar.
Como configurar um servidor FiveM no Linux: artifacts, systemd e ufwExecute um servidor FiveM no Ubuntu ou Debian: baixe o artifact, extraia-o, inicie run.sh com txAdmin ou server.cfg, mantenha-o vivo com screen ou systemd, abra portas com ufw.
Git de servidor FiveM: o que fazer commit, .gitignore e deploys com git pullColoque seu servidor FiveM sob git da forma segura: o que fazer commit, um .gitignore para cache e txData, mantendo chaves fora com uma secrets.cfg, repos privados e deploys com git pull.
Requisitos de hospedagem de servidor FiveM: CPU, RAM, disco e redeO que alugar para um servidor FiveM: por que velocidade de CPU de single-thread importa mais, RAM por contagem de jogadores, NVMe, proteção DDoS, Windows ou Linux, localização e tipos de hospedagem.
Servidor FiveM não aparecendo ou jogadores não conseguem conectar: correção da porta 30120Seu servidor FiveM não está na lista, ou jogadores sofrem timeout ao conectar. Abra porta 30120 para TCP e UDP no firewall e roteador, e teste com F8 connect.
Como ativar OneSync e aumentar o limite de jogadores FiveM acima de 32Seu servidor FiveM não vai passar de 32 jogadores, ou sv_maxclients é ignorado. Como ativar OneSync em server.cfg ou txAdmin, definir sv_maxclients e verificar se funciona.pma-voice não funciona: jogadores não conseguem se ouvir em FiveM · FiveM resmon high ms: como encontrar e corrigir scripts lentos · server.cfg explicado: cada linha do FiveM server.cfg, uma por uma · Ordem ensure do server.cfg: a ordem correta de início de recursos para FiveM · Ícone do servidor FiveM, banner, tags e cores: melhore sua listagem · Carros, roupas ou mapas DLC do FiveM desaparecendo? Defina sv_enforceGameBuild · txAdmin esqueceu a senha: redefina a conta master e retorne · Configuração do txAdmin e receitas: implemente um servidor FiveM passo a passo · Reinicializações agendadas do txAdmin: defina uma reinicialização diária com avisos · Artefatos de servidor FiveM desatualizados: como atualizar FXServer com segurança
ESX, QBCore e QBox
Converter um script ESX para QBCore (e voltar): mapa de funções e bridgePorte um script FiveM entre ESX e QBCore: uma tabela das chamadas comuns (jogador, dinheiro, job, itens, notificações, callbacks) e um arquivo bridge que suporta ambos.
Converter um script QBCore para QBox: qbx_core, ox_inventory, ox_targetComo portar um script QBCore para QBox: a camada de compatibilidade qbx_core, GetPlayer, itens ox_inventory, ox_lib notify e progress, ox_target, e o que geralmente quebra.
Como adicionar um emprego no ESX Legacy: jobs e job_grades SQL, setjobAdicione um emprego personalizado ao ESX Legacy com dois inserts SQL em jobs e job_grades, defina-o com /setjob, leia-o em scripts com xPlayer.job e vincule-o a uma conta de sociedade.
Tipos de dinheiro em FiveM: cash, bank e black money em ESX, QBCore e QBoxComo funciona o dinheiro em FiveM: contas ESX (money, bank, black_money), cash, bank e crypto de QBCore, cash de ox_inventory como um item, e reason strings para seus logs.
Como instalar ESX Legacy em um servidor FiveM: receita e manualInstale ESX Legacy com uma receita txAdmin ou manualmente: es_extended, recursos principais, oxmysql, importação SQL, ordem server.cfg, verificações de primeiro login e os primeiros erros.
Como instalar um servidor QBCore: receita txAdmin e passos manuaisInstale QBCore no FiveM com a receita txAdmin ou manualmente: qb-core, os recursos qb, oxmysql, importação SQL, server.cfg, verificações iniciais e os erros de primeira mais comuns.Como instalar um servidor QBox: receita, pilha e primeiros erros · Migrar ESX para QBox: o que transfere, o que quebra e um checklist · Como adicionar um job em QBCore: shared/jobs.lua, grades e /setjob · Server callback retorna nil: ESX, QBCore e callbacks ox_lib
Inventário e itens
Itens ESX: a tabela items, RegisterUsableItem e addInventoryItemAdicione um item ao ESX: a tabela SQL items, ESX.RegisterUsableItem para torná-lo utilizável, addInventoryItem, removeInventoryItem, getInventoryItem e canCarryItem, mais a nota sobre ox_inventory.
Sistema de artesanato FiveM: benches ox_inventory e artesanato personalizadoConstrua artesanato no FiveM: benches de artesanato ox_inventory em data/crafting.lua com ingredientes e zonas, uma receita verificada pelo servidor personalizada e dicas anti-dupe.
Como adicionar itens a ox_inventory: items.lua, imagens e itens usáveisAdicione um item personalizado a ox_inventory: a entrada data/items.lua, a imagem em web/images, dando-o com AddItem e tornando-o usável com uma exportação do cliente.
Metadados de item ox_inventory: AddItem, Search, SetMetadata e itens únicosUse metadados em ox_inventory: adicione itens com dados, procure e leia slots, atualize com SetMetadata, mostre um rótulo e descrição personalizados e crie itens únicos como IDs e chaves.
Lojas ox_inventory: data/shops.lua, RegisterShop e blipsComo criar uma loja em ox_inventory: a entrada data/shops.lua, preços e moeda, localizações e alvos, lojas bloqueadas por emprego, RegisterShop de outro recurso e blips.
Estojos ox_inventory: RegisterStash, openInventory e estojos de trabalhoComo criar estojos em ox_inventory: registre um no servidor, abra-o do cliente ou ox_target, torne-o pessoal por jogador ou bloqueie para um trabalho.Armas e munição ox_inventory: data/weapons.lua e armas desaparecendo · Como adicionar items em QBCore: items.lua, imagens, CreateUseableItem · QBCore items usáveis: CreateUseableItem, AddItem e RemoveItem
Veículos
Como adicionar carros addon a um servidor FiveM: stream e data filesAdicione carros addon ao FiveM passo a passo: a pasta stream, vehicles.meta, carvariations.meta, carcols.meta, handling.meta, linhas data_file no fxmanifest, addon vs replace.
Adicionar carros à loja de veículos do FiveM (tabela de veículos ESX, QBCore, QBox)Como adicionar um carro a uma concessionária: as tabelas ESX vehicles e vehicle_categories, entradas shared vehicles.lua do QBCore e QBox, e por que um carro aparece sem preço.
Editar handling.meta em FiveM: velocidade, grip, freios e HANDLING_FILEEdite um handling.meta de carro em FiveM: campos chave (fInitialDriveForce, fBrakeForce, fTractionCurveMax, fMass), HANDLING_FILE, correspondência de handlingName, testando e runtime.
Garagem FiveM: owned_vehicles e player_vehicles, carros faltando corrigidoVeículos faltando da garagem? Como as tabelas ESX owned_vehicles e QBCore player_vehicles funcionam, as colunas armazenadas e de estado, e o SQL para consertar carros presos lá fora.
Combustível de veículos FiveM: definir combustível ao desova e corrigir carros presos em 0Como funciona o combustível no FiveM: GetVehicleFuelLevel e SetVehicleFuelLevel, combustível em sacolas de estado, definindo combustível quando você desova um carro, e por que os veículos começam com um tanque vazio.
Chaves de veículos FiveM: não consegue dirigir seu próprio carro ou trancá-lo? CorrijaComo sistemas de chaves de veículos FiveM funcionam: listas de placas, dando chaves após um desova ou compra, travando com SetVehicleDoorsLocked, e por que você perde acesso ao seu próprio carro.Spawnar um veículo no FiveM: CreateVehicle vs CreateVehicleServerSetter · Dano de veículo FiveM: saúde do motor, saúde da carroceria e ajustes de handling · Obter e definir propriedades de veículos no FiveM: lib, ESX e QBCore · Veículos FiveM desaparecendo ou despawnando: por que acontece e a correção
Empregos e gameplay
Design de sistema de drogas FiveM: colheita, processamento e venda seguraComo projetar um sistema de drogas FiveM: colheita e processamento com verificações de itens do lado do servidor, limites de taxa, venda para NPCs com segurança, alertas de polícia e balanceamento de pagamentos.
Sistema de morte e reviver FiveM: último suspiro, respawn e bolsas de estadoComo um sistema de morte FiveM funciona: último suspiro vs morte, timer de respawn, reviver de admin ou EMS, sincronizando o estado morto com bolsas de estado e corrigindo log de combate.
Habitação e apartamentos em FiveM: shells, instâncias, estoques e chavesComo funciona um sistema de habitação em FiveM: interiores shell e MLO, instanciação com routing buckets, um estoque por casa, chaves e permissões, e salvamento de propriedade no banco de dados.
Mechanic job em FiveM: natives de reparo, mods de tuning e verificações de trabalhoConstrua um mechanic job em FiveM: repare um veículo com SetVehicleFixed e natives de saúde, sintonize com SetVehicleModKit e SetVehicleMod, salve mods, e controle actions por trabalho.
Configuração de police job em FiveM: graus, duty, armory e contagem de políciaComo configurar um police job em um servidor FiveM: job e graus, toggle de duty, armory com shop e stash, algema e escolta, verificações de contagem de polícia, MDT e dispatch.
Scripts de roubo de loja e banco em FiveM: configuração e design lado do servidorComo configurar e projetar roubos de loja e banco em FiveM: contagem de polícia, cooldowns lado do servidor, recompensas dadas apenas pelo servidor, alertas de polícia e verificações de distância.Equilíbrio da economia do servidor FiveM: salários, sumidouros de dinheiro e inflação
Menus, target e interface
Como criar blips no mapa em FiveM: AddBlipForCoord e radius blipsCrie blips em FiveM com AddBlipForCoord: sprite, cor, escala, short range, um rótulo de nome, radius blips com AddBlipForRadius, removendo blips e blips apenas para jobs.
DrawMarker, help text e lib.showTextUI sem lag em FiveMDesenhe markers e mostre prompts 'Press E' em FiveM sem um loop pesado: DrawMarker apenas quando próximo, nativos de help text, lib.showTextUI e pontos ox_lib para zonas.
Animações e props do FiveM: flags TaskPlayAnim, anexar a osso, deletarReproduza animações e anexe props no Lua do FiveM: RequestAnimDict, flags TaskPlayAnim 1, 16, 32 e 49, ClearPedTasks, AttachEntityToEntity para um osso, cenários e limpeza.
FiveM NUI com React e Vite: setup, callbacks e desenvolvimento no navegadorConstrua uma NUI FiveM com React e Vite: ui_page e files em fxmanifest, base './', SendNUIMessage, RegisterNUICallback, SetNuiFocus e desenvolvendo no navegador.
Notificações e barras de progresso FiveM: ESX, QBCore e ox_libEnvie notificações e mostre barras de progresso no ESX, QBCore e ox_lib com ShowNotification, Functions.Notify, lib.notify e lib.progressBar, mais uma função ponte.
Depurar FiveM NUI: nui_devtools, erros de console e retornos de chamada falhadosDepure uma FiveM NUI: abra as ferramentas de desenvolvedor Chromium com nui_devtools, leia erros Uncaught TypeError, corrija uma busca falhada para https://resource/cb e teste a UI em um navegador.Cursor FiveM preso ou não pode se mover após fechar um menu: correção de foco NUI · Menu de contexto ox_lib: registerContext, inputDialog e alertDialog · Zonas ox_lib: lib.zones.box, sphere e poly com onEnter e onExit · ox_target addBoxZone, addModel e addLocalEntity: como adicionar alvos · Reproduzir sons customizados em FiveM: NUI audio, volume pela distância, formatos · qb-target vs ox_target: converter AddBoxZone e corrigir targets não aparecendo · RegisterCommand e RegisterKeyMapping: keys rebindáveis em FiveM
Programação
escrow_ignore no fxmanifest: mantenha config.lua e locales abertosPara vendedores de scripts: como escrow_ignore mantém config.lua e arquivos de localização legíveis, o que permanece aberto, como fazer upload para o portal Cfx.re e testar a compilação em escrow.
Eventos FiveM: RegisterNetEvent, TriggerServerEvent, TriggerClientEventComo funcionam os eventos de cliente e servidor do FiveM: RegisterNetEvent, AddEventHandler, TriggerServerEvent, TriggerClientEvent com -1, a variável source e nomeação de eventos.
Exports FiveM em Lua: exports('name', fn) e 'No such export'Como definir e chamar exports no FiveM Lua, os estilos de exports de fxmanifest e server_exports, e como corrigir erros 'No such export' causados por ordem de inicialização ou lado errado.
Armazenamento KVP em FiveM: guia de SetResourceKvp e GetResourceKvpStringSalve configurações de cliente sem banco de dados usando KVP de FiveM: SetResourceKvp, GetResourceKvpString, SetResourceKvpInt, DeleteResourceKvp, json.encode para tabelas, e seus limites.
Routing buckets em FiveM: SetPlayerRoutingBucket, instâncias e vozComo os routing buckets em FiveM funcionam: SetPlayerRoutingBucket, SetEntityRoutingBucket, configurações de população e lockdown, bucket 0, casos de uso e o que acontece com a voz.
Locales de script em FiveM: scripts traduzíveis com en.lua, ox_lib e ESXTorne seu script FiveM traduzível: uma pasta locales com en.lua e es.lua, uma função locale simples, sistema de locale de ox_lib, ESX TranslateCap e uma configuração de idioma.Sacolas de estado FiveM: Entity(entity).state, GlobalState e handlers · FiveM CreateThread e Wait(0) explicados: por que seu script custa ms · Recursos TypeScript do FiveM: fxmanifest, tipos @citizenfx e esbuild · Configuração VS Code FiveM: servidor de linguagem Lua, natives, sem avisos falsos · __resource.lua para fxmanifest.lua: como converter um script antigo · Guia de consultas oxmysql: MySQL.query.await, single, scalar, insert · Como vender scripts FiveM: Tebex, Cfx.re escrow, packaging e support
Mapas e streaming
Como adicionar peds addon ao FiveM: arquivos stream, peds.meta, nome de spawnAdicione peds addon a um servidor FiveM: os arquivos stream (ydd, yft, ytd, ymt), peds.meta com PED_METADATA_FILE, spawning por nome de modelo e definindo um ped como modelo do jogador.
Adicionar roupas EUP e addon ao FiveM: stream, meta, correçõesInstale pacotes de roupas addon (estilo EUP) no FiveM: arquivos stream, ymt e meta, addon vs replace, game build, e por que roupas ficam invisíveis ou trocam outros itens.
Tela de carregamento personalizada para FiveM: loadscreen, fxmanifest e shutdownFaça uma tela de carregamento FiveM personalizada: loadscreen de fxmanifest e arquivos, loadscreen_manual_shutdown com ShutdownLoadingScreenNui, dicas de tamanho de música e vídeo, apenas uma tela de carregamento.
Desabilitar ou reduzir tráfego NPC e peds em FiveM: density nativesDesligue ou reduza NPCs, tráfego e carros estacionados em FiveM com os nativos do multiplicador de densidade, a regra por frame, routing buckets, removendo policiais e o custo de cada opção.
Caindo através do mapa no FiveM: colisões não carregando, como corrigirJogadores caem através do mapa ao spawnar ou teletransportar? Corrija colisões tardias: arquivos .ybn faltando, streaming demais, RequestCollisionAtCoord e HasCollisionLoadedAroundEntity.
Como instalar um MLO em um servidor FiveM: stream, fxmanifest, ensureInstale um MLO ou mapa no FiveM: a pasta stream, fxmanifest.lua com this_is_a_map, a linha data_file ytyp, ensure, compilação de jogo e como testá-lo no jogo.Conflitos de mapas MLO no FiveM: paredes ausentes, tremulação, props duplicados · Ativos aumentados podem e VÃO causar problemas de streaming: a correção
Jogo e cliente
Como limpar o cache do FiveM: quais pastas deletar (e quais não)Problemas de textura, arquivos antigos transmitidos, ou crashes após uma atualização? Como limpar o cache do cliente FiveM: a pasta data, cache, server-cache, server-cache-priv, e o que manter.
ERR_GFX_D3D_INIT no FiveM e GTA V: como corrigir a falha de DirectXERR_GFX_D3D_INIT fecha FiveM na inicialização? Atualize os drivers da GPU, altere a versão do DirectX, desfaça overclocks, redefina settings.xml e teste o modo janelado, passo a passo.
Conexão FiveM expirou / Falha ao obter informações do servidor: como corrigirConexão servidor->cliente expirou ou Falha ao obter informações do servidor após 3 tentativas? Verifique o servidor, porta, firewall, VPN, DNS e travamentos. Correções para jogadores e proprietários.
FiveM trava na inicialização: correções e como compartilhar o relatório de falhaFiveM trava quando você o inicia ou se conecta? Limpe o cache, verifique GTA V, desative overlays, adicione exclusões de antivírus, atualize drivers e compartilhe o dump de falha.
Verificar arquivos de jogo GTA V para FiveM: Steam, Epic e Rockstar launcherFiveM se recusa a iniciar ou trava em arquivos de jogo modificados? Verifique GTA V no Steam, Epic Games e no Rockstar launcher e mantenha sua pasta GTA livre de mods antigos.
Correção de FPS baixo em FiveM: configurações, orçamento de texturas e causas lado do servidorFPS baixo em servidores FiveM mas bem em modo single player? Corrija com configurações de gráficos, Orçamento de Texturas Estendido, configurações de GPU, aplicativos em segundo plano, e causas lado do servidor.FiveM não abre ou trava no lançamento: como corrigir no Windows · Servidor FiveM requer Steam: corrigir o identificador do Steam ausente · FiveM preso na tela de carregamento: causas e como debugar
Segurança e administração
Como se tornar administrador no FiveM: add_ace, add_principal, group.adminNão é administrador no seu próprio servidor FiveM? Adicione-se com add_ace e add_principal, encontre sua license, identificador fivem ou discord, e defina o grupo admin do ESX ou QBCore.
Logs de webhook Discord de um servidor FiveM: guia PerformHttpRequestEnvie logs para Discord do FiveM com PerformHttpRequest e embeds JSON. Apenas lado do servidor, URL em uma convar, uma fila para rate limits, e o que registrar.
Discord whitelist para FiveM: permitir jogadores por role DiscordConstrua uma whitelist de role Discord para seu servidor FiveM: playerConnecting com deferrals, o identificador Discord, uma verificação de role de bot através da API REST, e um token seguro.
Noções básicas de anticheat do FiveM: o que fazer e o que nenhum anticheat pode fazerNoções básicas de anticheat para FiveM: validar no servidor primeiro, limites de entidade OneSync, cancelar explosões, logs de webhook do Discord, bans do txAdmin e o que nenhum anticheat pode fazer.
FiveM playerConnecting e deferrals: defer, update, done explicadosComo AddEventHandler('playerConnecting') funciona com deferrals: defer, Wait(0), update, done(reason), adaptive cards, e por que os jogadores travam quando você esquece de chamar done.
FiveM server events seguros: pare cheaters de abusarem net eventsCheaters disparam seus server events com qualquer valores. Como validar no server: use source, verifique distância, job e cooldowns, e mantenha preços em uma tabela de server.txAdmin: como avisar, expulsar e banir jogadores (e revogar um banimento)