创作者文档
剧本创作指导
这篇文档带你从零写完一个能正常玩通的剧本：先看流程，再对着必填信息表填表，最后按「易错配置」逐条自检。所有数值限制都来自系统实际的校验规则，照做就不会在保存时被打回。
更新日期：2026 年 9 月 23 日
创作流程：六步写出一个剧本
从进入创作页到上架世界广场，中间只有一次人工自测是必须自己做的。
- 1
进入创作
侧边栏点「创造世界」进入发布页；也可以直接打开 /worldview/publish。两者表单一致，只是保存后的去向不同：站内入口保存后回到「我的发布」，独立页保存后直接进入编辑模式。
- 2
填写必填信息
标题、描述、世界设定三项缺一不可，页面会拦下不完整提交（提示「请填写所有必填字段」）。
- 3
搭世界书
用「世界书条目」写背景、角色、地点、探索目标、规则、物品、事件；每条设定触发条件与线索等级，剧情推进到对应条件时才会注入给 AI。
- 4
定义世界变量
把好感度、标志位、当前地点、进度计数等交给变量管理，之后可以在触发条件里引用，用来控制分支与结局。
- 5
开场白、状态栏与美术
开场白 HTML 负责第一屏的观感；状态栏 HTML 是玩家右侧看到的自定义面板（匹配度、时间、好感度等）。立绘、角色名牌、BGM 都是可选项。
- 6
自测后发布
先在「我的发布」里自己玩一遍：必填是否完整、主线能不能走通、变量是否按预期变化。确认后打开「公开」开关并等待审核上架。
小贴士 · 创作助手能帮什么
- 发布页内置 AI 创作助手，可以帮你起草标题与描述、补世界书条目、定义变量。
- 助手只做「新增」：不会覆盖或删除你已写好的条目，冲突时会提示你换名字或重新生成。
- 助手给出的草稿建议如果与你当前修改冲突，会提示「草稿已发生变化，请基于最新草稿重新生成建议」。
必填信息与篇幅上限
三项必填；其余都是可选，但选填字段同样有长度上限。
| 字段 | 必填 | 上限 | 写什么 |
|---|---|---|---|
| 标题 | 必填 | 200 字以内 | 世界广场列表里显示的名字，建议 6-16 字，带题材关键词便于搜索。 |
| 描述 | 必填 | 10000 字以内 | 两三句话说明身份、目标与看点，让玩家知道会玩到什么。 |
| 世界设定 | 必填 | 100000 字以内 | 核心提示词：时代与规则、玩家身份、主线脉络、结局条件、语气与禁忌，AI 每轮都会读到。 |
| 分类 | 可选 | 16 选 1 | 影响广场筛选与曝光，尽量选最接近的题材。 |
| 难度 | 可选 | 1-5 级 | 仅作为推荐难度展示，不改变检定公式。 |
| 开场白 HTML | 可选 | 256000 字符 | 第一屏的 HTML 开场，支持样式与图片外链。 |
| 状态栏 HTML | 可选 | 200000 字符 | 玩家右侧自定义状态面板，超长会被服务端直接拒绝。 |
| 角色立绘 / 名牌 | 可选 | 图片地址 2048 字符、角色名 40 字、身份 80 字 | 用于作者世界里的角色展示。 |
| 游戏链接 / 自定义 BGM | 可选 | 需为 http(s) 网址 | 挂你的外部小游戏或背景音乐。 |
分类与难度怎么选
分类是玩家找到你的主要路径，难度只影响推荐标签。
分类共 16 项：恋爱、悬疑、无限流、末日、古风、奇幻、都市、校园、娱乐圈、轻喜剧、治愈、科幻、蒸汽朋克、海洋、时空、其他。
分类可以留空，但留空的剧本不会出现在任何题材筛选中，只能靠搜索被找到，因此建议至少选一项。
难度 1-5 仅用于展示推荐（1 最轻松、5 最硬核）；玩家侧的检定难度由玩家自己的难度偏好与游戏风格决定。
分类示例：一个「都市 + 悬疑」的调查向剧本
容易出错分类留空，标题写成「测试剧本 1」，描述只写「好玩」
推荐写法分类选「悬疑」，标题「雨夜第七实验室」，描述写清玩家身份（民俗学研究生）、目标（找出失踪的导师）与看点（每夜只能调查一个地点）
主线与结局怎么设置
先用「剧本类型」告诉系统这个剧本该怎么出主线，再用世界书和变量把主线落地成可推进的结构。
创作表单里有「剧本类型」下拉，它决定任务系统怎么给这个剧本发主线；不选就按「自动（默认）」处理。
| 剧本类型 | 任务系统怎么出主线 | 适合的剧本 |
|---|---|---|
| 自动（默认） | 不加额外约束，交给 AI 按世界设定自行判断主线节奏 | 还没想好节奏、或者想保持和以前一样的老剧本 |
| 普通剧本 | 可以随剧情持续发布新主线，每条主线都能单独结算 | 一章一个目标、能一直往下写的连续冒险 |
| 有结局剧本 | 必须有明确的终章主线，终章完结后进入结局结算，不再发布新主线 | 有明确终局与结局分支的完整故事 |
| 长线自由剧本 | 允许没有终点，用「存活 N 轮」这类轻量目标引导玩家 | 求生、经营、可以长期玩下去的沙盒剧本 |
- 选「有结局剧本」时，请在世界设定里写清终章（最后一条主线要达成什么），否则 AI 找不到收尾时机，剧情会一直拖。
- 选「长线自由剧本」时，把目标写成可重复的轻量计数（存活轮数、经营规模、声望等级），不要写「击败最终 BOSS」这种一次性终点。
- 选「普通剧本」时，每条主线都写清结算条件，让玩家能一条条拿到结果，而不是攒到最后一起结算。
- 世界设定里写清四段结构：开场（玩家在哪、做什么）→ 关键节点（2-4 个必经事件）→ 高潮（对抗或抉择）→ 收束（结局分支）。
- 结局分支写清触发条件：例如「结局 A：找回导师且隐瞒真相；结局 B：公开真相但导师死亡；结局 C：献祭自己」。AI 会在高潮后按条件收束。
- 用世界书条目承载剧情线索：类型选「探索目标」，并设置线索等级 0 公开 / 1 浅层 / 2 深入 / 3 隐藏 / 4 终极，让信息随调查进度分层揭露。
- 用世界变量记录进度与分歧：如 `main_progress`（number，0-4）、`knows_truth`（boolean）、`route`（string），并在世界书触发条件里引用，避免主线被 AI 说飘。
- 运行时 AI 按三幕节奏推进，并把剧情目标登记为探索目标：主线用「主线」类型，可选收获用「支线」，真相与彩蛋用「隐藏」。
| 世界书条目类型 | 中文名 | 典型内容 |
|---|---|---|
| background | 背景 | 时代设定、势力关系、世界规则的总览 |
| npc | 角色 | NPC 的性格、动机、秘密与可触发对话 |
| location | 地点 | 场景描写、可调查物件、进入条件 |
| quest | 探索目标 | 主线节点、调查线索、必须完成的行动 |
| rule | 规则 | 禁止事项、语气要求、世界内的硬性规则 |
| item | 物品 | 剧本内可出现的关键道具与获得方式 |
| event | 事件 | 定时/条件触发的事件与转折 |
小贴士 · 让主线稳定的三个写法
- 每条主线线索都写明「什么时候该出现」（触发条件）与「玩家应该知道什么」（内容），不要只写气氛描写。
- 结局条件用变量表达，例如 `route = "public"`，而不是依赖 AI 自行理解「玩家是否公开了真相」。
- 世界书每轮注入的内容有限（预算约 2000 token，单条最多 2000），所以条目要写得短而准，别把所有设定塞进一条。
道具与奖励的生成限制
道具与奖励由 AI 在剧情里通过工具发放，数值必须落在下面的范围内，超出范围的调用会被拒绝。
| 发放道具（giveItem） | 取值范围 |
|---|---|
| 名称 | 1-50 字 |
| 描述 | 5-200 字 |
| 效果描述 | 100 字以内，可为空 |
| 类型 | 消耗品 / 工具 / 钥匙 / 武器 / 防具 |
| 稀有度 | 普通 / 精良 / 稀有 / 史诗 / 传说（默认普通） |
| 价值（金币） | 0-10000 的整数 |
| 恢复匹配度 / 上限 | 1-100 / 1-50 |
| 永久提升属性 | 身体素质、反应速度、逻辑思维、人格魅力各 1-20 |
| 增加经验 | 1-1000 |
| 探索目标奖励 | 取值范围 |
|---|---|
| 标题 / 描述 / 目标 | 3-50 字 / 10-300 字 / 5-200 字 |
| 类型 | 主线 / 支线 / 隐藏 |
| 初始状态 | 已激活 / 待激活 |
| 创建时奖励 | 经验 1-5000，金币 1-10000 |
| 完成时额外奖励 | 经验 0-1000，金币 0-5000 |
- 奖励道具要在探索目标完成时用「发放道具」单独给出：探索目标本身只携带经验与金币。
- 玩家背包固定 20 格，塞满后再发道具会失败并提示「背包已满，无法添加更多道具」——一局的主线奖励控制在 2-4 件更稳妥。
- 剧本没有独立的道具库：想让某个世界的道具稳定出现，就在世界书里用「物品」条目把它们的名称、效果、获取方式写清楚。
- 检定的参数范围：目标值 1-20，修正值 -10 ~ +10（不含属性加成）；匹配度单次变化不超过 ±50。
- 检定难度写着色：1~6 简单、8~12 中等、12~15 困难、15~18 极难；玩家的难度偏好会在此基础上再调整。
奖励节奏示例：三章主线 + 若干支线
容易出错每轮对话都发一件传说武器，价值一律填 99999
推荐写法每章主线完成给 1 件道具（第 1 章普通、第 2 章稀有、第 3 章史诗），支线给经验与金币，传说道具只作为隐藏结局奖励
这样玩家背包不会爆格，数值也不会因为稀有度灌水而失去意义。
易错配置与报错对照
下面每一条都是保存或游玩时真实会出现的提示，遇到就按「正确做法」改。
| 现象 / 提示 | 原因 | 正确做法 |
|---|---|---|
| 请填写所有必填字段 | 标题、描述或世界设定为空 | 三项都填；世界设定最少写到能说清主线与结局 |
| 请输入有效的游戏网址 | 游戏链接不是合法 URL | 填 https:// 开头的完整地址，或留空 |
| status_panel_html must not exceed 200000 characters | 状态栏 HTML 超过 20 万字符（常见于把图片塞成 base64） | 图片改用外部链接，或拆掉不必要的内联样式 |
| 请至少添加一个触发条件（关键词、游戏变量、角色状态或复合条件） | 世界书条目没有配置触发器 | 至少给一个关键词，或用变量/角色状态条件限定出现时机 |
| 内容不能为空 | 世界书条目正文为空 | 补上条目内容 |
| 无效的分块类型: xxx | 世界书条目类型不在枚举内 | 只能使用背景、角色、地点、探索目标、规则、物品、事件这七种 |
| 变量名称不能为空 | 变量没写名字 | 填写变量名 |
| 变量 "X" 缺少默认值 | 变量没有初始值 | 为每个变量填写默认值，类型要与取值一致 |
| 无效的变量类型: xxx，支持: number, string, boolean, string[] | 变量类型写错 | 从四种类型里选一个 |
| 变量名称已存在 | 同一剧本里变量重名 | 换一个名字，或在原变量上修改而不是新建 |
| 变量 X 已存在，请让助手使用新的名称 / 世界书条目 X 已存在，请重新生成 | 再次让创作助手生成同名资源 | 在提示里接受重命名，或手动写这条内容 |
| 草稿已发生变化，请基于最新草稿重新生成建议 | 你手动改了字段后再应用助手的旧建议 | 先提交当前草稿，再让助手重新生成 |
| 背包已满，无法添加更多道具 | 玩家侧 20 格已满（奖励给太密） | 减少发放频率，或把部分奖励改为经验与金币 |
| 道具一直发不出来 | AI 生成的道具字段超范围（如稀有度拼错、价值超过 10000） | 在剧本与状态栏里把道具数值限制在本文档的范围内 |
| 剧本在广场里看不到 | 「公开」开关没打开，或审核尚未通过 | 打开公开并等待审核；未公开状态只有你自己能看到 |
发布与审核
保存 = 写进你的「我的发布」；公开 + 审核通过 = 出现在世界广场。
- 保存后剧本出现在「我的发布」，可以随时回来继续编辑；关掉「公开」开关就是私密草稿。
- 审核状态由平台维护：新剧本默认为待审核，通过后才会在广场展示与搜索到；作者自己无法修改审核状态。
- 修改已发布剧本（尤其是世界设定与变量）后建议重新自测一局，避免旧存档与新设定冲突。
- 删除剧本会连同它的世界书条目与变量定义一起删除，且不可恢复。
- 想低调试玩就把「公开」关闭，把链接发给朋友一起测；确认没问题后再公开上架。
注意 · 提交前自检清单
- 标题、描述、世界设定都填了，并且世界设定里写清了主线与至少两个结局条件。
- 每条世界书条目都有触发条件，线索等级按「公开→终极」排好序。
- 所有变量都有默认值，名字不重复，并且至少被一处触发条件引用。
- 状态栏 HTML 不超过 20 万字符，开场白 HTML 不超过 25.6 万字符。
- 自己完整跑一局：主线能走通、奖励能收到、背包不会爆格。