Tarefas
Tudo o que um pet faz é uma tarefa: seguir você, trabalhar, pegar fichas, fazer compras, dar presentes, tirar fotos, dormir e também os passatempos. pet_errand/ tem um arquivo por tarefa, e o nome do arquivo é o id da tarefa; pet_errand/gift_owner.json, por exemplo, é chiikawa:gift_owner. Para saber como funciona no jogo, veja O que o pet está pensando.
Há três tipos de arquivo:
- Tarefas escritas no código, como seguir, fazer compras e dar presentes. Os arquivos delas só têm os campos comuns, que controlam o quanto a tarefa é urgente, quanto tempo leva e quanto descansa.
- Serviços, cujos arquivos têm uma
action, como colher, arrancar ervas daninhas, caçar e se apresentar. O que fazer, e com o quê, fica escrito no arquivo; veja Serviços abaixo. - Passatempos, que também são serviços, com mais dois campos,
whenecast, para quando acontecem e quem faz; veja Passatempos.
Como o pet escolhe uma tarefa
Cada vez que escolhe uma tarefa, o pet primeiro procura a prioridade mais alta entre as tarefas que consegue fazer agora, e só compara pontuações dentro dessa prioridade. A pontuação primeiro ganha os bônus das fichas e da vontade de trabalhar, depois é multiplicada pelos fatores da personalidade e, por fim, ganha um pouco de acaso de acordo com o randomness da personalidade. A tarefa com a maior pontuação é o que o pet faz.
Uma tarefa de prioridade mais alta pode interromper uma de prioridade mais baixa. Tarefas da mesma prioridade nunca interrompem uma à outra: a que está em andamento termina primeiro, e as outras esperam a vez, por mais alta que seja a pontuação. É por isso que os fatores da personalidade só valem dentro de uma mesma prioridade, e por maiores que sejam, passear nunca vence o trabalho.
As tarefas do próprio mod e as prioridades padrão:
| Prioridade padrão | Tarefas |
|---|---|
| 100 | flee fugir quando apanha sem revidar |
| 80 | melee, ranged se defender, proteger você e limpar os monstros em volta; defend_self pegar uma arma da mochila para revidar; gift_owner levar até você um presente que já tem em mãos; cooperate entrar na brincadeira quando outro pet convida; take_exam ir fazer a prova em uma Mesa de Exame; check_results ir ver o resultado no dia seguinte |
| 50 | follow_owner seguir; take_task pegar uma ficha em um Quadro de Trabalho; shop fazer compras; answer_whistle um pet selvagem chegar para olhar quando ouve a Bala de Apito; harvest colher; plant plantar; deliver guardar a colheita em baús; weed arrancar ervas daninhas; pick_mushroom colher cogumelos à noite; hunt_melee, hunt_ranged limpar os monstros perto de casa no modo Livre, que é o que as fichas de caça contam; play_music se apresentar |
| 40 | take_photo o Hachiware tirar fotos |
| 30 | offer_gift escolher um presente na mochila quando quer dar um; socialize procurar outro pet para fazer uma pequena cena; pick_up_item pegar coisas do chão |
| 10 | stay sentar e olhar em volta; wander passear; sleep dormir; todos os passatempos |
Esses números são só uma convenção. O mod não separa as tarefas por número, e os modpacks podem mudar à vontade.
Campos comuns
Todo arquivo de tarefa tem estes campos. Veja como exemplo o de dar presentes, pet_errand/gift_owner.json:
{
"priority": 80,
"score": 0.85,
"max_ticks": 2400,
"rests": {
"done": 0,
"gave_up": 600,
"interrupted": 0,
"reports": { "given": { "from": "chiikawa:gifting_cooldown" } }
},
"yields_to": ["chiikawa:melee", "chiikawa:ranged", "chiikawa:defend_self"],
"overlays": [],
"tuning": {
"arrive_distance": 1,
"morning_from": 0.77,
"morning_to": 0.8,
"reach": 2.0,
"slept_ticks": 100,
"speed": 1.0
}
}| Campo | Significado |
|---|---|
priority | A prioridade, um número inteiro de 0 para cima, veja acima |
score | Quanta vontade tem de fazer a tarefa dentro da sua prioridade, de 0 a 1 |
max_ticks | O tempo máximo que gasta nela; se não terminar até lá, desiste |
rests | Quanto tempo descansa depois de terminar, desistir ou ser interrompido, veja abaixo |
yields_to | Opcional, tarefas da mesma prioridade a que dá a vez: enquanto elas ainda tiverem algo a fazer, não começa. Só dá para listar tarefas da mesma prioridade |
overlays | Opcional, coisinhas que faz junto com esta tarefa; por enquanto a única é chiikawa:idle_chatter, conversar com os próprios botões de vez em quando enquanto passeia |
start_voice | Opcional, um momento de fala para dizer quando sai; luta corpo a corpo e tiro, por exemplo, têm hunt |
tuning | Os números próprios da tarefa, veja abaixo |
Dar presentes tem luta corpo a corpo, tiro e defesa em yields_to, então um pet no meio de uma luta não sai andando para entregar um presente. O deliver dos pets de Agricultura dá a vez a harvest e plant, e plant dá a vez a harvest, então sempre colhem primeiro, depois plantam, e só no fim guardam a colheita em baús.
O que vai em tuning depende da tarefa. Numa tarefa escrita no código, a própria tarefa define o formato; num serviço, quem define é a action. Nenhum campo pode ficar de fora, então o jeito mais fácil é copiar a mesma tarefa, ou um arquivo com a mesma action, de data/chiikawa/pet_errand/ no jar do mod e mudar os números. Algumas tarefas listam animações por personagem em tuning: cowers em flee é a pose em que se esconde, e sleeps em sleep é a pose em que dorme. by_character é escrito por personagem, e todos os outros personagens usam otherwise.
Quanto tempo descansa
done, gave_up e interrupted em rests são quanto tempo a tarefa descansa depois de terminada, abandonada ou interrompida, antes de ser feita de novo. Os três precisam ser escritos, e gave_up não pode ser 0, senão no momento em que desiste o pet começaria tudo de novo na hora. Cada um pode ser escrito de três jeitos:
| Escrito como | Significado |
|---|---|
600 | A tarefa inteira descansa por 600 ticks |
{ "ticks": 200, "per": "subject" } | Descansa 200 ticks só desse alvo específico, como a plantação que não conseguiu alcançar ou o pet com quem acabou de fazer uma cena, e continua com todo o resto |
{ "from": "chiikawa:gifting_cooldown" } | Quanto tempo descansa é decidido por um número em outro arquivo; também dá para acrescentar "per": "subject" |
Só estes podem ir em from:
| Nome | Usa |
|---|---|
chiikawa:camera_cooldown | O cooldown_ticks da câmera |
chiikawa:camera_retry | O retry_ticks da câmera |
chiikawa:photo_upload_wait | O tempo de espera até o jogo do dono desenhar a foto |
chiikawa:gifting_cooldown | O cooldown_ticks dos presentes |
chiikawa:music_retry | Quanto esperar antes de tentar de novo quando uma música não conseguiu começar, das configurações do mod |
chiikawa:scene_cooldown | O cooldown_ticks das pequenas cenas |
chiikawa:pastime_cooldown | O cooldown_ticks do tuning do próprio passatempo, ajustado por "Passatempos" nas configurações do mod |
reports é opcional. Guarda quanto tempo descansar quando o resultado só é conhecido depois, com chaves definidas pela própria tarefa: given, de dar presentes, é depois de o presente ser entregue; taken, stored e failed, de tirar fotos, são depois de a foto ser tirada, de ser guardada e de uma foto que não deu certo; played, das pequenas cenas, é depois de a cena ser feita.
Serviços
Um arquivo com action é um serviço. Um pet só faz um serviço quando ele está na lista de serviços de uma profissão que o pet tem; os passatempos são a exceção, e todo pet considera. Veja como exemplo o de arrancar ervas daninhas, pet_errand/weed.json:
{
"action": "chiikawa:harvest_block",
"category": "forage",
"counter": "chiikawa:weed",
"requires": ["wild_or_slip"],
"target": {
"type": "blocks",
"blocks": "#chiikawa:entity_weeds",
"missing": "no_weed"
},
"priority": 50,
"score": 0.5,
"max_ticks": 600,
"rests": {
"done": 0,
"gave_up": { "per": "subject", "ticks": 200 },
"interrupted": 0
},
"yields_to": [],
"overlays": [],
"tuning": { "no_way_ticks": 0, "reach_sqr": 3.0, "speed": 0.8, "tool_wear": 0 }
}Além dos campos comuns acima, um serviço tem estes:
| Campo | Significado |
|---|---|
action | Como é feito, veja a tabela abaixo |
category | Que tipo de coisa é, o que decide em qual ordem é feito, veja a tabela abaixo |
counter | Opcional, para que tipo de progresso de ficha cada vez conta. Quando a ficha em mãos conta este serviço, a pontuação sobe um pouco |
requires | Opcional, condições extras: wild_or_slip quer dizer que os pets selvagens fazem por conta própria, enquanto os seus pets só fazem com uma ficha em mãos que conte este serviço, e escrever isso exige um counter; at_night quer dizer que só é feito à noite |
target | Com o que é feito; algumas action exigem, outras não aceitam, veja a tabela abaixo |
action só pode ser um destes, que o mod tem:
action | O que faz | target | Arquivos do próprio mod |
|---|---|---|---|
chiikawa:harvest_block | Quebra o bloco e guarda o que sai na mochila | ripe_crop ou blocks | harvest, weed, pick_mushroom |
chiikawa:plant_block | Planta sementes da mochila | plantable_soil | plant |
chiikawa:deposit | Guarda coisas da mochila em um recipiente | container | deliver |
chiikawa:strike | Bate com uma espada | foe | melee, hunt_melee |
chiikawa:shoot | Atira com um arco | foe | ranged, hunt_ranged |
chiikawa:busk | Se apresenta com a Caixa de Música | Não se escreve | play_music |
chiikawa:perform, chiikawa:visit, chiikawa:ask_praise | Passatempos, veja Passatempos | Não se escreve | Veja aquela página |
Há cinco type de target, e todos precisam de um missing, veja abaixo:
type | Com o que é feito | Também precisa de |
|---|---|---|
ripe_crop | Plantações maduras | Nada |
plantable_soil | Terra arada que aceita as sementes da mochila; não procura enquanto não tiver sementes | Nada |
blocks | Blocos de uma tag de blocos; nas plantas de dois blocos de altura, só o bloco de baixo conta | blocks, uma tag de blocos |
container | Recipientes que aceitam coisas da mochila; não procura enquanto não tiver nada para guardar | blocks, a tag de blocos dos recipientes, e items, uma tag de itens do que guardar |
foe | Um inimigo em que o pet está de olho | grounds, o motivo para lutar, veja abaixo |
O próprio pet encontra os alvos que são blocos, e até onde procura está escrito em sight no arquivo da profissão, veja Profissões.
grounds em foe lista por quais motivos este serviço luta, e aceita vários: self é o que bateu no próprio pet ou está mirando no pet; owner é o que bateu em você, está apanhando de você ou está mirando em você; nearby são as criaturas hostis em volta enquanto segue você ou está na natureza; e hunt são as criaturas hostis perto de casa no modo Livre. Os melee e ranged do próprio mod listam os três primeiros, com prioridade 80; hunt_melee e hunt_ranged só listam hunt, com prioridade 50, a mesma do trabalho, então limpar os monstros nunca interrompe o trabalho em andamento.
missing é o motivo mostrado na tela do pet quando não há alvo: a parte de uma chave do arquivo de idioma do resource pack que vem depois de intent.chiikawa.fail.. no_weed, por exemplo, corresponde a intent.chiikawa.fail.no_weed, "Sem ervas daninhas por perto".
As category mais comuns são estas:
category | Quem faz |
|---|---|
work | Os seus pets no modo Livre |
forage | Os pets selvagens, e os seus pets no modo Livre |
combat | Todos, menos os pets na ordem Sentar |
pastime | Pets que estão passeando, veja Passatempos |
As outras (follow_owner, stay, wander, pick_up, take_task, shop, gift, social, exam, curious, photo, sleep, safety) são usadas pelas tarefas escritas no código, e os serviços raramente precisam delas. pick_up é a que o interruptor "Coleta automática" da tela do pet liga e desliga; veja A tela do pet.
Mudar e adicionar
Mudar uma tarefa. Coloque um arquivo com o mesmo nome em data/chiikawa/pet_errand/. Ele substitui por completo a cópia do próprio mod, então todos os campos precisam ser escritos. Uma tarefa escrita no código não pode virar um serviço, então o arquivo dela não pode ter action.
Adicionar um serviço. Crie um arquivo novo no seu próprio namespace. Por exemplo, escreva um data/my_pack/pet_errand/pick_flowers.json com base em weed.json, troque target por { "type": "blocks", "blocks": "#minecraft:small_flowers", "missing": "no_flower" } e tire requires e counter, e os pets de Agricultura vão colher por conta própria as florzinhas perto de casa. Depois adicione my_pack:pick_flowers à lista de serviços de pet_job/farmer.json, veja Profissões. O nome mostrado na tela vem de intent.my_pack.pick_flowers no arquivo de idioma do resource pack, e o motivo mostrado quando não há alvo, de intent.chiikawa.fail.no_flower.
O que acontece com erros. Um arquivo que não pode ser lido é ignorado, e o log diz qual é o arquivo e o que está errado; essa tarefa não começa mais até o arquivo ser corrigido e você rodar /reload. Listar em yields_to uma tarefa que não existe ou que tem outra prioridade, ou uma action que não combina com o target, também conta como erro. Um arquivo cujo nome não corresponde a nenhuma tarefa e que não tem action só gera um aviso no log.
