> ## Documentation Index
> Fetch the complete documentation index at: https://docs.temacstore.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 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:

```lua config.lua theme={null}
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:

<Tabs>
  <Tab title="Automático (recomendado)">
    Com `Config.Framework = 'auto'`, o script detecta automaticamente o framework ativo no servidor:

    ```lua config.lua theme={null}
    Config.Framework = 'auto'
    ```
  </Tab>

  <Tab title="ESX">
    Para forçar o uso do ESX:

    ```lua config.lua theme={null}
    Config.Framework = 'esx'
    ```
  </Tab>

  <Tab title="QBCore">
    Para forçar o uso do QBCore:

    ```lua config.lua theme={null}
    Config.Framework = 'qbcore'
    ```
  </Tab>
</Tabs>

## Salvando as Configurações

Após editar o `config.lua`:

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

```bash theme={null}
restart nome-do-script
```

<Warning>
  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.
</Warning>

## Localizações (Locales)

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

```lua config.lua theme={null}
Config.Locale = 'en'  -- Usa o arquivo locales/en.lua
```

<Tip>
  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.
</Tip>