GUIA

Instalar um script FiveM

Os passos abaixo são os mesmos para todos os scripts que vendemos. Cada página de produto repete os que são só dela, então leia isto uma vez e o resto vai rápido.

Instalar um script FiveM

De onde vêm os arquivos

As compras são entregues pela Tebex e caem na sua conta Keymaster da Cfx.re, em Granted assets. Baixe de lá, não de um link que alguém te mandar. Um script que chega até você fora desse canal não tem entitlement ligado à sua chave de licença, ou seja, nenhuma atualização e nenhum direito a suporte.

Colocar o recurso na pasta

Copie a pasta para o seu diretório resources, mantendo o nome exatamente como veio. Esse nome é o que as chamadas exports usam, então renomear quebra toda integração que você ou outro recurso tenha. Depois adicione a linha de inicialização na config do servidor.

lua
ensure oxmysql
ensure avenida_barber

Por que a ordem importa

Inicie a camada de banco antes do script, porque o script escreve no boot. Se o seu framework subir depois de nós, o bridge tenta de novo e encontra mesmo assim, mas iniciar o oxmysql atrasado te dá um erro de SQL em vez de uma nova tentativa.

Rodar o SQL

Cada script traz um INSTALL.sql dividido em seções identificadas. A seção [A] é obrigatória e roda sempre. As seguintes são condicionais, e o cabeçalho do arquivo diz exatamente quando você precisa delas, normalmente o armazenamento de aparência para servidores que ainda não têm um.

Conferir se a instalação passou

Coloque Config.Debug = true, reinicie e leia o console. Uma linha por categoria de bridge nomeia o target escolhido. A maioria dos scripts também expõe um comando de checagem que imprime um relatório completo dentro do jogo, por exemplo /avenida_barber_check, depois que você se der a ace.

lua
add_ace group.admin avenida_barber.admin allow

O que configurar antes de abrir

Duas coisas valem ser decididas antes dos jogadores chegarem: o idioma, em Config.Locale, e os preços, que ficam no arquivo de config com o nome do script. Todo o resto tem um padrão que funciona na maioria dos servidores.

Atualizar depois

Baixe a nova versão no Keymaster e substitua a pasta, guardando os seus arquivos config/ e locales/. Esses dois diretórios ficam fora do escrow justamente para que suas alterações sobrevivam a uma atualização, e o changelog nomeia tudo que mudou de lugar.

Perguntas

Preciso reiniciar o servidor inteiro?

Não, reiniciar o recurso basta para mudanças de config e de idioma. O SQL roda só uma vez, e um reinício completo só ajuda se você mudar a ordem de inicialização dos recursos.

O script não inicia, onde olho primeiro?

No console do servidor durante a inicialização. Uma dependência faltando, um nome de pasta errado e um SQL que falhou imprimem todos uma linha ali. Coloque Config.Debug = true e reinicie para receber uma linha por categoria de bridge, o que mostra se a detecção achou o que você esperava.

Posso renomear a pasta do recurso?

Não. O nome da pasta é o que as chamadas exports usam, as nossas e as suas, então renomear quebra em silêncio todas as integrações. Se precisar de outro nome na config do servidor, use um link simbólico em vez de renomear.

Onde encontro meus arquivos depois de uma reinstalação?

Na sua conta Keymaster da Cfx.re, em Granted assets. O entitlement acompanha a conta que comprou o script, então um servidor novo ou outra máquina não mudam nada.

Scripts que usam isto

Carrinho
Spirit RP
Discord