引擎不含剧情,
剧情由你书写。一行就能挂载哟

import { Runtime, type RuntimeUi } from 'plugin-story-engine'

// 引擎不认任何具体界面:给它一个实现 RuntimeUi 的东西就行(你的是你自己的 UI)
const runtime = new Runtime({ ui: myUi })
await runtime.loadStory('/stories/demo.json', { autoStart: true })

runtime.state.get('var.gold')        // 读状态
runtime.events.on('story:say', …)   // 听事件

import { createEmbedHost, parentSurface } from 'plugin-story-engine'

const host = createEmbedHost({ surface: parentSurface(iframe, location.origin) })
await host.ready()                          // 等子页就绪
await host.load('/stories/demo.json')
await host.start()
host.on('story:say', ({ payload }) => console.log(payload))

// manifest.json 声明权限 —— 宿主对每一次能力调用做校验,拒绝也留痕
export default {
  init(ctx) {
    // 剧情 JSON 里用 { "type": "plugin", "command": "giveGold" } 调用
    ctx.commands.register('giveGold', (args, api) => {
      api.state.set('var.gold', (Number(api.state.get('var.gold', 0)) || 0) + args.n)
      return { ok: true, message: '金币 +1' }
    })
    // 还能注册:条件 / 效果 / 自定义节点 / UI 组件 / 事件监听 / 表达式函数
  },
  snapshot() { return local },        // 随存档走
  restore(data) { local = data }      // 读档恢复
}

{
  "id": "rust-gate", "title": "锈蚀之门", "start": "start",
  "nodes": {
    "start": { "type": "say", "speaker": "铁颚", "text": "进去,或者滚。", "next": "ask" },
    "ask": {
      "type": "choice", "text": "怎么办?",
      "options": [
        { "text": "拿钥匙进去", "next": "hall" },
        { "text": "空手进去", "condition": "flag.brave == true", "next": "hall" }
      ]
    },
    "hall": {
      "type": "if",
      "branches": [{ "condition": "item.gold >= 10", "next": "good" }],
      "else": "poor"
    },
    "good": { "type": "end", "text": "好结局:你活着出来了。" },
    "poor": { "type": "end", "text": "穷得连门都进不去。" }
  }
}

# 锈蚀带
作者:编剧甲

## 门厅(内景 · 锈蚀的门厅 · 夜)
铁门被推开,灰尘落下来。
铁颚(低声):进去,或者滚。
选择:怎么办?
- 拿钥匙 -> 里间
- 空手进去(如果 flag.brave == true)-> 里间
- 就此离开
如果 item.gold >= 10 -> 富人区
否则 -> 贫民窟
结局:好结局
你活着出来了。