差事
宠物做的每一件事都是一件差事:跟着你、干活、领牌、逛商店、送礼、拍照、睡觉,还有闲暇时的小动作。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,不然放弃的那一刻它又会马上重新开始。每一项有三种写法:
| 写法 | 意思 |
|---|---|
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 | 一首歌没能开始时,等多久再试,来自模组设置 |
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 的,只会在日志里提醒一句。
