world.json

world.json 提供世界的稳定 id、必填 name、可选 description、作者、metadata.tags、开场消息、旁白声音和世界级变量初值。

{
  "id": "9d56bc2e-83ac-4eb0-b7bf-fac48772a6ef",
  "name": "黑水镇天文台",
  "description": "海边小镇仰望着悬崖上沉默的天文台。",
  "author": {"name": "示例作者"},
  "metadata": {"tags": ["悬疑", "历史"]},
  "opening_message": [
    {"type": "narration", "text": "海上飘来雨云。"},
    {"type": "utterance", "character": "mara", "text": "我们得在天黑前走。"}
  ]
}

开场发言中的 character 必须引用已定义角色。开场作为第一回合直接写入对话，不调用模型。旧导出格式的 manifest.json 和独立 author.json 不属于当前原生格式。

可选的 alternate_openings 是其他可选开场，每项为 {title, text, character?}（纯叙述，至多 30 个、每个至多 20000 字符；缺省标题取正文开头几个字）。开始对话框会把它们与世界自己的开场并列提供。带有 character（某个可扮演角色的 id）的开场只提供给扮演该角色的玩家，为其他角色指定它的开始会被拒绝；character 不是该世界可扮演角色时，开始会被拒绝并给出问题。

可选的 preset 是资料库中预设的名称：除非开始时另行选择，该世界的会话使用这个预设来写作（见提示词系统规范）。

可选的 lorebooks 是资料库中世界书的名称列表：除非开始对话框另行选择，该世界的会话以这些世界书开始（见世界书）。

可选的 tools 字段给出世界的智能体的可选工具开关，按智能体类别分组，例如 {"gameMaster": {"roll_dice": false}}。故事以它为起点，开始时所做的选择叠加在其上。此版本不认识的名字会被保留，但不起作用。