ars_hunting — Manual

Sistema de caça com zonas, spawn de animais, rastreador, isca, fogueira, loja e missões, integrado à progressão de skill do cw-rep.

Sumário

1. Dependências
2. Instalação
3. Itens
4. Configuração
5. Zonas de caça
6. Lojas
7. Missões
8. Fogueira
9. Bloqueio de mira (AimBlock)
10. Integrações
11. Localização
12. Estrutura de arquivos

Dependências

Instalação

1. Copie a pasta ars_hunting para resources/.
2. Adicione ao server.cfg:

   ensure ars_hunting
3. Registre os itens no inventário. O repositório traz os blocos prontos:
   • !INSTALLATION/ox_items.lua — para o ox_inventory (data/items.lua)
   • !INSTALLATION/qb_items.lua — para o qb-core (shared/items.lua)
4. Copie as imagens de !INSTALLATION/images/ para a pasta de imagens do inventário (ox_inventory/web/images/).
5. Registre a arma WEAPON_MUSKET e a munição ammo-musket no inventário se for manter esses itens na loja.
6. Não há SQL a importar. Os delays de missão são persistidos via KVP do próprio recurso.

Itens

Os três primeiros são registrados como usáveis pelo bridge (CreateUseableItem no QBCore, equivalente no ESX). Os nomes vêm de Config.TrackerItem, Config.BaitItem e Config.Campfire.campfireItem.

Configuração

Arquivo: shared/config.lua.

Geral

Rastreamento

Isca

AimBlock

Fogueira

Zonas de caça

Configuradas em Config.HuntingZones, indexadas por nome. A zona incluída de fábrica é CHILIAD_MOUNTAINS, em vec3(1125.88, 4622.2, 80.08), com veado (a_c_deer).

Campos de um animal

Como o loot é sorteado

A cada colheita o servidor sorteia uma pele e uma carne: rola 1-100 e escolhe aleatoriamente entre os itens cuja chance seja maior ou igual ao valor rolado. Isso significa que chance mais alta = item mais comum. A quantidade entregue é aleatória entre 1 e maxQuantity.

Além disso, em 30% das colheitas o servidor sorteia também um item de items.extra. Cada colheita dá 5 pontos de skill hunting no cw-rep (10 se saiu o extra).

O servidor recusa a colheita se o jogador estiver a mais de 8 metros do animal.

Lojas

Configuradas em Config.Shops, indexadas pelo nome exibido. A loja incluída é “Loja de Caçador”, em vec4(-679.28, 5834.25, 16.33, 132.58).

O levelmin é comparado com exports["cw-rep"]:getCurrentLevel('hunting'). Itens acima do nível do jogador aparecem na lista como desabilitados, com a descrição “Desbloqueia no LV X”.

A quantidade de compra ou venda é digitada pelo jogador em um input dialog, e o preço final é quantidade * price. O servidor valida dinheiro (compra) e posse do item (venda) antes de concluir.

Missões

O Mestre da Caça fica em Config.HuntMaster — vector4(17.04, 3688.28, 38.68, 147.12), modelo cs_fabien. Também define vehicleSpawn e vehicleDeposit, usados por missões que exigem veículo.

Missões incluídas: mission_1 (10 peles prime), mission_2 (5 chifres) e mission_3 (capturar um javali e levá-lo de volta, com o bodhi2).

O cooldown de cada missão é gravado por jogador com SetResourceKvp usando a chave <id>_<license>, então sobrevive a restart do recurso. O servidor recusa a finalização se o jogador estiver a mais de 3 metros do Mestre da Caça. Concluir uma missão dá 5 pontos de skill hunting.

Fogueira

Usar o item campfire consome o item e posiciona o prop prop_beach_fire no chão. Interagindo com ela, o jogador abre um menu com as receitas de Config.Campfire.items; a receita padrão transforma 1 raw_meat em 1 cooked_meat em 5 segundos. Cozinhar dá 5 pontos de skill cooking no cw-rep.

A fogueira pode ser recolhida (devolve o item), desde que o jogador esteja a menos de 4 metros dela.

Bloqueio de mira (AimBlock)

Com Config.AimBlock.enable = true, ao equipar uma arma listada em weaponsToBlock o recurso passa a bloquear o disparo (DisablePlayerFiring e os controles de ataque) sempre que o jogador não estiver mirando livremente em um alvo válido — ou seja, quando estiver mirando em outro jogador, em um veículo, ou em um ped dentro de um veículo.

Na prática: as armas de caça só disparam contra animais. Com global = false, a restrição vale apenas dentro das zonas de caça.

Localização

As strings são traduzidas via ox_lib locale. Arquivos em locales/:

• en.json — inglês
• pt-br.json — português do Brasil

O locale ativo vem da convar ox:locale:

setr ox:locale "pt-br"

Nota: os textos do NPC “Seu Tião” (em client/hunting.lua) e vários label de itens em shared/config.lua estão escritos direto em português no código, fora do sistema de locale.

Estrutura de arquivos

ars_hunting/
├── client/
│   ├── modules/utils.lua   — helpers: drawText3D, notificação, validação de arma
│   ├── hunting.lua         — zonas, spawn e comportamento dos animais, colheita, rastreador, isca, NPC tutorial
│   ├── campfire.lua        — colocar/recolher fogueira e menu de cozinhar
│   ├── shops.lua           — peds das lojas, menu de compra/venda e gate de nível via cw-rep
│   ├── missions.lua        — menu do Mestre da Caça, missões de item e de animal, veículo e transporte
│   └── aimblock.lua        — loop que bloqueia disparo das armas de caça contra jogadores e veículos
├── server/
│   ├── bridge/esx.lua      — implementação do framework para ESX
│   ├── bridge/qb.lua       — implementação do framework para QBCore + itens usáveis
│   └── server.lua          — sorteio de loot, compra/venda, missões, KVP de cooldown, skills do cw-rep
├── shared/
│   └── config.lua          — zonas, animais, lojas, missões, fogueira, aimblock
├── locales/
│   ├── en.json
│   └── pt-br.json
├── !INSTALLATION/
│   ├── ox_items.lua        — bloco de itens para o ox_inventory
│   ├── qb_items.lua        — bloco de itens para o qb-core
│   └── images/             — imagens dos itens para a pasta do inventário
├── _icons/                 — ícones usados pelos menus do recurso
└── fxmanifest.lua