This shows you the differences between two versions of the page.
Both sides previous revisionPrevious revision | |||
modding:automatic_file_mapping_in_pk3 [2017-03-19 20:40] – ↷ Links adapted because of a move operation skyjake | modding:automatic_file_mapping_in_pk3 [2017-03-20 20:21] (current) – ↷ Links adapted because of a move operation skyjake | ||
---|---|---|---|
Line 1: | Line 1: | ||
+ | ====== Automatic file mapping in PK3 ====== | ||
+ | |||
+ | Doomsday' | ||
+ | |||
+ | |||
+ | ===== Automatic relocation by resource class ===== | ||
+ | |||
+ | |||
+ | Files in the root direction of a PK3 are subject to automatic relocation according to the associated [[modding: | ||
+ | |||
+ | Files with the following extensions are automatically mapped to // | ||
+ | |||
+ | * [[: | ||
+ | * [[modding: | ||
+ | * [[:wad]] | ||
+ | * [[:deh]] {{: | ||
+ | |||
+ | [[:ded]] definitions are automatically mapped to // | ||
+ | |||
+ | **Note**: Automatically relocated root files are mapped to the same (virtual) directory appropriate for that class of resource. For example, given two archives " | ||
+ | |||
+ | |||
+ | ===== Shortcut folders (1.9.x) ===== | ||
+ | |||
+ | |||
+ | All files in the following virtual folders of a PK3 (including subfolders) are automatically moved to the correct (virtual) location in the file hierarchy by Doomsday. These shortcuts allow you to greatly simplify the folder structure of your mod/addon. For example instead of the virtual folder // | ||
+ | |||
+ | * flats/ | ||
+ | * fonts/ | ||
+ | * lightmaps/ | ||
+ | * models/ (1.9.7+) | ||
+ | * music/ | ||
+ | * patches/ | ||
+ | * sfx/ (1.9.7+) | ||
+ | * textures/ | ||
+ | |||
+ | |||
+ | ===== Manual " | ||
+ | |||
+ | |||
+ | It is also possible to request the mapping of entire directories manually by adding a special prefix character to the name of a directory in the root of a PK3. | ||
+ | |||
+ | |||
+ | |||
+ | ^ Prefix^ ^ Virtual Directory | | ||
+ | | # (hash)| ⇒| data/ | ||
+ | | @ (at)| ⇒| defs/ | ||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | ==== Examples ==== | ||
+ | |||
+ | |||
+ | |||
+ | Layout of // | ||
+ | |||
+ | ^ PK3 Directory^ ^ Virtual Directory | | ||
+ | | # | ||
+ | | @CoolStuff/ | ||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | ===== Examples ===== | ||
+ | |||
+ | |||
+ | Addon example for a mod for Doom that makes use of the available virtual directory shortcuts to simplify the structure. | ||
+ | |||
+ | * MyCoolLevel.PK3 | ||
+ | * textures/ | ||
+ | * Bigdoor1.png | ||
+ | * Brick1.png | ||
+ | * music/ | ||
+ | * romero.mp3 | ||
+ | * mycoolwad.wad | ||
+ | * myded.ded | ||
+ | |||
+ | |||
+ | ===== See also ===== | ||
+ | |||
+ | * [[: | ||
+ | |||
+ | |||
+ | |||