MLO comercial FiveM + script de emprego: guia de compatibilidade e configuração

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 arquivo entregue fxmanifest.lua antes de adicionar o recurso ao server.cfg. O manifesto pode identificar scripts, arquivos e dependências, enquanto a documentação do criador deve indicar o framework, inventário, alvo, menu, notificação, áudio e recursos de banco de dados necessários. Use o oficial referência do manifesto de recursos 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

1. Faça backup do servidor e do banco de dados e crie uma cópia de homologação.
2. Inicie apenas o MLO e suas dependências de mapa documentadas.
3. Confira entradas, portas, colisões, iluminação e acesso de veículos.
4. Procure recursos sobrepostos de YMAP, MLO ou vegetação no mesmo local.
5. 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

1. Escolha o ciclo do negócio e o framework.
2. Instale o MLO licenciado em um servidor de teste e comprove que não há conflito de mapa.
3. Selecione um script de emprego com suporte explícito ao seu framework e conjunto de dependências.
4. Adicione recursos de gerenciamento, inventário ou interação apenas quando o emprego escolhido exigir.
5. 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

Fonte: docs.qbox.re

Guia de compatibilidade de MLO FiveM: frameworks, conflitos e testes