할 일
펫이 하는 모든 일은 하나하나가 할 일이에요. 여러분을 따라가기, 일하기, 전표 받기, 쇼핑, 선물, 사진, 잠자기, 그리고 소일거리도요. pet_errand/에는 할 일마다 파일이 하나씩 있고, 파일 이름이 할 일의 ID예요. 예를 들어 pet_errand/gift_owner.json은 chiikawa:gift_owner예요. 게임에서 어떻게 작동하는지는 펫의 생각 읽기를 봐 주세요.
파일은 세 종류예요.
- 코드에 적힌 할 일. 따라가기, 쇼핑, 선물 같은 것들이에요. 파일에는 공통 필드만 있고, 얼마나 급한지, 얼마나 오래 하는지, 얼마나 쉬는지를 정해요.
- 작업. 파일에
action이 있는 것으로, 수확, 잡초 뽑기, 토벌, 연주 같은 것들이에요. 무엇을 하는지, 무엇을 대상으로 하는지가 모두 파일에 적혀 있어요. 아래의 작업을 봐 주세요. - 소일거리. 이것도 작업이지만
when과cast가 더 있어서, 언제 하는지와 누가 하는지를 적어요. 소일거리를 봐 주세요.
할 일을 고르는 방법
펫은 할 일을 고를 때마다, 먼저 지금 할 수 있는 할 일 중에서 가장 높은 우선순위를 찾고, 그 우선순위 안에서만 점수를 비교해요. 점수에는 먼저 전표와 의욕에 따른 가산이 더해지고, 그다음 성격의 배율이 곱해지고, 마지막으로 성격의 randomness만큼 운이 조금 섞여요. 점수가 가장 높은 할 일이 펫이 할 일이 돼요.
우선순위가 높은 할 일은 낮은 할 일을 끊을 수 있어요. 우선순위가 같은 할 일끼리는 서로 끊지 않아서, 하던 일을 먼저 끝내고, 점수가 아무리 높아도 차례를 기다려요. 그래서 성격의 배율은 같은 우선순위 안에서만 작동하고, 아무리 크게 해도 어슬렁거리기가 일을 이기지 못해요.
모드에 들어 있는 할 일과 기본 우선순위예요.
| 기본 우선순위 | 할 일 |
|---|---|
| 100 | flee 맞고도 반격하지 않을 때 도망치기 |
| 80 | melee, ranged 자기를 지키고, 여러분을 지키고, 주변 몬스터를 정리하기. defend_self 가방의 무기로 바꿔 들고 맞서기. gift_owner 손에 든 선물을 여러분에게 건네기. cooperate 다른 펫의 초대에 응하기. take_exam 시험 책상에 시험 보러 가기. check_results 다음 날 결과 보러 가기 |
| 50 | follow_owner 따라가기. take_task 게시판에 전표 받으러 가기. shop 쇼핑. answer_whistle 야생 펫이 피리 사탕 소리를 듣고 구경하러 오기. harvest 수확. plant 심기. deliver 수확물을 상자에 넣기. weed 잡초 뽑기. pick_mushroom 밤에 버섯 따기. hunt_melee, hunt_ranged 자유 행동 중에 집 근처 몬스터 정리하기, 토벌 전표가 세는 것이 이 둘이에요. play_music 연주 |
| 40 | take_photo 하치와레의 사진 찍기 |
| 30 | offer_gift 선물을 주고 싶을 때 가방에서 선물 고르기. socialize 다른 펫을 찾아가 작은 장면 연출하기. pick_up_item 땅에 있는 물건 줍기 |
| 10 | stay 앉아서 두리번거리기. wander 어슬렁거리기. sleep 잠자기. 모든 소일거리 |
이 숫자들은 약속일 뿐이에요. 모드가 숫자로 할 일을 나누지는 않으니, 모드팩에서 마음대로 바꿔도 돼요.
공통 필드
모든 할 일 파일에는 이 필드들이 있어요. 선물을 예로 들면 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
}
}| 필드 | 뜻 |
|---|---|
priority | 우선순위, 0 이상의 정수예요. 위를 봐 주세요 |
score | 같은 우선순위 안에서 얼마나 하고 싶은지, 0~1 |
max_ticks | 가장 오래 하는 시간이에요. 그때까지 끝나지 않으면 포기해요 |
rests | 끝냈을 때, 포기했을 때, 끊겼을 때 각각 얼마나 쉬는지, 아래를 봐 주세요 |
yields_to | 선택 사항. 같은 우선순위 안에서 먼저 양보하는 할 일이에요. 이 할 일들에 아직 할 게 있으면 시작하지 않아요. 우선순위가 같은 할 일만 적을 수 있어요 |
overlays | 선택 사항. 이 일을 하면서 곁들여 하는 작은 일이에요. 지금은 chiikawa:idle_chatter뿐이고, 어슬렁거리면서 가끔 혼잣말을 해요 |
start_voice | 선택 사항. 나설 때 한마디 하는 대사의 순간이에요. 예를 들어 근접 공격과 활 쏘기에는 hunt가 적혀 있어요 |
tuning | 그 할 일만의 수치예요. 아래를 봐 주세요 |
선물의 yields_to에는 근접 공격, 활 쏘기, 자기 지키기가 적혀 있어서, 싸우는 도중인 펫이 선물을 주러 자리를 뜨지는 않아요. 농부의 deliver는 harvest와 plant에, plant는 harvest에 양보해서, 언제나 먼저 수확하고, 다음에 심고, 상자에 넣는 건 맨 마지막이에요.
tuning의 형식은 할 일마다 달라요. 코드에 적힌 할 일은 그 할 일이 형식을 정하고, 작업은 그 action이 형식을 정해요. 필드를 하나도 빠뜨릴 수 없으니, 가장 쉬운 방법은 모드 jar의 data/chiikawa/pet_errand/에서 같은 할 일이나 같은 action의 파일을 복사해 숫자만 바꾸는 거예요. 몇몇 할 일은 tuning에 캐릭터마다 애니메이션을 적어 둬요. 예를 들어 flee의 cowers는 숨을 때의 자세, sleep의 sleeps는 잘 때의 자세예요. by_character에 캐릭터마다 적고, 나머지 캐릭터는 otherwise를 써요.
얼마나 쉬나요
rests의 done, gave_up, interrupted는 끝냈을 때, 포기했을 때, 끊겼을 때 그 할 일을 다시 하기까지 얼마나 쉬는지예요. 셋 다 적어야 하고, gave_up은 0이면 안 돼요. 0이면 포기하는 순간 바로 다시 시작해 버리기 때문이에요. 각각 세 가지로 적을 수 있어요.
| 적는 법 | 뜻 |
|---|---|
600 | 이 할 일 전체를 600틱 쉬어요 |
{ "ticks": 200, "per": "subject" } | 이번 대상에 대해서만 200틱 쉬어요. 손이 닿지 않던 그 작물이나 방금 같이 연출한 그 펫 같은 거예요. 다른 대상에게는 그대로 해요 |
{ "from": "chiikawa:gifting_cooldown" } | 얼마나 쉬는지를 다른 파일의 숫자로 정해요. "per": "subject"를 더할 수도 있어요 |
from에 적을 수 있는 건 이것들뿐이에요.
| 이름 | 가져오는 값 |
|---|---|
chiikawa:camera_cooldown | 카메라의 cooldown_ticks |
chiikawa:camera_retry | 카메라의 retry_ticks |
chiikawa:photo_upload_wait | 주인의 게임이 사진을 그려 낼 때까지 기다리는 시간 |
chiikawa:gifting_cooldown | 선물의 cooldown_ticks |
chiikawa:music_retry | 곡을 시작하지 못했을 때 다시 시도하기까지 기다리는 시간, 모드 설정에서 가져와요 |
chiikawa:scene_cooldown | 작은 장면들의 cooldown_ticks |
chiikawa:pastime_cooldown | 소일거리 자신의 tuning에 있는 cooldown_ticks를 모드 설정의 "소일거리"로 늘리거나 줄인 값 |
reports는 선택 사항으로, 결과를 나중에야 알 수 있을 때 얼마나 쉬는지를 적어요. 키 이름은 할 일이 스스로 정해요. 선물의 given은 선물을 건넨 뒤, 사진의 taken, stored, failed는 사진을 찍은 뒤, 저장한 뒤, 찍지 못한 뒤, 작은 장면의 played는 연출한 뒤예요.
작업
파일에 action이 있으면 작업이에요. 작업은 어떤 직업의 작업 목록에 적혀 있어야 그 직업의 펫이 해요. 소일거리만은 예외라서 모든 펫이 고려해요. 잡초 뽑기를 예로 들면 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 }
}위의 공통 필드 말고도 작업에는 이런 필드가 있어요.
| 필드 | 뜻 |
|---|---|
action | 어떻게 하는지, 아래 표를 봐 주세요 |
category | 어떤 종류의 일인지예요. 어떤 지시일 때 하는지가 정해져요. 아래 표를 봐 주세요 |
counter | 선택 사항. 한 번 할 때마다 어떤 전표의 진행도가 되는지예요. 들고 있는 전표가 이 작업을 세는 것이면 점수가 조금 올라가요 |
requires | 선택 사항. 추가 조건이에요. wild_or_slip은 야생 펫은 알아서 하지만, 여러분의 펫은 이 작업을 세는 전표를 들고 있을 때만 한다는 뜻이고, 이걸 적으면 counter도 꼭 적어야 해요. at_night는 밤에만 한다는 뜻이에요 |
target | 무엇을 대상으로 하는지예요. action에 따라 꼭 적어야 하는 것도, 적으면 안 되는 것도 있어요. 아래 표를 봐 주세요 |
action에는 모드에 있는 이것들만 적을 수 있어요.
action | 하는 일 | target | 모드에 들어 있는 파일 |
|---|---|---|---|
chiikawa:harvest_block | 블록을 부수고 얻은 것을 가방에 넣어요 | ripe_crop 또는 blocks | harvest, weed, pick_mushroom |
chiikawa:plant_block | 가방의 씨앗을 심어요 | plantable_soil | plant |
chiikawa:deposit | 가방의 물건을 보관함에 넣어요 | container | deliver |
chiikawa:strike | 검으로 공격해요 | foe | melee, hunt_melee |
chiikawa:shoot | 활로 쏴요 | foe | ranged, hunt_ranged |
chiikawa:busk | 오르골로 연주해요 | 적지 않아요 | play_music |
chiikawa:perform, chiikawa:visit, chiikawa:ask_praise | 소일거리, 소일거리를 봐 주세요 | 적지 않아요 | 그 페이지를 봐 주세요 |
target의 type은 다섯 가지이고, 모두 missing을 적어야 해요. 아래를 봐 주세요.
type | 무엇을 대상으로 하나요 | 더 적을 것 |
|---|---|---|
ripe_crop | 다 자란 작물 | 없음 |
plantable_soil | 가방의 씨앗을 심을 수 있는 경작지. 가방에 씨앗이 없으면 찾지 않아요 | 없음 |
blocks | 어떤 블록 태그에 든 블록. 두 칸 높이의 식물은 아래 칸만 쳐요 | blocks, 블록 태그를 적어요 |
container | 가방의 물건을 받아 줄 수 있는 보관함. 넣을 물건이 가방에 없으면 찾지 않아요 | blocks에 보관함의 블록 태그, items에 넣을 물건의 아이템 태그 |
foe | 펫이 노리고 있는 적 | grounds, 왜 싸우는지 적어요. 아래를 봐 주세요 |
블록 대상은 펫이 스스로 찾고, 얼마나 멀리까지 찾는지는 직업 파일의 sight에 적혀 있어요. 직업을 봐 주세요.
foe의 grounds에는 이 작업이 어떤 이유로 싸우는지 적고, 여러 개를 적을 수 있어요. self는 자기를 때렸거나 노리는 상대, owner는 여러분을 때렸거나, 여러분이 때리고 있거나, 여러분을 노리는 상대, nearby는 여러분을 따라올 때나 야생에 있을 때 주변에 있는 적대적 몹, hunt는 자유 행동 중일 때 집 근처에 있는 적대적 몹이에요. 모드에 들어 있는 melee와 ranged는 앞의 세 가지를 적고 우선순위가 80이에요. hunt_melee와 hunt_ranged는 hunt만 적고 우선순위가 일과 같은 50이라서, 몬스터를 정리하느라 하던 일을 끊지는 않아요.
missing은 대상이 없을 때 펫 화면에 나오는 이유로, 리소스 팩 언어 파일에서 intent.chiikawa.fail. 뒤에 오는 부분이에요. 예를 들어 no_weed는 intent.chiikawa.fail.no_weed, 곧 "근처에 잡초가 없어"예요.
자주 쓰는 category는 이것들이에요.
category | 누가 하나요 |
|---|---|
work | 자유 행동 중인 여러분의 펫 |
forage | 야생 펫, 그리고 자유 행동 중인 여러분의 펫 |
combat | 앉아 있는 펫 말고 모두 |
pastime | 어슬렁거릴 때, 소일거리를 봐 주세요 |
나머지(follow_owner, stay, wander, pick_up, take_task, shop, gift, social, exam, curious, photo, sleep, safety)는 코드에 적힌 할 일들이 쓰는 것이라, 작업에는 보통 쓸 일이 없어요. pick_up은 펫 화면의 "자동 줍기" 스위치로 켜고 꺼요. 펫의 화면을 봐 주세요.
바꾸기와 더하기
할 일 바꾸기. data/chiikawa/pet_errand/ 아래에 같은 이름의 파일을 두면 모드의 파일이 통째로 대체되니, 필드를 모두 적어야 해요. 코드에 적힌 할 일은 작업으로 바꿀 수 없어서, 그 파일에는 action을 적을 수 없어요.
작업 더하기. 자기 네임스페이스 아래에 새 파일을 만들어요. 예를 들어 weed.json을 본떠 data/my_pack/pet_errand/pick_flowers.json을 쓰고, target을 { "type": "blocks", "blocks": "#minecraft:small_flowers", "missing": "no_flower" }로 바꾸고, requires와 counter를 지우면 농부가 집 근처의 작은 꽃을 알아서 따러 가요. 그다음 my_pack:pick_flowers를 pet_job/farmer.json의 작업 목록에 더해 주세요. 직업을 봐 주세요. 화면에 나오는 이름은 리소스 팩 언어 파일의 intent.my_pack.pick_flowers에서, 대상이 없을 때의 이유는 intent.chiikawa.fail.no_flower에서 가져와요.
잘못 적으면. 읽을 수 없는 파일은 건너뛰고, 로그에 어느 파일의 무엇이 잘못됐는지 나와요. 그 할 일은 파일을 고치고 /reload할 때까지 시작되지 않아요. yields_to에 존재하지 않는 할 일이나 우선순위가 다른 할 일을 적었을 때, action과 target이 맞지 않을 때도 잘못 적은 걸로 쳐요. 파일 이름이 어떤 할 일과도 맞지 않고 action도 없는 파일은 로그에 한마디 알려 주기만 해요.
