mod_interactive_base/docs/zh.md

Interactive Base — 场景中可点击的对象

Interactive Base 为图像场景加入可点击的对象：地上的东西、一扇门、"墓穴后面"的某个位置。对象可以有一张叠在背景之上的图片，鼠标悬停时可以发光，点击则启动一段剧本。剧本会随着故事推进添加和移除对象。

Cthangover 的序章使用了它。RPG World 的图块地图则使用自己的事件。

在游戏中

Cthangover 开场时，小巷的自行车旁放着一块红布。它不是背景的一部分，而是一个带有独立图片的交互物。

当鼠标移到红布上时，指针变成手形，红布泛起一层淡淡的金色：

点击后启动红布的剧本：Marao 把它捡起来，剧本随即将这个对象从场景中移除。

交互对象

对象是 mod 的 interactives/ 文件夹里的 JSON 文件。下面就是截图中的红布（来自 Cthangover），轮廓顶点做了精简：

{
  "Items": [
    {
      "id": "cloak_ground",
      "texture": "cloak_ground",
      "layer": "foreground",
      "zIndex": 5,
      "cursor": "PointingHand",
      "hitArea": {
        "type": "polygon",
        "vertices": [
          { "x": 0.2796, "y": 0.7318 }, { "x": 0.3207, "y": 0.7167 },
          { "x": 0.3456, "y": 0.8434 }, { "x": 0.3387, "y": 0.8872 }
        ]
      },
      "highlight": { "color": "#FFD70044", "scale": 1, "duration": 0.12 },
      "actions": {
        "onClick": { "scenario": "scenarios/prolog/morning_cloak.scenario" }
      }
    }
  ]
}

• texture — 一张覆盖整个屏幕的图片，除对象本身外全部透明，因此能自动与背景对齐。想要看不见的点击区就省略它。
• hitArea — 对象可以被点击的范围，以屏幕比例（0–1）表示：rect 用 x、y、width、height；circle 用 x、y、radius；或 polygon 用 vertices。
• layer — background 或 foreground；两者都属于画面本身，位于对话框、工具栏和各面板之下。ui 则画在一切之上。
• zIndex — 同一图层内对象之间的先后顺序：数值越大越靠上绘制。
• cursor — 鼠标悬停在对象上时的指针样式，例如 PointingHand。
• highlight — 鼠标悬停时的染色效果：color（带透明度）、scale，以及淡入时长 duration（秒）。
• enabled、visible — 对象是否响应点击，以及最初是否绘制。
• actions — onClick 运行一个 scenario 文件或内联的 commands；onHoverEnter 和 onHoverLeave 执行剧本命令。

把对象放进场景

仅有定义不会出现在任何地方。场景的剧本负责添加它，而点击触发的剧本通常会移除它：

interactive_add cloak_ground
interactive_remove cloak_ground

切换场景时对象会被清空，因此 Cthangover 每次进入都用一段会检查剧情的场景剧本来重新添加它们：

scene: prolog_alley
priority: 15
condition: AwakeningQuest.notHasTag("cloak_taken") && AwakeningQuest.notHasTag("book_taken")
---
interactive_add cloak_ground
interactive_add book_ground
end

添加已存在的对象不会有任何效果，所以重复执行是安全的。

也可以在 Editor Tools 的交互编辑器里摆放对象并绘制点击区域。

出问题时

1. 点击没有反应。 对象从未在这个场景里添加过、enabled 未开启，或点击落在 hitArea 之外。
2. 图片位置不对。 贴图必须是与背景对齐的全屏图片，而不是一小块裁剪图。
3. 对象被拿走后又出现了。 添加它的剧本必须检查与点击剧本所设置的相同标签或标记。