The Vortex extension for Hogwarts Legacy includes logic to install multiple different types of mod. To help ensure your mod installs correctly, you should make sure the archive is structured as expected.
Regular asset replacer mods that consist of a .pak file will be installed to the ~mods folder in a load-order controlled subfolder.
✅ Supported Examples
Single PAK file
MyMod.pak
PAK with UCAS and UTOC files
MyMod.pak
MyMod.ucas
MyMod.utoc
Nested folders
Phoenix\Content\Paks\~mods\MyMod.pak
Phoenix\Content\Paks\~mods\MyMod.ucas
Phoenix\Content\Paks\~mods\MyMod.utoc
In order for Vortex to tell the different between an Asset Replacer .pak mod and a UE4SS Blueprint mod, a marker file must be included in the archive. Without this marker file, the mod will be treated as an Asset Replacer and may not be deployed to the correct location. Marker files can be blank text files but they must include one of the following names:
ue4sslogicmod.info.ue4sslogicmod.logicmod✅ Supported Examples
Single PAK file with marker
MyMod.pak
.logicmod
PAK with marker, UCAS and UTOC files
MyMod.pak
MyMod.ucas
MyMod.utoc
.ue4sslogicmod
Nested folders with marker file
Phoenix\Content\Paks\LogicMods\MyMod.pak
Phoenix\Content\Paks\LogicMods\MyMod.ucas
Phoenix\Content\Paks\LogicMods\MyMod.utoc
Phoenix\Content\Paks\LogicMods\ue4sslogicmod.info
❌ Unsupported Examples
No marker files
MyMod.pak
Blueprint mods that require Apparate will be treated as Asset Replacer mods.
Lua mods should contain a parent folder with the mod name, and a scripts subfolder containing the Lua files. These files will be automatically mapped to the correct folder when installed by Vortex.
✅ Supported Examples
Nested folders
Phoenix\Binaries\Win64\Mods\Some Mod Folder\scripts\main.lua
Phoenix\Binaries\Win64\Mods\Some Mod Folder\scripts\other.lua
Mod folders only
Some Mod Folder\scripts\main.lua
Some Mod Folder\scripts\other.lua
Some Mod Folder\some other file.txt
❌ Unsupported Examples
Loose Lua script
main.lua
No scripts folder
Some Mod Folder\notascriptsfolder\main.lua
Movie replacers change the .BK2 files that shipped with the game. They should be packed relative to the game folder and/or be named for the movie file they are intended to replace.
Some of the types of mod above can be combined, the table below shows the result of various combinations. If the combination won't work, you should split up to parts of your mod into separate downloads on your mod page.
| Asset Replacer | UE4SS Blueprint | Apparate Blueprint | Lua Mod | Movie Replacer | |
|---|---|---|---|---|---|
| Asset Replacer | n/a | ❌ | ❌ | ❌ | ✅ |
| UE4SS Blueprint | ❌ | n/a | ❌ | ✅ | ❌ |
| Apparate Blueprint | ❌ | ❌ | n/a | ❌ | ❌ |
| Lua Mod | ❌ | ✅ | ❌ | n/a | ❌ |
| Movie Replacer | ✅ | ❌ | ❌ | ❌ | n/a |