Version Manager

Overview

Version Manager is a lightweight Papyrus-based system designed to help modders manage script updates in Starfield without requiring users to start a new save. It allows quest scripts to detect version changes and automatically restart, ensuring that new script logic is applied seamlessly.

This system was originally created for my own A. C. T., MORPH, and MORPH Effects mods to ensure they could update cleanly without forcing users to restart their game or manually stop and restart quests. However, it can be used for any mod that needs an easy way to manage script updates.

• []Your quest script registers itself with Version Manager using RequestVersionManagement during OnQuestInit and OnPlayerLoadGame.

  []Version Manager checks if the version has changed:

  []If unchanged, nothing happens.

  []If changed, the quest stops and restarts to apply the latest script logic.

  []This means your quest must be designed to handle being restarted properly in OnQuestInit.

  ---

  How to Use

  1. Add a Property for Version Manager

  In your quest script, add a property that references

  VersionManager

  Like so and ensure that the VersionManager quest instance is being passed to it in the CK:

  VersionManagerQuestScript Property VersionManager Auto

  2. Register for Version Management in

  OnQuestInit and OnPlayerLoadGame

  Your quest script should register itself with Version Manager when it initializes and when the player loads a save:

  Event OnQuestInit()

  RegisterForRemoteEvent(Game. GetPlayer(), "OnPlayerLoadGame")

  ManageVersion()

  Event Actor. OnPlayerLoadGame(Actor akSender)

  ManageVersion()

  3. Implement

  ManageVersion()

  to Directly Pass the Version

  Always call RequestVersionManagement with the version string directly inside the function ensuring it is a stack variable otherwise you can end up passing in the stale version number even though the new script is installed:

  Function ManageVersion()

  VersionManager. RequestVersionManagement(self, "0. 9. 0")

  EndFunction

  ---

  What Happens When a Version Change is Detected?

  If the version string provided to RequestVersionManagement does not match the last registered version, Version Manager will:

  • []Stop the quest (Stop())

  • Restart the quest (Start())

  This ensures that