Skip to content

世界文件格式 ​

一个 Yumina 世界就是一个 JSON 文件。这里是它每一部分的参考,写给人看,也写给 AI 工具看。

大多数创作者从来不读它。Studio 替你写这个文件,你自己的 AI 也可以通过连接你的 AI直接编辑一张卡。这份参考是给三种情况的:

  • 你自己跑开源引擎,或者把一张卡作为角色放进一个游戏里。
  • 你的 AI 工具没有连接器。把单文件规格给它,它就能写出一个有效的世界让你导入。
  • 你想查某个分区、某种变量类型、某条指令或某条规则到底是怎么工作的。

规格章节 ​

章节涵盖内容
世界 Schema顶层 WorldDefinition 结构,所有字段
词条与分区词条类型、分区、关键词、匹配机制、官方预设
变量与指令类型、操作、指令语法、点路径更新、行为规则
规则与响应触发器、条件、动作、系统效果、事件模式
宏所有宏占位符及其替换内容
自定义 UIrootComponent、useYumina() API、沙箱、内置组件
音频音轨类型、AI 指令、播放列表、条件 BGM
完整下载供 AI 工具使用的单文件规格