{"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:\/\/fivemx.com\/pt\/estrutura-esx-2\/","title":{"rendered":"Guia do Framework ESX: Instala\u00e7\u00e3o Oficial, Atualiza\u00e7\u00f5es e Compatibilidade"},"content":{"rendered":"<p><strong>ESX Legacy \u00e9 um framework de roleplay open-source FiveM.<\/strong> Para um novo servidor, use o modelo oficial ESX Legacy no txAdmin ou siga a documenta\u00e7\u00e3o de instala\u00e7\u00e3o oficial completa. Instalar apenas a <code>es_extendido<\/code> pasta n\u00e3o \u00e9 uma configura\u00e7\u00e3o completa de servidor, pois o stack suportado inclui trabalho no banco de dados, recursos necess\u00e1rios e uma configura\u00e7\u00e3o de inicializa\u00e7\u00e3o ordenada.<\/p>\n<h2>Principais conclus\u00f5es<\/h2>\n<ul>\n<li>Use a receita oficial ESX Legacy do txAdmin para uma nova instala\u00e7\u00e3o.<\/li>\n<li><code>es_extendido<\/code> \u00e9 a base principal, n\u00e3o o servidor de roleplay completo.<\/li>\n<li>O caminho manual documentado inclui oxmysql, spawnmanager, SQL, exclus\u00f5es e ordem de recursos.<\/li>\n<li>Antes de uma atualiza\u00e7\u00e3o, identifique a vers\u00e3o exata ESX ou fork e fa\u00e7a backup tanto do banco de dados quanto dos recursos.<\/li>\n<li>Verifique cada script de terceiros contra o framework atual, invent\u00e1rio, biblioteca de banco de dados, eventos, exports e depend\u00eancias.<\/li>\n<\/ul>\n<h2>O que o ESX Legacy fornece<\/h2>\n<p>ESX fornece uma base de framework para dados de jogadores e personagens 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>es_extendido<\/code> estar instalado.<\/p>\n<p>O oficial <a href=\"https:\/\/github.com\/esx-framework\/esx_core\" target=\"_blank\" rel=\"noopener\">Reposit\u00f3rio principal ESX<\/a> \u00e9 a fonte correta para o c\u00f3digo principal atual. Seu <code>es_extendido<\/code> manifest declara oxmysql como uma depend\u00eancia. Use a documenta\u00e7\u00e3o oficial e o hist\u00f3rico de lan\u00e7amentos para identificar o que voc\u00ea tem; evite um pacote aleat\u00f3rio anunciado apenas como o \u00faltimo ZIP ESX.<\/p>\n<h2>Instale um novo servidor ESX com txAdmin<\/h2>\n<p>O tutorial oficial do servidor usa o deployer de receita do txAdmin embutido no FXServer. Selecione o modelo ESX Legacy e complete a configura\u00e7\u00e3o guiada atual em vez de copiar uma pasta principal para um diret\u00f3rio de recursos, caso contr\u00e1rio, 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 um novo deploy 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, permiss\u00f5es e ordem de recursos.<\/li>\n<li>Inicie o servidor de teste e verifique a cria\u00e7\u00e3o de personagens, persist\u00eancia, trabalhos, permiss\u00f5es e logs.<\/li>\n<\/ol>\n<p>Mantenha as credenciais fora de arquivos e capturas de tela compartilhados. Ap\u00f3s o deploy, registre as vers\u00f5es exatas do reposit\u00f3rio ou lan\u00e7amento para que verifica\u00e7\u00f5es de compatibilidade posteriores sejam baseadas em evid\u00eancias em vez de uma etiqueta gen\u00e9rica ESX.<\/p>\n<h2>Use o caminho de instala\u00e7\u00e3o manual apenas quando necess\u00e1rio<\/h2>\n<p>A documenta\u00e7\u00e3o oficial de instala\u00e7\u00e3o manual define o limite completo. Ela cobre os requisitos de oxmysql e spawnmanager, importando <code>legacy.sql<\/code>, o conjunto de recursos principais e adicionais, exclus\u00f5es e a ordem de inicializa\u00e7\u00e3o necess\u00e1ria. Siga essa p\u00e1gina como um \u00fanico procedimento atual. N\u00e3o reduza a mover <code>es_extendido<\/code>, editando um arquivo de configura\u00e7\u00e3o e adicionando um <code>garantir<\/code> linha.<\/p>\n<table>\n<thead>\n<tr>\n<th>\u00c1rea de instala\u00e7\u00e3o<\/th>\n<th>Evid\u00eancias para manter<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>N\u00facleo e adicionais<\/td>\n<td>Reposit\u00f3rio exato, tag ou commit 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 um backup pr\u00e9-mudan\u00e7a.<\/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>Pedido<\/td>\n<td>As garantias documentadas 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 personagens e verifica\u00e7\u00f5es de permiss\u00e3o.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h2>Atualizar 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 de banco de dados atual, as vers\u00f5es dos recursos e as modifica\u00e7\u00f5es locais. Crie um backup restaur\u00e1vel do banco de dados e um instant\u00e2neo dos recursos\/configura\u00e7\u00f5es antes de substituir qualquer coisa.<\/p>\n<p>Leia as notas de migra\u00e7\u00e3o e lan\u00e7amento entre a vers\u00e3o implantada e a vers\u00e3o alvo. Teste a atualiza\u00e7\u00e3o completa no ambiente de staging com dados de produ\u00e7\u00e3o representativos. Uma atualiza\u00e7\u00e3o do n\u00facleo pode afetar exporta\u00e7\u00f5es, eventos, dados de jogadores, tabelas de banco de dados, integra\u00e7\u00f5es de invent\u00e1rio e scripts dependentes. Valide reconex\u00f5es e reinicializa\u00e7\u00f5es, bem como um personagem novo.<\/p>\n<ol>\n<li>Compare esquemas e 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 consciente do framework quanto a exporta\u00e7\u00f5es, eventos ou identificadores alterados.<\/li>\n<li>Teste empregos, grupos e comandos permitidos e negados.<\/li>\n<li>Reveja logs de cliente, servidor e banco de dados sob a\u00e7\u00f5es representativas.<\/li>\n<li>Mantenha os arquivos anteriores e o backup do banco de dados correspondente at\u00e9 que o lan\u00e7amento seja aceito.<\/li>\n<\/ol>\n<h2>Escolha um script compat\u00edvel com ESX<\/h2>\n<p>Comece com o <a href=\"\/pt\/fivem-scripts\/\">pagos FiveM<\/a> and narrow to <a href=\"\/pt\/scripts-esx-2\/\">Scripts ESX<\/a>. An ESX product label is a starting filter. Confirm the expected ESX version or fork, database library, inventory, target or menu system, SQL changes, events, exports and permissions. Check whether the resource replaces an existing system or integrates with it. Two resources that both own inventory or character initialization can conflict even when each is individually marked ESX-compatible.<\/p>\n<p>Leia as informa\u00e7\u00f5es espec\u00edficas do produto sobre entrega, licen\u00e7a, atualiza\u00e7\u00e3o e suporte. Instale em um servidor de teste correspondente e teste caminhos de falha, incluindo pap\u00e9is n\u00e3o autorizados e eventos repetidos. Uma restri\u00e7\u00e3o vis\u00edvel UI n\u00e3o \u00e9 um substituto para valida\u00e7\u00e3o no lado do servidor.<\/p>\n<h2>ESX, QBCore ou Qbox<\/h2>\n<p>N\u00e3o h\u00e1 um framework universalmente melhor estabelecido pelas fontes oficiais. 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 da convers\u00e3o. QBCore \u00e9 um ecossistema de API e recursos separado. 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 retorno. 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 destino.<\/p>\n<h2>Pr\u00f3ximos passos seguros<\/h2>\n<ol>\n<li>Para uma nova constru\u00e7\u00e3o, comece a partir da receita oficial atual ESX Legacy txAdmin.<\/li>\n<li>Para um servidor existente, documente a vers\u00e3o exata e o fork antes de planejar uma atualiza\u00e7\u00e3o.<\/li>\n<li>Para um novo recurso, verifique todas as fronteiras de integra\u00e7\u00e3o e estagie-o com um banco de dados representativo.<\/li>\n<li>Mantenha a informa\u00e7\u00e3o do framework e os requisitos do produto comercial separados, e verifique ambos antes da compra.<\/li>\n<\/ol>\n<p><!-- fivemx-blog-content-links:2026-07-23:esx --><\/p>\n<section class=\"fivemx-content-links\" aria-labelledby=\"fivemx-esx-compare\">\n<h2 id=\"fivemx-esx-compare\">Compare ESX com os outros caminhos do framework<\/h2>\n<p>Reveja o mais amplo <a href=\"https:\/\/fivemx.com\/pt\/estruturas-fivem\/\">Compara\u00e7\u00e3o de frameworks do FiveM<\/a> antes de migrar um banco de dados existente, e use o <a href=\"https:\/\/fivemx.com\/pt\/qbcore\/\">Guia QBCore<\/a> apenas quando os scripts e o modelo de dados necess\u00e1rios justifiquem essa mudan\u00e7a.<\/p>\n<\/section>","protected":false},"excerpt":{"rendered":"<p>Aprenda o que o ESX Legacy oferece, por que novos servidores devem usar a receita oficial do txAdmin e como verificar depend\u00eancias antes de atualiza\u00e7\u00f5es ou instala\u00e7\u00f5es de scripts.<\/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:\/\/fivemx.com\/pt\/wp-json\/wp\/v2\/posts\/151194","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/fivemx.com\/pt\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/fivemx.com\/pt\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/fivemx.com\/pt\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/fivemx.com\/pt\/wp-json\/wp\/v2\/comments?post=151194"}],"version-history":[{"count":8,"href":"https:\/\/fivemx.com\/pt\/wp-json\/wp\/v2\/posts\/151194\/revisions"}],"predecessor-version":[{"id":215652,"href":"https:\/\/fivemx.com\/pt\/wp-json\/wp\/v2\/posts\/151194\/revisions\/215652"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/fivemx.com\/pt\/wp-json\/wp\/v2\/media\/151199"}],"wp:attachment":[{"href":"https:\/\/fivemx.com\/pt\/wp-json\/wp\/v2\/media?parent=151194"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/fivemx.com\/pt\/wp-json\/wp\/v2\/categories?post=151194"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/fivemx.com\/pt\/wp-json\/wp\/v2\/tags?post=151194"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}