Como instalar scripts no FiveM passo a passo

Instalar um script no FiveM é simples se seguires a ordem certa. Este guia serve para a maioria dos recursos pagos. Se o teu script tiver passos próprios, consulta sempre a respetiva documentação.

Antes de começar

Faz uma cópia de segurança da tua base de dados e da pasta resources.
Verifica o framework. Confirma que o script é compatível com o teu (ESX, QBCore ou QBox).
Revê as dependências. Muitos scripts precisam de outros recursos, como o oxmysql, e estes têm de arrancar primeiro.
Testa num servidor de desenvolvimento se puderes, e não diretamente com jogadores ligados.

1. Descarrega o recurso

Os recursos comprados são entregues no portal da Cfx.re, na conta FiveM com que fizeste a compra:

Entra em portal.cfx.re com essa conta.
Abre Granted Assets.
Procura o produto e descarrega-o.

Se o teu recurso usar FiveM Escrow, o teu servidor tem de usar uma chave de licença dessa mesma conta. Caso contrário, o recurso não arranca.

2. Copia a pasta

Descomprime o ficheiro e copia a pasta para dentro de resources. Não mudes o nome da pasta, a não ser que a documentação o permita: muitos scripts dependem dele.

text

server-data/
└── resources/
    └── [origen]/
        └── origen_ejemplo/

3. Importa a base de dados

Se o script incluir um ficheiro .sql, importa-o para a tua base de dados antes de o arrancares, com o HeidiSQL, o phpMyAdmin ou o programa que usares.

4. Adiciona-o ao server.cfg

Adiciona uma linha ensure com o nome da pasta. A ordem importa: primeiro as dependências e depois o script.

cfg

ensure oxmysql
ensure origen_ejemplo

5. Configura e reinicia

Abre os ficheiros de configuração (normalmente config.lua), ajusta o que for preciso e reinicia o servidor. Depois vê a consola: é aí que aparece qualquer erro.

Erros habituais

Erro	Causa provável	O que fazer
O recurso não arranca	Pasta no sítio errado ou com outro nome	Revê o caminho e o `ensure`
Erro de dependência	Falta um recurso ou arranca mais tarde	Instala-o e coloca-o antes no `server.cfg`
Erro de Escrow	A licença é de outra conta	Usa uma chave da conta que tem o recurso
Erro de SQL	Falta importar a base de dados	Importa o `.sql` e reinicia

Precisas de ajuda?

Cada script tem o seu guia na documentação. Se ficares bloqueado, fala connosco no nosso Discord. E se ainda estás a escolher, vê os scripts por framework e categoria.