剧本 JSON 参考

{
  "id": "ch-example-minimal",
  "name": "最小示例",
  "fragments": [
    {
      "id": "frag-example-main",
      "name": "main",
      "blocks": [
        {
          "type": "narration",
          "props": { "keepDialogue": false },
          "content": [
            { "type": "text", "text": "故事从这里开始。", "styles": {} }
          ]
        },
        { "type": "endChapter", "props": {} }
      ]
    }
  ]
}

{ "chapterOrder": ["开始", "最小示例"] }

{
  "id": "ch-1755500000000-1",
  "name": "第一章",
  "fragments": [
    { "id": "frag-1755500000000-2", "name": "main", "blocks": [] }
  ]
}

{
  "id": "frag-1755500000000-2",
  "name": "main",
  "blocks": []
}

{
  "id": "66d4d76d-ddec-4f99-836a-50beac4f6f90",
  "type": "dialogue",
  "props": { "disabled": false, "characterId": "b8e3efe5-…" },
  "content": [
    { "type": "text", "text": "台词正文。", "styles": {} }
  ]
}

{ "type": "wait", "props": {} }

{
  "type": "wait",
  "props": { "disabled": false, "duration": 1000, "waitForInput": false }
}

{ "content": [ { "type": "text", "text": "这是一句话。", "styles": {} } ] }

[
  { "mode": "jump", "text": "去图书馆", "fragmentId": "frag-3" },
  {
    "mode": "vars",
    "text": "回家休息",
    "varOps": [
      {
        "key": "b8e3efe5-….好感度",
        "op": "+=",
        "aKind": "lit",
        "aLit": "5",
        "bKind": "none",
        "binOp": "+"
      }
    ]
  }
]

{
  "choices":
    "[{\"mode\":\"jump\",\"text\":\"去图书馆\",\"fragmentId\":\"f3\"}]"
}

[
  {
    "left": "alice_affection",
    "op": ">=",
    "rightKind": "literal",
    "rightLiteral": "50"
  },
  {
    "left": "route_flag",
    "op": "==",
    "rightKind": "variable",
    "rightRef": "target_route"
  }
]

{
  "type": "dialogue",
  "props": {
    "characterId": "<角色UUID>",
    "characterName": "小雪",
    "expression": "微笑",
    "position": "center"
  },
  "content": [
    { "type": "text", "text": "今天想去哪里？", "styles": {} }
  ]
}

{
  "type": "narration",
  "props": {},
  "content": [
    {
      "type": "text",
      "text": "放学后的教室，只剩下我们两个人。",
      "styles": {}
    }
  ]
}

{
  "type": "showCharacter",
  "props": {
    "characterId": "<角色UUID>",
    "expression": "微笑",
    "position": "left"
  }
}

{
  "type": "scene",
  "props": {
    "sceneId": "<场景UUID>",
    "sceneName": "教室",
    "transitionMode": "crossfade",
    "transitionDuration": "500"
  }
}

{
  "type": "curtain",
  "props": { "op": "close", "duration": "800" }
}

{
  "type": "camera",
  "props": {
    "zoom": "1.4",
    "offsetY": "-60",
    "colorToneMode": "sepia",
    "colorToneIntensity": "0.6",
    "duration": "800",
    "easing": "easeInOut"
  }
}

{
  "type": "stageMask",
  "props": {
    "action": "show",
    "maskId": "spotlight",
    "mode": "overlay",
    "plane": "bottom",
    "shape": "ellipse",
    "visibility": "inside",
    "centerX": 50,
    "centerY": 45,
    "width": 36,
    "height": 60,
    "feather": 24,
    "opacity": 85,
    "color": "#000000",
    "enterDuration": 1000
  }
}

{
  "type": "particle",
  "props": { "mode": "show", "preset": "LIGHT_SNOW" }
}

{
  "type": "floatingText",
  "props": {
    "position": "(center,20%)",
    "anchor": "top-center",
    "fontSize": "42",
    "animIn": "fade,slide"
  },
  "content": [
    { "type": "text", "text": "——三年后。", "styles": {} }
  ]
}

{
  "type": "sound",
  "props": {
    "soundType": "BGM",
    "soundId": "<音频UUID>",
    "uri": "bgm/日常.mp3",
    "loop": "true",
    "volume": "80"
  }
}

{
  "type": "branch",
  "props": {
    "title": "去哪里",
    "choices":
      "[{\"mode\":\"jump\",\"text\":\"出发\",\"fragmentId\":\"f3\"}]"
  }
}

{
  "type": "setver",
  "props": {
    "key": "<角色UUID>.好感度",
    "op": "+=",
    "aKind": "lit",
    "aLit": "5",
    "bKind": "none",
    "binOp": "+"
  }
}

{ "type": "loadingStrategy", "props": { "mode": "auto", "lookahead": 20, "execution": "wait", "delayMs": 2000, "resourcesJson": "[]" } }

{
  "type": "systemMessage",
  "props": {
    "mode": "confirm",
    "title": "确认",
    "message": "要保存进度吗？",
    "resultVariable": "save_confirmed"
  }
}

{
  "type": "callExtensionFunction",
  "props": {
    "target": "avg.official.affection/add",
    "paramsJson": "{\"amount\":{\"kind\":\"lit\",\"value\":5}}"
  }
}

{ "type": "openExternalUrl", "props": { "url": "https://example.com" } }

{ "type": "unlockSteamAchievement", "props": { "apiName": "ACH_FIRST_CHAPTER" } }

{
  "type": "steamAction",
  "props": { "action": "stat.add", "name": "CHAPTERS_READ", "value": "1" }
}

{
  "id": "ch-example-call",
  "name": "片段调用示例",
  "fragments": [
    {
      "id": "frag-example-call-main",
      "name": "main",
      "blocks": [
        {
          "type": "callFragment",
          "props": {
            "fragmentId": "frag-example-greeting"
          }
        },
        {
          "type": "narration",
          "props": {
            "keepDialogue": false
          },
          "content": [
            {
              "type": "text",
              "text": "已回到主片段，继续故事。",
              "styles": {}
            }
          ]
        },
        {
          "type": "endChapter",
          "props": {}
        }
      ]
    },
    {
      "id": "frag-example-greeting",
      "name": "问候",
      "blocks": [
        {
          "type": "narration",
          "props": {
            "keepDialogue": false
          },
          "content": [
            {
              "type": "text",
              "text": "这是被调用片段中的旁白。",
              "styles": {}
            }
          ]
        }
      ]
    }
  ]
}

{
  "id": "ch-1755500000000-1",
  "name": "第一章",
  "fragments": [
    {
      "id": "f2",
      "name": "main",
      "blocks": [
        {
          "type": "scene",
          "props": {
            "sceneId": "<场景UUID>",
            "sceneName": "教室",
            "transitionMode": "crossfade",
            "transitionDuration": "500"
          }
        },
        {
          "type": "sound",
          "props": {
            "soundType": "BGM",
            "soundId": "<音频UUID>",
            "uri": "bgm/日常.mp3",
            "loop": "true",
            "volume": "80"
          }
        },
        {
          "type": "narration",
          "props": {},
          "content": [
            {
              "type": "text",
              "text": "放学后的教室，只剩下我们两个人。",
              "styles": {}
            }
          ]
        },
        {
          "type": "dialogue",
          "props": {
            "characterId": "<角色UUID>",
            "characterName": "小雪",
            "expression": "微笑",
            "position": "center"
          },
          "content": [
            { "type": "text", "text": "今天想去哪里？", "styles": {} }
          ]
        },
        {
          "type": "branch",
          "props": {
            "title": "去哪里",
            "choices":
      "[{\"mode\":\"jump\",\"text\":\"出发\",\"fragmentId\":\"f3\"}]"
          }
        },
        {
          "type": "narration",
          "props": {},
          "content": [
            {
              "type": "text",
              "text": "片段执行完后，故事回到这里继续。",
              "styles": {}
            }
          ]
        },
        { "type": "endChapter", "props": {} }
      ]
    },
    {
      "id": "f3",
      "name": "去图书馆",
      "blocks": [
        {
          "type": "dialogue",
          "props": {
            "characterId": "<角色UUID>",
            "characterName": "小雪",
            "expression": "开心"
          },
          "content": [
            { "type": "text", "text": "那就走吧！", "styles": {} }
          ]
        }
      ]
    }
  ]
}

{"type":"adjustVolume","props":{"scope":"type","soundType":"BGM","volume":"30","fadeDuration":"1000"}}