0 of 0
About this mod
A framework allowing mod authors to easily add ships for sale without conflicts.
- Requirements
- Permissions and credits
-
Translations
- Spanish
- Russian
- German
- Mirrors
- Changelogs
Ship Vendor Framework
by rux616
Version: 1.3.1
Table Of Contents:
- Ship Vendor Framework
- Table Of Contents
- Overview
- Summary
- How To (Lite)
- Compatibility
- Known Issues
- NPC Ship Lists
- Installation
- Load Order
- Requirements
- Recommendations
- Upgrading
- Mod Manager
- Manual
- License
- Credits and Acknowledgements
- Contact
Overview
Summary:
(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 Donation Point system.
NOTE: The "random" ships are only regenerated every 7 days (by default).
How To (Lite):
Mod authors, want to use the framework? It's easy, and you can do it in just three steps:
1. Design your ship.
2. Add your ship to a leveled base form.
3. 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 are included in the HOWTO.txt document, and in the "How to Utilize the Ship Vendor Framework" article on Nexus Mods.
Compatibility:
This mod alters NPCs that offer ship services, as well as some of the leveled lists for spaceships that vendors use. Any other mods that also alter those objects may conflict without patches.
Additionally, this mod alters 2 vanilla scripts, "ShipVendorScript" and "OutpostShipbuilderMenuActivator". As a result, any other mod that alters either of (or both) those scripts by definition will conflict. 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:
- "SGC Deadalus & Battlestar added to New Atlantis & Outpost Ship Vendor" by Rechi03 [Creations]: Use SVF Capability Patch - Daedalus and Battlestar and one of the SVF Generic Patches that fits what you need.
- "Dominion" by rhart317 [Creations]: Use SVF Capability Patch - Dominion.
- "Iconic Ships" by ShipTechnician [Creations]: Use SVF Capability Patch - Iconic Ships, and one of the SVF Generic Patches that fits what you need.
- "L-K Ships" by Lighthorse and KeithVSmith1977 [Creations / Nexus]: Use SVF Capability Patch - L-K Ships.
- "Lower Landing Pad" by SenterPat [Nexus]: Use one of the "Lower Landing Pad" SVF Capability Patches.
- "Outpost Vendor New Ships" by nefurun [Creations]: Use SVF Capability Patch - Outpost Vendor New Ships, and one of the SVF Generic Patches that fits what you need.
- "Outpost Shipbuilder Unlocked ESM" by goldenchrome [Nexus]: Use SVF Generic Patch - All Ship Modules Unlocked (Outpost Only).
- "Rich Outpost Shipbuilder" by LilithMotherOfAll [Nexus]: No patch. If you loaded a save at an outpost after installing SVF, go to another world (one of the big cities is best), then back to your outpost.
- "Starvival" by lKocMoHaBTl [Creations / Nexus]: Use SVF Compatibility Patch - Starvival.
- "The Den Astrodynamics" by VoodooChild [Nexus]: Use SVF Compatibility Patch - The Den Astrodynamics.
- "Ultimate Shipyards Unlocked" by JustAnOrdinaryGuy [Nexus]: Use one of the "All Ship Modules Unlocked" SVF Generic Patches.
Known Issues:
None
NPC Ship Lists:
Note: All form list editor IDs start with "SVF_ShipVendorList_". This prefix has been removed from the lists as presented in the following table for the sake of brevity.
Installation
Load Order:
For best results, put this mod last in your load order, followed by other mods that have it as a master.
For patches, the load order should be as follows:
- ShipVendorFramework.esm
- (SVF Capability Patches, if any)
- (SVF Generic Patches, if any)
- (SVF Compatibility Patches, if any)
Requirements:
None
Recommendations:
None
Upgrading:
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
Mod Manager:
Download and install the archive with either Mod Organizer 2 (version 2.5.0 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).
Manual:
Unsupported. I want nothing to do with your hand-crafted artisanal potential dumpster fire of an install.
License
- All code files are copyright 2024 Dan Cassidy, and are licensed under the GPL v3.0 or later. The sole exceptions to this are the "ShipVendorScript.psc" and "OutpostShipbuilderMenuActivator.psc" 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 Dan Cassidy, and are licensed under the CC BY-NC-SA 4.0 license.
Credits and Acknowledgements
ElminsterAU: For xEdit and BSArch
Mod Organizer 2 team: For Mod Organizer 2
Nexus Mods: For mod hosting and for the Vortex Mod Manager
Noggog: For Spriggit
Scrivener07: For some advice and clarification on papyrus matters
Contact
If you find a bug or have a question about the mod, please post it on the mod page at Nexus Mods, or in the GitHub project.
If you need to contact me personally, I can be reached through one of the following means:
- Nexus Mods: rux616 (Send a message via the "CONTACT" button.)
- Email: rux616-at-pm-dot-me (replace -at- with @ and -dot- with .)
- 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
by rux616
Version: 1.3.1
Table Of Contents:
- Ship Vendor Framework
- Table Of Contents
- Overview
- Summary
- How To (Lite)
- Compatibility
- Known Issues
- NPC Ship Lists
- Installation
- Load Order
- Requirements
- Recommendations
- Upgrading
- Mod Manager
- Manual
- License
- Credits and Acknowledgements
- Contact
Overview
Summary:
(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 Donation Point system.
NOTE: The "random" ships are only regenerated every 7 days (by default).
How To (Lite):
Mod authors, want to use the framework? It's easy, and you can do it in just three steps:
1. Design your ship.
2. Add your ship to a leveled base form.
3. 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 are included in the HOWTO.txt document, and in the "How to Utilize the Ship Vendor Framework" article on Nexus Mods.
Compatibility:
This mod alters NPCs that offer ship services, as well as some of the leveled lists for spaceships that vendors use. Any other mods that also alter those objects may conflict without patches.
Additionally, this mod alters 2 vanilla scripts, "ShipVendorScript" and "OutpostShipbuilderMenuActivator". As a result, any other mod that alters either of (or both) those scripts by definition will conflict. 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:
- "SGC Deadalus & Battlestar added to New Atlantis & Outpost Ship Vendor" by Rechi03 [Creations]: Use SVF Capability Patch - Daedalus and Battlestar and one of the SVF Generic Patches that fits what you need.
- "Dominion" by rhart317 [Creations]: Use SVF Capability Patch - Dominion.
- "Iconic Ships" by ShipTechnician [Creations]: Use SVF Capability Patch - Iconic Ships, and one of the SVF Generic Patches that fits what you need.
- "L-K Ships" by Lighthorse and KeithVSmith1977 [Creations / Nexus]: Use SVF Capability Patch - L-K Ships.
- "Lower Landing Pad" by SenterPat [Nexus]: Use one of the "Lower Landing Pad" SVF Capability Patches.
- "Outpost Vendor New Ships" by nefurun [Creations]: Use SVF Capability Patch - Outpost Vendor New Ships, and one of the SVF Generic Patches that fits what you need.
- "Outpost Shipbuilder Unlocked ESM" by goldenchrome [Nexus]: Use SVF Generic Patch - All Ship Modules Unlocked (Outpost Only).
- "Rich Outpost Shipbuilder" by LilithMotherOfAll [Nexus]: No patch. If you loaded a save at an outpost after installing SVF, go to another world (one of the big cities is best), then back to your outpost.
- "Starvival" by lKocMoHaBTl [Creations / Nexus]: Use SVF Compatibility Patch - Starvival.
- "The Den Astrodynamics" by VoodooChild [Nexus]: Use SVF Compatibility Patch - The Den Astrodynamics.
- "Ultimate Shipyards Unlocked" by JustAnOrdinaryGuy [Nexus]: Use one of the "All Ship Modules Unlocked" SVF Generic Patches.
Known Issues:
None
NPC Ship Lists:
Note: All form list editor IDs start with "SVF_ShipVendorList_". This prefix has been removed from the lists as presented in the following table for the sake of brevity.
Installation
Load Order:
For best results, put this mod last in your load order, followed by other mods that have it as a master.
For patches, the load order should be as follows:
- ShipVendorFramework.esm
- (SVF Capability Patches, if any)
- (SVF Generic Patches, if any)
- (SVF Compatibility Patches, if any)
Requirements:
None
Recommendations:
None
Upgrading:
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
Mod Manager:
Download and install the archive with either Mod Organizer 2 (version 2.5.0 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).
Manual:
Unsupported. I want nothing to do with your hand-crafted artisanal potential dumpster fire of an install.
License
- All code files are copyright 2024 Dan Cassidy, and are licensed under the GPL v3.0 or later. The sole exceptions to this are the "ShipVendorScript.psc" and "OutpostShipbuilderMenuActivator.psc" 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 Dan Cassidy, and are licensed under the CC BY-NC-SA 4.0 license.
Credits and Acknowledgements
ElminsterAU: For xEdit and BSArch
Mod Organizer 2 team: For Mod Organizer 2
Nexus Mods: For mod hosting and for the Vortex Mod Manager
Noggog: For Spriggit
Scrivener07: For some advice and clarification on papyrus matters
Contact
If you find a bug or have a question about the mod, please post it on the mod page at Nexus Mods, or in the GitHub project.
If you need to contact me personally, I can be reached through one of the following means:
- Nexus Mods: rux616 (Send a message via the "CONTACT" button.)
- Email: rux616-at-pm-dot-me (replace -at- with @ and -dot- with .)
- 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