桌面模组文档角色模组
模组开发文档

角色模组

食物喜好与金币外观

用一点小偏好,让角色拥有自己的日常。

设定喜欢与不喜欢的食物

将以下字段合并到角色的 pet_conf.json。键必须是物品名称,不是图片文件名:

{
  "item_favorite": {"苹果": 2.0},
  "item_dislike": {"苦茶": 0.5}
}

数值表示好感度倍率。示例中,苹果对应 2 倍、苦茶对应 0.5 倍。请同时提供对应物品,或确认用户可以从其他物品模组获得它们。

角色对不同喜好的喂食反应可以用 feed_1、feed_2、feed_3 配置,见事件动作。

自定义金币名字与图片

在角色目录的 info/ 中准备 coin.png,再合并以下片段:

{
  "coin_config": {
    "name": {"zh_CN": "星星币", "en_US": "Star Coins"},
    "image": "info/coin.png"
  }
}

这里的图片路径从角色目录开始,因此带有 info/。它与作者资料文件里相对该资料目录的图片路径不同。

适用范围

这些是角色专属设置,不应复制到迷你宠物。迷你宠物需要自己的动画、召唤物品和联动配置,见迷你宠物教程。

Choose favorite and disliked foods

Merge these fields into the character’s pet_conf.json. Keys must be item names, not image file names:

{
  "item_favorite": {"Apple": 2.0},
  "item_dislike": {"Bitter Tea": 0.5}
}

Values are affection multipliers: 2× for the apple and 0.5× for the tea in this example. Include the items or ensure users can obtain them from another item mod.

Configure feeding reactions with feed_1, feed_2 and feed_3; see event actions.

Customize coin names and artwork

Place coin.png in the character’s info/ folder, then merge this fragment:

{
  "coin_config": {
    "name": {"zh_CN": "星星币", "en_US": "Star Coins"},
    "image": "info/coin.png"
  }
}

This image path starts at the character folder, so it includes info/. This differs from image paths inside the creator information file, which are relative to that information directory.

Where these settings apply

These are character-specific settings and should not be copied into mini-pets. Mini-pets need their own animations, summoning item and interactions; see the mini-pet tutorial.

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

使用指南

待后续补充

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

常见问题

待后续补充

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

QQ 群

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

群号557261268

QQ 群二维码

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