Como instalar um MLO num servidor FiveM

O que é um FiveM MLO

MLO é o nome que a comunidade dá a um interior personalizado adicionado ao mapa do GTA V, construído da mesma forma que os interiores acessíveis da própria Rockstar. Os jogadores entram a partir da rua sem interrupções, sem teletransporte nem ecrã de carregamento.

Os MLO são feitos por criadores de mapas, gratuitos no fórum Cfx.re ou pagos, normalmente vendidos através da Tebex. Para o FiveM, um MLO é simplesmente um recurso que faz streaming de ficheiros de mapa, por isso instala-se como qualquer outro mapa.

Como é um recurso MLO

Um recurso de mapa é uma pasta com um manifesto e uma pasta stream com os ficheiros do jogo:

my_mlo/
├── fxmanifest.lua
└── stream/
    ├── my_mlo.ymap
    ├── my_mlo.ytyp
    ├── my_mlo.ybn
    ├── my_mlo.ydr
    └── my_mlo.ytd

A documentação do FiveM indica este manifesto para um mapa:

fx_version 'cerulean'
game 'gta5'
lua54 'yes'
this_is_a_map 'yes'

A maioria dos MLO que descarrega já inclui ambos. Se o manifesto do criador tiver linhas extra, como entradas data_file, mantenha-as como estão.

Instalar o MLO

1. Descompacte a transferência e encontre a pasta que contém o fxmanifest.lua. Essa pasta é o recurso; algumas transferências colocam-na dentro de uma pasta adicional.
2. Carregue-a para a pasta resources do seu servidor, com um nome de pasta simples: sem espaços.
3. Adicione-a ao server.cfg:

   ensure my_mlo

4. Carregue-a. Reinicie o servidor ou, na consola do servidor, execute refresh para detetar a nova pasta e depois ensure my_mlo.
5. Visite o local no jogo e entre. Se faltarem paredes ou cair através do chão, procure na consola erros relativos a esse recurso.

Um reinício completo do servidor é a forma mais segura de carregar um novo recurso de mapa.

MLOs com escrow da Tebex

Muitos MLO pagos usam o asset escrow da Cfx.re: os ficheiros estão encriptados e só funcionam em servidores cuja license key pertence à conta que os comprou.

• Compre com a conta certa. A conta Cfx.re associada no pagamento tem de ser a dona da license key do seu servidor.
• Carregue todos os ficheiros, incluindo o ficheiro oculto .fxap. Alguns programas de FTP ignoram ficheiros ocultos e, sem ele, o recurso falha com o erro "Failed to verify protected resource".
• "You lack the required entitlement" na consola significa que a license key e a compra estão em contas diferentes. Verifique a chave ou transfira a compra para a conta certa no portal Cfx.re; uma compra pode ser transferida uma vez.
• Os ficheiros com escrow estão encriptados, por isso não os pode editar; os criadores costumam deixar os ficheiros de configuração sem encriptação para as definições que é suposto alterar.

MLOs que precisam de uma game build mais recente

Alguns MLO usam props ou interiores de uma atualização posterior do GTA Online. Precisam que o servidor corra essa game build; numa mais antiga, faltam partes ou o recurso recusa-se a arrancar. A página do criador costuma indicar a build.

Defina-a no server.cfg, por exemplo:

sv_enforceGameBuild 3407

Só tem efeito quando o servidor arranca, e cada build inclui o conteúdo das anteriores, por isso use a build mais alta de que os seus MLO precisam. O FiveM muda os jogadores para essa build quando entram.

Conflitos e desempenho

• Um MLO por local. Dois MLO que substituem o mesmo edifício costumam entrar em conflito: paredes a piscar, chãos invisíveis, portas no sítio errado. Fique só com um ou peça aos criadores versões compatíveis.
• Esteja atento à consola por assets demasiado grandes. O FiveM avisa sobre ficheiros em streaming que usam mais de 16 MB de memória e, acima de 48 MB, indica que vão causar problemas de streaming, como modelos que não carregam. Prefira MLO otimizados.
• Não instale tudo de uma vez. Adicione alguns MLO, teste e depois adicione mais. Quando algo falhar, saberá qual foi.

Use apenas MLOs sobre os quais tem direitos

A licença da plataforma FiveM proíbe usá-la de formas que violem os direitos de terceiros, e o fórum Cfx.re não permite publicações que infrinjam a propriedade intelectual de terceiros, como marcas reais e modelos 3D retirados de outros jogos. Na prática:

• use MLO gratuitos a partir da página oficial de lançamento e MLO pagos comprados ao criador;
• nunca use cópias divulgadas ilegalmente ou "crackeadas" de MLO pagos: violam a licença do criador e, no caso dos que têm escrow, nem sequer funcionam;
• mantenha no recurso os créditos do criador e o ficheiro de licença.

MLOs nos servidores FiveM da HytHost

No alojamento FiveM da HytHost, o txAdmin gere o seu servidor, e o seu server.cfg e a pasta resources ficam na pasta de dados do txAdmin, txData. Carregue lá os MLO com o gestor de ficheiros do painel ou por SFTP, e edite o server.cfg no editor CFG do txAdmin.

• Não mexa no server.cfg da pasta principal: o painel reescreve-o a cada arranque e não é o que o txAdmin usa.
• Adicione você mesmo sv_enforceGameBuild ao server.cfg do txAdmin quando um MLO o exigir.
• Por predefinição, o servidor atualiza para os artifacts mais recentes do FiveM a cada arranque.

É novo no FiveM? Comece por como criar um servidor FiveM.