-
Notifications
You must be signed in to change notification settings - Fork 0
Introduction
LibSavedVars is a library for managing saved variables in The Elder Scrolls Online. It builds on the game's native ZO_SavedVars system by providing a simpler, more consistent API while adding features that make addon settings easier to organize, maintain, and evolve over time.
Whether your addon stores a handful of user preferences or a large collection of configuration data, LibSavedVars helps reduce boilerplate code and handles many of the common tasks involved in working with saved variables.
LibSavedVars extends the standard saved variable system with features such as:
- A unified API for account-wide and character-specific settings.
- Automatic handling of default values.
- Built-in support for data versioning and migrations.
- Easy migration between account-wide and character-specific storage.
- Optional cleanup of default values to reduce SavedVariables file size.
- Utilities for organizing and managing complex settings.
These features allow addon authors to focus on developing their addons instead of maintaining custom saved variable code.
LibSavedVars is fully compatible with ESO's native saved variable system. Saved data is stored in the standard SavedVariables folder and remains compatible with the game's loading and saving mechanisms.
The library does not replace ZO_SavedVars; instead, it provides a higher-level interface that simplifies common tasks while remaining faithful to the underlying data structure.
Many addons begin with only a few settings but grow significantly over time. New features may require additional settings, existing data may need to be reorganized, or users may request the ability to switch between account-wide and character-specific configurations.
LibSavedVars was designed with these scenarios in mind. Features such as version management and data migration make it possible to evolve your saved data structure without requiring users to delete their existing settings.
LibSavedVars is intended for ESO addon developers who want a reliable and maintainable solution for managing saved variables.
It is suitable for both simple addons that only require a few persistent settings and large addons that need advanced data management features.
If you are already familiar with ZO_SavedVars, you'll find LibSavedVars follows the same concepts while reducing complexity and providing additional capabilities when your addon requires them.