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

# Dicas

> Procedimentos recomendados para utilizar os sistemas da Five Network com segurança e eficiência.

Fique por dentro de algumas dicas gerais na utilização dos nossos sistemas e sobre procedimentos recomendados para manter seu servidor funcionando sem problemas.

## Reportar erros ou bugs

Ao encontrar um problema com qualquer produto, forneça as seguintes informações no ticket de suporte para agilizar o atendimento:

<Steps>
  <Step title="Descreva o contexto do erro">
    Informe **quando** e **em quais circunstâncias** o erro ocorre. Quanto mais detalhes, mais rápida será a resolução.
  </Step>

  <Step title="Envie os arquivos do script">
    Inclua todos os arquivos do recurso (especialmente arquivos de configuração que você tenha editado).
  </Step>

  <Step title="Capture os consoles">
    Tire prints ou grave o console do **cliente (F8)** e do **servidor** no momento em que o erro aparece.
  </Step>

  <Step title="Informe sua base">
    Indique qual framework e versão você utiliza (ex: ESX, QBCore, Ox Core), além de outros recursos que possam interagir com o script.
  </Step>
</Steps>

## Ambiente de testes

<Warning>
  Recomendamos utilizar um **servidor de testes separado** para realizar instalações, atualizações ou correções de erros. Nunca faça modificações diretamente em um servidor com jogadores ativos.
</Warning>

Testar em um ambiente isolado evita:

* Interrupções inesperadas para os jogadores
* Perda de dados causada por configurações incorretas
* Dificuldade em identificar a origem de conflitos entre scripts

## Processo de atualização

A maioria das atualizações da Five Network é aplicada automaticamente. No entanto, algumas atualizações exigem ações manuais. Siga sempre este processo:

<Steps>
  <Step title="Leia o changelog completo">
    Antes de atualizar, leia com atenção todas as mudanças descritas no changelog do produto.
  </Step>

  <Step title="Faça backup">
    Salve uma cópia do banco de dados e dos arquivos atuais do script **antes** de aplicar qualquer alteração.
  </Step>

  <Step title="Siga as instruções à risca">
    Aplique apenas as mudanças indicadas. Não substitua arquivos de configuração por completo — adicione ou altere apenas o que foi especificado.
  </Step>

  <Step title="Teste antes de abrir o servidor">
    Verifique se tudo funciona corretamente no ambiente de testes antes de aplicar em produção.
  </Step>
</Steps>

<Warning>
  Substituir arquivos de configuração inteiros durante uma atualização pode resultar na **perda de todas as personalizações** realizadas anteriormente. Sempre edite apenas o que foi indicado no changelog.
</Warning>

## Boas práticas gerais

<AccordionGroup>
  <Accordion title="Mantenha seu servidor atualizado" icon="arrow-up-circle">
    Utilize sempre as versões mais recentes dos nossos scripts. Atualizações trazem correções de bugs, melhorias de desempenho e novos recursos.
  </Accordion>

  <Accordion title="Não edite arquivos protegidos" icon="lock">
    Arquivos autenticados não devem ser modificados. Alterações nesses arquivos violam os Termos de Uso e podem invalidar sua licença.
  </Accordion>

  <Accordion title="Evite sobrecarga no servidor" icon="server">
    Instale apenas os scripts necessários para o seu servidor. Recursos em excesso aumentam o consumo de memória e CPU, prejudicando a experiência dos jogadores.
  </Accordion>

  <Accordion title="Comunique problemas rapidamente" icon="bell">
    Quanto antes um bug for reportado com informações detalhadas, mais rápido conseguimos resolver. Não espere o problema se agravar para abrir um ticket.
  </Accordion>
</AccordionGroup>

<Tip>
  Em caso de dúvidas, acesse o nosso **Discord oficial** e abra um ticket no canal de suporte. Nossa equipe está disponível de segunda a sexta, das 13h30 às 18h (horário de Brasília).
</Tip>