This is an extension for Vortex to add support for Starfield. This is available for the PC on Xbox & Game Pass and Steam.
The Steam and Xbox versions of Starfield are both supported, although there are differences between the two.
Clone repo and run yarn install
yarn build
will copy assets to the /dist
folder, create the /dist/info.json
from info within /package.json
and pack the contents of /dist
into /out/starfield-x.x.x.zip
yarn copyplugin
will copy contents of /dist
to the plugins folder of the production build of Vortex. Normally located at %APPDATA/Roaming/Vortex/plugins
yarn copyplugindev
will copy contents of /dist
to the plugins folder of the development build of Vortex. Normally located at %APPDATA/Roaming/vortex_devel/plugins
yarn buildcopydev
will build and contents of /dist
to the plugins folder of the development build of Vortex. Normally located at %APPDATA/Roaming/vortex_devel/plugins
Coming Soon
StarfieldCustom.ini
/Data
folders through the use of a folder junction. Defaults to off but is asked to enable with necessary warnings. Please read this page on modding.wiki for more information.This extension requires Vortex 1.9.10 or greater. LOOT sorting functionality requires Vortex 1.12.0 or greater.
To install, click the Vortex button at the top of the Starfield Extension page on Nexus Mods, and then click Install.
You can also manually install it by click the Manual button at the top of the page and dragging it into the drop target labelled Drop File(s) in the Extensions page at the bottom right.
Afterwards, restart Vortex and you can begin installing supported Starfield mods with Vortex.
If you've already got a previous version, the extension should auto update on a Vortex restart.
The Starfield game extension enables Vortex to automatically locate installs from the Steam and Xbox apps.
It is also possible to manually set the game folder if the auto detection doesn't find the correct installation. A valid Starfield game folder contains:
Starfield.exe
If your game lacks this file then it is likely that your installation has become corrupted somehow.
Currently the game discovery will resolve to the game's default WindowsApps
location - Vortex's access to this directory is very limited due to the game store locking the files in a system owned virtual file system. As a workaround, please install the game into an external location, e.g. C:/XboxGames/
and manually set the game folder inside Vortex to the C:XboxGamesStarfieldContent
folder. You should then be able to create the folder junction and mod your game.
By default, Vortex will deploy files to the game's root folder and extracts the archive while preserving the folder structure.
Starfield breaks the Bethesda-game trend by having a secondary data folder at DocumentsMy GamesStarfieldData
which, in most case, overrides the regular Data
folder within the game installation. This has caused quite a bit of confusion in the community with different mods providing instructions to install to the two different folders and a number of community workarounds - some that worked and some less so.
To get around this, Vortex can create a specific type of shortcut (called a folder junction) between the regular Data folder and the one in the My Games folder. This tricks the game engine into using the same Data folder and simplifies mod installation. As an added bonus, this also works for both Steam and Xbox versions. The My Games Data folder is tested on startup and if it isn't a junction already, then the user is notified about potentially enabling this feature along with documentation as to why the user may not want to.
IMPORTANT: Things aren't all perfect though. Using a file syncingcloud drive service such as OneDrive, Google Drive or Dropbox are known to cause issues with this method due to the inconsistencies in how they handle folder junctions. The most severe of these issues can lead to the loss of data. For compatibility information about individual services, please read this page on modding.wiki for more information.
Similar to Fallout 4, Starfield requires certain INI tweaks to be set in order to properly load loose files (i.e. those not packed in BA2 archives). There are a lot of mods out there which provide instructions for users to add these tweaks to a StarfieldCustom.ini
file in the DocumentsMy GamesStarfield
folder. If Vortex detects that this ini doesn't exist or is incorrect, it will notify the user and ask to fix it. If fix is requested, it will add or adjust the "bInvalidateOlderFiles" and "sResourceDataDirsFinal" values without changing any other settings you might've added manually.
Additionally, Vortex will apply a tweak to re-route your Photo Mode captures to DataTexturesPhotos (unless you've already set it to something else) and there is now a button inside Vortex to quickly open this folder. This was removed in version 0.6.7
of the extension due to a bug in Starfield that was introduced when the game updated to approximately version 1.10.31.0
.
A basic Save Games page has been added to allow users to view information regarding their save games. This functionality is unfortunately not available for Xbox game pass users as the saves themselves are inaccessible by default. Vortex will attempt to parse any existing saves within the "Documents/My Games/Starfield/Saves" directory and display information such as Character name, level, experience and more importantly, the plugins that have been loaded to the save game.
The current implementation allows the user to select between two different plugin management methodologies. By default the Starfield extension is configured to use the Drag and Drop functionality which has been available in previous versions of the extension, with an added "Sort via LOOT" button in the Load Order page for users of Vortex 1.12.x or greater.
Alternatively it is possible to switch to a completely automated sorting functionality controlled by LOOT; similar to the plugin management system available for other Bethesda games.
To switch between the two systems, the user needs to go to the Settings Page -> Mods Tab and choose between the Drag and Drop or Automated sorting functionalities.
The current implementation of the plugin management system in Starfield is temporary while we wait for the official creation kit from Bethesda. This means that we expect certain functionality to change in the future, yet we're confident enough to provide interim support. The plugin management systen in Starfield has been enabled as of 9th of June 2024; plugin enablers are no longer required.
A new "Load Order" page has been added to the extension to allow users to view their deployed mods and manage their load order. By default this system is disabled and can only be enabled through the Load Order page. The user can disable this feature at any time through the Settings -> Mods -> Starfield -> Manage Load Order Toggle.
Before enabling the plugin management system keep the following in mind:
Updating from Vortex 1.11.7 to 1.12.x beta while having Starfield 0.8.5 installed may present UI glitches upon Vortex re-launch (missing management type dropdown button, plugin enabler still being mentioned on the load order page) - please restart Vortex if you are affected - this should only happen one time after Vortex update.
Save Games functionality is not available for Xbox game pass users.
ASI Loader is outdated - disable the relevant script loader/extender to ensure your game does not crash.
This extension has been tested with all of the most popular mods, installers, script extenders, mod fixers etc. Please see this Mod Compatibility List forum post for details.
Symlink support has been disabled due inconsistencies with some files working and some not. Animation replacers don’t read symlinked, but textures seem ok. This does match the pattern of older Bethesda games which looked for a while like we could avoid.
Mods that include ini entries to be added won't fully work as functionality for ini merging isn't added yet. Deployment will work fine, but the ini (normally the StarfieldCustom.ini
) will need to be updated manually. Please see a mod's description for individual installation instructions.
Starfield Script Extender (SFSE) is Steam version only and currently does not work with the Xbox Game Pass version
PureDark's StarfieldUpscaler is manual install only, this is a good guide to follow.
Mods needing ASI loading will require manual installation due to the complexities. Please see a mod's description for individual installation instructions.
Mods installed with version 0.4 of this extension may have missing files due to a flaw in the default installer. Please re-install your mods using 0.5 to ensure your mods are installed correctly. (Any missing archives will have to be re-downloaded manually)
Fomods installed with 0.4 (selecting the "Vortex" flag) will no longer deploy correctly. 0.5 has a test in place to detect these mods and will notify you if any are found; providing you with the ability to fix the installed fomod. Mod authors are no longer required to provide separate Vortex/MO2 destinations for their mod files!
Migrating this extension from version 0.4 to 0.5 may fail if for any reason the files are being actively manipulated by other tools or the game itself. Please make sure to close any such tools (or the game) before migrating to 0.5
Modding Starfield's Xbox game pass version does not allow folder junctions when used with the default WindowsAppsStarfield
folder. Please ensure to install Starfield to an external location e.g. C:XboxGames
Vortex will try to resolve custom game pass locations using the hidden .GamingRoot files which
the game pass store creates. Alternatively, the location of the game can be set manually. Go to Games tab and find Starfield -> 3 dots top right of the game's thumbnail -> manually select location -> choose the game folder that contains Starfield.exe
Mod management isn't an exact science so please report any mods that don't install correctly so we can continue to increase our compatibility and coverage
The default installer in 0.4 has been deprecated in 0.5 due to:
What to expect:
Recommendations:
Given the changes in 0.5, migration functionality has been introduced to ensure we support collections created before this update. Upon successful installation of a collection, all mods tied to said collection are checked and migrated automatically to use the new system on the user's environment.
What to expect:
Recommendations:
Vortex 0.6.x load ordering functionality is using INI merging for global datasets defined in ASI mods. At the time of writing this addendum, the deepMerge utility function was not exported as part of the API. In order to allow users to test this extension without waiting for Vortex 1.9.9+, the extension has an identical copy of the deepMerge function included - this should be removed once we confirm 1.9.9+ is stable.
Please check out CHANGELOG.md