世界文件格式
一个 Yumina 世界就是一个 JSON 文件。这里是它每一部分的参考,写给人看,也写给 AI 工具看。
大多数创作者从来不读它。Studio 替你写这个文件,你自己的 AI 也可以通过连接你的 AI直接编辑一张卡。这份参考是给三种情况的:
- 你自己跑开源引擎,或者把一张卡作为角色放进一个游戏里。
- 你的 AI 工具没有连接器。把单文件规格给它,它就能写出一个有效的世界让你导入。
- 你想查某个分区、某种变量类型、某条指令或某条规则到底是怎么工作的。
规格章节
| 章节 | 涵盖内容 |
|---|---|
| 世界 Schema | 顶层 WorldDefinition 结构,所有字段 |
| 词条与分区 | 词条类型、分区、关键词、匹配机制、官方预设 |
| 变量与指令 | 类型、操作、指令语法、点路径更新、行为规则 |
| 规则与响应 | 触发器、条件、动作、系统效果、事件模式 |
| 宏 | 所有宏占位符及其替换内容 |
| 自定义 UI | rootComponent、useYumina() API、沙箱、内置组件 |
| 音频 | 音轨类型、AI 指令、播放列表、条件 BGM |
| 完整下载 | 供 AI 工具使用的单文件规格 |
