---
title: "世界文件格式"
description: "Yumina 世界文件的参考：词条、变量、指令、规则、宏、自定义 UI 和音频。给开源引擎、给 mod，也给没有连接器的 AI 工具。"
---

# 世界文件格式

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

大多数创作者从来不读它。Studio 替你写这个文件，你自己的 AI 也可以通过[连接你的 AI](/zh/creator/connect-your-ai)直接编辑一张卡。这份参考是给三种情况的：

- 你自己跑[开源引擎](https://github.com/lovetimo0421/yumina-oss)，或者把一张卡作为[角色](/zh/creator/games)放进一个游戏里。
- 你的 AI 工具没有连接器。把[单文件规格](/zh/world-spec/download)给它，它就能写出一个有效的世界让你导入。
- 你想查某个分区、某种变量类型、某条指令或某条规则到底是怎么工作的。

## 规格章节

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