Maintenance script: UI Lua API import (WAR 1.4.8)

2026-10-16T19:40:37Z

UI Lua API import (WAR 1.4.8)

New page

{{LuaApi|group=Interface}}
Reads a CSV file from the game data and stores its rows in a Lua table.

<pre>
BuildTableFromCSV(csvPath, luaTableName)
</pre>

== Arguments ==
;csvPath : <code>string</code> – Path of the CSV file in the game data, for example <code>"data\\gamedata\\pregame_features.csv"</code>.
;luaTableName : <code>string</code> – Path of the Lua table to fill, for example <code>"PregameFeatureList"</code>.

== Returns ==
Nothing.

== Details ==
* The first line of the file is the header. It gives the field names.
* Every following line becomes one entry: <code>''luaTableName''[''id''][''fieldName''] = ''value''</code>, where <code>id</code> is the first cell of the line read as a whole number, and each further cell is stored under the field name from the same column of the header.
* Cell values are converted like this:
{| class="wikitable"
! Cell !! Stored as
|-
| digits, optionally starting with <code>-</code> and with at most one <code>.</code> || <code>number</code>
|-
| <code>true</code> / <code>false</code> (any case) || <code>boolean</code>
|-
| anything else || <code>string</code>
|}
* Reading stops at the first line whose first cell cannot be read.
* Cells longer than 511 characters are cut.
* The function needs at least two arguments and only reads the last two. Both must be strings.

== Errors ==
* <code>Error in function call 'BuildTableFromCSV': Unable to open CSV File %s</code>

== Example ==
From <code>interfacecore/source/characterselectwindow.lua</code>:
<pre>
BuildTableFromCSV("data\\gamedata\\pregame_features.csv", "PregameFeatureList")
...
-- Loop through each feature in the CSV and Populate the Data Structures
for _, featureData in ipairs( PregameFeatureList )
do
local career = GameData.CareerLine[featureData.FEATURE_CAREER]
local gender = GameData.Gender[featureData.FEATURE_GENDER]
local featureName = GetPregameString( StringTables.Pregame[featureData.FEATURE_LABEL] )
...
end

PregameFeatureList = nil
</pre>

== See also ==
* [[API:LoadStringTable|LoadStringTable]]

API:BuildTableFromCSV - Revision history

Maintenance script: UI Lua API import (WAR 1.4.8)