物品模组
物品参数速查
按物品用途查字段、默认值与注意事项。
先选对类型
| 类型 | 数值效果 | 其他配置注意事项 |
|---|---|---|
consumable |
可设置饱食度、好感度和增益 | 使用后消耗 |
collection |
普通收藏品使用不触发数值效果 | 不需要填写 effect_HP、effect_FV，不建议配置 drop_rate、buff |
dialogue |
不应配置饱食度、好感度和增益 | 还需角色对话文件与名称映射 |
subpet |
不配置 effect_HP、effect_FV、drop_rate |
用于召唤迷你宠物，可配置增益 |
展示收藏品用 check_item；穿戴收藏品用 Equip。两者都属于 collection，用途不同。
图片、描述与直接效果
下表默认值来自开发文档底本。制作时显式填写你希望控制的数值，尤其是价格和解锁等级。
| 字段 | 类型 / 默认值 | 说明 |
|---|---|---|
image |
字符串，必填 | 对应物品图片，推荐正方形画布 |
description |
字符串，默认空字符串 | 展示给用户的说明 |
type |
字符串，默认 consumable |
物品类型 |
effect_HP |
整数，默认 0 | 使用后改变饱食度，负数表示降低 |
effect_FV |
整数，默认 0 | 使用后改变好感度，负数表示降低 |
buff |
对象，默认 {} |
持续效果，见增益说明 |
商店、奖励与角色限定
| 字段 | 类型 / 默认值 | 说明 |
|---|---|---|
fv_lock |
整数，默认 1 | 解锁好感等级；底本范围为 0–7 |
cost |
数字，默认 50*(fv_lock+1) |
建议自行定价；正整数出售，-1 不上架商店 |
fv_reward |
等级列表，默认 [] |
哪些好感等级升级时赠送此物品，例如 [1, 2] |
pet_limit |
角色名称列表，默认 [] |
限定与哪些角色关联；名字应与实际角色一致 |
drop_rate |
数字，默认 0 | 随机掉落相对权重，0 表示不掉落；不是百分比 |
即使只有一个奖励等级，fv_reward 也写成列表，例如 [2]。
常见排查
- 商店里看不到：检查
cost、fv_lock、角色限制，以及该模组是否成功导入。 - 图片缺失：核对
image路径、扩展名和大小写。 - 数值没有改变：先检查类型；收藏品和对话物品不能按食物的效果设计。
- 专属物品没有关联：核对
pet_limit中的角色名称，别填图片前缀或展示昵称。
Choose the right type first
| Type | Stat effects | Other considerations |
|---|---|---|
consumable |
Can change satiety and affection and apply buffs | Consumed after use |
collection |
Ordinary collectibles do not apply stat effects on use | Omit effect_HP and effect_FV; drop_rate and buff are not recommended |
dialogue |
Should not configure satiety, affection or buffs | Needs a character dialogue file and name mapping |
subpet |
Omit effect_HP, effect_FV and drop_rate |
Summons a mini-pet; can have buffs |
Use check_item for displaying a collectible and Equip for wearing one. Both are collection items with different purposes.
Images, descriptions and direct effects
Defaults below come from the developer guide. Explicitly set values you want to control, particularly prices and unlock levels.
| Field | Type / default | Meaning |
|---|---|---|
image |
Required string | Item image; square canvas recommended |
description |
String, empty by default | Description shown to users |
type |
String, consumable |
Item type |
effect_HP |
Integer, 0 | Satiety change on use; negative values reduce it |
effect_FV |
Integer, 0 | Affection change on use; negative values reduce it |
buff |
Object, {} |
Lasting effects; see buffs |
Shop, rewards and character restrictions
| Field | Type / default | Meaning |
|---|---|---|
fv_lock |
Integer, 1 | Required affection level; the source range is 0–7 |
cost |
Number, 50*(fv_lock+1) |
Set your own price; positive integers sell it, -1 hides it from the shop |
fv_reward |
Level list, [] |
Levels that award the item on level-up, such as [1, 2] |
pet_limit |
Character-name list, [] |
Restricts associated characters; match their actual names |
drop_rate |
Number, 0 | Relative drop weight; 0 disables drops, not a percentage |
Use a list even for one reward level, such as [2].
Troubleshooting
- Missing from the shop: check
cost,fv_lock, character restrictions and successful import. - Missing image: check the path, extension and case in
image. - No stat change: check the type first; collectibles and dialogue items do not behave like food.
- Missing character association: check names in
pet_limit; do not use image prefixes or display nicknames.
文档持续完善中。 查看原始开发文档 ↗