Laper如何创建剧本角色

在Laper中创建剧本角色需先进入角色管理视图确认数据表已初始化，再通过编辑面板设置唯一ID、中文名和类型；随后上传头像、配置表情与语音；最后定义可被脚本读写的状态变量以驱动分支逻辑。

在Laper中创建剧本角色是编写互动叙事内容的基础操作，必须先完成角色定义才能为其分配台词、行为和状态变化。角色信息直接影响后续分支逻辑的触发条件和UI显示效果。

新建角色前的必要准备

打开Laper项目后，点击左侧导航栏的【角色】图标，确保当前处于“角色管理”视图。如果界面显示为空白或提示“暂无角色”，说明尚未初始化角色数据表——此时不可跳过此步直接点击“+新增”，否则新建角色将无法保存到工程配置中。

确认顶部菜单栏显示“角色（0）”或已有角色列表，再进行下一步。

通过角色编辑面板创建基础角色

点击右上角的“+新增角色”按钮→在弹出的表单中填写“角色ID”（仅限英文小写字母和数字，如“lihua”“robot_01”，【ID一旦保存不可修改，ID重复会导致运行时冲突】）→输入中文名称（如“李华”“AI助手”）→选择角色类型（“玩家”“NPC”“旁白”三选一）→点击“保存”。

这一步操作完成后，新角色会立刻出现在左侧角色列表中，但此时角色尚无头像、语音配置和属性字段。

为角色添加视觉与交互属性

方法一：在角色列表中点击刚创建的角色名称，进入详情页→上传头像图片（支持PNG/JPG，建议尺寸400×600像素，过大图片会导致预览卡顿）→设置默认表情（从下拉菜单选择“微笑”“严肃”“惊讶”等）→勾选“启用语音合成”并选择TTS引擎（需提前在项目设置中授权对应API）。

方法二：批量配置多个角色的表情与语音参数→点击列表右上角“批量编辑”→勾选目标角色→在右侧面板统一设置“表情组”和“语音语速”，点击“应用到所选”。注意：批量操作不会覆盖已单独设定过表情的角色，仅作用于未修改过的角色。

定义角色专属状态变量

第一步：在角色详情页切换到“状态变量”标签页→点击“+添加变量”。

第二步：输入变量名（如“信任度”“体力值”“是否知晓真相”），选择数据类型（数字/布尔/字符串）→设置初始值（数字填0或100，布尔选“是/否”，字符串留空或填默认文本）→开启“可被脚本读写”开关（关闭则该变量仅作备注用途，无法参与剧情判断）。这一步决定角色能否响应玩家选择、影响分支走向，漏设会导致条件判断始终返回false。

第三步：点击“保存变量配置”，页面自动刷新，新变量即刻生效。