Troubleshooting

Common Issues

API not available

// Always use the apiReady hook
Hooks.once("stylish-action-hud.apiReady", (api) => {
  // API is guaranteed to be ready here
});

Adapter not being used

// Check registered adapters
const api = game.modules.get("stylish-action-hud").api;
console.log(api.listSystemAdapters());

// Verify your adapter is registered with correct systemId
console.log(api.getRegisteredAdapters("my-system"));

Submenu not showing data

// Debug submenu data
Hooks.on("stylish-action-hud.modifyActionMenuData", (data, actor, categoryId) => {
  console.log("Submenu data:", { data, actor: actor.name, categoryId });
});

Categories not appearing

// Debug categories
Hooks.on("stylish-action-hud.modifyActionMenuCategories", (categories, actor) => {
  console.log("Categories:", categories);
});

Debug Mode

Enable console logging for debugging:

CONFIG.debug.stylishActionHud = true;