Skip to content

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, when e cast, 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ãoTarefas
100flee fugir quando apanha sem revidar
80melee, 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
50follow_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
40take_photo o Hachiware tirar fotos
30offer_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
10stay 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:

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
  }
}
CampoSignificado
priorityA prioridade, um número inteiro de 0 para cima, veja acima
scoreQuanta vontade tem de fazer a tarefa dentro da sua prioridade, de 0 a 1
max_ticksO tempo máximo que gasta nela; se não terminar até lá, desiste
restsQuanto tempo descansa depois de terminar, desistir ou ser interrompido, veja abaixo
yields_toOpcional, 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
overlaysOpcional, 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_voiceOpcional, um momento de fala para dizer quando sai; luta corpo a corpo e tiro, por exemplo, têm hunt
tuningOs 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 comoSignificado
600A 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:

NomeUsa
chiikawa:camera_cooldownO cooldown_ticks da câmera
chiikawa:camera_retryO retry_ticks da câmera
chiikawa:photo_upload_waitO tempo de espera até o jogo do dono desenhar a foto
chiikawa:gifting_cooldownO cooldown_ticks dos presentes
chiikawa:music_retryQuanto esperar antes de tentar de novo quando uma música não conseguiu começar, das configurações do mod
chiikawa:scene_cooldownO cooldown_ticks das pequenas cenas
chiikawa:pastime_cooldownO 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:

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:

CampoSignificado
actionComo é feito, veja a tabela abaixo
categoryQue tipo de coisa é, o que decide em qual ordem é feito, veja a tabela abaixo
counterOpcional, 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
requiresOpcional, 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
targetCom o que é feito; algumas action exigem, outras não aceitam, veja a tabela abaixo

action só pode ser um destes, que o mod tem:

actionO que faztargetArquivos do próprio mod
chiikawa:harvest_blockQuebra o bloco e guarda o que sai na mochilaripe_crop ou blocksharvest, weed, pick_mushroom
chiikawa:plant_blockPlanta sementes da mochilaplantable_soilplant
chiikawa:depositGuarda coisas da mochila em um recipientecontainerdeliver
chiikawa:strikeBate com uma espadafoemelee, hunt_melee
chiikawa:shootAtira com um arcofoeranged, hunt_ranged
chiikawa:buskSe apresenta com a Caixa de MúsicaNão se escreveplay_music
chiikawa:perform, chiikawa:visit, chiikawa:ask_praisePassatempos, veja PassatemposNão se escreveVeja aquela página

Há cinco type de target, e todos precisam de um missing, veja abaixo:

typeCom o que é feitoTambém precisa de
ripe_cropPlantações madurasNada
plantable_soilTerra arada que aceita as sementes da mochila; não procura enquanto não tiver sementesNada
blocksBlocos de uma tag de blocos; nas plantas de dois blocos de altura, só o bloco de baixo contablocks, uma tag de blocos
containerRecipientes que aceitam coisas da mochila; não procura enquanto não tiver nada para guardarblocks, a tag de blocos dos recipientes, e items, uma tag de itens do que guardar
foeUm inimigo em que o pet está de olhogrounds, 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:

categoryQuem faz
workOs seus pets no modo Livre
forageOs pets selvagens, e os seus pets no modo Livre
combatTodos, menos os pets na ordem Sentar
pastimePets 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.

Unofficial fan-made mod, not affiliated with Nagano / Chiikawa rights holders. No official assets are used.

Unofficial fan-made mod, not affiliated with Nagano / Chiikawa rights holders.
京ICP备2024085629号