VNLE 使用手册
示例:港口的钥匙

米拉看守着一间上锁的仓库。你可以花五枚金币向她购买钥匙。游戏收到物品后,会话会带你前往仓库,随后完成任务。示例包含四个场景和全部九种节点。
1 · 打开项目
- 下载示例项目并解压 ZIP。
- 启动 VNLE,选择 Open project,然后选择解压后的项目文件夹,其中应包含 project.vnle.json。
- 在左侧边栏选择 Harbour。选择一个节点,即可在右侧查看内容。本指南使用英文操作名称。你可以在 Settings 中更改应用语言。
2 · 角色、变量和物品
打开 Characters:米拉已有名称和头像。对话节点选择米拉作为说话者,因此游戏可以在台词旁显示她的名称和图片。
在 Variables 中可以找到 Gold = 10,以及值为 false 的 HasKey、QuestAccepted 和 QuestComplete。整数用于记录金币数量,三个布尔值用于记录进度。
Resources 包含 Warehouse key 物品、Open the warehouse 任务和 Old warehouse 地点。这些条目为游戏提供稳定的引用。附带的游戏示例负责管理画面上可见的物品栏。
3 · 沿着对话流程探索
- Welcome 显示问候语。Ask Mira 调用 Mira’s request。另一段对话介绍仓库,然后 Return 将流程带回主会话。
- Already have the key? 检查 HasKey。如果没有钥匙,就会显示 Choose a reply。你可以选择购买,或选择 Maybe later。
- Enough gold? 检查 Gold ≥ 5。金币不足时米拉会拒绝交易;否则 Pay five gold 扣除五枚金币,并将 QuestAccepted 设为 true。
- Receive the key 请求执行 give_item。游戏把钥匙放入物品栏,并返回 Received 结果。Remember the key 将 HasKey 设为 true。
- Your remaining gold 在台词中显示当前金币数。Go to the warehouse 跳转到 Warehouse。Check the warehouse key 检查钥匙、设置 QuestComplete,并显示最后一段对话。
- Return to the game 是 End 节点:游戏关闭对话框,并将控制权交还玩家。
4 · 测试每条路线
- 打开 Play in your browser,选择 Talk to Mira,点击两次 Continue,然后购买钥匙。预期显示 Gold 5、背包中出现钥匙,最终显示 Quest complete。
- 用 Start with 2 gold 重新开始。购买应被拒绝,背包保持为空。然后测试 Maybe later 选项。
- 显示一句台词时,在 English 和 Deutsch 之间切换,同一句台词应保持打开。购买后选择 Save game,继续推进,再用 Load game 恢复。
添加游戏动作时,也要连接取消结果。在示例中,如果背包拒绝接收物品,Refund the payment 会退还五枚金币并重置 QuestAccepted,随后显示告别台词。