Como instalar um MLO em um servidor FiveM

O que é um FiveM MLO

MLO é o nome que a comunidade usa para um interior personalizado adicionado ao mapa do GTA V, construído do mesmo jeito que os interiores acessíveis da própria Rockstar. Os jogadores entram direto da rua, sem teleporte nem tela de carregamento.

Os MLOs são feitos por criadores de mapas, gratuitos no fórum Cfx.re ou pagos, geralmente vendidos pela Tebex. Para o FiveM, um MLO é simplesmente um resource que faz streaming de arquivos de mapa, então ele é instalado como qualquer outro mapa.

Como é um resource de MLO

Um resource de mapa é uma pasta com um manifesto e uma pasta stream com os arquivos 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 traz este manifesto para um mapa:

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

A maioria dos MLOs que você baixa já vem com os dois. Se o manifesto do criador tiver linhas a mais, como entradas data_file, deixe como está.

Instale o MLO

1. Descompacte o download e encontre a pasta que contém o fxmanifest.lua. Essa pasta é o resource; alguns downloads a colocam dentro de uma pasta extra.
2. Envie-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, no console do servidor, rode refresh para reconhecer a nova pasta e depois ensure my_mlo.
5. Vá até o local no jogo e entre. Se faltarem paredes ou você cair pelo chão, veja no console os erros desse resource.

Reiniciar o servidor por completo é a forma mais segura de carregar um novo resource de mapa.

MLOs com escrow da Tebex

Muitos MLOs pagos usam o asset escrow da Cfx.re: os arquivos são criptografados e só rodam em servidores cuja license key pertence à conta que fez a compra.

• Compre com a conta certa. A conta Cfx.re vinculada no checkout precisa ser a dona da license key do seu servidor.
• Envie todos os arquivos, inclusive o arquivo oculto .fxap. Alguns programas de FTP pulam arquivos ocultos e, sem ele, o resource falha com o erro "Failed to verify protected resource".
• "You lack the required entitlement" no console significa que a license key e a compra estão em contas diferentes. Confira a chave ou transfira a compra para a conta certa no portal Cfx.re; uma compra pode ser transferida uma vez.
• Arquivos com escrow são criptografados, então você não consegue editá-los; os criadores costumam deixar os arquivos de configuração sem criptografia para as opções que você pode alterar.

MLOs que precisam de uma game build mais nova

Alguns MLOs usam props ou interiores de uma atualização mais recente do GTA Online. Eles exigem que o servidor rode essa game build; numa mais antiga, faltam partes ou o resource não inicia. A página do criador geralmente informa a build.

Defina-a no server.cfg, por exemplo:

sv_enforceGameBuild 3407

Ela só vale quando o servidor inicia, e cada build inclui o conteúdo das anteriores, então use a build mais alta que seus MLOs exigem. O FiveM muda os jogadores para essa build quando eles entram.

Conflitos e desempenho

• Um MLO por local. Dois MLOs que substituem o mesmo prédio geralmente entram em conflito: paredes piscando, chão invisível, portas no lugar errado. Fique com apenas um ou peça aos criadores versões compatíveis.
• Fique de olho no console por assets grandes demais. O FiveM avisa sobre arquivos em streaming que usam mais de 16 MB de memória e, acima de 48 MB, informa que eles vão causar problemas de streaming, como modelos que não carregam. Prefira MLOs otimizados.
• Não instale tudo de uma vez. Adicione alguns MLOs, teste e depois adicione mais. Quando algo quebrar, você sabe qual foi.

Use só MLOs dos quais você tem os direitos

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

• use MLOs gratuitos a partir da página oficial de lançamento e MLOs pagos comprados do criador;
• nunca use cópias vazadas ou "crackeadas" de MLOs pagos: elas violam a licença do criador e, no caso das que têm escrow, nem vão rodar;
• mantenha no resource os créditos do criador e o arquivo de licença.

MLOs nos servidores FiveM da HytHost

Na hospedagem FiveM da HytHost, o txAdmin roda o seu servidor, e o seu server.cfg e a pasta resources ficam na pasta de dados do txAdmin, txData. Envie os MLOs para lá pelo gerenciador de arquivos 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 o reescreve a cada inicialização, e ele não é o que o txAdmin usa.
• Adicione você mesmo o sv_enforceGameBuild ao server.cfg do txAdmin quando um MLO precisar.
• Por padrão, o servidor atualiza para os artifacts mais recentes do FiveM a cada inicialização.

Começando no FiveM? Veja primeiro como criar um servidor FiveM.