2da Files

Information on 2da files, which are essentially 2 dimensional array tables of information.

Note a lot of information on specific 2da files are on different pages, such as Spells and Abilities for spells.2da.

2da Format

The 2da format is relatively simple:

• The top line must be 2DA V2.0
• There may be one or more blank lines before the first line that contains characters, which is considered the header line
  • The first column header must be blank, and that column is ignored (is usually a human readable number)
    • The first column number IDs can be wrong - the game just reads each new line as a new entry (incremented from 0)
  • The second and onwards columns must have the header match the in-game reference loaded, the order of columns doesn't matter. Label columns are generally ignored.
• Further lines are data rows:
  • Column data - but not the header name - can be in double quotes - "text here" - to include spaces. Whether or not the game understands that one being in quotes very much depends
  • Column data is separated by one or more whitespace characters (tabs, spaces)
  • Blank data is classified with 4 stars: ****
    • You can quote the stars ("****") or have a blank quoted field which, of course, is blank ("") but any other combination of stars (less, more, or in single quotes) will be returns literally.

This all comes together to mean some very odd looking 2das can be completely valid.

You can find notes on reading 2DA files in scripts at the Lexicon page for Get2DAString. Main thing to note is on error (no column or row matching etc.) and on blank entries it returns an empty string.

Order of Columns

The game generally won't care what order columns are in except for two exceptions;

• swearfilter.2da cannot be rearranged
• The first column of the spell preference 2da files

Adding Columns

Most game read 2da files (if not all) can have custom columns added but these are only useful for Get2DAString (and it's a much better idea to create a custom 2DA file for additional metadata).

In one instance in NWN:EE this has a valid use case the engine recognises: Additional "Spellbook" columns in spells.2da, which are now referenced by column name in classes.2da.

Client and Serverside 2das

The game as a whole is made up of the client and the server. A singleplayer game essentially runs both at once for the local user - of course other players may still join if it is created as a network game. Therefore it is important to understand which is which, since some 2da files you don't need to include at all in hakpack or nwsync resource lists, and can be left in the .mod or override folder on a PW server perfectly fine.

The client ones tend to be based around levelling up, appeareances, visuals (icons, vfx, textures, etc.) and sounds (the latter 3 servers don't even load of course). Servers need to know about all the resources loaded by the game in regards to objects, spells, etc.

It is recommended of course for the server to have copies of everything (if only for Get2DAString lookups) while you can lessen the amount put in client hakpacks or on nwsync if sending certain ones to the client.

Client and Server

Client Only

While many of these are only loaded by the game client, the toolset would still make regular use of them, for instance, to be able to have a blueprint reference a particular wing model on a suitable NPC.

It is always recommended to have these available on the server if only for Get2DAString lookups.

Server Only

NWNX Reference

Source of what is referenced by the game engine. It relates to this file: https://github.com/nwnxee/unified/blob/master/NWNXLib/API/API/CTwoDimArrays.hpp

    // client+server
    m_paIPRPCostTables // all of them
    m_pAppearanceTable
    m_pGenderTable
    m_pSurfaceMaterialTable
    m_pVisualEffectTable
    m_pPersistentVisualEffectTable
    m_pCreatureSpeedTable
    m_pDoorTypesTable
    m_pGenericDoorsTable
    m_pPlaceablesTable
    m_pAreaTransitionTable
    m_pIPRPSpells
    m_pIPRPLightTable
    m_pIPRPColor
    m_pIPRPMelee
    m_pItemPropDefTable
    m_pItemPropsTable
    m_pCreatureSizeTable
    m_pArmorTable
    m_pEncumbranceTable
    m_pPortraitTable
    m_pPartsChest
    m_pSpellSchoolTable
    m_pTrapTable
    m_pLightColorTable
    m_pIPRPDamageTable
    m_pPartsRobe
    m_pItemValue
    m_pPackages
    m_pRuleset

    // client only
    m_pPartTable
    m_pArmorTypesTable
    m_pTileColorTable
    m_pReplaceTextureTable
    m_pTailModelTable
    m_pWingModelTable
    m_pCloakModelTable
    m_pCursorTable
    m_pActionsTable
    m_pAmbientMusicTable
    m_pAmbientSoundTable
    m_pFootstepSoundsTable
    m_pAppearanceSoundsTable
    m_pWeaponSoundsTable
    m_pDefaultACSoundsTable
    m_pAmmunitionTypesTable
    m_pKeymapTable
    m_pPlaceableSoundsTable
    m_pDamageLevelTable
    m_pEffectIconsTable
    m_pLoadHintsTable
    m_pSwearFilterTable
    m_pPhenoTypeTable
    m_pIPRPVisualFxTable
    m_pWeatherTypesTable
    m_pProgFxTable

    // server only
    m_pStateScriptsTable
    m_pPoisonTable
    m_pDiseaseTable
    m_pRepAdjustmentsTable
    m_pFractionalCRTable
    m_pEncounterDifficultyTable
    m_pCategoryTable
    m_pExcitedDurationTable
    m_pRestDurationTable
    m_pPartsBelt
    m_pPartsBicep
    m_pPartsFoot
    m_pPartsForearm
    m_pPartsHand
    m_pPartsLegs
    m_pPartsNeck
    m_pPartsPelvis
    m_pPartsShin
    m_pPartsShoulder
    m_pXpBase
    m_pAssociatesAnimalCompanionTable
    m_pAssociatesFamiliarTable
    m_pSkillVsItemCostTable
    m_pRangesTable
    m_pPolymorphTable
    m_pDamageHitVisualTable
    m_pBodyBagTable
    m_pIPRPFeatsTable
    m_pIPRPMonsterDamageTable
    m_pOnHitTable
    m_pOnHitSpellTable
    m_pOnHitDurationTable
    m_pIPRPACModTypeTable
    m_pIPRPWeightIncTable
    m_pIPRPArcSpell
    m_pIPRPBonusCostTable
    m_pIPRPSRCostTable
    m_pIPRPNeg5CostTable