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

# Primeiros Passos: Instalação e Configuração de Scripts FiveM

> Configure seu servidor FiveM do zero com nossos scripts — do download ao primeiro teste, com dicas para evitar os erros mais comuns.

Este guia é para quem está usando nossos scripts pela primeira vez. Em poucos minutos você terá o ambiente configurado, o script rodando no servidor e entenderá o fluxo básico para adicionar novos recursos no futuro.

## O que você vai precisar

Antes de começar, tenha em mãos:

* Um servidor FiveM ativo com acesso root ou painel de hospedagem
* Framework instalado (ESX 1.9+ ou QBCore)
* Banco de dados MySQL com oxmysql configurado
* O arquivo do script (obtido após a compra ou download)

## Configuração Inicial

<Steps>
  <Step title="Organize a pasta resources">
    Crie uma pasta de organização dentro de `resources` para manter seus scripts separados dos recursos padrão:

    ```
    resources/
    ├── [system]/          # Recursos do FiveM
    ├── [framework]/       # ESX ou QBCore
    └── [meus-scripts]/    # Seus scripts aqui
        └── meu-script/
    ```
  </Step>

  <Step title="Instale o script">
    Copie a pasta do script para `resources/[meus-scripts]/`. Confirme que a estrutura contém pelo menos o `fxmanifest.lua`:

    ```bash theme={null}
    ls resources/meu-script/
    # fxmanifest.lua  config.lua  client/  server/  html/
    ```
  </Step>

  <Step title="Configure antes de iniciar">
    Abra o `config.lua` e ajuste pelo menos as configurações essenciais antes de iniciar o script pela primeira vez:

    ```lua config.lua theme={null}
    Config.Framework = 'auto'   -- Detecta ESX ou QBCore automaticamente
    Config.Debug = true         -- Ative durante os testes iniciais
    Config.Locale = 'pt-BR'
    ```
  </Step>

  <Step title="Adicione ao server.cfg">
    Registre o script no `server.cfg`, após o framework:

    ```cfg server.cfg theme={null}
    # Framework
    ensure es_extended  # ou qb-core

    # Meus scripts
    ensure meu-script
    ```
  </Step>

  <Step title="Teste no servidor">
    Inicie o servidor e conecte. Abra o console do cliente (F8) e verifique se há erros. Teste o comando ou funcionalidade principal do script para confirmar que tudo está funcionando.
  </Step>
</Steps>

## Dicas para Evitar Problemas

<Accordion title="O script não inicia (erro no console do servidor)">
  Verifique:

  * O nome na linha `ensure` bate exatamente com o nome da pasta
  * O arquivo `fxmanifest.lua` existe na raiz do recurso
  * Todas as dependências listadas no `fxmanifest.lua` estão instaladas e iniciadas antes deste script
</Accordion>

<Accordion title="Erros de banco de dados">
  Se aparecer `Database error` ou erros relacionados ao MySQL:

  * Confirme que o arquivo SQL foi importado corretamente
  * Verifique se o oxmysql está configurado e rodando
  * Ative `Config.Debug = true` para ver os queries executados
</Accordion>

<Accordion title="Script inicia mas nada funciona no cliente">
  * Verifique o console F8 por erros de Lua no cliente
  * Confirme que o framework correto está detectado — ative debug para ver a mensagem de inicialização
  * Certifique-se de que o script carrega depois do framework no `server.cfg`
</Accordion>

## Próximos Passos

<CardGroup cols={2}>
  <Card title="Configuração Avançada" icon="gear" href="/configuracao">
    Explore todas as opções disponíveis no config.lua.
  </Card>

  <Card title="Permissões" icon="shield" href="/guias/permissoes">
    Configure quem pode usar quais comandos e funcionalidades.
  </Card>
</CardGroup>