Um negócio no FiveM geralmente precisa de duas camadas separadas: um MLO fornece o prédio, os cômodos e a colisão; um script de emprego fornece funcionários, fabricação, cobrança, estoque, vendas e gerenciamento. Comprar os dois não garante que funcionem juntos. A compatibilidade depende do framework e dos outros recursos que fazem a conexão entre eles.
Matriz rápida de compatibilidade
| Camada | O que verificar | Incompatibilidade comum |
|---|---|---|
| MLO | Coordenadas, portas, colisão e conflitos de mapa | Outro mapa altera o mesmo local |
| Framework | Suporte a ESX, QBCore, Qbox ou standalone | Um rótulo QBCore é tratado como prova de suporte ao Qbox |
| Inventário | Definições de itens, imagens, metadados e exports | O script espera uma API de inventário diferente |
| Interação | Recurso de interação, zonas, marcadores ou indicações de teclas | Os pontos de interação foram escritos para outro sistema de interação |
| Lógica do negócio | Níveis de emprego, serviço, cobrança, conta da organização e menu do chefe | Os nomes dos níveis ou os identificadores das contas não correspondem |
| Banco de dados | Alterações SQL, propriedade e persistência | As tabelas são importadas sem backup ou plano de migração |
1. Escolha o local e a jogabilidade separadamente
Comece pelo ciclo de roleplay: oficina, restaurante, cafeteria, concessionária, casa noturna ou outro negócio de jogador. Depois escolha o mapa e o script de forma independente. Um interior bem-acabado não fornece receitas ou faturas, e um script completo de emprego não move automaticamente seus pontos de interação para um prédio personalizado.
2. Leia os manifestos dos recursos e as listas de dependências
Abra cada fxmanifest.lua fornecido antes de adicionar o recurso ao server.cfg. O manifest pode identificar scripts, arquivos e dependências, enquanto a documentação do criador deve informar os recursos necessários de framework, inventário, target, menu, notificações, áudio e banco de dados. Consulte a referência oficial de manifests de recursos da Cfx.re quando uma diretiva não estiver clara.
No Qbox, não presuma que todo recurso QBCore seja compatível. Leia o guia Qbox vs QBCore e exija, no produto individual, uma declaração de suporte nativo a Qbox ou um caminho documentado de integração por ponte.
3. Instale o MLO primeiro
- Faça backup do servidor e do banco de dados e crie uma cópia de homologação.
- Inicie apenas o MLO e suas dependências de mapa documentadas.
- Confira entradas, portas, colisões, iluminação e acesso de veículos.
- Procure recursos sobrepostos de YMAP, MLO ou vegetação no mesmo local.
- Registre as coordenadas exatas de balcões de atendimento, armazenamento, fabricação, serviço e gerenciamento.
Isso separa um problema de mapa de um problema no script de emprego. Se o prédio não funciona sozinho, adicionar recursos de cobrança e inventário dificulta o diagnóstico.
4. Defina empregos, níveis e contas
Crie a estrutura de empregos e níveis esperada pelo script. Faça os nomes internos corresponderem exatamente: mechanic e mechanic2 são identificadores diferentes. Decida quais níveis podem contratar, sacar dinheiro, fabricar itens restritos ou acessar o gerenciamento. Se o script usa uma conta de organização ou empresa, verifique se depósitos e saques chegam a essa conta após reconectar e reiniciar o recurso.
5. Mapeie inventário, interações e coordenadas
Adicione todos os itens exigidos ao inventário usado no servidor, incluindo imagens e metadados quando necessários. Substitua as coordenadas padrão de interação do script pelos pontos registrados dentro do MLO. Depois verifique as zonas de interação ou indicações de teclas a diferentes distâncias e posições do jogador.
Recursos de restaurantes e bares exigem atenção extra às receitas: nomes e quantidades dos ingredientes, itens produzidos e preços de venda devem corresponder à economia em produção. Recursos de oficina exigem verificações de propriedade do veículo, itens de reparo e cobrança. Recursos de concessionária exigem spawns de exposição, estoque e validação de compra.
6. Teste a jornada completa de clientes e funcionários
- O funcionário entra em serviço e acessa apenas as ações permitidas pelo nível.
- O cliente consegue comprar, receber uma fatura ou interagir sem ter o emprego de funcionário.
- Os itens são removidos e entregues exatamente uma vez.
- A receita do negócio chega à conta correta.
- Inventários cheios, ações canceladas e dependências indisponíveis falham de forma segura.
- O estado permanece após reconexões, reinicializações do script e uma reinicialização completa do servidor.
- Dois jogadores usando a mesma estação não conseguem duplicar estoque ou recompensas.
Ordem recomendada de configuração
- Escolha o ciclo do negócio e o framework.
- Instale o MLO licenciado em um servidor de teste e comprove que não há conflito de mapa.
- Selecione um script de emprego com suporte explícito ao seu framework e conjunto de dependências.
- Adicione recursos de gerenciamento, inventário ou interação apenas quando o emprego escolhido exigir.
- Conclua os testes em homologação antes de importar a configuração para produção.
Lista de verificação final
Antes da compra, você deve conseguir identificar a versão do framework, o inventário, o sistema de interação, o recurso de gerenciamento, o método de conta do negócio, as alterações no banco de dados e o local do mapa. Se algum desses pontos for desconhecido, pergunte ao criador ou escolha um produto com documentação mais clara. Isso é mais rápido e barato do que corrigir um conjunto incompatível de sistemas de negócio após o lançamento.
Documentação de referência
Guia de compatibilidade de MLO FiveM: frameworks, conflitos e testes