Localization
![]() |
Please help improve this article or section by expanding it. |
Localization files can be found in the localization folder.
Unlike most other files, they localization files have .yml extension.
All files names should look like this: <something>_l_<language>.yml
The file format is UTF-8 with BOM.
Text formatting should begin with a # character and end with #!:
#<formatting code> <text> #! Example: #P +15%#!
Insert other localization keys: $<other key>$ (e.g. $special_contract_march_short$ )
Example:
l_english: innovation_motte:0 "Mottes" innovation_motte_desc:0 "Simple yet effective, building our castles on raised earthen mounds is the best way to ensure we quite literally have the high ground over our enemies." unlock_tribal_economic_buildings:0 "Unlocks all Tribal Era [economic_buildings|E]" unlock_tribal_military_buildings:0 "Unlocks all Tribal Era [military_buildings|E]" unlock_march_contract:0 "Unlocks the #high $special_contract_march_short$#! [feudal_contract|E]"
Contents
Commands[edit]
Commands are used in instances where localisation must be dynamic and change based on certain conditions. Invoking a command will print out a specific string of text.
Gender[edit]
These commands will show text that vary based on the gender of the character in scope.
Command |
---|
GetHerHim |
GetHerHis |
GetHerHisMy |
GetHersHis |
GetHerselfHimself |
GetLadyLord |
GetSheHe |
Character names[edit]
These commands will show some variation of the name of the character. This is not a complete list.
Command |
---|
GetFirstName |
GetFirstNameBase |
GetFirstNameNicknamed |
GetFirstNameNicknamedNoTooltip |
GetFirstNameNicknamedNoTooltipRegnal |
GetFirstNameNicknamedOrMe |
GetFirstNameNicknamedOrMeNoTooltip |
GetFirstNameNicknamedOrMeNoTooltipRegnal |
GetFirstNameNicknamedOrMeRegnal |
GetFirstNameNicknamedPossessive |
GetFirstNameNicknamedPossessiveNoTooltip |
GetFirstNameNicknamedPossessiveNoTooltipRegnal |
GetFirstNameNicknamedPossessiveOrMy |
GetFirstNameNicknamedPossessiveOrMyNoTooltip |
GetFirstNameNicknamedPossessiveOrMyNoTooltipRegnal |
GetFirstNameNicknamedPossessiveOrMyRegnal |
GetFirstNameNicknamedPossessiveRegnal |
GetFirstNameNicknamedRegnal |
GetFirstNameNoTooltip |
GetFirstNameNoTooltipRegnal |
GetFirstNameOrMe |
GetFirstNameOrMeNoTooltip |
GetFirstNameOrMeNoTooltipRegnal |
GetFirstNameOrMeRegnal |
GetFirstNamePossessive |
GetFirstNamePossessiveNoTooltip |
GetFirstNamePossessiveNoTooltipRegnal |
GetFirstNamePossessiveOrMy |
GetFirstNamePossessiveOrMyNoTooltip |
GetFirstNamePossessiveOrMyNoTooltipRegnal |
GetFirstNamePossessiveOrMyRegnal |
GetFirstNamePossessiveRegnal |
GetFirstNameRegnal |
GetFullName |
GetFullNameNicknamed |
GetFullNameNicknamedNoTooltip |
GetFullNameNicknamedNoTooltipRegnal |
GetFullNameNicknamedOrMe |
GetFullNameNicknamedOrMeNoTooltip |
GetFullNameNicknamedOrMeNoTooltipRegnal |
GetFullNameNicknamedOrMeRegnal |
GetFullNameNicknamedPossessive |
GetFullNameNicknamedPossessiveNoTooltip |
GetFullNameNicknamedPossessiveNoTooltipRegnal |
GetFullNameNicknamedPossessiveOrMy |
GetFullNameNicknamedPossessiveOrMyNoTooltip |
GetFullNameNicknamedPossessiveOrMyNoTooltipRegnal |
GetFullNameNicknamedPossessiveOrMyRegnal |
GetFullNameNicknamedPossessiveRegnal |
GetFullNameNicknamedRegnal |
GetFullNameNoTooltip |
GetFullNameNoTooltipRegnal |
GetFullNameOrMe |
GetFullNameOrMeNoTooltip |
GetFullNameOrMeNoTooltipRegnal |
GetFullNameOrMeRegnal |
GetFullNamePossessive |
GetFullNamePossessiveNoTooltip |
GetFullNamePossessiveNoTooltipRegnal |
GetFullNamePossessiveOrMy |
GetFullNamePossessiveOrMyNoTooltip |
GetFullNamePossessiveOrMyNoTooltipRegnal |
GetFullNamePossessiveOrMyRegnal |
GetFullNamePossessiveRegnal |
GetFullNameRegnal |
GetName |
GetNameNicknamed |
GetNameNicknamedNoTooltip |
GetNameNicknamedNoTooltipRegnal |
GetNameNicknamedOrMe |
GetNameNicknamedOrMeNoTooltip |
GetNameNicknamedOrMeNoTooltipRegnal |
GetNameNicknamedOrMeRegnal |
GetNameNicknamedPossessive |
GetNameNicknamedPossessiveNoTooltip |
GetNameNicknamedPossessiveNoTooltipRegnal |
GetNameNicknamedPossessiveOrMy |
GetNameNicknamedPossessiveOrMyNoTooltip |
GetNameNicknamedPossessiveOrMyNoTooltipRegnal |
GetNameNicknamedPossessiveOrMyRegnal |
GetNameNicknamedPossessiveRegnal |
GetNameNicknamedRegnal |
GetNameNoTooltip |
GetNameNoTooltipRegnal |
GetNameOrMe |
GetNameOrMeNoTooltip |
GetNameOrMeNoTooltipRegnal |
GetNameOrMeRegnal |
GetNamePossessive |
GetNamePossessiveNoTooltip |
GetNamePossessiveNoTooltipRegnal |
GetNamePossessiveOrMy |
GetNamePossessiveOrMyNoTooltip |
GetNamePossessiveOrMyNoTooltipRegnal |
GetNamePossessiveOrMyRegnal |
GetNamePossessiveRegnal |
GetNameRegnal |
Special Characters[edit]
Some sets of characters perform special functions.
Command | Description | Example |
---|---|---|
\n | Line break. Works only in certain cases. | |
#P | Formats text "positive" | #P A very good thing has happened#! |
#N | Formats text "negative" | #N A rather bad thing has happened#! |
#help | Text is shown using a help style | #help If you do not give either Gold or Soldiers to the war effort, your [head_of_faith|E] will condemn you and you will lose [piety|E].#! |
#I | Text is displayed in an informational style | #I Click to view your [GetPlayer.GetCouncillorPosition( 'councillor_court_chaplain' ).GetPositionName]#! |
#W | Text is displayed as a warning | #X Only your younger children lacks [guardians|E]#! |
Linking[edit]
Localization strings can link to game concepts as follows:
[concept_key|E] # So for example [faith|E]
Rounding numbers[edit]
If a numeric value has a decimal portion, it can be rounded by using the desired number of decimal places, such as:
# Round to 2 decimals [some_value|2] # Remove all decimals: [some_value|0]
Note that the value is always rounded down.
References[edit]
Documentation | Effects • Triggers • Modifiers • Scopes • Variables • Data types • Localization • Customizable localization |
Scripting | AI • Bookmarks • Characters • Commands • Council • Culture • Decisions • Dynasties • Events • Governments • History • Holdings • Lifestyles • Regiments • Religions • Story cycles • Titles • Traits |
Map | Map • Terrain |
Graphics | 3D models • Exporters • Interface • Coat of arms • Graphical assets • Fonts • Particles • Shaders • Unit models |
Audio | Music • Sound |
Other | Console commands • Checksum • Mod structure • Troubleshooting |