Instalando e configurando seu modelo de servidor FiveM

Etapa 2: Preparando seu ambiente de servidor

Este passo é crucial para uma instalação suave. Não pule!

1. Configure seu servidor FiveM base:

   • Baixar Artefatos: Acesse a documentação oficial do FiveM (docs.cfx.re) e encontre o link para a versão mais recente recomendado artefatos de servidor para seu sistema operacional (Windows ou Linux). Baixe-os.

   • Criar diretório do servidor: Crie uma pasta principal para seu servidor (por exemplo, C:\FXServer ou /home/usuário/FXServer).

   • Extrair Artefatos: Extraia os artefatos do servidor baixados diretamente para esta pasta.

   • Criar dados do servidor Diretório: Dentro do diretório principal do servidor, crie uma subpasta chamada dados do servidor. É aqui que seus recursos e configuração ficarão, mantendo tudo organizado e separado dos arquivos principais do servidor. Nossos arquivos de modelo irão dentro disto dados do servidor pasta.

2. Instalar software de banco de dados (MySQL/MariaDB):

   • Por que? Os servidores FiveM, especialmente os servidores de RPG que usam estruturas como ESX ou QBCore, dependem muito de bancos de dados para armazenar dados persistentes: contas de jogadores, informações de personagens, inventário, propriedade de veículos, status de negócios, registros, etc. Sem um banco de dados, nenhuma dessas informações pode ser salva entre as sessões.

   • Como?

     • Windows: Baixe o instalador do MySQL Community Server ou o instalador do MariaDB de seus sites oficiais. Siga o assistente de instalação. Durante a instalação, anote com segurança o raiz senha que você definiu.

     • Linux (Debian/Ubuntu): Use o gerenciador de pacotes: sudo apt update && sudo apt install mariadb-server. Correr sudo mysql_secure_installation depois para definir a senha de root e proteger a instalação.

     • Linux (CentOS/RHEL): Use o gerenciador de pacotes: sudo yum update && sudo yum install mariadb-server. Inicie o serviço sudo systemctl iniciar mariadb e habilitá-lo na inicialização sudo systemctl habilitar mariadb. Correr sudo mysql_secure_installation.

   • Verificação: Certifique-se de que o serviço de banco de dados esteja em execução (serviços.msc no Windows, sudo systemctl status mariadb no Linux).

3. Instalar a ferramenta de gerenciamento de banco de dados (recomendado pelo HeidiSQL):

   • Por que? Enquanto você pode gerencie o MySQL/MariaDB via linha de comando, uma ferramenta gráfica que facilita muito a criação de bancos de dados, a importação de dados e a navegação em tabelas.

   • Como? Baixe o HeidiSQL do site oficial e instale-o. Ele é leve e fácil de usar.

4. (Somente Windows) Instale o Visual C++ Redistributable:

   • Por que? Muitos recursos do FiveM, e o próprio FiveM, dependem das bibliotecas Visual C++ da Microsoft. A falta delas é um muito comum causa de falhas de inicialização do servidor ou erros de script.

   • Como? Baixe a versão x64 mais recente diretamente da Microsoft e execute o instalador. Reinicie sua máquina se solicitado.

Etapa 3: Instalando o modelo do servidor

Agora, mesclamos o modelo baixado com o ambiente de servidor preparado.

1. Extraia os arquivos de modelo:

   • Abra o .zip arquivo que você baixou do FiveMX.com.

   • Extraia seu todo o conteúdo diretamente para o dados do servidor pasta que você criou na Etapa 2.

   • Crucial: Certifique-se de que a estrutura do arquivo esteja correta. Você deve ver pastas como recursos e potencialmente arquivos como servidor.cfg diretamente dentro dados do servidor, não aninhado dentro de uma pasta extra nomeada após o modelo (por exemplo, NÃO dados-do-servidor/MyTemplateName/recursos, mas dados/recursos do servidor).

2. Configurar o banco de dados:

   • Localize o arquivo SQL: Dentro dos arquivos de modelo extraídos (provavelmente dentro do arquivo principal dados do servidor diretório ou um dedicado _INSTALAR pasta), encontre o arquivo do banco de dados. Geralmente termina com .sql (por exemplo, banco de dados.sql, instalar.sql, esx_legacy.sql).

   • Abra o HeidiSQL (ou sua ferramenta): Inicie sua ferramenta de gerenciamento de banco de dados.

   • Conectar ao banco de dados: Crie uma nova sessão de conexão.

     • Nome do host/IP: 127.0.0.1 (ou host local) se o banco de dados estiver na mesma máquina que o HeidiSQL. Se seu banco de dados estiver hospedado em outro lugar, use seu endereço IP.

     • Usuário: raiz (ou o usuário específico que você criou, no entanto raiz é bom para configurações locais).

     • Senha: A senha que você definiu durante a instalação do MySQL/MariaDB.

     • Porto: Normalmente 3306.

     • Clique em “Abrir” ou “Conectar”.

   • Crie o banco de dados:

     • Clique com o botão direito no painel esquerdo (onde as conexões do servidor são listadas) ou vá para a aba “Consulta”.

     • Execute o comando: CRIAR BANCO DE DADOS SE NÃO EXISTIR nome_do_seu_banco_de_dados; (Substituir nome_do_seu_banco_de_dados com um nome que você escolher, por exemplo, Servidor fivemx. Lembre-se deste nome!). Use um nome descritivo. Pressione F9 ou clique no botão “Executar”.

     • Atualize a lista do banco de dados (F5). Você deverá ver seu novo banco de dados vazio.

   • Importe o arquivo SQL:

     • Selecione seu banco de dados recém-criado no painel esquerdo para torná-lo ativo.

     • Vá para Arquivo -> Executar arquivo SQL….

     • Navegue e selecione o .sql arquivo do seu modelo.

     • Clique em “Open”. O HeidiSQL executará todos os comandos dentro do arquivo, criando as tabelas necessárias e potencialmente inserindo dados padrão exigidos pelos scripts do modelo. Isso pode levar de alguns segundos a um minuto, dependendo da complexidade do modelo. Verifique a saída do log na parte inferior para ver se há erros.

3. Configurar conexão de banco de dados em arquivos do servidor:

   • Por que? Seu servidor FiveM precisa saber como se conectar ao banco de dados que você acabou de configurar. O modelo inclui scripts que exigem essas credenciais.

   • Encontre a configuração: O localização exata varia entre modelos e frameworks (ESX, QBCore). Locais comuns incluem:

     • Diretamente em dados do servidor/servidor.cfg.

     • No arquivo de configuração de um recurso específico, como dados do servidor/recursos/[esx]/es_extended/config.lua ou dados do servidor/recursos/[qb]/qb-core/config.lua.

     • Às vezes, em um script de conexão de banco de dados dedicado como ghmattimysql ou oxmysql. Verifique a documentação do modelo ou servidor.cfg para começar ou garantir linhas relacionadas ao mysql async/oxmysql.

   • Edite as configurações: Abra o(s) arquivo(s) relevante(s) com seu editor de texto (VS Code, Notepad++). Procure por linhas similares a esta (a sintaxe pode variar um pouco entre Lua/JS/JSON):

     -- Exemplo para Configurações Lua estilo ESX/QBCore Config.MySQLConnection = "mysql://root:[email protected]/nome_do_seu_banco_de_dados?charset=utf8mb4"
     -- ou campos separados:
     definir string_de_conexão_mysql "server=127.0.0.1;database=nome_do_seu_banco_de_dados;userid=root;password=SuaSenha;" -- Frequentemente encontrado diretamente em servidor.cfg para configurações mais antigas ou recursos específicos -- ou em JSON formatar para alguns recursos: // { "hospedar": "127.0.0.1", "usuário": "raiz", "senha": "SuaSenha", "banco de dados": "nome_do_seu_banco_de_dados" }

      

   • Atualizar valores: Substituir “SuaSenha” com sua senha raiz do banco de dados real e “nome_do_seu_banco_de_dados” com o nome exato do banco de dados que você criou no HeidiSQL. Certifique-se de que o host (127.0.0.1 ou host local) e usuário (raiz) estão corretas.

   • Salve o(s) arquivo(s). Verifique novamente se você atualizou todas as strings de conexão necessárias, caso haja várias.

4. Revisar e configurar servidor.cfg:

   • Abra o dados do servidor/servidor.cfg arquivo com seu editor de texto. Este é o arquivo de configuração principal para seu servidor FiveM.

   • Configurações essenciais:

     • sv_licenseKey “sua_chave_de_licença”: Substituir “sua_chave_de_licença” com a chave que você gerou do FiveM Keymaster. Isso é obrigatório para que o servidor seja listado e funcione corretamente.

     • sv_hostname “Meu incrível servidor FiveMX”: Altere isso para o nome do servidor desejado, como ele aparecerá na lista de servidores. Use cores e emojis se quiser (usando os códigos de formatação do FiveM).

     • sv_maxclientes 48: Defina o número máximo de slots de jogadores (certifique-se de que seu tipo de licença suporta esse número – chaves padrão suportam até 48, níveis mais altos via Patreon).

     • sv_projectDesc “Uma descrição do meu servidor.”: Defina uma breve descrição que aparece em algumas listas de servidores ou painéis de detalhes.

     • define steam_webApiKey “SUA_STEAM_API_KEY”: Necessário para muitas estruturas/scripts. Obtenha um no site do Steam Developer. Adicione esta linha se estiver faltando e for necessária para seu framework.

     • garantir …: Essas linhas carregam seus recursos. O template FiveMX deve ter essas pré-configuradas. A ordem às vezes pode importar, especialmente para estruturas (por exemplo, garantir es_extended antes dos complementos ESX). Não altere a ordem a menos que você saiba o que está fazendo ou seguindo instruções específicas.

   • Revisar outras configurações: Procure no arquivo por quaisquer outras configurações específicas para o modelo (como localidade, dinheiro inicial, convars específicos do script) e ajuste conforme necessário. Comentários (# ou — no início de uma linha) geralmente explicam o que as configurações fazem.

   • Salve o servidor.cfg arquivo.

Feito por enquanto.

Etapa 4: Iniciando seu servidor

É hora de colocá-lo online!

• Navegue até o diretório correto: Abra o seu servidor principal diretório (por exemplo, C:\FXServer ou /home/usuário/FXServer), aquele que contém o FXServer.exe ou executar.sh arquivo, NÃO o dados do servidor diretório.

• Para usuários do Windows:

  1. Encontrar executar.cmd ou similar: Procure um arquivo em lote normalmente chamado executar.cmd ou às vezes iniciar.bat. Muitas vezes, ele fará referência ao dados do servidor diretório, como +exec server.cfg +definir txAdminPort 40120.

  2. Clique duas vezes: Clique duas vezes no executar.cmd (ou arquivo equivalente).

  3. Janela do console: Uma janela de prompt de comando (ou várias, se estiver usando TxAdmin) aparecerá. Este é o console do seu servidor. Observe atentamente!

• Para usuários Linux:

  1. Abra o Terminal: Abra uma janela de terminal no diretório principal do seu servidor.

  2. Tornar executável (se necessário): Certifique-se de que o script de inicialização seja executável: chmod +x executar.sh.

  3. Execute o script: Execute o script de inicialização: ./run.sh +exec servidor.cfg. (O +exec servidor.cfg parte pode já estar dentro do executar.sh roteiro em si).

  4. Saída do console: A saída do console do servidor aparecerá diretamente no seu terminal.

Verifique se o servidor está em execução:

• Assista ao Console: Procure mensagens indicando que os recursos estão iniciando (geralmente texto verde como Recurso iniciado MyResource).

• Verifique se há erros: Procure criticamente VERMELHO mensagens de erro. Erros comuns incluem:

  • Falha de autenticação: Não foi possível conectar ao banco de dados. (Verifique a Etapa 3.3 – Credenciais do Banco de Dados).

  • Não foi possível encontrar o recurso X. (Verifique se a pasta de recursos existe em recursos e o garantir X linha em servidor.cfg corresponde exatamente ao nome da pasta).

  • ERRO de script: … (Indica um problema no código de um script específico. Pode exigir depuração ou verificação de problemas de compatibilidade).

  • Erros relacionados a dependências ausentes (como o Visual C++ Redistributable no Windows).

• Mensagem de sucesso: O ideal é que, após carregar todos os recursos, você veja mensagens indicando que o servidor está ativo, escutando em uma porta e autenticado com os serviços FiveM.

• Conectar no jogo:

  1. Inicie o FiveM no seu PC gamer.

  2. Pressione F8 para abrir o console do cliente.

  3. Tipo conectar 127.0.0.1:30120 (se estiver executando o servidor no mesmo máquina em que você está jogando) ou conecte SEU_IP_DO_SERVIDOR:30120 (se o servidor estiver hospedado em outro lugar, use seu endereço IP público). A porta padrão é 30120 a menos que tenha sido alterado no seu script de inicialização ou servidor.cfg.

  4. Se tudo estiver correto, você deve começar a se conectar ao seu servidor!

Etapa 5: Personalização básica (pós-instalação)

Seu servidor está em execução, mas agora você quer fazê-lo seu.

• Faça backup primeiro! Antes de fazer grandes alterações, pare o servidor e faça um backup do seu dados do servidor pasta e seu banco de dados (use o recurso de exportação do HeidiSQL).

• Alterar logotipos/telas de carregamento: Procure recursos relacionados a recursos visuais (por exemplo, tela de carregamento, placar) e verifique seus HTML->, css, js arquivos ou configuração.lua para opções de personalização. Substitua arquivos de imagem (como logo.png) com o seu, mantendo dimensões semelhantes.

• Configurar trabalhos/atividades: Explore os arquivos de configuração (configuração.lua é comum) dentro de pastas de recursos específicas (por exemplo, recursos/[empregos]/policejob/config.lua) para ajustar pagamentos de empregos, locais, classificações necessárias, etc.

• Adicionar/Remover Veículos: Para adicionar veículos personalizados, você normalmente coloca a pasta de recursos do veículo em seu recursos diretório e adicionar garantir nome_do_recurso_do_veículo para o seu servidor.cfg. Consulte guias específicos para adicionar veículos. A remoção é o inverso (apagar pasta, remover garantir linha).

• Ajustar a economia: As configurações de framework (ESX/QBCore) geralmente controlam o dinheiro inicial, os intervalos de salário e os preços dos itens base. Ajuste-os cuidadosamente.

Etapa 6: Gerenciando e mantendo seu servidor

Executar um servidor é um processo contínuo:

• Backups regulares: Sério, automatize isso se possível. Faça backup do seu dados do servidor pasta (especialmente a recursos subpasta e servidor.cfg) e seu banco de dados (.sql jogar fora) diário ou pelo menos várias vezes por semana. Armazene backups fora do local, se possível. Confira nosso tutorial de backup dedicado [Link para seu tutorial de backup aqui]!

• Mantenha-se atualizado:

  • Artefatos FiveM: Verifique periodicamente a documentação do FiveM para novas recomendado o servidor constrói e atualiza os arquivos principais do servidor (geralmente envolve a substituição dos arquivos externos dados do servidor). Leia os changelogs primeiro!

  • Atualizações do modelo FiveMX: Fique de olho no FiveMX.com para atualizações do seu template específico. As atualizações podem incluir correções de bugs, novos recursos ou melhorias de compatibilidade. Siga nossas instruções de atualização cuidadosamente.

  • Atualizações de recursos: Os criadores de scripts individuais geralmente atualizam seus recursos em plataformas como o GitHub. A atualização requer a substituição da pasta de recursos e a verificação de alterações de configuração. Tenha cuidado, pois as atualizações às vezes podem quebrar coisas ou entrar em conflito com outros scripts.

• Desempenho do monitor: Use ferramentas de monitoramento de servidor (como administrador do tx incluído com FiveM, ou monitores de recursos como htop no Linux / Gerenciador de Tarefas no Windows) para verificar o uso da CPU/RAM. Alto uso pode indicar scripts mal otimizados.

• Interaja com sua comunidade: Ouça o feedback dos jogadores para relatórios de bugs e sugestões.

• Use os canais de suporte: Se você encontrar problemas relacionados ao modelo FiveMX, não hesite em usar nosso Discord ou fóruns de suporte.