语言包 MOD

游戏自带日文、简体中文、繁体中文、英文、韩文五种阅读语言。语言包可以再加一种：装好、启用、重启游戏之后，设置里的语言菜单和语言切换键（F7）都会出现它。没翻译到的界面文字、名称和台词，显示你指定的退回语言；退回语言也没有的，显示日文原文。

同一个包也可以只改现有语言，比如换一套英文译文。

包的安装和管理见 MOD 包：安装与制作。需要 0.5.3 或更新的版本。

包里放什么

yourname.korean/
  mod.json
  dialogue/ko/language.json      这种语言的声明（新语言必须有）
  dialogue/ko/terms.json         界面文字与名称
  dialogue/ko/story/…            剧情台词
  dialogue/ko/battle/…           战斗台词
  dialogue/ko/fonts/…            字体（我们的字体没有这种文字时）
  art/ko/scene-images/…          按语言换的图（可选）
  art/ko/plates/…                世界地图名牌（可选）

ko 是语言代码，文件夹名和 language.json 里写的必须一样。只放用得到的东西：没翻的台词文件、没换的图都可以不放。

完整的范例是「韩文（第一关演示）」，源文件在 config/recomp/mods/lang.ko（韩文已内置到游戏里，这个包不再提供下载）。真实系男主第一关的剧情、战斗台词、全部界面文字都是韩文，其余显示英文。

制作步骤

下面的工具都在源代码仓库里，需要 Python 3。

1. 从一种现有语言导出起点

python3 tools/mods/language_template.py --locale ko --name 한국어 --fallback en --id yourname.korean -o korean-source

它把退回语言（这里是英文）的全部文字按上面的结构写进 korean-source：terms.json 里是全部界面文字和名称，dialogue/ko/ 下是全部台词文件，mod.json 和 language.json 也写好了。--id 是包的唯一名字，写成「作者.名字」，发布后不要再改。

2. 翻译

把 terms.json 和台词文件里的退回语言换成你的语言，规则见下面几节。不翻的条目可以留着，也可以删掉——没写的地方游戏会显示退回语言。只翻一部分也是一个能用的包，范例包就只翻了第一关。

3. 放字体、写名字

我们的字体没有这种文字时，把字体文件放进 dialogue/ko/fonts/，写进 language.json 的 fonts。在 mod.json 里填作者和许可证（见 MOD 包）。

4. 检查、打包

python3 tools/mods/validate.py korean-source

python3 tools/mods/pack.py korean-source -o build/mods

validate.py 按游戏的规则检查文件结构、语言代码、字体和各个字段；pack.py 打出 yourname.korean-0.1.0.srw64mod，打完再检查一遍。控制码和原文对不对、台词页数对不对，要游戏读到 ROM 才能核对：进游戏后看日志里有没有 SRW64_MOD_LANGUAGE_PROBLEM，用户目录的 dialogue/dialogue-report.txt 里列着每一条有问题的台词。

5. 安装、选语言

像别的 MOD 一样安装（电脑上拖进游戏窗口，安卓上放进 Documents/Marchwind64/mods 或在 MOD 页面「从文件安装」），重启游戏，然后在设置的语言菜单里选它，或者按语言切换键（F7）。选好的语言会记住，下次启动直接是它。

边改边看：把正在改的台词文件放进用户目录的 dialogue/ko/，它会盖在包上面；在游戏里按 F5 重新读取，当前这句马上按新文本显示，改好了再抄回包里。战斗台词用标题画面的「战斗鉴赏」看最快，不用玩到那一关。

仓库的 docs/guide/language-mods/ 文件夹里有翻译流程、规则清单和韩文演示包用的专名表，可以整个交给 AI 助手，让它照着翻。

language.json

{
  "schema": "srw64.language.v1",
  "locale": "ko",
  "name": "한국어",
  "fallback": "en",
  "fonts": { "text": ["fonts/MyGothic.ttf"], "title": "fonts/MyBrush.ttf" }
}

排版跟退回语言走：退回英文的语言，词与词之间留空格、在空格处换行；退回中文或日文的，按中日文的方式排。韩文、法文这类用空格分词的语言选 en。

字体：只能放在 fonts/ 里，.ttf 或 .otf，每个不超过 32 MB。西文字母我们的字体都有，法文、西班牙文这类不用自带；韩文、泰文等我们字体里没有的字，要放字体文件，否则显示不出来。字体的许可证要允许随包分发。

terms.json：界面文字与名称

{
  "schema": "srw64.language-terms.v1",
  "ui": { "title_start": "시작" },
  "entries": { "base:t00_00000": "평지<END>" }
}

• ui：界面文字，键和游戏自带语言的一样（模板里全有）。{A} 这类按键记号、{n} 这类数字位要原样保留，少了或多了的那条不用。
• entries：人物名、机体名、武器名、地形、能力名、系统提示等，记录号 0–5643。<BR>（换行）、<STOP>（翻页）、<END>（结尾）这些控制码要和原文一样。条目可以写成字符串，也可以写成 {"text": "…", "ja": "…"}，ja 只是给你对照的日文原文，游戏不读它（模板在有 ROM 文本导出时会填上）。
• 武器菜单名（entries 里开头带「格」「射」的那些）要保留这个开头字，它在游戏里显示成格斗／射击图标。
• 没写的条目显示退回语言的。

台词

剧情、战斗台词和文字页（开场、结局）写成纯文本，格式和玩家自己改台词的文件一样，见仓库里的台词纯文本格式。文件放在 dialogue/ko/ 下面任意位置，一条记录一段：

@17410 로렌스
“아가씨, 차가 준비되었습니다. 오늘은 러시안 티입니다.
---
어디로 가져다 드릴까요?”

页数（---）、选项个数、{HeroName} 这类名字占位符要和原文一致，不一致的那条不用，显示退回语言的。玩家自己的台词文件夹里也可以有 ko/，盖在包的上面。

按语言换图

阅读这种语言时，下面的图换成包里的：

• art/ko/scene-images/<文件名>：场景图，例如标题画面的 logo art/ko/scene-images/title-logo.png。文件名和 HD 包里的一样，需要装着 HD 包。
• art/ko/plates/<编号>.png：世界地图上舰船和地点的名牌，编号是我们名牌文件名去掉 .plate.ja.png 的部分（例如 5590、5599.6），尺寸要和我们的一样。没给的名牌先用 HD 包里这种语言的（HD 包从下一版起自带韩文名牌），再没有就用退回语言的。

别的包里的这种语言

装着语言包时，其他 MOD 也可以写这种语言的文字：mod.json 的名字和说明、追加剧本的名字和章节标题、名字 MOD、曲名。没写的照样按退回语言显示。

注意

• 启用、停用、更新语言包后都要重启游戏。正在用的语言包被停用或删除，下次启动回到系统语言。
• 韩文（ko）只在空格和标点处换行，词中间不断开。
• 需要词典断行的语言（泰文、老挝文、高棉文、缅甸文）只能在空格处换行；从右往左书写的语言（阿拉伯文、希伯来文）暂不支持。
• 有问题的语言包不会出现在语言菜单里，原因写在游戏日志里（SRW64_MOD_LANGUAGE_PROBLEM）。发布前用 tools/mods/validate.py 检查一遍。