变量

变量是你世界的游戏状态。数字、文本、标记、复杂对象 —— 任何需要跨回合持久存在的数据。AI 读取它们，通过指令更新它们，你的自动化规则也可以对变化做出反应。

只用自然语言描述变量本身

在变量的「行为规则」里，你只需要用大白话写清楚这个变量是什么、什么时候应该变化。**不需要提到 [health: -1] 这种语法 —— 我们的引擎已经教好ai了 ✅ 这样写：「受到物理伤害时减少，按伤害严重程度调整。一拳 -5 到 -10，刀伤 -15 到 -25。休息时缓慢恢复。」

在编辑器中，打开变量部分。每个变量都有名称、类型、默认值和 行为规则。

条目那一章提到的恐怖世界用了 5 个变量：生命值（数字，0-5）、体力（数字，0-8）、天数（数字，1-14）、游戏阶段（字符串，「Night」或「Day」）、以及武装状态（true/false）。这就足以运行一个完整的 14 夜生存游戏了。

每回合，AI 读取当前变量值，在回复中写下 [health: -1] 这样的指令，引擎提取它们并更新状态。

变量类型

数字（Number）

追踪数量：生命值、金币、好感度、天数、饥饿度。

你可以设置最小/最大边界，引擎会自动进行范围限制。

字符串（String）

追踪文本状态：位置、心情、当前任务、时间段。

布尔值（Boolean）

追踪真/假标记：是否拥有钥匙、是否见过某个 NPC、是否触发了某个事件。

JSON

追踪复杂结构：背包数组、NPC 关系对象、任务日志、地图数据。

JSON 变量支持点路径更新 —— 你可以修改嵌套字段而不需要重写整个对象。

规则 —— 最重要的部分

规则是用自然语言写的说明，教 AI 何时以及如何修改一个变量。没有它们，AI 不会可靠地使用你的变量。

（编辑器中这个字段的标签是「行为规则」。我们在这里叫它 行为规则，以免和编辑器中叫做「行为」的自动化系统混淆。）

好的 行为规则

变量：生命：

这是玩家的生命值，0 = 死亡 —— 描写一个死亡场景并结束游戏。1-20 = 危急（流血、呼吸困难）。20-50 = 受伤（疼痛影响行动）。50-80 = 擦伤（轻微不适）。80-100 = 健康。 受到物理伤害时按严重程度递减。一拳：-5 到 -10。一刀：-15 到 -25。从高处坠落：-20 到 -40。休息时缓慢恢复（每次休息场景 +5）或治疗时恢复（+10 到 +30）。单回合变化不得超过 30。

有效的写法模式

数值区间 —— 定义每个区间在叙事中的含义：

0 = 游戏结束。1-25 = 绝望。26-50 = 挣扎。51-75 = 尚可。76-100 = 自信。

触发时机 —— 什么时候应该变化：

玩家帮助村民、送礼或保护他们时增加。偷窃、威胁或违背承诺时减少。

变化限制 —— 防止剧烈波动：

单回合变化不超过 10。最小 0，最大 100。

TIP

通常两到四句话就够了。如果你的 行为规则比一小段还长，说明该精简了。AI 很聪明 —— 告诉它概念和边界就行，不需要写 500 字的小作文。