物品模组
物品增益
让一次使用带来持续一段时间的效果。
什么是 Buff？
除了使用瞬间增加数值，有些物品和迷你宠物还能带来持续效果，例如每隔一段时间增加饱食度、好感度或金币。
物品的增益配置放在 buff 中。
一段持续的饱食度增益
把下面的 buff 字段合并进消耗品配置。它会在 120 秒内，每 30 秒增加 2 点饱食度：
{
"buff": {
"effect": "hp",
"interval": 30,
"value": 2,
"expiration": 120,
"description": "每 30 秒增加 2 点饱食度，持续 2 分钟。"
}
}这是配置片段，不是完整的 items_config.json。物品仍需配置名字、图片和类型等信息。
支持的效果
effect |
效果 | 主要参数 |
|---|---|---|
hp |
定时改变饱食度 | interval、value、expiration |
fv |
定时改变好感度 | interval、value、expiration |
coin |
定时增加金币 | interval、value、expiration；值不可为负 |
HP_stop |
暂停饱食度下降 | expiration |
FV_stop |
暂停饥饿造成的好感度下降 | expiration |
时间字段的单位是秒。描述文字应说明实际效果和持续时间，方便用户决定何时使用。
暂停数值下降
下面是合并到消耗品的 buff 示例，持续 120 秒暂停饱食度下降。这种效果不需要填写 interval 或 value：
{
"buff": {
"effect": "HP_stop",
"expiration": 120,
"description": "暂停饱食度下降，持续 2 分钟。"
}
}迷你宠物的增益
迷你宠物的增益写在召唤物品的 buff 中。现有样例使用如下定时金币效果：
{
"buff": {
"effect": "coin",
"interval": 30,
"value": 5,
"description": "每 30 秒带来 5 枚金币。"
}
}这也是物品条目的合并片段。迷你宠物样例没有填写消耗品的 expiration，不要直接套用食物的持续时间；在软件中检查召唤与收回时的实际效果。召唤物品的其余配置见迷你宠物教程。
What is a buff?
Some items and mini-pets provide ongoing effects rather than an immediate stat change. Examples include periodically increasing satiety, affection or coins.
Item buffs are configured in buff.
A lasting satiety effect
Merge this buff field into a consumable item. It adds 2 satiety every 30 seconds for 120 seconds:
{
"buff": {
"effect": "hp",
"interval": 30,
"value": 2,
"expiration": 120,
"description": "Adds 2 satiety every 30 seconds for 2 minutes."
}
}This is a fragment, not a complete items_config.json. The item still needs its name, image, type and other relevant settings.
Supported effects
effect |
Effect | Main fields |
|---|---|---|
hp |
Periodic satiety change | interval, value, expiration |
fv |
Periodic affection change | interval, value, expiration |
coin |
Periodic coin gain | interval, value, expiration; value cannot be negative |
HP_stop |
Pause satiety loss | expiration |
FV_stop |
Pause affection loss caused by hunger | expiration |
Time values are in seconds. Describe the effect and its duration clearly so users know when to use the item.
Pause a decreasing stat
Merge this buff into a consumable to pause hunger loss for 120 seconds. This effect does not need interval or value:
{
"buff": {
"effect": "HP_stop",
"expiration": 120,
"description": "Pause hunger loss for 2 minutes."
}
}Buffs from mini-pets
Configure a mini-pet’s buff in its summoning item’s buff field. Existing examples use a periodic coin effect like this:
{
"buff": {
"effect": "coin",
"interval": 30,
"value": 5,
"description": "Bring 5 coins every 30 seconds."
}
}This is another fragment to merge into an item entry. Existing mini-pet examples omit the consumable’s expiration; do not simply copy a food item’s duration. Check the effect when summoning and retracting the mini-pet in the app. For the rest of the summoning item setup, see mini-pets.
文档持续完善中。 查看原始开发文档 ↗