ai-jobs
Rotas de trabalho iniciadas em um depósito (táxi, ônibus, caminhoneiro, lixeiro, jornal, guincho, reciclagem, vinhedo, mergulho) e a barraca de cachorro-quente.
O ai-jobs dá aos jogadores empregos simples que eles podem começar em um depósito: dirigir uma rota e receber por parada, guinchar carros quebrados, ou coletar itens a pé. Ao lado das rotas, ele cuida de uma barraca de cachorro-quente: alugue um carrinho, empurre-o por aí, cozinhe e venda para quem passa. Toda rota e toda parada são definidas no painel de administração, então você pode adicionar empregos novos sem escrever código.
O que faz no jogo
- Começando um turno. Cada rota tem um depósito com um blip no mapa. Vá até o depósito e use o ponto (Start working). Rotas de direção colocam um veículo de trabalho no ponto de spawn da rota e dão as chaves a você. Use o depósito de novo (Stop working) para encerrar o turno.
- Paradas. O servidor escolhe sua próxima parada e a mostra no mapa. Na parada, use o ponto (Work here): uma barra de progresso roda pelo tempo por parada da rota, depois você é pago (ou recebe itens em uma rota de coleta) e a próxima parada aparece.
- Tipos de rota.
- Paradas aleatórias: a próxima parada é qualquer outra parada da rota (táxi, caminhoneiro, jornal, lixeiro).
- Paradas em ordem: as paradas seguem umas às outras pelo id e recomeçam da primeira (ônibus).
- Coleta a pé: sem veículo; cada parada dá um número aleatório de um item (reciclagem, vinhedo, mergulho). Paradas debaixo d'água tocam uma animação de mergulho.
- Guincho: um carro quebrado e trancado espera na parada. Coloque-o na plataforma, depois o depósito vira a próxima parada. Você é pago no depósito, só se o carro guinchado ainda estiver a até 15 m da plataforma.
- Fim do turno. Um turno termina quando as paradas por turno acabam (0 significa que ele nunca termina sozinho), quando você o encerra no depósito, quando você sai do servidor, ou quando o recurso para. O veículo de trabalho e um carro guinchado são apagados nesse momento. Nada é salvo no banco de dados.
- Pagamento. Rotas de direção e de guincho pagam o pagamento por parada da rota na conta de pagamento da rota (banco por padrão).
Barraca de cachorro-quente
- No balcão, alugue uma barraca. O depósito é retirado da conta de depósito. A barraca aparece no seu ponto de spawn ao lado do balcão.
- Use a barraca para abrir o menu dela: Push the stand, Prepare hot dogs, Start selling / Stop selling.
- Enquanto empurra, aperte G para soltar. Você também solta quando cai, morre, mira, briga ou entra em um veículo.
- Prepare hot dogs roda uma série de testes de habilidade. Nenhum erro faz um cachorro-quente perfeito (A), um erro faz um raro (B), mais erros fazem um comum (C). Cada cachorro-quente aumenta sua reputação de cachorro-quente. A partir do nível 2, metade dos lotes tem sorte e dá mais de um cachorro-quente.
- Start selling: pessoas que passam por perto vêm até a barraca e fazem uma oferta (1 a 3 cachorros-quentes de uma qualidade, a um preço da faixa do seu nível). Aceite-a no cliente. Um cliente espera 30 s. Andar mais de 10 m da barraca ou ficar sem estoque para a venda.
- Devolva a barraca no balcão para receber o depósito de volta. Sair do jogo com uma barraca perde o depósito; parar o recurso o devolve.
A reputação é guardada no personagem (rep.hotdog, a mesma chave que o QBCore usa), então ela fica entre sessões. Seu nível é o maior nível cuja From reputation você alcançou; o nível define quantos cachorros-quentes de cada qualidade a barraca guarda e os preços deles.
Instalação
Instalado pela receita do AI Core. À mão: coloque a pasta em resources/[ai]/ e adicione ensure ai-jobs depois de ensure ai-core. Ele precisa do ai-core e do OneSync.
As rotas de coleta dão scrapmetal, grape e coral por padrão. Garanta que esses itens existam na lista de itens do seu inventário, ou mude o item da rota no painel. Os veículos de trabalho padrão são modelos do GTA (taxi, bus, rumpo, trash2, flatbed), nenhum veículo extra é necessário.
Configurações do painel
Painel de administração > Work routes. Ele tem três abas: Routes, Stops e Hot dog stand. Os padrões vêm de data/routes.json, data/stops.json e data/hotdog.json.
Aba Routes
Um registro por rota. As rotas padrão são taxi, bus, trucker, garbage, recycle, vineyard, diving, tow e news.
Route
| Configuração | O que muda | Unidade | Padrão para uma rota nova |
|---|---|---|---|
| Name | O nome mostrado no aviso e no blip do depósito. 1-48 caracteres. | vazio | |
| Kind | Como a próxima parada é escolhida: Random stops, Stops in order, Gathering on foot ou Towing broken-down cars (veja acima). | Random stops | |
| Jobs | Só membros desses empregos podem começar a rota. Deixe empregos e gangues vazios para todos. O depósito e o blip de uma rota restrita aparecem só para os jogadores que podem usá-la. | vazio (todos) | |
| Gangs | Membros dessas gangues também podem começá-la. | vazio | |
| Only on duty | Membros do emprego precisam estar em serviço naquele emprego. | desligado | |
| Depot | Onde os jogadores começam e param de trabalhar. Fique ali e use sua posição. | 0, 0, 0 | |
| Stops per shift | Quantas paradas um turno tem. 0 significa que o turno continua até o jogador parar. 0-100. | 5 | |
| Time per stop | Quanto tempo o trabalho em uma parada leva (a barra de progresso). 0-120. | s | 5 |
| Depot blip | Sprite, cor e tamanho do blip do depósito no mapa. | sprite 67, cor 5, tamanho 0.65 |
Work vehicle
| Configuração | O que muda | Unidade | Padrão |
|---|---|---|---|
| Vehicle model | Nome de spawn do veículo de trabalho (taxi, bus, mule, trash). Vazio: sem veículo (rotas de coleta). | vazio | |
| Vehicle spawn | Onde o veículo de trabalho aparece e para que lado ele fica virado. | 0, 0, 0 | |
| Pay per stop | Pago na conta de pagamento depois de cada parada. 0-100.000. | $ | 100 |
| Pay account | A conta de dinheiro para onde vai o pagamento. | bank | |
| Broken-down cars | Só rotas de guincho: nomes de spawn dos carros que esperam nas paradas; um é escolhido ao acaso. Até 40 nomes. | 12 carros do GTA (sultanrs, zion, oracle...) |
Gathering
| Configuração | O que muda | Unidade | Padrão |
|---|---|---|---|
| Item per stop | O item dado em cada parada. | vazio | |
| Fewest items per stop | Menor quantidade por parada. 1-100. | 1 | |
| Most items per stop | Maior quantidade por parada. Cada parada dá uma quantidade aleatória entre as duas. 1-100. | 3 |
NPC (opcional, uma pessoa parada no depósito)
| Configuração | O que muda | Padrão |
|---|---|---|
| Model | O modelo de ped; vazio significa sem NPC. Os jogadores o veem a até 50 m. | vazio (o depósito de lixo tem s_m_y_garbage, o de mergulho a_m_m_salton_01) |
| What it does | Uma animação parada: fica parado, espera impaciente, segura uma prancheta, olha o celular, bebe café, fuma, monta guarda, pose de polícia, fica de bobeira. | Fica parado |
| Where it stands | O ponto do NPC e para que lado ele fica virado. Sem ele, o NPC fica no ponto do depósito. | o depósito |
As rotas padrão:
| Rota | Tipo | Veículo | Pagamento por parada | Tempo por parada | Paradas por turno |
|---|---|---|---|---|---|
Downtown Cab Co. (taxi) | Paradas aleatórias | taxi | $120 | 4 s | 8 |
Dashound Bus (bus) | Paradas em ordem | bus | $60 | 6 s | 0 (sem fim) |
Post OP Freight (trucker) | Paradas aleatórias | rumpo | $250 | 8 s | 5 |
Los Santos Sanitation (garbage) | Paradas aleatórias | trash2 | $90 | 6 s | 10 |
Recycling Center (recycle) | Coleta | nenhum, dá scrapmetal | 5 s | 0 (sem fim) | |
Marlowe Vineyard (vineyard) | Coleta | nenhum, dá grape | 4 s | 0 (sem fim) | |
Del Perro Diving (diving) | Coleta | nenhum, dá coral | 8 s | 7 | |
Hayes Towing (tow) | Guincho | flatbed | $250 | 8 s | 5 |
Weazel News (news) | Paradas aleatórias | rumpo | $180 | 15 s | 5 |
Aba Stops
Um registro por parada. Uma rota sem paradas não pode ser começada. Apagar uma rota mantém as paradas dela.
| Configuração | O que muda | Padrão |
|---|---|---|
| Route | O id da rota à qual esta parada pertence (taxi, bus...). | taxi |
| Name | O nome da parada. 1-48 caracteres. | vazio |
| Place | Onde o trabalhador para. Fique no lugar e use sua posição. | 0, 0, 0 |
Aba Hot dog stand
Stand
| Configuração | O que muda | Unidade | Padrão |
|---|---|---|---|
| Open | Desligado esconde o balcão. Barracas já alugadas continuam funcionando até serem devolvidas. | ligado | |
| Counter | Onde os jogadores alugam e devolvem a barraca. | 39.31, -1005.54, 29.48 (Legion Square) | |
| Stand spawn | Onde uma barraca alugada aparece, virada para o lado em que o balcão da barraca deve olhar. | 38.15, -1001.65, 29.44 | |
| Stand model | O prop da barraca. | prop_hotdogstand_01 | |
| Jobs / Gangs / Only on duty | Quem pode alugar uma barraca (a mesma regra das rotas). Vazio: todos. | vazio | |
| Map blip | O blip do balcão. | sprite 542, cor 17, tamanho 0.6 |
Money
| Configuração | O que muda | Unidade | Padrão |
|---|---|---|---|
| Deposit | Retirado quando a barraca é alugada, devolvido quando ela é entregue no balcão (perdido ao sair do jogo). 0-1.000.000. | $ | 250 |
| Deposit account | A conta de onde o depósito é retirado e para onde volta. | bank | |
| Sales paid into | A conta para onde vai o dinheiro de um cliente. | cash |
Cooking and reputation
| Configuração | O que muda | Padrão |
|---|---|---|
| Skill checks | Testes de habilidade por cachorro-quente. 1-10. | 3 |
| Reputation per perfect | Reputação que um cachorro-quente perfeito dá. 0-100. | 3 |
| Reputation per rare | Reputação que um cachorro-quente raro dá. 0-100. | 2 |
| Reputation per common | Reputação que um cachorro-quente comum dá. 0-100. | 1 |
| Highest reputation | A reputação para de crescer aqui. 0-100.000. | 200 |
Levels e Prices (uma lista, até 10 níveis; o primeiro vale a partir de 0)
| Configuração | O que muda |
|---|---|
| From reputation | A reputação em que este nível começa. |
| Hot dogs per quality | Quantos cachorros-quentes de cada qualidade a barraca pode guardar neste nível. |
| Perfect from / to, Rare from / to, Common from / to | Faixa de preço de um cachorro-quente daquela qualidade, em $. Cada oferta escolhe um preço dentro da faixa. |
Níveis padrão:
| From reputation | Cachorros-quentes por qualidade | Perfeito | Raro | Comum |
|---|---|---|---|---|
| 0 | 15 | $8-12 | $6-9 | $4-6 |
| 50 | 30 | $9-13 | $7-10 | $5-7 |
| 100 | 45 | $10-14 | $8-11 | $6-9 |
| 200 | 60 | $11-15 | $9-12 | $7-9 |
A barraca também tem um cartão NPC (modelo, animação parada, posição), como as rotas.
Comandos
Nenhum.
Teclas
Cada jogador pode trocá-las nas configurações de teclas do GTA (seção FiveM); o dono troca os padrões no painel de administração (Keybinds).
| Tecla padrão | O que faz |
|---|---|
| G | Solta a barraca de cachorro-quente que você está empurrando (jobs_hotdog_release). |
Depósitos, paradas, o balcão e a barraca são pontos de interação: um aviso com a tecla de interação (E por padrão) ou uma opção de target, conforme a configuração Interaction style do ai-core.
O que ele substitui
Sem fxProvide. Um único motor cobre o que o QBCore / Qbox trazem como scripts de emprego separados (táxi, ônibus, caminhoneiro, lixeiro, guincho, jornal e empregos de coleta), e a barraca de cachorro-quente é uma adaptação do qb-hotdogjob. Ele não responde aos exports ou eventos desses scripts.
Scripts compatíveis
As chaves dos veículos de trabalho passam pela camada de chaves do AI Core, os itens pela camada de inventário. Qualquer script de chaves e inventário que o AI Core suporte funciona (veja Compatibilidade).
Limites conhecidos
- Um turno é mantido só na memória: sair do servidor ou reiniciar o recurso o encerra, e o veículo de trabalho é apagado.
- O servidor recusa uma parada quando o jogador está a mais de 12 m dela, a mais de 15 m do veículo de trabalho (rotas de direção), ou chega mais rápido que 60 m/s a partir da última parada (teleportes).
- Cachorros-quentes não são itens de inventário: o estoque fica na barraca, e os clientes são só NPCs. Os jogadores não podem comprar uns dos outros.
- Canais de log:
work(pagamento das rotas) ehotdog(vendas).
Empregos e serviços
Rotas de trabalho, polícia, alertas, prisão, morte e EMS, banco, menus do chefe e a prefeitura.
ai-jobs para desenvolvedores
O que o ai-jobs compartilha com outros scripts (ele não tem exports): a reputação do cachorro-quente, placas e chaves dos veículos de trabalho, motivos de registro, e seus eventos privados.