---
title: "行为"
description: "行为是引擎不经 AI 自己执行的「如果……就……」规则：触发、条件、效果、能传值的按钮、时刻，以及代码。"
---

# 行为

行为就是「如果……就……」。它由引擎自己执行，不用 AI 参与，所以很稳：说好 Yumina 的心意在好感 80 时打开，那就正好在 80 打开。

这和变量上的「行为规则」不一样。行为规则是教 AI 怎么改一个数。行为是引擎自己动手。

## 什么时候用行为

- 阈值：「好感到 80，打开一条隐藏设定」
- 节奏：「每 5 回合推进一次时间」
- 按钮：「玩家买酒时，扣 5 个金币」
- 一次性的惊喜：「第一次干杯时，弹出一张图」

## 加一条行为

点卡底下 **还可以加** 那一排里的 **＋ 行为**，新行为的设置会马上展开：

![刚加的新行为](./images/canvas/w-beh-new.webp)

每条行为有三段：**什么时候触发**、**如果……**（可以不写）和 **效果**。下面这条是「好感涨到 80 以上时，给玩家弹个提示」：

![好感到 80](./images/canvas/w-beh-done.webp)

好感和这条行为之间那根虚线是画布自己画的。意思是这条行为在看着这个变量。

行为多了以后，行为块是一行一个：

![行为多了以后](./images/canvas/behaviors.webp)

### 什么时候触发

| 触发 | 什么时候 |
|---|---|
| 每回合 | 每次玩家和 AI 来回一轮之后 |
| 每 N 回合 | 按固定间隔 |
| 每隔几秒 | 按真实时间，只在玩家开着游戏的时候走 |
| 会话开始 | 新开一局时 |
| 玩家说出关键词 / AI 说出关键词 | 消息里出现某个词时 |
| 变量变化 | 某个变量的值变了时 |
| 变量越过阈值 | 数值往上或往下越过一条线的那一刻 |
| 玩家点了某个按钮 | 玩家界面上的按钮叫它 |

### 如果……（可以不写）

变量等于、大于或小于某个值，或者和另一个变量比。有好几个条件的话，选 **全部满足** 或 **任一满足**。

条件不成立的时候，可以在 **条件不满足时告诉玩家** 里写一句话，比如「金币不够，要 {param.price}」。空着的话，什么都不会发生，玩家也不知道为什么按钮没反应。

### 效果

点 **加一个效果**。效果分成几组：

![选一个效果](./images/canvas/w-effect-menu.webp)

| 组 | 效果 | 做什么 |
|---|---|---|
| 游戏 | 修改变量 | 设为、加上、减去、乘以、切换、追加 |
| | 启用/禁用变量 | 让一个变量出现或藏起来 |
| | 启用/禁用情境 | 打开或关掉一个情境。设成「只看启用开关」的情境就靠它 |
| AI 与故事 | 告诉 AI | 给 AI 塞一句玩家看不到的话 |
| | 启用词条 / 禁用词条 | 打开或关掉一条设定 |
| 音频 | 播放音乐 / 播放音效 / 停止音频 | |
| 玩家 | 显示通知 | 给玩家弹一个提示 |
| | 解锁一个时刻 | 一张带图的小卡片，见下面 |
| 高级 | 启用/禁用行为 | 开关别的行为，可以连成一串 |
| | 随机抽取 | 从好几个效果里跑一个，公平地轮着来 |

一条行为可以有好几个效果。按顺序执行。

### 停止条件

最底下有一栏 **停止条件**，可以不写。写了的话，条件成立的时候这条行为就不跑，条件不再成立时又照常跑。比如「好感到 100 就别再提醒了」。想让它只跑几次，用下面其它选项里的 **最大触发次数**。

## 按钮传值

玩家界面上的按钮叫行为的时候，可以顺便 **传一个值进去**。比如酒馆的菜单上每种酒一个按钮，都叫同一条「买一杯蘑菇酒」行为。只是传进去的 **价格** 不一样：

- 按钮那边：**让一条行为生效** → 选「买一杯蘑菇酒」→ **＋ 传一个值进去**，名字写「price」，值写 `5`（也可以写 `{{某个变量}}`）
- 行为这边：条件写 `金币 ≥ {param.price}`，效果写 `金币 减去 {param.price}`，条件不满足时告诉玩家「金币不够，一杯要 {param.price}。」

一条行为就管了整张菜单

![买一杯蘑菇酒：价格从按钮传进来](./images/canvas/behavior.webp)

## 时刻

**解锁一个时刻** 给玩家一张小卡片：一个标题、一句话、一张图，像游戏里的成就或 CG。填好 **标题** 和 **图片（链接）**，再选 **收进哪个列表**。

![解锁一个时刻](./images/canvas/behavior-moment.webp)

一个时刻进了列表，就不会再弹第二次。把那个列表变量设成 **跨存档保留**（在变量的设置里），每个玩家就只会得到它一次，重开新局也一样。CG 图鉴和多结局收集都是建在这上面的。

## 代码行为

会写一点 JavaScript 的话，行为的效果里可以放一段 **代码**，玩的时候在卡里运行。它能读写变量、弹提示、让 AI 说话、叫别的 AI、掷随机数。适合抽卡、洗牌这类用效果行写起来很别扭的东西。

AI 永远不会运行代码。代码只在玩家开着游戏的时候跑。

## 自定义行为

行为设置的最上面有两个按钮：**规则 / 自定义**。规则就是上面讲的一切：一句话说什么时候、如果、做什么。自定义是另一回事：这条行为由代码来做，表单里那一句不算数。

想要的效果用效果行做不出来、自己又不想写代码的时候，选自定义。这条行为就变成一个占位。给它贴张便签说要做什么，创作助手或你接进来的外部 AI 会来写。写好以后，这里会显示它是怎么实现的：自己带的代码有多少行，或者玩家界面里哪个文件哪一行在触发它。还没写的话就是空的。

## 实例：好感路线

- **好感 25**：弹个提示，「她好像注意到你了……」
- **好感 50**：发出时刻「第一次干杯」，并告诉 AI「她开始流露感情了。她想靠近，却总是不自觉地退缩」
- **好感 80**：启用词条「她的心意」，这条待命设定从此每回合都发给 AI

## 其它选项

- **优先级**：好几条同时触发时，谁先跑
- **冷却**：两次触发之间至少隔几回合
- **最大触发次数**：1 就是一次性
- **发生概率**：一个百分比，给那些不该每次都发生的惊喜
- **启用**：可以先关着，等别的行为来打开它，连成一串

行为跑了没有、为什么没跑、离触发还差多少，[试玩](/zh/creator/playtest)的时候都看得到。
