官方扩展由 LetsGal Studio 维护,可以直接从扩展工坊安装。它们与其他工坊扩展一样按项目加入、启用和配置。
v1.9.0 系列更新:新增「用语辞典」「角色档案图鉴」「角色名字和对话主题色」。

安装与启用

1

打开扩展工坊

搜索扩展名称,并确认卡片带有「官方」徽章。
2

安装扩展

点击「安装」。安装完成后,卡片会显示当前项目是否正在使用。
3

加入当前项目

前往「个性化 → 项目设置」,在「本机的其他扩展」中找到扩展并点击「加入」。
4

配置并测试

在扩展设置中调整界面或配色,再从剧本插入扩展方法进行测试。

用语辞典

「用语辞典」用于制作世界观 TIPS、术语表和地点说明。词条统一在「资产 → 数据集合」中维护,直接使用词条名称作为唯一键,不需要另外填写 ID。玩家解锁词条时会看到可视化 UI 书签横幅,辞典界面支持分类、未读标记和玩家主题换色。 扩展加入项目后会自动创建「用语辞典」数据表,并显示在左侧的「扩展集合 → 用语辞典」分组中。每一行可以配置词条名称、分类、副标题、正文、配图、排序权重和初始解锁;其中词条名称必填且不能重复。表中的记录默认就是已登记词条,不需要在剧情中再调用登记方法。 扩展仍属于项目时,这张集合不能被手动删除。从项目移除或卸载扩展后,集合和已有词条不会丢失,但会显示为不可用,此时才可以手动删除;重新加入扩展后可以继续使用原集合。

剧本方法

方法用途
解锁用语按词条名称让数据集合中的词条从「???」变为可读;首次正常解锁时显示横幅,也可选择静默
打开用语辞典打开辞典并等待玩家关闭后继续剧情
标记用语已读清除未读标记;默认界面会自动调用,一般不需要手动插入
推荐先在数据集合中整理全部词条,再在剧情揭示信息的位置使用「解锁用语」。如果词条从一开始就应该可见,可以在数据表中开启「初始解锁」。 辞典和解锁横幅固定使用扩展自带的可视化界面,不需要额外选择界面。解锁横幅不由 React 组件绘制,可按设置的停留时间自动关闭,相邻解锁会依次显示。 玩家默认按 T 打开辞典。这个动作会出现在「个性化 → 项目设置 → 输入按键」中,可以重新绑定。
词条内容来自项目的数据集合;解锁状态、已读状态和玩家选择的主题在所有存档之间共享。读档或定位重放不会重复弹出解锁横幅。

角色档案图鉴

「角色档案图鉴」用于收集人物资料。图鉴采用左侧立绘、右侧资料的布局,支持分组、未读标记、玩家主题换色,以及随剧情反复更新同一角色的档案。

剧本方法

方法用途
登记角色档案选择项目角色并填写分组、一行资料和正文;显示名与立绘留空时读取角色库
解锁角色档案公开已登记档案;首次正常解锁时显示名牌横幅,也可选择静默
打开角色图鉴打开图鉴并等待玩家关闭后继续剧情
标记档案已读清除未读标记;默认界面会自动调用
同一角色可以重复登记。适合在初遇时只写基础信息,随着剧情推进再补充身份、经历或关系变化;更新内容不会清除已经解锁的状态。 玩家默认按 P 打开图鉴,也可以在「输入按键」中重新绑定。
角色档案、解锁状态、已读状态和玩家主题同样在所有存档之间共享。

道具系统

「道具系统」用于集中维护道具定义、玩家背包和使用事件。先在扩展设置的「道具目录」中填写名称、分类、说明、图片、是否叠加、是否可使用和使用后执行的剧情片段,再从剧本调用方法改变玩家实际持有状态。

剧本方法

方法用途
获得道具添加指定数量;可叠加道具增加同一格数量,不可叠加道具生成独立条目
移除道具移除指定数量;不足时移除现有全部,不会出现负数
检查是否持有道具返回布尔结果,可直接作为 If 条件来源
使用道具按目录规则消耗道具,并执行配置的使用事件
打开道具界面以模态方式打开完整背包,关闭后剧情继续
打开便携背包打开可与剧情并行使用的右侧抽屉
「检查是否持有道具」可以直接用于条件判断 If,不需要先把查询结果写入临时变量。
玩家默认按 I 打开完整道具界面、按 B 开关便携背包;两项动作都可以在「个性化 → 项目设置 → 输入按键」中关闭或重映射。

角色名字和对话主题色

这个扩展按角色设置名字牌和对话正文颜色。安装并加入项目后,在扩展设置的「角色配色」中为每个角色添加一行。 名字与正文分别提供三种模式:
模式说明
跟随角色预设色使用角色管理器中设置的主题颜色;以后修改角色主题色会自动同步
自定义使用当前行单独选择的颜色
不染色保留当前对话框样式的全局颜色
名字和正文可以使用不同模式。还可以分别填写补充 CSS,例如为名字添加文字阴影;不建议用定位属性改变排版。
默认只让名字跟随角色预设色,正文保持对话框全局颜色。正文需要按角色染色时,再显式修改「正文取色」。
剧本中使用 [color=...] 标记过的局部文字优先使用行内颜色,不会被角色正文颜色覆盖。

更新与卸载

工坊出现新版本时,扩展卡片会显示「更新到 vX.Y.Z」。更新前先保存项目;更新后的发行物会在项目再次同步扩展时刷新。 当前项目正在使用扩展时,工坊只显示使用状态,不提供直接卸载。先在「项目设置」中将它从项目移除,再回到工坊卸载。详细规则见扩展工坊 · 安装后的管理