> ## 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 Instalar Scripts FiveM: Guia Completo do Servidor

> Guia passo a passo para instalar scripts FiveM no seu servidor, configurar o server.cfg e verificar se o recurso está funcionando corretamente.

Instalar um script FiveM é um processo direto: você baixa o recurso, coloca na pasta correta, registra no `server.cfg` e reinicia o servidor. Este guia cobre cada etapa com detalhes para que você possa ter o script rodando sem problemas.

## Pré-requisitos

Antes de começar, verifique se você tem:

* Acesso à pasta `resources` do servidor (via FTP, SFTP ou acesso direto)
* Permissão para editar o arquivo `server.cfg`
* Os requisitos de sistema listados na [página de introdução](/introducao)

## Instalação Passo a Passo

<Steps>
  <Step title="Baixe o arquivo do script">
    Após a compra ou download, você receberá um arquivo `.zip` contendo o recurso. Extraia o conteúdo — você terá uma pasta com o nome do script (ex: `meu-script`).
  </Step>

  <Step title="Envie para a pasta resources">
    Copie a pasta do script para o diretório `resources` do seu servidor FiveM. A estrutura deve ficar assim:

    ```text theme={null}
    resources/
    └── [meu-script]/
        ├── fxmanifest.lua
        ├── config.lua
        ├── client/
        └── server/
    ```

    <Tip>
      Organize seus scripts em subpastas como `resources/[scripts-customizados]/` para facilitar o gerenciamento.
    </Tip>
  </Step>

  <Step title="Registre no server.cfg">
    Abra o arquivo `server.cfg` e adicione a linha de `ensure` para o seu script:

    ```cfg server.cfg theme={null}
    ensure meu-script
    ```

    <Warning>
      Coloque o `ensure` do script **depois** do ensure do framework (ESX ou QBCore) para garantir a ordem de carregamento correta.
    </Warning>
  </Step>

  <Step title="Configure o banco de dados">
    Se o script utiliza banco de dados, importe o arquivo SQL incluído no pacote. Geralmente ele se chama `meu-script.sql` ou está na pasta `database/`.

    ```bash theme={null}
    mysql -u usuario -p nome_do_banco < meu-script.sql
    ```

    Alternativamente, use uma interface como phpMyAdmin ou HeidiSQL para importar o arquivo.
  </Step>

  <Step title="Reinicie o servidor">
    Reinicie o servidor completo ou, se preferir, use os comandos no console:

    ```bash theme={null}
    refresh
    restart meu-script
    ```
  </Step>
</Steps>

## Verificando a Instalação

Após reiniciar, confirme que o script está rodando:

1. No console do servidor, procure por mensagens de inicialização do script (ex: `[meu-script] Iniciado com sucesso`)
2. Conecte ao servidor e teste o funcionamento básico
3. Verifique o console do F8 no cliente por erros de Lua

<Note>
  Se aparecer `Couldn't start resource meu-script`, verifique se a pasta está com o nome correto e se o `fxmanifest.lua` existe dentro dela.
</Note>

## Atualizando um Script

<Steps>
  <Step title="Faça backup">
    Antes de atualizar, salve uma cópia do `config.lua` atual para não perder suas configurações.
  </Step>

  <Step title="Substitua os arquivos">
    Substitua todos os arquivos da pasta do script pelos novos, exceto o `config.lua` se você não quiser perder as configurações.
  </Step>

  <Step title="Revise o config.lua">
    Compare seu `config.lua` com o novo `config.lua` fornecido para verificar se há novas opções de configuração.
  </Step>

  <Step title="Reinicie o recurso">
    Use `restart meu-script` no console do servidor.
  </Step>
</Steps>