Module localisable_fields 

Localisable fields parsing for Assembly Kit integration.

This module handles the parsing of Assembly Kit’s localisable fields definition file, which identifies which table fields contain translatable text that should be extracted to .loc (localisation) files.

Overview

Total War games support multiple languages through localisation files (.loc files). Rather than storing translated text directly in database tables, certain text fields are marked as “localisable” and their content is stored in separate translation files.

The Assembly Kit includes a TExc_LocalisableFields.xml file that defines which fields in which tables should be treated as localisable.

File Format

The localisable fields file is an XML file with this structure:

<dataroot>
  <TExc_LocalisableFields>
    <table_name>units_tables</table_name>
    <field>onscreen_name</field>
  </TExc_LocalisableFields>
  <TExc_LocalisableFields>
    <table_name>units_tables</table_name>
    <field>short_description</field>
  </TExc_LocalisableFields>
</dataroot>

Main Types

• RawLocalisableFields: Root structure containing all localisable field definitions
• RawLocalisableField: Single field marked as localisable

Availability

Localisable fields files are only available in Assembly Kit versions 1 and 2:

• Version 0 (Empire/Napoleon): Not available - must be determined through analysis
• Version 1 (Shogun 2): Available as TExc_LocalisableFields.xml
• Version 2 (Rome 2+): Available as TExc_LocalisableFields.xml

Structs

RawLocalisableField

Single localisable field definition.

RawLocalisableFields

Complete localisable fields definition from Assembly Kit.