物品模组
制作第一个物品
从一张图片和一件食物，认识物品模组的配置。
先准备一件小物品
物品模组通常放在 res/items/模组名字/。核心是物品图片和 items_config.json，模组及作者资料使用 info.json。
物品图片尽量使用正方形画布，方便在商店与背包中显示。
配置一颗苹果
下面是一个完整的 items_config.json 示例。将 apple.png 放在同一模组文件夹中：
{
"苹果": {
"image": "apple.png",
"description": "爽脆可口的酸甜果实。",
"type": "consumable",
"effect_HP": 3,
"effect_FV": 3,
"cost": 200,
"fv_lock": 0
}
}使用这颗苹果会增加 3 点饱食度和 3 点好感度，随后物品被消耗。这里的数值只是制作示例，可以根据自己的设计调整。
选择物品类型
type |
使用后的行为 | 继续阅读 |
|---|---|---|
consumable |
消耗品，用后消失，可增加饱食度与好感度 | 物品增益 |
collection |
收藏品，用后保留；普通收藏品不触发数值效果 | 可穿戴物品 |
dialogue |
触发预先编写的分支对话 | 对话物品 |
subpet |
召唤迷你宠物 | 迷你宠物 |
获取方式与解锁
| 字段 | 用途 |
|---|---|
cost |
商店价格；-1 表示不在商店出售 |
fv_lock |
在指定好感等级解锁 |
fv_reward |
哪些好感等级升级时奖励该物品，使用等级列表 |
pet_limit |
限定关联角色，使用角色名字列表 |
drop_rate |
随机掉落的相对权重；不是直接的百分比 |
根据物品类型选择合适的字段。召唤物品、对话物品与普通消耗品的配置用途不同，不要把食物的效果照搬到所有类型。
Prepare a small item
Item mods usually live in res/items/ModName/. The core files are the item images and items_config.json; info.json holds mod and creator information.
Prefer a square canvas for images so they display well in the shop and inventory.
Configure an apple
This is a complete items_config.json example. Place apple.png in the same mod folder:
{
"Apple": {
"image": "apple.png",
"description": "A crisp, sweet and tangy fruit.",
"type": "consumable",
"effect_HP": 3,
"effect_FV": 3,
"cost": 200,
"fv_lock": 0
}
}Using this apple adds 3 satiety and 3 affection, then consumes the item. These are example values; adjust them to your design.
Choose an item type
type |
What happens when used | Read more |
|---|---|---|
consumable |
Disappears after use; can increase satiety and affection | Item buffs |
collection |
Remains after use; ordinary collectibles do not apply stat effects | Wearable items |
dialogue |
Starts a predefined branching conversation | Dialogue items |
subpet |
Summons a mini-pet | Mini-pets |
Acquisition and unlocking
| Field | Purpose |
|---|---|
cost |
Shop price; -1 keeps it out of the shop |
fv_lock |
Affection level required to unlock it |
fv_reward |
List of affection levels that award this item on level-up |
pet_limit |
List of associated character names |
drop_rate |
Relative drop weight, not a direct percentage |
Choose fields according to the item type. Summoning items, dialogue items and ordinary consumables have different roles; do not copy food effects into every type.
For defaults, type restrictions and common issues, see the item field reference. Add info.json at the item-mod root before sharing.
文档持续完善中。 查看原始开发文档 ↗