Troubleshooting

This section helps you quickly identify and fix common issues when working with the radial menu, including missing categories, items not appearing, or conditions not behaving as expected. Follow these tips to debug problems efficiently and ensure your menu works correctly in all situations.

---

Category ID must be a non-empty string

• Check if categoryId was provided and is not empty

• Make sure it's a string, not a number

Category with ID '...' already exists

• The category ID has already been used

• Choose a unique ID for your category

• It's recommended to use format: "yourresource_categoryname"

Parent category '...' not found

• The specified parent category does not exist

• Check if the parent category was created before this one

• If using a config category, verify the label is correct

Category '...' not found" (when adding item)

• The category where you're trying to add the item does not exist

• Check if categoryId is correct (can be ID or label)

• If using label, make sure it matches exactly the label in config

Item does not appear in menu

• Check if job/gang restrictions are correct

• If using caninteract, make sure the function returns true

• Enable Config.Debug = true in config.lua to see debug logs

• Check if the category has visible items (empty categories are hidden)

Menu does not update after adding item/category

• The menu is automatically re-initialized after each addition

• If the menu is open, close and reopen it

• Use the /radialrefresh command to force an update

Performance with canInteract

• The caninteract function is called frequently

• Avoid heavy operations (database queries, large loops)

• Use cache when appropriate

• If possible, use job/gang restrictions instead of caninteract for static conditions