LibGamepadOptions (0.2.4)

LibGamepadOptions
Native gamepad Options UI registration for ESO addon developers.

Development Disclosure
Created by Official Zoruah with AI Assistance.

What It Is
LibGamepadOptions is a standalone ESO library that lets addon authors register controller-friendly settings inside ESO’s native gamepad Options UI.

It is built for addons that want a real gamepad settings experience instead of forcing controller users to swap back to the keyboard settings UI for every change.

Install Shape
Install as its own addon folder:

LibGamepadOptions/
LibGamepadOptions.txt
LibGamepadOptions.lua
README.md

Manifest Dependency
If your addon calls LibGamepadOptions directly, declare it as a required dependency:

## DependsOn: LibGamepadOptions>=7

If your addon treats gamepad Options support as optional, list it as optional and check for LibGamepadOptions before calling it.

Supported Rows

Header – section labels for grouped settings.
Description – informational rows.
Checkbox – boolean on/off settings.
Slider – numeric settings with min/current/max display.
Dropdown – finite option lists.
Button – run addon callbacks.
Submenu – nested option panels.

Basic Example

LibGamepadOptions:RegisterAddon(“MyAddon”, {
name = “My Addon”,
tooltip = “Controller-friendly settings for My Addon.”,
sortOrder = 100,
}, {
{ type = “header”, name = “General” },
{
type = “checkbox”,
name = “Enable feature”,
tooltip = “Turns the feature on or off.”,
getFunc = function() return MyAddon.saved.enabled end,
setFunc = function(value) MyAddon.saved.enabled = value end,
default = true,
},
})

Direct Gamepad Category
Use categoryName and directOpen when your addon should have its own top-level gamepad Options category:

LibGamepadOptions:RegisterAddon(“MyAddon”, {
name = “My Addon”,
displayName = “My Addon”,
categoryName = “My Addon”,
directOpen = true,
showInRoot = false,
tooltip = “Controller-friendly settings for My Addon.”,
sortOrder = 100,
}, optionsTable)

Notes

This library is for PC addons using ESO’s gamepad UI.
ESO console clients do not support user addons.
This library does not bundle or modify LibAddonMenu.
It is intended to complement normal keyboard settings panels.
Use showInRoot = true if your addon should appear both in its own category and in the shared Add-Ons hub.