Back
The Elder Scrolls Online

LibCustomIcons

Overview

LibCustomIcons is a lightweight library for The Elder Scrolls Online that allows custom icons for players.

LibCustomIcons

LibCustomIcons is a lightweight library for The Elder Scrolls Online that allows custom icons for players.
Originally part of HodorReflexes, this library was separated out to improve modularity and reduce overhead.
Dependencies: LibAddonMenu-2.0

Whether you're a streamer, guild leader, or just want to stand out with a personalized icon, this library gives you that little touch of customization — shared across all supported addons.

Features

- Assign custom icons to ESO players
- Centralized and easy-to-maintain icon list
- Designed for reuse in multiple addons (e.g., HodorReflexes)
- Lightweight and dependency-free

Get Your Custom Icon

Want to be featured with your own custom icon?

How to participate:

- Create a Pull Request adding your icon entry to the list
- Or send a donation to @m00nyONE in-game (EU server) and your request will be added

This helps support development and keeps the ESO addon ecosystem fun and alive!

Usage

If you're an addon developer and want to use LibCustomIcons:

Have a look at the full documentation here: Github Pages

Documentation will be expanded as needed — feel free to open an issue if you need help integrating it.

Repository Structure

- icons/: Contains all custom icon definitions
- LibCustomIcons.lua: Core logic to retrieve and manage custom icons

Contributing

https://github.com/m00nyONE/LibCustomIcons

Community contributions are welcome and appreciated!

- Fork the repo
- Add your custom icon to the data file
- Open a Pull Request with a short description

Make sure to keep icons appropriate and tasteful. Offensive or misleading content will not be accepted.

Credits

Made with contrib.rocks

Contact

For questions, contributions, or donations:

- GitHub: Issues & PRs

ABOUT THIS LISTING

This page describes LibCustomIcons by m00nyONE. The description and screenshots are the author's own, imported from their listing on ESOUI on 26 October 2026: https://www.esoui.com/downloads/info4161-LibCustomIcons.html

Mythiq.net hosts no files for it. The download button goes straight to the release file on cdn.esoui.com, so you are downloading from the author's own host, not from a copy of ours.

The download count, rating and comments on this page start at zero and count Mythiq.net only. The source's own figures are not copied here — they measure a different site, and a number that cannot be checked against our own ledger is not worth printing.

Requirements

Game versions
  • 11.1.0
  • 11.0.0
API VERSION

Built for ESO API version 11.1.0, 11.0.0. After a patch the game marks add-ons built for the previous API as out of date; the "Allow out of date add-ons" checkbox in the add-on menu loads them anyway, and most work.

LIBRARIES

Many ESO add-ons depend on a shared library — LibAddonMenu-2.0 above all — which is installed separately, exactly like an add-on. A dependency that is missing shows as the add-on simply not appearing in the list.

CONSOLE

Add-ons are PC and Mac only. There is no way to load them on console.

Installation

1. Download the archive with the button on this page and unzip it.

2. Move the unzipped folder into your add-ons directory:

Windows — Documents\Elder Scrolls Online\live\AddOns

macOS — ~/Documents/Elder Scrolls Online/live/AddOns

3. Start the game, and at the character select screen click Add-Ons.

4. Tick the add-on. If it is greyed out and marked out of date, tick "Allow out of date add-ons" at the top of the same panel.

5. Log in. Most add-ons need a /reloadui after they are first enabled.

UPDATING

Delete the old folder first. ESO loads everything it finds, and two copies of one add-on is the usual cause of "an add-on has produced an error" on login.

This release downloads from cdn.esoui.com, not from us, so there is no checksum to compare against. Scan the archive before you unpack it.

Version history

  1. v2026-10-26 Latest 26 Oct 2026 · 19 MB via cdn.esoui.com · 0 downloads Download
    ## 2026.07.05
    - regular update

    ## 2026.06.21
    - add AGENTS.md which states that AI is not allowed here

    ## 2026.03.30
    - bump API version to 101049 & 101050

    ## 2025.11.16
    - BREAKING CHANGE FOR DEVELOPERS:
    - removed GetIcon() - use GetStatic() or GetAnimated() instead
    - BREAKING CHANGES IN THE NEAR FUTURE:
    - GetStatic() now returns `texturePath, textureCoordsLeft, textureCoordsRight, textureCoordsTop, textureCoordsBottom` instead of only texturePath
    - GetAnimated() now returns `texturePath, textureCoordsLeft, textureCoordsRight, textureCoordsTop, textureCoordsBottom, columns, rows, framerate` instead of a table.
    - If you are a developer, and you have problems migrating, message me on Discord :-) I'll help you out.

    ## 2025.08.16
    - merge even more contributions

    ## 2025.08.04
    - merged HREI by @sshogrin

    ## 2025.08.02
    - merged Piou Icons by @TenshiRaitoEso
    - HasIcon bugfix by @WashedNotSloshed
    - unify API
    - fix some icons that went missing during migration

    ## 2025.07.22
    - Addon now automatically releases every sunday if there are changes in the files
    - remove orphaned icons
    - remove duplicate entries
    - new contributions
    - add a few tests like sanity-check, include-check, duplicate-check to the github pipeline

    ## 2025.07.20
    - update menu
    - Dolgubon you coulda just asked :D

    ## 2025.07.01
    - add integrity check /lci integrity
    - add menu

    ## 2025.06.27
    - first usable version
    - add api function to be used by other addons
    - porting over all custom icons from HodorReflexes

    Off-site on cdn.esoui.com — no checksum, because we never held this file. Link checked by our review team on 26 Oct 2026.

Comments

No comments yet.

Sign in to leave a comment.

Report this mod

Tell us if something is wrong — a file that will not work, content taken from someone else, or anything that looks unsafe. Reports go to our review team, not to the author.

Sign in to report this mod.

We use cookies to ensure that we give you the best experience on our website and improve your experience. By continuing to use this site you consent to such use of cookies.

Learn More