This shows you the differences between two versions of the page.
| Both sides previous revisionPrevious revisionNext revision | Previous revision | ||
| tutorial:basics [2025/02/24 18:34] – admin | tutorial:basics [2026/05/25 23:19] (current) – added more notes about AI jenovavirus | ||
|---|---|---|---|
| Line 1: | Line 1: | ||
| + | ====== Basics ====== | ||
| + | Authors: JeNoVaViRuS | ||
| + | |||
| + | ===== Preamble ===== | ||
| Before you try to start with any tutorials on modding you should read this. | Before you try to start with any tutorials on modding you should read this. | ||
| Line 13: | Line 17: | ||
| No matter which tools you use to modify content it will only take effect if you: | No matter which tools you use to modify content it will only take effect if you: | ||
| - | - are using ModEngine | + | - are using ModEngine, ModEngine2 |
| - | - selected " | + | - selected " |
| It is recommended to use ModEngine but older titles like DS1 are not supported. You can only use the second option. | It is recommended to use ModEngine but older titles like DS1 are not supported. You can only use the second option. | ||
| Line 32: | Line 36: | ||
| ===== Backup your save files ===== | ===== Backup your save files ===== | ||
| - | If you have existing save files then you need to make a backup of them. | + | If you have existing save files then you need to make a backup of them. Never, ever, go online with a save that was used with a mod. \\ |
| - | Never, ever, go online with a save that was used with a mod. | + | |
| After you have played the game with a mod you need to delete or rename your current save files and restore your old save files. | After you have played the game with a mod you need to delete or rename your current save files and restore your old save files. | ||
| Line 57: | Line 60: | ||
| Adding files: | Adding files: | ||
| - | - If you not just edit but add files to the unpacked folders then you also need to edit the " | + | - If you not just edit but add files to the unpacked folders then you also need to edit the " |
| - | - You need to look for the entries of a specific file type that already existed e.g. from the unpacked " | + | - You need to look for the entries of a specific file type that already existed e.g. from the unpacked " |
| - Then duplicate the last entry of the same file extensions | - Then duplicate the last entry of the same file extensions | ||
| - Then edit the ID to be the next consecutive number | - Then edit the ID to be the next consecutive number | ||
| Line 66: | Line 69: | ||
| ===== Game parts ===== | ===== Game parts ===== | ||
| ==== AI ==== | ==== AI ==== | ||
| - | All enemies and NPCs have an AI. The .luabnd | + | All enemies and NPCs have an AI that determines when an enemy takes which action. \\ |
| + | DS1: The .lua bnd files are in the " | ||
| + | DS3+: The .hks files are in the " | ||
| + | ER: " | ||
| + | |||
| + | The .hks files can be manually decompiled with a tool as well. After that you can just use the decompiled version for the game as it will work just fine. \\ | ||
| ==== Characters ==== | ==== Characters ==== | ||
| - | Characters are all entities (enemies and NPCs) with an AI. The player is c0000. | + | Characters are all entities (enemies and NPCs) with an AI. The player is c0000. |
| The character files are in the " | The character files are in the " | ||
| - | The players animation file " | + | The players animation file " |
| - | Additional files contain taes for other ranges e.g. " | + | Additional files contain taes for other ranges e.g. " |
| Other files e.g. " | Other files e.g. " | ||
| ==== Models and Textures ==== | ==== Models and Textures ==== | ||
| - | Body, weapon and armor files are in the " | + | Body, weapon and armor files of the player |
| All files have a prefix and indicate the type of model: | All files have a prefix and indicate the type of model: | ||
| - | fc: bald head (DS1), naked body (DS3+) | + | * fc: bald head (DS1), naked body (DS3+) |
| - | fg: face | + | |
| - | hr: hair | + | |
| - | hd: head armor | + | |
| - | bd: body armor | + | |
| - | lg: leg armor | + | |
| - | am: arm armor | + | |
| - | wp: weapon | + | |
| - | All body files have " | + | All body files have " |
| The suffix " | The suffix " | ||
| - | The ID is used to select the model from the folder (referenced in the params of the games with the field " | ||
| In DS1 the player model gets assembled with armor parts (include body parts) + configured face + bald head. This means equipping an armor piece will always replace the body part. Masks are used to avoid clipping between armor parts. | In DS1 the player model gets assembled with armor parts (include body parts) + configured face + bald head. This means equipping an armor piece will always replace the body part. Masks are used to avoid clipping between armor parts. | ||
| The suffix " | The suffix " | ||
| - | In DS3+ the player model gets assembled with armor parts + configured face + naked body parts. | + | In DS3+ the player model gets assembled with armor parts + configured face + naked body parts. Masks on armor parts are used to make the body part disappear if needed. |
| - | Masks on armor parts are used to make the body part disappear if needed. | + | |
| + | Texture files are in a .tpf format (packed and contain .dds files) and models are in a .flver format. | ||
| ==== HUD / Icons / Menu ==== | ==== HUD / Icons / Menu ==== | ||
| - | The HUD elements and icons are in the " | + | The HUD elements and icons are in the " |
| + | The " | ||
| + | In ER the goods param holds the IconID for the " | ||
| + | The " | ||
| ==== Language / Text ==== | ==== Language / Text ==== | ||
| - | The language files are in the " | + | The language files are in the " |
| + | |||
| + | ==== Maps [WIP] ==== | ||
| + | All files regarding maps are in the " | ||
| + | |||
| + | MSB: These are map metadata files. They hold the information what entity type (e.g. navmesh, object etc.) is located where (region, coordinates, | ||
| + | Navmesh: They are " | ||
| + | Objects/ | ||
| + | AETs: They are texture types used since ER and can be used for any map or object in the game directly. Textures are normally " | ||
| + | |||
| + | |||
| + | ==== States ==== | ||
| + | The player character and also npcs/ | ||
| + | |||
| + | A state can only change under certain preconditions and can only switch to other specific states. | ||
| + | The several games have different systems to handle states (and respective files): \\ | ||
| + | DS1: ESD (chr/ | ||
| + | DS2: EMEVD () \\ | ||
| + | DS3/BB/ER: HKS (action/ | ||
| + | |||
| + | |||
| + | Using " | ||
| + | HKS is normally compiled Lua (a script language) but they were decompiled by modders and can be downloaded from the tools page. They can be edited and then used just like that instead of the original files and the games will load them fine. The beh (behaviour) files can be converted with hkxpack-souls. \\ | ||
| ==== Scripts / Emevd ==== | ==== Scripts / Emevd ==== | ||
| - | If someone uses those words they are referring to the files in the " | + | If someone uses those words they are referring to the files in the " |
| - | The player always has the ID 10000 which is used in the scripts. | + | The player always has the ID 10000 which is used in the scripts. |
| - | Events are typically edited with DarkScript 3 (or esdlang | + | Events are typically edited with DarkScript 3 (or esdlang/ |
| ==== SFX / VFX / FFX / FXR ==== | ==== SFX / VFX / FFX / FXR ==== | ||
| - | Those are visual effects like magic, bonfires, sword sparks, walking on certain areas effects like mud etc. | + | Those are visual effects like magic, bonfires, sword sparks, walking on certain areas effects like mud etc. The sounds that are heard at the same time belong to them. \\ |
| - | The sounds that are heard at the same time belong to them. | + | The files are packed within the " |
| - | The files are packed within the " | + | |
| - | SFX is the term for visual effects in FromSoftware games. | + | The sfx files are in the " |
| - | VFX is normally used for visual effects but in FromSoftware games it refers to the SpEffectVfxParam category. | + | The respective resource BNDs hold the textures and models used by the effects. \\ |
| - | FFX is the file extension for unpacked SFX files in DS1 and 2. | + | |
| - | FXR is the file extension for unpacked SFX files in DS3, Sekiro, ER, and AC6. | + | SFX is the term for visual effects in FromSoftware games. |
| + | VFX is normally used for visual effects | ||
| + | FFX is the file extension for unpacked SFX files in DS1. \\ | ||
| + | FXR is the file extension for unpacked SFX files in DS3, Sekiro, ER, and AC6. \\ | ||
| ==== Sound ==== | ==== Sound ==== | ||
| - | Anything from sound effects (SE) to voice lines to background music (BGM). | + | Anything from sound effects (SE) to voice lines to background music (BGM). |
| These files are typically found in the " | These files are typically found in the " | ||
| ==== Talk ==== | ==== Talk ==== | ||
| - | Talk scripts are used by NPCs or some objects (using invisible NPCs). They start working when the player enters a 5m radius around them and are map based only. They are in the " | + | Talk scripts are used by NPCs or some objects (using invisible NPCs). They start working when the player enters a 5m radius around them and are map based only. \\ |
| - | They can either | + | They are in the " |