用事
なかまのすることは、どれもひとつの用事です。あなたについていく、お仕事をする、カードを受ける、お買い物、プレゼント、写真、眠ること、それにひまつぶしも用事です。pet_errand/ の下に用事ごとに1ファイルあり、ファイル名が用事のidです。たとえば pet_errand/gift_owner.json は chiikawa:gift_owner です。遊び方は何を考えているかを見てください。
ファイルは3種類あります。
- コードで決まっている用事。たとえばついていく、お買い物、プレゼント。ファイルには共通のフィールドだけがあり、どれだけ大事か、どれだけ続けるか、どれだけ休むかを決めます。
- 作業。ファイルに
actionがあるもので、たとえば収穫、草むしり、討伐、演奏。何をするか、何に対してするかがファイルに書かれています。下の作業を見てください。 - ひまつぶし。これも作業の一種で、さらに
whenとcastがあり、いつするか、誰がするかを書きます。ひまつぶしを見てください。
用事の選び方
なかまは用事を選ぶたびに、まずいまできる用事の中でいちばん高い優先度を探し、その優先度の中だけでスコアを比べます。スコアには、まずお仕事カードとやる気のぶんが足され、次に性格の係数がかけられ、最後に性格の randomness に応じて少しだけ運が加わります。いちばん高い用事が、なかまのすることになります。
優先度の高い用事は、低い用事を中断させられます。優先度が同じ用事どうしは中断し合わず、いまやっているものを先に終わらせます。スコアがどれだけ高くても順番待ちです。だから性格の係数が効くのは同じ優先度の中だけで、どれだけ大きくしても、ぶらぶらがお仕事に勝つことはありません。
MOD標準の用事と、デフォルトの優先度です。
| デフォルトの優先度 | 用事 |
|---|---|
| 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 自由行動のときにおうちの近くの敵を片づける。討伐カードが数えるのはこの2つです。play_music 演奏 |
| 40 | take_photo ハチワレが写真を撮る |
| 30 | offer_gift プレゼントしたくなったときに持ち物からプレゼントを選ぶ。socialize ほかのなかまを探してふれあいを演じに行く。pick_up_item 地面のものを拾う |
| 10 | stay 座ってきょろきょろする。wander ぶらぶら。sleep 眠る。すべてのひまつぶし |
これらの数字はただの決まりごとで、MODは数字で用事を分けてはいません。MODパックで自由に変えてかまいません。
共通のフィールド
どの用事のファイルにも、次のフィールドがあります。プレゼントを例に見てみましょう。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 が形を決めます。フィールドはひとつも省略できないので、いちばん手軽なのは、MODのjarの data/chiikawa/pet_errand/ から同じ用事か、同じ action のファイルをコピーして、数値だけ変えることです。いくつかの用事は tuning にキャラクターごとのアニメーションを書いています。たとえば flee の cowers は隠れるときの姿勢、sleep の sleeps は眠るときの姿勢で、by_character にキャラクターごとに書き、ほかのキャラクターは otherwise を使います。
どれだけ休むか
rests の done、gave_up、interrupted は、終わったとき、あきらめたとき、中断されたときに、その用事をまたするまでどれだけ休むかです。3つとも書く必要があり、gave_up は0にできません。0だと、あきらめたその瞬間にまたすぐ始めてしまうからです。どれも3通りの書き方があります。
| 書き方 | 意味 |
|---|---|
600 | この用事まるごとを600 tick休む |
{ "ticks": 200, "per": "subject" } | 今回の相手に対してだけ200 tick休む。たとえば届かなかったあの作物や、いっしょに演じたばかりのあのなかまで、ほかの相手にはふつうにします |
{ "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 | 曲を始められなかったとき、また試すまで待つ時間。MODの設定から来ます |
chiikawa:scene_cooldown | ふれあいの cooldown_ticks |
chiikawa:pastime_cooldown | ひまつぶし自身の tuning にある cooldown_ticks を、MODの設定の「ひまつぶし」で伸び縮みさせたもの |
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 | 省略可。1回するごとに、どのお仕事カードの進み具合になるか。持っているカードがこの作業を数えるものなら、スコアが少し上がります |
requires | 省略可。ほかの条件です。wild_or_slip は、野生のなかまは自分からするけれど、自分のなかまはこの作業を数えるカードを持っているときだけする、という意味で、書くときは counter も必要です。at_night は夜だけする、という意味です |
target | 何に対してするか。action によって、必ず書くものと、書けないものがあります。下の表を見てください |
action に書けるのは、MODにある次のものだけです。
action | すること | target | MOD標準のファイル |
|---|---|---|---|
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 は5種類で、どれにも missing を書きます。下を見てください。
type | 何に対してするか | ほかに書くもの |
|---|---|---|
ripe_crop | 実った作物 | なし |
plantable_soil | 持ち物の種を植えられる耕地。持ち物に種がないときは探しません | なし |
blocks | あるブロックタグに入っているブロック。2ブロックの高さの植物は、下のブロックだけを数えます | blocks。ブロックタグを書きます |
container | 持ち物のものを受け入れられる入れ物。しまうものが持ち物にないときは探しません | blocks に入れ物のブロックタグ、items にしまうもののアイテムタグ |
foe | なかまが目をつけた敵 | grounds。なぜ戦うかを書きます。下を見てください |
ブロックの相手は、なかまが自分で探します。どこまで探すかは職業ファイルの sight に書かれています。職業を見てください。
foe の grounds には、この作業がどんな理由で戦うかを書き、いくつでも書けます。self は自分を攻撃した相手や自分を狙っている相手、owner はあなたを攻撃した相手、あなたが攻撃している相手、あなたを狙っている相手、nearby はついてくるときや野生のときにまわりにいる敵対モブ、hunt は自由行動のときにおうちの近くにいる敵対モブです。MOD標準の melee と ranged は前の3つを書いていて、優先度は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/ の下に同じ名前のファイルを置くと、MOD標準のものがまるごと置き換わるので、フィールドはすべて書きます。コードで決まっている用事を作業に変えることはできず、そのファイルに 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 もないファイルは、ログでひと言知らせるだけです。
