支持的引擎 · YU-RIS
YU-RIS 引擎翻译工具 — 端到端翻译 raiL-soft 日语视觉小说
YU-RIS(由 raiL-soft 开发)是一款历史悠久的 Windows 脚本引擎,背后有数百部独立和商业日语视觉小说。它的资源存放在 .ypf 包归档里,剧情则编译成 YSTB 脚本(ysbin.ypf 内的 .ybn 文件,内部路径如 ysbin/yst00000.ybn)。RuneTranslate 用纯 Rust 读取 .ypf 包 — 无需外部工具 — 解压条目,然后解析编译后的 YSTB 脚本:它拆分四个区段(指令、参数描述符、字符串值、行号),并自动解码,无需任何配置。随后它从字符串表提取日语对话,并在编辑器中列出每一行,同时默认排除引擎的命令操作数、变量名和资源路径,因此你绝不会翻译到脚本逻辑用来比较的内容。导出时它会重建字符串表 — 修补每一个偏移,使更长或更短的翻译都能放下 — 以同样的方式重新编码,并把翻译后的 .ybn 以松散形式写在其归档路径。由于 YU-RIS 运行时会优先读取磁盘上的松散文件而非 .ypf 内相同路径的文件,游戏便直接加载你的翻译 — 无需重打包。它已在一个真实游戏上于游戏内确认,但 YU-RIS 因发行版而异,因此请在依赖它之前测试导出的版本。
视觉小说在数千行文本中依赖固定的角色阵容和反复出现的术语,而机器翻译会在三个章节里把女主角的名字拼成三种不同的写法。预先把你的角色、地名和反复出现的术语加进术语表,这样每一行对话都会以相同方式呈现它们。
如何翻译 YU-RIS
- 步骤 1
打开 YU-RIS 游戏文件夹
将 RuneTranslate 指向游戏目录 — 含游戏 yu-ris.exe 及其 .ypf 包(通常在 pac/ 子文件夹里,脚本在 ysbin.ypf 中)的文件夹。如果游戏的脚本已经解包,一个松散的、含 .ybn 脚本的 ysbin/ 文件夹也会被检测到。引擎检测会自动识别 YU-RIS 布局;你的原始文件夹绝不会被修改。
- 步骤 2
读取 .ypf 包并解码 YSTB 脚本
RuneTranslate 用纯 Rust 打开 .ypf 包,解压条目,并解析其中编译后的 YSTB 脚本。它会自动解码每个脚本,无需任何配置,并读取 Shift-JIS 字符串表,并在编辑器中按脚本文件分组列出每一条日语行。引擎命令操作数、变量名和资源路径会被呈现出来但默认排除,因此剧情逻辑保持完整。
- 步骤 3
通过你偏好的服务商翻译
这些游戏对话密集且对语气敏感,因此 LLM(OpenAI GPT-4o / Anthropic Claude)或 DeepL 通常读起来最好;免费的 Google Translate 或本地模型(Ollama / LM Studio)可覆盖短菜单字符串和选项,你还可以把 OpenAI 兼容服务商指向 OpenRouter 或 NanoGPT。可选的 AI 精修二次处理能收紧生硬的措辞。
- 步骤 4
保持内联控制码完好无损
YU-RIS 的消息文本会把反斜杠控制码(换行、颜色、ruby)和方括号标签穿插在对话中。RuneTranslate 在翻译过程中会把它们每一个冻结为数字占位符,并在输出时还原,因此翻译后的行保持与原文相同的格式和节奏。
- 步骤 5
以松散文件覆盖导出(无需重打包)
导出时,RuneTranslate 会复制游戏并重建每个翻译后的 YSTB 脚本 — 修补字符串表偏移,使任意长度的翻译都能放下,并以同样的方式重新编码 — 然后把它以松散形式写在其原始归档路径(如 ysbin/yst00000.ybn)。YU-RIS 运行时会优先读取松散文件而非 .ypf 内相同路径的文件,因此游戏只会读取你的翻译,无需重打包。运行导出的副本,它就会以你的语言运行。
支持内容
- 纯 Rust 的 .ypf 包读取器(含解压),无需外部工具或辅助程序
- 用纯 Rust 解析编译后的 YSTB .ybn 剧情脚本(指令 / 描述符 / 字符串表 / 行号)
- 编译后的 YSTB 脚本自动解码,无需任何配置
- 从字符串表提取日语对话;命令操作数 / 变量名 / 资源路径默认排除
- 重建字符串表并完整修补偏移,使更长或更短的翻译都能放下
- 松散文件覆盖导出 — 翻译后的 .ybn 放在其归档路径,无需重打包
- 通过 DeepL、Google、OpenAI、Anthropic、OpenAI 兼容或本地模型翻译成 30 多种语言
局限
- 已在一个真实游戏上于游戏内确认,但各发行版不尽相同,所以在依赖它之前先测试导出的构建
- YU-RIS 字符串为 Shift-JIS(cp932):英语和其他可用 cp932 表示的目标可用;非 cp932 脚本(如扩展西里尔文、韩语、繁体中文)需要尚未自动化的游戏字体 / 编码变通方案
- 烘焙进图像(标题界面、菜单、按钮)的文本不属于脚本;图片文字 OCR 流程只能触及游戏作为松散文件保存的图像,而不是打包在 .ypf 里的
- 通过 YSCM 命令表进行的逐命令消息标记是一项计划中的改进;目前脚本中的每条日语字符串都会被提供,非显示字符串则以启发式方式排除

