User Tools

Site Tools


fs:lump_assembly

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
fs:lump_assembly [2018-10-19 11:39] โ€“ [See also] skyjakefs:lump_assembly [2018-10-19 11:40] (current) โ€“ skyjake
Line 1: Line 1:
 +====== Lump assembly ======
 +
 +
 +As the name implies, a //lump assembly// is an assortment of [[lump]]s arranged into an assembly (inside a folder). It is also possible to include a hierarchy of folders inside a Lump Assembly (therefore puting [[lump]]s into "namespaces" where they can have a load order implied; see below). It is even possible to nest [[wad]]s inside an assembly.
 +
 +The [[modding:auto_folders|automatic loading of data files]] can be utilised to load
 +directories that contain individual [[data_lump]]s.  This kind of a
 +directory is called a "lump assembly" and it can be used instead of a
 +[[wad]] file.  Note that a lump assembly can only be loaded via the
 +[[autoload]] mechanism (but it can be inside a [[pk3]] that is loaded
 +manually).
 +
 +So what does that mean? In a nutshell: any folder's contents can be treated as a [[wad]] (this includes other [[doomsday]] [[wad]] features such as [[dd_direc]]) provided it is loaded by the auto loader.
 +
 +The assembly can be built using a hierarchy of directories.  For
 +example the contents of a [[pk3]] might be:
 +  
 +  #assembly/
 +     data1.lmp
 +     data2.lmp
 +     powerplant.2/
 +        a-E2M3.lmp
 +        b-THINGS.lmp
 +     xyz.lmp
 +
 +
 +**#assembly** would be mapped to **Data\<Game>\Auto\assembly\**.
 +
 +
 +===== Lump loading order =====
 +
 +
 +By default, the contents of a lump assembly are loaded in alphabetical
 +order.  However, some kinds of data require that the lumps are in a
 +specific order (for instance map data).  You have two options if you
 +want to enforce a specific order:
 +
 +
 +  * You can put a [[wad]] inside the assembly.
 +  * You can use //name prefixes// that are used to sort the lumps but are ignored when the [[lump_name]]s are determined.  The length of the prefix can be 1โ€“9 characters long.  You specify the length of the prefix by adding an extension to the name of the directory that contains the lumps.  An example that uses a prefix with 3 characters:
 +<code>
 +Data\Game\Auto\DirWithPrefix.3\01_LUMPNAME.lmp
 +</code>
 +The first three characters of the file name are ignored ("01_") and **LUMPNAME** becomes the name of the lump. 
 +
 +
 +
 +
 +===== Assembly loading order =====
 +
 +
 +The order in which assemblies are loaded is governed by the [[autoload]] mechanism. In short, all folders and files inside the Auto folder are loaded in alphabetical order. Note that this means that it makes no difference in which order the files containing the assemblies were loaded.
 +
 +
 +===== See also =====
 +
 +  *  [[modding:automatic_file_mapping_in_pk3]]
 +
 +
 +
 +
  
fs/lump_assembly.txt ยท Last modified: 2018-10-19 11:40 by skyjake