Como adicionar um FiveM MLO ao seu servidor

Público: Proprietários e desenvolvedores de servidores que já operam uma instância FiveM funcional e desejam estendê-la com ativos de mapa interno/externo (MLOs) personalizados.

1 · Pré-requisitos

Exigência	Versão mínima	Por que isso importa
Artefato do servidor FiveM	6016 (build 7116) ou mais recente	Artefatos mais antigos não podem carregar artefatos modernos `cerúleo` manifestos fx.
Carregador de mapas (já integrado)	Nativo por padrão	Nenhum plugin extra é necessário—O FiveM transmite arquivos de mapas automaticamente.
Acesso ao servidor	SFTP/SSH + permissões de gravação	Você deve fazer upload dos arquivos e editá-los servidor.cfg.
Licença legal	Comprovante de compra / termos de uso gratuito	O GDPR da UE e a política da Rockstar proíbem a distribuição de ativos não licenciados.

2 · Baixe e inspecione o pacote MLO

Integridade da fonte – Prefira fornecedores com zips assinados por SHA-256 ou tags públicas do Git.
Verificar estrutura – Um recurso compatível se assemelha a:

my-mlo/
 ├─ stream/
 │ ├─ *.ydr ↰ (modelos)
 │ ├─ *.ytyp ↰ (definições de item)
 │ ├─ *.ybn ↰ (colisões ― se fornecidas)
 │ └─ *.ytd ↰ (texturas)
 ├─ fxmanifest.lua
 └─ README.md (opcional)

Criar fxmanifest.lua se estiver faltando – Modelo mínimo:

fx_version 'cerulean'
games { 'gta5' }

author 'SeuNome'
description 'Meu MLO Personalizado'
version '1.0.0'

this_is_a_map 'yes'

files {
 'stream/**/*.ydr',
 'stream/**/*.ytyp',
 'stream/**/*.ytd',
 'stream/**/*.ybn'
}

data_file 'DLC_ITYP_REQUEST' 'stream/**/*.ytyp'

ℹ️ Os manifestos de recursos de padrões seguem o esquema em Documentação FiveM → “Manifesto de recursos” (commit 20b7b15, 2025‑03‑11)

3 · Carregar o recurso

Conecte-se via SFTP à raiz do seu servidor.
Navegar para /recursos/[mapas]/—crie a pasta de colchetes se ela não existir.
Carregar o inteiro meu-mlo diretório inalterado. Evite espaços e letras maiúsculas em nomes de pastas para evitar problemas de caminho no Linux.

4 · Cadastre-se em `servidor.cfg`

Adicionar (ou substituir começar) depois recursos básicos essenciais:

certifique-se de que my-mlo # carregue na inicialização; reinicia automaticamente em soft‑restarts do txAdmin

Salve o arquivo e reiniciar o servidor ou executar atualizar ➜ garantir meu-mlo no console ao vivo.

5 · Limpar cache e reiniciar (se necessário)

O FiveM armazena em cache os dados do mapa. Para evitar fantasmas de versões mais antigas:

# Linux
rm -rf cache/*
./run.sh +exec server.cfg

# Windows (PowerShell)
Remove-Item -Recurse -Force .cache*
run.cmd +exec server.cfg

Como limpar o cache dos servidores FiveM

6 · Lista de verificação no jogo

Verificar	Comando/ferramenta	Critérios de aprovação
Teletransporte	vMenu → Diversos → Teletransporte → Inserir Coordenadas	O jogador surge no novo interior/exterior.
Integridade da textura	`quadro_de_perfil` então ande por aí	Sem marcadores rosa/branco; perda de FPS < 10%.
Colisão	Paredes de caminhada e rampas	Sem barreiras invisíveis ou quedas no chão.
Iluminação	Mudança de ciclo de tempo com `/tempo 23 0`	O interior escurece/clareia corretamente sem artefatos.

Se ocorrer alguma falha, revisite a lista de arquivos ausentes .YTD ou .ybn é o culpado de sempre.

7 · Transmissão segura de vários MLOs

Um recurso por MLO. Isso evita colisões de hash.
Nomes de prefixo com tag de fornecedor, por exemplo lobby do banco bh, para facilitar a desativação.
Use a mesma versão do manifesto em todos os recursos do mapa para evitar avisos de análise.

8 · Solução de problemas de referência rápida

Sintoma	Causa provável	Resolução
Console: Não foi possível analisar o manifesto	Sintaxe Lua ruim	Correr `lua -p fxmanifest.lua` localmente; corrigir aspas/vírgulas.
MLO visível, texturas ausentes	`.YTD` arquivos não referenciados	Adicione-os a `arquivos{}` ou colocar em `fluxo/`.
Jogadores travam ao entrar	Duplicar hash de prop em todos os mapas	Renomear duplicado `.jardas` ou descarregar recursos conflitantes.
Longo tempo de download	Grande `.YTD` texturas	Comprimir texturas (DXT5 / BC3) ou reduzir a escala.

9 · Notas sobre conformidade e proteção de dados

Regulamento / Política	O que você deve fazer
Política de Modificação da Rockstar (15/09/2015)	Não venda ativos que contenham propriedade intelectual da Rockstar.
RGPD da UE, Art. 44-49	Armazene faturas de fornecedores; divulgue a origem dos ativos mediante solicitação do usuário.
FiveM ToS §3.2	Mantenha os créditos intactos; não redistribua mods pagos publicamente.

Conclusão

Carregar → garantir → reiniciar; se o manifesto for válido, seu novo interior estará ativo em dois minutos.

Precisa de novos MLOs?

Fontes

FiveM Docs – Manifestos de Recursos (acessado em 22 de maio de 2025)
Rockstar Games – Política de Modificação, 15 de setembro de 2015
Regulamento (UE) 2016/679 (RGPD), artigos 44.º a 49.º

Lista de verificação prática

Use este guia como uma lista de verificação antes de alterar um servidor FiveM em produção. Confirme a versão atual do artefato do servidor, a versão do framework, as dependências de recursos, as alterações no banco de dados e quaisquer arquivos do lado do cliente antes de aplicar a alteração.

Faça backup dos arquivos de configuração e tabelas do banco de dados afetados.
Aplique a alteração primeiro em um servidor de teste.
Observe o console do servidor e o console F8 do cliente em busca de erros.
Verifique se a alteração afeta empregos, inventário, veículos, mapas, voz, permissões ou dados do jogador.
Documente o arquivo, comando ou configuração exata que você alterou para que possa ser revertida rapidamente.

Testes antes da produção

Após o primeiro teste, entre com uma conta de jogador normal e repita o fluxo da perspectiva do jogador. Se o tópico envolver desempenho, meça o antes e o depois com a mesma quantidade de jogadores, rota e conjunto de recursos. Se envolver ferramentas ou permissões de administrador, verifique os usuários permitidos e os bloqueados.

Erros comuns

A maioria dos problemas do FiveM decorre de dependências ausentes, cache desatualizado, nomes de pastas incorretos, incompatibilidade de frameworks ou configurações copiadas de outro servidor. Evite alterar vários sistemas ao mesmo tempo; faça uma alteração por vez, teste-a e só então continue.

Recursos relacionados

Para ativos prontos para produção, compare os recursos pagos no Loja FiveMX. Para recursos gratuitos, navegue. Scripts gratuitos para FiveM e testar cada recurso antes de utilizá-lo publicamente.

Notas sobre o lançamento da produção

Antes de usar esta orientação em um servidor FiveM ativo, defina o resultado exato que você espera da alteração. Para How to Add a FiveM MLO to Your Server, isso significa verificar qual recurso, configuração, comando ou fluxo de trabalho é afetado e confirmar que a alteração se adequa ao seu framework atual, versão do artifact e regras do servidor. Mantenha a implementação pequena o suficiente para que você possa revertê-la rapidamente se os jogadores relatarem erros.

Utilize um servidor de testes com a mesma estrutura, esquema de banco de dados, ordem de recursos e principais dependências do servidor de produção. Se o tópico alterar a jogabilidade, permissões, visuais, voz, veículos, mapas, inventário ou comportamento da economia, teste com pelo menos uma conta de administrador e uma conta de jogador normal. Observe a saída do console do servidor, os logs do cliente (F8) e o tempo de uso dos recursos enquanto repete o fluxo exato de jogadores que ocorrerá no servidor de produção.

Lista de verificação de reversão

Salve o arquivo de configuração anterior, a pasta de recursos e o estado do banco de dados antes de fazer qualquer alteração.
Registre a versão do recurso, o commit, a página de download ou o valor da configuração que você testou.
Reinicie primeiro apenas o recurso afetado, se possível, e só reinicie o servidor completo se as dependências assim o exigirem.
Caso ocorram erros, reverta a alteração feita no recurso ou na configuração antes de testar outra correção.

Guia de manutenção

Revise esta configuração novamente após atualizações de artefatos do FiveM, atualizações do framework ou alterações importantes nos recursos. Uma configuração que funciona hoje pode parar de funcionar após atualizações de dependências, renomeação de exportações, alteração de eventos ou migrações de banco de dados. Mantenha anotações junto com a documentação do seu servidor para que os futuros administradores entendam o que foi alterado, por que foi alterado e como verificar novamente.

Revisão em andamento

Reveja How to Add a FiveM MLO to Your Server após grandes atualizações de artifact do FiveM, mudanças de framework ou migrações de recursos. Confirme se o conselho ainda corresponde ao comportamento atual do servidor, se qualquer fonte vinculada permanece disponível e se as etapas de instalação ainda correspondem aos arquivos que um proprietário de servidor realmente baixará ou configurará.

Para servidores públicos, mantenha um breve registro de alterações junto à documentação do servidor. Anote o que foi testado, o que foi alterado, quais contas foram usadas para verificação e como reverter as alterações. Isso agiliza a manutenção futura e evita que anotações antigas de configuração se tornem confusas ou inseguras para os jogadores.