Packs de roupas FiveM: roupas addon, EUP e como os packs funcionam

Um pack de roupas para FiveM é um resource que faz stream de roupas, fardas e acessórios novos para todos os players do seu servidor. Ninguém precisa instalar nada: o player entra, baixa o pack e vê as roupas no seu menu de roupas. Bem feito, é um dos jeitos mais baratos de dar cara própria ao servidor. Mal feito, é o motivo de o seu server levar cinco minutos para carregar e metade dos players nascer sem calça.

Este guia mostra como os packs de roupas funcionam de verdade: addon vs replace, o que é EUP, quais arquivos importam, como um pack é estruturado, os limites que você vai bater e como resolver os problemas que todo mundo enfrenta.

Resumindo: use roupas addon, não replace. Um pack é um resource com uma pasta stream/ cheia de modelos .ydd e texturas .ytd, um .ymt por gênero e um arquivo meta de loja registrado com data_file 'SHOP_PED_APPAREL_META_FILE'. Monte com um cloth tool em vez de renomear arquivo na mão, mantenha as texturas num tamanho razoável e junte vários packs pequenos em um só por gênero.

Roupas addon vs replace

Existem dois jeitos de colocar roupas novas no jogo.

Roupa replace é só um arquivo com o nome exato de um drawable do jogo, com o prefixo da DLC de onde ele vem e um ^. Joga numa pasta stream/ e o item vanilla é trocado. É rápido, mas todo outfit, farda de emprego e personagem salvo que usa aquele item muda junto.

Roupa addon registra uma "DLC" nova para um ped freemode. O jogo adiciona seus itens depois dos vanilla, então nada que já existe quebra. É o que praticamente todo servidor sério usa.

O que é EUP

EUP (Emergency Uniforms Pack) é uma coleção grande de fardas de polícia, bombeiro, SAMU/EMS e outros serviços de emergência feitas para os personagens multiplayer freemode. Começou na cena de mods de single player e virou o jeito padrão de os servidores de roleplay vestirem suas corporações.

A versão de FiveM de longa data fica no fórum da Cfx.re e é instalada como três resources:

ensure NativeUI
ensure eup-stream
ensure eup-ui

• eup-stream guarda os modelos e as texturas.
• eup-ui adiciona um menu /eup para escolher as fardas.
• NativeUI é a biblioteca de menus da qual o eup-ui depende, então ela precisa iniciar primeiro.

A versão server-side do EUP tem ficado atrelada a uma assinatura paga da Cfx.re (Element Club, antigo Patreon). Confira os requisitos atuais nesse tópico do fórum antes de planejar em cima disso.

"EUP" também é usado de forma genérica para qualquer pack de fardas de emergência no mesmo estilo. Muitas corporações encomendam EUP custom: distintivos, patches e nomes da corporação em cima dos modelos base do EUP. Na maioria dos servidores com framework, essas fardas acabam no menu de roupas normal ou num sistema de outfits por emprego, e não no menu /eup separado.

Os tipos de arquivo de um pack de roupas

Se você já leu formatos de arquivo do GTA V para FiveM, a maioria vai parecer familiar.

Components vs props

O GTA V divide as roupas em dois sistemas, e colocar um item no errado é um erro clássico.

Components são os 12 slots do corpo que sempre existem num ped:

Props são itens opcionais presos a pontos de ancoragem: bonés e chapéus (p_head), óculos (p_eyes), brincos (p_ears), relógios (p_lwrist) e pulseiras (p_rwrist). Props podem ser tirados separadamente, por isso dá para tirar boné e óculos sem mudar o outfit.

Peds freemode masculino e feminino

Os personagens dos players em quase todo servidor de FiveM usam dois modelos de ped: mp_m_freemode_01 (masculino) e mp_f_freemode_01 (feminino). Eles têm esqueletos e corpos diferentes, então uma peça feita para um não serve no outro. Uma jaqueta de um pack "unissex" na verdade são dois drawables separados, um por ped.

Isso também quer dizer que todo pack tem duas metades, cada uma com seu próprio .ymt e meta de loja. Se um pack só vem com arquivos masculinos, suas players mulheres ficam sem nada.

Como um pack faz stream por um resource

Um pack addon típico fica assim:

As regras de nome que importam:

• O nome completo da DLC é o nome do ped mais o nome do seu pack: mp_m_freemode_01_my_clothing. Tudo em minúsculo.
• Tudo antes do ^ diz a qual DLC o arquivo pertence. Tudo depois é o nome do drawable ou da textura.
• Props usam uma variação p_ do nome da DLC (mp_m_freemode_01_p_my_clothing).
• Os números começam em 000 e precisam bater com o que o .ymt descreve. Um buraco ou erro de digitação e o item não carrega.

O arquivo meta de loja diz ao jogo a qual ped o pack pertence:

<?xml version="1.0" encoding="UTF-8"?>
<ShopPedApparel>
  <pedName>mp_m_freemode_01</pedName>
  <dlcName>my_clothing</dlcName>
  <fullDlcName>mp_m_freemode_01_my_clothing</fullDlcName>
  <eCharacter>SCR_CHAR_MULTIPLAYER</eCharacter>
  <creatureMetaData>MP_CreatureMetadata_my_clothing</creatureMetaData>
  <pedOutfits></pedOutfits>
  <pedComponents></pedComponents>
  <pedProps></pedProps>
</ShopPedApparel>

A versão feminina usa mp_f_freemode_01 e SCR_CHAR_MULTIPLAYER_F. Depois registre os dois no fxmanifest.lua:

fx_version 'cerulean'
game 'gta5'

files {
  'mp_m_freemode_01_my_clothing.meta',
  'mp_f_freemode_01_my_clothing.meta',
}

data_file 'SHOP_PED_APPAREL_META_FILE' 'mp_m_freemode_01_my_clothing.meta'
data_file 'SHOP_PED_APPAREL_META_FILE' 'mp_f_freemode_01_my_clothing.meta'

Adicione ensure my_clothing no server.cfg e reinicie o servidor. Um restart completo é mais seguro para carregar um pack de roupas novo do que iniciar ele com o server rodando e players conectados.

Montando um pack: use uma ferramenta

Dá para escrever os .ymt e renomear centenas de arquivos na mão, mas quem fez isso uma vez não faz de novo. Duas ferramentas fazem o trabalho pesado:

• Durty Cloth Tool (gta.clothing). O padrão de longa data. Você arrasta drawables e texturas, define slots e gêneros, vê o preview em 3D e exporta um resource de FiveM pronto para rodar, com .ymt, meta e manifest gerados. É software pago com licença; a versão open source antiga no GitHub não é atualizada desde 2021.
• Vestium. Um builder de roupas addon mais novo e gratuito, com preview 3D, otimização de texturas e geração de metadata para FiveM.

As duas também cuidam dos detalhes fáceis de errar na mão: salto alto, bonés que escondem o cabelo e variações de primeira pessoa.

A modelagem das roupas em si é feita no Blender (com um plugin de import/export de GTA V como o Sollumz) ou no 3ds Max. O cloth tool só empacota drawables prontos.

Criando texturas

A maior parte das roupas custom nem tem geometria nova. É um modelo vanilla ou de EUP com uma textura nova: o logo de uma facção num moletom, o patch de uma corporação, uma camiseta de uma marca do server. Esse trabalho é feito num editor de imagem. Se você precisa de arte para essas texturas, o gerador de imagens da BLDR cria logo, patch ou estampa a partir de um prompt de texto ou edita uma imagem que você já tem.

Limites e tempo de carregamento

Roupa é onde muitos servidores batem nos limites da engine sem perceber.

• Drawables por slot. O .ymt de cada pack tem um teto de itens por tipo de component, por gênero. O limite clássico é 128 por slot; ferramentas mais novas documentam limites estendidos em builds recentes. Passar do limite causa crash, não só item faltando.
• Quantidade de YMT. O jogo só permite um certo número de DLCs de roupa por gênero, e as DLCs vanilla já ocupam boa parte. Dez packs pequenos de dez criadores diferentes gastam dez slots. Junte tudo em um pack por gênero com o seu cloth tool.
• Pool de texturas. Texturas demais em stream ao mesmo tempo enchem o pool de texture dictionaries do jogo, e isso aparece como crash TxdStore Pool Full ou textura que não carrega.

Além disso, todo player baixa as roupas antes de conseguir entrar. Uma pasta de roupas de 4 GB são 4 GB que todo player novo espera, e eles ficam no cache disputando memória com seus carros e mapas.

Tamanho das texturas

Texturas grandes demais são o maior desperdício na maioria dos packs de roupas. O FXServer mostra avisos de assets grandes demais (oversized) na inicialização; leve a sério.

• Ajuste a resolução da textura ao espaço que a peça ocupa na tela. Um par de meias não precisa da mesma resolução que uma jaqueta inteira.
• Use as opções de otimização do cloth tool para reduzir e comprimir numa passada só.
• Remova as variações de textura que ninguém usa. Vinte cores de uma mesma camiseta são vinte texturas para baixar.

Otimizando assets no FiveM explica compressão de texturas com mais detalhe; as mesmas regras valem para carros, props e MLOs.

Como os players pegam as roupas novas

Depois que o pack está em stream, os itens existem, mas os players ainda precisam de um menu para escolher. Isso vem do seu resource de aparência:

• illenium-appearance suporta QBCore e ESX (e ox_core em modo experimental), com lojas de roupa, outfits salvos e fardas travadas por emprego.
• fivem-appearance é o resource original em que o illenium-appearance foi baseado, e muitos forks ainda estão em uso.
• Os padrões do framework, como qb-clothing ou esx_skin, fazem o mesmo com menos recursos.

Itens addon aparecem depois dos vanilla em cada slot, então uma jaqueta nova pode ser o "top #392". A maioria dos resources de aparência deixa restringir components por emprego, facção ou grupo de permissão. Use isso para manter as fardas da polícia fora das lojas civis. Outfits salvos guardam números, não nomes, então se depois você reordenar ou remover itens de um pack, muda o que os players veem.

Problemas comuns e soluções

Perguntas frequentes

O que é um pack de roupas de FiveM?

Um resource que faz stream de modelos e texturas de roupas novos para os players, junto com a metadata que diz ao jogo a qual personagem e slot cada item pertence. Os players baixam automaticamente ao entrar.

O EUP é de graça no FiveM?

Não totalmente. A versão server-side oficial para FiveM tem ficado atrelada a uma assinatura paga da Cfx.re. Confira o tópico oficial no fórum para ver as condições atuais, e só use fardas EUP custom que você tenha permissão para usar.

Uso roupas addon ou replace?

Addon. Replace sobrescreve itens vanilla para todo mundo e quebra os outfits que usavam esses itens. Use replace só para teste rápido.

Por que meu servidor de FiveM demora tanto para carregar as roupas?

Normalmente é textura grande demais e packs separados demais. Reduza as texturas, remova variações sem uso e junte os packs em um por gênero. Se você também faz stream de props ou interiores custom, veja props custom no FiveM e MLOs no FiveM, que seguem os mesmos princípios.

Dá para fazer tatuagem do mesmo jeito?

Não. Tatuagens são overlays, não drawables de roupa, e usam um sistema separado. A ferramenta de tatuagem da BLDR gera e mostra o preview de designs de tatuagem.