Instalação

Dez minutos, a maior parte colando definições de itens. O resource não tem tabelas próprias nem resource complementar: os modelos de vape são transmitidos da sua própria pasta stream/.

Antes de começar

Você precisa	Por quê
ESX (`es_extended`), QBCore (`qb-core`) ou QBox (`qbx_core`), em execução	Detectado automaticamente; não há configuração de framework
Acesso à lista de itens do seu inventário	Os vapes são itens
Acesso à pasta de imagens do seu inventário	Para que cada vape tenha o seu ícone

1. Coloque a pasta no lugar

Solte mic_vape nos seus resources, por exemplo dentro de resources/[mic]/. Mantenha o nome da pasta: a barra de progresso se comunica com o resource pelo próprio nome dele.

Os dez modelos de vape e seu def_props.ytyp estão em stream/ e são carregados pelo manifesto; você não precisa movê-los.

2. Inicie após o seu framework

No server.cfg, coloque ensure mic_vape abaixo de es_extended, qb-core ou qbx_core, e abaixo do seu inventário. O QBox é detectado por meio de sua compatibilidade com o QBCore — qbx_core fornece qb-core — então não há nada para configurar.

Isso importa mais do que o normal: o mic_vape procura um framework iniciado no momento em que ele próprio inicia. Se ele iniciar primeiro, não encontra nada, não registra nenhum item e não exibe nenhum aviso sobre isso.

Funcionou quando o mic_vape inicia sem linhas vermelhas abaixo dele.

3. O banco de dados

Nada para o resource em si. No ESX com o inventário padrão, os itens de vape vão na tabela items — esse é o próximo passo.

4. Adicione os itens

Cada chave em Config.Vapes (em config.lua) é um nome de item, e todas são registradas como utilizáveis. A lista completa com o que cada um faz está em 🎒 Itens. Em resumo:

Grupo	Itens
Normal	`vape`
Vapes de poder	`invisibility_vape`, `speed_vape`, `superjump_vape`, `teleport_vape`, `invincibility_vape`, `health_vape`, `armor_vape`, `carspeed_vape`, `random_vape`
Sabores	`vape_watermelon`, `vape_mango`, `vape_blueberry` … quarenta ao todo, cada um chamado `vape_<flavour>`

Onde estão as definições prontas, na pasta inventory_items/ do resource:

Arquivo	Para	O que fazer
`esx_sql_items.sql`	ESX com seu inventário padrão	Importe uma vez no seu banco de dados
`ox_inventory_items.md`	ox_inventory	Cole as linhas dentro de `ox_inventory/data/items.lua`
`qb_items.md`	QBCore	Cole as linhas dentro de `qb-core/shared/items.lua`

Imagens: os ícones estão em inventory_images/, um PNG por item com o mesmo nome dele. Copie-os para a pasta de imagens do seu inventário — ox_inventory/web/images/ ou qb-inventory/html/images/. Três itens das listas acima não têm ícone (transform_vape, freeze_vape, gravity_vape) e vape_grape também não; adicione um ícone próprio se for usá-lo.

Funcionou quando você consegue se dar vape_watermelon e ele aparece no seu inventário com a imagem.

5. Primeiro teste

Dê a si mesmo um vape e use-o pelo inventário.

Funcionou quando um vape preto aparece na mão do seu personagem. Pressione E: seu personagem o levanta e, um instante depois, sai fumaça branca. Use o item novamente, ou digite /vape, e ele é guardado.

Depois teste speed_vape: após uma tragada, você corre visivelmente mais rápido por quinze segundos.

Antes de abrir sua cidade

mic_vape inicia após o seu framework no server.cfg.
Estresse: Config.Stress vem ativado e, por padrão, apenas imprime uma linha no console do servidor a cada tragada. Coloque a sua lógica de estresse em bridge/server_bridge.lua ou defina Config.Stress = false. Veja Personalização.
As notificações vêm desativadas por padrão (Config.ShowNotifications = false). Ative-as se quiser que os jogadores vejam mensagens de “em tempo de recarga”, “vape vazio” e dos poderes.
Decida sobre os vapes de poder. Invisibilidade, invencibilidade e teleporte são fortes. Defina um preço, uma loja ou um trabalho para eles antes que apareçam no bolso de alguém.