桌面模组文档迷你宠物
模组开发文档

迷你宠物

昼夜作息

把睡眠与夜间动作纳入迷你宠物的日常。

与角色使用相同配置

迷你宠物的昼夜作息配置与角色一致:在动作组中标记 phase: "night",再用 day_night 指定睡眠循环、夜间随机动作和过渡动作。

这是迷你宠物的日常行为配置,不属于进阶功能。配置写在迷你宠物自己的 pet_conf.json 中,动作定义和素材也来自这位迷你宠物。

按同一套步骤接入

完整步骤、字段表和示例统一放在昼夜作息配置,避免两份说明出现差异。

  1. 准备迷你宠物自己的睡眠动作,写入其 act_conf.json。
  2. 在迷你宠物的 random_act 或 accessory_act 中添加夜间动作组。
  3. 在同一份 pet_conf.json 中填写 day_night,引用这些组的 name。
  4. 在软件设置中开启昼夜作息,再测试睡眠、起床及配置过的夜间反应。

复制角色示例时,替换动作名和组名,确保它们指向迷你宠物自身的素材。

与其他联动分开理解

昼夜作息不需要先配置 main_interact。后者用于迷你宠物与主角色的专属联动,其具体格式后续另行补充,不影响先完成这套共用的作息配置。

The same configuration as characters

Mini-pets use the same day/night configuration as characters: mark action groups with phase: "night", then use day_night for sleep loops, random nighttime actions and transitions.

This is part of everyday mini-pet behavior, not an advanced feature. Configure it in the mini-pet’s own pet_conf.json, using that mini-pet’s animations and assets.

Follow the shared steps

The full workflow, field reference and examples are maintained in day/night configuration so the instructions stay consistent.

  1. Prepare the mini-pet’s sleep animation in its act_conf.json.
  2. Add nighttime groups to its random_act or accessory_act.
  3. Add day_night to the same pet_conf.json, referencing those groups by name.
  4. Enable day/night routines in the app and test sleep, waking up and any nighttime reactions you configured.

When copying a character example, replace animation and group names with ones that belong to the mini-pet’s own assets.

Separate this from other interactions

Day/night routines do not require setting up main_interact first. That field handles dedicated interactions with the main character; its format will be documented separately. It does not prevent you from completing the shared day/night setup.

文档持续完善中。 查看原始开发文档 ↗

使用指南

待后续补充

使用指南将在后续补充,介绍呆啵桌宠的设置与日常使用。

常见问题

待后续补充

常见问题将在后续补充,汇总使用过程中常遇到的问题与解答。

QQ 群

一起分享使用体验,抢先测试新版

群号557261268

QQ 群二维码

使用 QQ 扫码,或搜索群号加入。