Como instalar recursos no seu servidor RedM

Tudo o que um servidor RedM executa é um recurso: o chat, o gerenciador de spawn, um framework de roleplay e cada script por cima dele. Instalar um recurso é sempre feito nos mesmos três passos.

Onde ficam os recursos

resources/

Um recurso é uma pasta que contém um fxmanifest.lua. Muitos servidores agrupam os recursos em subpastas com nomes entre colchetes, como [core] e [scripts], que o servidor varre automaticamente.

Instale um recurso

1. No painel, abra Files e vá até resources/.
2. Envie a pasta do recurso. Não a renomeie, porque o nome da pasta é o nome do recurso.
3. Pare o servidor, edite o server.cfg e adicione:

   ensure resourcename

4. Inicie o servidor e leia o console.

A ordem de carregamento importa

Os recursos iniciam na ordem em que as linhas ensure aparecem. Um framework, um wrapper de banco de dados e qualquer biblioteca compartilhada devem vir antes dos scripts que os usam. Errar isso gera erros que parecem um script quebrado, mas na verdade são uma dependência ausente.

Uma ordem típica é:

ensure mapmanager
ensure chat
ensure spawnmanager
ensure sessionmanager-rdr3
ensure oxmysql
ensure my-framework
ensure my-jobs-script

Recursos com banco de dados

Muitos recursos de roleplay precisam de um banco de dados MySQL. Crie um na seção Bancos de dados do painel e coloque o host, o nome, o usuário e a senha dele na string de conexão que o recurso pede, normalmente uma linha set mysql_connection_string no server.cfg. Importe qualquer arquivo SQL que acompanhe o recurso antes de iniciá-lo.

Trabalhando sem reiniciar tudo

No Console do painel:

refresh
start resourcename
restart resourcename
stop resourcename

refresh faz o servidor perceber um recurso recém-enviado. restart é o que você usa depois de editar um script.

Quando um recurso falha

O console mostra o nome do recurso e o motivo. Causas comuns:

• Um fxmanifest.lua ausente, ou escrito para outra versão do Cfx.re.
• Uma dependência que não foi iniciada, nomeada no erro.
• Uma conexão de banco de dados que não foi configurada.
• Um erro de sintaxe em Lua, informado com arquivo e número de linha.

Downloads no cliente

Os arquivos que um recurso marca como do lado do cliente são baixados por todos os jogadores ao entrar. Um servidor com centenas de megabytes de assets em streaming tem uma primeira entrada muito longa, então remova os modelos que não usa antes de abrir o servidor ao público.