调用扩展方法块用于执行扩展注册的剧本方法。好感度增减、成就解锁、鉴赏解锁、道具发放等玩法能力,都通过这个 Block 从剧本触达扩展。

基本用法

1

插入 Block

在空白旁白块按 Tab,在「扩展」分组中选择「调用扩展方法」。
2

选择方法

点击卡片上的「选择要调用的方法」,列表按扩展分组展示当前项目已启用扩展提供的全部方法。
3

填写参数

在右侧检查器中逐项填写方法参数。
选中后,卡片会显示所选扩展和方法名;点击卡片可以重新选择。方法列表只包含当前项目已启用的扩展——停用或移除扩展后,引用它的调用块会失效。

参数

检查器按方法声明的参数表逐项渲染,控件随参数类型变化:文本、数字、开关、下拉、角色、场景、立绘、素材、片段、界面等。 扩展为单行文本参数声明候选值时,输入框会同时提供下拉菜单。候选可以来自当前项目剧本中已经填写过的同类值,也可以包含项目角色名;选择候选不会限制你继续输入新内容。 每个参数可以在两种取值方式之间切换:
  • :直接填写固定内容。
  • 变量:选择一个剧情变量,剧本执行到这里时把变量的当前值传给扩展。适合把好感度加值、道具数量等做成随剧情变化的参数。
「变量」类型的参数含义相反——它是目标变量:扩展会把执行结果写进你选中的变量,之后可以用条件分支读取它。
v1.9.0 起:没有编辑过的参数会按方法声明的默认值传给扩展,不再需要逐个点开确认。

运行时行为

剧本执行到这个 Block 时调用扩展方法,方法执行完毕后再继续后续 Block。方法内部打开界面并等待玩家操作时(例如打开小游戏、等待确认),剧情会停在这里直到方法结束。

典型用法

  • 解锁鉴赏:解锁 CG、音乐或剧情片段,见多类型鉴赏
  • 玩法系统:好感度增减、成就达成、道具获得等官方或第三方扩展提供的能力。
  • 读写剧情数据:把方法结果写入变量,再用条件分支驱动后续剧情。
扩展开发者如何注册方法、声明参数表,见剧本方法。打开或关闭扩展界面使用显示界面,不需要经过扩展方法。