by rux616
Version: 1.10.0
(A framework allowing mod authors to easily add ships for sale without conflicts.)
The system that Bethesda designed for selling ships is interesting, but it lacks a crucial element: Changeability. In vanilla Starfield, once a ship vendor has been loaded the first time, the list of ships they offer for sale is locked in forever until starting a new game (or new game plus).
That's where this mod comes in. I've designed a system such that mod authors can easily add ships for sale to the various ship vendors without either conflicting with other mods that do the same or requiring the set up of a script. It will also refresh the vendor's list of ships if a change is detected in the vendor's "always" or "unique" lists. (A ship vendor's inventory is composed of three lists: always a.k.a. priority, random, and unique.)
As with Ship Builder Categories, this mod is intended to be a community resource and so will always have manual donations disabled and remain opted out of the Nexus Mods Donation Point system.
NOTE: Vendors refresh their ship inventory every 7 days by default.
(TOC)
Mod authors, want to use the framework? It's easy, and you can do it in just three steps with the Starfield Creation Kit:
- Design your ship.
- Add your ship to a leveled base form.
- Put that leveled base form into a form list and set one of the form lists included with this mod (SVF_ShipVendorList_*) as the target in the "add to list" box.
More detailed instructions, including for making your own SVF-enhanced ship vendors, are included in the HOWTO.txt document, and in the "How to Utilize the Ship Vendor Framework" article on Nexus Mods.
(TOC)
This mod alters most of the leveled lists for spaceships that vendors use to add proper level gates, as well as the CF_Post dialogue [QUST:00143472] and CF_Post_Toft_TL_ShipServices scene [SCEN:001F88DD] to allow for Lt. Jillian Toft to function as a ship vendor once the Crimson Fleet quest line concludes. Any other mods that also alter those records may conflict without patches.
Additionally, this mod alters 4 vanilla scripts, "OutpostShipbuilderMenuActivator", "ShipBuilderMenuActivator", "ShipVendorInfoScript", and "ShipVendorScript". As a result, a mod that alters any of those scripts will conflict by definition. This also means that when the game is updated, script changes by Bethesda will not be present in this mod until it is updated.
Mods that are known to conflict:
- "DarkStar" by WykkydGaming [Creations]: No patch. There are no lists for mod authors to add ships to, the "Rich Ship Vendors" option doesn't work with the DarkStar ship vendors, and not all ships may be immediately available to purchase if the "buy ships" option is accessed too soon after the vendor's ship inventory is refreshed or the vendor is initially created.
- "Rich Outpost Shipbuilder" by LilithMotherOfAll [Nexus]: No patch. Uninstall this mod if you have it. Ship Vendor Framework now has this functionality built in.
- "Starvival" by lKocMoHaBTl [Creations / Nexus]: Use SVF Compatibility Patch - Starvival.
Mods that I have created capability patches for (included in the main download):
- "DarkStar Astrodynamics" by WykkydGaming [Creations / Nexus]
- "Dominion" by rhart317 [Creations]
- "Falkland Systems Ship Services" by Hjalmere [Creations]
- "Iconic Ships" by ShipTechnician [Creations]
- "L-K Ships" by Lighthorse and KeithVSmith1977 [Creations / Nexus]
- "Lower Landing Pad" by SenterPat [Nexus]
- "Outpost Vendor New Ships" by nefurun [Creations]
- "SGC Deadalus & Battlestar added to New Atlantis & Outpost Ship Vendor" by Rechi03 [Creations]
- "The Den Astrodynamics" by VoodooChild [Nexus]
- "Watchtower" by kinggath_creations [Creations]
(TOC)
None
(TOC)
NOTE: This section only applies to PC users.
In your StarfieldCustom.ini file, make sure you have the following section:
[Papyrus]
bEnableLogging=1
bEnableProfiling=1
bEnableTrace=1
bLoadDebugInformation=1
This will ensure that the game writes logs. If I request them in order to help you, I will be looking for "Papyrus.X.log" in the "%UserProfile%\Documents\My Games\Starfield\Logs" directory, and "ShipVendorFramework.X.log" in the "%UserProfile%\Documents\My Games\Starfield\Logs\Script\User" directory, where "X" represents a number 0-3.
(TOC)
NOTE: All form list editor IDs start with SVF_ShipVendorList_. This prefix has been removed from the lists as presented in the following tables for the sake of brevity.
Vanilla:
Shattered Space (with patch):
DarkStar Astrodynamics (with patch):
Falkland Systems Ship Services (with patch):
Watchtower (with patch):
(TOC)
For best results, I would recommend keeping this mod and all its patches in a single block, all following any other mods that are being patched.
For patches, the load order should be as follows:
- ShipVendorFramework.esm
- (SVF Expansion Patches, if any)
- (SVF Capability Patches, if any)
- (SVF Compatibility Patches, if any)
(TOC)
- Must have the Free Lanes update (Starfield v1.16.236+)
(TOC)
None
(TOC)
When upgrading non-major versions (for example v2.something to v2.something-else), you don't need to do anything except replace the installed mod files.
When upgrading major versions (for example v1.whatever to v2.whatever), you need to do a clean install:
- Open the game and load your latest save
- Save your game, then quit
- Uninstall the previous version of the plugin and all its files
- Open the game and load your last save
- You will see a warning about missing the plugin you just uninstalled, choose to continue
- Save your game again, then quit
- Install the new version of the plugin
(TOC)
The v1.6.0 update of Ship Vendor Framework gets rid of the following ESM files, as they are obsolete and no longer needed:
- SVF-Generic-AllShipModulesUnlocked-AllShipVendors-Patch.esm
- SVF-Generic-AllShipModulesUnlocked-AllShipVendors-ShatteredSpace-Patch.esm
- SVF-Generic-AllShipModulesUnlocked-OutpostOnly-Patch.esm
- SVF-Generic-ShipVendors-Patch.esm
- SVF-Generic-ShipVendors-ShatteredSpace-Patch.esm
- SVF-LowerLandingPadUnlocked-Patch.esm
If you were using them, you should be able to safely ignore the "missing mod files" message when you load up your game for the first time after installing the new version (for the Lower Landing Pad patch, use the other one). That being said, you should back up your save anyway, just in case.
(TOC)
NOTE: Support for Nexus Mod Manager (NMM) will NOT be provided as its FOMOD implementation is broken. Use either Mod Organizer 2 or Vortex.
Download and install the archive with either Mod Organizer 2 (version 2.5.2 or later) or Vortex. I personally recommend Mod Organizer 2 (with the optional Root Builder plugin to use with SFSE or any other mod that requires files be put directly in the game's installation folder).
(TOC)
Unsupported. I want nothing to do with your hand-crafted artisanal potential dumpster fire of an install.
(TOC)
- All code files are copyright Dan Cassidy (see individual files for exact years), and are licensed under the GPL v3.0 or later. The sole exceptions to this are the "OutpostShipbuilderMenuActivator", "ShipBuilderMenuActivator", "ShipVendorInfoScript", and "ShipVendorScript" files, as they are built upon the base that BGS provided and so are covered by their licenses.
- All non-code files are copyright 2024, 2025 Dan Cassidy, and are licensed under the CC BY-NC-SA 4.0 license.
(TOC)
Bethesda Game Studios: For Starfield itself and the Starfield Creation Kit ElminsterAU: For xEdit and BSArch Lively: For helping explain some of the odd nuances of an infrequently-used-by-me FOMOD feature Mod Organizer 2 team: For Mod Organizer 2 Nexus Mods: For mod hosting and for the Vortex Mod Manager Noggog: For Spriggit perchik71: For Creation Kit Platform Extended Scrivener07: For some advice and clarification on papyrus matters
(TOC)
If you find a bug or have a question about the mod, please post it on the mod page at Nexus Mods, the GitHub project, or on Reddit in r/StarfieldMods (make sure to tag me: u/rux616).
If you need to contact me personally, I can be reached through one of the following means:
- Nexus Mods: rux616 (Click the "Message" button.)
- Email: rux616-at-pm-dot-me (replace
-at-with@and-dot-with.) - Reddit: u/rux616
- Discord: rux616 (user ID 234489279991119873) - make sure to "@" me
- Lively's Modding Hub
- Nexus Mods
- Collective Modding ("🔧-chaotic-cognitions" channel)
- Starfield - Ship Distribution
- Starfield Modding
(TOC)