视觉与音频
每个世界都自带一个简洁的聊天界面。下面是如何更进一步。
在编辑器中,自定义 UI 在 自定义UI 部分,音轨在音频部分,上传的文件在资源部分。
角色立绘
给角色一张脸:简易编辑器里点角色名旁边的相机方块;Studio 里在 知识库 打开该角色的条目,用 立绘 一栏。从 资源 里选图,或当场上传。聊天里,这张图和角色名会出现在这个角色每一句发言的上方。多个角色都有立绘时,AI 会被要求在每条回复开头写一个玩家看不见的 [speaker: 名字] 标记,所以第一个字还没出来,脸就已经对了。标记为旁白的回复不显示脸;模型漏写标记时,聊天会退而看行首的「名字:」或第一句里出现的名字。
开场白里放图
开场白里可以放图。开场白文本框下面按 插入图片,上传一张或从 资源 里选;把文件拖到文本框上、或者直接粘贴一张图也行。图会以 [image:@asset:…|alt=…] 的形式插在光标处,聊天里就显示在那个位置。| 后面可以加:alt=(这是什么图)、caption=(图下面的一行字)、size=sm|md|lg|full、placement=left|center|right。写普通 markdown 也认 ——  —— 两种写法都可以用 https:// 链接代替资源。
自定义 UI
默认的聊天界面对大多数世界已经足够了。自定义 UI 是你超越它的方式:
前面提到的恐怖世界用了一个 CRT 风格的绿色荧屏界面,状态栏显示生命值、体力和武装状态。Studio AI 根据类似「末世恐怖 UI,CRT 显示器美学,暗绿色荧光文字,扫描线效果」这样的描述生成了它。
你不需要会写代码。描述你想要的外观和感觉,让工作室里的 AI助手 来构建。自定义 UI 是纯粹的视觉层,它读取游戏状态但不会改变状态。
完整的自定义 UI 指南 → 进阶:Custom UI 深度指南
音频
| 类型 | 用途 | 示例 |
|---|---|---|
| BGM | 背景音乐,持续循环播放 | 酒馆主题曲、战斗音乐、探索配乐 |
| SFX | 一次性音效 | 刀剑碰撞、门吱嘎声、提示音 |
| Ambient | 环境循环音,和 BGM 叠加播放 | 雨声、森林环境音、人群嘈杂声 |
BGM 播放列表自动轮播曲目,以及条件 BGM 根据游戏状态切换(比如变量 location 为「arena」时播放战斗音乐)。
一个恐怖世界可能在探索时播放紧张的 BGM,在某个东西扑向玩家时触发一声尖锐的 SFX,背景中持续播放稳定的雨声环境音。三个层次,同时运行。
音频模式和条件 BGM 详解 → 进阶:音频设计
场景图
会自己出现的图片。每张场景图有一个短 id(img1)、一张来自素材库或 https 地址的图,以及一两句话说明什么时候展示——"猫咪 Minyu 被吓了一跳,整只弹起来"。这句话既是开关也是发送条件,照字面执行:写了,满足条件的每条回复都会带上这张图(写“每次回复都发”就每回合都发);空着,这张图只会出现在你贴了它代码的地方。
谁来放图在场景图页顶上选:
- 回复写完再配图(默认,推荐):每回合 AI 写完回复后,智能追踪逐张判断每张图的"什么时候展示"条件,满足的都放在这条回复最后。玩家用什么模型都一样稳。
- 写故事的 AI 自己插:写故事的 AI 在正文里写
[image: img1],图可以出现在两段话中间,但得看模型听不听话,有的模型基本不放。
在「概览」里关掉智能追踪的话,就只能由写故事的 AI 自己插。
- 在编辑器的场景图页添加(Studio 里也可以把同一页作为面板打开)。可以从电脑上传,也可以从素材库选;一次拖多张就会生成多张,标题取文件名。
- 在开场白里写
[image: img1],故事一开始就带图。词条里也可以写,AI 用到那条时会把它带进回复。 - 在适用开场里可以把一张图限定给某几个开场白。
- 玩家在游戏顶栏有一个图鉴。故事已经出现过的图完整显示,其余的显示你写的解锁提示,玩家就知道前面还有值得走到的节点。
- "什么时候展示"照你写的执行。写"两人在咖啡店对坐时",只有那样的回复才带图;写"每次回复后都发",每条回复都带。之前发过的图,条件再满足时会再发。
素材
你可以通过编辑器的素材部分上传图片、音频文件、字体和其他媒体。文件托管在 Yumina 的 CDN 上,可以在自定义 UI、条目或音轨中随处引用。不需要自己托管文件。
在 我的库 → 资源 中,可通过 上传 → 上传文件 上传 MP4 或 WebM 视频。点击 视频 分类筛选,再打开视频预览,即可使用内置控件播放。
在 我的库 → 资源 中,选择 上传 → 上传文件夹,或把文件夹拖到资源区域。确认预览中的文件夹结构和文件数量后开始导入。所选文件夹及其子文件夹会保存在当前资源文件夹下;空文件夹不会导入。
文件夹导入支持 JPG/JPEG、PNG、GIF、WebP 图片;TXT、LOG、Markdown(.md / .markdown)、CSV、JSON 文本;MP4、WebM 视频;MP3、WAV、OGG、AAC、M4A 音频;以及 WOFF、WOFF2、TTF、OTF 字体。不支持的文件会列出并跳过。
导入文件夹时,对话框会显示当前文件的已上传大小、百分比和传输速度,以及整体进度和已完成文件数。关闭对话框或点击 后台上传 后,可以继续浏览 Yumina 的其他页面。浮动上传面板会显示进度,点击 详情 可重新打开对话框。请保持浏览器标签页打开,不要刷新:刷新或关闭标签页后,任务无法继续。
点击 取消上传 会停止当前传输和后续文件。取消或部分文件失败后,在移除任务前点击 重试未完成项 即可继续,已成功的文件不会重复上传。
资源较多时,在底部分页框中输入页码,点击 前往 或按 Enter 即可跳转。两端的双箭头可直达首页或末页,内侧的单箭头用于逐页翻动。
AI 生图
不想自己找图,可以直接在平台里生成。入口有三个:「新建」页的 AI 生图 卡片、「我的库 → 资源」右上角的 AI 生成 按钮、编辑器里的 AI 生成 一节。
写一句画面描述,选模型、画面比例和张数,点「生成」。默认模型每张约 35 蘑菇币,按出图后的实际用量结算,没出图不扣钱;出图一般 30 秒左右,完成后会有一条带缩略图的通知。
生成的图会存进你的素材库(可以指定文件夹),和上传的素材一样用 @asset:{id} 引用。也可以拿一张已有的图当参考,用文字描述要怎么改。
同时最多 2 张在生成,每小时最多提交 30 次。描述不能涉及未成年人或真人换脸,这类请求会被直接拒绝。
