Naming conventions

From Dragon Age Toolset Wiki
Jump to: navigation, search

BioWare's resources follow a naming convention which allows for easy management and easy location of resources needed. When creating new resources it is a good idea to follow the existing naming convention (or your own scheme if you have a preferred one), to differentiate your work from that of others and to help you keep your resources organized.

For the most part the names you give your resources will matter only to you, there are very few situations where the toolset pays attention to the specific form that a resource name takes. So provided you're working on your own any naming convention that suits your particular style will suffice.

Although only one campaign is loaded at a time in game, unintended conflict can arise between the campaign and any core resource mods the player may have installed. If two design resources have the same name, only one will load. This is determined by the Source directory priorities. So, it's good to choose names that are likely to be unique.

Usually resources are separated by underscores into categories and have prefixes sorting them based on a certain main class, or suffixes giving them certain variations.

Resource Naming Convention

Design resource names are free-form. As a matter of convenience and courtesy to players, you might prefer to follow a convention that reduces the risk of conflict between add-ins and improves compatibility with future Bioware releases. Bear in mind that only one resource with a given name will load in game.

For simple mods, it might be sufficient to use a unique resource name prefix which is unlikely to be used by anyone else. See Prefixes in use.

Larger mods and campaigns may prefer a more professional approach which makes scripting more legible by identifying the resource type etc.

In either case, it would be wise to avoid a prefix that Bioware has already used, such as "gen".

The convention used in the main Single Player campaign of Dragon Age is as follows:

cir200cr_bloodmage
  • Three-letter prefix indicating which large-scale area of the game the resource begins to (particular origin story, prelude, etc) or "gen" for global resources.
  • three-digit number unique to a particular area, generally starting with 100 and incrementing in hundreds for major areas. Accessory areas are given numbers within the block of one hundred that their 'parent' area belongs to. "global" resources are often given the number 000.
  • two-letter code indicating what general type of resource it is ("ar" for area, "al" for area list, "ip" for placeable, "cr" for creature, "im" for item, "tr" for trigger, "pt" for plot, "st" for stage, "cs" for cutscene, "wp" for waypoint). A major exception here is event scripts, which have exactly the same name as the resource they're the script for. Dialogue files are also generally named exactly the same as their owner resource. Merchants usually have the owner name, with the prefix "store_".
  • An underscore.
  • The remainder of the name is free-form and human-readable, a descriptive term to remind you at a glance what the resource is.

Model File Naming Convention

Items

[MainClass]_[MODELTYPE]_[MODELSUBTYPE][MODELVARIATION]_[LOD].MMH / PHY 

[ef]_[rob]_[enc][a]_[0].mmh  (ef_rob_enca_0.mmh)
  • Where [MainClass] is of General type of a Model. The Toolset will build the MainClass based on Race/Gender/Itemtype etc, so this must be correct. (see below)
  • [MODELTYPE] as defined with 2DAs. Typically a short name describing the Model ie. Wolf. See: ItemVariations.xls
  • [MODELSUBTYPE] is optional as defined with 2DAs. Typically a short name describing different Variations of a Model. See: ItemVariations.xls
  • [MODELVARIATION] is optional as defined with 2DAs. Typically one letter a, b, c describing further Variations. See: ItemVariations.xls
  • [LOD] is optional for LOD Versions of Models, where its 0, 2 or 3 from highest to lowest LOD. Options are dependant on resourcetype, however 0 is always required if LOD is applicable.

Creatures

[MainClass]+[ModelName]_[LOD].MMH / PHY

[c]_[deepstkra]_[0].mmh (c_deepstkra_0.mmh)
  • [MainClass] is the general type of the model. When no override is set in APR base.xls, the toolset will generate it based on race and gender. (see below)
  • [ModelName] is the Modelname (including mainclass) described in APR base.xls. When no Modelname is given, and Modeltype is P, the toolset will generate it based on NakedVariations.xls (unsure)
  • [LOD] is optional for LOD Versions of Models, where its 0, 2 or 3 from highest to lowest LOD. Options are dependant on resourcetype, however 0 is always required if LOD is applicable.

This accounts for the game being able to locate a MMH via 2DA definitions. MSH / MAO / DDS Files are referenced by the MMH and each other but follow similar schemes.

Model Main Class Naming Convention

  • base
  • blk - black boxes of various sizes and proportions, used to obscure the portions of models that lie "outside" an interior level where the player shouldn't be able to see.
  • c - Creature (full body)
  • cai - Cave Int.
  • cav - Caves
  • cdr - Cave Deep Road
  • che - Chantry Exterior
  • chi - Chantry Interior
  • cn - Creatures split into body/head/eyes
  • cs - Cutscene
  • df - dwarf female accessories and components
  • dm - dwarf male accessories and components
  • dne - dwarf noble exterior level pieces
  • dni - dwarf noble interior level pieces
  • dse - Dwarf Slum Exterior
  • dsi - Dwarf Slum Interior
  • dwe - Dwarven Exterior (Orzammar City)
  • dwi - Dwarven Interior
  • ef - elf female accessories and components
  • el - Lights
  • el_lr - Light Rig
  • el_lp - Light Probe
  • em - elf male accessories and components
  • fca - Fereldan Castle
  • fce - Fereldan Castle/City Exterior
  • fci - Fereldan Castle Interior
  • fde - Fade
  • fdi - Fereldan Dungeon Interior
  • fhe - Fereldan Human Exterior
  • fhec - ? (used in Redcliffe Village)
  • fhi - Ferelden Human Interior
  • fne - Ferelden noble exterior level pieces
  • frt - Fort (Drakon)
  • fti - Fereldan Town Interior
  • ftr - Fort (Drakon) Roof
  • fve - Fereldan Village Exterior
  • fx - Effects
  • fxa - Ability Effects
  • fxc - Creature Effects
  • fxe - Environmental Effects
  • fxg - Glyph (or Ground?) Effects (eg AOE placement/aim indicators)
  • fxm - Animator cutscene effects
  • fxp - Prop Effects
  • hf - human female accessories and components
  • hm - human male accessories and components
  • hro - Hero Sets
  • kn - Kid (child) related
  • lightrig
  • material
  • nm - ? (just Duncan's body)
  • pf - Female (race-neutral) related
  • plc - placeables
  • pm - Male (race-neutral) related
  • pn - Related to any gender or race
  • prp - props
  • prv - Provings
  • qm - Qunari male related
  • sb - Skybox
  • sca
  • sr - Selection Ring (creature allegiance indicator rings)
  • tce - Tevinter Castle Exterior
  • tci - Tevinter Castle Interior
  • tfi - Tevinter Fade Interior
  • tools - models used by the toolset
  • trn - ? (possibly terrain creation utilities)
  • tti - Tevinter Tower Interior
  • tve - Tevinter Exterior
  • tvi - Tevinter Interior
  • tvm - ? (Tevinter something)
  • ue - Eye morph targets
  • uem - Eyes and eye morph targets
  • uh - Head morph targets
  • uhm - Heads and head morph targets
  • ul - Eyelash morph targets
  • ulm - Eyelashes and eyelash morph targets
  • v
  • vfx - Visual Effects
  • vis - Vista Objects
  • vst - Vista Objects
  • w - weapon models
  • water - waterfall pieces
  • zz - models used in debugging

Voice Over File Naming Convention

[LineID]_m.WAV
  • with [LineID] replaced by the ID number for the conversation line's string table entry.

This accounts for being able to locate thousands of VO lines, when assigning them to their conversation line.

See voice over for more information on how to manage voice over recording.

Animation File Naming Convention

mh.dg_5p_tn_l_45.ANI

The various parts of the animation name gives you information about the type of animation. This for example means "male human dialogue 5 paces turn left 45 degrees."

All humanoid animations prefix with mh. (male human). There is also a small list of fh (female human), These work across all races pretty much.

After the prefix you have the following:

  • 2p - a 2 person animation... usually lined up (i.e. give and receive, punch and punched, kiss and kissed)
  • am - ambient... full animations that so specific actions (i.e. blacksmith, cheering, clean floor)
  • cb - combat animations
  • cu - custom animation, usually for a specific cutscene or purpose
  • dg - dialog... animation fpr the purpose of use within dialogs (although we use all these animations)
  • po - pose based animations - these are specific poses and gestures for talking dialogs
  • wi - world interaction - similar to ambient but more about interacting with world objects (desks, leaning, sitting)

After the above second prefix the rest is usually descriptive (or some what). Key thing to note:

  • en - enter animation... this is the animation that gets the actor doing the animation... usually from a standing neutral position
  • lp - looping animation - this is the animation that loops to keep the actor in a pose or position
  • ex - exit animation - this is the animation that gets the actor out of the lp animation... usually to a standing neutral position
  • tw - twitch, an animation that plays from the lp animation

So, for example:

  • mh.wi_sit_en - animation goes from standing neutral to sitting
  • mh.wi_sit_lp - animation loops in the sitting pose
  • mh.wi_sit_ex - animation goes from sitting to standing neutral
  • mh.wi_sit_tw1 - an animation that plays from sit_lp, such as someone scratching their head

Vegetation (Speedtree) File Naming Convention

tre c oakfixl.SPT

Vegetation is sorted in main categories via Prefix:

  • bsh - Bushes
  • gra - Grass
  • tre - Trees

The last part is a short description of the vegetation type, ie Oak, which is a Oaktree.

See Also