How To Add Addons To ESO: The Complete Elder Scrolls Online Modding Guide

To add addons to Elder Scrolls Online, players must navigate to the local Documents folder and place extracted mod files into the live AddOns directory or utilize the Minion management tool for automated synchronization. Success depends on maintaining updated library dependencies and toggling the Allow Outdated Addons setting within the in-game UI menu to prevent script conflicts.

Technical Foundation and Environment Preparation

Before modifying the Elder Scrolls Online (ESO) user interface, users must understand the architectural constraints of the game's API. Unlike many modern titles that support Steam Workshop or in-game mod browsers, ESO relies on a traditional LUA-based system where files are stored locally on the user's hardware. This process is exclusively available to PC and Mac users; players on PlayStation 4, PlayStation 5, Xbox One, and Xbox Series X/S cannot utilize third-party addons due to console manufacturer security protocols and the lack of a file-access layer.

Proper preparation ensures that the game engine correctly initializes the scripts upon startup. The primary directory is almost always located within the user's system profile rather than the game's installation directory. Understanding this distinction prevents the common error of placing files in the Program Files folder, which will result in the game failing to recognize any installed modifications.

Essential Modding Gear and Requirements

• Operating System: Windows 10/11 or macOS (High Sierra or later).
• Storage Directory: Approximately 100MB to 2GB of free space depending on the volume of texture-heavy addons.
• Required Software: An archive extractor such as 7-Zip or WinRAR for manual installations.
• Automated Utility: The Minion Addon Manager (highly recommended for version control).
• Direct File Path: Users\UserName\Documents\Elder Scrolls Online\live\AddOns.
• Prerequisite Knowledge: Familiarity with the "ReloadUI" command and the difference between standalone addons and library dependencies.

Standard Operating Procedures for Addon Integration

Installing addons can be executed via two primary workflows: the automated management method and the manual file distribution method. While the automated method is preferred for long-term maintenance, manual installation remains a critical skill for troubleshooting or installing private, non-indexed mods.

Step 1: Identifying and Locating the Correct Directory

The most frequent point of failure in ESO modding is the misidentification of the "Live" folder. On a standard Windows installation, the path is C:\Users\YourUsername\Documents\Elder Scrolls Online\live. If you have recently installed the game, you may need to launch it at least once and log in to a character to trigger the creation of these folders.

Warning: Users utilizing Microsoft OneDrive may find their Documents folder redirected to a cloud path. This often causes "disappearing" addons. If your path includes "OneDrive" within the string, you must ensure the folder is set to Always Keep on This Device or redirect the game's look-up path to a local-only directory.

Step 2: Automated Installation via Minion

Minion is the industry-standard tool for ESO players. It scans your directory, tracks versions, and alerts you when developers release updates—which happens frequently following major game patches like new Chapters or DLCs.

1. Download the Minion client from the official ESOUI project site.
2. During the initial setup, select Elder Scrolls Online as your game of choice.
3. Instruct Minion to "Find Game" or manually point it to your /live/AddOns folder.
4. Navigate to the "Find More" tab to browse the library of thousands of mods.
5. Click "Install" on the desired addon; Minion will automatically handle the extraction and placement of files.

Step 3: Manual Installation Protocol

If you prefer to manage files yourself or are using a mod not hosted on the main repositories, follow this sequence:

1. Download the addon file, which will typically arrive as a .zip or .7z archive.
2. Open the archive and locate the primary folder. This folder should contain a file ending in .txt (the manifest) and various .lua and .xml files.
3. Copy the entire folder. Do not copy the individual files inside; the game requires the specific folder structure to remain intact.
4. Paste the folder into your /live/AddOns directory.
5. Ensure there are no "nested" folders (e.g., AddOns/Skyshards/Skyshards/files). The correct structure is AddOns/Skyshards/files.

Step 4: Managing Library Dependencies

Modern ESO addons are modular. Developers often strip out common functions into "Libraries" (e.g., LibAddonMenu, LibGPS) to save memory. An addon like "Map Pins" will not function without its required libraries.

1. Check the description page of any addon you download for a list of "Required Dependencies."
2. Search for these libraries in Minion or on ESOUI.
3. Install libraries exactly like addons; they reside in the same /AddOns folder.
4. In the game's Addons menu, any addon with a red text label "Dependency Missing" indicates a library you forgot to install.

Step 5: In-Game Activation and Outdated Content Overrides

Once the files are in place, you must tell the game engine to execute them. This is managed via the Character Select screen or the in-game Escape menu.

1. Log into the game and navigate to the "Addons" menu.
2. Locate the checkbox labeled "Allow Outdated Addons" at the top of the interface. This is mandatory. ESO updates its API version number with every patch; if an addon was made for version 101038 and the game is now 101039, it will be disabled unless this box is checked.
3. Ensure the specific addons you want are checked in the list.
4. If you are already logged in, type /reloadui in the chat box to refresh the interface and load the new scripts.

Pro-Tip: If your game crashes immediately after a major update, the "Allow Outdated Addons" setting is likely forcing a broken script to run. Disable all addons and re-enable them one by one to find the culprit.

Addon Management Methodology Comparison

The following table compares the two primary methods of adding content to the game to help you determine the best approach for your hardware setup.

Resolving Script Errors and Mod Initialization Failures

Even with a perfect installation, the LUA environment in Elder Scrolls Online can be volatile. Understanding the root causes of failure allows for rapid recovery without needing to reinstall the entire game client.

• Scenario: Addons do not appear in the in-game menu.

  
  
  
  • Root Cause: The files are likely placed in the Program Files directory or a sub-folder within the AddOns directory (nesting).
  • Actionable Fix: Verify that the .txt manifest file is exactly one folder deep from the AddOns directory. If using a cloud service like OneDrive or Dropbox, disable syncing for the Documents/Elder Scrolls Online folder to prevent file locking.

• Scenario: The screen is filled with "UI Error" windows upon login.

  
  
  
  • Root Cause: A conflict between two addons or a missing library dependency.
  • Actionable Fix: Read the error log displayed in-game. It will usually name the offending addon or missing "Lib." Go to the Addons menu, find the name mentioned, and ensure all its dependencies are checked. If the error persists, delete the "SavedVariables" folder for that specific addon to reset its configuration.

• Scenario: Minion cannot find the game or won't install files.

  
  
  
  • Root Cause: Permissions issues or incorrect pathing in the Minion settings.
  • Actionable Fix: Run Minion as an Administrator. In Minion's settings, clear the "Game Path" and manually navigate to the /live/ folder. Ensure you are selecting the folder, not the ESO.exe file itself.

• Scenario: Frames and windows are overlapping or stuck on screen.

  
  
  
  • Root Cause: Two addons are attempting to modify the same UI element (e.g., two different minimaps).
  • Actionable Fix: Most addons allow you to move elements by holding the "Unlock UI" keybind (often found in the addon's specific settings menu). If they overlap, you must choose one and disable the other to prevent frame rate drops.

Frequently Asked Questions

Can I get banned for using addons in ESO?

No, ZeniMax Online Studios officially supports the use of addons through their provided LUA API. However, any third-party software that automates gameplay (macros, botting) or modifies the game's executable (.exe) files is strictly prohibited and can lead to a permanent ban. Addons only change the visual interface and data presentation.

Why don't my addons work on the PTS (Public Test Server)?

The PTS uses a separate directory from the live game. To use addons on the PTS, you must copy your files from the /live/AddOns folder to the /pts/AddOns folder. Note that many addons may be broken on the PTS as developers have not yet updated them for the upcoming changes.

How do I update my addons after a big game update?

If you use Minion, simply open the client and click "Update All." If you install manually, you must return to the website where you downloaded the mod, download the new version, and overwrite the old files in your AddOns folder. Always keep "Allow Outdated Addons" checked during the first week of a new patch.

Do addons affect my game's performance or FPS?

Yes, certain "heavy" addons like Combat Metrics or HarvestMap can significantly impact your CPU performance, especially in high-density areas like Cyrodiil or trials. If you experience low frame rates, try disabling addons that track large amounts of data or 3D pins on the map.

Where can I find the best addons for my class?

The most reputable source for ESO addons is ESOUI (esoui.com). For specific gameplay needs, look for "essential" categories such as Map Pins, Skyshards, LoreBooks, and combat enhancers like Deadly Strike or Hodor Reflexes.

Optimize Your Elder Scrolls Experience Today

Mastering the installation of addons is the single most effective way to improve your efficiency in Tamriel, whether you are tracking crafting nodes or optimizing trial DPS. Ensure your Minion client is updated and your library dependencies are current to maintain a seamless, error-free gaming session.