脚本语法教程 - Shiori 引擎

← 返回主页

1. 场景数据结构 (sceneData)

每个场景文件包含一个 `sceneData` 对象，定义了背景、音频和故事脚本。

const sceneData = {
    background: BG_CONFIG_SUB,
    bgm: BGM_CONFIG_SUB,
    story: [
        {
            text: "对话文本内容",
            speaker: "说话者姓名",
            background: "bg_001_00_00",
            command: "[pov 主角]"
        }
    ]
};

2. Command 字段使用规范

黄金法则： 一行只做一件事。要么显示文本，要么执行命令，不要混用。

[错误] 错误用法：命令与文本混用

{
    text: "这段文字会被跳过",
    command: "[fadeout time=1000]"
}

[正确] 正确用法：独立成行

{
    text: "即将开始转场...",
    speaker: "旁白"
},
{
    text: "",
    command: "[fadeout time=1000]"
}

3. 常用指令速查

指令	功能说明
`[pov 角色名]`	在右上角显示当前叙事视角
`[pov stop]`	隐藏视角指示器
`[wait]`	暂停剧情，等待用户点击
`[fadeout time=1000]`	屏幕淡出效果
`[novel]`	开启全屏小说模式
`[normal]`	关闭全屏小说模式

4. 文本格式标签

\n：换行符，用于在同一段落内换行。
[s]：分段符，点击鼠标后显示下一段文本。

text: "第一段文字[s]第二段文字\n第三行文字"