{"id":151194,"date":"2024-08-28T00:00:00","date_gmt":"2024-08-27T22:00:00","guid":{"rendered":"https:\/\/hifivem.com\/?p=151194"},"modified":"2026-08-05T21:21:50","modified_gmt":"2026-08-05T19:21:50","slug":"estrutura-esx-2","status":"publish","type":"post","link":"https:\/\/rpcrate.com\/pt\/esx-framework\/","title":{"rendered":"Guia do Framework ESX: Instala\u00e7\u00e3o Oficial, Atualiza\u00e7\u00f5es e Compatibilidade"},"content":{"rendered":"<p class=\"translation-block\"><strong>O ESX Legacy \u00e9 um framework de roleplay de c\u00f3digo aberto para FiveM.<\/strong> Para um servidor novo, use o modelo oficial ESX Legacy no txAdmin ou siga a documenta\u00e7\u00e3o oficial completa de instala\u00e7\u00e3o. Instalar apenas a pasta <code>es_extended<\/code> n\u00e3o configura um servidor completo, pois o conjunto compat\u00edvel inclui trabalho no banco de dados, recursos exigidos e uma configura\u00e7\u00e3o ordenada de inicializa\u00e7\u00e3o.<\/p>\n<h2 id=\"key-takeaways\">Principais conclus\u00f5es<\/h2>\n<ul>\n<li>Use a receita oficial do ESX Legacy no txAdmin para uma nova instala\u00e7\u00e3o.<\/li>\n<li><code data-no-translation=\"\" translate=\"no\">es_extended<\/code> \u00e9 a base fundamental, n\u00e3o o servidor de roleplay completo.<\/li>\n<li>O caminho manual documentado inclui oxmysql, spawnmanager, SQL, exclus\u00f5es e ordem dos recursos.<\/li>\n<li>Antes de uma atualiza\u00e7\u00e3o, identifique a vers\u00e3o exata do ESX ou o fork e fa\u00e7a backup do banco de dados e dos recursos.<\/li>\n<li>Verifique cada script de terceiros em rela\u00e7\u00e3o ao framework atual, ao invent\u00e1rio, \u00e0 biblioteca de banco de dados, aos eventos, aos exports e \u00e0s depend\u00eancias.<\/li>\n<\/ul>\n<h2 id=\"what-esx-legacy-provides\">O que o ESX Legacy oferece<\/h2>\n<p>O ESX fornece uma base de framework para dados de jogador e personagem e para recursos que se integram com suas APIs e conven\u00e7\u00f5es. Trabalhos, invent\u00e1rio, moradia, bancos, telefones e outros sistemas de gameplay s\u00e3o recursos separados ou partes de uma receita selecionada. Sua presen\u00e7a e comportamento dependem do stack real, n\u00e3o apenas do fato de <code data-no-translation=\"\" translate=\"no\">es_extended<\/code> estar instalado.<\/p>\n<p class=\"translation-block\">O <a href=\"https:\/\/github.com\/esx-framework\/esx_core\">reposit\u00f3rio oficial do core do ESX<\/a> \u00e9 a fonte correta do c\u00f3digo atual do core. Seu manifesto de <code>es_extended<\/code> declara oxmysql como depend\u00eancia. Use a documenta\u00e7\u00e3o oficial e o hist\u00f3rico de vers\u00f5es para identificar o que voc\u00ea tem; evite pacotes aleat\u00f3rios anunciados apenas como o ZIP mais recente do ESX.<\/p>\n<h2 id=\"install-a-new-esx-server-with-txadmin\">Instale um novo servidor ESX com txAdmin<\/h2>\n<p>O tutorial oficial do servidor usa o implantador de receitas txAdmin inclu\u00eddo no FXServer. Selecione o modelo ESX Legacy e conclua a configura\u00e7\u00e3o guiada atual, em vez de copiar uma pasta do n\u00facleo para um diret\u00f3rio resources vazio.<\/p>\n<ol>\n<li>Prepare um ambiente FXServer atual e abra o fluxo de configura\u00e7\u00e3o do txAdmin.<\/li>\n<li>Crie uma nova implanta\u00e7\u00e3o de receita usando o modelo oficial ESX Legacy.<\/li>\n<li>Forne\u00e7a a chave do servidor e as configura\u00e7\u00f5es do banco de dados documentadas.<\/li>\n<li>Permita que a receita implante o banco de dados e os recursos necess\u00e1rios.<\/li>\n<li>Revise a configura\u00e7\u00e3o gerada, as permiss\u00f5es e a ordem dos recursos.<\/li>\n<li>Inicie o servidor de teste e verifique a cria\u00e7\u00e3o de personagens, a persist\u00eancia, os trabalhos, as permiss\u00f5es e os logs.<\/li>\n<\/ol>\n<p>Mantenha as credenciais fora de arquivos e capturas de tela compartilhados. Ap\u00f3s a implanta\u00e7\u00e3o, registre as vers\u00f5es exatas do reposit\u00f3rio ou do lan\u00e7amento para que as verifica\u00e7\u00f5es de compatibilidade posteriores sejam baseadas em evid\u00eancias, e n\u00e3o em um r\u00f3tulo gen\u00e9rico ESX.<\/p>\n<h2 id=\"use-the-manual-installation-path-only-when-necessary\">Use o caminho de instala\u00e7\u00e3o manual apenas quando necess\u00e1rio<\/h2>\n<p class=\"translation-block\">A documenta\u00e7\u00e3o oficial de instala\u00e7\u00e3o manual define o escopo completo. Ela aborda os requisitos de oxmysql e spawnmanager, a importa\u00e7\u00e3o de <code>legacy.sql<\/code>, o conjunto de recursos centrais e adicionais, as exclus\u00f5es e a ordem exigida de inicializa\u00e7\u00e3o. Siga essa p\u00e1gina como um \u00fanico procedimento atual. N\u00e3o reduza o processo a mover <code>es_extended<\/code>, editar um arquivo de configura\u00e7\u00e3o e adicionar uma linha <code>ensure<\/code>.<\/p>\n<div aria-label=\"Tabela com rolagem horizontal\" class=\"fmx-guide-table\" role=\"region\" tabindex=\"0\">\n<table>\n<thead>\n<tr>\n<th>\u00c1rea de instala\u00e7\u00e3o<\/th>\n<th>Evid\u00eancias a manter<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>N\u00facleo e complementos<\/td>\n<td>Reposit\u00f3rio, tag ou commit exatos para cada recurso ESX.<\/td>\n<\/tr>\n<tr>\n<td>Banco de dados<\/td>\n<td>Configura\u00e7\u00e3o de conex\u00e3o, SQL importado e backup pr\u00e9-altera\u00e7\u00e3o.<\/td>\n<\/tr>\n<tr>\n<td>Depend\u00eancias<\/td>\n<td>oxmysql, spawnmanager e quaisquer bibliotecas espec\u00edficas do recurso.<\/td>\n<\/tr>\n<tr>\n<td>Ordem<\/td>\n<td>Os comandos ensure documentados e quaisquer exclus\u00f5es deliberadas.<\/td>\n<\/tr>\n<tr>\n<td>Verifica\u00e7\u00e3o<\/td>\n<td>Logs de inicializa\u00e7\u00e3o, persist\u00eancia de personagem e verifica\u00e7\u00f5es de permiss\u00e3o.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/div>\n<h2 id=\"update-an-existing-esx-server-safely\">Atualize um servidor ESX existente com seguran\u00e7a<\/h2>\n<p>Primeiro, identifique se o servidor executa o ESX Legacy atual, uma vers\u00e3o mais antiga ou um fork com altera\u00e7\u00f5es personalizadas no n\u00facleo. Registre o esquema atual do banco de dados, as vers\u00f5es dos recursos e as modifica\u00e7\u00f5es locais. Crie um backup restaur\u00e1vel do banco de dados e um snapshot de recursos\/configura\u00e7\u00e3o antes de substituir qualquer coisa.<\/p>\n<p>Leia as notas de migra\u00e7\u00e3o e de lan\u00e7amento entre a vers\u00e3o implantada e a vers\u00e3o alvo. Teste a atualiza\u00e7\u00e3o completa em ambiente de staging com dados de produ\u00e7\u00e3o representativos. Uma atualiza\u00e7\u00e3o do n\u00facleo pode afetar exports, eventos, dados do jogador, tabelas do banco de dados, integra\u00e7\u00f5es de invent\u00e1rio e scripts dependentes. Valide reconex\u00f5es e reinicializa\u00e7\u00f5es, bem como um novo personagem.<\/p>\n<ol>\n<li>Compare os esquemas e as migra\u00e7\u00f5es SQL antes de import\u00e1-los.<\/li>\n<li>Resolva altera\u00e7\u00f5es personalizadas no n\u00facleo explicitamente, em vez de sobrescrev\u00ea-las silenciosamente.<\/li>\n<li>Verifique cada recurso integrado ao framework em busca de exports, eventos ou identificadores alterados.<\/li>\n<li>Teste trabalhos, grupos e comandos permitidos e negados.<\/li>\n<li>Revise os logs de cliente, servidor e banco de dados em a\u00e7\u00f5es representativas.<\/li>\n<li>Mantenha os arquivos anteriores e o backup do banco de dados correspondente at\u00e9 que a implanta\u00e7\u00e3o seja aceita.<\/li>\n<\/ol>\n<h2 id=\"choose-an-esx-compatible-script\">Escolha um script compat\u00edvel com ESX<\/h2>\n<p>Leia as informa\u00e7\u00f5es de entrega, licen\u00e7a, atualiza\u00e7\u00e3o e suporte espec\u00edficas do produto. Instale em um servidor de teste correspondente e teste os caminhos de falha, incluindo pap\u00e9is n\u00e3o autorizados e eventos repetidos. Uma restri\u00e7\u00e3o de UI vis\u00edvel n\u00e3o substitui a valida\u00e7\u00e3o do lado do servidor.<\/p>\n<h2 id=\"esx-qbcore-or-qbox\">ESX, QBCore ou Qbox<\/h2>\n<p>N\u00e3o h\u00e1 um framework universalmente melhor estabelecido pelas fontes oficiais. O ESX \u00e9 frequentemente a escolha de menor risco quando os dados de produ\u00e7\u00e3o existentes, scripts e procedimentos da equipe j\u00e1 dependem do ESX e nenhum benef\u00edcio de migra\u00e7\u00e3o testado supera o custo de convers\u00e3o. O QBCore \u00e9 um ecossistema de API e recursos separado. O Qbox tem uma ponte QB documentada, mas isso n\u00e3o torna os recursos espec\u00edficos do ESX automaticamente port\u00e1teis.<\/p>\n<p>Use uma compara\u00e7\u00e3o de frameworks baseada em recursos necess\u00e1rios, conhecimento da equipe, migra\u00e7\u00e3o de dados, documenta\u00e7\u00e3o atual e capacidade de rollback. Ao considerar uma mudan\u00e7a, inventarie identidades, dinheiro, empregos, invent\u00e1rio, ve\u00edculos, moradia, telefones, bancos, permiss\u00f5es e eventos personalizados antes de escolher um alvo.<\/p>","protected":false},"excerpt":{"rendered":"<p class=\"translation-block\"><strong>O ESX Legacy \u00e9 um framework de roleplay de c\u00f3digo aberto para FiveM.<\/strong> Para um servidor novo, use o modelo oficial ESX Legacy no txAdmin ou siga a documenta\u00e7\u00e3o oficial completa de instala\u00e7\u00e3o. Instalar apenas a pasta <code>es_extended<\/code> n\u00e3o configura um servidor completo, pois o conjunto compat\u00edvel inclui trabalho no banco de dados, recursos exigidos e uma configura\u00e7\u00e3o ordenada de inicializa\u00e7\u00e3o.<\/p>","protected":false},"author":1,"featured_media":151199,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[2347],"tags":[2858,2950],"class_list":["post-151194","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-frameworks","tag-esx","tag-framework"],"_links":{"self":[{"href":"https:\/\/rpcrate.com\/pt\/wp-json\/wp\/v2\/posts\/151194","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=151194"}],"version-history":[{"count":8,"href":"https:\/\/rpcrate.com\/pt\/wp-json\/wp\/v2\/posts\/151194\/revisions"}],"predecessor-version":[{"id":215652,"href":"https:\/\/rpcrate.com\/pt\/wp-json\/wp\/v2\/posts\/151194\/revisions\/215652"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/rpcrate.com\/pt\/wp-json\/wp\/v2\/media\/151199"}],"wp:attachment":[{"href":"https:\/\/rpcrate.com\/pt\/wp-json\/wp\/v2\/media?parent=151194"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/rpcrate.com\/pt\/wp-json\/wp\/v2\/categories?post=151194"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/rpcrate.com\/pt\/wp-json\/wp\/v2\/tags?post=151194"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}