创作入门 · 4 分钟阅读
把 Ren'Py 视觉小说导入 Pominis
把 Ren'Py 游戏变成能在浏览器里玩的故事：导入会保留哪些内容，「导入游戏」窗口怎么一步步填写，以及哪些东西转换不过来、为什么。
如果你用 Ren'Py 做完了一部视觉小说，或者做到一半，现在不必从头重做，可以直接把它导入 Pominis。导入会读取游戏的脚本和素材，生成一个普通的 Pominis 项目：场景、选项、变量、结局、画面和音乐都在，能在浏览器里玩，之后也能继续交给 Agent 修改。它移植的是脚本做了什么，而不是模拟 Ren'Py 引擎本身，所以上传前最好先弄清楚边界在哪里。
本文用一个虚构的例子贯穿始终：一部用 Ren'Py 写的港口小镇短篇《末班渡轮》，里面有一个决定玩家留下过夜还是离开的选择、一个信任度变量，游戏的 tl 文件夹里还有一份日文翻译。
导入会保留什么
- 对白和旁白，说话人的名字沿用 Character 定义里的写法。
- menu 菜单会变成选项，只在满足条件时出现的选项也会保留条件。
- label、jump 和 call 会变成场景之间的连接。过长的 label 会拆成几个场景，名字像 chapter_1、day2 这样的 label 会成为章节。
- 变量和条件：$ 赋值以及 if、elif、else 会变成故事变量和条件分支。
- 结局：无处可去的场景会成为结局，能从 label 取名时就用 label 命名。
- 画面：每个场景的背景，以及用 scene、show 显示的立绘，会按原作的摆放位置合成为一张图。分层立绘（layeredimage）会被合并。
- 角色：每个角色会从某张立绘里裁出头像，并附上一段文字设定，方便之后继续使用。
- 用 play music 播放的音乐会作为这个故事自己的曲目上传。
翻译会被特别处理。如果游戏在 game/tl 下有翻译文件夹，导入时会优先使用和你当前 Pominis 界面语言一致的那一份（如果有的话）。用日文界面导入《末班渡轮》，得到的是日文版；用英文界面导入，得到的就是原始脚本。
label harbor_night:
scene bg harbor_dusk
show aoi worried at right
a "The last ferry leaves at nine."
menu:
"Stay the night":
$ trust += 1
jump inn
"Take the ferry" if ticket:
jump ferry导入 Pominis 后，港口背景和葵的立绘合成为一张场景图，她的台词变成对白，menu 变成两个选项。第二个选项保留了 ticket 条件；选择留下仍然会让 trust 加一，供后面的判断使用。
一步步导入游戏
- 把游戏打包成一个 .zip。直接用下载的发行包就可以，只要 game 文件夹里有 .rpy 源脚本；压缩包里的 .rpa 归档会被自动解开。只有编译后 .rpyc 文件的游戏无法导入，加密的 zip 也会被拒绝。单个文件最大 1.5 GB。
- 打开导入窗口。在工作区首页的「其他开始方式」里选「导入游戏」；在「项目」页面点「导入游戏」按钮；或者直接在输入框里附上这个 zip。在 VN Studio 的对话框里附上也可以：游戏会导入为一个新项目，当前项目不受影响。
- 填写窗口里的信息。「故事名称」留空则使用游戏原名。「署名（可选）」用来写作者与许可，例如「作者 张三，CC BY 4.0」，它会写进第一章的简介。
- 确认权利。只有勾选「我有权改编并发布这部作品（我是作者，或它的许可允许改编，例如 CC0、CC BY）」之后，「开始导入」按钮才能点。
- 查看进度：上传中、解包游戏、读取剧本、生成画面、导入音乐、整理角色、命名选项、保存项目。上传完成前请不要关闭页面；上传完成后可以点「后台继续」，项目准备好后会出现在「项目」里。
导入完成后，项目会在 VN Studio 中打开。它和其他项目一样只是草稿，在你发布之前不会公开；上传的压缩包也会在导入结束后删除。
先了解这些限制
- 每个账号同一时间只能进行一次导入。如果上一次还在进行，请等它结束再开始下一次。
- 导入超过 30 分钟会被停止。特别大的游戏可能需要拆成几部分。
- 音效、语音和视频不会被带过来，只保留音乐。
- 转场、停顿和动画会被舍弃。立绘的位置会读取，但动作不会。
- 自定义界面（screen）和小游戏无法运行。如果某个界面的按钮或热区会跳转到某个 label，它们会变成选项：有文字的按钮沿用按钮文字，只有图片的按钮会生成一个简短的动作名。
- 除了简单的变量赋值和条件判断之外，其他 Python 代码、persistent 持久数据以及直接调用引擎的代码都会被跳过。
- NVL 模式的整页文字排版不会还原，角色名字的颜色也不会保留。
导入不会列出它跳过了哪些内容。请从头玩一遍项目，和原作对照，尤其是小游戏、自定义菜单，以及依赖时机或声音的场景。
交给 Agent 继续创作
故事进入 Pominis 之后，就是一个普通项目，Agent 可以修改、翻译或续写它。把移植带不过来的部分交给它：「暴风雨那场现在没有声音了，给它配一段安静的雨声音乐。」「重写旅馆那一场，让葵说明她为什么要走。」「把故事翻译成中文。」「从渡轮结局接着写第二章。」Agent 生成新的图片、视频和文字照常消耗积分；移植本身用的是游戏原有的美术，不会重新生成画面。
有些修改自己动手更快。用「场景详情」打开场景，就能改一句台词或某个选项的去向。如果原作在一场戏中途切换了立绘表情，检查一下合成出来的图是否还和台词对得上；发布前把每条路线都玩一遍。
只导入你有权改编的作品
权利确认不是走过场。请只导入你自己的游戏，或许可协议明确允许改编的游戏，并用「署名」栏把作者和许可一起带进故事。一部下载来的商业游戏，不会因为能顺利导入就变成你可以发布的作品。
