Instalação

Quinze minutos. Duas pastas, algumas configurações e os itens. Nada é salvo no banco de dados, então não há nada para importar para o resource em si.

Antes de começar

Você precisa	Por quê
ESX, QBCore ou QBox, em execução	Itens, donos e empregos passam por ele
ox_target ou qb-target, em execução	Todas as interações com um narguilé ou cadeira posicionada
Ambas as pastas da sua compra: `mic_hookah` e `mic_hookah_prop`	O script e os modelos de narguilé
Acesso à lista de itens e à pasta de imagens do seu inventário	Narguilés, móveis, suprimentos e essências são itens

1. Coloque ambas as pastas no lugar

Coloque mic_hookah e mic_hookah_prop na sua pasta de resources, por exemplo dentro de resources/[mic]/.

mic_hookah_prop contém os dez modelos de narguilé (mic_hookah_black … mic_hookah_yellow) e o seu mic_hookah.ytyp. Ele não tem código; apenas faz o stream. As mesas e cadeiras são modelos do jogo base e não precisam de nada extra.

2. Ordem de inicialização

No server.cfg, abaixo do seu framework, do seu inventário e do seu resource de target, adicione ensure mic_hookah_prop e depois ensure mic_hookah.

Funcionou quando ambos iniciarem sem linhas vermelhas abaixo deles.

3. Framework e target

Abra config.lua:

Opção	Defina como	Padrão
`Config.Framework`	`esx`, `qbcore` ou `qbox`	`esx`
`Config.Target`	`ox_target` ou `qb-target`	`ox_target`
`Config.ESXResourceName`	O nome da pasta do ESX, se você o renomeou	`es_extended`
`Config.QBResourceName`	O nome da pasta do QBCore, se você o renomeou	`qb-core`
`Config.QBoxResourceName`	O nome da pasta do QBox, se você o renomeou	`qbx_core`
`Config.QBTargetResourceName`	O nome da pasta do qb-target, se você o renomeou	`qb-target`

Nada é detectado sozinho aqui: esses valores decidem qual framework e qual target são usados.

4. O banco de dados

Nada para o resource: narguilés e móveis posicionados ficam na memória do servidor, não em uma tabela. No ESX com o inventário padrão, os itens vão na tabela items — próximo passo.

5. Adicione os itens

A lista completa está em 🎒 Itens. Em resumo:

Item	O que faz
`hookah_black`, `hookah_blue`, `hookah_green`, `hookah_grey`, `hookah_orange`, `hookah_pink`, `hookah_purple`, `hookah_red`, `hookah_skyblue`, `hookah_yellow`	Use para carregar e posicionar esse narguilé
`hookah_table` … `hookah_table5`	Use para posicionar uma mesa
`hookah_chair` … `hookah_chair6`	Use para posicionar uma cadeira na qual é possível sentar
`hookah_coal`	Enche o carvão pelo menu de configuração
`hookah_water`	Enche a água pelo menu de configuração
`hookah_<flavour>_flavor`	Sessenta essências, escolhidas no menu de configuração

Onde estão as definições prontas, em inventory_items/ dentro de mic_hookah:

Arquivo	Para	O que fazer
`esx_items.sql`	ESX com seu inventário padrão	Importe uma vez no seu banco de dados
`ox_items.md`	ox_inventory	Cole suas linhas em `ox_inventory/data/items.lua`
`qb_items.md`	QBCore / QBox com qb-inventory	Cole suas linhas em `qb-core/shared/items.lua`

Imagens: os ícones estão em inventory_images/, um PNG por item com o seu respectivo nome. Copie-os para a pasta de imagens do seu inventário — ox_inventory/web/images/ ou qb-inventory/html/images/.

Depois, aponte Config.InventoryImagePath para essa mesma pasta, para que os ícones das essências apareçam no menu de configuração. Ele vem por padrão como nui://ox_inventory/web/images/; para qb-inventory use nui://qb-inventory/html/images/.

Funcionou quando você puder se dar hookah_red e ele aparecer no seu inventário com a sua imagem.

6. Primeiro teste

Dê a si mesmo hookah_red, hookah_coal, hookah_water e hookah_mint_flavor.

Use hookah_red. Seu personagem o segura em uma bandeja. Pressione E.
Uma prévia segue a sua mira. Gire-a com a roda do mouse, suba ou desça com as setas e pressione E para colocá-la no chão.
Use o target no narguilé e escolha Open Setup Menu. Adicione carvão, adicione água, escolha Mint e depois Light Hookah.
Feche o menu, use o target no narguilé novamente e escolha Grab Hose. Pressione E.

Funcionou quando uma mangueira for do narguilé até o seu personagem e, ao pressionar E, você der uma tragada e sair uma fumaça verde-clara. O carvão e a água no menu diminuem um pouco a cada tragada.

Antes de abrir sua cidade

Decida quem pode gerenciar os narguilés. Config.AdminGroups vem como false, o que permite que qualquer jogador abra o menu e recolha qualquer narguilé ou móvel. Defina os seus grupos de administrador para limitar isso ao dono e à equipe. Veja Personalização.
Config.InventoryImagePath aponta para a pasta de imagens que você realmente usa.
Estresse: Config.Stress vem ativado, mas ReduceStress em server_functions.lua está vazio até que você coloque a sua chamada nele.
Avise seus jogadores que narguilés e móveis não são salvos: eles desaparecem quando o resource ou o servidor reinicia.