# Items Base — 物品、背包与物品的使用

Items Base 为游戏提供物品和装物品的背包。它定义物品是什么（名称、图片、价格、类型，以及使用时会发生什么），显示**背包**面板，保存玩家携带的东西，并让剧本能够发放、移除和检查物品。交易、烹饪、合成、装备和 RPG 地图都构建在它之上。

## 背包面板

用工具栏上的背包图标打开。点击左侧的物品，右侧会显示它的详情。

![在 RPG Plus 中使用森林蘑菇：网格中选中的蘑菇（×2），右侧是它的详情——"定向使用"和"食物"徽章、描述"恢复 5 点生命值"、带 heal 5 属性的 action/heal 动作——点击"吃"之后出现目标列表，英雄当前 10/24 生命值。](assets/use-mushroom.jpg)

- 顶部的**页签**按类型筛选（食物、资源、配方、任务）；搜索框和排序列表可以缩小网格范围。
- **详情**显示名称、类型徽章、价格、描述、堆叠上限、id 和物品自身的属性。
- **动作按钮**由物品自己命名：**使用**、食物显示**吃**、**对目标使用**、**学习配方**，或者物品自定义的动词（蘑菇因为带 `verb` 而显示**吃**）。
- **定向物品**会询问用在谁身上：选择一名队伍成员，或者**取消**。
- **丢弃**会在确认后扔掉一整堆；关键物品无法丢弃。
- 战斗中，每次使用或丢弃都要花掉当前角色一点行动点；战斗之外则免费。

![选择英雄之后：堆叠降到 ×1，面板提示"已使用：森林蘑菇 → 英雄"。](assets/after-use.jpg)

如果动作无法执行——比如目标生命值已满——物品不会被消耗，面板会说明原因。

## 物品的定义

物品是 mod 的 `items/` 文件夹里类型为 `item` 的 JSON 文件，图片就放在旁边。这是上面截图中的蘑菇（来自 RPG Demo）：

```json
{
  "Kind": "item",
  "Items": [
    {
      "Id": "rpg_demo/mushroom",
      "Name": "rpg_demo/item/mushroom/name",
      "Description": "rpg_demo/item/mushroom/desc",
      "Cost": 2,
      "Sprite": "rpg_demo/forest_mushroom",
      "ItemType": "Food,TargetUsed",
      "ItemAction": "action/heal",
      "heal": 5,
      "verb": "ui/inventory/verb_eat"
    }
  ]
}
```

- `Name`、`Description` — 翻译键，显示在详情里。
- `Cost` — 价格，商店会用到。
- `Sprite` — 图片 `items/rpg_demo/forest_mushroom.png`。
- `ItemType` — 一个或多个类型，用逗号分隔：`Food`、`Resource`、`Quest`、`Recipe`、`Used`（无需目标直接使用）、`TargetUsed`（对队伍成员使用）、`CantDrop`。
- `ItemAction` — 使用时做什么。`action/heal` 按物品的 `heal` 值恢复生命值，不会超过上限，也绝不会作用于倒下的角色。其他 mod 会添加自己的动作，例如装备的 `action/equip`。
- 其余任何键（`heal`、`verb`）都是物品属性：动作读取它们，详情也会列出。`verb` 决定动作按钮的名字。

## 剧本中的物品

```scenario
action item.add id=rpg_demo/mushroom count=2
when "item('rpg_demo/mushroom') >= 2" -> :enough
action item.remove id=rpg_demo/mushroom count=2
```

- `item.add` 把物品放进背包（宝箱、礼物、地图上的拾取物）；`count` 默认为 1。
- `item('id')` 比较玩家拥有多少个；可用于 `when`、选项条件、任务和地图事件。
- `item.remove` 移除物品；数量不足时会拒绝执行，所以请先用 `item('id')` 检查。

## 配方

配方（类型 `recipe`）列出 `Input` 和 `Output` 物品及数量。本 mod 负责记住玩家已学会哪些配方；烹饪和合成都会用到它们。

## 出问题时

1. **物品显示的是 id 而不是名字。** 把它的 `Name` 键加进 mod 的 `locale` 文件。
2. **没有动作按钮。** 物品需要在 `ItemType` 里带 `Used` 或 `TargetUsed`，并且设置 `ItemAction`。
3. **使用没有效果，物品也没消耗。** 动作拒绝了：治疗时目标生命值已满或已倒下。
4. **`item.add` 什么都没加。** id 未知；核对物品文件里的 `Id`。