本地化

本地化文件将 eu4 文件中事物的内部代码名称与实际文本关联起来，并根据 eu4 所设置的语言使用不同的文本。

格式

EU4 使用的格式类似于 YAML，大致如下：

l_english:
 MENU_MESSAGES_DISABLE_ALL:0 "Disable all"
 FILTER:0 "Filter"
 TO_ME:0 "To me"
 FROM_ME:0 "From me"
 INTERESTING:0 "Interesting"
 OTHERS:0 "Others"
 hre_province_restored:0 "Territory restored to the Empire"
 DECAY:0 "Decay"

以下规则适用于所有本地化文件：

• 本地化文件必须放在 "localisation" 文件夹中（"localization" 无效）。
• 要替换原版或其他模组中已有的本地化，请将编辑后的本地化文件放入 "localisation/replace"。
• 文件名必须以 _l_english.yml 结尾，例如 mymod_l_english.yml。为英语以外的语言进行本地化时，请将 english 替换为对应的语言（french 等）。
• 文件必须编码为 带字节顺序标记的 UTF-8（UTF-8-BOM）。如果本地化文件使用 ISO 8859-1 等单字节编码，游戏将无法读取该文件，而是直接显示本地化键名。为确保编码正确，可以复制一份原版本地化文件，或使用 Notepad++ 等高级编辑器，通过编码菜单中的 Convert to …（转换为……）选项进行设置。游戏的其他文本文件（.txt）应使用 CP-1252/ANSI 编码，且绝不能带有 BOM。
• 文件的第一行必须是 l_english:（同样，将 "english" 替换为其他语言）。
• 与其他文件一样，引号之外的 # 表示行注释——只要该行 # 之后不含双引号（"），其后的所有内容都不会被 eu4 读取。你可以在引号内的文本中使用 #。
• 空行会被忽略（包括仅含空白字符和注释的行）。
• 其他所有行都必须符合以下格式：

1. 恰好一个空格
2. 本地化键，只能包含以下字符：A-Z、a-z、0-9、'_'、'.'、'-'。游戏通过该键来确定文本应当用于何处。在某些情况下（例如事件标题、描述、选项名称），键在其他游戏文件中指定；在另一些情况下，键由代码对象名称派生（例如，名为 test_decision 的决议会自动使用 test_decision_title 作为其标题的本地化键，使用 test_decision_desc 作为描述的本地化键）。
3. 冒号（:）
4. 可选：一个数字。没有实际含义，供 eu4 开发者记住该文本的“版本”。
5. 恰好一个空格
6. 一个双引号（"）
7. 本地化文本。它几乎可以使用任何 UTF8 字符，但只有 UI 元素所用字体中包含的字符才能正确显示。对于原版字体，即 CP-1252/ANSI 字符集。换行必须写作 \n，反斜杠必须写作 \\。文本中的双引号可以正常使用（旧版游戏要求将其写作 \"）。反斜杠后跟任何其他字符都会破坏本地化。
8. 一个双引号（"）

• 偏离此格式可能会破坏本地化文件，并导致其后所有行被忽略。
• 任何本地化键都可以放在任何文件中，替换本地化时亦然；不过，最好将相近的键值对放在同一文件中（并使用与被替换文件相同的文件名），以便日后查找。

文本格式

本地化系统还支持在本地化字符串中（而非 C++ 代码中）格式化文本。要格式化某个变量，请输入 §，后接所需的格式规则，再以 §! 结束该表达式。

如果键盘上有数字小键盘，可以按住 左 Alt，在小键盘上输入 0167，然后松开 左 Alt，即可轻松输入 §。必须开启 NumLock 才有效。

或者，也可以尝试 Compose 键序列 S, !。

目前实现了以下格式规则：

§<COLOR_CODE>彩色文字§!

"This is regular text, §Rand this text is red§!"

"Regular text, §Rred text, §Bblue§! and back to red§!, and black"

$VAL|%$!

$VAL|*$!

$VAL|=$!

$VAL|<1..9>$!

$VAL|3$!

$VAL|+$!

$VAL|-$!

例如，若要将一个定点数值转换为百分比并保留一位小数，且在其为正时显示为绿色，现在可以写作 $VAL|%2+$!。若要将一个数值显示为黄色、保留 3 位小数，并在其为正时加上 '+' 号，则可以写作 §=Y3$VAL$§! 等。

变量

我们可以通过几种方式来显示动态的本地化信息（例如省份的宗教）。

方括号命令

这是调用数据并在本地化中显示的更简洁、更新、更灵活的方式。它使用类似于事件修改中 作用域 的系统，不过请注意，它使用的是下文所列的一套独有的作用域。任何做过面向对象编程的人都会对它感到熟悉。

下面是一些示例——请注意游戏是如何从事件的 Root/From 出发，通过各级作用域，直至找到我们所需的信息的。

[Root.GetAdjective]

我们可以使用额外的作用域：

[FRA.Monarch.GetTitle]

与常规代码中的 FROM 不同，本地化命令允许叠加 From 作用域，以访问事件链中更早的部分：

[From.From.From.Owner.Monarch.GetHerHim]

作用域（区分大小写）

没有起点的作用域（如 Root）可用于开始本地化命令。

命令（区分大小写）

@TAG

@TAG（例如 @HAB）会显示该标签对应的国旗，可与 @[Root.GetTag] 及类似的本地化作用域配合使用。

键

游戏现有的本地化文件中出现了许多标量标识符。它们不太灵活，也不太美观，但只要作用域正确，我们就可以使用它们。

其中一些可能无法用于事件、任务等，因为它们需要通过游戏代码获得其他数据。

替换本地化键

要替换原版本地化，请在 localisation 文件夹内创建一个名为 replace 的文件夹，并将包含你想替换的原版本地化键的本地化文件放入其中。你也可以像对待其他内容一样，通过 模组 来修改本地化。计算 校验和 时会忽略本地化。

文化省份名称

如果开启了“使用动态省份名称”，省份名称会根据当前所有者的文化，从 localisation 文件夹中的取值发生变化。这些名称列在 common/province_names 之下，每个标签、文化或文化组可以对应一个文件。每个文件包含一个列表，每一项由省份编号、等号以及 1 至 2 个带引号的名称构成。一个带引号的名称将替换省份名称；两个带引号的名称（以花括号括起）则以第一个作为省份名称，第二个作为省份首府名称。例如，来自 british.txt 的内容：

873 = "Astoria"
893 = { "New Orleans" "New Orleans" }
894 = "Ecore Fabre"
896 = "Grand River"
897 = { "Little Rock" "Little Rock" }
899 = { "Ozarks" "Springfield" }
908 = { "Minnesota" "St. Paul" }
910 = "Red Lake"
911 = { "Upper Peninsula" "Escanaba" }

将使用可用的最具体的名称。例如，编号为 282 的省份通常名为 Yedisan，1444 年由克里米亚拥有；如果被某个突厥国家拥有，它就叫 Hocabey；但如果被奥斯曼拥有，则叫 Özü，即使奥斯曼同样是突厥国家。

图标

图形图标通常通过用井号（£）包围文本键来插入，但也有一些例外（例如杜卡特图标）。

文本键指的是某个 .gfx 文件中定义的 spriteType 名称。

你应当可以使用任何 spriteType，但要注意你打算使用的图像尺寸应适合用于行内文本。

默认图标可在 interface/texticons.gfx 中找到

常用图标
类别	描述	键	图标
通用	“是”指示符	£yes£
	“否”指示符	£no£
君主点数	行政点数	£adm£
	外交点数	£dip£
	军事点数	£mil£
资源
	杜卡特	¤
	人力	£icon_manpower£
	水手	£icon_sailors£
舰船	重型船只	£big_ship_icon_small£
	轻型船只	£light_ship_icon_small£
	桨帆船	£galley_icon_small£
	运输船	£transport_icon_small£
陆军单位	步兵	£infantry_icon_small£
	骑兵	£cavalry_icon_small£
	炮兵	£artillery_icon_small£

导入/导出文本以进行翻译

要导出，请创建游戏 exe 的快捷方式。右键点击并选择属性，然后在目标末尾输入

-export_loc

。这将在游戏文件夹中创建一个名为 "customizable_localization" 的文件夹。现在可以打开并翻译这些文件。请将你的译文放入对应的语言列中。如果没有你所用的语言，可以重命名其他列之一。

如果你使用 Steam，则无需创建快捷方式，而是在 Steam 中右键点击 EU4 并选择属性。在“常规”选项卡上，点击“设置启动选项...”并输入上述内容。请记得之后将其移除，因为游戏在使用此选项时并不会真正启动。

要导入，请在刚刚创建的文件夹旁新建一个名为 localization_translated 的文件夹，并将你的文件放入其中。文件名开头必须带有 l_language（语言名称），并通过以下这行导入：

-import_loc

随后，你会在文档文件夹中得到一批文件，位于一个新建的名为

localization_import

的文件夹中。需要将这些文件复制并粘贴到游戏的 localization 文件夹中。当导出和导入都完成后，结构大致如下：

总而言之，如果你是将例如我们的英文文本翻译成另一种语言，就不必太在意格式，只需模仿我们所写的即可。如果你是在为自己的模组添加文本，则可能需要对前两个标题多加留意。