Como Configurar Scripts FiveM pelo Arquivo config.lua

Aprenda a personalizar os scripts FiveM editando o arquivo config.lua — opções gerais, integrações com frameworks e ajustes de comportamento.

Todos os scripts FiveM são configurados através do arquivo config.lua, localizado na raiz do recurso. Este arquivo centraliza todas as opções disponíveis para personalizar o comportamento do script sem precisar alterar o código-fonte.

Estrutura do config.lua

O arquivo de configuração utiliza uma tabela Lua chamada Config. Cada script possui suas próprias opções, mas todas seguem o mesmo padrão:

config.lua

Config = {}

-- Configurações gerais
Config.Debug = false            -- Ativa logs detalhados no console
Config.Locale = 'pt-BR'        -- Idioma das mensagens
Config.Framework = 'auto'      -- 'auto', 'esx' ou 'qbcore'

-- Configurações específicas do script
Config.MaxPlayers = 32
Config.EnableNotifications = true
Config.NotificationPosition = 'top-right' -- 'top-right', 'top-left', 'bottom-right', 'bottom-left'

Opções Comuns

Estas opções estão presentes na maioria dos scripts:

Opção	Tipo	Padrão	Descrição
Config.Debug	boolean	false	Ativa mensagens de debug no console
Config.Locale	string	'pt-BR'	Idioma das mensagens exibidas
Config.Framework	string	'auto'	Framework utilizado ('auto', 'esx', 'qbcore')
Config.UseTarget	boolean	false	Ativa sistema de target (ox_target/qb-target)
Config.UseOxLib	boolean	false	Usa ox_lib para notificações e menus

Seleção de Framework

O parâmetro Config.Framework controla qual framework é utilizado:

Automático (recomendado)

Com Config.Framework = 'auto', o script detecta automaticamente o framework ativo no servidor:

config.lua

Config.Framework = 'auto'

ESX

Para forçar o uso do ESX:

config.lua

Config.Framework = 'esx'

QBCore

Para forçar o uso do QBCore:

config.lua

Config.Framework = 'qbcore'

Salvando as Configurações

Após editar o config.lua:

1. Salve o arquivo
2. No console do servidor, execute:

restart nome-do-script

Nunca edite arquivos diferentes do config.lua (como client/main.lua ou server/main.lua) a menos que você saiba o que está fazendo — alterações no código-fonte podem quebrar o script e invalidar o suporte.

Localizações (Locales)

Alguns scripts suportam múltiplos idiomas através de arquivos de localização na pasta locales/. Para usar um idioma diferente:

config.lua

Config.Locale = 'en'  -- Usa o arquivo locales/en.lua

Se o idioma desejado não estiver disponível, você pode criar um novo arquivo de locale copiando locales/pt-BR.lua e traduzindo as strings.