玩家输入 Block 会暂停剧情,打开输入界面,等玩家确认后把结果写入指定变量。它适合填写姓名、输入数值、确认开关等需要由玩家提供内容的场景。

基本用法

1

先创建变量

叙事地图的变量管理中创建用于接收结果的变量,并根据用途选择文本、数字或布尔类型。
2

插入玩家输入 Block

在空白旁白块按 Tab,搜索并选择「玩家输入」。选中 Block 后,在右侧检查器中选择要写入的变量。
3

设置提示与校验

填写标题、说明和确认按钮文案;文本输入还可设置占位文字,再按输入类型设置长度、范围或选项文字。
4

运行预览

从该 Block 前开始预览,确认输入界面、错误提示和后续剧情读取到的值符合预期。
必须选择一个已有的可写变量。没有写入变量的玩家输入 Block 会在运行时被跳过,无法保存玩家填写的内容。

三种输入形态

输入形态会跟随目标变量的声明类型,不需要另外选择:
变量类型玩家看到的界面可设置内容
文本单行文字输入框占位文字、是否必填、必填提示、最短和最长长度
数字数字输入框最小值、最大值和步进
布尔两个选择按钮「是」和「否」两项的显示文字
切换写入变量时,Studio 会自动更新输入形态。若已有配置与新类型不适用,检查器只显示当前类型需要的设置。

文本长度

  • 最短长度和最长长度都以字符数计算。
  • 长度设为 0 表示不限制。
  • 关闭「必填」后,玩家可以留空继续;非空内容仍需满足长度限制。

数字范围

  • 最小值和最大值都可以留空,表示该方向不限制。
  • 步进必须是正数,例如 10.5
  • 若最小值大于最大值,Studio 会在编辑时自动对齐冲突范围。

提示文案

设置用途
标题说明这次要玩家输入什么,例如「你的名字」
补充说明解释用途或格式要求,可以留空
占位文字在文本输入框为空时显示提示
确认按钮自定义提交按钮上的文字
必填提示文本必填但未填写时显示的错误信息
是 / 否文字自定义布尔输入的两个选项,例如「接受 / 拒绝」
建议把规则写进补充说明,而不是只依赖报错提示。例如需要 2~12 个字符时,可以直接告诉玩家可填写的范围。

运行时行为

  • 输入界面打开后,剧情会等待玩家确认,不能通过关闭弹窗或按 Esc 跳过。
  • 目标变量已有值时,界面会把当前值作为初始值,方便玩家确认或修改。
  • 文本输入是否必填由 Block 设置决定;数字和是/否输入必须给出有效结果。
  • 玩家确认后,新值写入变量,剧情才继续执行。
  • 玩家填写的结果会出现在游戏历史记录中。不要用此功能收集密码、联系方式等敏感信息。
后续可以用条件判断读取结果并进入不同分支,也可以用变量赋值在之后覆盖该值。

更换输入界面

玩家输入使用默认游戏壳中的「玩家输入」系统槽位。标题、说明、变量信息和按钮文字会自动传给这个槽位。 如果需要调整整体布局、字体或动效,可以前往个性化与项目设置 · 选项与输入界面更换系统槽位模板;Block 本身只负责每次输入的内容和校验规则。