Skip to content

About

Load External ESO addons through the Xbox Game Pass (PC) version of the game.

Resources

Stars

2 stars

Watchers

0 watching

Forks

Repository files navigation

ESO AddOn Manager - Xbox Game Pass

Load your Elder Scrolls Online addons through the Xbox Game Pass (PC) version of the game.

The Game Pass version of ESO does not read from the standard Documents\Elder Scrolls Online\AddOns folder that addon managers like Minion use. This tool bridges the gap by creating NTFS directory junctions from the Game Pass managed-addon system back to your normal AddOns folder, so you can keep using Minion as usual and the game will see everything automatically.

No game files are modified. Junctions are transparent to both ESO and your addon manager.


Requirements

  • Windows 10 or 11
  • Elder Scrolls Online installed via Xbox Game Pass (PC)
  • Python 3.8 or later or the standalone .exe (see Releases)
  • Administrator privileges (required to create NTFS junctions)

Quick Start

Option A - Standalone exe (recommended)

  1. Download ESO-AddOn-Manager.exe from the Releases page.
  2. Place it anywhere - including inside your AddOns folder if you like.
  3. Double-click it. Follow the one-time setup to point it at your AddOns folder.
  4. Click Sync All. Done.

Option B - Run from source

  1. Install Python (check "Add Python to PATH").
  2. Download or clone this repository.
  3. Double-click Launch.bat.

Usage

GUI (Launch.bat / ESO-AddOn-Manager.exe)

Button What it does
Sync All Creates or refreshes junctions for every addon found in your source folder. Removes junctions for addons that are no longer there.
Refresh Re-scans the source folder and updates the addon list.
Remove All Junctions Removes all junctions this tool created. Your actual addon files are not touched.
Change Folder Opens the setup dialog to pick a different source folder.

CLI (sync.bat / AddonsManager.py)

python AddonsManager.py sync --source "D:\path\to\AddOns" --remove-stale
python AddonsManager.py status
python AddonsManager.py clean

How it Works

The Game Pass version of ESO loads addons from:

%LOCALAPPDATA%\Elder Scrolls Online\xb1cert\CachedData\AddOnsManaged\{UUID}\{AddonName}\

This tool creates NTFS directory junctions at those paths that point back to your real addon folders in Documents. ESO sees the addon files as if they were installed natively. Minion (or any other addon manager) keeps managing the Documents folder as usual.

Each addon gets a stable, deterministic UUID derived from its folder name, so syncing twice gives the same result and the mapping survives a reinstall of this tool.


Building from Source

Run compile.bat to produce a single portable ESO-AddOn-Manager.exe in the dist\ folder. PyInstaller is installed automatically if it is not already present.


Safety Notes

  • Your addon files are never deleted. Junctions are removed with os.rmdir(), which removes only the junction point itself and never touches the target directory.
  • If the source folder scan returns no results (e.g. wrong path configured), stale-junction removal is skipped entirely to prevent accidental mass-removal.

Credits

Built by FairTech

About

Load External ESO addons through the Xbox Game Pass (PC) version of the game.

Resources

Stars

2 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages