Como instalar um MLO em um servidor FiveM: stream, fxmanifest, ensure

Você fez download de um pacote de mapa com arquivos como .ymap, .ytyp, .ybn e .ydr, e deseja em seu servidor. Este guia mostra o layout de pasta, o fxmanifest.lua, a linha server.cfg e uma maneira rápida de testá-lo no jogo.

#O que está dentro de um pacote de mapa

Um MLO (um interior customizado) ou um mapa é um recurso normal. Os arquivos usuais são:

• .ymap: onde os objetos e o interior se sentam no mundo.
• .ytyp: a definição do interior e de seus props customizados (seus "tipos").
• .ybn: as colisões. Sem elas você cai através do chão ou caminha através das paredes.
• .ydr e .ydd: os modelos 3D de props e peças.
• .ytd: as texturas.

Todos esses vão em uma pasta chamada stream. FiveM envia tudo em stream para os jogadores por conta própria, portanto você não lista esses arquivos no manifest.

#A estrutura de pasta

resources/[maps]/my_mlo/
  fxmanifest.lua
  stream/
    my_mlo.ymap
    my_mlo.ytyp
    my_mlo.ybn
    my_mlo_props.ydr
    my_mlo.ytd

Muitos pacotes vêm com outro nível, como my_mlo-master/my_mlo/. Mova a pasta que contém fxmanifest.lua para resources, ou o servidor não consegue encontrar o recurso.

#O fxmanifest.lua

Se o pacote vier sem um manifest, crie um:

fx_version 'cerulean'
game 'gta5'

this_is_a_map 'yes'

this_is_a_map 'yes' diz ao FiveM que o recurso contém dados de mapa. Se o pacote tem um arquivo .ytyp, adicione a linha que o registra:

fx_version 'cerulean'
game 'gta5'

this_is_a_map 'yes'

data_file 'DLC_ITYP_REQUEST' 'stream/my_mlo.ytyp'

Use uma linha data_file por arquivo .ytyp. O caminho é o caminho real na pasta, portanto verifique o nome e o caso das letras.

Dica: se o pacote já veio com um manifest, mantenha-o. O autor escreveu para esses arquivos exatos, e frequentemente lista vários arquivos .ytyp ou opções extras que você não quer adivinhar.

#Adicione-o ao server.cfg

ensure my_mlo

O nome após ensure deve ser o nome da pasta. Para iniciar um grupo inteiro, coloque os mapas em uma pasta de parênteses e use ensure [maps]. Mapas não dependem de seu framework, mas inicie-os após seus outros recursos de base para que um erro de mapa não possa bloquear os importantes. Mais sobre isso em ordem de recurso server.cfg.

Reinicie o servidor, ou digite ensure my_mlo no console ao vivo do txAdmin. Um novo .ytyp é mais confiável com um reinício completo.

#Requisito de compilação de jogo

Alguns mapas usam props ou modelos de um DLC GTA V mais novo. Na compilação de jogo padrão, esses props estão faltando: você vê salas vazias, uma caixa branca ou nenhum interior. A página do pacote geralmente diz a compilação que precisa. Defina-a em server.cfg e reinicie:

set sv_enforceGameBuild 3095

O número acima é apenas um exemplo: use o que o pacote pede. A lista completa e os efeitos colaterais estão em sv_enforceGameBuild e DLC.

#Teste-o no jogo

1. Leia o console txAdmin no início. Erros como um arquivo faltando em data_file aparecem lá. Se o recurso não iniciar, veja não foi possível iniciar recurso.
2. Junte-se ao servidor. Vá para as coordenadas no readme do pacote, com o teleporte do menu txAdmin ou um comando de coordenadas de seu script de admin.
3. Caminhe pela porta. Um interior customizado frequentemente carrega apenas quando você está perto, portanto chegue a pé e não de longe em alta velocidade.
4. Verifique o chão e as paredes. Se você cair ou passar através, os arquivos .ybn estão faltando ou não carregaram. Veja caindo através do mapa.

#Problemas comuns

• O interior não aparece. O recurso não foi iniciado, as coordenadas estão erradas, ou uma compilação de jogo mais nova é necessária. Também verifique se os arquivos estão dentro de stream e não um nível mais profundo em uma subpasta que o recurso não usa.
• Props estão faltando, mas as paredes estão lá. O .ytyp não está registrado. Adicione a linha DLC_ITYP_REQUEST, com o nome de arquivo correto.
• Parte da sala pisca ou paredes desaparecidas. Outro mapa cobre a mesma área. Veja conflitos de mapa.
• Texturas parecem erradas ou pesadas. Grandes texturas custam memória de streaming. Veja ativos supervisados.
• Funcionou, depois quebrou após uma atualização. Limpe o cache do cliente e tente novamente: limpe o cache FiveM.

#Muitos mapas em um servidor

Cada mapa adiciona arquivos em stream que cada jogador faz download e mantém na memória. Instale apenas os mapas que você usa, coloque cada um em seu próprio recurso e nomeie-o claramente. Quando algo quebrar, você poderá parar um recurso de cada vez e encontrar a causa.

#Checklist