{"id":148412,"date":"2024-07-19T13:19:39","date_gmt":"2024-07-19T11:19:39","guid":{"rendered":"https:\/\/hifivem.com\/?p=148412"},"modified":"2026-08-12T15:40:36","modified_gmt":"2026-08-12T13:40:36","slug":"como-criar-um-servidor-fivepd","status":"publish","type":"post","link":"https:\/\/rpcrate.com\/pt\/how-to-create-a-fivepd-server\/","title":{"rendered":"Como Configurar e Verificar um Servidor FivePD"},"content":{"rendered":"<p><strong>Para criar um servidor FivePD, comece com um FXServer funcional, baixe o pacote FivePD de uma fonte confi\u00e1vel, leia as notas de instala\u00e7\u00e3o do pacote, instale suas depend\u00eancias declaradas, adicione os recursos ao <code data-no-translation=\"\" translate=\"no\">server.cfg<\/code>, e teste o recurso base antes de adicionar callouts.<\/strong> N\u00e3o copie um banco de dados antigo ou exemplo de configura\u00e7\u00e3o cegamente: as distribui\u00e7\u00f5es e complementos FivePD nem todos usam os mesmos arquivos, camada de armazenamento ou vers\u00f5es de depend\u00eancia.<\/p>\n<h2 id=\"what-you-need-before-downloading-fivepd\">O que voc\u00ea precisa antes de baixar o FivePD<\/h2>\n<ul>\n<li>Uma inst\u00e2ncia limpa do FXServer que inicia com sucesso sem o FivePD.<\/li>\n<li>Uma chave de servidor Cfx.re v\u00e1lida e acesso ao console do servidor.<\/li>\n<li>Um servidor de teste ou de prepara\u00e7\u00e3o separado. N\u00e3o experimente na \u00fanica c\u00f3pia ativa.<\/li>\n<li>O arquivo FivePD, seu README ou documenta\u00e7\u00e3o, e todas as depend\u00eancias nomeadas l\u00e1.<\/li>\n<li>Um backup de <code data-no-translation=\"\" translate=\"no\">server.cfg<\/code>, configura\u00e7\u00e3o de recursos e qualquer banco de dados usado pelo pacote.<\/li>\n<\/ul>\n<p>Se o servidor FiveM subjacente ainda n\u00e3o estiver pronto, siga <a href=\"https:\/\/rpcrate.com\/pt\/como-criar-um-servidor-fivem\/\">o guia de configura\u00e7\u00e3o do servidor txAdmin<\/a> primeiro. Verifique os arquivos e requisitos da distribui\u00e7\u00e3o FivePD real antes de instal\u00e1-la.<\/p>\n<h2 id=\"step-1-prove-the-base-fxserver-works\">Passo 1: prove que o FXServer base funciona<\/h2>\n<p>Inicie o FXServer com uma configura\u00e7\u00e3o m\u00ednima e conecte-se uma vez antes de instalar o FivePD. Confirme que o servidor aparece, o console est\u00e1 livre de falhas de inicializa\u00e7\u00e3o e um cliente pode se conectar. Isso separa um problema de FXServer, firewall ou chave de servidor de um problema de FivePD.<\/p>\n<p>Registre as vers\u00f5es atuais do artefato e do recurso. O Cfx.re recomenda artefatos de servidor atuais, mas alterar o artefato, a compila\u00e7\u00e3o do jogo, a estrutura e o pacote FivePD em uma \u00fanica tentativa torna as falhas dif\u00edceis de isolar. Altere uma camada por vez.<\/p>\n<h2 id=\"step-2-inspect-the-fivepd-download\">Passo 2: inspecione o download do FivePD<\/h2>\n<p class=\"translation-block\">Primeiro, extraia o pacote fora do diret\u00f3rio <code>resources<\/code> de produ\u00e7\u00e3o. Localize o <code>fxmanifest.lua<\/code> ou manifesto antigo, o README, os arquivos de configura\u00e7\u00e3o e as declara\u00e7\u00f5es de depend\u00eancias. A pasta colocada em <code>resources<\/code> deve ser a que cont\u00e9m o manifesto; uma pasta extra criada na extra\u00e7\u00e3o acima dela \u00e9 uma causa comum de \u201cresource not found\u201d.<\/p>\n<p>Verifique o arquivo para obter instru\u00e7\u00f5es sobre importa\u00e7\u00f5es de banco de dados, strings de conex\u00e3o, permiss\u00f5es e ordem de carregamento. Alguns pacotes ou extens\u00f5es podem precisar de armazenamento de banco de dados; outros podem n\u00e3o. Crie esquemas ou cole SQL apenas quando o pacote instalado o exigir explicitamente. Nunca publique senhas de banco de dados em um script de cliente, configura\u00e7\u00e3o compartilhada ou reposit\u00f3rio p\u00fablico.<\/p>\n<h2 id=\"step-3-install-dependencies-before-the-main-resource\">Passo 3: instale as depend\u00eancias antes do recurso principal<\/h2>\n<p class=\"translation-block\">Coloque cada depend\u00eancia exigida em seu pr\u00f3prio diret\u00f3rio de recurso. Confirme que o nome corresponde ao manifesto e \u00e0 linha <code>ensure<\/code> que voc\u00ea pretende usar. Se a documenta\u00e7\u00e3o definir uma ordem, inicie as bibliotecas compartilhadas e as integra\u00e7\u00f5es de banco de dados antes do FivePD, depois inicie os recursos de ocorr\u00eancias ap\u00f3s o recurso base.<\/p>\n<p>Uma forma de configura\u00e7\u00e3o simples \u00e9:<\/p>\n<pre data-no-translation=\"\" translate=\"no\"><code data-no-translation=\"\" translate=\"no\"># Start required libraries first\nensure required_dependency\n\n# Start the FivePD resource after its dependencies\nensure fivepd\n\n# Add one compatible callout only after the base test passes\nensure example_callout<\/code><\/pre>\n<p class=\"translation-block\">Esses nomes s\u00e3o ilustrativos. Use os nomes reais dos diret\u00f3rios e recursos do seu download. O comando <code>ensure<\/code> da Cfx.re inicia um recurso parado ou reinicia um que j\u00e1 esteja em execu\u00e7\u00e3o.<\/p>\n<h2 id=\"step-4-configure-server-side-values-safely\">Passo 4: configure os valores do lado do servidor com seguran\u00e7a<\/h2>\n<p>Fa\u00e7a a menor configura\u00e7\u00e3o necess\u00e1ria para um primeiro in\u00edcio. Mantenha as credenciais e as configura\u00e7\u00f5es privilegiadas no lado do servidor. Onde o pacote fornece padr\u00f5es, copie o exemplo distribu\u00eddo e altere apenas as chaves documentadas. N\u00e3o invente campos de configura\u00e7\u00e3o de um tutorial n\u00e3o relacionado: uma chave com erro de digita\u00e7\u00e3o pode ser ignorada silenciosamente, e uma op\u00e7\u00e3o antiga pode n\u00e3o existir mais.<\/p>\n<p>Se um banco de dados for necess\u00e1rio, use um usu\u00e1rio de banco de dados dedicado com apenas as permiss\u00f5es necess\u00e1rias. Importe o esquema correspondente do pacote uma vez e, em seguida, confirme se as tabelas existem. Uma importa\u00e7\u00e3o SQL bem-sucedida n\u00e3o prova que o recurso pode se conectar, ent\u00e3o verifique o console do servidor durante a inicializa\u00e7\u00e3o.<\/p>\n<h2 id=\"step-5-test-the-base-resource-before-callouts\">Passo 5: teste o recurso base antes dos callouts<\/h2>\n<ol>\n<li>Inicie o servidor com depend\u00eancias e FivePD, mas sem callouts opcionais.<\/li>\n<li>Observe o log completo do servidor desde a descoberta do recurso at\u00e9 a inicializa\u00e7\u00e3o.<\/li>\n<li>Conecte-se com um cliente limpo e inspecione o console F8 em busca de erros do cliente.<\/li>\n<li>Confirme apenas os comandos e interfaces base documentados.<\/li>\n<li>Reinicie o recurso e reconecte-se para expor problemas de ordem de carregamento ou persist\u00eancia.<\/li>\n<\/ol>\n<p>Em seguida, adicione um callout, reinicie e teste-o. Repita um de cada vez. Um callout escrito para outra compila\u00e7\u00e3o FivePD pode falhar mesmo quando o recurso base est\u00e1 saud\u00e1vel; mantenha a \u00faltima vers\u00e3o funcional dispon\u00edvel para revers\u00e3o.<\/p>\n<h2 id=\"common-fivepd-installation-failures\">Falhas comuns de instala\u00e7\u00e3o do FivePD<\/h2>\n<div aria-label=\"Tabela com rolagem horizontal\" class=\"fmx-guide-table\" role=\"region\" tabindex=\"0\">\n<table>\n<thead>\n<tr>\n<th>Sintoma<\/th>\n<th>Primeira verifica\u00e7\u00e3o<\/th>\n<th>Pr\u00f3xima a\u00e7\u00e3o segura<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>Recurso n\u00e3o encontrado<\/td>\n<td class=\"translation-block\">A pasta que cont\u00e9m <code>fxmanifest.lua<\/code> e o nome exato usado em <code>ensure<\/code><\/td>\n<td>Corrija o n\u00edvel do diret\u00f3rio ou o nome do recurso, depois reinspecione\/reinicie<\/td>\n<\/tr>\n<tr>\n<td>Depend\u00eancia ou exporta\u00e7\u00e3o ausente<\/td>\n<td>A depend\u00eancia est\u00e1 instalada, compat\u00edvel e iniciada primeiro<\/td>\n<td>Use a vers\u00e3o declarada do pacote e a ordem de carregamento<\/td>\n<\/tr>\n<tr>\n<td>Erro de conex\u00e3o com o banco de dados<\/td>\n<td>Valor de conex\u00e3o apenas do servidor, usu\u00e1rio do banco de dados e esquema necess\u00e1rio<\/td>\n<td>Teste o acesso do servidor e compare com a documenta\u00e7\u00e3o do pacote<\/td>\n<\/tr>\n<tr>\n<td>A base funciona, mas uma chamada falha<\/td>\n<td>Compatibilidade da chamada e suas pr\u00f3prias depend\u00eancias<\/td>\n<td>Desative essa chamada e retorne \u00e0 base conhecida e funcional<\/td>\n<\/tr>\n<tr>\n<td>O cliente se conecta, mas UI ou comandos falham<\/td>\n<td>Erros F8 e arquivos de cliente ausentes no manifesto<\/td>\n<td>Verifique o manifesto de recursos e os arquivos do navegador\/NUI<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/div>\n<h2 id=\"safe-update-order\">Ordem de atualiza\u00e7\u00e3o segura<\/h2>\n<p>Fa\u00e7a backup do recurso em funcionamento e seus dados, leia as notas de lan\u00e7amento, atualize no ambiente de teste e teste novamente a base antes das chamadas opcionais. N\u00e3o sobrescreva uma configura\u00e7\u00e3o personalizada sem compar\u00e1-la. Se uma atualiza\u00e7\u00e3o alterar o banco de dados, mantenha tanto o dump pr\u00e9-atualiza\u00e7\u00e3o quanto a vers\u00e3o exata do pacote necess\u00e1ria para restaur\u00e1-lo.<\/p>\n<p>Esta sequ\u00eancia \u00e9 deliberadamente conservadora: primeiro FXServer, depois as depend\u00eancias, depois FivePD, depois uma chamada. Isso d\u00e1 a cada falha uma pequena \u00e1rea de busca e torna o rollback poss\u00edvel sem reconstruir o servidor inteiro.<\/p>","protected":false},"excerpt":{"rendered":"<p>To create a FivePD server, start with a working FXServer, download the FivePD package from a source you trust, read the package&#8217;s own installation notes, install its declared dependencies, add the resources to server.cfg , and test the base resource before adding callouts. Do not copy an old database or configuration example blindly: FivePD distributions and add-ons do not all use the same files, storage layer or dependency versions.<\/p>","protected":false},"author":1,"featured_media":148413,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[1899],"tags":[],"class_list":["post-148412","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-tutorials"],"_links":{"self":[{"href":"https:\/\/rpcrate.com\/pt\/wp-json\/wp\/v2\/posts\/148412","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/rpcrate.com\/pt\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/rpcrate.com\/pt\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/rpcrate.com\/pt\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/rpcrate.com\/pt\/wp-json\/wp\/v2\/comments?post=148412"}],"version-history":[{"count":1,"href":"https:\/\/rpcrate.com\/pt\/wp-json\/wp\/v2\/posts\/148412\/revisions"}],"predecessor-version":[{"id":214690,"href":"https:\/\/rpcrate.com\/pt\/wp-json\/wp\/v2\/posts\/148412\/revisions\/214690"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/rpcrate.com\/pt\/wp-json\/wp\/v2\/media\/148413"}],"wp:attachment":[{"href":"https:\/\/rpcrate.com\/pt\/wp-json\/wp\/v2\/media?parent=148412"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/rpcrate.com\/pt\/wp-json\/wp\/v2\/categories?post=148412"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/rpcrate.com\/pt\/wp-json\/wp\/v2\/tags?post=148412"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}