kloud-farmjob — Manual

Emprego de agricultor: colha batata, repolho, tomate, grãos de café e laranja nos campos, lave a colheita e venda para o feirante.

Sumário

1. Dependências
2. Instalação
3. Configuração geral
4. Campos de colheita
5. Árvores
6. Lavagem da colheita
7. Lojas
8. Entrypoints para outros recursos
9. Localização
10. Estrutura de arquivos

Dependências

O recurso avisa no console de inicialização (shared/checks.lua) se não encontrar framework ou target ativos.

Instalação

1. Copie a pasta kloud-farmjob para resources/.

2. Adicione ao server.cfg, garantindo que framework, target e inventário subam antes:

   ensure ox_lib
   ensure kloud-farmjob

3. Copie as imagens de install/images/ para a pasta de imagens do seu inventário (em ox_inventory, web/images/).

4. Cadastre os itens no seu inventário. São necessários:

   Item	Uso
   trowel	Ferramenta exigida no campo de batata (com durabilidade e chance de quebra)
   shovel	Vendido na loja de agricultura
   dirty_potato, dirty_cabbage, dirty_tomato, dirty_coffee_beans	Resultado da colheita, antes da lavagem
   potato, cabbage, tomato, coffee_beans	Resultado da lavagem; itens vendáveis
   orange	Colhida já limpa, direto da árvore

   O README.md do recurso traz os blocos prontos de qb-core/shared/items.lua e de ox_inventory/data/items.lua.

5. Não há SQL a importar — o recurso usa o oxmysql apenas via wrappers do framework, sem tabela própria.

Configuração geral

Arquivo: shared/config.lua.

Campos de colheita

Definidos em KloudDev.Locations (shared/location_config.lua). Cada campo aceita:

Os campos que vêm no config são potato (exige trowel), cabbage, tomato e coffee_beans.

A durabilidade e a quebra da ferramenta são resolvidas no servidor lendo requireItem.randomBreak e requireItem.breakChance — chaves que não existem na estrutura item.require do config, que usa breaking.enabled e breaking.chance. Na prática a ferramenta perde durabilidade, mas nunca quebra.

Árvores

Definidas em KloudDev.Trees. Usam os mesmos campos dos campos de colheita, com dois adicionais:

A única árvore configurada é orange, que entrega o item orange já limpo (não passa pela lavagem).

Lavagem da colheita

Definida em KloudDev.WashLocations. Nos pontos de lavagem, pressione E para converter os itens sujos em limpos.

Lojas

Definidas em KloudDev.Shops, com dois NPCs. Cada um usa blip, coords (array de vector4), pedModels (sorteado) e prices (array de {item, preço}).

Entrypoints para outros recursos

O recurso não expõe exports nem comandos. Os eventos abaixo são de cliente e podem ser disparados por outro recurso, mas todos dependem do estado interno de zona (_G.CurrentZone).

-- Abre o menu de venda do feirante
TriggerEvent('kloud-farm:client:openSell')
 
-- Abre o menu da loja de agricultura
TriggerEvent('kloud-farm:client:openShop')
 
-- Inicia a lavagem da colheita
TriggerEvent('kloud-farm:client:wash')

Os callbacks de servidor (kloud-farm:callback:canStart, :uprooted, :washed, :sellItem, :buyItem, :canCarry) são internos: recebem os dados da zona vindos do cliente e não são feitos para chamada externa.

Localização

As strings são traduzidas via ox_lib locale. Os arquivos ficam em locales/:

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

O locale ativo é definido pela convar ox:locale no server.cfg:

setr ox:locale "pt-br"

Alguns textos não passam pelo sistema de locale e estão escritos direto no shared/location_config.lua: os target.label dos campos (“Uproot”, “Pick Orange”), os blip.label e os item.label. Para traduzi-los, edite o config.

Estrutura de arquivos

kloud-farmjob/
├── init.lua                      — cria zonas, blips, targets e NPCs na inicialização
├── server.lua                    — callbacks de colheita, lavagem, compra e venda
├── shared/
│   ├── config.lua                — debug, UI (notify/progress/target/menu) e caminho das imagens
│   ├── location_config.lua       — campos, árvores, pontos de lavagem e lojas
│   ├── animations.lua            — dicionários e clips usados pelos NPCs e ações
│   ├── checks.lua                — avisa no console se faltar framework ou target
│   └── utils.lua                 — wrappers de TextUI, progressbar, notificação e skill check
├── modules/
│   ├── field/
│   │   ├── events.lua            — eventos de colher prop, colher árvore, cooldown e lavar
│   │   └── functions.lua         — spawn/limpeza de props, animações e fluxo da lavagem
│   └── shops/
│       └── events.lua            — menus de venda e de compra
├── framework/
│   ├── client/{qb,esx}.lua       — dados e job do jogador por framework
│   └── server/{qb,esx}.lua       — dinheiro e player por framework
├── inventory/
│   ├── client/{ox_inventory,qb-inventory,qs-inventory}.lua
│   └── server/{ox_inventory,qb-inventory,qs-inventory}.lua
├── target/
│   ├── ox_target.lua             — wrappers de target do ox_target
│   └── qb-target.lua             — wrappers de target do qb-target
├── locales/
│   ├── en.json
│   └── pt-br.json
├── install/images/               — imagens dos itens (copiar para o inventário)
└── fxmanifest.lua