Como instalar e verificar um template de servidor FiveM

Instale um template de servidor FiveM em um diretório server-data isolado e em um banco de dados novo, seguindo a documentação desse pacote exato. Confirme o fluxo principal do jogador antes de importar dados existentes ou abrir o servidor ao público.

Vai montar seu primeiro servidor? Siga nosso guia passo a passo sobre como criar um servidor FiveM.

Reúna os arquivos necessários

Baixe o pacote autorizado pelo local de download do seu pedido e guarde o arquivo original e as instruções de instalação. Registre a versão do framework, o mecanismo de banco de dados exigido, os requisitos de artifact, as dependências e as licenças vinculadas à conta.

Para uma compra na RPScripts, use os downloads da sua conta. As instruções do próprio pacote determinam a organização dos arquivos e o procedimento de atualização. Se elas estiverem ausentes, solicite-as antes de tentar adivinhar configurações de SQL ou de inicialização.

Prepare o ambiente

1. Configure o FXServer usando o procedimento oficial específico do sistema operacional. Mantenha separados os binários do servidor, o server-data e os dados do perfil do txAdmin.
2. Instale o mecanismo e a versão de banco de dados compatíveis com o template. Crie um banco de dados novo e uma conta dedicada com acesso limitado a ele. Não aponte o template para o banco de dados que você já usa em produção.
3. Faça backup do servidor atual se for substituí-lo. Extraia o template no local esperado pelo procedimento de implantação; a pasta resources e o server.cfg não devem ficar escondidos em uma pasta extra criada por engano na extração.
4. Revise o SQL fornecido antes de importá-lo no banco de dados novo. Confira o banco de dados selecionado, as alterações no esquema e as contas de exemplo. Pare se houver erros em vez de repetir às cegas uma importação destrutiva.

Exemplo: o SQL recria um banco de dados com nome fixo

Para a primeira importação, use uma instância de banco de dados isolada quando o SQL de um pacote contiver um nome de banco de dados fixo ou instruções destrutivas. Verifique as instruções DROP DATABASE, CREATE DATABASE e USE antes da execução. Selecionar um novo banco de dados em um cliente gráfico não é suficiente quando o próprio arquivo seleciona ou recria outro esquema.

O atual guia de configuração do QBCore V5 identifica QBV5/[sql]/fivemstore.sql e avisa que o arquivo exclui e recria fivemstorev5. Mantenha os bancos de dados existentes fora da instância de teste, inspecione a instrução e importe o arquivo nessa instância. Depois, verifique o esquema fivemstorev5 e o log de importação. Configure o pacote para usar o banco de dados verificado com uma conta de permissões limitadas.

A auditoria separada do pacote de 8 de setembro verificou a integridade do arquivo e uma importação SQL isolada. A inicialização real do FXServer não foi verificada. Continue com os testes de execução e de sessão do jogador descritos abaixo; importar o SQL com sucesso não comprova que o servidor funciona.

Se as instruções ou dependências do pacote não estiverem claras, envie o URL exato do produto, o ambiente e o primeiro erro para o Suporte RPScripts, com as credenciais removidas. Este exemplo estabelece o comportamento desse arquivo V5; ele não estabelece que outros pacotes usam o mesmo nome de banco de dados ou procedimento de importação.

Configure apenas as opções documentadas

Defina a conexão do banco de dados no local do lado do servidor usado pelo adaptador real. Não invente Config.MySQLConnection nem coloque senhas em arquivos Lua compartilhados. Preserve a ordem de dependências do template até que a documentação dele explique uma mudança.

Use em sv_licenseKey a chave atual de servidor do proprietário no Cfx.re Portal. Mantenha-a privada. Configure os endpoints TCP/UDP reais, o limite compatível de slots e a descrição pública usando a referência de comandos de servidor. Chaves de API da Steam, quando exigidas por um recurso, são segredos e não devem ser publicadas com sets.

Inicie com o contexto de execução correto

Use o perfil do txAdmin ou o inicializador documentado que aponta para esta configuração de server-data. Um +exec server.cfg relativo é resolvido no contexto de execução; iniciar a partir do diretório errado pode não carregar nenhuma configuração ou carregar a errada.

Leia o primeiro erro de inicialização. Verifique recursos ausentes, autenticação do banco de dados, requisitos de versão e permissões antes de adicionar mais recursos. Restrinja as portas de administração separadamente do endpoint público do jogo.

Verifique uma sessão completa

1. Entre usando o endpoint de jogo pretendido. Use 127.0.0.1 apenas quando cliente e servidor rodarem na mesma máquina.
2. Crie um personagem de teste e exercite inventário, dinheiro, empregos, voz e qualquer interação essencial. Compare uma conta comum com uma de administrador.
3. Reconecte e reinicie o servidor. Depois, confira se os dados esperados foram mantidos sem duplicação.
4. Restaure um backup em um ambiente de teste separado. Registre todos os arquivos e dependências necessários para a recuperação.
5. Agende a virada para o público somente depois que essas verificações passarem. Mantenha o servidor anterior e o banco de dados correspondente disponíveis até a aceitação.

Quando uma instalação falha

Compartilhe a versão do pacote, o ambiente, o primeiro erro completo e as etapas já tentadas com o contato de suporte do pacote. Remova credenciais e dados pessoais dos logs. Um valor nil, por si só, não prova que uma tabela SQL está faltando.