Como criar uma shell para FiveM
Interiores personalizados estão entre os recursos mais pedidos nos servidores de roleplay FiveM. Os jogadores querem apartamentos, esconderijos de facção, delegacias e estabelecimentos que pareçam únicos. O jeito tradicional de conseguir isso é caçar packs de MLO, lidar com downloads e torcer para que funcionem com o script de housing que você usa. As shells são uma alternativa mais simples, e o Shell Creator faz com que qualquer admin de servidor consiga criá-las.
O que é uma shell no FiveM?
Uma shell é uma estrutura de interior pronta que fica fora do mundo normal do jogo. Ela é colocada em um espaço vazio, geralmente bem acima do mapa, onde não atrapalha nada. Os jogadores são teleportados para dentro dela quando entram em uma propriedade ou local.
Shells são diferentes de MLOs. Um MLO (Map Level Object) é um interior 3D personalizado inserido diretamente no mundo do jogo, em um ponto fixo do mapa. As shells são mais flexíveis porque podem ser reutilizadas. Várias propriedades podem compartilhar o mesmo layout de shell, e elas aparecem e somem de forma dinâmica, em vez de ficarem carregadas o tempo todo no mundo.
A maioria dos scripts de housing suporta shells, e muitos usam esse tipo de interior como padrão para apartamentos e propriedades.
O jeito tradicional de conseguir shells
Antes de existirem ferramentas como o Shell Creator, os admins de servidor tinham duas opções.
A primeira era baixar packs de shells prontas feitos pela comunidade. Eles vêm com layouts fixos, sem nenhuma personalização. O que você baixa é o que você leva.
A segunda era pagar um mapper para criar uma shell personalizada com ferramentas como o Blender e o plugin Sollumz. Assim você recebe exatamente o que precisa, mas leva tempo, custa dinheiro e exige que o mapper entenda o pipeline de streaming do FiveM.
Nenhuma das duas opções é muito rápida, e nenhuma permite que os admins testem e ajustem o layout por conta própria.
O que o Shell Creator faz
O Shell Creator é um editor dentro do jogo que permite aos admins criar interiores personalizados direto no servidor, sem nenhuma ferramenta externa. Todo o processo de construção acontece dentro do FiveM, em uma UI de editor.
O script vem com uma biblioteca de props para você construir:
- Uma grande variedade de texturas de piso e parede, com a opção de adicionar as suas
- Escadas, janelas e portas
- Luzes e elementos de teto
- Móveis personalizados
Todos os props somam menos de 12 MB, então os jogadores não precisam baixar arquivos grandes para ver o interior corretamente.
As shells são salvas no banco de dados em formato compactado e geradas dinamicamente quando um jogador entra em uma propriedade. Quando não tem ninguém dentro, a shell é removida. O script roda entre 0.00 e 0.01ms em idle, então não tem impacto relevante no desempenho do servidor.
O que você pode criar com ele
O Shell Creator não serve só para housing. Qualquer script que use shells ou IPLs pode apontar para uma shell criada com ele. Alguns usos comuns:
- Apartamentos e casas: compatível com qualquer script de housing que suporte shells ou IPLs
- Esconderijos de gangue e bases de facção: uma shell fixa ligada a um local, e não a uma propriedade de jogador
- Locais de emprego: oficinas mecânicas, vestiários da polícia, laboratórios de drogas, galpões
- Espaços públicos: bares, baladas, lojas, centros comunitários
- Integrações com scripts: as Grow Ops do Weed Production, da própria KuzQuality, usam o Shell Creator nos interiores dos laboratórios subterrâneos
Para scripts de housing, o Shell Creator gera o código de configuração automaticamente. Escolha o sistema de housing na lista, copie o resultado e cole na config. Os sistemas suportados estão listados na documentação em docs.kuzquality.com.
Se o seu sistema de housing não estiver na lista, ainda dá para adaptar o formato gerado manualmente.
Alguns sistemas de housing vão além. O nolag_properties, por exemplo, usa a exportação do Shell Creator diretamente para buscar a lista de shells de forma automática. Nada de copiar e colar código de config. A integração é totalmente transparente e já funciona de cara.
Sistema de teleporte integrado
O Shell Creator inclui um sistema de teleporte para os casos em que a shell não está ligada a um script de housing. Os admins podem definir pontos de entrada e saída direto no editor, e assim os jogadores acessam o interior sem nenhum script adicional. O teleporte de veículos é opcional e também configurável.
Timecycles e atmosfera
Cada shell pode receber um timecycle. Os timecycles controlam a iluminação, a correção de cor e a atmosfera geral do interior. Um apartamento arrumado pode ficar claro e moderno. Um esconderijo de gangue pode ficar escuro e sujo. O interior de uma balada pode ter um clima completamente diferente de uma delegacia, mesmo que a estrutura da shell seja parecida.
Como criar uma shell
Depois que o script está instalado, o processo é simples:
- Abra o editor do Shell Creator no jogo pelo comando ou menu configurado
- Posicione o piso, as paredes e o teto com o seletor de props
- Adicione móveis, luzes, escadas e qualquer outro elemento
- Aplique um timecycle para definir a atmosfera
- Salve a shell no banco de dados
- Copie o resultado da config de housing se estiver usando um script de housing, ou configure um teleporte para acesso standalone
Tem um vídeo completo mostrando o passo a passo aqui: Como criar uma shell para FiveM com o KQ Shell Creator
Compatibilidade com frameworks
O Shell Creator funciona em qualquer framework: ESX, QBCore, QBox, vRP, TMC e bases totalmente personalizadas. Ele usa o kq_link como ponte para o framework e as dependências.
